Selectable xProfile Sign-up Fields in 8.0.0

Until now, only the Primary group of xProfile fields was displayed on the registration form of your community. 8.0.0 gives you the freedom to choose any field from any field group to add to your site’s registration form.

Default behavior

On a fresh & new install, the “Profile Details” section of the sign-up form will only include the Name field of the Primary xProfile field group.

If you upgraded BuddyPress from a previous version, the fields you included into the Primary xProfile field group will all be used as the default ones into the “Profile Details” section of the sign-up form.

On the right, the “Profile Details” section of the sign-up form.

Manage xProfile Sign-up Fields

To manage the fields to use into the “Profile Details” section of your sign-up form, head over to the Users > Profile Fields Administration screen. You’ll discover a new tab named “Signup fields” at the last position of the xProfile Groups navigation.

The Signup Fields type into the Profile Fields Administration screen

Once you activate this tab and just under it, you’ll find a message explaining how to use drag and drop to pick the fields you want to use into the sign-up form. You can select any fields from any other xProfile field groups.

Drag and drop the fields of your choice into the Signup form.

There’s another way to add fields to the sign-up form thanks to a specific metabox into the xProfile single Field edit screen.

The Signups xProfile Field edit screen metabox

You can also activate the Signups metabox checkbox to include a field into the registration form.

Signup fields are added the ones under the others. If you need to change this order, you can do it at any time using drag and drop inside the Signup Fields tabbed area.

Moving the “My Story” field before the “Website” one.

Finally, If you need to remove a field from the signup form, you can do it using the corresponding “Remove” link (displayed at the bottom right of the Field’s box) into this tabbed area or from the xProfile single Field edit screen deactivating the Signups metabox checkbox.

Feel free to read the story of this feature on our Trac to know more about how it was built.

👉 BuddyPress theme designers / advanced users

If your theme uses a custom buddypress/members/register.php template, please make sure to update it so that it uses the new way of building arguments in order to make the xProfile loop fetch the Signup fields.

bp_has_profile( bp_xprofile_signup_args() );

Please, consider testing BuddyPress 8.0.0 pre-releases to make sure everything’s fine for your specific configurations.

End users, don’t worry: if they forgot to do so when BuddyPress 8.0.0 is released, the back compatibility mechanism we’ve put in place will make sure you can enjoy this new feature.

Watch the demo!

#8-0-0, #signup, #xprofile

New xProfile Field Type – Checkbox Acceptance will be introduced in BuddyPress 8.0.0

The BuddyPress xProfile component gives you the power to create as many profile fields as you wish quickly and to organize these fields into groups of fields. An important step when creating a new profile field is to select the Field Type that best suits your need to display the information.

The Checkbox Acceptance field type is a new type of field we will introduce into our next major release (8.0.0). Thanks to it you’ll be able to easily create a new field to manage the Terms of Service of your site (which is often mandatory nowadays to follow compliance) or any other acceptance page (eg: code of conduct, good behavior rules, etc…). As it’s a profile field, it’s very easy to include it into your registration form to be sure to have your new members to agree to your linked acceptance page.

Adding a new field using the Checkbox Acceptance type.

When you’ll create a new xProfile field once you upgraded to BuddyPress 8.0.0, you will find a new field type option – Checkbox Acceptance.

Checkbox Acceptance field option

After selecting the Acceptance field, you can map your terms of service page to field options and include it into your registration form using the checkbox of the new Signup metabox (also introduced in 8.0.0).

Select your Terms of Service page to Checkbox Acceptance field

Save your profile field, and log out to preview the result on your registration page.

Checkbox Acceptance field view at register page.

It will be visible as in the above screenshot, mapped terms & condition page link on the register page with checkbox. Of course, new users will be able to click on the “Terms and conditions” link to aknowledge it.

Checkbox Acceptance field view for existing users.

Existing members can also agree to your acceptance page. Tell them to log in and visit their edit profile screen to submit their Acceptance from there. Once submitted, it will be a read-only field; members can not uncheck the value for the Acceptance field.

The acceptance field will only be visible to the logged-in member (viewing their self profile) and the admin. It will not be visible to members visiting any other one’s profile.

Checkbox Acceptance field view at own profile

Watch the demo!

The video below will show you how to create a new Acceptance field

Please read the full story about this new xProfile field type, head over to this ticket on our Trac environment.

#8-0-0, #xprofile

2 new xProfile Field types will be introduced in BuddyPress 8.0.0

The BuddyPress xProfile component gives you the power to easily create as many profile fields as you wish and to organize these fields into groups of fields. So far there was only one field which was linked to an existing WordPress user field : the base Name field. This field’s data is synchronized with the WordPress user display name (unless you opt out this synchronization from the BuddyPress Options Administration screen).

• 

• 

WP xProfile field types are arriving!

In BuddyPress 8.0.0, you’ll have the extra power to include other WordPress fields into the xProfile groups of fields. This time, unlike what we’re doing for the Name field, we are not duplicating and synchronizing field values between the WordPress user field tables (the wp_users & the wp_usermeta ones) and the BuddyPress xProfile data table). Instead we are directly using the WordPress user field values.

Creating these new field types, we’ve also improved our xProfile field API so that you can now have more control about the features your custom type of field can support.

/**
 * Custom xProfile field type.
 */
class Custom_XProfile_Field_Type extends BP_XProfile_Field_Type {

	/**
	 * This property enforces Field's default visibility.
	 */
	public $visibility = 'public';

	/**
	 * Supported features for the WordPress field type.
	 */
	public static $supported_features = array(
		'required'                => false,
		'do_autolink'             => false,
		'allow_custom_visibility' => false,
		'member_types'            => false,
	);
}

Using the static $supported_features property, you can disable the corresponding features meta boxes from the xProfile Administration Screen. The above example is showing the supported features by the WordPress fields : as defined by WordPress, these fields cannot be made required, cannot have their visibility changed for something different than public and cannot be restricted to a member type. Below are the values used by default for any xProfile field type.

A regular xProfile field can be made required, can be restricted to a specific member type, can be set to let members define the field data visibility and can be auto linked to a members search request about the field value.

1. wp-biography

The first type is specially designed to let you include the biographical information of the user into the group of xProfile fields of your choice.

• 

• 

Your members can now directly edit their biographical information from their front-end profile.

2. wp-textbox

Using this type of field, you can insert the first name, the last name, the website URL and the potential WordPress User Contact Methods you added. Once you created your wp-textbox field, you’ll just need to use the advanced meta box below the field’s description textarea to select the information to include into the group of fields of your choice.

Watch the demo!

The video below will show you how to create a new field to add/edit the Member’s website URL and the Biographical information directly from their front-end profile.

If you want to read the full story about these new xProfile field types, head over to this ticket on our Trac environment.

#8-0-0, #wordpress, #xprofile