Giải thích chi tiết về mã đường dẫn mẫu tùy chỉnh cho plugin WordPress Shortcodes Ultimate

Bạn đã bao giờ tự hỏi làm cách nào để tùy chỉnh một đường dẫn mẫu duy nhất trong plugin Shortcodes Ultimate chưa?

Không cần phải ghen tị với những bậc thầy kỹ thuật đang chơi với WordPress, vì bây giờ tôi sẽ đưa bạn tiết lộ bí mật đằng sau nó!

Nào, hãy đi thẳng vào vấn đề và thực hiện từng bước một!

Plugin Shortcodes Ultimate là gì?

Shortcodes Ultimate là một trong những plugin phổ biến nhất trong WordPress. Nó có thể dễ dàng triển khai nhiều chức năng khác nhau thông qua mã ngắn, chẳng hạn như tạo nút, băng chuyền hình ảnh, danh sách bài viết, v.v...

Tuyệt vời hơn nữa, chúng ta có thể tùy chỉnh đường dẫn mẫu để hiển thị nội dung linh hoạt hơn.

Làm cách nào để thêm đường dẫn mẫu tùy chỉnh?

Trước tiên, hãy xem xét bước quan trọng nhất – thêm đường dẫn mẫu tùy chỉnh.

Đây là bước đầu tiên hướng tới việc trình bày được cá nhân hóa!

ví dụ về mã

trong chủ đề của bạn functions.php Thêm mã sau vào tệp hoặc plugin tùy chỉnh:

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

        return $locations;
    },
    10,
    1
);

mã phân tích

1. 过滤器 su/shortcode/posts/allowed_template_locations
   Bộ lọc này cho phép chúng tôi mở rộng đường dẫn mẫu mặc định của Shortcodes Ultimate.

2. Đường dẫn tùy chỉnh /wp-content/custom-templates/
   Chúng tôi lưu trữ mẫu trong /wp-content/custom-templates/ thư mục để không bị mất khi cập nhật plugin.

3. 安全 性
   Không bao giờ sửa đổi trực tiếp tệp mẫu mặc định của plugin để tránh mất nội dung tùy chỉnh sau khi cập nhật plugin.

Tạo một tập tin mẫu tùy chỉnh

Tiếp theo, chúng ta cần tạo tệp mẫu trong đường dẫn tùy chỉnh.

Ví dụ: chúng tôi tạo một tệp có tên jiawen.php tập tin mẫu.

Ví dụ về tệp mẫu

在 /wp-content/custom-templates/ thư mục, tạo jiawen.php tập tin và thêm đoạn mã sau:

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

Mô tả tệp mẫu

• $atts['class']: Cho phép chúng ta tùy chỉnh các lớp CSS và thiết kế các kiểu độc đáo cho các mẫu.
• Hình thu nhỏ và tiêu đề bài viết: Hiển thị hình thu nhỏ và tiêu đề của bài viết và liên kết đến trang chi tiết bài viết.
• 安全 性:sử dụng defined('ABSPATH') || exit; Đảm bảo rằng các tệp mẫu không thể được truy cập trực tiếp.

Sau khi tạo mẫu, chúng ta có thể gọi nó thông qua shortcode trong bài viết hoặc trang.

Ví dụ về mã ngắn

Thêm mã ngắn sau vào bài đăng hoặc trang của bạn:

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

[] được sử dụng trong shortcode trên để ngăn chặn shortcode trong bài viết bị thoát. Trong sử dụng thực tế, ký hiệu [] cần được thay đổi thành [] tiêu chuẩn.

Mô tả tham số shortcode

1. template="jiawen.php"
   Chỉ định tên của tệp mẫu tùy chỉnh, đường dẫn liên quan đến /wp-content/ của.

2. posts_per_page="10"
10Hiển thị 10 bài viết;
   -1Hiển thị tất cả các bài viết, nhưng không nên thiết lậpVô hạnNếu có quá nhiều bài viết, trang web có thể bị sập vì không thể tải hết tất cả các bài viết.

3. ignore_sticky_posts="yes"
   Bỏ qua các bài viết được ghim.

4. id="32277,30806"
   Chỉ hiển thị các bài viết có ID được chỉ định. Hai ID bài viết được chỉ định ở đây, 32277 và 30806. Chỉ những bài viết tương ứng với hai ID này mới được hiển thị.

tóm lại

• Đường dẫn mẫu tùy chỉnh: Mở rộng đường dẫn mặc định thông qua các bộ lọc để tránh mất mẫu trong các bản cập nhật plug-in.
• Tạo tập tin mẫu: Kiểm soát bố cục và nội dung của danh sách bài viết thông qua mã PHP.
• Tệp mẫu cuộc gọi: Gọi điện linh hoạt đạt được thông qua các tham số shortcode.

Khả năng tùy chỉnh đường dẫn mẫu cải thiện đáng kể tính linh hoạt của plugin Shortcodes Ultimate.

Bằng cách này, chúng tôi có toàn quyền kiểm soát cách hiển thị danh sách bài viết của chúng tôi.

Cách tiếp cận này đặc biệt quan trọng khi chúng ta cần đạt được các thiết kế đa dạng trên các trang khác nhau.

Nếu bạn muốn làm cho trang web WordPress của mình được cá nhân hóa hơn, hãy thử!