Spiegazione dettagliata di u codice di percorsu di u mudellu persunalizatu per u plugin WordPress Shortcodes Ultimate

Avete mai dumandatu cumu persunalizà un percorsu di mudellu unicu in u plug-in Shortcodes Ultimate?

Ùn ci hè bisognu di invidià quelli maestri tecnichi chì ghjucanu cù WordPress, perchè avà vi purteraghju per revelà u sicretu daretu à questu!

Andemu, andemu drittu à u puntu è fate un passu à passu !

Cosa hè u plugin Shortcodes Ultimate?

Shortcodes Ultimate hè unu di i plugins più populari in WordPress Puderà facilmente implementà diverse funzioni attraversu shortcodes, cum'è a creazione di buttuni, carrusels d'imaghjini, elenchi d'articuli, etc.

Ancu megliu, pudemu persunalizà u percorsu di u mudellu per vede u cuntenutu più flexible.

Cumu aghjunghje una strada di mudellu persunalizata?

Fighjemu prima u passu più criticu - aghjunghjendu una strada di mudellu persunalizata.

Questu hè u primu passu versu a presentazione persunalizata!

esempiu codice

in u vostru tema functions.php Aghjunghjite u codice seguente à u schedariu o plugin persunalizatu:

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

        return $locations;
    },
    10,
    1
);

parse codice

1. 过滤器 su/shortcode/posts/allowed_template_locations
   Stu filtru ci permette di allargà i percorsi di mudelli predeterminati di Shortcodes Ultimate.

2. Strada persunalizata /wp-content/custom-templates/
   Guardemu u mudellu in /wp-content/custom-templates/ directory per ùn esse persu quandu aghjurnà u plugin.

3. 性
   Ùn mai mudificà u schedariu di mudellu predeterminatu di un plugin direttamente per evità di perde u cuntenutu persunalizatu dopu chì u plugin hè aghjurnatu.

Crea un schedariu di mudellu persunalizatu

Dopu, avemu bisognu di creà u schedariu di mudellu in u percorsu persunalizatu.

Per esempiu, avemu creatu un schedariu chjamatu jiawen.php schedariu mudellu.

Esempiu di schedariu di mudellu

in /wp-content/custom-templates/ annuariu, creà jiawen.php file è aghjunghje u codice seguente:

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

Descrizzione di u schedariu mudellu

• $atts['class']: Ci permette di persunalizà e classi CSS è cuncepisce stili unichi per mudelli.
• Miniatura di l'articulu è titulu: Mostra a miniatura è u titulu di l'articulu è ligame à a pagina di dettagli di l'articulu.
• 性: usu defined('ABSPATH') || exit; Assicuratevi chì i schedarii di mudelli ùn ponu micca accede direttamente.

Dopu avè creatu u mudellu, pudemu chjamà per mezu di un shortcode in un articulu o pagina.

Esempiu di shortcode

Aghjunghjite u seguente shortcode à u vostru post o pagina:

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

[] hè utilizatu in u shortcode sopra per impedisce u shortcode in l'articulu di esse scappatu In l'usu propiu, u simbulu [] deve esse cambiatu à u standard [].

Descrizione di i paràmetri di Shortcode

1. template="jiawen.php"
   Specificate u nome di u schedariu di mudellu persunalizatu, a strada hè relative /wp-content/ di.

2. posts_per_page="10"
10Mostra 10 articuli;
   -1Mostra tutti l'articuli, ma ùn hè micca cunsigliatu per stabilisceillimitatuSe ci sò troppu articuli, u situ web pò fallu perchè ùn pò micca carricà tutti l'articuli.

3. ignore_sticky_posts="yes"
   Ignora l'articuli pinned.

4. id="32277,30806"
   Mostra solu articuli cù l'ID specificata. Dui ID d'articuli sò specificati quì, 32277 è 30806. Solu articuli chì currispondenu à sti dui ID seranu visualizati.

总结

• Percorsu di mudellu persunalizatu: Espande u percorsu predeterminatu attraversu i filtri per evità di perde mudelli in l'aghjurnamenti di plug-in.
• Crea un schedariu di mudellu: Cuntrolla u layout è u cuntenutu di a lista di l'articuli attraversu u codice PHP.
• Chjamate u schedariu mudellu: A chjama flessibile hè ottenuta attraversu i paràmetri di shortcode.

A capacità di persunalizà i percorsi di mudelli migliora assai a flessibilità di u plug-in Shortcodes Ultimate.

In questu modu, avemu un cuntrollu tutale di cumu si mostra a nostra lista d'articuli.

Stu approcciu hè particularmente impurtante quandu avemu bisognu di ottene diversi disinni in diverse pagine.

Se vulete fà u vostru situ WordPress più persunalizatu, pruvate!