توضیح مفصل کد مسیر قالب سفارشی برای افزونه وردپرس Shortcodes Ultimate

آیا تا به حال به این فکر کرده اید که چگونه یک مسیر قالب منحصر به فرد را در افزونه Shortcodes Ultimate شخصی سازی کنید؟

نیازی نیست به آن استادان فنی که با وردپرس بازی می کنند حسادت کنید، زیرا اکنون شما را برای فاش کردن راز پشت آن می برم!

بیا، بیایید مستقیماً به اصل مطلب برویم و آن را مرحله به مرحله انجام دهیم!

افزونه Shortcodes Ultimate چیست؟

Shortcodes Ultimate یکی از محبوب ترین افزونه ها در وردپرس است که به راحتی می تواند عملکردهای مختلفی را از طریق کدهای کوتاه مانند ایجاد دکمه ها، چرخ فلک های تصویری، لیست مقالات و غیره پیاده سازی کند.

حتی بهتر از آن، می‌توانیم مسیر قالب را برای نمایش انعطاف‌پذیرتر محتوا سفارشی کنیم.

چگونه مسیر قالب سفارشی را اضافه کنیم؟

بیایید ابتدا به مهم ترین مرحله نگاه کنیم - اضافه کردن یک مسیر قالب سفارشی.

این اولین قدم به سوی ارائه شخصی است!

نمونه کد

در موضوع شما 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 را تا حد زیادی بهبود می بخشد.

به این ترتیب ما کنترل کاملی بر نحوه نمایش لیست مقالات خود داریم.

این رویکرد به ویژه زمانی مهم است که ما نیاز به دستیابی به طرح های متنوع در صفحات مختلف داریم.

اگر می خواهید وب سایت وردپرس خود را شخصی تر کنید، آن را امتحان کنید!