var 5.0.5
| フック名 | フックの種類 | 説明 |
|---|---|---|
| wpcf7_validate | フィルター | 送られた値を検証 |
| wpcf7_mail_sent | アクション | メールが送信された後に実行するフック |
WordPressにはアクションフックとフィルターフックという仕組みがあります。これは一言でいうと手を加えること。WordPressが動く一連の流れの途中で、何かを追加して実行したり、値を変えたり、独自の関数を挟むことができる機能です。例えば「投稿が保存されたとき」とか、「テンプレートが読み込まれた時」とか、WordPressでは様々なフックが要所要所で用意されているので、いい感じのところで機能を追加したり値を変えたりができるわけですね。「ユーザーが追加されたとき」に「カテゴリーを追加する」なんてこともできちゃうです。フック一覧についてはCodexで確認できます(アクションフック一覧 / フィルターフック一覧)。
わざわざフックを利用せずに直接ファイルを変更してカスタマイズすることも可能ではありますが、WordPressではコアな部分は編集しない方針があります。それはWordPressをバージョンアップする度に編集する必要が出てくることや、プラグインやテーマはコアファイルがデフォルトの前提で設計されているなど、安全性からみても管理性からみてもあまりいいことがないからです。しかし良い感じのところにフックが用意されているので余程特殊なことをしない限りはフックによってカスタマイズができるかと思います。
それはプラグインにも同じことが言えます。バージョンアップもありますので、余程のことがない限りプラグインのコアファイルも編集しないほうがいいでしょう。親切なプラグインの場合はフックを要所要所で用意していますので、プラグインは設定やフックを利用してカスタマイズするのが基本です。
今回のContact Form 7も色々とフックが用意されているので、カスタマイズする場合は、フックに引っ掛けるイメージで関数を実行したり、値を変更したりする流れになります。
送られた情報をチェックするにはwpcf7_validateのフィルターフックを利用すると便利です。これはフォームが送信されてからの流れの途中で実行されるフィルターで、お問い合わせのタグデータを引数として使えたり、エラー時のメッセージを設定できたりと、検証するのにうってつけです。
送信データのチェックは、郵便番号の形式のチェックを追加したり、確認用メールアドレスのチェックを追加したりと、使いどころの多いフックになると思いますが、ContactForm7のプラグイン自体はこのフィルターを利用していないのでカスタマイズ用に用意してくれているフックなのでしょうね。
フィルターフック「wpcf7_validate」は$result = apply_filters( 'wpcf7_validate', $result, $tags );のようにフィルターを通しており、「$tags」を引数として「$result」に対してフィルタリングをすることができます。
流れとしては以下のようになります。
if ( ! $this->validate() ) {として「validate()」を実行if ( ! $this->validate() ) {に当てはまり、CF7が「validation_error」としてエラーメッセージを返す注目したいのは⑤で、無効の項目があるかどうかによって検証結果を判別しているところです。フィルタリングを行ってチェックをしたとしても、$resultに対し無効な項目を設定しなければ「無効ではない」と判断されてメールが送信されてしまいます。
そのためadd_filterでフィルタリングを行う関数には、何らかの条件下で無効としたい箇所に$result->invalidate( $name,$message);のような記述して、無効な項目をセットします。
$result = apply_filters( 'wpcf7_validate', $result, $tags );ネットで色々調べると引数で受け取ることができる「$tags」を回して該当のタグの時に判別するやり方が一般的ですかね。しかし、$tag['type']で判別する場合、タイプ別のフィルターが用意されているので、そちらを利用したほうが無駄に回さずにいいかもしれないですね。
add_filter('wpcf7_validate', 'my_wpcf7_validate', 11, 2);
function my_wpcf7_validate($result,$tags){
foreach( $tags as $tag ){
$name = $tag['name'];
/*
ここにごにょごにょ
*/
// 何らかの判別
if($name === 'validate_invalidate'){
// 無効な項目を追加(第二引数は第一引数のフォーム近辺に表示されるメッセージ)
$result->invalidate( $name, '〇〇してください。' );
}
}
return $result;
}
タグ全体を引数としてフィルターをかける「wpcf7_validate」ですが、「wpcf7_validate」のフィルターを通す前に、type別にフィルターを通しています。
フィルター名はwpcf7_validate_{タイプ名}といった具合です(‘email’の場合は’wpcf7_validate_email’)。
デフォルトでもフィルタリングされており、例えば「number」の場合、maxやminの情報を取得して最小値を下回ったり最大値を上回ったりしていないかチェックしています。
メールが送信されたらゴニョゴニョしたいってときはアクションフックwpcf7_mail_sentが便利です。これはメール送信が成功した時に実行されるアクションなので、POSTを利用して他のシステムとも連携することもできますね。「Contact Form 7」を申請フォームとして利用したり、夢が広がるのではないでしょうか。送信された情報を検証する為のフィルターフックwpcf7_validateと組み合わせればユーザー登録だってできるかもしれません。
アクションフック「wpcf7_mail_sent」はdo_action( 'wpcf7_mail_sent', $contact_form );のように実行されており、「$contact_form」を引数として実行されます。
流れとしては以下のようになります。
if ( $this->mail() ) {でメール送信do_action( 'wpcf7_mail_sent', $contact_form );を実行ここでの注目したい所は、すでに検証が終わっており、メールも送信後になることです。
do_action( 'wpcf7_mail_sent', $contact_form );メール送信後に何かしたい場合に実行できるわけですが、$submission = WPCF7_Submission::get_instance();とすることで、送信された情報を色々ととれるようです。
function my_wpcf7_mail_sent($contact_form){
//送信された情報を取得
$submission = WPCF7_Submission::get_instance();
if($submission) {
/*
ごにょごにょ
*/
}
}
add_action("wpcf7_mail_sent", "my_wpcf7_mail_sent");]]>
WordPressでは、「投稿タイプ(post_type)」や「タクソノミー(taxonomy)」、「ターム(term)」など、カスタマイズしようとすると聞きなれない言葉が出てきます。私はこの辺のWordPress特有の言い回しに最初戸惑ってしましたので、まずはその説明からしようと思います。
WordPressのデフォルトの投稿タイプは、記事を投稿するための「投稿(post)」、ページを表示するための「固定ページ(page)」などが存在します。この2つは「投稿タイプ」が異なる訳ですが、それぞれ違うタイプにするには理由があります。
一般的なブログサイトの記事一覧ページを想像してみてください。普通は新しい記事が上に表示されて、時系列順に表示されますね。
では、プロフィールページを作りたいと思って、記事にプロフィールを書いて投稿したらどうなるでしょう。記事は時系列順に表示されるので、新しい記事を書けばプロフィールを書いた記事はどんどん後ろの方に行ってしまいます。古い記事は流れてもいいですが、プロフィールはいつでも見られるようにしておきたいですね。そのため、時系列順に表示される「投稿」とは別に、ページ用の投稿タイプ、つまり「固定ページ」が必要になるわけです。他にもWordPressのデフォルトの投稿タイプに、画像などのファイル用の投稿タイプ「添付ファイル(attachment)」や、自動保存用に記録するための投稿タイプ「リビジョン(revision)」などがあります。
今回の「カスタム投稿タイプ」とは、これらのデフォルトの投稿タイプとは別に、新しく自分で作った投稿タイプのことを示します。言ってしまえば、「投稿」や「固定ページ」で事足りるのであれば、わざわざ「カスタム投稿タイプ」を作る必要はありません。しかし、投稿とは表示形式を変えたい場合など、新しい投稿タイプを作った方が便利な場合も多々あります。
WordPressでは「カテゴリー」や「タグ」があり、「投稿」を自由に分類できます。この「カテゴリー」や「タグ」は、デフォルトで登録されている「タクソノミー」になります。つまり、投稿を分類する方法として「カテゴリー」という名のタクソノミーがあるわけです。ちょっとややこしいかもしれませんが。
では、「車」という投稿タイプをつくったとしましょう。車には「色」や「ブランド」、「車種」など、色々な情報がありますね。デフォルトの「カテゴリー」を利用して分類してもいいですが、カテゴリーの数がとんでもないことになり管理が大変そうです。そんな時、カテゴリの他に、「色別」という分類方法や、「ブランド別」、「車種別」などの分類方法があれば管理がしやすくなると思いませんか?
この「投稿を分類する方法」のことを「タクソノミー」といい、オリジナルで登録する分類方法のことを「カスタムタクソノミー(カスタム分類)」といいます。
カスタムタクソノミーを実装していくと「ターム」というこれまた聞きなれない言葉が出てきます。「投稿」をカテゴリーで、「日常について」や「犬の話」などと分けていたとします。このカテゴリーに登録された「日常について」などが「ターム(term)」となります。つまりタームは、タクソノミーに登録する分類のことです。
WordPressのデフォルトではカテゴリーに「未分類」とありますね。これはつまり、「カテゴリー」という名の「タクソノミー」に、「未分類」という名の「ターム」が登録されていることになります。
上記のタクソノミーの車で説明するなら、「色別」に登録した「赤」や「青」、「ブランド別」で登録した「トヨタ」や「マツダ」がタームにあたります。
カスタム投稿タイプはプラグインによって簡単に登録できますが、ここでは「functions.php」に記述して登録する方法を説明します。
WordPressにはカスタム投稿タイプを登録するために「register_post_type()」という関数が用意されています。それを利用して、以下をfunction.phpに記述します。
ここでは、「車(car)」というカスタム投稿タイプを追加してみましょう。
function add_custom_post_car()
{
/*「車」のラベルの設定
--------------------------------------------------------------------------*/
$car_labels = array(
'name' => "車",
'singular_name' => "車",
'add_new' => "新規追加",
'add_new_item' => "車を新規追加",
'edit_item' => "車を編集",
'new_item' => "新規車",
'view_item' => "車を表示",
'search_items' => "車を検索",
'not_found' => "車が見つかりません",
'not_found_in_trash' =>"車はゴミ箱にはありません",
'parent_item_colon' => '親',
'menu_name' => '車',
'all_items' => '車一覧'
);
/*「車」の設定と追加
--------------------------------------------------------------------------*/
$car_args = array(
'labels' => $blog_labels,
'public' => true,
'publicly_queryable' => true,
'description' => '車を掲載しています。',
'show_ui' => true,
'query_var' => true,
'rewrite' =>array( 'with_front' => false ),
'capability_type' =>'post',
'has_archive' => true,
'hierarchical' => false,
'menu_position' => 5,
'supports' => array('title','editor','author','thumbnail','excerpt','comments','custom-fields'),
'taxonomies' => array('color', 'brand' )
);
register_post_type('car', $car_args);
}
add_action('init', 'add_custom_post_car');
上記の記述を詳しく説明していきます。大まかな流れでは「add_custom_post_car()」という関数を作成し、「WordPressの読み込みが完了した時(init)」に実行するように「add_action」に関数名を入れています。
function add_custom_post_car(){...}add_action('init', 'add_custom_post_car')の第二引数と同じである必要があります。$car_labels = array(..);'name' => 'Cars', 'singular_name' => 'Car'となります。$car_args = array(..);labelspublicdescriptionrewritearray( 'with_front' => false )を入れているのは、URLの設定を変更するためです。WordPressでは「投稿」のパーマリンク設定にて、「https://sampale.com/news/(タイトル)/」の「news」ように、URLの前に任意の文字を入れることができます。デフォルトのままだと、「https://sampale.com/news/car/xxxxx/」というパーマリンクになってしまうからです。もちろんそれでいいのなら設定をデフォルトから変える必要はありませんが、カスタム投稿タイプが投稿とは全く関係ない場合、「https://sampale.com/car/(タイトル)/」の方が自然だと思うので今回は「with_front」だけ変更しています。supportstaxonomiesregister_post_type('car', $car_args);以上でカスタム投稿タイプの登録が完了です。カスタム投稿タイプの登録はパーマリンクや結びつきに関わる追加設定になるため注意して扱う必要があります。
register_post_type('car', $car_args);のあとに、register_taxonomy_for_object_type('category', 'car');を実行して結び付ける必要があります。'rewrite' =>array( 'with_front' => false )とパーマリンク設定を変更した場合、管理画面には出たけどページが表示されないなどといった現象が起こります。変更した場合は、一度パーマリンク設定をフレッシュする必要があるためです。「管理画面」>「設定」>「パーマリンク設定」にいき、何も変更は加えないでもいいので、「変更を保存」を押すと、パーマリンク設定が更新されるので、表示されるようになります。次にカスタムタクソノミーの登録方法を説明します。
「色別(color)」というカスタムタクソノミーを追加してみます。
カスタム投稿タイプのようにfunctions.phpに記載する方法になります。こちらも「add_custom_type_color」という関数を定義し、add_actionのinitの時に実行する流れです。
function add_custom_type_color()
{
/*「色別」のラベルの設定
--------------------------------------------------------------------------*/
$color_labels = array(
'name' => "色別",
'singular_name' => "色別",
'search_items' => "色を検索",
'all_items' => "すべての色",
'parent_item' => "親の色別",
'parent_item_colon' => "親:",
'edit_item' => "色を編集",
'update_item' => "色を更新",
'add_new_item' => "新しい色を追加",
'new_item_name' => "新規色",
'menu_name' => "色別",
);
/*「色別」の設定・追加
--------------------------------------------------------------------------*/
register_taxonomy(
'color',
array( 'car' ),
array(
'hierarchical' => true,
'labels' => $color_labels,
'show_ui' => true,
'query_var' => true,
'rewrite' => true,
'capabilities' => array('assign_terms' => 'manage_categories' ),
'rewrite' =>array( 'with_front' => false ),
)
);
}
add_action('init', 'add_custom_type_color');
register_taxonomy()はカスタム投稿タイプより短いですね。詳しい説明は以下より確認できます。
→ target=”_blank”>関数リファレンス/register taxonomy – WordPress Codex 日本語版
function add_custom_type_color(){...}add_action('init', 'add_custom_type_color')の第二引数と同じである必要があります。hierarchicalカスタム投稿タイプの登録が終わると次は表示する流れになります。表示を投稿と切り分けたい場合、読み込まれるテンプレートを把握することは大事です。WordPressでは読み込むテンプレートを決定する時、探す順番にはルールがあります。
基本的には投稿と同じようにarchiveから探していきますが、カスタム投稿タイプのスラッグを用いたテンプレートを先に探します。
ここではスラッグ名を「car」とした場合になります。
シングルページの場合も、アーカイブページと同じようにカスタム投稿タイプのスラッグが入ります。
カスタムタクソノミーの表示の際に読み込まれるテンプレートは基本的に一覧ページとなるわけですが、タームのスラッグも指定できるため、タームを登録する時は半角英字で登録し、ハイフンなどは使わないようにします。
ここでは「color」というカスタムタクソノミーに「red」というタームが登録されているとします。
カスタム投稿タイプの情報や、現在の投稿はどの投稿タイプかなど、色々と関数を知っておくとテーマ作成の時に便利です。
$post_types = get_post_types();$args = array( 'name' => 'car' ); $post_types = get_post_types( $args, 'objects' );
$post_type = get_query_var( 'post_type' );$post_type = get_post_type();$post_type = get_post_type( $post );カスタムタクソノミーもまた、タクソノミー名を取得したい場合など、色々と取得するためにごちゃごちゃと関数があります。
$taxonomies = get_taxonomies(array(), 'objects');$taxonomy = get_taxonomy('color');$term = get_term( $term_id, 'color');$terms = get_terms( $taxonomies, $args );$term_link = get_term_link( $term );$term_meta = get_term_meta( $term_id );$taxonomy_name = get_query_var( 'taxonomy' );$term_id = get_queried_object();$terms = get_the_terms($post_id, 'color');if(taxonomy_exists('color')){ ... }if(term_exists('red')){ ... }if(is_tax()){ ... }if(is_tax('color')){ ... }if(is_tax('color', 'red')){ ... }
CSS3のアニメーションについてをまずは説明します。
CSS3でアニメーション効果を利用できるようになってから数年が経ちました。対応ブラウザなどの心配もありますが、モダンブラウザでは自動更新がデフォルトであること、スマホの普及やWindowsXPのサポート停止などを経て、対応ブラウザを最新環境に設定しているサイトも多くなってきている印象です。IEの旧バージョンは切り捨ててもIE11は切り捨てるべきではないと個人的には思っていますが(仕事で制作した日本向けの企業サイトでは10%~30%の割合で未だIEを利用している人がいます)、IE11ではアニメーションを使えるため実装はしても問題なさそうです。バグなどが報告されているそうなので、確認はしないといけません。
CSSのアニメーションは主に2つの方法があります。
1つは「transition」。これは要素の値が変更された時、変化にかかる時間など「どのように変化するか」を指定をすることができます。例えばwidth:100pxの要素に「transition:width 1s linear 0」と指定し、その要素をjavascriptでwidth:200pxに変更したとします。すると一瞬で200pxになるわけではなく、100pxから200pxへ「1秒かけて徐々に変化する」ことになります。これを利用して徐々に動く「アニメーション」効果をつけることができるのです。
2つ目は「@keyframes」と「animation」。まずは「@keyframes」で「何をどのように変化させるか」というアニメーションを作ります。始まりから終わりまでを「0%~100%」で表すのですが、widthを100px→200pxへと変化させたい場合は、「0%」のときに「width:100px」、「100%」のときに「width:200px」といった具合です。これでは動きを作っただけなので、どの要素が動くのか指定しなくてはなりません。作ったアニメーションを要素に対して指定するには「animation」を使います。つまり「@keyframes」でアニメーションを作り、「animation」でアニメーションを要素にしているという流れになります。
単純にCSSで要素にアニメーションを指定しただけの場合、アニメーションの開始はCSSが反映された時、つまり読み込まれてすぐに動くことになります。ローディングのアイコンなどはそれでもいいかもしれませんが、こうした時に動いてほしい等、タイミングを制御した場合はCSSの記述を工夫したり、javascriptを利用する必要があります。
CSSだけでアニメーション開始のタイミングを計れる場合は以下のような場合になります。そもそもずっと動き続けてほしい場合や、「:hover」など疑似要素を利用した場合など、基本的にCSSでアニメーションになるタイミングを再現できればCSSで完結することができます。
クリックした時に別の要素を動かすなど、CSSで開始のタイミングを再現できない場合があります。そいうときはjavascriptなどでタイミングを任意に変更してあげる必要があります。
この様な場合、大体次のような流れでCSSアニメーションを行います。
要素Aをクリックした時に要素Bをアニメーションしたいとします。
まずは「transition」の説明をします。「transition」については前述した通り、変化した時「どのように変化するか」を指定することができます。変化前と変化後の指定が必要になってきます。
「trandition」は、「trandition:(property) (duration) (timing-function) (delay);」のように指定します。1つずつ見ていきましょう
以上を踏まえてCSSを記述すると以下のようになります。
以下の例では、class「tr01」に対して、【width】が変更された時、【2秒】かけて、【ease】の動きで、【0秒後】にアニメーションするということになります。
.tr01{
transition: width 2s ease 0s;}また、各値の違いがあるとどうなるかまとめてみました。
「transition」でアニメーションするデモ
動きを指定する「timing-function」は色々用意されています。また、各値の違いがあるとどうなるかまとめてみました。
「trandition」の「timing-function」まとめ
まずはどこのサーバに接続するかを指定します。店名が分からなければ何処からリンゴを買えばいいのか分かりませんもんね。どこのサーバに接続するかは、「sample.com」のようなドメインで指定します。「”シッタカ果物屋に行って”リンゴを買ってくる」といった具合に、店名を指定するイメージです。
GoogleやYahooなどの検索サイトを利用してサイトを見る人が多いと思いますが、それらはリンクを表示しているだけであって、最終的にリンク先のドメインを指定してそのサーバからデータを引っ張ってきています。検索サイトは案内サービスをしているお店って感じですかね。
注意点として同じドメイン名があっては困るので、同じドメイン名は登録できません。「シッタカ果物屋 大通り店」とか、「シッタカ果物屋2号店」とか、違う名前にしないといけません。少しでも違えば大丈夫です。
じゃあ指定したドメインのサーバはどこにあるのでしょうか?店名だけ分かってもお店の住所が分からないと辿り着けません。ウェブサイトで利用されるサーバには、お店の住所と同じようにそれぞれ固有のIPアドレスが振られています。IPアドレスは123.456.789のように無機質な羅列になっています。
でも、店名が分からなくても住所が分かればお店にいけますよね。実際、IPアドレスを指定してもサーバへ接続を試みることはでき、きちんとウェブサイトを表示できる場合もあります。しかし、お店も一軒家タイプだったりショッピングモールの中に入っていたりするように、サーバにも専用サーバや共有サーバが存在して、一つのIPアドレスに対していくつものドメインを登録している場合があります。そんな時、メインとなるドメインのサイトを表示するサーバもあれば、サーバの管理会社の表示がされることもあるのです。
ここで、なぜドメインからサーバへ接続できるか不思議ですね。「シッタカ果物屋」の住所を教えてくれる存在が必要です。
ブラウザからウェブサイトを見るとき、実は裏ではドメインとIPアドレスを結び付けるためにドメインネームサーバ(DNS)というサーバへの接続を挟んでいて、そのネームサーバが「このドメインね、このIPアドレスだよ」と住所を教えてくれています。アドレス帳から「シッタカ果物屋」を探して住所を調べるイメージです。「北海道札幌市中央区…」より「シッタカ果物屋」の方が覚えやすいですよね。DNSはこのアドレス帳のような役割を果たしています。DNSはドメインを指定したらIPアドレスと結び付けてくれる、なくてはならない存在です。
また、1つのDNSが全てのアクセスをこなしているかというとそうではありません。世界中の大量のアクセスを上手くさばくために、ドメインを分割して参照するネームサーバを切り分けています。数多くあるドメインの中から「シッタカ果物屋」を1冊のアドレス帳から探すのにのは大変ですもんね。
「sample.co.jp」というドメインの場合、ドメインの後ろから参照していきます。まずは「jp」のネームサーバを参照し「co.jp」のネームサーバへ接続します。次に「co.jp」のネームサーバが「sample.co.jp」が登録されているネームサーバを参照してIPアドレスを取得する流れです。「〇屋」をまとめたアドレス帳から「果物屋」のアドレス帳がどこにあるかを探し、「果物屋」のアドレス帳から「シッタカ果物屋」の住所が載っているアドレス帳を探すイメージですね。一見面倒なように感じますが、1冊の分厚いアドレス帳を皆で使うと大変です。役割を分割することよって世界中からの大量のアクセスをうまくさばくことができます。
最初のトップレベルドメインと言われる「jp」や「com」はそれぞれ企業や組織が管理しているのですが、では一番最初の「jp」や「com」はどこか教えてくれるのは誰でしょうか?ルートサーバと呼ばれるDNSが存在します。トップレベルドメインの前に一番最初に訪れる場所になるわけですが、世界に13個のルートサーバーがあるそうですよ。へぇー。。。
「sample.co.jp」の場合は以下のような流れになるわけですね。
最終的に「4)sample.co.jpのあるネームサーバ」がIPアドレスを教えてくれるわけですが、そのDNSは大抵ドメイン管理会社やレンタルサーバ会社が用意しています。つまり、「1)」や「2)」、「3)」のネームサーバはそれぞれ管理しているのが違うんですね。
これでお店までの道のりは完璧です。ドメインからネームサーバへ接続してIPアドレスをゲットして、サーバの場所が分かったのです。
次にどのように接続するか。お店までの交通手段です。ネット回線が通っている状態では、言ってみれば道路が通じているだけ。実際にネットに接続するためにはプロバイダとの契約が必要です。NTTやauなどですね。
彼らはタクシー会社のようなイメージです。お店までに行くためにタクシー会社と契約してタクシーを手配する感じ。これでお店に行き、リンゴを要求して持って帰ることができるわけです。
PCなどからドメインへの接続を指定した際、代わりにIPアドレスを聞いて回ってくれる存在がいます。それがDNSキャッシュサーバーです。「シッタカ果物屋まで」と言われ、アドレス帳を索引して住所を調べてくれるタクシー運転手のような存在です。
そしてこのDNSキャッシュサーバー、毎回ルートサーバに聞きに行く訳ではなく、一度IPアドレスを割り出したら保存する機能が付いています。保存したIPアドレスを参照してくれるので、ルートサーバーへ接続する手間が省けるのです。
タクシー運転手さんが知っている場合は、住所を調べずに場所に直接行くようなものですね。便利なようですが、ここがサーバ移管にとっては注意しなくてはならない点になります。
ウェブサイト閲覧もメールの送受信も流れ自体は同じようなものです。サーバ上にあるデータをダウンロードして表示するのか、メールをダウンロードして表示するのか。しかし、ウェブサイトは基本的に誰でも見ることができるようになっていますが、メールは見られたら困ります。お店に届いた手紙を誰でも見られたら困りますよね。
そのためウェブサイト閲覧とメールの入り口が異なっており、メールにはユーザー名とパスワードを利用した設定が必要です。郵便受けの暗証番号のようなものです。
こうしてお客さんはお店の正面玄関から入ってリンゴを買い、お店のスタッフはお店の裏口から入り自分宛の手紙を受け取ることができるんですね。
基本的なことですが…。ページのURLがリダイレクトされてデフォルトのページが表示されてしまうのか、そもそもリンクのURLがデフォルトのURLを指定しているのかを確認します。Google ChromeやFireFoxなどのモダンブラウザでは、リンクをマウスおーばすると左下にURLが表示されると思いますので、そこできちんと翻訳ページのURLになっているか確認します。
翻訳ページを作成するときはページの編集画面から言語を選んで作成すると思いますが、親ページの翻訳ページが作成してから子ページの翻訳ページを作成した方がうまく行きます。親ページの翻訳ページを作成しないまま子ページの翻訳ページを作成してしまった場合、うまく子ページの翻訳ページが表示されないことがありました。
ブラウザのキャッシュが原因かもしれません。こんな初歩的なことでと思うかもしれませんが、実際に「F5」キーや更新ボタンを押しても反映されなかったですしブラウザのキャッシュは残さない設定にしていたのに関わらず、キャッシュを削除を行ってから再読み込みするときちんと翻訳ページが表示されたことがありました。一度お試しください。
]]>オリジナルテーマを作るときはいつも新規作成しています。HTMLからWordPressにテーマ化する際に便利なコード集です。
WordPressのテーマ作成に必須のテーマ情報の記述です。
/* Theme Name: xxxxxxx Theme URI: https://xxxxxxx.com/ Description: xxxxxxx Author: xxxxxxx Author URI: https://xxxxxxx.com/ Version: 1.0 . */
トップページのURLを出力するWordPress関数です。この辺は直接書いたりテキストエディタで一括置換した方が早そうですね。
<?php echo get_option('home'); ?>/
この辺りを忘れるとプラグインで用意しているjavascriptが読み込まれなかったりします。
<?php wp_head(); ?> <?php wp_footer(); ?>
こちらも直接書いた方が早いかもですが、「get_template_part」とかはアンダースコアの位置ってこれでよかったっけ?って思ってしまいます。
<?php get_header(); ?>
<?php get_sidebar(); ?>
<?php get_template_part('xxxxx'); ?>
<?php get_footer(); ?>
サムネイルやカテゴリを含めると以外に面倒なのがループ。have_postだっけ?have_postsだっけ?はたまたhas_post?みたいな英語が苦手な私は毎回コピペしています。
単純なループの記述。
<?php if ( have_posts() ) : ?> <?php while ( have_posts() ) : the_post(); ?> <?php endwhile; ?> <?php else : ?> <?php endif; ?>
サムネイル画像の取得やカテゴリーの一覧取得などなど、HTML入りのメインループです。
<?php
if ( have_posts() ) :
while ( have_posts() ) : the_post();
$post_title = get_the_title();
$post_id = get_the_ID();
//カテゴリの取得
$tax_name = 'category';
$terms_arr = get_terms($tax_name);
$term_html = '<ul class="post_'.$tax_name.'_list">';
foreach($terms_arr as $term_obj) :
$term_name = $term_obj->name;
$term_id = $term_obj->term_id;
$term_slug = $term_obj->slug;
$term_html .= '<li><a class="tax_'.$tax_name.' term_'.$term_slug.'" href="'.get_term_link($term_id, $tax_name).'/" title="'.$term_name.'一覧へ">'.$term_name.'</a></li>'."\n";
endforeach;
$term_html .= '</ul>';
//サムネイル画像
$img_size = 'thumbnail';
if(has_post_thumbnail()){
$post_img_src = get_the_post_thumbnail_url($post_id, $img_size);
} else {
$post_images = get_children(
array(
'post_type' => 'attachment',
'post_mime_type' => 'image',
'post_parent' => $post_id,
'order' => 'DESC',
'numberposts' => 1
)
);
if(is_array( $post_images ) && ! empty( $post_images )){
$first_img = wp_get_attachment_image_src( current($post_images)->ID, $img_size);
$post_img_src = $first_img[0];
} else {
$post_img_src = get_option('home').'/xxxxx/noimg_'.$img_size.'.jpg';
}
}
//本文の整形
$post_cnt_length = 100;
$post_cnt = $post->post_content;
$post_cnt = apply_filters('the_content', $post_cnt);
$post_cnt = str_replace(']]>', ']]>', $post_cnt);
$post_cnt = str_replace(array(' ', ' ', ' '), '', wp_strip_all_tags( $post_cnt, true ));
if (mb_strlen($post_cnt) > $post_cnt_length) {
$post_cnt = mb_substr($post_cnt, 0, $post_cnt_length, 'UTF-8').'...';
}
?>
<article class="post_box">
<h2><a href="<?php the_permalink(); ?>" title="<?php echo $post_title; ?>"><?php echo $post_title; ?></a></h2>
<div class="post_thumnail"><img src="<?php echo $post_img_src; ?>" alt="<?php echo $post_title; ?>" /></div>
<div class="post_detail">
<dl class="post_date">
<dt>日付</dt><dd><?php the_date('Y.m.d'); ?></dd>
</dl>
<dl class="post_category">
<dt>カテゴリー</dt><dd><?php echo $term_html; ?></dd>
</dl>
<div class="post_ex">
<p><?php echo $post_cnt; ?></p>
</div>
</div>
</article>
<?php endwhile; ?>
<?php else : ?>
<div class="post_not_found">
<h2>404 Error</h2>
<p>ページが見つかりませんでした。URLが間違っているか、削除された可能性があります。</p>
</div>
<?php endif; ?>
よく使う設定を入れ込んだWP_Queryを利用したループ。使わない設定もありますが、記述するより削除の方が楽なのでコピペで済ませています。サイドバーやカスタム投稿をデータとして利用している場合などによく使います。
<?php
$post_set = array(
'p' => 0,
'cat' =>0,
'posts_per_page' => 0,
'offset' => 0,
'post_type' => 'post',
'orderby' => 'date',//author、ate、title、medified、ID:ID、rand、meta_value、meta_value_num
'tax_query' => array(
'relation' => 'AND', //AND、OR)
array(
'taxonomy' => 'category',
'terms' => array('news'),
'include_children' => true,
'field'=>'term_id',
'operator' => 'IN'//(IN、NOT IN、AND)
),
),
'meta_query' => array(
'relation' => 'AND',
array(
'key' => '',//メタキー
'value' => '', //値(文字列か配列)
'compare' => '=', //'='、'!='、'>'、'>='、'<'、'<='、'LIKE'、'NOT LIKE'、'IN'、'NOT IN'、'BETWEEN'、'NOT BETWEEN'
'type' => 'CHAR' //'NUMERIC'、'BINARY'、'CHAR'、'DATE'、'DATETIME'、'DECIMAL'、'SIGNED'、'TIME'、'UNSIGNED'
),
)
);
$post_query = new WP_Query($post_set);
$post_max = $post_query->found_posts;//------記事の最大値
if($post_query->have_posts()) :
while ( $post_query->have_posts() ) : $post_query->the_post(); ?>
<?php endwhile; ?>
<?php else : ?>
<?php endif; wp_reset_postdata(); ?>
コーポレートサイトをWordPressで構築する場合、ちょっとしたプログラムを組んで利用するページが必要なことが多々あります。そんなときに役立つページテンプレートの作成時に役立つ記述です。
スペースだとかスペルミスを防ぐためにもコピペが一番ですね。
<?php /* Template Name: xxxxxxxxxxxxxxx */
WordPressがより便利になったカスタム投稿とカスタム分類の登録。プラグインを使わなくとも、コピペをすれば簡単に登録できます。ただ、データとして扱う場合などはpuclicなどに注意が必要です。
functions.phpに記述します。
<?php
function add_custom_post_xxxxx()
{
/*「XXXXX」のラベルの設定
--------------------------------------------------------------------------*/
$xxxxx_labels = array(
'name' => "XXXXX",
'singular_name' => "XXXXX",
'add_new' => "新規追加",
'add_new_item' => "新規XXXXX追加",
'edit_item' => "XXXXXを編集",
'new_item' => "新規XXXXX",
'view_item' => "表示",
'search_items' => "XXXXXを検索",
'not_found' => "見つかりません",
'not_found_in_trash' =>"ゴミ箱にはありません",
'parent_item_colon' => '親',
'menu_name' => 'XXXXX',
'all_items' => 'XXXXX一覧'
);
/*「XXXXX」の設定と追加
--------------------------------------------------------------------------*/
$xxxxx_args = array(
'labels' => $xxxxx_labels,
'public' => true,
'publicly_queryable' => true,
'description' => 'XXXXXの一覧。',
'show_ui' => true,
'query_var' => true,
'rewrite' =>array( 'with_front' => false ),
'capability_type' =>'post',
'has_archive' => true,
'hierarchical' => false,
'menu_position' => 5,
'supports' => array('title','editor','author','thumbnail','excerpt','custom-fields'),
'taxonomies' => array('xxxxxcat' ),
'menu_icon' => 'dashicons-admin-home'
);
register_post_type('xxxxx',$xxxxx_args);
}
add_action('init', 'add_custom_post_xxxxx');
同じく、functions.phpに記述します。
<?php
/*========================================================================
XXXXXカテゴリーの追加
==========================================================================*/
function add_custom_type_xxxxxcat()
{
/*「XXXXXカテゴリー」のラベルの設定
--------------------------------------------------------------------------*/
$xxxxxcat_labels = array(
'name' => "XXXXXカテゴリー",
'singular_name' => "XXXXXカテゴリー",
'search_items' => "XXXXXカテゴリーを検索",
'all_items' => "すべてのXXXXXカテゴリー",
'parent_item' => "XXXXXカテゴリー",
'parent_item_colon' => "親:",
'edit_item' => "XXXXXカテゴリーを編集",
'update_item' => "XXXXXカテゴリーを更新",
'add_new_item' => "新規XXXXXカテゴリー",
'new_item_name' => "新規XXXXXカテゴリー名",
'menu_name' => "XXXXXカテゴリー",
);
/*「XXXXXカテゴリー」の設定・追加
--------------------------------------------------------------------------*/
register_taxonomy(
'xxxxxcat',
array( 'xxxxx' ),
array(
'hierarchical' => true,
'labels' => $xxxxxcat_labels,
'description' => 'XXXXXの分類。',
'show_ui' => true,
'query_var' => true,
'rewrite' => true,
'capabilities' => array('assign_terms' => 'manage_categories' ),
'rewrite' =>array( 'with_front' => false ),
)
);
}
add_action('init', 'add_custom_type_xxxxxcat');]]>
まずはどういったスライダーを作るのかを考えます。自作するにあたって途中であれが必要だったとか今の構造じゃちょっと難しいとか、あとからごちゃごちゃ修正するのを避けるためにも、どのようなスライダーにするかを練ります。基本的には企画やデザインの時点である程度は決まってそうですが。
まずはスライドの中身です。一枚画像なのか、テキストやリンクを含めたテキストなのか、1枚のスライドに対し複数のコンテツを入れたいのかなどなど。この部分はHTML/CSSをどう書くのかに繋がってきます。
スライダーとは言いつつも、横からスライドするもの、フワッとフェードアウト/インをして切り替わるもの、複雑なアニメーションによりダイナミックに切り替わるものなどたくさんの種類があります。この切り替わり方がスライダーの中で一番の活躍どころです。もちろんコンセプトに沿った適切なアニメーションが求められますが。
次/前のスライドへ行くリンクや、今が何番目のスライドなのかなど、ユーザーに優しいスライダーの機能、ナビゲーション。上のデモではナビゲーションはありません。ナビゲーションがないとユーザーはテレビCMを見るかのようにじっと見つめるだけです。ウェブサイトで情報を得るのは基本的に能動的だと思いますが、その分自分のペースで情報を得たい人が多いのではないでしょうか。見ている人によっては早く次のスライドが見たかったり、いつ終わるのか気になる人もいると思います。そんな人へナビゲーションをUIとして設置してあげるのもいいと思います。
ナビゲーションのついたスライダー
スライダーを実際に自作する作業に入ります。まずは簡単なフェードイン/アウトのスライドを組む想定で行います。
フェードイン/フェードアウトするということは、前の画像と次の画像が重なっている必要があります。
まずはHTMLになりますが、今回は中身に文章が入る想定です。
注意点としては、スライド1枚1枚に連番が振ってあることです。この処理をjQuery側でも行うことはできますが、それはオプションとして基本を先に構築するのも手です。classの「sld_fade」は、共通のスタイリングをするときや、jQueryでまとめて処理したいときに便利です。
<div id="slider"> <div id="sld1" class="sld_fade"><p>スライド1</p></div> <div id="sld2" class="sld_fade"><p>スライド2</p></div> <div id="sld3" class="sld_fade"><p>スライド3</p></div> <div id="sld4" class="sld_fade"><p>スライド4</p></div> </div>
次にCSSでスタイリングしていきます。この時点で既にどのような動きをするかを考慮した記述をしなくてはなりません。
スライドとスライドが重なる様に、親要素となる「#slider」には「position:relative」、子要素には「absolute」を指定します。
また、最初はスライドを消しておくため、「display:none」を指定しています。
ここでの注意点は子要素がabsoluteになっているため、親要素の高さが「0」になってしまうことです。「height」で指定するか、下のように「padding」で高さを確保します。このpaddingにパーセント指定をして高さを確保するやり方は、比率を確保しつつ幅に合わせて縮んでいくので、レスポンシブになります。(横 : 縦 = 100 : X から、X = 縦 × 100 / 横 = 61.77%といった感じです。)
#slider{
max-width: 960px;
margin: 0 auto;
padding: 61.77% 0 0;
position: relative;}
.sld_fade{
width: 100%;
height: 100%;
position: absolute;
left: 0;
top: 0;
display: none;}
少し長いですが。。。
$(function(){
var sld_wrap = '#slider',
sld = '.sld_fade',
sld_pre = 'sld',
sld_time = 1000,
sld_wait = 3000;
$.fn.slide_fade = function(){
return this.each(function(i, elem) {
var sldnum = parseInt($(this).data('sldnum'));
$(sld).not('#' + sld_pre + sldnum).fadeOut(sld_time);
$('#' + sld_pre + sldnum).fadeIn(sld_time);
var sld_timer = setTimeout(function(){
sldnum++;
if(sldnum > $(sld).length){ sldnum = 1; }
$(sld_wrap).data('sldnum', sldnum);
$(sld_wrap).slide_fade();
}, sld_wait);
});
};
$(window).load(function() {
$(sld_wrap).data('sldnum', 1).slide_fade();
});
});ページが読み込まれてから実行する順に説明をしてみます。
最初「var …」により色々と変数に入れています。スピードやID名など、後で変更しやすい様に上の方にまとめておきました。
「$.fn.slide_fade = function(){…」ではごにょごにょしたものが書いてありますが、定義しているだけで実行はしていません。
そして「$(window).load(function() {…」、これは読み込まれた中のものを実行するというものになります。
ページが読み込まれてから「$(sld_wrap).data(‘sldnum’, 1).slide_fade();」を実行していることになります。
ここではじめて「slide_fade」のごにょごにょが実行されるわけですが、ポイントはHTMLで記述した連番に対し、「sldnum」が一致したものを表示(fadeIn)し、それ以外を表示しない(fadeOut)処理を行っているところです。
そして、その値を1個増やし、「setTimeout」で自分自身を呼び出すことで無限に続く様にしています。繰り返しの処理があるということはどこかで「1」に戻らないといけないため、全体の数を「length」で数え、それを越えていたら「1」に戻します。
テンプレートとして持っておけば大分楽になるのかなとおもいます。
上にある「ナビゲーションのついたスライダー」のデモとほとんど同じですが。
スライダーの基本はほとんど変わりませんが、ナビ用にHTMLが追加されています。
<div id="slider"> <div id="sld_area"> <div id="sld1" class="sld"><p>スライド1</p></div> <div id="sld2" class="sld"><p>スライド2</p></div> <div id="sld3" class="sld"><p>スライド3</p></div> <div id="sld4" class="sld"><p>スライド4</p></div> </div> <div id="sld_nav"></div> <a id="sld_prev" class="sld_dir_btn">< </a> <a id="sld_next" class="sld_dir_btn">></a> </div>
装飾的な部分が多くなってしまいましたが、いろいろ変更してみるといいと思います。
#slider{
max-width: 960px;
margin: 0 auto;
padding: 61.77% 0 0;
position: relative;}
#sld_area{
width: 100%;
height: 100%;
position: absolute;
left: 0;
top: 0;
overflow: hidden;}
.sld{
width: 100%;
height: 100%;
position: absolute;
left: 100%;
top: 0;}
#sld_nav{
width: 100%;
height: 20px;
position: absolute;
left: 0;
bottom: 20px;
text-align: center;}
.sld_navi_circle {
display: inline-block;
width: 16px;
height: 16px;
margin: 0 4px;
border-radius: 8px;
background: rgba(255,255,255,0.4);
border:2px solid #FFF;
box-shadow: 0 2px 0 rgba(0,0,0,0.4);}
.sld_navi_circle.current{
background: rgba(255,255,255,1);}
.sld_dir_btn{
font-size: 20px;
position: absolute;
top: 50%;
display: block;
width: 40px;
height: 40px;
border-radius: 20px;
line-height: 40px;
text-align: center;
font-weight: bold;
margin: -20px 0 0 0;
background: rgba(255,255,255,0.4);
color: #000;
box-shadow: 0 2px 0 rgba(0,0,0,0.1);}
.sld_dir_btn:hover{
background: rgba(255,255,255,1);}
#sld_prev{
left: 20px;}
#sld_next{
right: 20px;}
ちょっと基本というには長すぎますかね。
フェードイン/アウトではナビゲーションがないため、前に戻る処理は必要ありませんでしたが、前に戻る処理が追加されています。
また。「●○○○」をクリックしてその場所へ飛べるように関数も変更し、動くだけの関数、横に行く関数、前に行く関数の3つを作成しました。
$(function(){
var sld_wrap = $('#slider'),
sld_navi = '#sld_nav',
sld = '.sld',
sld_max = $(sld).length,
sld_pre = 'sld',
sld_time = 1000,
sld_wait = 2000,
sld_timer, goaway_left, from_left, sld_direction;
$.fn.slide_move = function(options){
var settings = $.extend( {
'direction': 'next'
}, options);
return this.each(function(i, elem) {
clearTimeout(sld_timer);
var sldnum = parseInt(sld_wrap.data('sldnum'));
if(settings.direction === 'prev'){
goaway_left = '100%';
from_left = '-100%';
} else {
goaway_left = '-100%';
from_left = '100%';
}
$(sld + '.current').stop().animate({'left':goaway_left},sld_time);
$(sld).not('#' + sld_pre + sldnum).removeClass('current');
$('#' + sld_pre + sldnum).css({'left':from_left}).addClass('current').stop().animate({'left':0}, sld_time, function(){
sld_timer = setTimeout(function(){
sld_wrap.slide_next();
}, sld_wait);
});
$('.sld_navi_circle').not('#sld_navi' + sldnum).removeClass('current');
$('#sld_navi' + sldnum).addClass('current');
});
};
$.fn.slide_next = function(){
return this.each(function(i, elem) {
var sldnum = parseInt(sld_wrap.data('sldnum'));
sldnum++;
if(sldnum > sld_max){ sldnum = 1; }
sld_wrap.data('sldnum', sldnum).slide_move();
});
};
$.fn.slide_prev = function(){
return this.each(function(i, elem) {
var sldnum = parseInt(sld_wrap.data('sldnum'));
sldnum--;
if(sldnum < 1){ sldnum = sld_max; }
sld_wrap.data('sldnum', sldnum).slide_move({'direction': 'prev'});
});
};
sld_wrap.on('click', '.sld_navi_circle', function(){
var sldnum = parseInt(sld_wrap.data('sldnum'));
var sldnavi_num = parseInt($(this).data('sldnum'));
if(sldnum > sldnavi_num){
sld_direction = 'prev';
} else {
sld_direction = 'next';
}
sld_wrap.data('sldnum', sldnavi_num).slide_move({'direction': sld_direction});
});
$('#sld_next').click(function(){
sld_wrap.slide_next();
});
$('#sld_prev').click(function(){
sld_wrap.slide_prev();
});
$(window).load(function() {
var sld_count = 1;
var sld_navi_class;
$(sld).each(function(){
if(sld_count === 1){ sld_navi_class = 'sld_navi_circle current'; } else { sld_navi_class = 'sld_navi_circle' }
$(sld_navi).append('<a id="sld_navi' + sld_count + '" class="' + sld_navi_class +'" data-sldnum="' + sld_count + '"> </a>');
sld_count++;
});
var sld_timer = setTimeout(function(){
sld_wrap.data('sldnum', 1).slide_move();
}, 0);
});
});]]>
トップページかどうかを表示する関数は「is_front_page()」と「is_home()」の2つあります。どちらで判別するかは管理画面の「設定」>「表示設定」>「フロントページの表示」の設定に関係があります。この設定が「最新の投稿」(デフォルト)に設定されている場合はどちらも利用できますが、「固定ページ」に設定されている場合は、どのような表示の場合に「true」を返すのかが変わってきます。基本的にサイトアドレスを表示している場合を判別したい場合には「is_front_page()」を使うとよさそうです。「is_home()」は「固定ページでフロントページ」が設定されている場合、サイトアドレスにおいては「false」になってしまいます。
ここからは蛇足ですが、WordPressはもともとブログとして開発されたため、通常はサイトのフロントページ(トップページ)は最新の投稿一覧となります。しかしコーポレートサイトでの利用などを考えると、固定ページをサイトのフロントページとして表示させたい場合もあると思います。WordPressではそういったケースにも考慮されており、フロントページを固定ページとして、投稿一覧ページは別の固定ページとして設定できるようになっています。この設定の場合のために「is_home()」が存在します。
ややこしい場合は、とりあえずフロントページは「is_front_page()」を使い、投稿一覧ページは「is_home()」を使うようするといいかもしれません。
通常のフロントページを固定ページにしないやり方であればどちらでも構いません。
if(is_home()){
//「管理画面の表示設定でフロントページの表示が「最新の投稿に設定」かつ「トップページ」が表示されている場合
//または、フロントページの表示が「固定ページに設定」かつ「投稿ページに設定されているページ」が表示されている場合
}
if(is_front_page()){
//管理画面の表示設定でフロントページの表示が「最新の投稿に設定」かつ「トップページ」が表示されている場合
//または、フロントページの表示が「固定ページに設定」かつ「フロントページに設定されているページ」が表示されている場合
}
投稿(カスタム投稿タイプ)の詳細ページや、個別ページが表示されているかどうかを判別するための条件分岐になります。
個別ページを判別するWP関数は「is_singular()」や「is_single()」、「is_page()」などがありますが、「is_singular()」は他の分岐より広義であり、投稿タイプを問わず個別ページを表示しているかどうかのみを判別するため、いくつかの条件を設定する際は条件分岐を行うタイミングに注意が必要です。
投稿、カスタム投稿タイプ、固定ページの詳細ページかどうかを判別します。
また、引数を入れることで投稿タイプを指定することができます。投稿の詳細ページが表示されているかどうかを調べたいならば「is_singular(‘post’)」、固定ページが表示されているかどうかを調べたいならば「is_singular(‘page’)」、カスタム投稿タイプの名前が例として「topics」なら「is_singular(‘topics’)」となります。また、配列を入れることにより複数指定することが可能です。
固定ページは「is_page()」が用意されていますが、デフォルトで用意されている投稿タイプ「post」の詳細ページのみを判別する関数は無いので、そういった場合に便利かもしれません。
//引数無し
if(is_singular()){
//個別ページが表示されている場合
}
//投稿タイプを指定
if(is_singular('post')){
//「post(投稿)」の個別ページが表示されている場合
}
//投稿タイプを複数指定
if(is_singular(array('post','topics'))){
//「post(投稿)」または「topics(カスタム投稿タイプ例)」の個別ページが表示されている場合
}
投稿、またはカスタム投稿タイプの個別ページが表示されているかどうかを判別します。
引数に「投稿ID」や「タイトル」、「スラッグ」を入れることで該当の投稿を判別することができます。Codexによると、IDのつもりで「19」のような数値を引数に指定した場合は、投稿IDの「19」とスラッグの「19」を区別しないそうなので注意が必要です。恐らくタイトルとスラッグも同じ場合は区別しなさそうですが未確認です。
if(is_single()){
//投稿(カスタム投稿)の投稿ページが表示されている場合
}
//投稿IDを指定
if(is_single(16)){
//投稿のIDが「16」の投稿ページが表示されている場合(文字列として'16'を入れても大丈夫)
}
//タイトルを指定
if(is_single('Hello World')){
//投稿のタイトルが「Hello World」の投稿ページが表示されている場合
}
//スラッグを指定
if(is_single('hello-world')){
//投稿のスラッグが「hello-world」の投稿ページが表示されている場合
}
//配列で複数指定
if(is_single(array(16, 'Hello World', 'hello-world'))){
//投稿のIDが「16」、またはタイトルが「Hello World」、またはスラッグが「hello-world」の投稿ページが表示されている場合
}
固定ページが表示されているか判別します。
投稿と同じように引数に「投稿ID」や「タイトル」、「スラッグ」を指定することで該当のページに判別を狭めることができます。
if(is_page()){
//固定ページが表示されている場合
}
//投稿IDを指定
if(is_page(16)){
//固定ページのIDが「16」の固定ページが表示されている(文字列として'16'を入れても大丈夫)
}
//タイトルを指定
if(is_page('サンプルページ')){
//固定ページのタイトルが「サンプルページ」の固定ページが表示されている場合
}
//スラッグを指定
if(is_page('sample-page')){
//固定ページのスラッグが「sample-page」の固定ページが表示されている場合
}
//配列で複数指定
if(is_page(array(16, 'サンプルページ', 'sample-page'))){
//固定ページのIDが「16」、またはタイトルが「サンプルページ」、またはスラッグが「sample-page」の固定ページが表示されている場合
}
一覧ページの判別は「is_archive()」ですが、WordPressには様々なアーカイブの表示を用意しており、条件分岐もさらに細かい判別が可能です。
ここでは一覧ページが表示されている場合に利用できる条件判別を記載します。
「is_archive()」は一覧ページ判別の中でも一番大きな分類です。「is_singular()」が個別ページ全てを通すのに対し、「is_archive()」は日付アーカイブだろうがカテゴリーアーカイブだろうがカスタム投稿タイプアーカイブだろうが一覧ページであれば全てをtrueを返します。もしカテゴリーの場合とカスタム投稿タイプアーカイブの場合とで分けたい場合は順番に注意が必要です。
if(is_archive()){
//アーカイブページが表示されている場合
}
カスタム投稿タイプは、その登録をする際にアーカイブページを設けるかどうかを指定できます。もししていた場合、指定のパーマリンク設定によりアーカイブページが表示されるのですが、その判別に利用できるのが「is_post_type_archive()」です。
if(is_post_type_archive()){
//カスタム投稿タイプのアーカイブページが表示されている場合
}
if(is_post_type_archive('works')){
//カスタム投稿タイプ「works」のカスタム投稿タイプアーカイブページが表示されている場合
}
if(is_post_type_archive('works', 'staff')){
//カスタム投稿タイプ「works」または「staff」のカスタム投稿タイプアーカイブページが表示されている場合
}
日付関連のアーカイブページを判別します。「is_date()」はこれらの中で一番大きなくくりになり、「年別」や「月別」、「日別」の場合でもtrueを返します。
逆に言えば、どれか一つがtrueの場合は「is_date()」は常にtrueです。
余談ですが、このあたり、WordPressはリクエストされたURLから判断しているので、「2017」だとか、「10」だとかいうスラッグは固定ページや投稿ページに指定しない方がいいことが分かります。「2017」というスラッグの固定ページがあった場合、「http://xxx.xxx/2017/」のページを開こうとすると、年別アーカイブとしてではなく、固定ページとして判断されるので、「is_year()」は「false」となり逆に「is_page()」がtrueになってしまいます。
と、試しに固定ページのスラッグを「2017」に変更しようとしたところ、自動で「2017-2」となりました。数字を受け入れないのか、「1960」でも「1960-2」となり、「3000」でも「3000-2」となり、「10」でも「5」でも「30000」でも最後に「-2」がつくようになっていました。前はこんな設定ではなかったような気もしますが、さすがWordPressですね。
if(is_date()){
//日付のアーカイブページが表示されている場合
}
if(is_year()){
//年別のアーカイブページが表示されている場合
}
if(is_month()){
//年別アのアーカイブページが表示されている場合
}
if(is_day()){
//日別のアーカイブページが表示されている場合
}
カスタムタクソノミーアーカイブを判別する時は「is_tax()」を使います。第一引数にタクソノミー名を入れることでタクソノミーを指定し、第二引数にターム名を入れるとタームを指定します。注意点としては、デフォルトで存在するタクソノミー「category」一覧の場合は「is_tax()」はfalseが返されるとのことです。
また余談ですが、タクソノミーとタームは、なじみのない言葉だったので最初イメージがつかず嫌いでした。分類を表す言葉として馴染み深い「カテゴリー」というものはデフォルトのタクソノミーとして利用されているため、ちょうどいい名前の付け方がなかったのでしょうかね。
私の場合、ECショップを思い浮かべこの辺を覚えました。「色」や「サイズ」がタクソノミーにあたり、「赤」「青」や「S」「M」がタームにあたります。
if(is_tax()){
//カスタムタクソノミーのアーカイブページが表示されている場合
}
if(is_tax('mytax')){
//カスタムタクソノミー「mytax」のカスタムタクソノミーアーカイブページが表示されている場合
}
if(is_tax('mytax', 'myterm')){
//カスタムタクソノミーが「mytax」かつタームが「myterm」のカスタムタクソノミーアーカイブページが表示されている場合
}
カテゴリー一覧ページかどうかを判別するには「is_category()」を利用します。引数に値を入れることで、該当のカテゴリー一覧かどうかを条件分岐できます。指定は「ID」「カテゴリー名」「カテゴリースラッグ」のようです。
これも余談ですが、「is_category()」を利用して、もしカテゴリーIDが「1」の場合はこのテンプレートを読むこむといった処理をたまにオリジナルテーマで見かけますが、カテゴリーを追加する度にテーマを変更しなくてはいけないため保守性が悪い気もします。カテゴリーによって何を切り替えるかによりますが、CSSで済む話ならカテゴリースラッグを大枠のタグにIDとして埋め込めばいいですし、背景画像や画像も読み込むファイルをスラッグ名にすれば可能です。文章ならカテゴリーの説明文もありますし、カテゴリースラッグとメディアのファイル名を結び付けることもできるそうです。プラグインを利用するなら「Advanced Custom Field」などでカテゴリーにメタ情報を簡単に設定できるようになります。
if(is_category()){
//カテゴリーのアーカイブページが表示されている場合
}
if(is_category(7)){
//カテゴリーID(tag_id)が「7」のカテゴリーアーカイブページが表示されている場合
}
if(is_category('トピック')){
//カテゴリー名が「トピック」のカテゴリーアーカイブページが表示されている場合
}
if(is_category('topic')){
//カテゴリーのスラッグが「topic」のカテゴリーアーカイブページが表示されている場合
}
if(is_category( array(7, 'トピック', 'topic'))){
//カテゴリーID(tag_id)が「7」、またはカテゴリー名が「トピック」、またはカテゴリーのスラッグが「topic」のカテゴリーアーカイブページが表示されている場合
}
タグのアーカイブページ一覧を条件分岐で判別する場合には「is_tag()」を利用します。普段あまりタグを利用しないのですが、見たところカテゴリーと一緒でしょうか。
if(is_tag()){
//タグのアーカイブページが表示されている場合
}
if(is_tag(9)){
//タグID(tag_id)が「9」のタグアーカイブページが表示されている場合
}
if(is_tag('赤色')){
//タグ名が「赤色」のタグアーカイブページが表示されている場合
}
if(is_tag('red')){
//タグのスラッグが「red」のタグアーカイブページが表示されている場合
}
if(is_tag( array(9, '赤色', 'red'))){
//タグID(tag_id)が「9」、またはタグ名が「赤色」、またはタグのスラッグが「red」のタグアーカイブページが表示されている場合
}
表示に関する条件分岐として上記にいろいろ載せましたが、他にも利用できそうなものがあります。
テーマの作成というよりプラグインの方に近いかもしれませんが、「is_admin()」は管理画面が表示されている場合を条件分岐として判別してくれます。
Codexにも書いてありましたが、ログインの有無や権限などのチェックは行っていないそうなので、その辺の判別もしたい場合は別のWP関数と併用する流れになるでしょうか。
if(is_admin()){
//管理画面が表示されている場合
}
著者ページが表示されているかを条件分岐として判別するには「is_author()」を利用します。引数により「ID」や「ニックネーム」、「ナイスネーム」によって条件分岐することができます。
またまた余談ですが、個人的に英語と日本語の関係で「姓」と「名」が逆だったりとこの辺のメタ情報まわりの構成はあまり好きではありません。
if(is_author()){
//著者ページが表示されている場合
}
if(is_author(2)){
//ユーザーIDが「2」の著者ページが表示されている場合
}
if(is_author('田中くん')){
//ユーザーのニックネームが「田中くん」の著者ページが表示されている場合
}
if(is_author('mr-tanaka')){
//ユーザーのナイスネームが「mr-tanaka」の著者ページが表示されている場合
}
if(is_author( array(2, '田中くん', 'mr-tanaka'))){
//ユーザーIDが「2」、またはユーザーのニックネームが「田中くん」、またはユーザーのナイスネームが「mr-tanaka」の著者ページが表示されている場合
}
検索ページの判断になります。検索ワードなどをタイトル入れたいなどの場合に利用できそうですね。
if(is_search()){
//検索結果ページ表示されている場合
}
404エラーのページが表示されている場合、「is_404()」はtrueを返します。
if(is_404()){
//404ページ表示されている場合
}
ユーザーに関する条件分岐をまとめてみました。エンドユーザーが何かしらユーザー登録できるシステムや、会員制サイトの際など、様々なケースで必要になってくると思います。
ユーザーがログインしているかどうかの判別です。ログインユーザーのみに表示をさせたい項目がある場合などに利用できます。
ログイン情報を元に表示させたい場合にも、先に「is_user_logged_in()」の条件分岐を挟んだ方がベターだと思います。
if(is_user_logged_in()){
//ユーザーがログインしている場合
}
ユーザーIDを指定し、そのユーザーが権限を持っているかを判別することができます。
ユーザーIDの取得は別のWP関数などで行う必要があります。
if(user_can(8, 'administrator')){
//ユーザーID「8」のユーザーが、権限グループ「administrator(管理者)」の場合
}
現在ログインしているユーザーが権限を持っているかを判別します。上記の「is_user_logged_in()」と「user_can()」を合わせた感じでしょうか。
if(current_user_can('administrator')){
//ログインユーザーが、権限グループ「administrator(管理者)」の場合
}
メールが登録されているかを判別し、存在すればユーザーIDを返します。会員制やユーザーの機能を利用したシステムで色々使えそうですね。
新規ユーザー登録あたりはコアなシステムやプラグインに任せるとしても、返り値を利用してメールアドレスからユーザー情報を引っ張る、ログインしているユーザーIDと同じメールアドレスを入力しているかどうかの判別など、便利そうです。
例えばユーザー同士の交流ができる掲示板サイトをWordPressで構築したとします。ユーザーが作成した掲示板に誰かのメールアドレスから招待したい場合、この条件分岐を行えば、「既に登録済み」>「招待が来た旨のメッセージ」、「未登録」>「ユーザー登録のメール」というシステムの流れをくむことができます。
if(email_exists('xxx@sample.com')){
//メールを「xxx@sample.com」として登録しているユーザーが存在する場合
}
投稿タイプに関する条件分岐では、投稿タイプが存在するかや、現在の投稿の投稿タイプで条件分岐を行いたい場合などを記述します。
投稿タイプが存在するかをチェックする関数です。
恐らくリクエストからの判断に利用されているものだと思いますが、例えばオリジナルの検索機能を付けて、投稿タイプの絞り込みフォームを作成した際などに、検索者が投稿タイプとしての正しい値を入れているか判断するのに利用できそうです。あとは自動で投稿タイプを作るシステムを組み込んでいるときでしょうか?プラグインの有効化の際に判断するのはありそうですが。
if(post_type_exists('works')){
//投稿タイプ「works」が存在している場合
}
現在の投稿が指定した投稿タイプかを条件分岐するためには「is_post_type()」と言いたいところですが、存在しないようです。
しかし、詳細ページ、アーカイブページで分けるならば投稿タイプの条件分岐は可能です。例えば「works」という投稿タイプがあったとして、「is_singular(‘works’)」で「works」のシングルページかどうか、「is_archive(‘works’)」で「works」のアーカイブページかどうかを判断することが可能です。
しかし、独自ループなどで投稿タイプが混在し、投稿タイプを取得したいことはあると思います。そうした場合には「get_post_type()」を利用して投稿タイプを取得したのち、それが「works」かどうかを判断する流れです。
また、ループ外で取得したい場合は「get_query_var(‘post_type’)」を利用してクエリから投稿タイプを取得できます。
if(get_post_type(10) === 'post'){
//投稿ID「10」の投稿の投稿タイプが、「post」の場合
}
if(get_post_type(get_the_ID()) === 'post'){
//ループ内において、現在の投稿の投稿タイプが「post」の場合
}
$post_type = (is_archive()) ? get_query_var( 'post_type' ) : get_post_type();
if($post_type === 'post'){
//表示しているページの投稿タイプが「post」の場合
}
カテゴリーに関する条件分岐では、タクソノミー関連も一緒にまとめたいと思っています。
「in_category()」は投稿がカテゴリーに属するかを判断します。カテゴリーに属するかという条件分岐なので、第一引数にカテゴリーを指定しなくてはなりません(必須)。第二引数に投稿IDを指定することができます。
よく記事で見かける話になってしまいますが、「in」と「is」は違います。同じことを書いてもあれなのでナメた感じに書くと以下のような感じでしょうか。
is_category(8)の場合、
ここってカテゴリー8だよね
→ うん、そうだよ! > true
→ 違うよ… > false
in_category(8,25)の場合、
投稿「25」さんってカテゴリー8に入ってるよね
→ うん、入ってる! > true
→ 違うよ、嘘つき! > false
と、クエリに対してカテゴリーを判別したい場合と、投稿に対してカテゴリーを判別したい場合と別れていることが分かるかと思います。一文字しか違いませんが。
if(in_category(8)){
//現在の投稿がカテゴリーID「8」のカテゴリーに属するか
}
if(in_category(8, 10)){
//ID「10」の投稿が、カテゴリーID「8」のカテゴリーに属するか
}
if(is_email($my_mail)){
//変数「$my_mail」が、メールアドレス式の文字列の場合
}
if(is_serialized($serialize_text)){
//変数「$serialize_text」がシリアライズされている場合
}
$filetype = wp_check_filetype($file);
if($filetype[‘ext’] === ‘jpg’){
//変数「$file」の拡張子が、「jpg」の場合
}
if($filetype[‘type’] === ‘image/jpeg’){
//変数「$file」のMIMEタイプが、「image/jpeg」の場合
}
「PostgresからMySQLに変える作業」と「会員情報を移管する作業」の2つの作業の流れになります。会員情報を移管する流れだけを知りたい場合は最初の方は飛ばして大丈夫かと。
まずは旧サイトのphpPgAdminから吐き出されたdumpfileをPostgreSQLにインポートします。これはあくまでPostgreSQLからMySQLへ移す中間点のために必要な作業なので、新サーバの必要もなくローカルで構築したサーバでも大丈夫だと思いますが、理想はPostgreSQLのバージョンをそろえる方がいいかと思います。今回の場合は新サーバでPostgreが使えない環境だったため他のサーバを利用しました。
この項目は会員情報を移換するだけの方は必要ありません。また、旧サイトも管理下にあって実際に抽出する側の場合は、phpPgAdminからデータをエクスポートする必要があります。
とりあえずphpPgAdminで旧サーバのデータを入れることができたら、次は会員情報のテーブルを抜き出します。顧客データが入っているテーブルは「dtb_customer」です。phpPgAdminの場合は左メニューより「dtb_customer」テーブルを選択し、「エクスポート」からCSV形式でダウンロードします。
旧サーバより吐き出されたCSVを整形します。エクセルで開くと文字化けなんかしてしまうことがあるので、Googleスプレッドシートで開きました。無料だしとても便利です。
MySQLで見る「NULL」は、Googleスプレッドシートでは「\n」の文字列となって表示されています。
カラム「salt」の値を全て「\n」にしてしまいます。1つの行だけ入れ、角にカーソルを合わせてツタタタターっと伸ばしてしまえば同じ値が入ります。
吐き出されたCSVは最初にカラム名が入っています。「name」とかそういう最初の行です。これを行の削除で消してしまいます。
※Googleスプリットシートでやったからわかりませんが最後に2行空の行が入っていたので消してしまいました。
書き出して別名保存しておいた方がいいと思います。あとで利用するかもしれません。
ここまできたら新サイトにECCUBEをインストールします。バージョンは旧サイトのECCUBEのバージョンとそろえた方がいいと思います。
インストール方法は省略しますが、今回はMySQLにて旧サイトと同じバージョンでECCUBEをインストールしました。
以下はインポートする際に行った設定です。
ここまでで既に会員データを管理画面から確認できますが、会員データをデータベースに直接インポートした場合、新規会員登録の時にシステムエラーが発生します。理由は何となくですが、ID1として登録ってもう既にID1いるじゃないですか!って感じだと思います。
phpMyAdminで以下を行いました。
会員のパスワードは暗号化されてデータベースに挿入されているのですが、新しくECCUBEをインストールした場合はその解読方法も変わってしまうので、このままではせっかく入れ込んだ会員がログインできません。
以下の方法のように、同じキーを入れてあげることでパスワードに対する解釈が旧サイトと同じになりログインできるようになるのですが、今度はインストール時に設定した管理者はログインできなくなるため、1番目の手順は忘れずに必ず行った方がいいと思います。
これで多分大丈夫です。もし不安な場合はログアウトする前に違うブラウザでログインしてみましょう。
ECCUBEってややこしいイメージがありましたがやっぱりややこしいと思いました。
]]>
これがあれば一発と思い検索しても出なかったため中身をたどってみると、パスワード保護されているかを判定する関数はpost_password_required()ぽいでした。Codexにはこう書いてありました。
参考URL:テンプレートタグ/post password required – WordPress Codex 日本語版
投稿がパスワードを必要とするか否か、また正しいパスワードが入力されたか否かを確認する関数。
これは$postに投稿オブジェクトまたは投稿IDを入れることで(ループ内不要)、その投稿がパスワードを要求していてパスワードが一致しない場合に「true」を返すものです。パスワードが不要であったり、パスワードが一致した場合にfalseを返すとのこと。
パスワードを入力するフォームを取得する関数はget_the_password_form()です。この関数はパスワードで保護されている投稿の入力フォームを取得するものらしいのですが、フィルターフック「the_password_form」を通しているらしいので、入力フォームを編集したいときはこれを利用すればいいですね。
上記の2つをまとめるとこんな感じになります。
if ( post_password_required() ){
//パスワード入力フォームを出力
echo get_the_password_form( $post );
} else {
//隠したい情報
}注意点として、$postの中身を変えている場合はきちんと「post_password_required()」の引数に入れる必要があります。また、get_the_content()の中にもこのような記述があるため、「the_content()」などは隠したい情報の方に入れるよう設定した方がいいかもしれません。
これでカスタムフィールドを表示する場合や日付やカテゴリーも隠したいなんていった場合に、任意のコンテンツを非表示にすることができます。