とりあえず調べた内容をメモ、表の空白は分からない部分です。bbPress は本家のサイトデザインが変わってたり、新しく 2.1 が出たりで動きはあるんだけど、ドキュメントもまだ途中っぽいしなかなか情報が見つからない。日本語の情報とかほぼ皆無、日本人は使ってないのかな…？

最終更新 : 2012.07.21

環境

• WordPress 3.4.1
• bbPress 2.1

オリジナルテーマ作成手順

以前は、functions.php にオリジナルテーマを使用することを書かなくてはいけなかったんですが、自分のテーマ内にファイルを作成するだけで認識してくれるようです。

1. テーマディレクトリ直下にplugin-bbpress.phpを作成して、フォーラム用にレイアウトを変更する。
2. wp-content/plugins/bbpress/bbp-themes/bbp-twentyten/css/bbpress.cssを自分のテーマディレクトリにコピー、読み込ませて後は編集。

   <link rel="stylesheet" href="<?php bloginfo('template_url'); ?>/bbpress.css" />
   

フォーラムで使用されるファイル

1. plugin-bbpress.php
2. bbpress.php
3. forums.php
4. forum.php
5. generic.php
6. page.php
7. single.php
8. index.php

フォーラム表示の際には上記ファイルが使われます。数字は優先順位。

各ページで使用されるファイル

各ページ毎にレイアウト等を変えたい場合などは、wp-content/plugins/bbpress/bbp-themes/bbp-twentyten内の必要な php ファイルを自分のテーマディレクトリにコピーして編集します。これらのファイルがあった場合は、plugin-bbpress.php などよりも優先で使用されます。

ファイル名	説明
archive-forum.php	フォーラム一覧ページ
archive-topic.php
page-create-topic.php	トピック作成ページ。固定ページテンプレート
page-forum-statistics.php	フォーラムの統計情報ページ。固定ページテンプレート
page-front-forums.php	フォーラム一覧ページ。固定ページテンプレート
page-front-topics.php	トピック一覧ページ。固定ページテンプレート
page-topics-no-replies.php	返信のないトピック一覧ページ。固定ページテンプレート
page-topic-tags.php	トピックタグ一覧ページ。固定ページテンプレート
page-user-login.php	ユーザーログインページ。固定ページテンプレート
page-user-lost-pass.php	パスワード忘れたページ。固定ページテンプレート
page-user-register.php	ユーザー登録ページ。固定ページテンプレート
single-forum.php	フォーラム個別ページ
single-forum-edit.php
single-reply.php	返信個別ページ
single-reply-edit.php	返信編集ページ
single-topic.php	トピック個別ページ
single-topic-edit.php	トピック編集ページ
single-topic-merge.php	トピック結合ページ
single-topic-split.php	トピック分割ページ
single-user.php	ユーザーページ
single-user-edit.php	ユーザー情報編集ページ
single-view.php
taxonomy-topic-tag.php	トピックタグページ
taxonomy-topic-tag-edit.php

bbpress ディレクトリ内ファイル

ページ内で出力される内容等を変えたい場合は、/wp-content/plugins/bbpress/bbp-themes/bbp-twentyten/bbpressディレクトリを自分のテーマディレクトリ/bbpressにコピーして編集する。

フォーラム関係

ファイル名	説明
content-archive-forum.php	フォーラム一覧表示
loop-forums.php	フォーラム一覧のループ。content-archive-forum.php から呼ばれる
loop-single-forum.php	フォーラムの内容表示。loop-forums.php から呼ばれる
content-single-forum.php	フォーラムの個別表示

トピック関係

ファイル名	説明
content-archive-topic.php	トピック一覧（タグでの表示時など）
loop-topics.php	トピック一覧のループ。content-archive-topic.php から呼ばれる
loop-single-topic.php	トピックの内容表示。loop-topics.php から呼ばれる
content-single-topic.php	トピックの個別表示
content-single-topic-lead.php

返信関係

ファイル名	説明
loop-replies.php	返信ループ
loop-single-reply.php	返信の内容表示。loop-replies.php から呼ばれる。
content-single-reply.php

入力フォーム関係

ファイル名	説明
form-forum.php	フォーラム作成フォーム。ショートコード[bbp-forum-form]で表示される
form-topic.php	トピック作成, 編集フォーム
form-reply.php	返信作成, 返信編集フォーム
form-anonymous.php	ユーザー登録していない人が返信するときに表示する、名前やメールアドレス入力のフォームなど
form-topic-merge.php	トピック結合フォーム
form-topic-tag.php	タグ編集フォーム
form-user-login.php	ユーザーログインフォーム
form-user-register.php	ユーザー登録フォーム
form-user-lost-pass.php	パスワード忘れた！のフォーム
form-user-edit.php	ユーザー情報編集フォーム
form-topic-split.php	トピック分割フォーム、トピック内の返信を新たな「トピック」として分割するときのフォーム。
form-protected.php

ユーザー関係

ファイル名	説明
content-single-user.php	ユーザー個別表示
user-details.php	ユーザー情報
user-subscriptions.php	ユーザーが購読しているトピック
user-favorites.php	ユーザーのお気に入りトピック
user-topics-created.php	ユーザーが作成したトピックス
content-single-user-edit.php	ユーザー情報の編集

ページネーション関係

ファイル名	説明
pagination-topics.php	トピックのページ遷移
pagination-replies.php	返信のページ遷移

タグ関係

ファイル名	説明
content-topic-tag-edit.php	タグの編集ページ

その他

ファイル名	説明
feedback-logged-in.php	「ログインフォーム」「登録フォーム」「パスワード忘れた」画面表示時に、すでにログイン済みの場合の表示
feedback-no-forums.php	フォーラムがなかった場合の表示
feedback-no-topics.php	トピックがなかった場合の表示
feedback-no-replies.php	返信がなかった場合の表示
feedback-no-access.php
content-single-view.php

参考

bbPress Codex · Themes and Templating