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')){ ... }
基本的なことですが…。ページの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');]]>
トップページかどうかを表示する関数は「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」の場合
}
これがあれば一発と思い検索しても出なかったため中身をたどってみると、パスワード保護されているかを判定する関数は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()」などは隠したい情報の方に入れるよう設定した方がいいかもしれません。
これでカスタムフィールドを表示する場合や日付やカテゴリーも隠したいなんていった場合に、任意のコンテンツを非表示にすることができます。
WordPressのいいところでコアなところを編集しないでいいようにアクションフックが用意されており、「ある処理を行ったときにこの処理もする」といったことが可能になります。ユーザーを追加したときというアクションフックがあるため、そこに投稿する関数を付け足すイメージです。
ユーザーを追加するときのアクションフックは「user_register」になります。「user_register」は引数にユーザーIDを受け渡すことが出来るため、新規追加したユーザーの情報をタイトルや本文、カスタムフィールドなどに利用できるわけです。
function auto_insert_page( $user_id ) {
//ここに処理を記述
}
add_action( 'user_register', 'auto_insert_page', 10, 1 );
新しく投稿するには「wp_insert_post()」を利用しました。投稿の情報を色々と設定できるのですが、その中で投稿タイプも設定できるのでカスタム投稿タイプを利用したい場合などにも便利です。タイトルと本文は必須になります。Codexの説明でどのような設定が可能かみれますので参考にしてみてください。この関数は投稿が成功した場合、投稿IDを返しますので、続けて処理が可能です。
/*設定 ====================================================*/ $my_post = array( 'post_title' => '新しい投稿!', //タイトル 'post_content' => 'この投稿は自動で投稿されました。',//本文 'post_type' => 'page', //投稿タイプ(post,page,カスタム投稿タイプ) 'post_status' => 'publish',//ステータス 'post_author' => 1,//著者 'comment_status' => 'open'//コメントの受付 ); /*投稿 ====================================================*/ $post_id = wp_insert_post( $my_post );
ユーザーと結び付けるためにカスタムフィールドを利用しました。作成した著者を新ユーザーにしてもよかったのですが、ユーザーには編集の権限を持たせたくなかったので今回はユーザーと関連付けるだけにとどめました。カスタムフィールドを更新するには、「update_post_meta() 」を利用します。引数は順に、「投稿ID」、「カスタムフィールドのキー」、「カスタムフィールドの値」となっています。
/*
====================================================*/
if($post_id) {
update_post_meta($post_id, 'profile_user', $user_id);
}
これらを組み合わせると以下のようになります。「auto_insert_page( $user_id )」はユーザー定義関数で、「add_action( ‘user_register’, ‘auto_insert_page’, 10, 1 );」と結びついています。ユーザーを追加したときに「auto_insert_page()」を行うということですね。
また、「get_user_meta()」では登録されたユーザーIDからそのユーザーメタ情報を引っ張ってきています。ここでの注意点は、ユーザー登録フォームにて必須になるものだけを利用した方がよさそうです。ログインID、メールアドレスやパスワードのみしか登録の際に行っていない場合、値が空になってしまいます。
そしてフォームからの情報を利用する場合、悪意ある攻撃を防ぐために「wp_strip_all_tags()」を使います。
function auto_insert_page( $user_id ) {
$user_name = get_user_meta($user_id,'last_name',true);
/*設定
====================================================*/
$my_post = array(
'post_title' => wp_strip_all_tags($user_name.'さんのプロフィール'), //タイトル
'post_content' => ' ',//本文
'post_type' => 'page', //投稿タイプ(post,page,カスタム投稿タイプ)
'post_status' => 'publish',//ステータス
'post_author' => 1,//著者
'comment_status' => 'open'//コメントの受付
);
/*投稿
====================================================*/
$post_id = wp_insert_post( $my_post );
/*もし成功していたらカスタムフィールド「profile_user」を更新
====================================================*/
if($post_id) {
update_post_meta($post_id, 'profile_user', $user_id);
}
}
add_action( 'user_register', 'auto_insert_page', 10, 1 );
ここまでで既に新規ユーザーが追加されたときに固定ページが作成されます。実際に利用するには、「ユーザーIDから関連付けられたページを取得したい」といったことも出てくると思います。今回は「$wpdb」を利用して取得します。1ユーザーにつき1件しかない想定のため配列の「0」番目を返す設定になっていますが、複数取得する場合は配列ごと返してあげてもいいかもしれません。
function my_get_page_by_userid($user_current_id){
global $wpdb;
$page_id = '';
$meta_key = 'profile_user'; //カスタムフィールドのキー
$meta_value = $user_current_id;
$arrPostIds = $wpdb->get_col($wpdb->prepare("select post_id from wp_postmeta where meta_key = %s and meta_value = %s", $meta_key, $meta_value));
$page_id = $arrPostIds[0];
return $page_id;
}ログインユーザーから利用したい場合は、以下のようにすると関連付けられたIDを取得できます。
if(is_user_logged_in()) { //ログインしている場合
$now_user = wp_get_current_user();//ログインユーザーの情報を取得
$now_user_id = $user->get('ID');//IDを摘出
$page_id = my_get_page_by_userid($now_user_id);//上で作った関数でIDを取得
}
]]>インストールは以下の流れに沿って簡単にできます。
「管理画面」>「プラグイン」>「新規追加」>「Bogo」で検索 >「インストール」
言語ファイルをダウンロードする必要があるようです。日本語版を構築したのなら既に「日本語」と「英語」は備わっています。
それ以外の言語をダウンロードする場合は、管理画面の「ツール」>「Bogo」より様々な言語をインストールできます。ここでインストールした言語は言語ボタンに反映されるので必要な言語だけインストールするといいかと思います。
Bogoを有効化すると投稿(固定ページ)編集画面にて、右上の「公開」ボックスの上に「言語」のボックスが表示されます。最初は恐らく日本語になっていると思いますが、翻訳ページを作ることでここに結び付けられた投稿のタイトルが表示されるようになります。まずは多言語化する投稿の流れになります。
多言語するボタンを設置するためにBogoではショートコード[bogo]を用意しています。本文中に挿入する場合は記事の本文に、テーマで利用する場合は
<?php echo do_shortcode('[bogo]') ?> を挿入します。実際にされる表示はインストールされている言語が国旗付きで並び、翻訳ページがあるものだけリンクになっています。これで投稿・固定ページの多言語化は完了です。
カテゴリーページや月別アーカイブなどの一覧ページでは、該当の言語の投稿しか表示されません。例えばデフォルトの言語が日本語だった場合、カテゴリー「news」一覧を表示するURL「http://ドメイン/category/news/」では日本語のみを表示し、「http://ドメイン/en/category/news/」では英語のみを表示します。そのため、英語に翻訳した「news」カテゴリーの記事がない場合はhaspost()がfalseになり記事がない場合の処理になってしまいます。この辺りは既に記事を大量に作成している人にとっては大変ですね。
the_title()などの投稿の情報を表示する場合は良いですが、サイトのタイトル、カテゴリー等を多言語化するためには一工夫が必要です。
Bogoには現在の言語を取得してくれる関数「get_locale()」が定義されています。これを利用した条件分岐により、日本語だったらこのテンプレートを読み込む、英語だったらこのテキストにする、などといったことが可能になるかと思います。すべてこれで行うとなると結構手間ですけどね。
$locale = get_locale(); if($locale == 'zh_TW') : echo '台湾です'; elseif($locale == 'en_US') : echo '英語です'; else : echo 'その他'; endif;
テーマ内では「get_option(‘home’)」などでホームのリンクを指定している方もいると思いますが、とりわけオリジナルテーマを作成している場合、固定ページのリンクは直に書き込みしていることが私は多いです。特にグローバルメニュー。英語の時はこのリンクで、日本語の時はこのリンクで、と条件分岐してもいいですが手間がかかりそうです。
そこで、「wp-content/plugins/bogo/includes/functions.php」の378行目あたりで定義されている「bogo_url()」が便利かもしれません。第一引数にURLがありますが、これを指定しないと現在のリクエストとなってしまうため、グローバルメニューで使う際はURLを指定しましょう。
<ul>
<li><a href="<?php echo bogo_url('http://domain.com/about/'); ?>">ABOUT</a></li>
<li><a href="<?php echo bogo_url(get_option('home').'/service/'); ?>">SERVICE</a></li>
<li><a href="<?php echo bogo_url(get_option('home').'/category/news/'); ?>">NEWS</a></li>
</ul>
国旗はいらないとか、独自のクラスを付けたいとか、HTMLタグを変えたいとか、ヘッダーやフッターなどテーマに挿入する場合色々とやりたいことが出てくると思います。ここではプラグインの関数を参考に、オリジナルの多言語化ボタンを作成してしまいましょう。ちなみに国旗はCSSの背景指定なので関数を作成しなくても該当のCSSを探し出して変更すれば大丈夫です。
※この項目はバージョンによって異なる可能性があるので注意が必要です。
オリジナルのプログラムを組んだりしていて投稿を扱っていると、取得した投稿がどの言語なのかを判別したいときがあります。BOGOでは投稿の言語を、'_locale'をキーとしたメタ情報を保存しています。そのため、get_post_meta()を利用して言語キーを取得できるというわけです。
$locale = get_post_meta( $post_id, '_locale', true );
]]>
まずはWP-Membersの導入です。詳しく書かれたサイトがたくさんあるのでここでは簡単に書きます。
「プラグイン」>「新規追加」>「WP-Members」で検索 > 「インストール」>「有効化」
プラグインを有効化するといくつかの注意が表示されます。一応従っておきます。
・「設定」>「一般」>「だれでもユーザー登録ができるようにする」のチェックを外して更新
・「設定」>「ディスカッション」>「ユーザー登録してログインしたユーザーのみコメントをつけられるようにする」のチェックを外して更新
・「設定」>「表示設定」>「RSS/Atom フィードでの各投稿の表示」を「抜粋のみを表示」にチェックして更新
WP-Membersで利用されるログインページ、登録ページ、プロフィールページの3つを作成しておきます。
例1)タイトル「ログインページ」スラッグ「login」
例2)タイトル「会員登録」スラッグ「register」
例3)タイトル「マイページ」スラッグ「mypage」
本文には[wp-members page="members-area"]を入れると「プロフィール編集」や「パスワードの変更」が表示されます。
テーマに「page.php」がないと表示されないらしいので作成しておきます。最低限、ループにthe_contentが利用されていれば大丈夫かと思います。
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); the_content(); endwhile; endif; ?>
自分のサイトに合わせて設定していきます。「固定ページ」の項目は先ほど作成したページを選択させます。
最初から「州」や「電話番号」などが追加されているので、削除したり追加したりして編集します。
ドロップダウンを選択した場合は、値とラベルを「|」で区切り、「”」で囲みます。また、最後の行以外は「,」を末尾につけて改行させます。
例)
“北海道|address01”,
“青森|address02”,
・・・
“沖縄|address47”
エラー時のメッセージなど、ダイアログを編集できます。ログインページや会員ページにリンクをつけた方が親切な項目もあります。
「新規ユーザー登録」、「パスワードリセット」などの時に送信されるメールの設定です。
翻訳ファイルが間に合っていないのかは分かりませんが、英語のままの個所があります。翻訳ファイルを編集するか、日本語のみの予定ならプラグインファイルを直接修正してしまいます。アップグレード時に注意ください。
私の場合は以下のファイルを修正しました。
・wp-membears > wp-members-dialogs.php
・wp-membears > forms.php
いくつかCSSが用意されていますが、サイトに合わせたい場合は整えます。
基本的なところはできたところで、ユーザー情報をCSVから一括登録できるプラグインを導入します。
「プラグイン」>「新規追加」>「Members Import」で検索 > 「インストール」>「有効化」
ここでは、Members Importを利用してCSVをインポートするためにCSVのデータを整えます。
コピペや編集がしやすいので、私は「OpenOffice Calc」を利用しました。
文字コードは必ず「utf-8」にします。1行目はヘッダー部分となります。「address」と「birthday」はWP_Membersの「フィールド」で追加したものになります。
メールアドレスなど必須のところは入れる必要がありますが、ウェブサイト(user_url)など必須ではないところは無視しても大丈夫でした
表で見た場合
| user_email | user_pass | user_login | first_name | nickname | display_name | address | birthday |
|---|
テキストエディタで見た場合
"user_email","user_pass","user_login","first_name","nickname","display_name","address","birthday"
既存のユーザー情報が入ったCSVを入れ込んでいく前に、文字コードをUTF-8にする必要があります。「TeraPad」などのフリーのテキストエディターでCSVを開き、文字コードをUTF-8にして別名保存します。
「OpenOffice Calc」で各CSVを開いた場合は基本的にコピーペーストで大丈夫かと思います。データを分割したり整えながら当てはめていきます。
フィールドの区切り記号を「,」、テキストの区切り記号を「”」にする必要があります。
以下は「OpenOffice Calc」の方法になります。
最後に実際にユーザー情報をインポートします。流れは簡単ですが、インポート画面の注意書きにあるように必ずデータベースのバックアップを取っておくことをお勧めします。
ユーザー一覧に登録されていれば完了です。一度ログインを試してみた方がいいかもしれません。
今回の場合は、既存のユーザー情報のCSVがある場合に限りますが、WP-Membersを利用していなくても使えるプラグインだと思います。
私はこの方法でできましたが、データベースを一括登録させますのであくまでも自己責任でお願い致します。
ここでは「Any Mobile Theme Switcher」のインストール方法と、設定方法を説明しますが、とても簡単なので、簡単に説明します。
前提としては既にスマホ用テーマが作成してある段階です。
オプション設定はこのようになっています。
ここではテーマの作成についてになります。PC版、スマホ版のテーマをそれぞれ作成しても、データベースが1つなのは忘れてはいけません。できれば画像も最適化したいところです。
以下のコードをテーマ内に記述すると、PC版ならスマホ版へのリンク、スマホ版ならPC版へのリンクが挿入されます。
<?php echo do_shortcode('[show_theme_switch_link]'); ?>入力されたコンテンツは1つのため、本文に挿入された画像が大きければスマホの人にとって重くなります。レスポンシブデザインの際にはよくある話ですが、せっかくスマホ用のテーマを作成しているのでこれをショートコードを作成することにより解決します。
テーマフォルダ内にあるfunctions.php内にショートコードを登録する流れとなるのですが、PCとスマホではテーマを変えれるのでそれを利用して読み込む先のURLを変動させるというものです。
また、このショートコードはテスト環境で行っている場合にも利用できます。本番サーバになりURLが変更されても、本文中に入力した画像のパスを変更しなくて済むわけです。
以下をfunctions.phpに追加します。
function my_shortcode_img($atts){
extract(shortcode_atts(array(
'src' => '',
'alt' => ''
), $atts));
$img_path = get_option('home').'/images/'.$src; //ここが画像のパス
//$img_path = get_option('home').'/images/sp/'.$src; スマホの場合
$img_tag = '<img src="'.$img_path.'" alt="'.$alt.'" />';
return $img_tag;
}
add_shortcode('img', 'my_shortcode_img');これをPCの場合とスマホの場合でパスを分けて保存することにより本文内の画像のを切り分けることができます。
テンプレートフォルダを参照すれば一発ではあるのですが、私の場合大抵はドメインの直下に「images」フォルダを作り、その中にまとめて画像ファイルを入れているので「get_option(‘home’)」を利用しています。
このコードを利用して参照する場合は両方のパスに画像が存在する必要があるため、クライアント側にとっては面倒な作業になるかもしれません。
また、投稿画面から入力した画像を表示するには、また別の操作が必要です。
使い方は、を挿入します。