実は開催されることはずいぶん前に知っていたのですが、チェックを怠り受付が開始されていることを知りませんでした。慌てて参加登録しましたが、懇親会は既に満員でした（まあ懇親会は行きたいのですが、行けるか分からないのであれなのですが。）

WordPress の予約投稿の仕組み

予約投稿は cron などで動作しているのではなく、ブログへのアクセスをトリガーにした疑似 cron になっています。
wp-includes/cron.php の wp_cron 関数で現在時刻で実行すべきイベントがあるかチェックしてあればそのイベントに起動します。

予約投稿では予約時刻が過ぎている投稿があると、publish_future_post というイベントが予約日時とともに登録されます。ブログへのアクセス時に wp_cron 関数で publish_future_post というイベントがあり、実行日時を過ぎていると、spawn_cron 関数が呼ばれます。この関数で WordPress のトップレベルにある wp_cron.php に HTTP リクエストを発行します。

wp-cron.php では処理すべきイベントに publish_future_post があると、wp-includes/posts.php の wp_publish_post 関数を呼びます。wp_publish_post 関数では、投稿の状態を公開状態に変更して、管理画面から行うのと同じ処理で編集、保存処理を行います。

予約投稿が失敗するときのチェックポイント

サーバに SSH で接続して、以下のコマンドを実行します。

$ wget http://example.com/wp-cron.php

このコマンドを実行して、サーバレスポンスで 200 が返ってくれば問題ありません。失敗している原因は他にあります。
もし、200 が返って来ないときや、接続ができないようなときはサーバ内から自ドメインの名前解決ができていないことが原因かもしれません。

予約投稿の仕組みで説明したように、WordPress は自分自身に対して HTTP リクエストを出します。そのために自分のドメインがサーバで解決できないとアクセスできずに予約投稿が失敗します。

解決策は /etc/hosts に以下のように指定します。

127.0.0.1 example.com

ググっていると WordPress2.7 にしてから予約投稿が失敗するようになったという現象がちらほらあります。また、wp-includes/cron.php を WordPress2.7 以前のものにすると成功するというような話もあります。これは 2.7 から現在のように HTTP リクエストを出して予約投稿を公開状態にするようになったためだと思われます。

2.7 以前はソケット接続して wp-cron.php を呼び出していました。しかし、予約投稿すると ping が送信されないなどの不具合がありました。多分これを解消するために、通常の編集、保存処理をして公開するように HTTP リクエストを出すようにしたのでしょう。ですので、cron.php を書き換えての対処方法はオススメできません。

Windows では poEdit など専用のソフトがありますが、Mac では手頃なソフトがないのでエディタで編集して msgfmt コマンドを使用して mo ファイルに変換します。

以下、変換方法です。

1. まず適当なエディタで編集する po ファイルを開き編集
2. ターミナルから以下のコマンドで mo ファイルに変換

   $ msgfmt -o /path/to/file.mo /path/to/file.po
   

管理画面にウィジェットを表示する

管理画面の「外観」>「ウィジェット」にウィジェットを表示する。

function widget_control() {
  echo "My Widget";
}
register_widget_control('Widget Name', 'widget_control');

以下のように表示されます。


このウィジェットをサイドバーにドラッグ&ドロップすると以下のようになります。

ウィジェットの表示

ブログのサイドバーを表示した際に出力する内容を設定する。

function widget_view() {
  echo "My Widget";
}
register_sidebar_widget('Widget Name', 'widget_view');

ウィジェットのオプションを設定する

サイドバーにドラッグ&ドロップした後に、ウィジェットのオプションを設定できるようにします。
widget_control 関数を下記のように変更します。値を設定できるような HTML タグを出力することと、POST された値を options に保存する処理を追加しています。

function widget_control() {
  if (isset($_POST['mywidget_value'])) {
    update_option('mywidget_option', $_POST['mywidget_value']);
  }
  $option = get_option('mywidget_option');
  echo "My Widget";
  echo "<input type='text' name='mywidget_value' value='".$option."' />";
}

これで以下のように表示されます。

あとは widget_view関数の方で get_option() で設定した値を取得して表示に反映させたりします。

管理画面のウィジェットに説明を入れる

上記の例では、管理画面のウィジェット一覧でウィジェットの説明がウィジェット名と同じです。他のウィジェットと同様に説明を入れるには以下のようにします。

$options['description'] = 'My Widget Description';
wp_register_sidebar_widget('Widget Name', 'Widget Name', 'widget_control' ,$options);

$options['description'] に設定した文字列がウィジェット名の下に説明として表示されます。

しかし、WordPress をカスタマイズする際にプラグインやテーマだけではどうしても出来ずに DB とのやり取りをカスタマイズしたい場合が出て来た時に、wpdb クラスを直接カスタマイズするのはバージョンアップの時などを考えるとやりたくありません。

そういう場合に有効な方法が wp-content/db.php をいうファイルを使う方法です。wpdb クラスは wp-includes/wp-db.php で定義されていますが、それを読み込んでいるのは wp-includes/functions.php の require_wp_db という関数です。その関数のコードは以下のようになっています。

/**
 * Load the correct database class file.
 *
 * This function is used to load the database class file either at runtime or by
 * wp-admin/setup-config.php We must globalise $wpdb to ensure that it is
 * defined globally by the inline code in wp-db.php.
 *
 * @since 2.5.0
 * @global $wpdb WordPress Database Object
 */
function require_wp_db() {
	global $wpdb;
	if ( file_exists( WP_CONTENT_DIR . '/db.php' ) )
		require_once( WP_CONTENT_DIR . '/db.php' );
	else
		require_once( ABSPATH . WPINC . '/wp-db.php' );
}

wp-content/db.php というファイルは素の WordPress にはないのですが、このファイルを作っておくと wp-db.php をインクルードせずに db.php をインクルードしてくれるようになります。つまり wpdb クラスのカスタマイズが可能ということです。

wp-content/db.php で以下のような感じで wpdb クラスを継承したクラスを定義してそのクラスのインスタンスを $wpdb に入れておけば、WordPress 全体でカスタマイズした wpdb クラスを使用することができます。

require_once( ABSPATH . WPINC . '/wp-db.php' );
class my_wpdb extends wpdb {
    // カスタマイズしたい wpdb のメソッドをオーバーライドする
}
if ( ! isset($wpdb) ) {
    $wpdb = new my_wpdb(DB_USER, DB_PASSWORD, DB_NAME, DB_HOST);
}

まず簡単な雛形から紹介

function my_plugin_dashboard_test() {
    echo "ダッシュボードに表示する内容";
}
function my_plugin_dashboard_setup() {
	wp_add_dashboard_widget( 'my_plugin_dashboard_test', __( 'Widget Title' ),  'my_plugin_dashboard_test');
}
add_action('wp_dashboard_setup', 'my_plugin_dashboard_setup');

ダッシュボードから設定を変更する方法

ダッシュボードウィジットによってはウィジットの右上に「設定」というリンクがあり、クリックすると値などを変更できるものがあります。

wp_add_dashboard_widget 関数は wp-admin/includes/dashboard.php で以下のように定義されています。

function wp_add_dashboard_widget( $widget_id, $widget_name, $callback, $control_callback = null )

最初の例では第４引数の $controll_callback は定義していません。この $control_callback を設定するとダッシュボードウィジットに「設定」というリンクがつきます。この設定をクリックすると、$control_callback で指定した関数で出力した内容が表示されます。この表示は以下のようになります。

<form action="" method="post" class="dashboard-widget-control-form">
ここに $control_callback で出力した内容が表示される
<p class='submit'>
<input type='hidden' name='widget_id' value='suzuki_news_dashboard_test' />
<input type='submit' value='実行' />
</p>
</form>

つまり、$controll_callback で指定した関数でフォームの内容を出力すれば、それを POST で受け取れます。例えば $controll_callback に my_plugin_option と設定すれば、以下のようにして options テーブルに値を入れておくことも可能です。

function my_plugin_option() {
  if ( 'post' == strtolower($_SERVER['REQUEST_METHOD']) &&
       isset( $_POST['widget_id'] ) &&
       'my_plugin_dashboard_test' == $_POST['widget_id'] ) {
    foreach ( array( 'hoge', 'foo' ) as $key )
      $options[$key] = $_POST[$key];
      update_option( 'my_plugin_dashboard', $options );
    }
  }

  // form に表示する内容
}

ちなみに $controll_callback 関数で出力する内容は「設定」をクリックしたときに実行されるのではなく、ダッシュボードが表示されたときに実行され、CSS により非表示になっているだけです。

参考 URL
Rick’s HideOut ? How add options to your WordPress 2.7 dashboard widgets – Archivo

調べたところ、以下の Adobe の Tech Note に回答があった。
SSL 通信における Flash Player の問題

Flash Player ActiveX コントロールは、ブラウザに手動で追加されたもの以外の自己署名証明書（Self-Signed Certificate）を信用しません。この問題は、ユーザがテストサーバにインストールされた完全な SSL 認証を望まない場合、テスト環境でよく見られる現象です。

テストサーバの SSL 証明書が正式なものではなく自己署名証明書だったのが原因のようでした。

参考サイト
SSL経由でSWFUploadするとIO Error（#2038）が発生する ? 岩家ぶろぐ

プラグイン API/アクションフック一覧 – WordPress Codex 日本語版

そこで、自分で一覧を作成してみました。作成方法は wpmu- で始まるソースから do_action を探してアクション名を拾いました。一部 WordPress 用のアクションも入っているかもしれません。また漏れがあるかもしれませんが、これで WordPress Mu 用のプラグイン作成時にかなり助かりましたので、参考までに載せておきます。使用した WordPress Mu のバージョンは 2.8.2 です。

アクション名からだいたいアクションの概要は分かるかと思います。

ログインしているユーザ情報を取得する

$user = wp_get_current_user();

ユーザID を指定してユーザ情報を取得する

$user = new WP_User($user_id);

XML-RPC とは簡単に言うと XML を HTTP でやり取りしてリモート手続き呼び出しを行うための方法です。非常に簡単な仕様で、仕様書も短いですので興味のある方は下記サイトで仕様を確認してください。
XML-RPC Specification
XML-RPC 仕様書　（上記仕様の日本語訳）

その他の参考サイト
PEAR の XML_RPC のマニュアル
Manual :: XML_RPC

WordPress でサポートされている XML-RPC API
Blogger API
MetaWeblog API
Movable Type API

WordPress の XML-RPC API
XML-RPC wp ? WordPress Codex

日本語の情報では下記サイトが見やすくまとめられています。
MovableType で使える XML-RPC API

準備

PHP で XML-RPC を使用するときに PEAR の XML_RPC を使うと非常に簡単です。下記コマンドでインストールします。

# pear install XML_RPC

WordPress が当然必要になるのですが、実際に公開しているブログでテストするのはあれなので、ローカルサーバにテスト用の WordPress をインストールしました。WordPress 2.7 では XML-RPC がデフォルトで使用できないようになっていますので、「設定」>「投稿設定」の中にある XML-RPC のチェックボックスにチェックを入れてます。これで WordPress の XML-RPC が有効になります。

ブログ情報の取得

WordPress の URL が http://example.com/wordpress/ だとすると host は example.com 、XML-RPC サーバ（xmlrpc.php）へのパスは /wordpress/xmlrpc.php となります。
ユーザ名とパスワードには WordPress に登録したユーザを指定します。appkey という項目は Blogger API で使用しますが、WordPress では使われない項目なので空白でかまいません。

記事を投稿したりするときには、blog_id が必要になるのでまず下記のようにして、blog_id を取得します。実際には blog_id の他にも URL やブログ名、ユーザの属性などが取得できます。

require_once("XML/RPC.php");

$host = "example.com";
$xmlrpc_path = "/wordpress/xmlrpc.php";
$appkey = '';
$user = 'username';
$passwd ='password';

$c = new XML_RPC_client($xmlrpc_path, $host, 80);
$appkey = new XML_RPC_Value($appkey, 'string');
$username = new XML_RPC_Value( $user, 'string' );
$passwd = new XML_RPC_Value( $passwd, 'string' );

$message = new XML_RPC_Message(
    'blogger.getUsersBlogs',
    array($appkey, $username, $passwd) );

$result = $c->send($message);

if( !$result ){
 	exit('Could not connect to the server.');
}else if( $result->faultCode() ){
 	exit($result->faultString());
}
$blogs = XML_RPC_decode($result->value());

$blog_id = new XML_RPC_Value($blogs[0]["blogid"], "string");

Recent Post の取得

$numbers = new XML_RPC_Value(20, "int");
$message = new XML_RPC_Message(
    'metaWeblog.getRecentPosts',
    array($blog_id, $username, $passwd, $numbers) );

$result = $c->send($message);

if( !$result ){
    exit('Could not connect to the server.');
}else if( $result->faultCode() ){
    exit($result->faultString());
}
$posts = array_map(
    'array_convEnc',
    XML_RPC_decode($result->value())
);

function array_convEnc($a){
    if( is_array($a) ){ return array_map( 'array_convEnc', $a ); }
    return mb_convert_encoding($a, mb_internal_encoding(),'UTF-8');
}

ファイルのアップロード

写真などのファイルをアップロードすることもできます。記事に写真を入れたい時には予めファイルをアップロードしておく必要があります。アップロード後に URL など取得できるのでそれを投稿する時に使用します。

$image = file_get_contents("/path/to/filename.jpg");
$file = array(
    "bits" => new XML_RPC_Value($image, "base64"),
    "name" => new XML_RPC_Value("filename.jpg", "string"),
);
$file = new XML_RPC_Value($file, "struct");
$message = new XML_RPC_Message(
    'metaWeblog.newMediaObject',
    array($blog_id, $username, $passwd, $file)
);
$result = $c->send($message);
if( !$result ){
    exit('Could not connect to the server.');
}else if( $result->faultCode() ){
    exit($result->faultString());
}
$resp = XML_RPC_decode($result->value());
$image_url = $resp["url"];

記事の投稿

タイトルやカテゴリ、本文、投稿日時、公開するか下書きにするかなどを指定します。

$title = 'TITLE';
$categories = array(
    new XML_RPC_Value("category name1", "string"),
    new XML_RPC_Value("category name2", "string")
);
$description = "ここに本文を入れます。<p>HTML も書けます</p><img src='".$image_url."'>";
$content = new XML_RPC_Value(
    array(
        'title' => new XML_RPC_Value($title, 'string'),
        'categories' => new XML_RPC_Value($categories, 'array'),
        'description' => new XML_RPC_Value($description, 'string'),
        'dateCreated' => new XML_RPC_Value(time(), 'dateTime.iso8601')
    ),
    'struct');
$publish = new XML_RPC_Value(1, "boolean");
$message = new XML_RPC_Message(
    'metaWeblog.newPost',
    array($blog_id, $username, $passwd, $content, $publish));

$result = $c->send($message);

if( !$result ){
    exit('Could not connect to the server.');
}else if( $result->faultCode() ){
    exit($result->faultString());
}
$post_id = XML_RPC_decode($result->value());

metaWeblog.newPost でカテゴリを指定するときは 配列にする必要があり、またカテゴリ名で指定しなければいけません。blogger.newPost ではタイトルやカテゴリは本文と一緒に下記のように指定します。そのときのカテゴリの指定はカテゴリID だったのでちょっとはまりました。

$content = "<title>TITLE</title><category>4</category>本文...";