WordPressのループ処理の中にショートコードの引数の値を使って記事を出力させたい

解決済

回答 1

投稿 編集

  • 評価
  • クリップ 0
  • VIEW 327

aguu0101

score 9

前提・実現したいこと

ワードプレスのショートコードの引数をループの処理に使って特定のカテゴリや新着記事等を出力させたいです。

発生している問題・理解できていないこと

該当のソースコードをみていただければ早いかと思いますが、

print_number()の関数内で作成した変数を関数外で使用することができれば問題は解決すると思っているのですが、
global宣言しても解決できず。。

どこに問題があるのかわからずご質問しました。

該当のソースコード

<?php
    // 未定義の関数を初期化
    $title = null;
    $number = null;
    $category = null;

    // ショートコードの引数を設定して変数に代入→配列で出力
    function print_number($atts){
        $atts = shortcode_atts(array(
            "title" => タイトル,
            "number" => 5,
            "category" => カテゴリ名
        ),$atts);

        $atts['title'] = $title;
        $atts['number'] = $nubmer;
        $atts['category'] = $category;

        return array($title,$number,$category);
    }
    add_shortcode('file_include','print_number');

    // ループ処理の設定(配列の変数を取得してループ処理に追加
    $news_query = new WP_Query(
        array(
            'post_type'      => 'post',
            'category_name' => $category,
            'posts_per_page' => $number,
        )
    );
?>
<div class="space_wrapper">
    <div class="space_ttl">
        <p>

        </p>
    </div>
    <ul>
        <?php if ( $news_query->have_posts() ) : ?>
          <?php while ( $news_query->have_posts() ) : ?>
            <?php $news_query->the_post(); ?>
        <li>
            <a href="">
                <div class="space_cat_inner">
                    <div class="space_cat_thumb">
                        <img src="#" alt="サンプル画像">
                    </div>
                    <div class="space_cat_meta">
                        <h2 class="post-list-title entry-title">
                            ここにタイトルが入ります。ここにタイトルが入ります。ここにタイトルが入ります。ここにタイトルが入ります。
                        </h2>
                    </div>
                </div>
            </a>
        </li>
        <?php endwhile; ?>
        <?php endif; ?>
        <?php wp_reset_postdata(); ?>
    </ul>
</div>

試したこと

先述の通り、変数をglobal宣言してみましたが何も出力せず。。
エラー等も出ていないので、どこから着手すればいいかわからずじまいになっています。

補足情報

・WordPressのバージョン WordPress 5.1.1
・使用しているブラウザ   GoogleChrome
・PHPバージョン 7.0
・使用サーバー mixhost

追記情報

ショートコードを書き忘れていたので追加します。。。

[file_include file='category' title='タイトル' number='2' category='test']

またショートコードは投稿でも固定ページにも両方使います。

追記情報その2

ディレクトリ構造とショートコードについて補足いたします。

plugins(プラグイン名)
┗functions.phptemplatecategory.php

今回のショートコードは問題のショートコードとは別に
「プラグイン内のphpファイルを呼び出すための引数」も設定しています。

file='category'


ショートコードの上記の記述はそのための記述なので、問題とは関係がないかと。。
また、phpファイルを呼び出す引数の設定は、functions.phpに記載しています。

function space_article($params = array()) {
  extract(shortcode_atts(array('file' => 'default'), $params));
  ob_start();
  include(plugin_dir_path( __FILE__ ) . "templates/$file.php");
  return ob_get_clean();
}
add_shortcode('file_include', 'space_article');

関係はないと思いますが一応載せておきます。。

  • 気になる質問をクリップする

    クリップした質問は、後からいつでもマイページで確認できます。

    またクリップした質問に回答があった際、通知やメールを受け取ることができます。

    クリップを取り消します

  • 良い質問の評価を上げる

    以下のような質問は評価を上げましょう

    • 質問内容が明確
    • 自分も答えを知りたい
    • 質問者以外のユーザにも役立つ

    評価が高い質問は、TOPページの「注目」タブのフィードに表示されやすくなります。

    質問の評価を上げたことを取り消します

  • 評価を下げられる数の上限に達しました

    評価を下げることができません

    • 1日5回まで評価を下げられます
    • 1日に1ユーザに対して2回まで評価を下げられます

    質問の評価を下げる

    teratailでは下記のような質問を「具体的に困っていることがない質問」、「サイトポリシーに違反する質問」と定義し、推奨していません。

    • プログラミングに関係のない質問
    • やってほしいことだけを記載した丸投げの質問
    • 問題・課題が含まれていない質問
    • 意図的に内容が抹消された質問
    • 広告と受け取られるような投稿

    評価が下がると、TOPページの「アクティブ」「注目」タブのフィードに表示されにくくなります。

    質問の評価を下げたことを取り消します

    この機能は開放されていません

    評価を下げる条件を満たしてません

    評価を下げる理由を選択してください

    詳細な説明はこちら

    上記に当てはまらず、質問内容が明確になっていない質問には「情報の追加・修正依頼」機能からコメントをしてください。

    質問の評価を下げる機能の利用条件

    この機能を利用するためには、以下の事項を行う必要があります。

質問への追記・修正、ベストアンサー選択の依頼

  • CHERRY

    2019/05/08 14:49 編集

    ショートコードは、どこに書かれているのでしょうか?

    投稿の本文?  phpファイルに直接?  その他?

    キャンセル

  • aguu0101

    2019/05/08 14:52

    ご連絡ありがとうございます!
    追記の情報に追加させていただきましたのでご確認していただけると嬉しいです。

    キャンセル

  • CHERRY

    2019/05/08 14:55

    ショートコードは、通常、 the_content() が実行されたタイミングで、ショートコードの実行がされますが、 質問に記載されたコードでは、 the_content() が使われていないようですが... どこか省略されていたりしますか?

    キャンセル

  • aguu0101

    2019/05/08 16:04

    ご回答ありがとうございます。

    追記の情報にもご連絡させていただきましたが、該当のファイル(category.php)をショートコードの引数で呼び出して使いますのでthe_content()は必要ないかと思うのですが間違ってますでしょうか??

    キャンセル

回答 1

checkベストアンサー

+1

なにをしようとしているのか把握できていませんが、コードを眺めて、いくつか気になった点を指摘しておきます。


    add_shortcode('file_include','print_number');
    add_shortcode('file_include', 'space_article');

質問に記載されているコードでは、同じ名前のショートコードを add_shortcode() している部分が2つありますが、同じショートコード名で、別の処理を定義しているのでしょうか?

add_shortcode に

各ショートコードには、ひとつだけフックを定義することができます。そのため、他のプラグインが同じショートコードを持っていると、他のプラグインによってフックが上書きされるか、または他のプラグインのフックを上書きしてしまいます。どちらになるかは、プラグインの読み込み順または実行の順番に左右されます。

と記載されている通り、1つの WordPress 上では、WordPress core やプラグインやテーマで、同じショートコードの名前に2つ(以上)の内容を定義することはできません。


   function print_number($atts){
       (略)
       return array($title,$number,$category);
   }
   add_shortcode('file_include','print_number');

(変数が未定義なので、Notice: Undefined variable ...  がでるという問題は置いておいて... )

ショートコードの結果を配列で返していますが、WordPress が期待する do_shortcode を実行した返り値は、コンテンツのショートコードを実行した結果に置き換えた結果の「文字列」です。

質問のコードだと下記のような配列を変数に代入する

function arr(){
    return array(1, 2, 3);
}

$a = '';
$a = arr();
echo $a;     //  'Array'が表示される 

の様な処理になるので、配列で返された場合は、文字列 Array が返されて、Notice: Array to string conversion in ... のメッセージが出力されるような気がします。(未確認)


add_shortcode() は、ショートコードの内容を定義するだけですので、 do_shortcode() が実行されない限りショートコードは、実行された結果を返しませんが、どこで実行されていますか?

通常のテーマで、 do_shortcode() を記載していない状態でも本文に記載したショートコードが実行されるのは、本文を表示する処理である the_content() の中で、the_content フックを利用して、do_shortcode() が、呼び出されて実行されているので、本文表示時にショートコードは、実行結果に置き換えて表示されます。( do_shortcode 参照 )

投稿

編集

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

  • 2019/05/09 14:24

    ご指摘ありがとうございます!

    伝わるかどうかはわかりませんが、やりたいこととしては

    「プラグイン内にあるファイルをショートコードで呼び出して、且つ同じショートコードで記事のカテゴリや
    表示記事数を設定し、その設定したカテゴリや表示記事数に応じて記事を表示させたいです。」

    add_shortcode() に複数の定義を設定してはいけないということは上記のやりたいことを実現することは不可能なのでしょうか?

    また、do_shortcode()の件で同じ質問なのですが、投稿や固定ページにショートコード(例えば、[file_include file='category' title='タイトル' number='2' category='test'])を記述するだけでは意味がないのでしょうか?

    このファイルは全てプラグインとして作成しているのですが、基本的にどのテーマテンプレートにもthe_content()の記述がある認識で作成しています。。

    この認識はそもそも間違っているということなのでしょうか?
    重ね重ね質問等が多く大変恐縮ではございますがご教示いただけますと幸いでございます。

    キャンセル

  • 2019/05/09 16:48 編集

    質問の中にある functions.php や category.php というファイルは、テーマの中にあるファイルと思って回答していたのですが、自作プラグインの中にあるのファイルでしょうか?

    ----

    まだ、イマイチ理解できていませんが...

    > 「プラグイン内にあるファイルをショートコードで呼び出して、且つ同じショートコードで記事のカテゴリや
    表示記事数を設定し、その設定したカテゴリや表示記事数に応じて記事を表示させたいです。」


    「プラグイン内にあるファイル」というのがよくわかりませんが、表示用のテンプレートという意味であれば、ショートコードから複数の値を return する必要はないように思えますが...

    たとえば、

    [shortcodename templatefile="template1" category="cagegory1" posts_per_page=”20″]

    のようなショートコードで呼び出だされた場合、ショートコードの function の中で、

    1. ショートコードで与えられたパラメータから検索条件を抽出。
    2. template file を読み込む
    3. 検索条件を設定して、 get_posts() や WP_Query で投稿を取得
    4. テンプレートに取得した投稿のデータを埋め込む
    5. 完成した HTML を return する

    という処理でよいと思うのですが...


    ここまで書いてから気が付きましたが、Display Posts Shortcode プラグイン( https://ja.wordpress.org/plugins/display-posts-shortcode/https://github.com/billerickson/display-posts-shortcode ) のテンプレートが変更できるバージョンを作成したいという感じでしょうか?

    キャンセル

  • 2019/06/03 19:07

    ご連絡遅くなり申し訳ございません!!

    取り急ぎご報告ですが実装したい機能を実装することができました!
    ご協力いただきありがとうございます。

    色々勘違いしてしまい、CHERRYさんのヒントを元に
    もう一度一からやり直して以下をfunctions.phpに記載し
    ショートコードで呼び出すことでできました。

    //ショートコードで記事一覧を表示させる
    function print_post($atts){
    $retHTML='';
    $args = array(
    'posts_per_page' => $atts['count'],
    'orderby' => 'date',
    'order' => 'DESC',
    'post_type' => 'post',
    'category' => $atts['category'],
    'include' => $atts['id'],
    );
    global $post;
    $myposts = get_posts($args);
    foreach($myposts as $post):
    setup_postdata($post);
    $retHTML.='<li><a href="'.get_permalink().'">'.'<div class="space_thumb">'.get_the_post_thumbnail('',array(640,360)).'</div>';
    $retHTML.='<div class="space_title"><span class="space_icon">'.get_the_date('Y.n.j').'</span><p>'.the_title("","",false).'</p></div>'.'</a></li>';
    endforeach;
    wp_reset_postdata();
    return '<div id="spaceArticle"><p>'.$atts['name'].'</p><ul id="spaceList">'.$retHTML.'</ul></div>';
    }
    add_shortcode('space','print_post');

    =====================================

    ここまで書いてから気が付きましたが、Display Posts Shortcode プラグイン( https://ja.wordpress.org/plugins/display-posts-shortcode/https://github.com/billerickson/display-posts-shortcode ) のテンプレートが変更できるバージョンを作成したいという感じでしょうか?

    =====================================

    また上記ですが、全くその通りです。。
    ここまで項目は多くなくて

    カテゴリ、タグ、記事ID、表示記事数

    くらいを設定することができれば大丈夫ですが。。
    重ね重ねではございますが、今回がご回答いただきありがとうございました。

    キャンセル

15分調べてもわからないことは、teratailで質問しよう!

  • ただいまの回答率 90.21%
  • 質問をまとめることで、思考を整理して素早く解決
  • テンプレート機能で、簡単に質問をまとめられる