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
Wordpress – 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プラグイン「Bogo」:翻訳ページが表示されないときの対処 https://tetch1987.com/shittakabull/web/wordpress-bogo-redirect-problem/ https://tetch1987.com/shittakabull/web/wordpress-bogo-redirect-problem/#comments Mon, 26 Mar 2018 06:08:51 +0000 https://tetch1987.com/shittakabull/?p=759 WordPressでの多言語化サイト作成に便利なプラグイン「Bogo」にて、英語などに翻訳したページを確認しようと開いてもデフォルトの日本語ページにリダイレクトされてしまう場合があります。困ったことに毎回リダイレクトされるわけでもなかったり、いつの間にか直っていたりと、原因も解決方法も見当もつかないってことはありませんか。
避けるための注意点と、これを試してみると直るかも、という記事になります。Bogoの設定方法や便利な関数などについてはこちらの記事に書いています。

1 : 該当URLの確認

基本的なことですが…。ページのURLがリダイレクトされてデフォルトのページが表示されてしまうのか、そもそもリンクのURLがデフォルトのURLを指定しているのかを確認します。Google ChromeやFireFoxなどのモダンブラウザでは、リンクをマウスおーばすると左下にURLが表示されると思いますので、そこできちんと翻訳ページのURLになっているか確認します。

2 : 翻訳ページを作成するときは親ページから順々に

翻訳ページを作成するときはページの編集画面から言語を選んで作成すると思いますが、親ページの翻訳ページが作成してから子ページの翻訳ページを作成した方がうまく行きます。親ページの翻訳ページを作成しないまま子ページの翻訳ページを作成してしまった場合、うまく子ページの翻訳ページが表示されないことがありました。

3 : キャッシュを削除する

ブラウザのキャッシュが原因かもしれません。こんな初歩的なことでと思うかもしれませんが、実際に「F5」キーや更新ボタンを押しても反映されなかったですしブラウザのキャッシュは残さない設定にしていたのに関わらず、キャッシュを削除を行ってから再読み込みするときちんと翻訳ページが表示されたことがありました。一度お試しください。

]]>
https://tetch1987.com/shittakabull/web/wordpress-bogo-redirect-problem/feed/ 2
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プラグイン:Bogoで多言語化 https://tetch1987.com/shittakabull/web/wordpress-bogo-multilingual/ https://tetch1987.com/shittakabull/web/wordpress-bogo-multilingual/#comments Fri, 04 Dec 2015 09:32:46 +0000 http://tetch1987.com/shittakabull/?p=579 WordPressを多言語化するプラグインはウェブを検索したらいくつか出てきますが、今回は「Bogo」を紹介したいと思います。以前は「qTranslate」を利用していたのですが、使いやすいのはないのかと思い探してみたら色々と出ており、中でも「Bogo」が良さそうなので実装しました。「Bogo」の特徴として、日本語なら日本語のページ、中国語なら中国語のページなど、それぞれページを作成するところにあります。それらはこのプラグインによって結び付けられており、用意された言語ボタンをクリックすることでそのページの翻訳されたページが表示がされるといった感じです。

インストール

インストールは以下の流れに沿って簡単にできます。
「管理画面」>「プラグイン」>「新規追加」>「Bogo」で検索 >「インストール」

下準備

言語ファイルをダウンロードする必要があるようです。日本語版を構築したのなら既に「日本語」と「英語」は備わっています。
それ以外の言語をダウンロードする場合は、管理画面の「ツール」>「Bogo」より様々な言語をインストールできます。ここでインストールした言語は言語ボタンに反映されるので必要な言語だけインストールするといいかと思います。

投稿・固定ページを多言語化する

Bogoを有効化すると投稿(固定ページ)編集画面にて、右上の「公開」ボックスの上に「言語」のボックスが表示されます。最初は恐らく日本語になっていると思いますが、翻訳ページを作ることでここに結び付けられた投稿のタイトルが表示されるようになります。まずは多言語化する投稿の流れになります。

1)翻訳の元となるページの編集画面へ
翻訳したいページ(投稿/固定ページ)の編集画面を開きます。
2)言語を変更
最上部ヘッダーメニュー右側にある言語(今の言語が表示されています。例:日本語)にマウスを載せるとインストールした言語が表示されるので、翻訳したい言語をクリックします。
3)多言語のページを追加
管理画面が選択した言語になり、言語ボックスに「○○語の翻訳を追加する」といった旨のボタンが表示されるのでクリックします。
4)下書き保存して管理画面の言語を戻す
この作業は必須ではありませんが、管理画面が他の言語だと分かりづらいので下書きして言語を元に戻します。言語ボックスにデフォルト言語のタイトルが表示されているのが確認できると思います。(例:サンプルページ[日本語])
このとき、タイトルも翻訳した言語にしておいた方が後で分かりづらくなる事態を避けれます。
5)タイトルや本文を入力して公開
選択した言語で入力して公開します。パーマリンクを確認すると、「http://ドメイン/en/」といったように、該当の言語のパスを挟んでいるのを確認できます。

多言語ボタンを挿入

多言語するボタンを設置するために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を探し出して変更すれば大丈夫です。
※この項目はバージョンによって異なる可能性があるので注意が必要です。

1)参考PHPをコピー
ボタンを取得する関数はbogo_language_switcher()です。「wp-content/plugins/bogo/includes/link-template.php」の191行目~249行目で定義づけられていました。
function bogo_language_switcher(){…}をコピーします。
2)テーマ内の「functions.php」に貼り付け、関数の名前を変更します。
「my_bogo_language_switcher()」などのように関数の名前を変更しましょう。
3)HTMLの吐出し部分を編集
PHPにあまり詳しくない方でも、HTMLタグがどのような形で挿入されているか分かると思います。これを編集することで文字を消したり国旗を消した利が可能です。

BOGOで投稿IDから言語を取得する

オリジナルのプログラムを組んだりしていて投稿を扱っていると、取得した投稿がどの言語なのかを判別したいときがあります。BOGOでは投稿の言語を、'_locale'をキーとしたメタ情報を保存しています。そのため、get_post_meta()を利用して言語キーを取得できるというわけです。

$locale = get_post_meta( $post_id, '_locale', true );

]]>
https://tetch1987.com/shittakabull/web/wordpress-bogo-multilingual/feed/ 1
WP-Membersを導入後、ユーザーをCSVで一括登録(インポート) https://tetch1987.com/shittakabull/web/wp-members-register-user-form-csv/ https://tetch1987.com/shittakabull/web/wp-members-register-user-form-csv/#respond Fri, 08 May 2015 09:01:43 +0000 http://tetch1987.com/shittakabull/?p=557 WordPressのプラグイン「WP-Members」を利用すると、ユーザーログイン、パスワードの変更、ユーザー登録・プロフィール編集が固定ページ上で可能になり、会員サイトを作るのにとても便利です。有名どころでいえば「Theme My Login」でも同じようなことはできるのですが、「WP-Members」の場合は住所や携帯電話などデフォルトにないユーザーメタ情報を追加できるので1つのプラグインで簡易的な会員サイトが作れるのです。しかし、これからユーザーを集める場合はいいですが、すでにユーザー情報を何百件も持っていてそれを反映させたい場合は1件1件登録するのはとても面倒になります。しかし、もし既存のユーザー情報のCSVを取得可能であれば、プラグインで一括登録することができます。WordPressのデフォルトのユーザーメタ情報にない場合でも、CSVからWP-Memebersで設定したユーザーメタ情報も含めて登録できるプラグイン「Members Import」を見つけたので紹介します。別にWP-Membersでなくても使えるかと思いますが。

WP-Membersの導入

まずは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; ?>

WP-Membersの設定1:オプションの設定

自分のサイトに合わせて設定していきます。「固定ページ」の項目は先ほど作成したページを選択させます。

WP-Membersの設定2:フィールドの設定

最初から「州」や「電話番号」などが追加されているので、削除したり追加したりして編集します。
ドロップダウンを選択した場合は、値とラベルを「|」で区切り、「”」で囲みます。また、最後の行以外は「,」を末尾につけて改行させます。
例)
“北海道|address01”,
“青森|address02”,
・・・
“沖縄|address47”

WP-Membersの設定3:ダイアログの設定

エラー時のメッセージなど、ダイアログを編集できます。ログインページや会員ページにリンクをつけた方が親切な項目もあります。

WP-Membersの設定4:メールの設定

「新規ユーザー登録」、「パスワードリセット」などの時に送信されるメールの設定です。

WP-Membersの英語部分を修正

翻訳ファイルが間に合っていないのかは分かりませんが、英語のままの個所があります。翻訳ファイルを編集するか、日本語のみの予定ならプラグインファイルを直接修正してしまいます。アップグレード時に注意ください。
私の場合は以下のファイルを修正しました。
・wp-membears > wp-members-dialogs.php
・wp-membears > forms.php

CSSで整える

いくつかCSSが用意されていますが、サイトに合わせたい場合は整えます。

「Members Import」を導入

基本的なところはできたところで、ユーザー情報をCSVから一括登録できるプラグインを導入します。

「Members Import」のインストール

「プラグイン」>「新規追加」>「Members Import」で検索 > 「インストール」>「有効化」

CSVファイルを作成する

ここでは、Members Importを利用してCSVをインポートするためにCSVのデータを整えます。
コピペや編集がしやすいので、私は「OpenOffice Calc」を利用しました。

インポート用のCSVファイルを作成する

文字コードは必ず「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を当てはめて整える

既存のユーザー情報が入ったCSVを入れ込んでいく前に、文字コードをUTF-8にする必要があります。「TeraPad」などのフリーのテキストエディターでCSVを開き、文字コードをUTF-8にして別名保存します。
「OpenOffice Calc」で各CSVを開いた場合は基本的にコピーペーストで大丈夫かと思います。データを分割したり整えながら当てはめていきます。

作成したCSVを別名で保存する

フィールドの区切り記号を「,」、テキストの区切り記号を「”」にする必要があります。
以下は「OpenOffice Calc」の方法になります。

  • 1)「ファイル」>「別名で保存」
  • 2)「フィルタ設定を編集する」にチェックを入れ、名前を付けて「保存」
  • 3)「選択した書式を維持」を「OK」
  • 4)以下のように設定して「OK」を押します。
      文字列:UTF-8
      フィールドの区切り記号:,
      テキストの区切り記号:”
      すべてのセルをダブルクウォーテーションで囲む:チェックを付ける

ユーザーを一括インポートする

最後に実際にユーザー情報をインポートします。流れは簡単ですが、インポート画面の注意書きにあるように必ずデータベースのバックアップを取っておくことをお勧めします。

  • WordPress管理画面に戻り、「ユーザー」>「Members Import」
  • ファイルを選択
  • オプションを確認し、「Refister」をクリック

ユーザー一覧に登録されていれば完了です。一度ログインを試してみた方がいいかもしれません。

まとめ

今回の場合は、既存のユーザー情報のCSVがある場合に限りますが、WP-Membersを利用していなくても使えるプラグインだと思います。
私はこの方法でできましたが、データベースを一括登録させますのであくまでも自己責任でお願い致します。

]]>
https://tetch1987.com/shittakabull/web/wp-members-register-user-form-csv/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