Išsamus „WordPress Shortcodes Ultimate“ papildinio tinkinto šablono kelio kodo paaiškinimas

Ar kada nors susimąstėte, kaip pritaikyti unikalų šablono kelią „Shortcodes Ultimate“ papildinyje?

Nereikia pavydėti tiems technikos meistrams, kurie žaidžia su WordPress, nes dabar aš jums padėsiu atskleisti jo paslaptį!

Nagi, eikime tiesiai prie reikalo ir atlikime tai žingsnis po žingsnio!

Kas yra „Shortcodes Ultimate“ papildinys?

„Shortcodes Ultimate“ yra vienas populiariausių „WordPress“ papildinių. Jis gali lengvai įgyvendinti įvairias funkcijas per trumpuosius kodus, pavyzdžiui, kurti mygtukus, vaizdų karuseles, straipsnių sąrašus ir kt.

Dar geriau, kad galime tinkinti šablono kelią, kad turinys būtų rodomas lanksčiau.

Kaip pridėti pasirinktinį šablono kelią?

Pirmiausia pažvelkime į svarbiausią veiksmą – tinkinto šablono kelio pridėjimą.

Tai pirmas žingsnis asmeninio pristatymo link!

kodo pavyzdys

savo temoje functions.php Pridėkite šį kodą prie failo arba pasirinktinio papildinio:

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

        return $locations;
    },
    10,
    1
);

išanalizuoti kodą

1. 过滤器 su/shortcode/posts/allowed_template_locations
   Šis filtras leidžia išplėsti numatytuosius „Shortcodes Ultimate“ šablonų kelius.

2. pasirinktinis kelias /wp-content/custom-templates/
   Mes saugome šabloną /wp-content/custom-templates/ katalogą, kad jis nebūtų prarastas atnaujinant papildinį.

3. 安全 性
   Niekada nekeiskite numatytojo papildinio šablono failo tiesiogiai, kad neprarastumėte tinkinto turinio atnaujinus papildinį.

Sukurkite pasirinktinį šablono failą

Tada turime sukurti šablono failą pasirinktame kelyje.

Pavyzdžiui, sukuriame failą pavadinimu jiawen.php šablono failą.

Šablono failo pavyzdys

在 /wp-content/custom-templates/ katalogas, sukurti jiawen.php failą ir pridėkite šį kodą:

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

Šablono failo aprašymas

• $atts['class']: leidžia tinkinti CSS klases ir sukurti unikalius šablonų stilius.
• Straipsnio miniatiūra ir pavadinimas: Rodyti straipsnio miniatiūrą ir pavadinimą bei nuorodą į straipsnio išsamios informacijos puslapį.
• 安全 性: naudoti defined('ABSPATH') || exit; Įsitikinkite, kad šabloninių failų negalima pasiekti tiesiogiai.

Sukūrę šabloną, galime jį iškviesti trumpuoju kodu straipsnyje ar puslapyje.

Trumpojo kodo pavyzdys

Pridėkite šį trumpąjį kodą prie savo įrašo ar puslapio:

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

[] naudojamas aukščiau esančiame trumpajame kode, kad būtų išvengta straipsnio trumpojo kodo pašalinimo. Faktiškai naudojant simbolį [] reikia pakeisti į standartinį [].

Trumpojo kodo parametro aprašymas

1. template="jiawen.php"
   Nurodykite tinkinto šablono failo pavadinimą, kurio kelias yra santykinis /wp-content/ apie.

2. posts_per_page="10"
10Rodoma 10 straipsnių;
   -1Rodyti visus straipsnius, bet nerekomenduojama nustatytineribotasJei straipsnių yra per daug, svetainė gali sugesti, nes negali įkelti visų straipsnių.

3. ignore_sticky_posts="yes"
   Ignoruoti prisegtus straipsnius.

4. id="32277,30806"
   Rodyti tik straipsnius su nurodytu ID. Čia nurodyti du gaminių ID: 32277 ir 30806. Bus rodomi tik straipsniai, atitinkantys šiuos du ID.

apibendrinti

• Pasirinktinis šablono kelias: Išplėskite numatytąjį kelią per filtrus, kad neprarastumėte šablonų atnaujinant papildinius.
• Sukurti šablono failą: valdykite straipsnių sąrašo išdėstymą ir turinį naudodami PHP kodą.
• Skambinimo šablono failas: Lankstus skambinimas pasiekiamas naudojant trumpojo kodo parametrus.

Galimybė tinkinti šablonų kelius labai pagerina „Shortcodes Ultimate“ papildinio lankstumą.

Tokiu būdu mes visiškai kontroliuojame, kaip bus rodomas mūsų straipsnių sąrašas.

Šis metodas yra ypač svarbus, kai reikia sukurti skirtingus dizainus skirtinguose puslapiuose.

Jei norite, kad jūsų „WordPress“ svetainė būtų labiau suasmeninta, išbandykite!