自分で作ったアニメーションやスクリプトを、作品というカテゴリで記事として投稿していました。しかし、カテゴリやタグをつける際に困りました。作品の中でJavaScriptやJava。備忘録の中でのJavaScriptやJava。と同じカテゴリ名で区分けしないと後で整理するときに面倒になります。そこで今回はカスタム投稿を使い、作品を記事からカスタム投稿へ移行しました。その際にやったことを記録しておきます。

カスタム投稿/タクソノミーの関数を使った追加方法

プラグインを使用する前に仕組みを理解します。

カスタムタクソノミーはタグかカテゴリとして設定できますが、タグを入力する分類を2つ以上用意するのは思いつきませでした。

カスタム分類（カスタムタクソノミー）機能を使って、「ルームタイプ」と「家具の種類」という分類も付けています。
WordPressでブログじゃないWebサイトを作るときのいろいろ（サンプル付き）

プラグインでカスタム投稿/タクソノミーを管理する

function.phpに記述しなくてもダッシュボードからカスタム投稿・カスタムタクソノミーは追加できるようになるプラグイン。どうやらregister_post_typeやregister_taxonomyはプラグインに記述しても有効になるらしいです。ようは1つのサイトならfunciton.phpに。複数テーマで使いまわすならプラグインにと、使い分けられています。

使用方法は下記を参考。

注意点

function.phpに自動で記述されるわけではない
登録されたカスタム投稿slugを変更すると、修正ではなく新規で登録されることになる。以前のものはそのままになっている。

カスタムフィールドの入力値に文字列以外のフォーマットを追加

カスタムフィールドは名前と値の組み合わせなのですが、この値が文字列しか入れれないというのは不便です。フォーマットやバリデートをかけたいですよね。このカスタムフィールドを柔軟に拡張できるすごいプラグインがありました。

Advanced Custom Fieldsの使い方

無料でもすごいのですが、有料版があるとのこと。合わせて出力方法まで別記事で丁寧に解説してくれいますが、解説がなくても直感的に使えるような関数が用意されていて便利だなと感じました。おそらくフィールド名で値をゲットするために、DBにはidなどの数値ではなく文字列で登録することが多いのかな。

Advanced Custom Fieldsの出力

Advanced Custom Fieldsの有料アドオンを購入。

Repeater Fieldという有料アドオンを公式サイトから購入しました。初めてwordpressの有料プラグインを購入しましたが、方法がとても簡単でした。

購入・導入手順

公式サイトにて購入をクリック
新規登録するアカウント情報を入力
paypalでログイン
オンラインレシートを受け取る
オンラインレシートに記述してあるリンクからプラグインであるzipファイルをDL
wordpressのダッシュボードからzipファイルを新規プラグインとしてアップロード
プラグインを有効化

注意点

オンラインレシートにあるライセンスキーを入力する必要はなかった。
Pro版だとライセンスが1サイトのみと無制限がある。
個別アドオンだと複数サイトにしようできるライセンスとなる

このアドオンによってカスタムフィールドを親子階層にすることができます。また作成したフィールドは1つの記事に対していくつも追加して値を登録することができます。

今回は作品使用した素材を1つずつカスタムフィールドで登録するために使用しました。このアドオンのお陰で、素材というカスタムフィールドを1列追加すると、素材名とURLを入力できる2つの欄が表示されます。

Tableレイアウトの投稿画面

この見た目はレイアウト設定で変更することができます。

Rowレイアウトの投稿画面

出力すると下記のようになります。

Advanced Custom Fieldsのカスタムフィールドはどのように登録されているのか

Advanced Custom Fieldsで登録したカスタムフィールドがどのようにDBに登録されているか確認したところ、meta_keyは親フィールド名_フィールド順序_子フィールド名となっていました。区切りに_（アンダーバー）が使われていたため単語区切りに_（アンダーバー）は使用せずにキャメルケースで記述した方が良いかと思われます。

meta_key	meta_value
material_0_material_name	グーグル
_material_0_material_name	field_5581556e5ed0c
material_0_material_url	http://www.google.co.jp/
_material_0_material_url	field_558155895ed0d

訂正

ここからカスタムフィールドの値を変更した際に、既存レコードを修正ではなく新規レコードとして登録されてしまう現象について記述していましたが原因がわかりました。ラベルではなくフィールド名を日本語にしていたため発生していたようです。英字に変更したところ、既存フィールドを更新するようになりました。日本語をkeyとするとこういうところでバグを生むのですね。念のため文章は残しておきます。

ちなみに、投稿画面で親子階層を持ったカスタムフィールドの順序を変えても新規レコードが追加されることはなく、既存レコードの値の順番の数値を書き換えてくれていました。

下記のサイトにも詳しい解説があります。カスタムフィールドは検索としては使用しない方がいいみたいです。
Advanced Custom Fieldsプラグインを使う際の注意点など | notnil creation weblog

「グーグル」という文字を「グーグル1」にダッシュボードから変更したところ、同フィールドグループの値すべてが新しいレコードとして登録されていました。_material~のfiledより後ろの連番は以前と違うものが登録されています。

追加されたレコード

また、入力したフィールド値だけでなく、下記のように毎回いくつのレコードを追加したかというデータ（レコード）まで一緒に登録されます。余計なデータが増えていく気がします。私には必要性がわかりませんでした。

meta_key	meta_value
materiall_name	2
_material	field_558155675ed0b

ただしどのレコード、つまりカスタムフィールドの値を変更せずに記事を更新した際は、重複したレコードが登録されることはありませんでした。

カスタムフィールドで親子階層を登録となると、別テーブルや親のレコードIDを保持するのかなと思いました。しかし、親も子もただのカスタムフィールドであり、既存テーブルであるwp_postmetaに登録されるので階層は文字列で表記されていました。

既存の記事をカスタム投稿に移行する

下記を参考に、プラグインで特定カテゴリの記事を一括で移行しました。カテゴリ単位でしか細かく指定できないので少し不便です。移行後にカスタムタクソノミーは手動でつけました。移行してもテーブルwp_postsに新規レコードが追加されるわけでなく、既存レコードのpost_typeを書き換えることを確認しました。

Convert Post Types：記事とカスタム投稿記事との変換プラグイン - ログブック｜CONSA DE CONSA

カスタムフィールドの値を表示する

取得したいフィールド名さえわかれば簡単に値を習得することができます。

the_field('material');
// =>Array, Array

var_dump(the_field('material'));
// =>Array, ArrayNULL
// Arrayという文字列が返ってくるので構造を表示できない？

親子階層のカスタムフィールドは配列になるので注意が必要です。

echo("<pre>");
var_dump(get_field('material'));
echo("</pre>");
// =>
// array(2) {
//   [0]=>
//   array(2) {
//     ["material_name"]=>
//     string(24) "りんごのイラスト"
//     ["material_url"]=>
//     string(11) "http:~apple"
//   }
//   [1]=>
//   array(2) {
//     ["material_name"]=>
//     string(3) "BGN"
//     ["material_url"]=>
//     string(12) "http:~sound1"
//   }
// }

親子階層のカスタムフィールドはforeachを入れ子にすることによって取得できます。

echo("<pre>");
$materials = get_field('material');
var_dump($materials[0]);
foreach ($materials as $material) {
    foreach ($material as $key => $value) {
        echo("フィールド名 = ${key}\n");
        echo("フィールド値 = ${value}\n");
    }
    echo("\n");
}
echo("</pre>");
// =>
// フィールド名 = material_name
// フィールド値 = りんごのイラスト
// フィールド名 = material_url
// フィールド値 = http:~apple
// 
// フィールド名 = material_name
// フィールド値 = BGN
// フィールド名 = material_url
// フィールド値 = http:~sound1

素材の種類も選択できるようにしてみました。

さらに今回は下記のように装飾しました。

// content.php
<div class="entry-content">
    <?php
        /* translators: %s: Name of current post */
        the_content(
            // 省略
        ) );
    ?>

    <!-- 追加コード -->
    <div class="work-materials">
        <strong>使用した素材</strong>
        <ul>
        <?php
            $materials = get_field('material');
            foreach ($materials as $material) {
                foreach ($material as $key => $value) {
                    //echo "$kye , $value \n";
                    if ($key == 'material_name') $material_name = $value;
                    if ($key == 'material_url') $material_url = $value;
                    if ($key == 'material_type') $material_type = $value;
                }
                echo '<li class="'.${material_type}.'"><a href="'.${material_url}.'" target="_blank" >'.${material_name}.'</a></li>';
            }
        ?>
        </ul>
    </div>

    <?php
        wp_link_pages( array(
        // 省略
        ) );

    ?>
</div><!-- .entry-content -->

CSSは下記のジェネレータを使用しました。
好きな色でCSS見出しが作れます | スタイルシート見出しメーカー

/* style.css */
/* 作品の素材集 */
div.work-materials > strong {
    margin-bottom: -3%;
    font-size: 90%;
    margin:0 0 10px 0;
    padding:3px 8px;
    border-width:0 0 0 5px;
    border-color: #8d6d6d;
    border-style:solid;
    background:#5c3739;
    color:#d6c7c7;
    line-height:140%;
    font-weight:bold;
}

div.work-materials > ul {
    margin-top: -2%;
}

div.work-materials > ul > li {
    margin-bottom: -5%;
    margin-left: 7%;
}

div.work-materials > ul > li.image {
    font-size: 200%;
    list-style-image: url('img/icon/image.svg');
} 

div.work-materials > ul > li.audio {
    font-size: 200%;
    list-style-image: url('img/icon/audio.svg');
} 

div.work-materials > ul > li.video {
    font-size: 200%;
    list-style-image: url('img/icon/video.svg');
}

div.work-materials > ul > li > a {
    font-size: 40%;
}

アイコンの画像は下記のものを使用しています。

カスタム投稿の一覧ページを作る

今回は3つある方法の内、アーカイブテンプレートを用意する方法にしました。これなら固定ページを作る必要はありません。どれが主流なのかはわかりませんでした。

カスタム投稿タイプの一覧ページの作成 | Web Design Leaves

**プラグインCPT UIでカスタム投稿を登録しているのですが、アーカイブページを作成する際はなぜかhas_archiveをtrueではなくfalseにしないといけません。**trueの時にアーカイブページに繊維しようとすると、そのカスタム投稿の特定ページに飛ばされてしまいました。

例

カスタム投稿タイプでworkというスラッグを使用。
カスタム投稿の1つの記事にwork1というスラッグを使用。
localhost:8888/work/をクリックすると、localhost:8888/work/work1/に飛ばされる。

カスタムメニュー

固定ページを作るにしろ、作らないにしろ、カスタム投稿一覧ページへのリンクを置くためにカスタムメニューを使います。

注意点

ウィジェットにカスタムメニューを追加。
タイトルを設定しないと何も表示されない。デフォルトはなし。
メニューを選択しないと、タイトルも出力されない。
固定ページのslugにハイフンを入れても、page-スラッグ名.phpののファイル名は正常に認識される。
固定ページのテンプレート優先順位
1. ~.php（固定ページのページ属性でテンプレートを指定）
2. page-固定ページのスラッグ名.php
3. page.php

アクションフック

一覧ページを作る上で合わせてアクションフックについて調べました。
WordPressをカスタマイズするなら覚えておきたいアクションフックとフィルターフック

参考サイトを読む際に、調べた関数は下記の通り。リンク先はリファレンスとなっております。

関数リファレンス

get header
have_posts
the post
ループを次の投稿へ進めます。次の投稿を取得して、それを「現在の投稿」としてセットアップし、ループの 'in the loop' プロパティを true にします。
in_the_loop
in_the_loop() がループの中で呼び出されたかどうか判定します（つまり、現在ループの中であるかどうか）。
get_query_var
グローバル $wp_query オブジェクトの_ _WP_Query クラス内の public query variable /en を取得する。
is_admin
ダッシュボードまたは管理パネルが表示されているかどうかをチェックします。
add_action特定のアクションに関数をフックします。この関数は add_filter() のエイリアスです。
locate_template
テンプレートファイルが存在するか確認する
wp_reset_postdata
new WP_Query を使って二番目のクエリを実行した後に、メインクエリの $post グローバル変数を復元するために使用します。つまり $post がメインクエリの現在の投稿になります。

webサービスを作るならwordpressではなく、他のフレームワークを使おう

wordpressでブログを構築する際に、カテゴリやタグの分類に迷ったら、とにかく細かくやっておくと後から修正が効きやすいと思います。その分記事作成の労力は増えますので、そこでカスタム投稿の出番だと思いました。なるべく速い段階からカスタム投稿は使用したほうがいいと思います。

思ったより簡単に使えるものでしたので、ほかのサイトを構築する際にはどんどん使いたいと思います。ただし、カスタム投稿はあくまで特定記事のコンテンツを出力する際に整形させやすくするものだと思います。これを検索機能として活用するのは無理があるかと。なので、検索機能を持たせたい場合はカテゴリやタグをカスタムタクソノミーでいくつも用意しておくとよいでしょう。

Webサービスを構築する際に、wordpressで頑張るのもいいですが、あくまでもwordpressはブログやサイトを作るためのcmsなのだと思いました。