管理画面のエラーの内容からスクリプトをgrepなどで辿って調べたいと思っても日本語化されてるので手間がかかって仕方ない。というわけで、いったん英語モードにしようと思ったものの、確か見た記憶のある言語を変更できる管理画面上のインターフェイスがどこにもない。確かに見たはずなんだけど…

調べたところ、マルチサイト化している場合のみ、ブログ単位で管理画面から言語を変更できるようだ。

// /wp-admin/options-general.php
$languages = get_available_languages();
if ( is_multisite() && !empty( $languages ) ):
// 以下、言語設定用の表示が続く

ここで設定された言語設定はマルチサイトでのみ作成される wp_blogs テーブルの lang_id に格納されるため単独ブログでは反映するすべがない。

単独のサイトの場合は wp-config.php を編集する必要あり。

define('WPLANG', 'ja');

これをコメントアウトすればデフォルトの英語表記になります。

複数言語のユーザーで同一ブログを編集するためには何らかのプラグインが必要になるのでしょうね、今のところは。

参考サイト：

• Kinopyo Blog: WordPress言語の変更
• hyokoya: 言語設定の変更　英語→日本語　日本語→英語 wordpress

あえて定石から外れたやり方でポストを表示するためのメモ。

// 通常のWordPressループとは別に投稿オブジェクトを取得
$another_post = get_post( $args );

// パーマリンクの取得
$permalink = apply_filters( 'the_permalink', get_permalink( $another_post -> ID ) );

// コンテンツの取得（ だいぶ端折った簡易版 ）
$content = apply_filters( 'the_content', str_replace( ']]>', ']]>', $another_post -> ID ) );

コンテンツの取得は自信ないけどこんなものでしょうか。
ほかに、抜粋（excerpt）や $more の取得などもありますがまたの機会に。
WordPress の定石だとクエリを発行して投稿オブジェクトを取得してそれをループさせてってなるんですけど、どうも扱いが苦手。それにしてもグローバル変数をこれほど多用しながら、よくもここまでの規模のシステムを維持できるものですね。すごい。個人的にはありえないですわ。

WordPressのコアが提供している定義済み定数や関数、メソッドの中から、URLおよびファイルパスをGETするためのものをリストアップしていきます。同種の機能がなんとなく散在している印象があるため、このエントリを使ってメモしていきます。※とりあえず順不同＆解説なし。

関数

• get_bloginfo( $show, $filter )
  $show に対応した値を返す。
• bloginfo( $show )
  上記の get_bloginfo で取得した値を echo する。
  詳しくはこちら→WordPress の get_bloginfo, bloginfo を詳しく見る。
  Webページに出力する値を中心にまとめられているようです。出力する必要のなさそうなプラグインのディレクトリだとか、管理画面のURLなどは対象外。
• get_stylesheet_uri()
  =get_bloginfo( ‘stylesheet_url’ )
• get_stylesheet_directory()
  =get_bloginfo( ‘stylesheet_directory’ )
  現在使用中のスタイルシートのディレクトリパス。管理画面で指定したテーマディレクトリを参照します。親テーマを指定した場合もこれは変わりません。
• get_stylesheet_directory_uri()
  =get_bloginfo( ‘stylesheet_directory’ )

  使用例

  /* スタイルシートを読み込む. head 内で wp_head() よりも先に記述 */
  $handle = 'my-style';
  $css_url = get_stylesheet_directory_uri() . '/my-style.css';
  wp_register_style( $handle, $css_url );
  wp_enqueue_style( $handle );

• get_template_directory()
  使用中のテーマディレクトリ。親テーマを定義している場合、この値は親テーマのディレクトリパス。親テーマを指定しない場合、get_stylesheet_directory() と同じ値。
  /wp-includes/default-constants.php で TEMPLATEPATH に、この値が定義される。
• get_template_directory_uri()
  使用中のテンプレートディレクトリのURL
• get_theme_roots()
  テーマディレクトリのベースネーム
  (例) /themes
• get_theme_root()
  =get_bloginfo( ‘template_directory’ )
  テーマディレクトリの絶対パス
  (例) /root/account/public_html/wp-content/themes
• get_theme_root_uri()
  テーマディレクトリへのURL
  (例) http://example.com/wordpress/wp-content/themes
  • ※使用中のテーマディレクトリのURLは get_bloginfo( ‘template_url’ ) で取得。
    (例) http://example.com/wordpress/wp-content/themes/my-template
  • ※使用中のメインスタイルシートのURLは get_bloginfo( ‘stylesheet_url’ ) で取得。
    (例) http://example.com/wordpress/wp-content/themes/my-style/style.css
• site_url( $path = ”, $scheme = null )
  = get_bloginfo( ‘wpurl’ )
  ダッシュボードの「WordPress のアドレス (URL)」に設定した値。内部的に次の get_site_url( null, $path, $scheme ) を呼び出している。
• get_site_url( $blog_id = null, $path = ”, $scheme = null )
  上記のsite_url のもとになる関数。 blog_id の引数を渡せる。
• home_url( $path = ”, $scheme = null )
  引数を渡さない場合 get_bloginfo( ‘url’ ) と同値。 ‘siteurl’, ‘home’ も同じ値が返るが非推奨
  ダッシュボードの「サイトのアドレス (URL)」に設定した値。
  内部的に、次の get_home_url( null, $path, $scheme ) を呼び出している。
• get_home_url( $blog_id = null, $path = ”, $scheme = null )
  上記のsite_url のもとになる関数。 blog_id の引数を渡せる。
• admin_url( $path = ”, $scheme = null )
  管理画面用のURL。get_admin_url( null, $path, $scheme )
• get_admin_url( $blog_id = null, $path = ”, $scheme = null )
  指定したブログIDの管理画面用のURLが返る。ディレクトリ名の ‘wp-admin/’ は決め打ち。
  フィルタ ‘admin_url’ を適用。
• plugin_dir_path( $file )
  $file のディレクトリパスが返る。関数名に「plugin」とありますがまったく関係なし。単に ディレクトリパスの末尾にスラッシュをつけたものが返ってきます。しかも末尾は「スラッシュ」固定ですが、それより前にあるセパレータは環境依存のまま。中途半端な印象の関数です。コアシステムでも一切使用されていない意味不明な存在。
  v.3.1現在、デフォルトでこの関数を参照しているのは  wp-multibyte-patch プラグインのみ。dirname() を用いたほうが絶対にいいだろと思う。歴史的な意味があったのか知らん。
• plugin_dir_url( $file )
• plugins_url( $path = ”, $scheme = null )
  プラグインの「ルートディレクトリ」までのURLを返す。
  末尾にスラッシュは付かない。
• plugin_basename( $file )
  引数で渡したファイルパスの文字列から plugin の「ルートディレクトリ」以下のパスを切り取って、ディレクトリセパレータを’/'に変換して返す。先頭にセパレータは付かない。
  プラグインのサブディレクトリに含まれているファイルにも対応。
  pluginディレクトリに含まれていないファイルパスを渡した場合は、切り取りは一切行われずにセパレータの変換のみを行う。

  使用例

  プラグインファイルのURLを取得する。

  $plugin_file_url = plugins_url() . '/' . plugin_basename( __FILE__ );  // __FILE__ までのURLが返る。間のスラッシュを忘れないこと。
  // 同じことは以下のようにも記述できる
  $plugin_file_url = plugins_url( plugin_basename( __FILE__ ) );
  // これは間違い
  // $invalid_url = plugins_url( __FILE__ );

• content_url( $path = ” )
• includes_url( $path = ” )
• network_site_url()
• network_home_url()
• network_admin_url()
• wp_login_url( $redirect = ” )
• wp_logout_url( $redirect = ” )
• wp_lostpassword_url( $redirect = ” )

定数

• ABSPATH
• ADMIN_COOKIE_PATH
• PLUGINDIR
• WPINC
• WP_PLUGIN_URL
• WP_PLUGIN_DIR
• WPMU_PLUGIN_DIR
• WPMU_PLUGIN_URL
• WP_CONTENT_URL
• WP_CONTENT_DIR
• COOKIEPATH
• MUPLUGINDIR
• SITECOOKIEPATH
• PLUGINS_COOKIE_PATH
• WP_LANG_DIR
• LANGDIR
• UPLOADBLOGSDIR
• UPLOADS
• BLOGUPLOADDIR
• TEMPLATEPATH
• STYLESHEETPATH

クラスメソッド

class WP_Filesystem_Base

ファイルシステムを操作するための基底クラス。

• WP_Filesystem_Base::abspath()
• WP_Filesystem_Base::wp_content_dir()
• WP_Filesystem_Base::wp_plugins_dir()
• WP_Filesystem_Base::themes_dir()
• WP_Filesystem_Base::find_base_dir($base = ‘.’, $echo = false)
• WP_Filesystem_Base::get_base_dir($base = ‘.’, $echo = false)
• WP_Filesystem_Base::find_folder($folder)
• WP_Filesystem_Base::search_for_folder($folder, $base = ‘.’, $loop = false )
• WP_Filesystem_Base::gethchmod($file)
• WP_Filesystem_Base::getnumchmodfromh($mode)
• WP_Filesystem_Base::is_binary( $text )

継承クラス

• WP_Filesystem_Direct
• WP_Filesystem_FTPext
• WP_Filesystem_ftpsockets
• WP_Filesystem_SSH2

参考ページ

• Codex:Determining Plugin and Content Directories(プラグインおよびコンテンツのディレクトリの決定)
• firegoby:WordPressでサイトのURLを取得する方法を整理してみた。
• KWLOG:WordPressのurlの取得方法がいろいろある
• WEBLE:WordPressの各種ディレクトリへのパスを取得するタグまとめ
• Serendip WS:WordPressでブログの各アドレス情報を取得・表示する

きっとあるに違いないと思って探したらやっぱりあったので、同じく探し中の人が1秒でも得できるためにメモ。※ただし v. 3.1.0 からの新機能です。

ユーザーの一覧を取得したいときは、get_users という関数がコアで提供されているのでそれを利用すると良いです。

しかし、wp_users のテーブルから任意の行･カラムの取得をするための関数であり、メタ情報などとのアソシエーションは組まれていませんので、より詳しいデータを取得したい場合は独自にクエリを発行するか、この関数の結果を元に再度 get_userdata をコールするしかないでしょう。

日本語リファレンスは無いので本家のリンク→http://codex.wordpress.org/Function_Reference/get_users

思いつくパラメータはすべて網羅されているのではないかと思います。

$args = array(
    'blog_id' => $GLOBALS['blog_id'],
    'role' => ,
    'meta_key' => ,
    'meta_value' => ,
    'meta_compare' => ,
    'include' => array(),
    'exclude' => array(),
    'orderby' => 'login',
    'order' => 'ASC',
    'offset' => ,
    'search' => ,
    'number' => ,
    'count_total' => true,
    'fields' => 'all',
    'who' =>
 );

上記は codex のまんまコピーなんですが、’count_total’ に関しては、この関数の中で強制的に false に上書きされています。何故かは不明。現時点の暫定処理かも。

ソースを見てみるととても簡単な実装で、これまた初耳の WP_User_Query というクラスの get_results を呼び出しています。

どちらも Version 3.1.0 からの新規追加実装なのでバージョンにはご注意を。

※あと、よく分からないのが’who’ というパラメータですが、’authors’という文字を渡した場合に限り、なんだかんだとおまけの情報を付加してくれる模様ですが、未確認です。将来的にこの辺拡張されるのかもしれません。

戻り値はオブジェクトの配列。