Podrobné vysvětlení kódu cesty vlastní šablony pro plugin WordPress Shortcodes Ultimate

Přemýšleli jste někdy o tom, jak přizpůsobit jedinečnou cestu šablony v zásuvném modulu Shortcodes Ultimate?

Není třeba závidět těm technickým mistrům, kteří si hrají s WordPress, protože teď vás vezmu, abyste odhalili tajemství, které se za tím skrývá!

Pojď, pojďme rovnou k věci a udělejme to krok za krokem!

Co je plugin Shortcodes Ultimate?

Shortcodes Ultimate je jedním z nejoblíbenějších pluginů ve WordPressu, který dokáže snadno implementovat různé funkce prostřednictvím krátkých kódů, jako je vytváření tlačítek, karusely obrázků, seznamy článků atd.

Ještě lépe můžeme upravit cestu šablony, aby se obsah zobrazoval flexibilněji.

Jak přidat vlastní cestu šablony?

Nejprve se podíváme na nejkritičtější krok – přidání vlastní cesty šablony.

Toto je první krok k personalizované prezentaci!

příklad kódu

ve vašem tématu functions.php Přidejte následující kód do souboru nebo vlastního pluginu:

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

        return $locations;
    },
    10,
    1
);

analyzovat kód

1. Filtr su/shortcode/posts/allowed_template_locations
   Tento filtr nám umožňuje rozšířit výchozí cesty šablony Shortcodes Ultimate.

2. vlastní cesta /wp-content/custom-templates/
   Šablonu uložíme do /wp-content/custom-templates/ adresář, aby se při aktualizaci pluginu neztratil.

3. 安全 性
   Nikdy neupravujte přímo výchozí soubor šablony pluginu, aby nedošlo ke ztrátě vlastního obsahu po aktualizaci pluginu.

Vytvořte soubor vlastní šablony

Dále musíme vytvořit soubor šablony ve vlastní cestě.

Například vytvoříme soubor s názvem jiawen.php soubor šablony.

Příklad souboru šablony

在 /wp-content/custom-templates/ adresář, vytvořit jiawen.php soubor a přidejte následující 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 souboru šablony

• $atts['class']: Umožňuje nám přizpůsobit třídy CSS a navrhnout jedinečné styly pro šablony.
• Miniatura a název článku: Zobrazí miniaturu a název článku a odkaz na stránku s podrobnostmi o článku.
• 安全 性:použití defined('ABSPATH') || exit; Ujistěte se, že k souborům šablon nelze přistupovat přímo.

Po vytvoření šablony ji můžeme zavolat prostřednictvím krátkého kódu v článku nebo na stránce.

Příklad krátkého kódu

Přidejte do svého příspěvku nebo stránky následující krátký kód:

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

[] se používá ve výše uvedeném zkráceném kódu, aby se zabránilo úniku zkráceného kódu v článku Při skutečném použití je třeba změnit symbol [] na standardní [].

Popis parametru Shortcode

1. template="jiawen.php"
   Zadejte název souboru vlastní šablony, k němuž je cesta relativní /wp-content/ z.

2. posts_per_page="10"
10Zobrazeno 10 článků;
   -1Zobrazit všechny články, ale nedoporučuje se to nastavovatneomezenýPokud je článků příliš mnoho, web může selhat, protože nedokáže načíst všechny články.

3. ignore_sticky_posts="yes"
   Ignorovat připnuté články.

4. id="32277,30806"
   Zobrazujte pouze články se zadaným ID. Zde jsou zadána dvě ID článku, 32277 a 30806. Zobrazí se pouze články odpovídající těmto dvěma ID.

总结

• Vlastní cesta šablony: Rozbalte výchozí cestu přes filtry, abyste se vyhnuli ztrátě šablon v aktualizacích zásuvných modulů.
• Vytvořte soubor šablony: Ovládejte rozvržení a obsah seznamu článků pomocí kódu PHP.
• Soubor šablony volání: Flexibilní volání je dosaženo prostřednictvím parametrů shortcode.

Možnost přizpůsobit cesty šablon výrazně zlepšuje flexibilitu plug-inu Shortcodes Ultimate.

Tímto způsobem máme plnou kontrolu nad tím, jak se zobrazuje náš seznam článků.

Tento přístup je zvláště důležitý, když potřebujeme dosáhnout různých návrhů na různých stránkách.

Pokud chcete, aby byl váš web WordPress více přizpůsobený, vyzkoušejte to!