add_permastruct

(3.0.0以降)
add_permastruct - 投稿タイプのパーマリンク設定を追加する

説明

void add_permastruct( string $name, string $struct [ , mixed $args = array() ] )
投稿タイプのパーマリンク設定を追加する。

パラメータ

  • $name
    投稿タイプ名を指定。
  • $struct
    パーマリンクのURLパターンを指定。
  • $args
    パーマリンク設定の属性を連想配列で指定。
    キーデフォルト値
    'with_front'booltrue
    'ep_mask'intEP_NONE(0)
    'paged'booltrue
    'feed'booltrue
    'forcomments'boolfalse
    'walk_dirs'booltrue
    'endpoints'booltrue

返り値

返り値はありません。

注意

本関数は3.4でパラメータ仕様が変更されている。3.0~3.3までの呼び出し形式は次の通りで、3.4以降の環境において下記の指定で呼び出された場合でも互換性は保たれている。
add_permastruct( string $name, string $struct [ , bool $with_front = true [ , int $ep_mask = EP_NONE ] ] )
パーマリンクのURLパターンは、末尾の'/'が無視される以外に制限はなく、日本語を使用する場合はそのまま(URLエンコードは不要)指定できる。
なお本関数で追加したパーマリンク設定はそのままではシステムに反映されないため、適宜flush_rewrite_rules関数を呼び出すか、管理者ページの「設定」-「パーマリンク設定」を開き、「変更を保存」ボタンをクリックする必要がある。

使用例

  • カスタム投稿タイプ'tool'のパーマリンクに拡張子htmlを設定する。
    <?php add_permastruct( 'tool', 'tool/%tool%.html', array( 'ep_mask'=>EP_PERMALINK ) ); ?>
  • カスタム投稿タイプ'tool'のパーマリンクのディレクトリ名を'tool'から'道具'に変更する。
    <?php add_permastruct( 'tool', '道具/%tool%', array( 'ep_mask'=>EP_PERMALINK ) ); ?>

フィルター

実行するフィルターはありません。

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/rewrite.php

関連

お勧めコンテンツ

決まった値を返すだけの関数群(2015年7月15日 登録)

WordPressのソースコードを眺めているとフィルター関数名で'__return_○○'が指定されている部分を時々見かけます。それらの関数定義を見てみると、すべて決まった値を単純に返すだけでした。これらの関数がちょっと気になったので、まとめてみました。

「テキスト」モードと「ビジュアル」モードを行き来すると投稿内容の一部が消える(2015年3月14日 登録)

仕事がらサイトの引っ越し作業のお手伝いをすることがあるのですが、今回は引っ越しにあわせてWordPressを「3.7.1」から最新版「4.1.1」にアップデートすることになりました。ここで紹介するのはこの案件で発生したトラブルの話です。

Post-tag automaton:プラグイン作ってみました(2012年7月3日 登録)

みなさんは投稿をポストする際に投稿タグを付け忘れたことはないでしょうか。このプラグインは、投稿をポストする際にタイトルと記事に投稿タグが含まれていないか調べ、含まれていた場合はその投稿タグを追加します。

もうquery_postsは呼ばない(2011年9月27日 登録)

トップページやカテゴリーページで標準の条件に少し手を加えた投稿情報を表示するケースがある。そんな時、テンプレートファイルの先頭でquery_posts関数を呼び出して投稿情報を再抽出していたのだが、フィルター処理をうまく使えばquery_posts関数を呼び出さなくても大丈夫みたいだ。

3.8の「アクティビティ」ウィジェットに投稿以外の情報も表示する(2014年1月17日 登録)

ちょうど1月前の「ダッシュボードの「概要」にカスタム投稿タイプ件数を表示する」にて、WordPress 3.8新ダッシュボードの「概要」ウィジェットにカスタム投稿タイプの投稿数を表示する方法を紹介したが、今回のその続編で「アクティビティ」ウィジェットを拡張する方法を紹介する。

最終更新日時 : 2012-09-06 16:21