bbPress.org

OBSERVED BEHAVIOUR:

In Installation Step 3, the ‘”Key Master” Username’ is a text entry box, with no pre-populated values.

EXPECTED BEHAVIOUR:

The ‘”Key Master” Username’ should be a drop-list, with the admin IDs of the primary blog in it.

DETAILS

When integrating with an MU site, Step 2 asks for the WordPress Primary Blog ID.

In step 3, the install program uses the value entered to find administrators for the specified blog. The function populate_keymaster_user_login_from_user_tables concatenates the database prefix, the blog ID specified, and the constant ‘_capabilities’. For example, if the prefix is ‘wp_’ and blog ID is 1, you get ‘wp_1_capabilities’.

There’s only one problem with this. When you install WordPress, you have to complete the standard installation, and then reconfigure it to be a multi-site blog. For the standard installation, the first blog does not contain the numeric ID, and neither does the capabilities meta_key – it is simply ‘wp_capabilities’.

SUGGESTED FIX:

In Step 2, the pop-up help text for the “WordPress MU primary blog ID” field states:

“If you are integrating with a WordPress MU site you need to specify the primary blog ID for that site. It is usually 1. You should probably leave this blank if you are integrating with a standard WordPress site.”

Change the wording, to more accurately reflect what needs to be entered:

“If you are integrating with a WordPress MU site, you need to specify the primary blog ID for that site. If you have changed the primary site, enter the site ID. You should probably leave this blank if you have not changed the primary site, or if you are integrating with a standard WordPress site.”