Detaillierte Erläuterung des benutzerdefinierten Vorlagenpfadcodes für das WordPress Shortcodes Ultimate-Plugin

Haben Sie sich jemals gefragt, wie Sie einen eindeutigen Vorlagenpfad im Shortcodes Ultimate-Plug-in anpassen können?

Kein Grund, die technischen Meister, die mit WordPress spielen, zu beneiden, denn jetzt enthülle ich Ihnen das Geheimnis dahinter!

Komm, lass uns direkt zur Sache kommen und es Schritt für Schritt angehen!

Was ist das Shortcodes Ultimate-Plugin?

Shortcodes Ultimate ist eines der beliebtesten Plugins in WordPress. Es kann problemlos verschiedene Funktionen über Shortcodes implementieren, wie zum Beispiel das Erstellen von Schaltflächen, Bildkarussells, Artikellisten usw.

Noch besser: Wir können den Vorlagenpfad anpassen, um Inhalte flexibler anzuzeigen.

Wie füge ich einen benutzerdefinierten Vorlagenpfad hinzu?

Schauen wir uns zunächst den wichtigsten Schritt an – das Hinzufügen eines benutzerdefinierten Vorlagenpfads.

Dies ist der erste Schritt zur personalisierten Präsentation!

Codebeispiel

in deinem Thema functions.php Fügen Sie der Datei oder dem benutzerdefinierten Plugin den folgenden Code hinzu:

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

        return $locations;
    },
    10,
    1
);

Code analysieren

1. Filter su/shortcode/posts/allowed_template_locations
   Mit diesem Filter können wir die Standardvorlagenpfade von Shortcodes Ultimate erweitern.

2. benutzerdefinierter Pfad /wp-content/custom-templates/
   Wir speichern die Vorlage in /wp-content/custom-templates/ Verzeichnis, damit es bei der Aktualisierung des Plugins nicht verloren geht.

3. 安全 性
   Ändern Sie niemals die Standardvorlagendatei eines Plugins direkt, um zu vermeiden, dass benutzerdefinierte Inhalte nach der Aktualisierung des Plugins verloren gehen.

Erstellen Sie eine benutzerdefinierte Vorlagendatei

Als nächstes müssen wir die Vorlagendatei im benutzerdefinierten Pfad erstellen.

Wir erstellen zum Beispiel eine Datei mit dem Namen jiawen.php Vorlagendatei.

Beispiel einer Vorlagendatei

在 /wp-content/custom-templates/ Verzeichnis, erstellen jiawen.php Datei und fügen Sie den folgenden Code hinzu:

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

Beschreibung der Vorlagendatei

• $atts['class']: Ermöglicht uns, CSS-Klassen anzupassen und einzigartige Stile für Vorlagen zu entwerfen.
• Miniaturansicht und Titel des Artikels: Zeigt die Miniaturansicht und den Titel des Artikels sowie einen Link zur Artikeldetailseite an.
• 安全 性:verwenden defined('ABSPATH') || exit; Stellen Sie sicher, dass auf Vorlagendateien nicht direkt zugegriffen werden kann.

Nachdem wir die Vorlage erstellt haben, können wir sie über einen Shortcode in einem Artikel oder einer Seite aufrufen.

Shortcode-Beispiel

Fügen Sie Ihrem Beitrag oder Ihrer Seite den folgenden Shortcode hinzu:

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

[] wird im obigen Shortcode verwendet, um zu verhindern, dass der Shortcode im Artikel maskiert wird. Bei der tatsächlichen Verwendung muss das Symbol [] in das Standardsymbol [] geändert werden.

Beschreibung der Shortcode-Parameter

1. template="jiawen.php"
   Geben Sie den Namen der benutzerdefinierten Vorlagendatei an, zu der der Pfad relativ ist /wp-content/ von.

2. posts_per_page="10"
1010 Artikel werden angezeigt;
   -1Alle Artikel anzeigen, aber es wird nicht empfohlen,无限Bei zu vielen Artikeln kann es zum Absturz der Website kommen, da nicht alle Artikel geladen werden können.

3. ignore_sticky_posts="yes"
   Angepinnte Artikel ignorieren.

4. id="32277,30806"
   Nur Artikel mit der angegebenen ID anzeigen. Hier werden zwei Artikel-IDs angegeben, 32277 und 30806. Es werden nur Artikel angezeigt, die diesen beiden IDs entsprechen.

总结

• Benutzerdefinierter Vorlagenpfad: Erweitern Sie den Standardpfad durch Filter, um den Verlust von Vorlagen bei Plug-in-Updates zu vermeiden.
• Vorlagendatei erstellen: Steuern Sie das Layout und den Inhalt der Artikelliste über PHP-Code.
• Aufrufvorlagendatei: Flexible Anrufe werden durch Shortcode-Parameter erreicht.

Die Möglichkeit, Vorlagenpfade anzupassen, verbessert die Flexibilität des Shortcodes Ultimate-Plug-ins erheblich.

Dadurch haben wir die volle Kontrolle darüber, wie unsere Artikelliste angezeigt wird.

Dieser Ansatz ist besonders wichtig, wenn wir auf verschiedenen Seiten unterschiedliche Designs erzielen müssen.

Wenn Sie Ihre WordPress-Website persönlicher gestalten möchten, probieren Sie es aus!