Подробно обяснение на персонализирания шаблонен код на пътя за плъгина WordPress Shortcodes Ultimate

Чудили ли сте се някога как да персонализирате уникален път на шаблон в плъгина Shortcodes Ultimate?

Няма нужда да завиждате на онези технически майстори, които си играят с WordPress, защото сега ще ви разкрия тайната зад него!

Хайде, нека да преминем направо към въпроса и да го направим стъпка по стъпка!

Какво представлява плъгинът Shortcodes Ultimate?

Shortcodes Ultimate е един от най-популярните плъгини в WordPress. Той може лесно да реализира различни функции чрез кратки кодове, като създаване на бутони, въртележки с изображения, списъци със статии и т.н.

Дори по-добре, можем да персонализираме пътя на шаблона, за да показваме съдържанието по-гъвкаво.

Как да добавите потребителски шаблонен път?

Нека първо да разгледаме най-важната стъпка – добавяне на персонализиран път на шаблон.

Това е първата стъпка към персонализирано представяне!

примерен код

във вашата тема functions.php Добавете следния код към файла или персонализирания плъгин:

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

        return $locations;
    },
    10,
    1
);

анализирайте кода

1. филтър su/shortcode/posts/allowed_template_locations
   Този филтър ни позволява да разширим пътищата на шаблона по подразбиране на Shortcodes Ultimate.

2. потребителски път /wp-content/custom-templates/
   Ние съхраняваме шаблона в /wp-content/custom-templates/ директория, така че да не се загуби при актуализиране на приставката.

3. 安全 性
   Никога не променяйте директно шаблонния файл по подразбиране на плъгин, за да избегнете загуба на персонализирано съдържание, след като плъгинът бъде актуализиран.

Създайте персонализиран файл с шаблон

След това трябва да създадем шаблонния файл в персонализирания път.

Например създаваме файл, наречен jiawen.php шаблонен файл.

Пример за файл с шаблон

在 /wp-content/custom-templates/ директория, съз jiawen.php файл и добавете следния код:

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

Описание на файл с шаблон

• $atts['class']: Позволява ни да персонализираме CSS класове и да проектираме уникални стилове за шаблони.
• Миниатюра и заглавие на статията: Показване на миниизображение и заглавие на статията и връзка към страницата с подробности за статията.
• 安全 性:използване defined('ABSPATH') || exit; Уверете се, че шаблонните файлове не могат да бъдат достъпни директно.

След като създадем шаблона, можем да го извикаме чрез кратък код в статия или страница.

Пример за кратък код

Добавете следния кратък код към вашата публикация или страница:

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

[] се използва в горния кратък код, за да се предотврати екранирането на краткия код в статията. При действителна употреба символът [] трябва да бъде променен на стандартния [].

Описание на параметъра за кратък код

1. template="jiawen.php"
   Посочете името на файла с персонализиран шаблон, като пътят е относителен към /wp-content/ на.

2. posts_per_page="10"
10Показани са 10 статии;
   -1Показване на всички статии, но не се препоръчва да се задаванеограниченАко има твърде много статии, уебсайтът може да се срине, защото не може да зареди всички статии.

3. ignore_sticky_posts="yes"
   Игнорирайте фиксираните статии.

4. id="32277,30806"
   Показвайте само статии с посочения идентификатор. Тук са посочени два идентификатора на статии, 32277 и 30806. Ще бъдат показани само статии, съответстващи на тези два идентификатора.

总结

• Път на персонализиран шаблон: Разширете пътя по подразбиране чрез филтри, за да избегнете загуба на шаблони при актуализации на добавки.
• Създайте шаблонен файл: Контролирайте оформлението и съдържанието на списъка със статии чрез PHP код.
• Файл с шаблон за обаждане: Гъвкавото повикване се постига чрез параметри за кратък код.

Възможността за персонализиране на пътищата на шаблона значително подобрява гъвкавостта на плъгина Shortcodes Ultimate.

По този начин имаме пълен контрол върху това как се показва нашият списък със статии.

Този подход е особено важен, когато трябва да постигнем разнообразен дизайн на различни страници.

Ако искате да направите своя WordPress уебсайт по-персонализиран, опитайте го!