#coldbox theme

書いたよ。複雑な WordPress のエスケープ関数を整理してみる

WordPress でセキュリティを考える時に大事なのは文字列のエスケープです。ただ、エスケープの関数だけでもかなりの数がありややこしいので、よく使うものをまとめてみました。

前提知識 the_* 関数と get_* 関数の違い

基本的に the_ 関数は get_ 関数を echo しているだけですが、一部の関数ではエスケープされて出力されています。 ですので安全面を考えると、echo get_ は極力使わず、可能な限り the_ 関数を使うのが望ましいです。 the_ 関数を使えばエスケープは必要ありません (既にエスケープされているため)。

翻訳可能文字列

WordPress テーマを公式ディレクトリにアップロードする際には、すべての文字列が翻訳可能文字列になっていることが必須になっています。 基本的に翻訳可能な文字列は、__( 'example', 'slug' ) もしくは _e…

WordPress にあるコメント機能ですが、そこにはコメントだけでなくピンバックも混ざっていてとても見にくかったりします。 そこでこのカスタマイズを使うと、コメント・ピンバックをそれぞれ別々の場所に出力できるようになります。

comments.phpへの記述

まずは、記事へのコメント・ピンバックがそれぞれ存在するかを確認します。 これには、get_comments() 関数を使います。

$comments_count = get_comments( array( 'status' => 'approve', 'post_id'=> get_the_ID(), 'type'=> 'comment', 'count' => true, ) ); $pings_count = get_comments( array( 'status' => 'approve', 'post_id'=>…

[WordPress] インライン CSS/JS をエンキューして出力する

テーマカスタマイザーから引っ張ってくるコンテンツでは、スタイル・スクリプトをインラインとして出力したい時があります。 ただ、WordPress のテーマガイドラインによると、すべてのスタイル・スクリプトは正しくエンキューされている必要があり、wp_head へのフックで直接吐き出すのは認められていません。

そこで使えるのが wp_add_inline_style() / wp_add_inline_script() という関数。これを使うことで適切にエンキューされたスタイル・スクリプトを出力できます。

使い方

基本的な使い方は wp_enqueue_style と変わりません。 wp_add_inline_style がスタイル用、 wp_add_inline_script がスクリプト用です。

一つ注意点は、$handleへは、既にキューに登録されているスクリプト /…

記事投稿: [WordPress] 言語ごとに時間のフォーマットを変えて出力する方法

公式ディレクトリ掲載のテーマ等、英語ベースで開発しているテーマで気になってくるのは時間フォーマットです。 英語圏では 年→日→月 の順番で表示するのが基本ですが、日本語でそうなっているとかなり違和感があります。 pot ファイルを使うことにより、その問題を解決することが出来ましたのでご紹介です。

方法

the_time() 関数の引数を翻訳可能文字列として保存するだけです。

例

<?php the_time( __( 'jS F, Y', 'theme_slug' ) ); ?>

これは実際に私の開発した Coldbox テーマで使っているものです。the_time 関数は引数として時間フォーマットを指定できるので、その文字列を翻訳可能にしてしまいます。

その上で ja.po ファイルでこの文字列を “Y年 m月 j日”…

新しい記事: WordPress テーマカスタマイザーに任意のHTMLを出力する

特定のカスタマイザーコントロールに基づくラベルや説明 以外 の HTML をカスタマイザーに追加する方法の紹介です。改行、画像、ボタンまたは見出しなんかを追加できます。

現在 WordPress のネイティブ機能として実装することは出来ませんが、カスタムコントロールを使用して実装することが可能です。

この記事は WP Theming で公開された Customizer Control: Arbitrary HTML の翻訳記事です。執筆者の許可を得た上で翻訳、公開しています。

カスタムコントロール

任意の HTML を表示させる為のカスタムコントロールはものの数行で実装できます。ラベルと説明が要らなければさらに短縮することも可能です。

if ( class_exists( 'WP_Customize_Control' ) && ! class_exists(…