Enable bbPress for Block Themes

描述

Enables bbPress for a full site editing WordPress block theme, fixing WSoD (White Screen of Death).

What problem does it solve?

Do you want to use bbPress plugin, but it does not display on your website?
Do you see WSoD when visiting bbPress forum pages?
Do you want to edit bbPress templates?
Are you using a full site editing WordPress block theme?

If you answered yes to these questions, you’re in luck.

Enable bbPress for Block Themes plugin fixes White Screen of Death for bbPress screens/views when you are using a WordPress block theme.

What the plugin does not do?

  • Plugin does not provide CSS styles for bbPress to look good with your theme.

    Design is very specific thing to each theme. If you want to style your bbPress appearance, use custom CSS code in Styles section of Site Editor, or use other means, such as 3rd party plugins.

    You may especially need to style form fields, buttons and pagination.

  • Plugin does not provide blocks to tweak bbPress views to your liking.

    bbPress plugin contains no blocks you can use to create custom forum layouts (as of February 2025).

    However, in Site Editor you can edit “bbPress content” template. This template is used to display all bbPress content. (If you enable block editor for bbPress post types, you can further edit additional templates.)

Got a question or suggestion?

In case of any question or suggestion regarding this plugin, feel free to ask at support section, or at GitHub repository issues.

屏幕截图

  • bbPress forums archive: before and after. Using Twenty Twenty-Five theme.

安装

First you need to install and activate bbPress plugin, and use a block theme, such as Twenty Twenty-Five.

Automatic installation:

  1. Navigate to Plugins Add New Plugin and search for Enable bbPress for Block Themes.
  2. Once the plugin is displayed in the list, click the “Install Now” button, then “Activate” button.

Manual installation:

  1. Download the plugin to your computer.
  2. Then unzip Enable bbPress for Block Themes plugin download file and upload enable-bbp-block-theme folder into the …/wp-content/plugins/ directory on your website server.
  3. Activate the plugin through the Plugins menu in WordPress admin area.

Plugin works immediately after activation.
Additionally, you can enable block editor for bbPress post types in Settings Forums “Block Theme Compatibility” section.

常见问题

How does it work?

First, this plugin works only if:
– you are using a block theme,
– and bbPress plugin is active.

The plugin modifies template hierarchy for bbPress content, adding compatibility with block themes. It also fixes bbPress content display in Post Content block.

Plugin also provides “bbPress content” template you can edit in Site Editor. (Make sure to use Post Content block in the template as bbPress uses it for displaying its views. Even for bbPress archives!)
By default bbPress uses your theme’s Page template to display its content. However, providing this new “bbPress content” template is adding a new layer of flexibility.

It also allows enabling block editor for bbPress post types, for additional modifications to bbPress templates in Site Editor.

bbPress looks ugly, help!

Design is very specific thing to each theme. Please understand this plugin does not provide any CSS styles for bbPress.

If you want to style your bbPress appearance, use custom CSS code in Styles section of Site Editor, or use other means, such as 3rd party plugins.

You may especially need to style form fields, buttons and pagination.

Tip: If you want to make bbPress content different width from the other content on your website, you can either edit “bbPress content” template in Site Editor, or apply this custom CSS: .bbpress { --wp--style--global--content-size: 45rem; }.

Are there any blocks I can use?

No, this plugin does not provide any blocks.

As of February 2025, bbPress plugin does not provide any blocks either, but you can use its shortcodes in Shortcode block.

Can I edit bbPress template?

Yes. The plugin provides dedicated “bbPress content” template in Site Editor.

This template displays all bbPress content and is derived from your theme’s Page template. You can modify it to provide dedicated bbPress views without affecting your pages.

(Make sure to use Post Content block in the template as bbPress uses it for displaying its views. Even for bbPress archives!)

Additionally, after enabling block editor for bbPress post types in Settings Forums “Block Theme Compatibility” section of your WordPress admin, you can modify other bbPress templates in Site Editor.

Where can I find options?

Settings Forums “Block Theme Compatibility” section in your WordPress admin.

In plugin options you can enable block editor for bbPress post types, which allows tweaking bbPress content templates in Site Editor.

评价

2025 年 7 月 25 日 1 回复
A lightweight pluginWith low memory and resource consumptionVery useful featuresThank you very much
2025 年 5 月 10 日 3 回复
first time I can use bbpress with fse theme (twenty twenty five) without any issue. bbp style pack plugin work so bad with me. this is just simple and looks so good. ty.
阅读所有2条评价

贡献者及开发者

「Enable bbPress for Block Themes」是开源软件。 以下人员对此插件做出了贡献。

贡献者

「Enable bbPress for Block Themes」插件已被翻译至 1 种本地化语言。 感谢所有译者为本插件所做的贡献。

帮助将「Enable bbPress for Block Themes」翻译成简体中文。

对开发感兴趣吗?

您可以浏览代码,查看SVN仓库,或通过RSS订阅开发日志

更新日志

Please see the changelog.md file for details.