WordPress Shortcodes Ultimate プラグインのカスタム テンプレート パス コードの詳細な説明

Shortcodes Ultimate プラグインで独自のテンプレート パスをカスタマイズする方法を疑問に思ったことはありますか?

WordPress を使って遊んでいる技術の達人を羨む必要はありません。今から私がその背後にある秘密を明らかにしていきます。

さあ、早速本題に入り、段階的にやっていきましょう！

Shortcodes Ultimate プラグインとは何ですか?

Shortcodes Ultimate は、WordPress で最も人気のあるプラグインの 1 つで、ボタン、画像カルーセル、記事リストなどの作成など、さまざまな機能をショートコードを通じて簡単に実装できます。

さらに良いのは、テンプレート パスをカスタマイズして、コンテンツをより柔軟に表示できることです。

カスタム テンプレート パスを追加するにはどうすればよいですか?

まず、最も重要なステップであるカスタム テンプレート パスの追加を見てみましょう。

これがパーソナライズされたプレゼンテーションへの第一歩です。

コード例

あなたのトピックで functions.php 次のコードをファイルまたはカスタム プラグインに追加します。

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

        return $locations;
    },
    10,
    1
);

コードを解析する

1. フィルター su/shortcode/posts/allowed_template_locations
   このフィルターを使用すると、Shortcodes Ultimate のデフォルトのテンプレート パスを拡張できます。

2. カスタムパス /wp-content/custom-templates/
   テンプレートを保存します /wp-content/custom-templates/ プラグインの更新時にディレクトリが失われないようにします。

3. 安全性
   プラグインの更新後にカスタム コンテンツが失われないように、プラグインのデフォルトのテンプレート ファイルを直接変更しないでください。

カスタムテンプレートファイルを作成する

次に、カスタム パスにテンプレート ファイルを作成する必要があります。

たとえば、次のようなファイルを作成します。 jiawen.php テンプレートファイル。

テンプレートファイルの例

で /wp-content/custom-templates/ ディレクトリ、作成 jiawen.php ファイルを開き、次のコードを追加します。

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

テンプレートファイルの説明

• $atts['class']: CSS クラスをカスタマイズし、テンプレートの独自のスタイルをデザインできます。
• 記事のサムネイルとタイトル：記事のサムネイルとタイトル、記事詳細ページへのリンクを表示します。
• 安全性：使用 defined('ABSPATH') || exit; テンプレート ファイルに直接アクセスできないようにしてください。

テンプレートを作成したら、記事またはページ内のショートコードを通じてそれを呼び出すことができます。

ショートコードの例

次のショートコードを投稿またはページに追加します。

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

上記ショートコードで[]を使用しているのは、記事内のショートコードがエスケープされないようにするためです。実際に使用する場合は、記号[]を標準の[]に変更する必要があります。

ショートコードパラメータの説明

1. template="jiawen.php"
   カスタム テンプレート ファイルの名前を指定します。パスは相対パスです。 /wp-content/ の。

2. posts_per_page="10"
1010件の記事を表示しています。
   -1すべての記事を表示しますが、設定することはお勧めしません无限記事が多すぎると、すべての記事を読み込めないため、Web サイトがクラッシュする可能性があります。

3. ignore_sticky_posts="yes"
   固定された記事は無視してください。

4. id="32277,30806"
   指定したIDの記事のみを表示します。ここでは 32277 つの記事 ID、30806 と XNUMX が指定されています。この XNUMX つの ID に該当する記事のみが表示されます。

サマリー

• カスタムテンプレートのパス: プラグインの更新でテンプレートが失われないように、フィルターを介してデフォルトのパスを拡張します。
• テンプレートファイルの作成: PHP コードを通じて記事リストのレイアウトとコンテンツを制御します。
• 呼び出しテンプレートファイル: ショートコードパラメータによる柔軟な呼び出し。

テンプレート パスをカスタマイズできる機能により、Shortcodes Ultimate プラグインの柔軟性が大幅に向上します。

このようにして、記事リストの表示方法を完全に制御できます。

このアプローチは、さまざまなページで多様なデザインを実現する必要がある場合に特に重要です。

WordPress ウェブサイトをよりパーソナライズしたい場合は、ぜひ試してみてください。