Explicação detalhada do código do caminho do modelo personalizado para o plugin WordPress Shortcodes Ultimate

Você já se perguntou como personalizar um caminho de modelo exclusivo no plug-in Shortcodes Ultimate?

Não há necessidade de invejar aqueles mestres técnicos que estão brincando com WordPress, pois agora vou levá-los para revelar o segredo por trás disso!

Vamos direto ao ponto e fazer passo a passo!

O que é o plugin Shortcodes Ultimate?

Shortcodes Ultimate é um dos plugins mais populares do WordPress. Ele pode implementar facilmente diversas funções através de shortcodes, como criação de botões, carrosséis de imagens, listas de artigos, etc.

Melhor ainda, podemos personalizar o caminho do modelo para exibir o conteúdo de forma mais flexível.

Como adicionar um caminho de modelo personalizado?

Vejamos primeiro a etapa mais crítica – adicionar um caminho de modelo personalizado.

Este é o primeiro passo para uma apresentação personalizada!

exemplo de código

no seu tópico functions.php Adicione o seguinte código ao arquivo ou plugin 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
);

analisar código

1. filtro su/shortcode/posts/allowed_template_locations
   Este filtro nos permite estender os caminhos de modelo padrão do Shortcodes Ultimate.

2. Caminho personalizado /wp-content/custom-templates/
   Armazenamos o modelo em /wp-content/custom-templates/ diretório para que não seja perdido ao atualizar o plugin.

3. 安全 性
   Nunca modifique diretamente o arquivo de modelo padrão de um plug-in para evitar a perda de conteúdo personalizado após a atualização do plug-in.

Crie um arquivo de modelo personalizado

A seguir, precisamos criar o arquivo de modelo no caminho personalizado.

Por exemplo, criamos um arquivo chamado jiawen.php arquivo de modelo.

Exemplo de arquivo de modelo

在 /wp-content/custom-templates/ diretório, crie jiawen.php arquivo e adicione 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>

Descrição do arquivo de modelo

• $atts['class']: nos permite personalizar classes CSS e criar estilos exclusivos para modelos.
• Miniatura e título do artigo: exibe a miniatura e o título do artigo e vincula à página de detalhes do artigo.
• 安全 性:usar defined('ABSPATH') || exit; Certifique-se de que os arquivos de modelo não possam ser acessados ​​diretamente.

Após criar o template, podemos chamá-lo através de um shortcode em um artigo ou página.

Exemplo de código curto

Adicione o seguinte código de acesso à sua postagem ou página:

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

[] é usado no shortcode acima para evitar que o shortcode do artigo seja escapado. No uso real, o símbolo [] precisa ser alterado para o padrão [].

Descrição do parâmetro shortcode

1. template="jiawen.php"
   Especifique o nome do arquivo de modelo personalizado, o caminho é relativo ao /wp-content/ do.

2. posts_per_page="10"
10Mostrando 10 artigos;
   -1Exibir todos os artigos, mas não é recomendado definir无限Se houver muitos artigos, o site poderá travar porque não conseguirá carregar todos os artigos.

3. ignore_sticky_posts="yes"
   Ignore artigos fixados.

4. id="32277,30806"
   Exiba apenas artigos com o ID especificado. Dois IDs de artigos são especificados aqui, 32277 e 30806. Somente artigos correspondentes a esses dois IDs serão exibidos.

总结

• Caminho do modelo personalizado: expanda o caminho padrão por meio de filtros para evitar a perda de modelos em atualizações de plug-ins.
• Criar arquivo de modelo: Controle o layout e o conteúdo da lista de artigos através do código PHP.
• Arquivo de modelo de chamada: A chamada flexível é obtida por meio de parâmetros de shortcode.

A capacidade de personalizar caminhos de modelo melhora muito a flexibilidade do plug-in Shortcodes Ultimate.

Dessa forma, temos controle total sobre como nossa lista de artigos é exibida.

Esta abordagem é particularmente importante quando precisamos obter designs diversos em páginas diferentes.

Se você quiser deixar seu site WordPress mais personalizado, experimente!