Skip to:
Codex HomeBuddyPress Theme Development → BP Default Theme – moving forward with BP 1.9

BP Default Theme – moving forward with BP 1.9

The BP Default theme was moved into the BP Classic backwards compatibility Add-on during the 12.0.0 BP development cycle.

Updated BP default theme usuage for BP 1.9 onwards

The BP default theme has served a hugely useful purpose in providing a true out of the box experience for users, allowing for a standard to work from either in re-skinning or for building child themes from. With the successful rollout of the ‘Theme Compatibility’ functionality in BP 1.7 a decision was made by the core development team that it was time to officially retire the default bundled theme from the core application. As of BP 1.9 users will note that the listing of the bp-default theme is removed from the WP ‘Appearance > Themes’ screens (although it will still appear if you currently use the theme)

What does this mean?

In terms of future development of the theme, this will be limited to providing critical fixes and security updates where necessary but there will be no further development on the theme template files. The theme will continue to be physically bundled in the core download for the immediate future but it is envisioned that at some point the theme files will be removed altogether and hopefully be provided as a standalone theme downloaded from the WP theme repo.

How do these changes affect current theme use?

Have no worries, if you currently use the default theme on your site things will continue to work just as before. BP has the provision to check whether bp-default is activated or whether a theme has overloaded bp-default templates to the top level of their theme and will then disable theme compatibility mode.

There is one important change in behaviour to take into account if you are currently using bp-default and you need to revert to another theme for testing you will find the option to select bp-deault has been removed, don’t panic though to ensure you can still change themes and re-select bp-default you will need to add a simple one line piece of code

add_filter( 'bp_do_register_theme_directory', '__return_true' );

Add this line to your bp-custom.php file located in the WP plugins directory ( this file does not exist by default and needs to be manually created and must begin with <?php at the very top of the file.)

Skip to toolbar