「get_template_part」でディレクトリを遡ったり掘ったりする書き方

Question

Wordpressのget_template_part()の使い方について質問です。

下記のディレクトリ階層において、
【output.php】で、【target.php】を呼びたい。
と思っているのですが、

出力先ディレクトリ	呼出元ディレクトリ
wp-content	wp-content
plugins	themes
buddypress	twentyseventeen-child
custom_user	template-parts
【output.php】	【target.php】

この場合、【output.php】で★の部分にはどう書けばよろしいでしょうか？
get_template_part( '★' )

ひとまずwp-contentまで溯って、さらにそこから掘っていく(?)のような書き方になると思うのですが、いろいろ試してもできませんでした。

ご存知の方がいらっしゃいましたら教えて下さいませ。

Comments

[CHERRY]

実際に試された例をいくつか記載してください。

Answer 1

関数リファレンス/get_template_part に

テンプレートパーツ（ヘッダー、サイドバー、フッターを除きます）をテンプレートへ読み込みます。これにより、テーマがコードのセクションを再利用すること、また子テーマが親テーマのセクションを置き換えることが容易になります。

とあるように、この関数はテーマディレクトリの中で、親テーマ・子テーマのファイルの置き換えをするために用意されている関数です。

わざわざ、テーマディレクトリ以外から呼び出したい意味は何でしょうか？

テーマフォルダ以外であれば、普通に php の require ( ABSPATH . "/WordPressのディレクトリからのパス" ); で良いと思いますが...
※ ABSPATH は、 WordPress の index.php や wp-config.php のあるディレクトリです。

Comments

[EggBenedict]

なるほど。「テーマディレクトリの中で、親テーマ・子テーマのファイルの置き換えをするために用意されている関数」ということ、覚えておきます。

普通にPHPでの呼び出し関数もあるのですね。当たり前か。今後の参考にさせて頂きます。

ありがとうございます。

・・・

以下は蛇足ですが、

「わざわざ、テーマディレクトリ以外から呼び出したい意味」についてですが、必須ではなくなんとなくな考え方です。

その考え方とは、「【target.php】は子テーマの他のファイルからも呼んでるから移動したくないし、かといって【output.php】はこちらのサイト（http://www.kaasan.info/archives/2452）に「ここに置いたよ」と書いてあるからあえて移動させるのも怖いし、なら２つのファイルはこの位置のままにしたい。だからテーマディレクトリ以外から呼び出したいな。」というものでした。

Answer 2

普通に

get_template_part('template-parts/target');

であかんかったの？

Comments

[EggBenedict]

いけました…
ディレクトリの「/」をたくさん書いたり、戻るための「...」を書いたり、一人でてんやわんやしていました。笑
ありがとうございます。