Core advanced configurations

There are many BuddyPress configuration settings that can be changed by adding a configuration definition line to a /wp-content/plugins/bp-custom.php file. You can read the previous chapter for more details about this specific file.

Profile photo configurations Profile photo configurations

Profile photo images are available in two versions: a thumb and a full version. By default the first version is a 50×50 pixels image and the second one a 150×150 pixels image. The following constants will be applied to any BuddyPress component’s items profile photo (eg: a single member or a single group).

Width of the thumb version Width of the thumb version

define( 'BP_AVATAR_THUMB_WIDTH', 50 );

Use this constant if you need the width of the thumb version to be different than 50 pixels.

Top ↑

Height of the thumb version Height of the thumb version

define( 'BP_AVATAR_THUMB_HEIGHT', 50 );

Use this constant if you need the height of the thumb version to be different than 50 pixels.

Top ↑

Width of the full version Width of the full version

define( 'BP_AVATAR_FULL_WIDTH', 150 );

Use this constant if you need the width of the full version to be different than 150 pixels.

Top ↑

Height of the full version Height of the full version

define( 'BP_AVATAR_FULL_HEIGHT', 150 );

Use this constant if you need the height of the full version to be different than 150 pixels.

Top ↑

Max width of the user submitted image file Max width of the user submitted image file

define( 'BP_AVATAR_ORIGINAL_MAX_WIDTH', 640 );

When a user uploads a profile image, it is resized to prepare it for the crop step of the process to set a user or group local profile image. By default the maximum width used during for the resize is 640 pixels. Use this constant if you need it to be different than 640 pixels.

Top ↑

Custom image to use as the default full version Custom image to use as the default full version

define( 'BP_AVATAR_DEFAULT', '://site.url/path-to-default-full/150x150.png' );

If a BuddyPress component’s item does not have a full version of a local profile photo yet, a default profile photo will be used by BuddyPress. Use this constant if you need to use another image for the full version of the default profile image.

Top ↑

Custom image to use as the default thumb version Custom image to use as the default thumb version

define( 'BP_AVATAR_DEFAULT_THUMB', '://site.url/path-to-default-thumb/50x50.png' );

If a BuddyPress component’s item does not have a thumb version of a local profile photo yet, a default profile photo will be used by BuddyPress. Use this constant if you need to use another image for the thumb version of the default profile image.

Top ↑

Ignore all deprecated code Ignore all deprecated code

define( 'BP_IGNORE_DEPRECATED', true );

When you update BuddyPress to a new version, to prevent fatal errors with plugins, themes or custom code using deprecated functions, BuddyPress is loading various files containing deprecated code. You can bypass this behavior setting the BP_IGNORE_DEPRECATED to true.

Top ↑

Specific BuddyPress configuration for WordPress multisite. Specific BuddyPress configuration for WordPress multisite.

define( 'BP_ENABLE_MULTIBLOG', true );

You can activate BuddyPress on the main site or a sub-site of a multisite network. This should reply to most people needs. If you absolutely need to “duplicate” the display on any site of the multisite network. You can use the BP_ENABLE_MULTIBLOG constant. Enabling BuddyPress content to be displayable on any site in your network can be useful when supporting multilingual versions of your site.

NB: this constant will not generate a different BuddyPress community for each site of the multisite network.