bbPress の基本動作を一通り見て回るまでプラグインを控えるつもりだったのですが、早くも手打ちが面倒になってきたぼのは、クイックタグボタンを設置してしまったのでした。(´_｀)

導入手順

1. 配布元よりダウンロード。
2. プラグインの設置が初めてなので、bbPress のディレクトリ直下に my-plugins ディレクトリを作成。そこに comment_QT_4_bbpress.php, js_quicktags.js の 2つをアップロード。
   • フォルダごとアップロードすると、有効化はできるが、クイックタグが表示されなかった。Installation のとおりにフォルダ名を quicktags4bbpress にしてもダメ。
     GuitarAngel のコメント を読んで、フォルダから出したら動作した（ソースもそうなってた）。 thanks!
3. bbPress 管理パネルの サイト管理 » プラグイン で「Actvate」をクリック。
4. 投稿欄の上部にクイックタグが表示され、動作することを確認。

注

• [IMG] ボタンが表示されるが、実際に使うには、img タグを許可するプラグインが必要。
• [Bold] [Italic] ボタンで挿入されるタグは <strong> <em>。実際と違うので後で直そう。斜体は日本語だと読みにくいから、後で CSS を直しちゃうだろうし。

実際に試しながら、分かったことを追記していきます。以下の内容は、後で訂正する可能性があります。

bbPress の設定

config.php

現バージョンでは、bbPress 全体に関わる設定のほとんどを config.php で行なう模様。設定項目は多くない。以下に、config-sample.php のコメント部分をざっくり意訳。

<?php

// ** MySQL 設定 ** //
define('BBDB_NAME', 'bbpress');      // データベース名
define('BBDB_USER', 'username');     // MySQL ユーザ名
define('BBDB_PASSWORD', 'password'); // ...それから、パスワード
define('BBDB_HOST', 'localhost');    // ここは 99% 変更しなくてオッケー

define('BBDB_CHARSET', 'utf8');      // *アップグレード* かつ あなたの旧 config.php に
define('BBDB_COLLATE', '');          // この2行がない場合は、この定義を外すこと。
                                     // 新規インストールであればこのまま残してください。

// 一つの DB で複数フォーラムを設置したいときは、テーブル名の接頭辞（prefix）を変更
$bb_table_prefix = 'bb_'; // 半角英数・アンダースコアのみ！

// 設置した bbPress のフル URL
$bb->uri = 'http://my-cool-site.com/forums/';

// なんて呼ぶ？
$bb->name = 'New bbPress Site';

// インストールスクリプト実行前に必ず設定しておくこと。管理者メールアドレス
$bb->admin_email = 'you@example.com';

// パーマリンクを使う場合は true、パーマリンクにスラッグを使いたい場合は 'slugs' と設定
$bb->mod_rewrite = false;

// 各ページに表示するトピック数
$bb->page_topics = 30;

// 投稿後何分以内であれば、投稿者自身が投稿を修正できるようにするか
$bb->edit_lock = 60;

// 時差（timezone offset）。例： 太平洋時間（サマータイム）は -7。日本は 9？+9？
$bb->gmt_offset = 0;

// bbPress を現地語化するにはここを変更。
// 言語に合った MO ファイルを bb-includes/languages に置くこと。
// 例えば、ドイツ語化するには、bb-includes/languages に de.mo を置き、
// BBLANG に 'de' を設定する。
define('BBLANG', '');

// あなたの Akismet Key。 bbPress の動作自体には不要ですが、
// Akismet の強力なスパムブロックを利用したい場合にはこのキーが必要です。
// Akismet key の入手はこちらから。↓
// http://wordpress.com/api-keys/
$bb->akismet_key = ''; // 例： '0123456789ab'


// 以下は bbPress を WordPress と一体化させるときに設定します。
// そうでない場合はこのまま残しておいてください。

$bb->wp_table_prefix = '';  // WordPress のテーブル接頭辞.  例： 'wp_';
$bb->wp_home = '';  // WordPress - Options->General: Blog address (URL) // 例： 'http://example.com'
$bb->wp_siteurl = '';  // WordPress - Options->General: WordPress address (URL) // 例： 'http://example.com'

/* 編集はここまで */

if ( !defined('BBPATH') )
    define('BBPATH', dirname(__FILE__) . '/' );
require_once( BBPATH . 'bb-settings.php' );

?>

説明： bbPress » Installation

文字コード

BBDB_CHARSET 以外に文字コードを設定できる箇所は見当たらない。決め打ちしている箇所もあるので、UTF-8 固定っぽい。

時差

$bb->gmt_offset = 9;
にしてみたが、管理画面のユーザ登録時間は GMT で表示されている。後でテーブルも見てみる。

パーマリンク設定

フォーラム・トピック・タグ・ユーザ・フィードの URI のパーマリンク形式を設定できる模様。
まだ試していないけれど、bbPress » FAQ » How do I get Pretty Permalinks working? をまたまたざくっと意訳。

1. bbPress の config.php で次のように設定。

   • $bb->mod_rewrite = false; 「クエリ型」リンクにしたいとき（/topic.php?id=17）（デフォルト）
   • $bb->mod_rewrite = true; 数字のパーマリンクにしたいとき（/topic/17）
   • $bb->mod_rewrite = 'slugs'; スラッグベースのパーマリンクにしたいとき（/topic/i-like-bbpress）

2. bbPress のルートディレクトリに .htaccess という名前のファイルを作成し、次の 1行のみ記入。

   Options +MultiViews
   

3. これで試してみて。
   動かなければ、あなたのウェブサーバが MultiViews に対応していません。その替わりに、.htaccess から先の1行を削除すると、and replace it with the several lines bbPress generates for you when you browse to your bbPress installation’s /bb-admin/rewrite-rules.php.

注： スラッグについて
フォーラム名・トピック名などが日本語の場合、自動生成されるスラッグは例のごとく URL エンコード文字列。編集画面がないので、パーマリンクにスラッグを使いたいときは phpMyAdmin で修正するとかしなさそう。

WordPress との一体化

試していないので省略。

参照：

• config.php での設定
• bbPress » Integration with WordPress
• bbPress » FAQ » Do I need any plugins to integrate bbPress with WordPress?

bbrpress 管理画面

WordPress でいうオプション設定のような、bbPress 全体の設定項目はない。

• ダッシュボード — 統計情報など
• ユーザー — 一覧表示と詳細の編集
  • 検索 — 権限別ユーザ一覧と検索
  • モデレーター
  • ブロック
  • 不正ユーザ
• コンテンツ
  • トピック
  • 投稿
  • フォーラム — 追加・編集・削除。フォーラム名・説明・親フォーラム・表示位置は編集できるが、スラッグは編集できない。
  • Akismet スパム
• サイト管理
  • プラグイン
  • 再計算 — 投稿数などの再計算。通常は使わない。

機能

bbPress でできること。後日追記。

ユーザの役割・権限

参考： bb-includes/capabilities.php

• Key Master
• Administrator
• Moderator
• Member
• Inactive
• Blocked

ユーザ

フォーラム

トピック

タグ付け

フィード配信

bbPress 情報

• 公式サイト： bbPress
• インストール手順： bbPress » Installation
• 配布ページ： bbPress » Download
• サーバ要件： bbPress » Requirements
  • PHP 4.2 以上
  • MySQL 4.0 以上
  • （オプション） MultiViews または mod_rewrite Apache モジュール
• 日本語化ファイル update ： bbpress-i18n/ja/
  • 作者： WordPress 日本語版作成チーム
  • 参考： bbPress の日本語リソース
• ドキュメント（マニュアル）：
  • bbPress » Documentation
  • bbPulp 追加 — wiki。個人サイトかな？
• プラグイン： bbPress plugin browser
• テーマ： 公式な配布サイトはないっぽい。
  • ドキュメント： bbPress » Themes and Templates

設置方法

注

• s206 サーバのデフォルト文字コードは EUC-JP。bbPress を UTF-8 で設置する場合、今のところ次の 2つの設定だけで文字化けは見られない。
  • DB は UNICODE で作成済み、Mediawiki で使用中（共用）。
  • config.php で define('BBDB_CHARSET', 'utf8'); （デフォルト）
• インストール画面を日本語化するには、「手順 8」を「手順 3」の段階で行なう。
  • 現在設置してあるフォーラム は、その手順で行なったもの。最初の自動投稿も日本語になる。
  • インストール画面が分かりやすくなってよいが、うちではパスワード等の通知メールの日本語が文字化けしてしまった。調査せねば。。

手順

1. 配布元よりダウンロードし、解凍。
2. config-sample.php ファイルを config.php として複製、次の項目を自分の環境に合わせて書き換える。
   • WordPress のような項目のほか、フォーラムの URI・フォーラム名・時差などもここで設定。
   • Akismet の Key もここに入力。
3. 全てのファイルをサーバへアップロード。public_html/forums ディレクトリに置くことにした。
   • インストーラも日本語化するなら、下記「8. 日本語化」をここで実行。
4. XREA の自動広告挿入を停止するため、.htaccess に LayoutIgnoreURI * を書いて、forums ディレクトリ直下へアップロード。
5. ブラウザで http://bono.s206.xrea.com/forums/bb-admin/install.php へアクセスし、指示どおりに実行。
   • 入力項目：
     • 管理者アカウント — ユーザ名は管理画面からは変更不可
     • 一つめのフォーラム名 — 後から管理画面で変更可
   • 2ステップ目へのボタンをクリックした途端にテーブルが作られてインストール完了。
6. 念のため install.php, upgrade.php を削除。
7. フォーラムの表示や管理画面を一通り見回ってみる。
8. 日本語化
   1. 日本語化ファイル配布元より、本体に合うバージョンのファイルをダウンロード。ja.mo は必須。自分でアレンジするなら ja.po も。
   2. config.php で define('BBLANG', 'ja'); を指定して再アップロード
   3. bb-includes/languages ディレクトリを作り、ja.mo をアップロード（バイナリモード）。
9. 日本語でテスト書き込みを行い、DB に格納されたデータが文字化けしていないことを phpMyAdmin で確認。
10. XREA の広告用コードを herder.php に挿入。

備考：

• 時差の設定が効いていない気がする。。ユーザの登録日時だけか、投稿もか、サーバのせいなのかとか後で調べる。
• config.php の詳細、スクリーンショットなどは後日。
• 機能・設定・カスタマイズについては、別記事にて。