Explicație detaliată a codului de cale a șablonului personalizat pentru pluginul WordPress Shortcodes Ultimate

V-ați întrebat vreodată cum să personalizați o cale unică de șablon în pluginul Shortcodes Ultimate?

Nu trebuie să-i invidiezi pe acești maeștri tehnici care se joacă cu WordPress, pentru că acum te voi duce să dezvălui secretul din spatele lui!

Haide, să trecem direct la subiect și să o facem pas cu pas!

Ce este pluginul Shortcodes Ultimate?

Shortcodes Ultimate este unul dintre cele mai populare plugin-uri din WordPress. Poate implementa cu ușurință diverse funcții prin shortcodes, cum ar fi crearea de butoane, carusele de imagini, liste de articole etc...

Și mai bine, putem personaliza calea șablonului pentru a afișa conținutul mai flexibil.

Cum să adăugați o cale de șablon personalizată?

Să ne uităm mai întâi la pasul cel mai critic – adăugarea unei căi de șablon personalizate.

Acesta este primul pas către prezentarea personalizată!

exemplu de cod

în subiectul dvs functions.php Adăugați următorul cod la fișier sau plugin personalizat:

add_filter(
    'su/shortcode/posts/allowed_template_locations',
    function( $locations ) {
        // 添加自定义模板路径 /wp-content/custom-templates/
        $locations[] = WP_CONTENT_DIR . '/custom-templates';

        return $locations;
    },
    10,
    1
);

parse cod

1. filtru su/shortcode/posts/allowed_template_locations
   Acest filtru ne permite să extindem căile implicite ale șablonului Shortcodes Ultimate.

2. Cale personalizată /wp-content/custom-templates/
   Stocam șablonul în /wp-content/custom-templates/ director, astfel încât să nu se piardă la actualizarea pluginului.

3. 安全 性
   Nu modificați niciodată fișierul șablon implicit al unui plugin pentru a evita pierderea conținutului personalizat după actualizarea pluginului.

Creați un fișier șablon personalizat

Apoi, trebuie să creăm fișierul șablon în calea personalizată.

De exemplu, creăm un fișier numit jiawen.php fișier șablon.

Exemplu de fișier șablon

în /wp-content/custom-templates/ director, creați jiawen.php fișier și adăugați următorul cod:

<?php defined( 'ABSPATH' ) || exit; ?>
<div class="su-posts su-posts-teaser-loop <?php echo esc_attr( $atts['class'] ); ?>">

    <?php if ( $posts->have_posts() ) : ?>
        <?php while ( $posts->have_posts() ) : ?>
            <?php $posts->the_post(); ?>

            <?php if ( ! su_current_user_can_read_post( get_the_ID() ) ) : ?>
                <?php continue; ?>
            <?php endif; ?>

            <div id="su-post-<?php the_ID(); ?>" class="su-post <?php echo esc_attr( $atts['class_single'] ); ?>">
                <?php if ( has_post_thumbnail() ) : ?>
                    <a target="_blank" rel="nofollow" class="su-post-thumbnail" href="<?php the_permalink(); ?>"><?php the_post_thumbnail(); ?></a>
                <?php endif; ?>
                <div class="su-post-title">
                    <a target="_blank" href="<?php the_permalink(); ?>">🔗<?php the_title(); ?></a>
                </div>
            </div>

        <?php endwhile; ?>
    <?php else : ?>

        <p class="su-posts-not-found"><?php esc_html_e( 'Posts not found', 'shortcodes-ultimate' ); ?></p>

    <?php endif; ?>
</div>

Descrierea fișierului șablon

• $atts['class']: Ne permite să personalizăm clasele CSS și să proiectăm stiluri unice pentru șabloane.
• Miniatura articolului și titlul: Afișează miniatura și titlul articolului și link-ul către pagina cu detaliile articolului.
• 安全 性:utilizare defined('ABSPATH') || exit; Asigurați-vă că fișierele șablon nu pot fi accesate direct.

După crearea șablonului, îl putem apela printr-un shortcode într-un articol sau pagină.

Exemplu de cod scurt

Adăugați următorul cod scurt la postarea sau pagina dvs.:

【su_posts template="jiawen.php" posts_per_page="10" ignore_sticky_posts="yes" id="32277,30806"】

[] este utilizat în codul scurt de mai sus pentru a preveni scăparea codului scurt din articol În timpul utilizării efective, simbolul [] trebuie schimbat la standardul [].

Descrierea parametrului de cod scurt

1. template="jiawen.php"
   Specificați numele fișierului șablon personalizat, calea este relativă /wp-content/ 的.

2. posts_per_page="10"
10Se afișează 10 articole;
   -1Afișați toate articolele, dar nu este recomandat să le setaținelimitatDacă există prea multe articole, site-ul web se poate bloca deoarece nu poate încărca toate articolele.

3. ignore_sticky_posts="yes"
   Ignorați articolele fixate.

4. id="32277,30806"
   Afișați numai articolele cu ID-ul specificat. Două ID-uri de articol sunt specificate aici, 32277 și 30806. Vor fi afișate doar articolele corespunzătoare acestor două ID-uri.

总结

• Cale personalizată a șablonului: extindeți calea implicită prin filtre pentru a evita pierderea șabloanelor în actualizările plug-in-urilor.
• Creați fișier șablon: Controlați aspectul și conținutul listei de articole prin cod PHP.
• Fișier șablon de apel: Apelarea flexibilă se realizează prin parametrii de cod scurt.

Abilitatea de a personaliza căile șablonului îmbunătățește foarte mult flexibilitatea plug-in-ului Shortcodes Ultimate.

În acest fel, avem control deplin asupra modului în care este afișată lista noastră de articole.

Această abordare este deosebit de importantă atunci când trebuie să realizăm modele diverse pe pagini diferite.

Dacă doriți să vă faceți site-ul WordPress mai personalizat, încercați-l!