• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

「関数リファレンス/get post ancestors」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function Reference/get post ancestors 19:03, 16 March 2010 Ancawonka)
 
(全体を和訳。サンプルコードを追加。)
1行目: 1行目:
== Description ==
+
<div id="Description">
Retrieve the parents of the post based on the post ID.
+
== 説明 ==
 +
</div>
  
== Usage ==
+
指定した投稿の先祖の投稿 ID を配列で取得します。
%%%<?php get_post_ancestors( $post ) ?>%%%
+
  
== Parameters ==
 
{{Parameter|$post|mixed|Post ID or post object.|required}}
 
  
== Return Values ==
+
<div id="Usage">
; <tt>(array)</tt> : Array of IDs or empty if no ancestors are found.  The parent is returned as the first value in the array.
+
== 使い方 ==
 +
</div>
  
== Examples ==
+
<?php get_post_ancestors( $post ) ?>
 +
 
 +
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
 +
 
 +
{{Parameter|$post|整数またはオブジェクト|投稿 ID または投稿オブジェクト}}
 +
 
 +
 
 +
<div id="Return_Values">
 +
== 戻り値 ==
 +
</div>
 +
 
 +
; <tt>(配列)</tt> : 先祖の投稿 ID の配列。先祖の投稿が無い場合は空の配列。配列の最初には親投稿の ID が入っています。以降、その親投稿の ID, ... 最上位(親を持たない)の投稿 ID と順に配列に入っています。
 +
 
 +
<div id="Examples">
 +
== 用例 ==
 +
</div>
 +
 
 +
現在のページが、固定ページ ID =123の子孫なら '固定ページ ID 123 の子孫ページです' と表示する:
 +
 
 +
<pre>if ( in_array(123, get_post_ancestors( $post->ID ) ) )
 +
  echo '固定ページ ID 123 の子孫ページです';</pre>
  
 
== Notes ==
 
== Notes ==
  
== Change Log  ==
+
<div id="Change_Log">
Since: 2.5.0
+
== 変更履歴 ==
 +
</div>
 +
 
 +
* [[Version 2.5|バージョン 2.5]] : 新規導入
 +
 
 +
<div id="Source_File">
 +
== ソースファイル ==
 +
</div>
  
== Source File ==
+
<tt>get_post_ancestors()</tt> {{Trac|wp-includes/post.php}} に含まれています。
<tt>get_post_ancestors()</tt> is located in {{Trac|wp-includes/post.php}}.
+
  
== Related ==
+
<div id="Related">
 +
== 関連資料 ==
 +
</div>
  
 
{{Tag Footer}}
 
{{Tag Footer}}

2010年4月30日 (金) 00:16時点における版

指定した投稿の先祖の投稿 ID を配列で取得します。


使い方

<?php get_post_ancestors( $post ) ?>

パラメータ

$post
整数またはオブジェクト) (必須) 投稿 ID または投稿オブジェクト
初期値: なし


戻り値

(配列) 
先祖の投稿 ID の配列。先祖の投稿が無い場合は空の配列。配列の最初には親投稿の ID が入っています。以降、その親投稿の ID, ... 最上位(親を持たない)の投稿 ID と順に配列に入っています。

用例

現在のページが、固定ページ ID =123の子孫なら '固定ページ ID 123 の子孫ページです' と表示する:

if ( in_array(123, get_post_ancestors( $post->ID ) ) )
  echo '固定ページ ID 123 の子孫ページです';

Notes

変更履歴

ソースファイル

get_post_ancestors()wp-includes/post.php に含まれています。


関数リファレンステンプレートタグ目次もご覧ください。

最新英語版: WordPress Codex » Function Reference/get post ancestors最新版との差分