var 5.0.5
| フック名 | フックの種類 | 説明 |
|---|---|---|
| wpcf7_validate | フィルター | 送られた値を検証 |
| wpcf7_mail_sent | アクション | メールが送信された後に実行するフック |
WordPressにはアクションフックとフィルターフックという仕組みがあります。これは一言でいうと手を加えること。WordPressが動く一連の流れの途中で、何かを追加して実行したり、値を変えたり、独自の関数を挟むことができる機能です。例えば「投稿が保存されたとき」とか、「テンプレートが読み込まれた時」とか、WordPressでは様々なフックが要所要所で用意されているので、いい感じのところで機能を追加したり値を変えたりができるわけですね。「ユーザーが追加されたとき」に「カテゴリーを追加する」なんてこともできちゃうです。フック一覧についてはCodexで確認できます(アクションフック一覧 / フィルターフック一覧)。
わざわざフックを利用せずに直接ファイルを変更してカスタマイズすることも可能ではありますが、WordPressではコアな部分は編集しない方針があります。それはWordPressをバージョンアップする度に編集する必要が出てくることや、プラグインやテーマはコアファイルがデフォルトの前提で設計されているなど、安全性からみても管理性からみてもあまりいいことがないからです。しかし良い感じのところにフックが用意されているので余程特殊なことをしない限りはフックによってカスタマイズができるかと思います。
それはプラグインにも同じことが言えます。バージョンアップもありますので、余程のことがない限りプラグインのコアファイルも編集しないほうがいいでしょう。親切なプラグインの場合はフックを要所要所で用意していますので、プラグインは設定やフックを利用してカスタマイズするのが基本です。
今回のContact Form 7も色々とフックが用意されているので、カスタマイズする場合は、フックに引っ掛けるイメージで関数を実行したり、値を変更したりする流れになります。
送られた情報をチェックするにはwpcf7_validateのフィルターフックを利用すると便利です。これはフォームが送信されてからの流れの途中で実行されるフィルターで、お問い合わせのタグデータを引数として使えたり、エラー時のメッセージを設定できたりと、検証するのにうってつけです。
送信データのチェックは、郵便番号の形式のチェックを追加したり、確認用メールアドレスのチェックを追加したりと、使いどころの多いフックになると思いますが、ContactForm7のプラグイン自体はこのフィルターを利用していないのでカスタマイズ用に用意してくれているフックなのでしょうね。
フィルターフック「wpcf7_validate」は$result = apply_filters( 'wpcf7_validate', $result, $tags );のようにフィルターを通しており、「$tags」を引数として「$result」に対してフィルタリングをすることができます。
流れとしては以下のようになります。
if ( ! $this->validate() ) {として「validate()」を実行if ( ! $this->validate() ) {に当てはまり、CF7が「validation_error」としてエラーメッセージを返す注目したいのは⑤で、無効の項目があるかどうかによって検証結果を判別しているところです。フィルタリングを行ってチェックをしたとしても、$resultに対し無効な項目を設定しなければ「無効ではない」と判断されてメールが送信されてしまいます。
そのためadd_filterでフィルタリングを行う関数には、何らかの条件下で無効としたい箇所に$result->invalidate( $name,$message);のような記述して、無効な項目をセットします。
$result = apply_filters( 'wpcf7_validate', $result, $tags );ネットで色々調べると引数で受け取ることができる「$tags」を回して該当のタグの時に判別するやり方が一般的ですかね。しかし、$tag['type']で判別する場合、タイプ別のフィルターが用意されているので、そちらを利用したほうが無駄に回さずにいいかもしれないですね。
add_filter('wpcf7_validate', 'my_wpcf7_validate', 11, 2);
function my_wpcf7_validate($result,$tags){
foreach( $tags as $tag ){
$name = $tag['name'];
/*
ここにごにょごにょ
*/
// 何らかの判別
if($name === 'validate_invalidate'){
// 無効な項目を追加(第二引数は第一引数のフォーム近辺に表示されるメッセージ)
$result->invalidate( $name, '〇〇してください。' );
}
}
return $result;
}
タグ全体を引数としてフィルターをかける「wpcf7_validate」ですが、「wpcf7_validate」のフィルターを通す前に、type別にフィルターを通しています。
フィルター名はwpcf7_validate_{タイプ名}といった具合です(‘email’の場合は’wpcf7_validate_email’)。
デフォルトでもフィルタリングされており、例えば「number」の場合、maxやminの情報を取得して最小値を下回ったり最大値を上回ったりしていないかチェックしています。
メールが送信されたらゴニョゴニョしたいってときはアクションフックwpcf7_mail_sentが便利です。これはメール送信が成功した時に実行されるアクションなので、POSTを利用して他のシステムとも連携することもできますね。「Contact Form 7」を申請フォームとして利用したり、夢が広がるのではないでしょうか。送信された情報を検証する為のフィルターフックwpcf7_validateと組み合わせればユーザー登録だってできるかもしれません。
アクションフック「wpcf7_mail_sent」はdo_action( 'wpcf7_mail_sent', $contact_form );のように実行されており、「$contact_form」を引数として実行されます。
流れとしては以下のようになります。
if ( $this->mail() ) {でメール送信do_action( 'wpcf7_mail_sent', $contact_form );を実行ここでの注目したい所は、すでに検証が終わっており、メールも送信後になることです。
do_action( 'wpcf7_mail_sent', $contact_form );メール送信後に何かしたい場合に実行できるわけですが、$submission = WPCF7_Submission::get_instance();とすることで、送信された情報を色々ととれるようです。
function my_wpcf7_mail_sent($contact_form){
//送信された情報を取得
$submission = WPCF7_Submission::get_instance();
if($submission) {
/*
ごにょごにょ
*/
}
}
add_action("wpcf7_mail_sent", "my_wpcf7_mail_sent");]]>
基本的なことですが…。ページのURLがリダイレクトされてデフォルトのページが表示されてしまうのか、そもそもリンクのURLがデフォルトのURLを指定しているのかを確認します。Google ChromeやFireFoxなどのモダンブラウザでは、リンクをマウスおーばすると左下にURLが表示されると思いますので、そこできちんと翻訳ページのURLになっているか確認します。
翻訳ページを作成するときはページの編集画面から言語を選んで作成すると思いますが、親ページの翻訳ページが作成してから子ページの翻訳ページを作成した方がうまく行きます。親ページの翻訳ページを作成しないまま子ページの翻訳ページを作成してしまった場合、うまく子ページの翻訳ページが表示されないことがありました。
ブラウザのキャッシュが原因かもしれません。こんな初歩的なことでと思うかもしれませんが、実際に「F5」キーや更新ボタンを押しても反映されなかったですしブラウザのキャッシュは残さない設定にしていたのに関わらず、キャッシュを削除を行ってから再読み込みするときちんと翻訳ページが表示されたことがありました。一度お試しください。
]]>インストールは以下の流れに沿って簡単にできます。
「管理画面」>「プラグイン」>「新規追加」>「Bogo」で検索 >「インストール」
言語ファイルをダウンロードする必要があるようです。日本語版を構築したのなら既に「日本語」と「英語」は備わっています。
それ以外の言語をダウンロードする場合は、管理画面の「ツール」>「Bogo」より様々な言語をインストールできます。ここでインストールした言語は言語ボタンに反映されるので必要な言語だけインストールするといいかと思います。
Bogoを有効化すると投稿(固定ページ)編集画面にて、右上の「公開」ボックスの上に「言語」のボックスが表示されます。最初は恐らく日本語になっていると思いますが、翻訳ページを作ることでここに結び付けられた投稿のタイトルが表示されるようになります。まずは多言語化する投稿の流れになります。
多言語するボタンを設置するためにBogoではショートコード[bogo]を用意しています。本文中に挿入する場合は記事の本文に、テーマで利用する場合は
<?php echo do_shortcode('[bogo]') ?> を挿入します。実際にされる表示はインストールされている言語が国旗付きで並び、翻訳ページがあるものだけリンクになっています。これで投稿・固定ページの多言語化は完了です。
カテゴリーページや月別アーカイブなどの一覧ページでは、該当の言語の投稿しか表示されません。例えばデフォルトの言語が日本語だった場合、カテゴリー「news」一覧を表示するURL「http://ドメイン/category/news/」では日本語のみを表示し、「http://ドメイン/en/category/news/」では英語のみを表示します。そのため、英語に翻訳した「news」カテゴリーの記事がない場合はhaspost()がfalseになり記事がない場合の処理になってしまいます。この辺りは既に記事を大量に作成している人にとっては大変ですね。
the_title()などの投稿の情報を表示する場合は良いですが、サイトのタイトル、カテゴリー等を多言語化するためには一工夫が必要です。
Bogoには現在の言語を取得してくれる関数「get_locale()」が定義されています。これを利用した条件分岐により、日本語だったらこのテンプレートを読み込む、英語だったらこのテキストにする、などといったことが可能になるかと思います。すべてこれで行うとなると結構手間ですけどね。
$locale = get_locale(); if($locale == 'zh_TW') : echo '台湾です'; elseif($locale == 'en_US') : echo '英語です'; else : echo 'その他'; endif;
テーマ内では「get_option(‘home’)」などでホームのリンクを指定している方もいると思いますが、とりわけオリジナルテーマを作成している場合、固定ページのリンクは直に書き込みしていることが私は多いです。特にグローバルメニュー。英語の時はこのリンクで、日本語の時はこのリンクで、と条件分岐してもいいですが手間がかかりそうです。
そこで、「wp-content/plugins/bogo/includes/functions.php」の378行目あたりで定義されている「bogo_url()」が便利かもしれません。第一引数にURLがありますが、これを指定しないと現在のリクエストとなってしまうため、グローバルメニューで使う際はURLを指定しましょう。
<ul>
<li><a href="<?php echo bogo_url('http://domain.com/about/'); ?>">ABOUT</a></li>
<li><a href="<?php echo bogo_url(get_option('home').'/service/'); ?>">SERVICE</a></li>
<li><a href="<?php echo bogo_url(get_option('home').'/category/news/'); ?>">NEWS</a></li>
</ul>
国旗はいらないとか、独自のクラスを付けたいとか、HTMLタグを変えたいとか、ヘッダーやフッターなどテーマに挿入する場合色々とやりたいことが出てくると思います。ここではプラグインの関数を参考に、オリジナルの多言語化ボタンを作成してしまいましょう。ちなみに国旗はCSSの背景指定なので関数を作成しなくても該当のCSSを探し出して変更すれば大丈夫です。
※この項目はバージョンによって異なる可能性があるので注意が必要です。
オリジナルのプログラムを組んだりしていて投稿を扱っていると、取得した投稿がどの言語なのかを判別したいときがあります。BOGOでは投稿の言語を、'_locale'をキーとしたメタ情報を保存しています。そのため、get_post_meta()を利用して言語キーを取得できるというわけです。
$locale = get_post_meta( $post_id, '_locale', true );
]]>
まずはWP-Membersの導入です。詳しく書かれたサイトがたくさんあるのでここでは簡単に書きます。
「プラグイン」>「新規追加」>「WP-Members」で検索 > 「インストール」>「有効化」
プラグインを有効化するといくつかの注意が表示されます。一応従っておきます。
・「設定」>「一般」>「だれでもユーザー登録ができるようにする」のチェックを外して更新
・「設定」>「ディスカッション」>「ユーザー登録してログインしたユーザーのみコメントをつけられるようにする」のチェックを外して更新
・「設定」>「表示設定」>「RSS/Atom フィードでの各投稿の表示」を「抜粋のみを表示」にチェックして更新
WP-Membersで利用されるログインページ、登録ページ、プロフィールページの3つを作成しておきます。
例1)タイトル「ログインページ」スラッグ「login」
例2)タイトル「会員登録」スラッグ「register」
例3)タイトル「マイページ」スラッグ「mypage」
本文には[wp-members page="members-area"]を入れると「プロフィール編集」や「パスワードの変更」が表示されます。
テーマに「page.php」がないと表示されないらしいので作成しておきます。最低限、ループにthe_contentが利用されていれば大丈夫かと思います。
<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); the_content(); endwhile; endif; ?>
自分のサイトに合わせて設定していきます。「固定ページ」の項目は先ほど作成したページを選択させます。
最初から「州」や「電話番号」などが追加されているので、削除したり追加したりして編集します。
ドロップダウンを選択した場合は、値とラベルを「|」で区切り、「”」で囲みます。また、最後の行以外は「,」を末尾につけて改行させます。
例)
“北海道|address01”,
“青森|address02”,
・・・
“沖縄|address47”
エラー時のメッセージなど、ダイアログを編集できます。ログインページや会員ページにリンクをつけた方が親切な項目もあります。
「新規ユーザー登録」、「パスワードリセット」などの時に送信されるメールの設定です。
翻訳ファイルが間に合っていないのかは分かりませんが、英語のままの個所があります。翻訳ファイルを編集するか、日本語のみの予定ならプラグインファイルを直接修正してしまいます。アップグレード時に注意ください。
私の場合は以下のファイルを修正しました。
・wp-membears > wp-members-dialogs.php
・wp-membears > forms.php
いくつかCSSが用意されていますが、サイトに合わせたい場合は整えます。
基本的なところはできたところで、ユーザー情報をCSVから一括登録できるプラグインを導入します。
「プラグイン」>「新規追加」>「Members Import」で検索 > 「インストール」>「有効化」
ここでは、Members Importを利用してCSVをインポートするためにCSVのデータを整えます。
コピペや編集がしやすいので、私は「OpenOffice Calc」を利用しました。
文字コードは必ず「utf-8」にします。1行目はヘッダー部分となります。「address」と「birthday」はWP_Membersの「フィールド」で追加したものになります。
メールアドレスなど必須のところは入れる必要がありますが、ウェブサイト(user_url)など必須ではないところは無視しても大丈夫でした
表で見た場合
| user_email | user_pass | user_login | first_name | nickname | display_name | address | birthday |
|---|
テキストエディタで見た場合
"user_email","user_pass","user_login","first_name","nickname","display_name","address","birthday"
既存のユーザー情報が入ったCSVを入れ込んでいく前に、文字コードをUTF-8にする必要があります。「TeraPad」などのフリーのテキストエディターでCSVを開き、文字コードをUTF-8にして別名保存します。
「OpenOffice Calc」で各CSVを開いた場合は基本的にコピーペーストで大丈夫かと思います。データを分割したり整えながら当てはめていきます。
フィールドの区切り記号を「,」、テキストの区切り記号を「”」にする必要があります。
以下は「OpenOffice Calc」の方法になります。
最後に実際にユーザー情報をインポートします。流れは簡単ですが、インポート画面の注意書きにあるように必ずデータベースのバックアップを取っておくことをお勧めします。
ユーザー一覧に登録されていれば完了です。一度ログインを試してみた方がいいかもしれません。
今回の場合は、既存のユーザー情報のCSVがある場合に限りますが、WP-Membersを利用していなくても使えるプラグインだと思います。
私はこの方法でできましたが、データベースを一括登録させますのであくまでも自己責任でお願い致します。
ここでは「Any Mobile Theme Switcher」のインストール方法と、設定方法を説明しますが、とても簡単なので、簡単に説明します。
前提としては既にスマホ用テーマが作成してある段階です。
オプション設定はこのようになっています。
ここではテーマの作成についてになります。PC版、スマホ版のテーマをそれぞれ作成しても、データベースが1つなのは忘れてはいけません。できれば画像も最適化したいところです。
以下のコードをテーマ内に記述すると、PC版ならスマホ版へのリンク、スマホ版ならPC版へのリンクが挿入されます。
<?php echo do_shortcode('[show_theme_switch_link]'); ?>入力されたコンテンツは1つのため、本文に挿入された画像が大きければスマホの人にとって重くなります。レスポンシブデザインの際にはよくある話ですが、せっかくスマホ用のテーマを作成しているのでこれをショートコードを作成することにより解決します。
テーマフォルダ内にあるfunctions.php内にショートコードを登録する流れとなるのですが、PCとスマホではテーマを変えれるのでそれを利用して読み込む先のURLを変動させるというものです。
また、このショートコードはテスト環境で行っている場合にも利用できます。本番サーバになりURLが変更されても、本文中に入力した画像のパスを変更しなくて済むわけです。
以下をfunctions.phpに追加します。
function my_shortcode_img($atts){
extract(shortcode_atts(array(
'src' => '',
'alt' => ''
), $atts));
$img_path = get_option('home').'/images/'.$src; //ここが画像のパス
//$img_path = get_option('home').'/images/sp/'.$src; スマホの場合
$img_tag = '<img src="'.$img_path.'" alt="'.$alt.'" />';
return $img_tag;
}
add_shortcode('img', 'my_shortcode_img');これをPCの場合とスマホの場合でパスを分けて保存することにより本文内の画像のを切り分けることができます。
テンプレートフォルダを参照すれば一発ではあるのですが、私の場合大抵はドメインの直下に「images」フォルダを作り、その中にまとめて画像ファイルを入れているので「get_option(‘home’)」を利用しています。
このコードを利用して参照する場合は両方のパスに画像が存在する必要があるため、クライアント側にとっては面倒な作業になるかもしれません。
また、投稿画面から入力した画像を表示するには、また別の操作が必要です。
使い方は、を挿入します。
トップレベルメニューは、左側に現れるメニューのうち、一番最初から選択できるメニューです。
add_menu_page('page_title', 'menu_title', 'access_level/capability', 'file', '[function]', '[icon_url]');
サブメニューとして管理画面にメニューを追加する場合。ほとんど同じですが、親の指定が必要です。
また、コーデックに以下のように記載されています。
プラグインがトップレベルメニューを持つ場合、最初のサブメニューはトップレベルメニューと同じ名前を持ち、従ってリンクは複製されます。リンクの複製を避けるには、はじめにadd_submenu_page関数を呼び出し、parentとfileパラメータを同じ名前にします。
add_submenu_page('parent', 'page_title', 'menu_title', 'access_level/capability', 'file', '[function]');
既存のトップレベルメニューにサブメニューで追加できる関数がいくつか用意されているようです。
add_options_page('page_title', 'menu_title', 'access_level/capability', 'file', '[function]');
add_management_page('page_title', 'menu_title', 'access_level/capability', 'file', '[function]');
add_theme_page( 'page_title', 'menu_title', 'access_level/capability', 'file', '[function]');
例として、飲食店のメニュー表をカスタムフィールドに入力しているとします。
フィールド名、吐き出されるHTMLやそのクラス名は任意のもので変更できますが、以下のようにフィールドグループを作成したとします。
コメントをいただいたのですが、ちょうど他の投稿のデータを取る必要が出てきたので、
追記(2014.01.30)として投稿IDを指定しても挿入できるようにしました。
これにより他の投稿でも表示することが出来ます。
以下はテーマ内のfunctions.php内に記述します。
function menubox($atts) {
extract(shortcode_atts(array(
'id' => ""
), $atts));
global $cfs;
if(empty($atts)) :
$fields = $cfs->get('menu');
else :
$fields = $cfs->get('menu',$atts['id']);
endif;
$menucode = '';
foreach ($fields as $field) {
$menutitle = $field['menutitle'];
$menuimg = $field['menuimg'];
$menutext = $field['menutext'];
$menucode .= '<div class="MenuBox">';
$menucode .= '<h2>'.$menutitle.'</h2>';
$menucode .= '<p class="Img"><img src="'.$menuimg.'" /></p>';
$menucode .= '<p>'.$menutext.'</p>';
$menucode .= '</div>';
}
return $menucode;
}
add_shortcode('menu', 'menubox');
「$menucode」は吐き出す変数、「.=」は付け足していく感じです。自由にHTML変えたり出来るかと思います。
ifとかでメニューが入っているか確かめた方がいいのかもですが、こうすれば投稿画面内で[menu]と入れればカスタムフィールドに入力したものが一覧表示されます。
たぶん吐き出されるHTMLは以下のようになります。
<div class="MenuBox"> <h2>料理名1</h2> <p class="Img"><img src="料理1の画像のURL" /></p> <p>料理1の説明が入ります。</p> </div> <div class="MenuBox"> <h2>料理名2</h2> <p class="Img"><img src="料理2の画像のURL" /></p> <p>料理2の説明が入ります。</p> </div> ・ ・
]]>
このプラグインについては、下記の参考サイトに説明書といっていいほど詳しく載ってあります。少し前まではGoogle上位だったのに関わらず、最近探しにくくなったのでメモ。まだまだGoogleの検索エンジンには改良が必要なようです。
追記:とても分かりやすかった以下のURLですが、残念ながら消えてしまいました。一応URLだけ残しておきます。
参考サイト:http://komodo.arrow.jp/wp/great-plugins/advances-custom-fields
「プラグイン」→「新規追加」→「Advanced Custom Fields」で検索→「インストール」→「有効化」
管理メニューに「カスタムフィールド」が追加されるので、そこから管理できます。
フィールドグループの作成ができます。条件に合わせていくつかのフィールドをまとめることが出来ます。この部分は管理上で利用するだけなので、分かりやすい名前をつけておくといいと思います。
「フィールドグループを編集」画面にて、「新規追加」を押すことでフィールドを追加できます。
ここの説明は上記の参考サイトを見た方が分かりやすく、早いと思います。
残念ながら消えてしまいましたので、ここで追記していこうと思います。
ルールでは、どの場合に表示するかの条件を指定できます。基本的には、「パラメータ」「条件式」「値」を設定することで、パラメータが値と等しい場合、等しくない場合と設定できます。これらは横の「and」ボタンを設定することで条件を追加することができます。条件は等しい、等しくないの2通り選べます。
get_field($field_name,$post->ID)では取得できません。$taxonomy = 'category';
$term_id = 1;
$field = get_field('field_name',$taxonomy.'_'.$term_id);
get_field($field_name,$post->ID)では取得できません。$userid = 1;
$field = get_field('field_name','user_'.$userid);
該当する編集画面の項目の位置や表示をオプションで追加できます。