Penjelasan mendetail tentang kode jalur templat khusus untuk plugin WordPress Shortcodes Ultimate

Pernahkah Anda bertanya-tanya bagaimana cara menyesuaikan jalur templat unik di plugin Shortcodes Ultimate?

Tidak perlu iri pada para ahli teknis yang bermain-main dengan WordPress, karena sekarang saya akan mengajak Anda mengungkap rahasia di baliknya!

Yuk langsung ke intinya dan lakukan step by step!

Apa itu plugin Shortcodes Ultimate?

Shortcodes Ultimate adalah salah satu plugin paling populer di WordPress. Ia dapat dengan mudah mengimplementasikan berbagai fungsi melalui shortcode, seperti membuat tombol, carousel gambar, daftar artikel, dll...

Lebih baik lagi, kami dapat menyesuaikan jalur template untuk menampilkan konten dengan lebih fleksibel.

Bagaimana cara menambahkan jalur templat khusus?

Mari kita lihat langkah paling penting terlebih dahulu – menambahkan jalur templat khusus.

Ini adalah langkah pertama menuju presentasi yang dipersonalisasi!

contoh kode

dalam topik Anda functions.php Tambahkan kode berikut ke file atau plugin khusus:

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

        return $locations;
    },
    10,
    1
);

mengurai kode

1. Saring su/shortcode/posts/allowed_template_locations
   Filter ini memungkinkan kita untuk memperluas jalur template default Shortcodes Ultimate.

2. Jalur khusus /wp-content/custom-templates/
   Kami menyimpan template di /wp-content/custom-templates/ direktori agar tidak hilang saat mengupdate plugin.

3. 安全 性
   Jangan pernah memodifikasi file templat default plugin secara langsung untuk menghindari hilangnya konten khusus setelah plugin diperbarui.

Buat file templat khusus

Selanjutnya, kita perlu membuat file template di jalur kustom.

Misalnya kita membuat file bernama jiawen.php berkas templat.

Contoh file templat

在 /wp-content/custom-templates/ direktori, buat jiawen.php file dan tambahkan kode berikut:

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

Deskripsi file templat

• $atts['class']: Memungkinkan kita menyesuaikan kelas CSS dan mendesain gaya unik untuk templat.
• Gambar mini dan judul artikel: Menampilkan thumbnail dan judul artikel serta link ke halaman detail artikel.
• 安全 性:menggunakan defined('ABSPATH') || exit; Pastikan file template tidak dapat diakses secara langsung.

Setelah membuat template, kita dapat memanggilnya melalui shortcode di artikel atau halaman.

Contoh kode pendek

Tambahkan kode pendek berikut ke postingan atau halaman Anda:

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

[] digunakan pada kode pendek di atas untuk mencegah kode pendek dalam artikel di-escape. Dalam penggunaan sebenarnya, simbol [] perlu diubah ke standar [].

Deskripsi parameter kode pendek

1. template="jiawen.php"
   Tentukan nama file templat khusus, jalurnya relatif /wp-content/ dari.

2. posts_per_page="10"
10Menampilkan 10 artikel;
   -1Menampilkan semua artikel, tetapi tidak disarankan untuk mengaturnyatak terbatasJika terlalu banyak artikel, situs web mungkin macet karena tidak dapat memuat semua artikel.

3. ignore_sticky_posts="yes"
   Abaikan artikel yang dipasangi pin.

4. id="32277,30806"
   Hanya tampilkan artikel dengan ID yang ditentukan. Dua ID artikel ditentukan di sini, 32277 dan 30806. Hanya artikel yang sesuai dengan kedua ID ini yang akan ditampilkan.

总结

• Jalur templat khusus: Perluas jalur default melalui filter untuk menghindari kehilangan templat dalam pembaruan plugin.
• Buat file templat: Mengontrol tata letak dan isi daftar artikel melalui kode PHP.
• File templat panggilan: Panggilan fleksibel dicapai melalui parameter kode pendek.

Kemampuan untuk menyesuaikan jalur templat sangat meningkatkan fleksibilitas plugin Shortcodes Ultimate.

Dengan cara ini kami memiliki kendali penuh atas bagaimana daftar artikel kami ditampilkan.

Pendekatan ini sangat penting ketika kita perlu mencapai beragam desain pada halaman berbeda.

Jika Anda ingin membuat situs WordPress Anda lebih personal, cobalah!