Падрабязнае тлумачэнне кода шляху карыстальніцкага шаблону для плагіна 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 больш персаналізаваным, паспрабуйце!