Шарҳи муфассали рамзи роҳи қолаби фармоишӣ барои плагини Shortcodes Ultimate WordPress

Оё шумо ягон бор дар ҳайрат шудаед, ки чӣ гуна роҳи қолаби беназирро дар плагини 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"
   Танҳо мақолаҳоро бо ID-и муайяншуда нишон диҳед. Дар ин ҷо ду ID-и мақола нишон дода шудаанд, 32277 ва 30806. Танҳо мақолаҳои мувофиқи ин ду ID нишон дода мешаванд.

Хулласи калом

• Роҳи қолаби фармоишӣ: Роҳи пешфарзро тавассути филтрҳо васеъ кунед, то қолабҳоро дар навсозиҳои плагин аз даст надиҳед.
• Файли шаблон эҷод кунед: Тарҳ ва мундариҷаи рӯйхати мақолаҳоро тавассути рамзи PHP назорат кунед.
• Файли қолаби занг: Зангҳои чандир тавассути параметрҳои кӯтоҳ.

Қобилияти танзими роҳҳои шаблон чандирии плагини Shortcodes Ultimate-ро хеле беҳтар мекунад.

Ҳамин тариқ, мо назорати пурраи он дорем, ки чӣ гуна рӯйхати мақолаҳои мо нишон дода мешаванд.

Ин равиш махсусан муҳим аст, вақте ки мо бояд тарҳҳои гуногунро дар саҳифаҳои гуногун ба даст орем.

Агар шумо хоҳед, ки вебсайти WordPress-и худро бештар фардӣ кунед, онро санҷед!