WordPressをカスタマイズするなら【予約語】を知っておこう!
WordPressには、カスタム投稿名などでの使用を禁止されている文字列があります。
これを【予約語】と言います。
この予約語をカスタム投稿名やカスタムタクソノミー名で使用してしまうと、以下のような不具合が生じます。
- 投稿が正常に表示されない
- 404エラーが返される
- タクソノミーアーカイブが西方に表示されない
- etc…
以前に漫画レビューブログの構築を担当させていただいたことがあります。
この案件で、カスタムタクソノミーを使って漫画の著者を管理することになりました。
著者のカスタムタクソノミーだからと、安易に【author】という文字列を使ったのが失敗でした。
これが実は予約語だったのです。
使っちゃいけない予約語を使ったわけですから、当然変な挙動をします。
予約語の存在を知らなかったので、原因の特定にかなり時間を要してしまいました。
WordPressでカスタマイズをするのであれば、予約語の存在は知っておく必要があります。
以下に予約語の一覧をまとめておきますので、参考にしてください。
WordPressの予約語リスト
予約語一覧をご覧ください。
- attachment
- attachment_id
- author
- author_name
- calendar
- cat
- category
- category__and
- category__in
- category__not_in
- category_name
- comments_per_page
- comments_popup
- customize_messenger_channel
- customized
- cpage
- day
- debug
- error
- exact
- feed
- fields
- hour
- link_category
- m
- minute
- monthnum
- more
- name
- nav_menu
- nonce
- nopaging
- offset
- order
- orderby
- p
- page
- page_id
- paged
- pagename
- pb
- perm
- post
- post__in
- post__not_in
- post_format
- post_mime_type
- post_status
- post_tag
- post_type
- posts
- posts_per_archive_page
- posts_per_page
- preview
- robots
- s
- search
- second
- sentence
- showposts
- static
- subpost
- subpost_id
- tag
- tag__and
- tag__in
- tag__not_in
- tag_id
- tag_slug__and
- tag_slug__in
- taxonomy
- tb
- term
- theme
- type
- w
- withcomments
- withoutcomments
- year
関数リファレンス/register taxonomyの予約語から抜粋
まとめ
カスタム投稿名などで使えないWordpressの予約語をまとめてみました。
カスタム投稿やカスタムタクソノミーを作成する時、予約語を使わないように注意が必要です。
既に何かしらの不具合が生じている場合、その原因が予約語にないか確認してみましょう。
コメントを残す