Explicación detallada do código de ruta do modelo personalizado para o complemento WordPress Shortcodes Ultimate

Algunha vez te preguntas como personalizar un camiño de modelo único no complemento Shortcodes Ultimate?

Non hai que envexar a eses mestres técnicos que están xogando con WordPress, porque agora levareivos a revelar o segredo que hai detrás!

Veña, imos directos ao grano e facémolo paso a paso!

Que é o complemento Shortcodes Ultimate?

Shortcodes Ultimate é un dos complementos máis populares de WordPress. Pode implementar facilmente varias funcións mediante códigos curtos, como crear botóns, carrusel de imaxes, listas de artigos, etc.

Aínda mellor, podemos personalizar o camiño do modelo para mostrar o contido de forma máis flexible.

Como engadir un camiño de modelo personalizado?

Vexamos primeiro o paso máis crítico: engadir un camiño de modelo personalizado.

Este é o primeiro paso para unha presentación personalizada!

exemplo de código

no teu tema functions.php Engade o seguinte código ao ficheiro ou 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
);

analizar código

1. filtro su/shortcode/posts/allowed_template_locations
   Este filtro permítenos estender as rutas de modelos predeterminadas de Shortcodes Ultimate.

2. Camiño personalizado /wp-content/custom-templates/
   Gardamos o modelo /wp-content/custom-templates/ directorio para que non se perda ao actualizar o complemento.

3. 安全 性
   Nunca modifiques o ficheiro de modelo predeterminado dun complemento directamente para evitar perder contido personalizado despois de actualizar o complemento.

Crea un ficheiro de modelo personalizado

A continuación, necesitamos crear o ficheiro de modelo no camiño personalizado.

Por exemplo, creamos un ficheiro chamado jiawen.php ficheiro modelo.

Exemplo de ficheiro modelo

en /wp-content/custom-templates/ directorio, crear jiawen.php arquivo e engade o seguinte 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>

Descrición do ficheiro modelo

• $atts['class']: Permítenos personalizar clases CSS e deseñar estilos únicos para modelos.
• Miniatura e título do artigo: Mostra a miniatura e o título do artigo e ligazón á páxina de detalles do artigo.
• 安全 性:usar defined('ABSPATH') || exit; Asegúrate de que non se pode acceder directamente aos ficheiros de modelos.

Despois de crear o modelo, podemos chamalo a través dun shortcode nun artigo ou páxina.

Exemplo de código curto

Engade o seguinte código curto á túa publicación ou páxina:

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

[] utilízase no código curto anterior para evitar que se escape o código curto do artigo No uso real, o símbolo [] debe cambiarse polo estándar [].

Descrición do parámetro de código curto

1. template="jiawen.php"
   Especifique o nome do ficheiro de modelo personalizado, o camiño é relativo /wp-content/ de.

2. posts_per_page="10"
10Mostrando 10 artigos;
   -1Mostra todos os artigos, pero non se recomenda configuralosilimitadoSe hai demasiados artigos, o sitio web pode fallar porque non pode cargar todos os artigos.

3. ignore_sticky_posts="yes"
   Ignorar artigos fixados.

4. id="32277,30806"
   Mostra só artigos co ID especificado. Aquí especifícanse dous ID de artigo, 32277 e 30806. Só se mostrarán os artigos correspondentes a estes dous ID.

总结

• Camiño de modelo personalizado: amplía a ruta predeterminada a través de filtros para evitar perder modelos nas actualizacións de complementos.
• Crear ficheiro modelo: Controla o deseño e o contido da lista de artigos a través do código PHP.
• Ficheiro modelo de chamada: As chamadas flexibles conséguense mediante parámetros de código curto.

A capacidade de personalizar os camiños dos modelos mellora moito a flexibilidade do complemento Shortcodes Ultimate.

Deste xeito, temos control total sobre como se mostra a nosa lista de artigos.

Este enfoque é especialmente importante cando necesitamos conseguir deseños diversos en páxinas diferentes.

Se queres facer que o teu sitio web de WordPress sexa máis personalizado, próbao!