Explicación detallada del código de ruta de la plantilla personalizada para el complemento WordPress Shortcodes Ultimate

¿Alguna vez te has preguntado cómo personalizar una ruta de plantilla única en el complemento Shortcodes Ultimate?

¡No hay necesidad de envidiar a esos maestros técnicos que están jugando con WordPress, porque ahora te llevaré a revelar el secreto detrás de esto!

¡Vamos, vayamos directo al grano y hagámoslo paso a paso!

¿Qué es el complemento Shortcodes Ultimate?

Shortcodes Ultimate es uno de los complementos más populares de WordPress. Puede implementar fácilmente varias funciones a través de códigos cortos, como crear botones, carruseles de imágenes, listas de artículos, etc.

Aún mejor, podemos personalizar la ruta de la plantilla para mostrar el contenido de manera más flexible.

¿Cómo agregar una ruta de plantilla personalizada?

Veamos primero el paso más crítico: agregar una ruta de plantilla personalizada.

¡Este es el primer paso hacia una presentación personalizada!

Ejemplo de código

en tu tema functions.php Agregue el siguiente código al archivo o complemento personalizado:

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

        return $locations;
    },
    10,
    1
);

código de análisis

1. Filtro su/shortcode/posts/allowed_template_locations
   Este filtro nos permite ampliar las rutas de plantilla predeterminadas de Shortcodes Ultimate.

2. Ruta personalizada /wp-content/custom-templates/
   Guardamos la plantilla en /wp-content/custom-templates/ directorio para que no se pierda al actualizar el complemento.

3. 安全 性
   Nunca modifique el archivo de plantilla predeterminado de un complemento directamente para evitar perder contenido personalizado después de actualizar el complemento.

Crear un archivo de plantilla personalizado

A continuación, debemos crear el archivo de plantilla en la ruta personalizada.

Por ejemplo, creamos un archivo llamado jiawen.php archivo de plantilla.

Ejemplo de archivo de plantilla

在 /wp-content/custom-templates/ directorio, crear jiawen.php archivo y agregue el siguiente código:

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

Descripción del archivo de plantilla

• $atts['class']: Nos permite personalizar clases de CSS y diseñar estilos únicos para plantillas.
• Miniatura y título del artículo.: muestra la miniatura y el título del artículo y enlaza a la página de detalles del artículo.
• 安全 性： 使用 defined('ABSPATH') || exit; Asegúrese de que no se pueda acceder directamente a los archivos de plantilla.

Después de crear la plantilla, podemos llamarla mediante un código corto en un artículo o página.

Ejemplo de código corto

Agregue el siguiente código corto a su publicación o página:

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

[] se utiliza en el código corto anterior para evitar que se escape el código corto del artículo. En el uso real, el símbolo [] debe cambiarse al estándar [].

Descripción del parámetro de código corto

1. template="jiawen.php"
   Especifique el nombre del archivo de plantilla personalizado, la ruta es relativa a /wp-content/ de.

2. posts_per_page="10"
10Mostrando 10 artículos;
   -1Mostrar todos los artículos, pero no se recomienda configurarlos无限Si hay demasiados artículos, el sitio web puede bloquearse porque no puede cargar todos los artículos.

3. ignore_sticky_posts="yes"
   Ignora los artículos fijados.

4. id="32277,30806"
   Mostrar solo artículos con el ID especificado. Aquí se especifican dos ID de artículo, 32277 y 30806. Sólo se mostrarán los artículos correspondientes a estos dos ID.

总结

• Ruta de plantilla personalizada: expanda la ruta predeterminada a través de filtros para evitar perder plantillas en las actualizaciones de complementos.
• Crear archivo de plantilla: Controle el diseño y el contenido de la lista de artículos mediante código PHP.
• Archivo de plantilla de llamada: Las llamadas flexibles se logran mediante parámetros de código corto.

La capacidad de personalizar las rutas de las plantillas mejora enormemente la flexibilidad del complemento Shortcodes Ultimate.

De esta manera tenemos control total sobre cómo se muestra nuestra lista de artículos.

Este enfoque es particularmente importante cuando necesitamos lograr diversos diseños en diferentes páginas.

Si desea que su sitio web de WordPress sea más personalizado, ¡pruébelo!