Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: preg_replace(): Compilation failed: invalid range in character class at offset 4 in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php on line 340

Warning: Cannot modify header information - headers already sent by (output started at /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-content/plugins/crayon-syntax-highlighter/crayon_langs.class.php:340) in /home/tetch1987/tetch1987.com/public_html/shittakabull/wp-includes/feed-rss2.php on line 8
テーマ作成 – ShitTakaBull by tetch1987 https://tetch1987.com/shittakabull WordPress関連やjQueryなどウェブ制作のテクニックデータベース Tue, 06 Nov 2018 06:46:12 +0000 ja hourly 1 https://wordpress.org/?v=7.1.5 WordPressのContact Form 7をフックを利用してカスタマイズ https://tetch1987.com/shittakabull/web/customize-contact-form-7-using-hook/ https://tetch1987.com/shittakabull/web/customize-contact-form-7-using-hook/#respond Tue, 06 Nov 2018 04:51:11 +0000 https://tetch1987.com/shittakabull/?p=848 Contact Form 7は言わずと知れたWordPressのお問い合わせフォーム作成プラグインですが、もう少し機能を追加したいってことがあると思います。プラグインなどをカスタマイズしたいときはアクションフックやフィルターフックを利用すると便利なのですが、プラグイン自体の構造やプログラムの流れをある程度把握しないといけないので、調べたるのが結構な手間になったります。調べることが勉強になったりするのですが、そんな時間がないって人のために(本当は忘れっぽい自分のために)、Contact Form 7をカスタマイズしたいという時に役に立つ解釈を書いていきます(解説ではなく解釈!)。しかしながらバージョンによって異なるので、もしバージョンが違う場合は確認をしてくださいね。

var 5.0.5

目次

Contact Form 7の便利なフック一覧表

フック名 フックの種類 説明
wpcf7_validate フィルター 送られた値を検証
wpcf7_mail_sent アクション メールが送信された後に実行するフック

アクションフックとフィルターフックについて

WordPressにはアクションフックとフィルターフックという仕組みがあります。これは一言でいうと手を加えること。WordPressが動く一連の流れの途中で、何かを追加して実行したり、値を変えたり、独自の関数を挟むことができる機能です。例えば「投稿が保存されたとき」とか、「テンプレートが読み込まれた時」とか、WordPressでは様々なフックが要所要所で用意されているので、いい感じのところで機能を追加したり値を変えたりができるわけですね。「ユーザーが追加されたとき」に「カテゴリーを追加する」なんてこともできちゃうです。フック一覧についてはCodexで確認できます(アクションフック一覧 / フィルターフック一覧)。
わざわざフックを利用せずに直接ファイルを変更してカスタマイズすることも可能ではありますが、WordPressではコアな部分は編集しない方針があります。それはWordPressをバージョンアップする度に編集する必要が出てくることや、プラグインやテーマはコアファイルがデフォルトの前提で設計されているなど、安全性からみても管理性からみてもあまりいいことがないからです。しかし良い感じのところにフックが用意されているので余程特殊なことをしない限りはフックによってカスタマイズができるかと思います。
それはプラグインにも同じことが言えます。バージョンアップもありますので、余程のことがない限りプラグインのコアファイルも編集しないほうがいいでしょう。親切なプラグインの場合はフックを要所要所で用意していますので、プラグインは設定やフックを利用してカスタマイズするのが基本です。
今回のContact Form 7も色々とフックが用意されているので、カスタマイズする場合は、フックに引っ掛けるイメージで関数を実行したり、値を変更したりする流れになります。

フォーム送信後、送られた情報をチェックするフック

送られた情報をチェックするにはwpcf7_validateのフィルターフックを利用すると便利です。これはフォームが送信されてからの流れの途中で実行されるフィルターで、お問い合わせのタグデータを引数として使えたり、エラー時のメッセージを設定できたりと、検証するのにうってつけです。
送信データのチェックは、郵便番号の形式のチェックを追加したり、確認用メールアドレスのチェックを追加したりと、使いどころの多いフックになると思いますが、ContactForm7のプラグイン自体はこのフィルターを利用していないのでカスタマイズ用に用意してくれているフックなのでしょうね。

フィルターフック「wpcf7_validate」について

フィルターフック「wpcf7_validate」は$result = apply_filters( 'wpcf7_validate', $result, $tags );のようにフィルターを通しており、「$tags」を引数として「$result」に対してフィルタリングをすることができます。
流れとしては以下のようになります。

  1. ① フォームが送信されたときに「submit()」を実行
  2. ② 「submit()」内で送信データを検証するためif ( ! $this->validate() ) {として「validate()」を実行
  3. ③ 「validate()」内でそれぞれのお問い合わせ用のタグを検証
  4. ④ 次にタグ全体を引数として結果をフィルターフック「wpcf7_validate」に通す
  5. ⑤ 「validate()」が、「無効な項目がある場合はfalse」、「無効な項目がない場合はtrue」を返す
  6. ⑥ 無効な項目がある場合はif ( ! $this->validate() ) {に当てはまり、CF7が「validation_error」としてエラーメッセージを返す

注目したいのは⑤で、無効の項目があるかどうかによって検証結果を判別しているところです。フィルタリングを行ってチェックをしたとしても、$resultに対し無効な項目を設定しなければ「無効ではない」と判断されてメールが送信されてしまいます。
そのためadd_filterでフィルタリングを行う関数には、何らかの条件下で無効としたい箇所に$result->invalidate( $name,$message);のような記述して、無効な項目をセットします。

実行ファイル
「contact-from-7」>「includes」> submission.php / 271行
$result = apply_filters( 'wpcf7_validate', $result, $tags );

フィルターフック「wpcf7_validate」の使用例

ネットで色々調べると引数で受け取ることができる「$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;
}

特定のtypeの時に行いたい場合

タグ全体を引数としてフィルターをかける「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」について

アクションフック「wpcf7_mail_sent」はdo_action( 'wpcf7_mail_sent', $contact_form );のように実行されており、「$contact_form」を引数として実行されます。
流れとしては以下のようになります。

  1. ① フォームが送信されたときに「submit()」を実行
  2. ② 「submit()」内で検証後、if ( $this->mail() ) {でメール送信
  3. ③ 送信が成功すると、ステータスが「mail_sent」/’mail_sent_ok’のメッセージがセット
  4. ④ do_action( 'wpcf7_mail_sent', $contact_form );を実行

ここでの注目したい所は、すでに検証が終わっており、メールも送信後になることです。

実行ファイル
「contact-from-7」>「includes」> submission.php / 219行
do_action( 'wpcf7_mail_sent', $contact_form );

アクションフック「wpcf7_mail_sent」の使用例

メール送信後に何かしたい場合に実行できるわけですが、$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");

]]>
https://tetch1987.com/shittakabull/web/customize-contact-form-7-using-hook/feed/ 0
WordPressのカスタム投稿タイプとカスタムタクソノミーまとめ https://tetch1987.com/shittakabull/web/wordpress-custom-postype-and-taxonomy/ https://tetch1987.com/shittakabull/web/wordpress-custom-postype-and-taxonomy/#respond Thu, 14 Jun 2018 08:44:01 +0000 https://tetch1987.com/shittakabull/?p=822 WordPressには「投稿」や「カテゴリー」といったデフォルトの投稿タイプや分類方法(タクソノミー)がありますが、functions.phpでの指定やプラグインを利用することでオリジナルの投稿タイプとタクソノミーを登録することができます。それが「カスタム投稿タイプ」と「カスタムタクソノミー」です。私は最初、日本語で躓いたりしたので、その辺も踏まえつつ、「カスタム投稿タイプ」や「カスタムタクソノミー」について、登録から表示、色々な関数を説明します。

目次

「投稿タイプ」「タクソノミー」、「ターム」とは?

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');

register_post_typeの説明

上記の記述を詳しく説明していきます。大まかな流れでは「add_custom_post_car()」という関数を作成し、「WordPressの読み込みが完了した時(init)」に実行するように「add_action」に関数名を入れています。

function add_custom_post_car(){...}
まずは登録するための関数を書きます。関数名は任意ですが、最後の
add_action('init', 'add_custom_post_car')
の第二引数と同じである必要があります。
$car_labels = array(..);
ここは管理画面などで利用される、カスタム投稿タイプのラベル用の設定を配列に格納しています。「name」と「singular_name」の違いについては、単数か複数形かで表示が違う時のためのものです。日本語では同じでいいですが、英語の場合'name' => 'Cars', 'singular_name' => 'Car'となります。
$car_args = array(..);
ここでは登録するカスタム投稿タイプの設定を配列に格納しています。注意点は説明しますが、それぞれの詳しい説明は以下をみてください。
→ 関数リファレンス/register post type – WordPress Codex 日本語版
labels
ここはラベルの設定を配列で入れます。今回はラベル用の配列を代入している「$car_labels」を指定しています。
public
投稿を表示する時は「true」、投稿を公開しないときは「false」。これはカスタム投稿タイプをデータとして利用したいときなど、プラグインなどが「false」にして登録されていることがあります。公開ページがないので、編集画面にはパーマンリンクが表示されなかったりします。
description
投稿タイプを説明する文章になります。普通はサイト上にも管理画面でも表示されませんが、私の場合、カスタム投稿タイプのアーカイブページのdescriptionとして、この値を使っていたりします。
rewrite
「rewrite」は、パーマリンクの変更についてを指定します。デフォルトは「true」になっており、投稿タイプのスラッグが利用されます。その他、配列を指定して細かく設定することができます。
ここであえてデフォルトではなくarray( 'with_front' => false )を入れているのは、URLの設定を変更するためです。WordPressでは「投稿」のパーマリンク設定にて、「https://sampale.com/news/(タイトル)/」の「news」ように、URLの前に任意の文字を入れることができます。デフォルトのままだと、「https://sampale.com/news/car/xxxxx/」というパーマリンクになってしまうからです。もちろんそれでいいのなら設定をデフォルトから変える必要はありませんが、カスタム投稿タイプが投稿とは全く関係ない場合、「https://sampale.com/car/(タイトル)/」の方が自然だと思うので今回は「with_front」だけ変更しています。
supports
「supports」は、そのカスタム投稿タイプがサポートする入力欄になります。サムネイル画像を利用したい場合は「thumbnail」を配列に含める必要がありますが、テーマ自体が「add_theme_support()」でサムネイル画像の登録をサポートしている必要があります。カスタム投稿タイプに対してAdvanced Custom Fieldのようなカスタムフィールドを弄るプラグインを利用する場合があると思いますが、ACFはカスタムフィールドを利用しているので、「custom-fields」を配列に含める必要があります。
taxonomies
「taxonomies」は、登録するカスタム投稿タイプと結びつけるタクソノミーを配列で指定します。デフォルトにある「カテゴリー」を利用したいときは、「’category’」を含めます。今回は後述する「’color’」タクソノミーと「’brand’」タクソノミーを指定しています。
register_post_type('car', $car_args);
「register_post_type()」によってWordPressにカスタム投稿タイプを指定します。第一引数がカスタム投稿タイプのスラッグとなり、URLなどで利用されたりするので分かりやすい方がいいと思います。

カスタム投稿タイプの注意点

以上でカスタム投稿タイプの登録が完了です。カスタム投稿タイプの登録はパーマリンクや結びつきに関わる追加設定になるため注意して扱う必要があります。

  • 「taxonomy」でデフォルトにある「categoy」を指定した場合、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の説明

register_taxonomy()はカスタム投稿タイプより短いですね。詳しい説明は以下より確認できます。
→ target=”_blank”>関数リファレンス/register taxonomy – WordPress Codex 日本語版

function add_custom_type_color(){...}
こちらも登録するための関数を書きます。関数名は任意ですが、最後の
add_action('init', 'add_custom_type_color')
の第二引数と同じである必要があります。
hierarchical
カテゴリーのように、階層化するる場合は「true」、タグのように階層化しない場合は「false」を指定します。

カスタム投稿タイプの表示で読み込まれるテンプレート

カスタム投稿タイプの登録が終わると次は表示する流れになります。表示を投稿と切り分けたい場合、読み込まれるテンプレートを把握することは大事です。WordPressでは読み込むテンプレートを決定する時、探す順番にはルールがあります。

カスタム投稿タイプ一覧を表示する際に読み込まれるテーマ

基本的には投稿と同じようにarchiveから探していきますが、カスタム投稿タイプのスラッグを用いたテンプレートを先に探します。
ここではスラッグ名を「car」とした場合になります。

  1. 1) archive-car.php
  2. 2) archive.php
  3. 3) paged.php(2ページ名以降の場合のみ)
  4. 4) index.php

カスタム投稿タイプのシングルを表示する際に読み込まれるテーマ

シングルページの場合も、アーカイブページと同じようにカスタム投稿タイプのスラッグが入ります。

  1. 1) single-car.php
  2. 2) single.php
  3. 3) singular.php
  4. 4) index.php

カスタムタクソノミーの表示で読み込まれるテンプレート

カスタムタクソノミーの表示の際に読み込まれるテンプレートは基本的に一覧ページとなるわけですが、タームのスラッグも指定できるため、タームを登録する時は半角英字で登録し、ハイフンなどは使わないようにします。
ここでは「color」というカスタムタクソノミーに「red」というタームが登録されているとします。

  1. 1) taxonomy-color-red.php
  2. 2) taxonomy-color.php
  3. 2) taxonomy.php
  4. 2) archive.php
  5. 3) paged.php(2ページ名以降の場合のみ)
  6. 4) index.php

カスタム投稿タイプの取得する関数

カスタム投稿タイプの情報や、現在の投稿はどの投稿タイプかなど、色々と関数を知っておくとテーマ作成の時に便利です。

登録されている投稿タイプを取得する
$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');
タームIDとタクソノミーを指定してタームの情報を取得する
$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')){ ... }
]]>
https://tetch1987.com/shittakabull/web/wordpress-custom-postype-and-taxonomy/feed/ 0
WordPressテーマ作成に役立つコード集まとめ https://tetch1987.com/shittakabull/web/wordpress-useful-code-of-create-theme/ https://tetch1987.com/shittakabull/web/wordpress-useful-code-of-create-theme/#respond Wed, 28 Feb 2018 09:16:17 +0000 https://tetch1987.com/shittakabull/?p=762 WordPressでオリジナルテーマを作成する際、何度も何度も使うコードや記述があります。知ってはいるけどコードや記述を直接書くよりコピーペーストした方が早いってことは多いのではないでしょうか。テンプレート用にファイルを保存しておくと便利なんですがファイルを開くのが面倒なこともあり、Googleで検索した方が早いなんて場合も。そんなめんどくさがりな私(のような人)のために、1ページにまとめた記事があればいいかと思いこの記事を作成しました。WordPressのテーマ作成のお供になれば幸いです。

目次

1) テーマの新規作成時に役立つコードや記述

オリジナルテーマを作るときはいつも新規作成しています。HTMLからWordPressにテーマ化する際に便利なコード集です。

style.cssのテーマ情報

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'); ?>/

header.phpとfooter.phpに記述するコード

この辺りを忘れるとプラグインで用意しているjavascriptが読み込まれなかったりします。

<?php wp_head(); ?>
<?php wp_footer(); ?>

各テンプレートファイルの読み込み

こちらも直接書いた方が早いかもですが、「get_template_part」とかはアンダースコアの位置ってこれでよかったっけ?って思ってしまいます。

<?php get_header(); ?>
<?php get_sidebar(); ?>
<?php get_template_part('xxxxx'); ?>
<?php get_footer(); ?>

2) ループに役立つコードや記述

サムネイルやカテゴリを含めると以外に面倒なのがループ。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(']]>', ']]&gt;', $post_cnt);
		$post_cnt = str_replace(array(' ', ' ', '&nbsp;'), '', 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のループ

よく使う設定を入れ込んだ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(); ?>

3) ページテンプレート作成に役立つコードや記述

コーポレートサイトをWordPressで構築する場合、ちょっとしたプログラムを組んで利用するページが必要なことが多々あります。そんなときに役立つページテンプレートの作成時に役立つ記述です。

ページテンプレートの情報

スペースだとかスペルミスを防ぐためにもコピペが一番ですね。

<?php
/*
Template Name: xxxxxxxxxxxxxxx
*/

4) カスタム投稿、カスタム分類の登録に役立つコードや記述

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');

]]>
https://tetch1987.com/shittakabull/web/wordpress-useful-code-of-create-theme/feed/ 0
WordPressのテーマ作成で利用する条件分岐まとめ https://tetch1987.com/shittakabull/web/wordpress-if/ https://tetch1987.com/shittakabull/web/wordpress-if/#respond Wed, 05 Apr 2017 10:54:22 +0000 https://tetch1987.com/shittakabull/?p=653 WordPressの条件分岐は、テーマ作成をする際にちょっとしたプログラムを作成する場合でも利用します。非常に細かく判別できるようWP関数が数多く用意されているため、覚えておくと便利かと思います。また条件分岐の関数があると知っているだけで手間を省くことにもつながります(この記事を書くきっかけとなった「taxonomy_exists()」を知らなかった私は該当タクソノミーから全てのタームを取得してin_array()で判別していました…)。現在表示しているのが投稿ページなのか固定ページなのかなどの表示に関する条件分岐からユーザーがログインしているか、指定するタームは存在するのかなどの条件分岐まで、WordPressにおけるよく利用しそうな条件分岐をまとめました。

目次

トップページの表示に関する条件分岐

トップページかどうかを表示する関数は「is_front_page()」と「is_home()」の2つあります。どちらで判別するかは管理画面の「設定」>「表示設定」>「フロントページの表示」の設定に関係があります。この設定が「最新の投稿」(デフォルト)に設定されている場合はどちらも利用できますが、「固定ページ」に設定されている場合は、どのような表示の場合に「true」を返すのかが変わってきます。基本的にサイトアドレスを表示している場合を判別したい場合には「is_front_page()」を使うとよさそうです。「is_home()」は「固定ページでフロントページ」が設定されている場合、サイトアドレスにおいては「false」になってしまいます。
ここからは蛇足ですが、WordPressはもともとブログとして開発されたため、通常はサイトのフロントページ(トップページ)は最新の投稿一覧となります。しかしコーポレートサイトでの利用などを考えると、固定ページをサイトのフロントページとして表示させたい場合もあると思います。WordPressではそういったケースにも考慮されており、フロントページを固定ページとして、投稿一覧ページは別の固定ページとして設定できるようになっています。この設定の場合のために「is_home()」が存在します。

is_front_page(), 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() : 個別ページが表示されているかどうか

投稿、カスタム投稿タイプ、固定ページの詳細ページかどうかを判別します。
また、引数を入れることで投稿タイプを指定することができます。投稿の詳細ページが表示されているかどうかを調べたいならば「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(カスタム投稿タイプ例)」の個別ページが表示されている場合
}

is_single() : 投稿(カスタム投稿タイプ)の個別ページが表示されているかどうか

投稿、またはカスタム投稿タイプの個別ページが表示されているかどうかを判別します。
引数に「投稿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」の投稿ページが表示されている場合
}

is_page() : 固定ページが表示されているかどうか

固定ページが表示されているか判別します。
投稿と同じように引数に「投稿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_archive()」は一覧ページ判別の中でも一番大きな分類です。「is_singular()」が個別ページ全てを通すのに対し、「is_archive()」は日付アーカイブだろうがカテゴリーアーカイブだろうがカスタム投稿タイプアーカイブだろうが一覧ページであれば全てをtrueを返します。もしカテゴリーの場合とカスタム投稿タイプアーカイブの場合とで分けたい場合は順番に注意が必要です。

if(is_archive()){
	//アーカイブページが表示されている場合
}

is_post_type_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()、is_year()、is_month()、is_day() : 日付のアーカイブページが表示されているかどうか

日付関連のアーカイブページを判別します。「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() : カスタムタクソノミーのアーカイブページが表示されているかどうか

カスタムタクソノミーアーカイブを判別する時は「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() : カテゴリーのアーカイブページが表示されているかどうか

カテゴリー一覧ページかどうかを判別するには「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() : タグのアーカイブページが表示されているかどうか

タグのアーカイブページ一覧を条件分岐で判別する場合には「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() : 管理画面が表示されているかどうか

テーマの作成というよりプラグインの方に近いかもしれませんが、「is_admin()」は管理画面が表示されている場合を条件分岐として判別してくれます。
Codexにも書いてありましたが、ログインの有無や権限などのチェックは行っていないそうなので、その辺の判別もしたい場合は別のWP関数と併用する流れになるでしょうか。

if(is_admin()){
	//管理画面が表示されている場合
}

is_author() : 著者ページが表示されているかどうか

著者ページが表示されているかを条件分岐として判別するには「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」の著者ページが表示されている場合
}

is_search() : 検索結果ページが表示されているかどうか

検索ページの判断になります。検索ワードなどをタイトル入れたいなどの場合に利用できそうですね。

if(is_search()){
	//検索結果ページ表示されている場合
}

is_404() : 404ページが表示されているかどうか

404エラーのページが表示されている場合、「is_404()」はtrueを返します。

if(is_404()){
	//404ページ表示されている場合
}

ユーザーに関する条件分岐

ユーザーに関する条件分岐をまとめてみました。エンドユーザーが何かしらユーザー登録できるシステムや、会員制サイトの際など、様々なケースで必要になってくると思います。

is_user_logged_in() : ユーザーがログインしているか(ログインの判別)

ユーザーがログインしているかどうかの判別です。ログインユーザーのみに表示をさせたい項目がある場合などに利用できます。
ログイン情報を元に表示させたい場合にも、先に「is_user_logged_in()」の条件分岐を挟んだ方がベターだと思います。

if(is_user_logged_in()){
	//ユーザーがログインしている場合
}

user_can() : 指定したユーザーは指定した権限グループか、または権限を持っているか

ユーザーIDを指定し、そのユーザーが権限を持っているかを判別することができます。
ユーザーIDの取得は別のWP関数などで行う必要があります。

if(user_can(8, 'administrator')){
	//ユーザーID「8」のユーザーが、権限グループ「administrator(管理者)」の場合
}

current_user_can() : ログインしているユーザーは指定した権限グループか、または権限を持っているか

現在ログインしているユーザーが権限を持っているかを判別します。上記の「is_user_logged_in()」と「user_can()」を合わせた感じでしょうか。

if(current_user_can('administrator')){
	//ログインユーザーが、権限グループ「administrator(管理者)」の場合
}

email_exists() : 指定したメールアドレスが登録されているか(ユーザーIDを返す)

メールが登録されているかを判別し、存在すればユーザーIDを返します。会員制やユーザーの機能を利用したシステムで色々使えそうですね。
新規ユーザー登録あたりはコアなシステムやプラグインに任せるとしても、返り値を利用してメールアドレスからユーザー情報を引っ張る、ログインしているユーザーIDと同じメールアドレスを入力しているかどうかの判別など、便利そうです。
例えばユーザー同士の交流ができる掲示板サイトをWordPressで構築したとします。ユーザーが作成した掲示板に誰かのメールアドレスから招待したい場合、この条件分岐を行えば、「既に登録済み」>「招待が来た旨のメッセージ」、「未登録」>「ユーザー登録のメール」というシステムの流れをくむことができます。

if(email_exists('xxx@sample.com')){
	//メールを「xxx@sample.com」として登録しているユーザーが存在する場合
}

投稿タイプに関する条件分岐

投稿タイプに関する条件分岐では、投稿タイプが存在するかや、現在の投稿の投稿タイプで条件分岐を行いたい場合などを記述します。

post_type_exists() : 投稿タイプが存在するか

投稿タイプが存在するかをチェックする関数です。
恐らくリクエストからの判断に利用されているものだと思いますが、例えばオリジナルの検索機能を付けて、投稿タイプの絞り込みフォームを作成した際などに、検索者が投稿タイプとしての正しい値を入れているか判断するのに利用できそうです。あとは自動で投稿タイプを作るシステムを組み込んでいるときでしょうか?プラグインの有効化の際に判断するのはありそうですが。

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() : 投稿が指定したカテゴリーに属するか

「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」のカテゴリーに属するか
}

文字列に対する条件分岐

is_email() : 指定した文字列がメール形式かどうか

if(is_email($my_mail)){
//変数「$my_mail」が、メールアドレス式の文字列の場合
}

is_serialized() : 指定した文字列がリアライズされているかどうか

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」の場合
}

]]>
https://tetch1987.com/shittakabull/web/wordpress-if/feed/ 0
WordPress:パスワード保護した投稿で任意のコンテンツを非表示にする https://tetch1987.com/shittakabull/web/wordpress-postpass/ https://tetch1987.com/shittakabull/web/wordpress-postpass/#respond Thu, 08 Dec 2016 12:14:18 +0000 http://tetch1987.com/shittakabull/?p=636 WordPressの投稿時、パスワード保護を設定するとコンテンツは非表示になり、代わりにパスワード入力フォームが表示されるようになります。コンテンツを隠したい場合に便利ですが、パスワード保護を前提とした場合、コンテンツ以外にも隠したい要素が出てくることがあります。例えばカスタムフィールドの表示やお問い合わせフォームを「テーマ側」で出力しているとき、ついでに隠してくれよって思ってしまいます。パスワード保護した投稿で任意のコンテンツを非表示にする方法になります。

パスワード保護されているかを判定する関数

これがあれば一発と思い検索しても出なかったため中身をたどってみると、パスワード保護されているかを判定する関数は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()」などは隠したい情報の方に入れるよう設定した方がいいかもしれません。
これでカスタムフィールドを表示する場合や日付やカテゴリーも隠したいなんていった場合に、任意のコンテンツを非表示にすることができます。

]]>
https://tetch1987.com/shittakabull/web/wordpress-postpass/feed/ 0
WordPressでユーザー登録(追加)時に紐づいたページを作成 https://tetch1987.com/shittakabull/web/create-user-and-page/ https://tetch1987.com/shittakabull/web/create-user-and-page/#respond Fri, 27 May 2016 06:55:39 +0000 http://tetch1987.com/shittakabull/?p=598 WordPressで構築した会員サイトでユーザー作成時にプロフィールページを作りたい場合や、店舗情報などユーザーを振り分けるなどといった場合、ユーザーの追加時に自動で固定ページ(または投稿、カスタム投稿タイプ)を作成したいことがあるかと思います。また、作成したページとユーザーと紐づける方法も記述します。

ユーザー追加時にページを作成

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を返しますので、続けて処理が可能です。

関数リファレンス/wp insert post

/*設定
====================================================*/
$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から関連付けられたページIDを取得する

ここまでで既に新規ユーザーが追加されたときに固定ページが作成されます。実際に利用するには、「ユーザー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を取得
}

]]>
https://tetch1987.com/shittakabull/web/create-user-and-page/feed/ 0
WordPressプラグイン : Any Mobile Theme Switcherでスマホ対応 https://tetch1987.com/shittakabull/web/wordpress-any-mobile-theme-switcher/ https://tetch1987.com/shittakabull/web/wordpress-any-mobile-theme-switcher/#respond Fri, 13 Feb 2015 07:08:25 +0000 http://tetch1987.com/shittakabull/?p=522 先日、スマートフォン対応の記事を書きましたが、それに関連して今日はAny Mobile Theme SwitcherというWordPressのプラグインの紹介です。
WordPressでは様々な方法でスマートフォン対応をすることができます。レスポンシブデザインのテーマを選択・作成したり、自動でスマホ用テーマにコンテンツを適用させたりと、今後もアプローチがどんどん増えていけばいいなと思っています。
今回のプラグイン「Any Mobile Theme Switcher」は、スマホの場合に別のテーマを適用させることができるプラグインです。つまりスマホ用のテーマとPC用のテーマを作成し、スマホの場合はスマホ用テーマ、PCの場合はPC用テーマに割り振れるのです。どの機種をどうするかも設定画面で選べますが、私はタブレットくらいしか悩まず、すべてスマホ用テーマにしておきました。
この記事ではインストール方法や設定方法はとても簡単に、スマホ対応として可能なことを書きます。
プラグインの詳細:Any Mobile Theme Switcher

インストールと設定

ここでは「Any Mobile Theme Switcher」のインストール方法と、設定方法を説明しますが、とても簡単なので、簡単に説明します。
前提としては既にスマホ用テーマが作成してある段階です。

インストール

  1. 「管理画面」>「プラグイン」>「新規追加」
  2. 「Any Mobile Theme Switcher」で検索
  3. 「インストール」、「有効化」

設定

  1. 「管理画面」>「設定」>「Any Mobile Theme」
  2. 各デバイスに対してテーマを選択させます
  3. オプションを設定し、更新

オプション設定はこのようになっています。

Remember forced layout till
ユーザーがPC版を見るボタンをしたときなど、設定を保存しておく期間です。
Switch Mobile Theme Link Text
「スマホ版を見る」リンクの文章
Switch Desktop Theme Link Text
「PC版を見る」リンクの文章
Do you want to show Switch Mobile Theme link even the vistor is viewing from desktop ?
PC(ディスクトップ)で見ている人にスマホ版へのリンクを見せますか?

テーマの作成について

ここではテーマの作成についてになります。PC版、スマホ版のテーマをそれぞれ作成しても、データベースが1つなのは忘れてはいけません。できれば画像も最適化したいところです。

切り替えボタンを付ける

以下のコードをテーマ内に記述すると、PC版ならスマホ版へのリンク、スマホ版ならPC版へのリンクが挿入されます。

<?php echo do_shortcode('[show_theme_switch_link]'); ?>

スマホ版ならURLに「?am_force_theme_layout=desktop」が追加されてPC版へのリンクが挿入されます。タグで囲ったり、挿入されるアンカータグのクラス「am-switch-btn gomobile」に対してCSSでスタイリングを行うことができます。

画像用のショートコードを作る:パスをそれぞれに設定する

入力されたコンテンツは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’)」を利用しています。
このコードを利用して参照する場合は両方のパスに画像が存在する必要があるため、クライアント側にとっては面倒な作業になるかもしれません。
また、投稿画面から入力した画像を表示するには、また別の操作が必要です。
使い方は、画像につける名前を挿入します。

]]>
https://tetch1987.com/shittakabull/web/wordpress-any-mobile-theme-switcher/feed/ 0
WordPress:Ajaxでランダムの記事を取得し、切り替えさせる https://tetch1987.com/shittakabull/web/wordpres-ajax-random-post/ https://tetch1987.com/shittakabull/web/wordpres-ajax-random-post/#respond Tue, 03 Feb 2015 04:06:38 +0000 http://tetch1987.com/shittakabull/?p=510 WordPressにて、ランダムの記事をAjaxを用いて表示する方法をご紹介します。サイドバーに常に入れ替わるランダム記事を挿入することができますし、これを応用すれば、スライドショー用のカスタム投稿タイプを作成した後、ランダムに1件ずつ表示することでデータベースと連動したスライドショーを作成することもできるかと思います。

WordPressのAjaxを利用する

Ajaxで読み込むPHPプログラムをWordPress連携させるにはどうしたらいいのか悩んでいたのですが、少し調べると用意されているようで感心しました。
以下の方法で、まずはAjaxを利用する下準備をします。
参考URL:http://hijiriworld.com/web/wordpress-ajax/

読み込むパスを宣言

WordPressでAjaxを利用する場合は、「/wp-admin/admin-ajax.php」にリクエストを送るようにするとのことです。参考URLのようにwp_headやwp_footerにフックしてもいいでしょうし、テンプレートファイルに直接書いてもいいと思います。
ついでに、ajaxを記述する用のjsファイルも読み込んでしまいます。

echo '<script>'."n";
echo "t".'var ajaxurl = "'.admin_url('admin-ajax.php').'";'."n"; //ajaxリクエスト用のパスを宣言
echo '</script>'."n";
echo '<script type="text/javascript" src="'.get_option('home').'/js/random.js"></script>'; //ajaxを記述するjsファイルを読み込み

以下は、functionwp_headやwp_footerにフックする場合です。

function add_my_ajaxurl() {
	echo '<script>'."n";
	echo "t".'var ajaxurl = "'.admin_url('admin-ajax.php').'";'."n"; //ajaxリクエスト用のパスを宣言
	echo '</script>'."n";
	echo '<script type="text/javascript" src="'.get_option('home').'/js/random.js"></script>'; //ajaxを記述するjsファイルを読み込み
}
add_action( 'wp_footer', 'add_my_ajaxurl', 1 );

ランダム記事を出力する関数を作成

次に、「wp_ajax_(action)」と「wp_ajax_nopriv_(action)」を用いて出力する関数を登録します。wp_ajax_(action)はログインユーザー用、wp_ajax_nopriv_(action)は非ログインユーザー用とのことです。
これをajaxに組み込み、出力させる流れです。functions.phpに記述します。

function my_random_post(){
	//処理
    die();
}
add_action( 'wp_ajax_my_random_post', 'my_random_post' );
add_action( 'wp_ajax_nopriv_my_random_post', 'my_random_post' );

処理のところにランダムで取得した記事を出力する処理を記述するわけですが、ランダム記事の取得方法は、get_postsやWP_Query、$wpdbなどたくさんあると思うのでお任せします。
ここではget_post()を利用した場合の記述になります。

function my_random_post(){
    global $post;
    $rand_posts = get_posts('posts_per_page=5&orderby=rand');
    echo '<ul>'."n";
    foreach($rand_posts as $rand_post):
        $rand_id = $rand_post->ID;
        echo '<li><a href="'.get_the_permalink($rand_id).'">'.get_the_title($rand_id).'</a>'."n";
    endforeach;
    echo '</ul>'."n";
    wp_reset_postdata();
    die();
}
add_action( 'wp_ajax_my_random_post', 'my_random_post' );
add_action( 'wp_ajax_nopriv_my_random_post', 'my_random_post' );

ここの処理を色々と変更すれば、冒頭で述べたカスタム投稿タイプを利用したスライドショーなどを作成できます。

jQueryとajaxの記述

上記の「/wp-admin/admin-ajax.php」を読み込むパスを宣言した際についでに読み込んだjsファイルに以下を書き込みます。
ajaxを発動させるタイミングや、リクエストから受け取った情報の処理を設定します。
以下ではsetTimeout()を利用して、「#randamBox」に対し一定時間でランダム記事を表示し続けます。

$(function(){
WaiteTime = 5000; //切り替わる時間
RandTarget = $('#randamBox');//ランダム記事を挿入する包容タグ
$.fn.DoRandomPost = function(config){
    return this.each(function(i, elem) {
		$.ajax({
			type: 'POST',
			url: ajaxurl,
			data: {
				'action' : 'my_random_post',//登録したアクションフック
			},
			success: function( response ){
				RandTarget.fadeOut(function(){
					RandTarget.empty().append(response).fadeIn();
					timerID = setTimeout(function(){RandTarget.DoRandomPost();},WaiteTime);
				});
			}
		});
		return false;
	});
}
$(window).load(function() {
	RandTarget.delay(WaiteTime).queue(function(next) {
		$(this).DoRandomPost().dequeue();
	});
});

});

HTMLの記述

ここにjsファイルで指定した、ランダム記事を挿入するHTMLを記述しますが、javascriptを利用していない人やSEOなども考えて、最初から表示してあるランダム記事を出力しておいた方がいいかもしれません。

<div id="randamBox">
<!--ここにajaxで取得したランダム記事が出力される-->
</div>

まとめ

以上になります。PHPやjavascriptの処理を変えたりと応用すれば色々とできると思うので、実際に作成したものをテンプレートとしてとっておいたら便利かもしれません。

]]>
https://tetch1987.com/shittakabull/web/wordpres-ajax-random-post/feed/ 0
スマートフォン対応について https://tetch1987.com/shittakabull/web/about-mobile-firendly/ https://tetch1987.com/shittakabull/web/about-mobile-firendly/#respond Tue, 27 Jan 2015 01:06:06 +0000 http://tetch1987.com/shittakabull/?p=504 iPhoneやアンドロイドなどのスマートフォンが流行り始めてから数年もしない内に、すぐにweb制作においてスマートフォン対応が注目されてきました。ここでいうスマートフォン、いわゆるスマホはiPhoneやアンドロイドなどここ数年で出てきた携帯電話としておきます。フィーチャーフォンと呼ばれるガラケーの対応でも、ウェブ制作者の方々は時と場合によって表示の切り替え方を変えてきたと思います。.htaccessを変更してディレクトリで振り分けるのか、サブドメインなどを取得して個別のサイトを構築するのか。個人的には制作費が許される限り1つのデータベースでそれぞれのサイトを構築し、デバイスによって切り替えるのが理想的だと考えています。しかし、最近のGoogleではどうも1つのHTMLにCSSでの対応させる方法を勧めているようです。そのことをGoogleは色々と理由は述べていますが、私はGoogleが絶対正しいかというとそうではなく、あくまでGoogle検索にとっては都合がいい程度に考えています。はっきり言って日々変わっているGoogleが今後より高性能のアルゴリズムを作ってしまえばそれで終わりだと思うからです。
スマホ対応もフィーチャーフォン対応と同じように、色々な対応の仕方があります。製作費や時間、サーバ環境などはあると思いますが、維持管理や今後のウェブ展開も考え、正統な対応をしていればしばらくは衰えないと思います。
このようなスマホ対応についてのページは沢山あるため、このページでは個人的に思うことを多く書いていこうと思います。主流に乗っかるのではなく新しいデザインや方法を見つけるヒントになれば一番嬉しいですが、どちらかというと意見が欲しかったりします。そのためこうすればいいという記事というより、こう考えているんだけど、程度に見てください。

各デバイスの特徴から対応を考える

まずなぜスマホ対応が必要なのかを考えるところから始めた方がいいかもしれません。この項目はネットの情報に感化された個人的なところもありますが、それぞれのデバイスの特徴から何が親切で使いやすいかというのを考えてみました。

PCの場合

  • HTML/CSS:ブラウザのバージョンや種類も多様なため、古いバージョンにも配慮したコーディングが必要。
  • 表示サイズ:ウィンドウサイズは人によって異なるため、固定にしてしまうか変動させることでレイアウトを崩れないよう構築する。
  • 画像:ネットの高速化により大きめの画像でダイナミックに見せることができる。
  • リンク:マウスを利用していると考えると、カーソルの乗せた時にリンクだと分かるように変化させると親切。
  • レイアウト:表示サイズに合わせた構築は親切だが、横幅が広いデザインが多くなってきている。
  • 文字サイズ:文字サイズの変更をブラウザで行う人がいるか分からないので変更ボタンを付けてあげると親切。
  • Flash:使える場合が多い。
  • 場所:屋内で座ってみてる場合が多い。

スマホの場合

  • HTML/CSS:スマホ自体が新しいのでCSS3やHTML5に対応しているため、便利な機能も使える。
  • 表示サイズ:画面サイズは機種によって違い、今後も新しいサイズが出てくるため、サイズ変化に対応した構築が親切。
  • 画像:ネット環境はPCよりも遅く個々の差も大きいため、コンテンツ内容によっては出来るだけ軽くした方が親切。
  • リンク:指でタップするため、リンクが大きいと親切。
  • レイアウト:上下左右のスクロールは見づらい。スクロールせずに見れる範囲が小さいため、メニューなどはまとめるのが主流になってきている。
  • 文字サイズ:980pxの構築では、16px以上はないと見づらい。見る人の拡大率によって異なるため、固定した状態で見やすい文字サイズにする。
  • Flash:デフォルトでは使えない場合が多い。
  • 場所:外出中、自宅で寝っ転がりながら、何かの合間に、など様々。

どこまで対応させるか

このように見る人がPCなのかスマホなのかで、内部的なところからどんな表示が使いやすいかまで異なります。PCならPCに親切な構築、スマホならスマホに親切な構築をするということですが、気を付けていきたいのはただボタンを大きくするだけではなく、何を求めてページにたどり着いたのかや、そのページで何をさせたいかなど、ユーザーとwebページ、そして運営者のシチュエーションを想像することが大事だと思います。店舗サイトを例にすると、スマホなら電話をかけれるリンクや地図アプリに飛ぶリンクが目立つところに合った方がいいかもしれませんし、PCなら足を運んでもらえるように雰囲気を押し出しブランド構築を優先させてもいいかもしれません。
もちろん理想は全ての人に使いやすく魅力的なデザインですが、実際のところ、最近ではスマホしか持っていない人や未だにケータイを持っていない人もいるなど、時代と共に情報格差は広がっていくと考えています。進歩と共に機能も増え、それに対応させる要素がどんどん増えていきます。そうなってくると、変動や切り替えを行わずして全てに対応した表示と言うのは難しいでしょう。
ではその中でどこまで対応するのか、そして何のために対応するのか。今のサイトではスマホで見ると使いづらいからなのか、スマホの人にはPCと違う情報を載せたいからなのか、PC版のままだと表示が遅いからなのか。そこを明確にしてからスマホ対応をした方が、切り替えの方法、コンテンツ、デザインなどが洗練されていくと思います。

何かを優先させて切り捨てる選択肢だってあります。今までを例にとっても、例えば現在まだ横幅を980pxや960pxで固定しているサイトが多いですが、それはスマホのみならずPCのウィンドウサイズを960px以下にしていた人たちの手間を切り捨てていると言い換えることもできます、極論ですが。しかしそれらは恐らく、ウィンドウサイズの平均や、ディスプレイ解像度、レイアウトのしやすさなど、色んなところから主流となったのでしょう。実際レイアウトを組む時に分割しやすいですし、4:3の比率で横960pxにすると縦720pxになるし16:9の比率では縦が540pxとなって切りが良く、レイアウトのしやすさを感じました(以前は640pxが主流だったのも同じ理由かもしれません)。
スマホ対応が主流だからという理由だけで話を進めると、スマホ対応が意味を持たなくなる可能性があると私は思います。

スマホとPCでの切り替え方

既存のウェブサイトをスマホ対応させる人もいるとは思いますが、新規にスマホ対応するウェブサイトを立ち上げる人はPC版を構築する前に切り替え方を考慮しないと二度手間になる可能性があります。既にウェブサイトを持っている場合はPC版の作り直しなどを含めた、作業費との兼ね合いも関係してくるでしょう。
大きく分けると、PC版とは全く別にスマホ版を構築して切り替える方法と、コンテンツをPCとスマホでレイアウトを変えて表示する方法、データベースなどを利用しシステムで切り分ける方法があります。

1)スマホ版を独立して構築する

PC版はPCサイトを作り、スマホ版は別にスマホサイトを作る方法です。
既存のサイトをスマホに対応するのが難しい場合や、スマホ版はスマホに特化したウェブサイトを作りたい場合にいいかもしれません。メリットとしては、それぞれに合ったコンテンツを提供でき、画像なども最適化することができます。デメリットとしては、2つのサイトを作ることになるので、制作時に時間がかかる点や、修正があった場合に作業が2倍になることです。
運営方法は何種類か考えられます。

1-1)ディレクトリで分ける
スマホ版を「sm」などのディレクトリ内に構築しおき、.htaccessによってURLを叩いた人のデバイスを認識させ、スマホなら「http://domain.com/sm/」へ転送、PCが「sm」にアクセスしたら通常の「htttp://domain.com」へ転送する方法になります。.htaccessが使えるサーバ環境なら、サイトをHTMLのみで構築している場合に便利かもしれません。また、既存のウェブサイトに影響を与えずに独立したスマホサイトを構築することができるので、PC版に特化し過ぎたサイトや変更を加えたくないときに便利だと思います。
1-2)サブドメインで分ける
スマホ版を「mobile.domain.com」のサブドメインに構築し、.htaccessによって切り替えます。この場合はサーバも別に構築することができるため、ディレクトリで分けるより、サーバの負担を分担できるのではないかと思います。しかし、ドメイン管理会社やサーバ会社によっては利用できない可能性もあるかもしれません。

2)1つのコンテンツをスマホとPCで表示を変える

1つのコンテンツを見る人によって表示が異なるようにする方法です。最大のメリットは、修正が楽な点だと思います。デメリットは、方法によってはランニングコストがかかったり、デザイン段階にPCとスマホの両方を考慮しなくてはならない点が挙げられます。

2-1)レスポンシブウェブデザインで構築する
viewportの指定やcssの「media screen」によって、ウィンドウサイズによってレイアウトなどを変動させる方法です。この対応はPCでもウィンドウサイズを変更することで確認することができます。メリットとしては独立した場合に比べ簡単な修正が楽な点があげられ、Googleの勧める1つのHTMLで見る人に分けるといった方法になります。また、HTMLとCSSだけの構築なのでサーバ環境はあまり関係なさそうです。ただ、デザインの段階からスマホを考慮しなければならなく、構造が難しくなっている場合が多いため構築の際にちゃんと更新の場合を考えておかないと1手間も2手間もかかってしまう可能性があります。PC版サイズの画像をスマホでも読み込まなくてはいけない点もデメリットと言えるでしょう。そのため、シンプルなデザインやCSS3を使ったデザインに多い気がします。
2-2)ASPを利用する
自動でスマホ対応させるASPを利用する方法です。現在、「スマホ対応 ASP」で検索したら数多くのサービスを見ることができます。HTMLを変換してくれる仕組みであれば、既存のウェブサイトにシステムを組んでいたとしても、影響はないと思われます。また今まで通り更新していくだけでいいのであれば、スマホ対応の作業だけをみるなら一番楽なのかもしれません。デメリットとしてはランニングコストでしょう。

3)システムを利用する(WordPress)

既に利用しているシステムにスマホ対応を付け加える、または、対応しているCMSに組み込む方法です。独自システムの場合は開発費が必要になりそうですが、WordPressなどのオープンソースのCMSでは、プラグインでスマホ対応することもできそうです。ここでは、一番利用されているCMS、WordPressの場合について考えたいと思います。

3-1)テーマを切り替えるプラグインを利用する
スマホを判別し、機種によってテーマを切り替える方法です。「Any Mobile Theme Switcher」がその中の一つです。事前にスマホ用のテーマを作成しておく必要があります。データベースに挿入されたコンテンツは同じHTMLとなるため、崩れない程度の修正でスマホ対応として良しとするか、スマホも意識してコンテンツを作成するか、これらを考えると完ぺきとは言えないかもしれませんが、個人的には理想に近い形でスマホ対応できると思います。また、データベースの部分は1回の修正で大丈夫ですが、テーマが絡むと2度修正しなくてはなりません。特にfunctions.phpは重要なのですが、私は忘れがちです。
3-2)自動で切り替えるプラグインを利用する
設定をすれば自動でスマホ対応させるものです。有名なプラグインではスマホ用テーマも豊富にありそうです。

まとめ

システムを利用すれば他にももっと切り替え方はあると思いますが、切り替え方から考えると初期作業も大事ですが、後々のことも考えたいところです。更新が大変だったら維持管理費がかかります。
すでにデフォルトでスマホ対応の機能がついているCMSもありますが、コンテンツの入力画面にももっと目を向けて欲しいと思います。ホームページを持つのが当たり前となり、HTMLからCMSになり、今度はCMSが当たり前になってきたので、デバイスによる切り替えに特化したCMSの開発もぐーんと進んでいくと思います。

]]>
https://tetch1987.com/shittakabull/web/about-mobile-firendly/feed/ 0
WordPress 固定ページの最上親ページを取得する https://tetch1987.com/shittakabull/web/wordpress-page-most-parent/ https://tetch1987.com/shittakabull/web/wordpress-page-most-parent/#comments Sat, 27 Dec 2014 03:29:33 +0000 http://tetch1987.com/shittakabull/?p=496 WordPressで固定ページの一番上の親を取得したいときがあるかと思います。get_postなどで得られる固定ページの情報には親のIDしかなく、さらにさかのぼった情報はありません。そのため、孫まで行ってしまったときに祖父を言い当てるのには少々工夫が必要です。

functions.phpに関数を作る

先祖をさかのぼり、最も上の親ページを取得する関数を作成し、functions.phpに記載することでテーマ内で利用できます。
以下をテーマの中のfunctions.phpに記載します。

function get_most_parent_pageID($current_id = ''){
	global $post;
	if($current_id == '') $current_id ==$post->ID;  
	$par_id = get_post($current_id)->post_parent;
	$most_par_id = $current_id;
	while($par_id!= 0) :
		$par_post = get_post($par_id);
		$most_par_id = $par_post->ID;
		$par_id = $par_post->post_parent;
	endwhile;
	return $most_par_id;
}

使い方

初期設定は現在の投稿の最上の親、引数にIDを渡せばその投稿の最上の親のIDを取得できます。
現在の固定ページの最上親のIDを取得できます。

$most_post_id = get_most_parent_pageID(); //最上親のIDを取得する
$most_post = get_post($most_post_id); //投稿を取得

投稿オブジェクトで取得する場合

上記の使い方ではIDを返してそのIDから投稿オブジェクトを取得していますが、それをまとめた関数です。

function get_most_parent_page($current_id = ''){
	global $post;
	if($current_id == '') $current_id ==$post->ID; 
	$current_post = get_post($current_id);
	$par_id = $current_post->post_parent;
	while($par_id!= 0) :
		$par_post = get_post($par_id);
		$current_post = $par_post;
		$par_id = $par_post->post_parent;
	endwhile;
	return $current_post;
}

使用例:固定ページ毎に最上の親のスラッグのクラスを入れる

例えばpage.php内でスラッグのクラスを入れてCSSで背景画像などを変化させたい時、子ページの場合は親ページの、孫ページの場合は祖父ページのスラッグを入れたいときがあるかと思います。

<?php 
//関数によりスラッグを取得
$most_par_post = get_most_parent_page();
$most_par_slug = $most_par_post->post_name; ?>
<div id="page" class="<?php echo $most_par_slug; ?>">
<!--ここに内容を記述-->
</div>

]]>
https://tetch1987.com/shittakabull/web/wordpress-page-most-parent/feed/ 3