# WordPress Japan

バージョン 1.0.3

ウェブログ / ニュース パブリッシング ツール

動作環境 - インス トール - テンプレート - クエリ文字列の 用法 - XML-RPC (Blogging API) - メールでの投稿 - 注記

# 動作環境：

- PHP4 (バージョン 4.0.6 以上)
- MySQL (バージョン 3.23.23 以上)
- ... それとあなたのサイトに http://wordpress.org へのリンクを。

このリンクは WordPress を普及させる手助けになりますし、またその唯一の手段でもあります。

WordPress は b2 を正式に引き継いだウェブログツールで、Michel V がスタートさせました。開発作業は引き続き WordPress の開発者たちによって行われています。 WordPress に支援をしていただけるのなら、どうか寄付を お考え下さい。

このドキュメントは今のところまだ未完成であり、WordPress の進展に従い頻繁に更新していきます。また、オンライン・ドキュメント（英語） も wiki（英語） と同時に書き進められています。
（日本語ドキュメント：WPJ Wiki）

# インストール：

## 新規ユーザ：５分でインストール

1. 空のディレクトリに zip ファイルを展開します。
2. すべてをアップロードします。このリリースは、あなたのルートフォルダに設置するように設計されています。ルートフォルダとは、 WordPress で動作するページが置かれるフォルダのことです。
3. （オプション）もし利用するのなら、 weblogs.com キャッシュファイルはウェブサーバによる書き込みができるように設定する必要があります。`weblogs.com.changes.cache` ファイルのパーミッションを "666" (CHMOD 666) に設定して下さい。

4. ブラウザで wp-admin/install-config.php を開きます。これによりインストールに必要な設定ファイルを作成します。データベース名、ユーザ名、パスワード、そしてホスト名が必要になります。

   もしくは、テキストエディタで wp-config-sample.php を開き、コメントで指示されているとおりにデータベース名、ユーザ名、パスワード、そしてホスト名を挿入する方法があります。（ `/*` あるいは `//` で始まる行がコメントです）そしてこのファイル名を wp-config.php に変更して保存し、アップロードします。

5. ブラウザで /wp-admin/install.php を開いてください。このインストーラがあなたのブログ用に MySQL データベースをセットアップします。注意：最初のログイン用のパスワードがインストーラによって与えられます。 エラーが発生した場合は wp-config.php ファイルを再確認して、再度このインストーラを試して下さい。それでも失敗する場合は、その失敗に関する情報（エラー メッセージ等）とあなたのセットアップ情報（あなたの使用しているサーバの PHP と MySQL のバージョン 、インストールに使用したブラウザ名）などの全ての情報とともに、インストールに失敗した旨をサポートフォーラム（英語）に投稿して下さい。
6. その後このインストールスクリプトはあなたをログインページに案内します。ユーザ名 "admin" とインストール中に生成されたパスワードを使ってログインして下さい。そして 'My Profile' の項目をクリックしてパスワードを変更して下さい。このログインページへは wp-login.php からもアクセスすることができます。

## 使用上のヒント：

- なにか投稿したいと思った時はいつでも、ブラウザを起動して wp-login.php を 開き、ログインして投稿します。
- bookmarklet やサイドバー (IE5+/NS6+) を使用して投稿することもできます。
- あるいは、Blogger、MetaWeblog、そして MovableType の API を通じて投稿することもできます。詳しくはこちらをクリックし て下さい。
- デフォルトでは、あなたのサイトのブログは index.php に位置します。この index.php は手の込んだ .CSS-ベースのテンプレートです。また、wp.php という名称の、非.CSS テンプレートを使用することもできます。両方のファイルともあなたの好きなファイル名に変更することができます（php 拡張子をつけるかサーバによって php ファイルとして認識されるようにして下さい）。

## すべてのアップグレードの前に：

- 何を行うにしてもまずその前に、あなたのデータベースをバックアップして下さい。
- まだしてなければ、あなたのデータベースをバックアップするよう、私たちは強くお すすめします。
- データベースをバックアップしましたか？ホントに？よかった！
- どのようにしたらよいのか分からない場合は、こ のスクリプトがお役に立つでしょう。

## これまでのバージョンから v1.0.2 へのアップグレード：

- データベースをバックアップする。そうです、今すぐに。
- ブラウザで /wp- admin/upgrade.php を開く。
- ひょっとしてもっと何かしたかったですか？これだけです！

## v1.0.2 へのアップグレード注意事項：

- テンプレートには新しい index.php の使用を強くお すすめします。古い index.php を単純にアップグレードする方法はおすすめしません。 もちろんこれには少し手間がかかりますが、そうすれば結果にもっと満足できるはず！

## b2 v0.6.1/v0.6.2.2 から WordPress v1.0.2 へのアップグレード：

- 何を行うにしてもまずその前に、あなたのデータベースをバックアップして下さい。そうです、今すぐ に。
- "５分でインストール" の項で説明されているとおりに `wp-config.php` を設定します。
- あとは、すべてのファイルを新しいバージョンのファイルと置き換えて wp-admin/upgrade.php を実行するだけです。これでアップグレードが完了しているはずです。
- またインポートスクリプトが wp-admin/import-b2.php にあります。
- もし b2 のもっと古いバージョンを使用しているのなら、一足飛びに WordPress に移行する前に、最低でも 0.6.1 にアップグレードした方がよいでしょう。
- 新しいテンプレートはさらに改善され、構造が少し変更されていますので、ゼロから始めて 元の自分のデザインに少しずつ近づけていくための時間をかける価値はあるかもしれません。
- WordPress に関する問題はサポート フォーラム（英語） / WPJ フォーラム（日本語）で話し合うよ うにして下さい。

## Movable Type、Textpattern、GreyMatter、Blogger から WordPress v1.0.2 へのアップグレード

- まず最初にデータベースをバックアップする、って言いましたっけ？
- これらのブログツールそれぞれにインポート用のスクリプトが用意されていて、すべて wp-admin ディレクトリにあります。スクリプトを実行する前に必ずあなたのデータベース情報を設定して下さい。
- インポートの詳しい方法はインポートスクリプトの実行中に説明されます。
- Textpattern: wp-admin/import-textpattern.php を実行します
- GreyMatter: wp-admin/import-greymatter.php を実行します
- Blogger: wp-admin/import-blogger.php を実行します
- Movable Type: wp-admin/import-mt.php を実行します

# テンプレート：

WordPress のテンプレートについては、オンラ イン文書（英語）をご覧下さい。（訳注：日本語訳はこちら）

# クエリ文字列の用法：

WordPress はクエリ文字列に大きく依存しています。こうした変数は URL と共に受け渡されます（ク エリ文字列の変数を受け渡す場合、最初の変数名は '?' クエスチョン・マークを伴い、それに続く別の変数は '&' 記号を伴うことに留意して下さい）。

たいていの場合これに関して何かをする必要はありませんが、もしどのように機能するのか知りたければ、以下を参考にして下さい：

クエリ文字列の使い方：

index.php?m=200107 ：２００１年７月の投稿を表示します。

index.php?m=20010701 ：２００１年７月１日以降のすべての投稿を表示します。

index.php?w=20 ：その年の２０週目の投稿を表示します。１月１日を含む週が第１週です（PHP による）。

index.php?p=50 ：データベースで #50 とラベルされている投稿を表示します。

index.php?s=blue+house ：検索語句 "blue house" と一致する投稿を表示します。
簡単な検索ボックス用のコードを以下に示します：

`<form name="searchform" action="<?php echo $PHP_SELF ?>" method="get">
<input type="text" name="s" />
<input type="submit" name="submit" value="search" />
</form>`

index.php?cat=1 ：カテゴリ番号１（１はデフォルト）に属する投稿すべてを表示します。カテゴリは WordPress の管理画面から追加 / 名称変更 / 削除することができます。

index.php?author=1 ：ユーザ番号１（Auther ID）の投稿すべてを表示します。

index.php?p=50&c=1：その投稿に対するコメントやコメントを投稿するための フォームが表示 されま す。
この変数は必ず p= を伴います。
使用例：index.php?p=50&c=1

index.php?p=50&page=1：投稿番号５０の最初のページを表示します。これも各 エントリ毎 に p= を伴います。

これらの変数を組み合わせることも出来ます。例：
index.php?m=200107&s=hotdog：検索語 "hotdog" に一致する、２００１年７月の投稿を表示します。

# XML-RPC インターフェース：

WordPress は XMLRPC インターフェースを備えています。現在サポートしている API は Blogger API、metaWeblog API、そして MovableType API です。将来の weblog/CMS システムを広範囲にカバーするような新しい API に関する話し合いが持たれています。その準備が整い次第、WordPress はその API をサポートします。

Blogger API は WordPress で完全にエミュレートするようになりましたが、ほんの少しだけ次のような違いがあります：

- 番号 'zero（ゼロ）' を伴って blogger.getRecentPosts を使用すると、その blog のすべての投稿を返します
- blogger.getTemplate はあなたのファイル $blogfilename（config で指定されている）を取得し、blogger.setTemplate は編集したデータでそれを上書きします
- blogger.getUsersBlogs はダミー関数で '1' と$blogname を返します。これは WordPress が今のところ一つの blog しかサポートしていないからです。

blogger.newPost を使うと、あなたのポストはタイトルなしでカテゴリー ID １に投稿されます。

しかし <title>私のタイトル</title> や <category>2<category> を投稿の本文に含めると、その投稿はタイトルが '私のタイトル' になり、カテゴリー ID は 2 になります（カテゴリーの ID 番号を調べるには管理画面のカテゴリーのセクションを参照して下さい）。そしてそれが投稿されると、その投稿の本文からは余計な情報（タイトルやカテゴ リ）が削除されます。

metaWeblog と MovableType の API は今のところ次の例外をのぞいた物がサポートされています：

- metaWeblog.newMediaObject、mt.getRecentPostTitles、そして mt.getTrackbackPings がまだ実装されていません
- mt.supportedTextFilters はダミーの控え関数で空の文字列を返します
- MovableType API ではキーワードがサポートされていません

MovableType API の追記された( Extended )エントリは WordPress の <!--more--> タグと変換されます。

次のようなツールを使用して WordPress に投稿できるようになりました：
BlogBuddy、Bloggar、WapBlogger（Wap 規格携帯電話からの投稿！）、Radio Userland（これは Radio のメール-to-ブログ機能を使用できるということです）、Zempt、NewzCrawler、そして Blogging API をサポートするその他のツール！(^^)

仮に http://example.com/me/wp-login.php にある WordPress にログインしたとすると、 あなたの XMLRPC サーバ / パスは次のようになります：

- サーバ：http://example.com/ （いくつかのツールはホスト名の部分 'example.com' だけを必要とするかもしれません）
- パス：/me/xmlrpc.php
- 完全な URL（念のため）： http://example.com/me/xmlrpc.php

また b2 特有のメソッドもあります：b2.getCategories：これは３つの文字列（blog_ID ( '1' を使用)、ユーザ名、パスワード）とともにリクエストします。すると、カテゴリー ID (categoryID) とカテゴリー名 (categoryName) 文字列からなる配列を返します。

# メールでの投稿：

メールクライアントから記事を投稿することが出来ます！
しかしまず初めにオプション画面でオプションを設定しなくてはなりません。ここであなたの POP3 メールアカウントの値を正しく入力します（このインターフェースがサポートしているのは POP3 のみで IMAP はまだです、ゴメン）。

このオプションの設定がすめば、設定された一定の時間毎にあなたのウェブサーバに wp-mail.php を実行させることが出来ます。（ホストの能力にもよりますが、このスクリプトはリソースを集中的に使用しますので一分毎に実行したりしないように。さもな いとサーバから追い出されます）

このスクリプトは Cron のジョブとして実行できます。あなたのホストが Cron をサポートしていなければ、様々なウェブサイト・モニタリング・サービスを調べてあなたの wp-mail.php URL をチェックさせることも出来ます。

## 予備的なアドバイス：

HTML 形式のメールでも機能しますが（このスクリプトはすべての html タグを取り除いてしまいますが、、）、テキストのみでの送信を強くお勧めします（Outlook や Outlook Express は 'html' が初期設定になっていて、これだと問題を引き起こすかもしれません）。

また、いつも使用しているメールアドレスではなく、このスクリプト用に新しくメールアドレスを作成するようお勧めします。もしいつものメールア ドレスを使 用していて、このスクリプトがおかしくなってすべてのメールがあなたのブログに投稿されたり、あるいはすべてのメールが削除されても、私は責任を取れませ ん。

念のため（"送信済み" フォルダの中にあるあなたのログイン ID とパスワードを誰かに見つけてほしくなければ）、あなたのブログに送信した "送信済み" フォルダにあるメールも削除して下さい。

このスクリプトはあなたのウェブログへの投稿に成功したメールを 削除 します。もし投稿がうまくいかなけれ ば、その メールは削除されません。

## 投稿の方法：

ではなにか投稿してみましょう。メールは次のようになります：

To(宛先): address@example.com (config ファイルで設定したもの)
Subject(件名): blog:投稿のタイトル ('blog:' は config ファイルで変更できます)
本文:
ログインID:パスワード (例: Jack:Starwars)
投稿の内容、などなどなど。
さらに、かくかくしかじか。 ___

件名は 'blog:' か config ファイルで設定した文字列で始めなくてはなりません（このスクリプトがあなたのメールボックスのす べて のメールをチェックしないようにするためです）。

本文の最初の行は必ず "ログインID:パスワード" にします。これ以外であればこのスクリプトはそのメールを読み込みません。

もし '___'（もしくは config ファイルで設定した本文終了文字列 - body terminator）を使わなければ、このスクリプトは本文全体を投稿します。もし Yahoo や Hotmail でメールを送る場合にはこれは望ましくないでしょう（あの宣伝をあなたのブログに残したくはないでしょう？）。

## 携帯電話からのメールの場合：

いくつかの携帯電話サービスプロバイダーでは携帯電話や PDA でメールを送ることができますが、こうした装置では改行ができないことがあります。こうした場合、オプションで use_phoneemail = true に設定し、次のようにメールを書いて下さい：

To(宛先): address@example.com
Subject(件名): blog:the post's title :::
本文:
ログインID:パスワード ::: 投稿の内容、かくかくしかじか。___

"件名"と"ログインID:パスワード"の後に ':::'（もしくは config ファイルに設定した文字列）を追加します。

いくつかの携帯電話サービスプロバイダーでは件名を設定できないかもしれません。その場合は本文の最初の文を件名にして、次のようなメールを送 ります：

To(宛先): address@example.com
Body(本文):
blog:投稿のタイトル ::: ログインID:パスワード ::: 投稿の内容、かくかくしかじか。___

# 注記：

複数ユーザに関して：

新しいユーザは wp-register.php で登録することができます。その後、（admin - 管理者として）管理画面「チーム」ページの登録した名前の横の "+" マークをクリックしてその登録者のレベルを１以上にアップグレードします。するとその新規ユーザが投稿できるようになります。あるユーザを投稿できなくす るには、そのユーザのレベルが０になるまで "-" マークをクリックします。

ヒント：config ファイルですべてのユーザ登録を無効にできるようになりました。

ユーザレベル：

- 0 - 新規ユーザ：投稿できません。
- 1 - ユーザ：投稿と自分の投稿の編集 / 削除ができます。
- 3 以上 - admin（管理者）：投稿と他の人の投稿の編集 / 削除、そしてオプションの変更ができます。
- 1 より上のユーザは誰でも、自分より下のレベルのユーザの投稿を編集 / 削除したり、そのユーザのレベルを変更することができます。例：レベル 2 のユーザは admin（管理者）ではありませんが、レベル 1 ユーザの投稿を編集することができ、また新規ユーザのレベルを 0 から 1 に上げることができます。

通常は自分以外のユーザのレベルを１にしてチームを組むといいでしょう。;)

ヒント： オプション画面でオプションを変更することにより、登録後すぐにその新規ユーザの投稿が可能になります。

あなたのブログで自分以外のユーザをいっさい登録させないようにするには、自分のアカウントを登録後に wp-register.php を削除して下さい。

# 最後の注記：

- 提案、アイディア、コメントをお持ちだったり、あるいはバグを見つけたのなら、サポートフォーラム（英語）に参加してみませんか？（訳注：日本 語でのフォーラムもあります：WPJ フォーラム）
- PHP のコードが分かる方なら、WordPress の構造がさらに多くの機能やセクションを追加できるほどの十分な柔軟性を備えていることが理 解できると思います。

# 著作権に関する注記：

- サードパーティのコードが使用されている箇所には、そのコードのコメントにクレジットが記されています。
- WordPress は GPL（license.txt 参照）に基づいてリリースされています。