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