月: 2019年6月

テーマのパスを取得する関数です。get_template_directory_uri()とほぼ同じです。
違いは「子テーマをの場合、子テーマのディレクトリパスを返す」ここがポイントです。

メリット

get_stylesheet_directory_uri() を使用するとこで、子テーマのパス指定が簡単になります。SSL 対応やドメイン変更など運用にも強いコードになります。

使い方

echo で出力して使います。

<a href="https://camon.tokyo/" ><img src="<?php echo get_stylesheet_directory_uri(); ?>/images/logo.png" /></a>

この辺りもget_template_directory_uri()と基本的には変わらないですね。

参考

https://wpdocs.osdn.jp/%E9%96%A2%E6%95%B0%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9/get_stylesheet_directory_uri

pugiemonn

CAMON.TOKYO の吉澤修です。

記事に関連したお困りごとやお仕事のご相談などはお問い合わせからご連絡ください。

get_template_directory_uri() はテーマのディレクトリパスを取得する関数です。

WordPress のテーマを編集する際、必ず遭遇するのが get_template_directory_uri() と言っても過言ではないでしょう。

メリット

テーマで get_template_directory_uri() を利用しておくことで、SSL 対応やドメイン変更など WordPress の運用に強いコードを作ることができます。

使い方

テーマのディレクトリパスを取得したい場合に利用します。
get_template_directory_uri が意味するテーマとは親テーマのことです。ここがポイントです。

出力は echo で行います。

<a href="/"><img src="<?php echo get_template_directory_uri(); ?>/images/camon_logo.png" /></a>

echo と組み合わせて HTML 内に出力というのが多いですね。

子テーマの場合

子テーマでテーマの パスを取得したい場合は、get_template_directory_uri ではなく、get_stylesheet_directory_uri を使用します。

参考

https://wpdocs.osdn.jp/%E9%96%A2%E6%95%B0%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9/get_template_directory_uri

pugiemonn

CAMON.TOKYO の吉澤修です。

記事に関連したお困りごとやお仕事のご相談などはお問い合わせからご連絡ください。

WordPress 管理画面に独自メニューを追加できる、add_menu_page() をご紹介します。

add_menu_page() は管理画面に独自のメニューを追加できる関数なので、テーマ開発やプラグイン開発で必ず登場する関数とも言えます。

使い方

add_menu_page() ですが引数が多めです。

add_menu_page( string $page_title, string $menu_title, string $capability, string $menu_slug, callable $function = '', string $icon_url = '', int $position = null )

引数はストリング型が多いです。最後のポジションが int 型です。

呼び出し関数の中で、表示したい内容を記述すれば、追加したメニューに反映されます。

呼び出すには

add_menu_page() は add_action のアクションフックを使用します。

//管理画面にメニューを追加
function add_my_menu() {
    add_menu_page( 'page_title', 'menu_title', 'administrator', __FILE__, 'function_name', '', 8);
}
add_action('admin_menu', 'add_my_menu');

上記例の中にある、function_name 部分で HTML 出力コードを記載すると良いでしょう。

position について

パラメータの $position には管理画面での表示位置を数字で指定します。

Default: bottom of menu structure #Default: bottom of menu structure
2 – Dashboard
4 – Separator
5 – Posts
10 – Media
15 – Links
20 – Pages
25 – Comments
59 – Separator
60 – Appearance
65 – Plugins
70 – Users
75 – Tools
80 – Settings
99 – Separator

https://developer.wordpress.org/reference/functions/add_menu_page/#menu-structure

例えば管理画面にある設定項目の下に表示するには80を指定します。
ここは実際にコードを書いて試してみるとわかりやすいです。

参考

• https://developer.wordpress.org/reference/functions/add_menu_page/
• https://wpdocs.osdn.jp/%E9%96%A2%E6%95%B0%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9/add_menu_page
• https://firegoby.jp/archives/3831
• https://qiita.com/konweb/items/330f735a899e448ef876

pugiemonn

CAMON.TOKYO の吉澤修です。

記事に関連したお困りごとやお仕事のご相談などはお問い合わせからご連絡ください。

国際化、翻訳のための関数です。
__() は translate() のエイリアスとのことですが、translate()は直接しようしないようにせよとありました。

使い方

使い方
<?php translate( $text, $domain ) ?>
パラメータ
$text
（string） （必須） 翻訳するテキスト。初期値： なし
$domain
（string） （optional） 翻訳テキストを取得するドメイン。初期値： ‘default’
戻り値
(string) 
翻訳されたテキスト。

https://wpdocs.osdn.jp/%E9%96%A2%E6%95%B0%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9/translate

公式ディレクトリに公開するようなプラグインやテーマなどは__()を利用しておいて、基本的には多くの言語に対応したほうがいいですね。

日本人のみを対象とした有料プラグインなどでは不要かもしれません。

参考

• https://wpdocs.osdn.jp/%E9%96%A2%E6%95%B0%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9/translate
• https://wpdocs.osdn.jp/%E9%96%A2%E6%95%B0%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9/_2

pugiemonn

CAMON.TOKYO の吉澤修です。

記事に関連したお困りごとやお仕事のご相談などはお問い合わせからご連絡ください。