Podrobné vysvetlenie vlastného kódu cesty šablóny pre doplnok WordPress Shortcodes Ultimate

Premýšľali ste niekedy o tom, ako prispôsobiť jedinečnú cestu šablóny v doplnku Shortcodes Ultimate?

Nie je potrebné závidieť technickým majstrom, ktorí sa hrajú s WordPress, pretože teraz vás vezmem, aby ste odhalili tajomstvo, ktoré sa za tým skrýva!

Poď, prejdime priamo k veci a urobme to krok za krokom!

Čo je doplnok Shortcodes Ultimate?

Shortcodes Ultimate je jedným z najpopulárnejších doplnkov vo WordPress, ktorý dokáže jednoducho implementovať rôzne funkcie prostredníctvom krátkych kódov, ako je vytváranie tlačidiel, obrázkových karuselov, zoznamov článkov atď.

Ešte lepšie je, že môžeme prispôsobiť cestu šablóny, aby sa obsah zobrazoval flexibilnejšie.

Ako pridať vlastnú cestu šablóny?

Najprv sa pozrime na najdôležitejší krok – pridanie vlastnej cesty šablóny.

Toto je prvý krok k personalizovanej prezentácii!

príklad kódu

vo vašej téme functions.php Pridajte nasledujúci kód do súboru alebo vlastného doplnku:

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

        return $locations;
    },
    10,
    1
);

analyzovať kód

1. filter su/shortcode/posts/allowed_template_locations
   Tento filter nám umožňuje rozšíriť predvolené cesty šablóny Shortcodes Ultimate.

2. vlastnú cestu /wp-content/custom-templates/
   Šablónu uložíme do /wp-content/custom-templates/ adresár, aby sa pri aktualizácii pluginu nestratil.

3. 安全 性
   Nikdy neupravujte priamo predvolený súbor šablóny doplnku, aby ste po aktualizácii doplnku nestratili vlastný obsah.

Vytvorte súbor vlastnej šablóny

Ďalej musíme vytvoriť súbor šablóny vo vlastnej ceste.

Napríklad vytvoríme súbor tzv jiawen.php súbor šablóny.

Príklad súboru šablóny

在 /wp-content/custom-templates/ adresár, vytvoriť jiawen.php súbor a pridajte nasledujúci kód:

<?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>

Popis súboru šablóny

• $atts['class']: Umožňuje nám prispôsobiť triedy CSS a navrhnúť jedinečné štýly pre šablóny.
• Miniatúra a názov článku: Zobrazte miniatúru a názov článku a odkaz na stránku s podrobnosťami o článku.
• 安全 性:použitie defined('ABSPATH') || exit; Uistite sa, že k súborom šablón nemožno pristupovať priamo.

Po vytvorení šablóny ju môžeme zavolať prostredníctvom krátkeho kódu v článku alebo na stránke.

Príklad krátkeho kódu

Pridajte nasledujúci krátky kód do svojho príspevku alebo stránky:

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

[] sa používa vo vyššie uvedenom skrátenom kóde, aby sa zabránilo úniku kódu v článku. Pri skutočnom použití je potrebné zmeniť symbol [] na štandardný [].

Popis parametra krátkeho kódu

1. template="jiawen.php"
   Zadajte názov súboru vlastnej šablóny, ku ktorému je cesta relatívna /wp-content/ z.

2. posts_per_page="10"
10Zobrazuje sa 10 článkov;
   -1Zobraziť všetky články, ale neodporúča sa to nastavovaťneobmedzenéAk je článkov príliš veľa, webová stránka môže zlyhať, pretože nedokáže načítať všetky články.

3. ignore_sticky_posts="yes"
   Ignorovať pripnuté články.

4. id="32277,30806"
   Zobrazovať iba články so zadaným ID. Tu sú špecifikované dve ID článku, 32277 a 30806. Zobrazia sa iba články zodpovedajúce týmto dvom ID.

总结

• Cesta vlastnej šablóny: Rozšírte predvolenú cestu cez filtre, aby ste predišli strate šablón v aktualizáciách doplnkov.
• Vytvorte súbor šablóny: Ovládajte rozloženie a obsah zoznamu článkov pomocou kódu PHP.
• Súbor šablóny hovoru: Flexibilné volanie je dosiahnuté prostredníctvom parametrov krátkeho kódu.

Schopnosť prispôsobiť cesty šablón výrazne zlepšuje flexibilitu doplnku Shortcodes Ultimate.

Takto máme plnú kontrolu nad tým, ako sa zobrazuje náš zoznam článkov.

Tento prístup je obzvlášť dôležitý, keď potrebujeme dosiahnuť rôznorodé návrhy na rôznych stránkach.

Ak chcete, aby bol váš web WordPress prispôsobenejší, skúste to!