All posts by andrea

On custom field types

With BP Profile Search 4.7.5 the selection of search modes moved to the individual field level, partially breaking support for custom profile field types (CPFT).

Version 4.7.8 introduces a new and much simpler interface for CPFT, see the new Custom Field Types page.

The old and now buggy interface will be kept until the end of this year, then will be promptly removed to streamline the code. I hope that the simplicity of the new interface will enable all the CPFT developers to switch quickly, and of course I am available if you have questions or suggestions (please use my Contact page).

BP Profile Search 4.7

BP Profile Search version 4.7 allows you to sort your search results using profile fields, adding those options to the Order By drop-down in the search results page.

As you may recall, the ability to build a custom search results page with the [bps_directory] shortcode was added in version 4.1. Now that shortcode accepts a new attribute:

[bps_directory order_by=field_xyz]

where xyz is the id of the profile field you wish to use. For instance, if you have a profile field City with id 35, and a field Graduation Date with id 12, the shortcode:

[bps_directory order_by=field_35]

adds the option City to the Order By drop-down.

When a visitor selects City from the Order By drop-down, the directory (or the search results if a search is active) will be sorted by city, ascending. At the same time, the value of the City field will be displayed in each member’s entry.

The sort direction is asc (ascending) by default, but you can specify desc (descending) or both (both directions). For instance the shortcode:

[bps_directory order_by='field_35 both, field_12 desc']

adds the options City ⇡, City ⇣ and Graduation Date to the Order By drop-down. When a visitor selects Graduation Date from the Order By drop-down, the directory (or the search results if a search is active) will be sorted by graduation date, descending. If they select City ⇡ or City ⇣, the directory will be ordered by city, respectively ascending or descending.

For a complete overview of the [bps_directory] shortcode, see the Custom Directories tutorial.

BP Profile Search 4.3

BP Profile Search 4.2, released on April 19th, introduced the form templates. BP Profile Search 4.3, released today, modifies (slightly) the template structure to add support for certain custom profile field types.

Unfortunately, if you modified a 4.2 template to customize it, your modified template won’t work well with version 4.3. You have two choices:

1. Edit your template and update it to the 4.3 template structure;

2. Or, if you prefer, reapply to a 4.3 template the changes you made to the 4.2 template.

I’m sorry for the extra work you’ll have to do, but I wasn’t able to preserve the compatibility with older templates.

I’ve also updated the documentation for custom field types authors, that has been affected by the introduction of templates.

If you are a developer and create custom field types, please have a look at the new documentation that explains all the currently supported hooks. Please note that old hooks not mentioned in the current documentation don’t work anymore or, if they are working, they are deprecated and will be removed in a future plugin version.

Support Options

I provide free support for my WordPress plugins both on the WordPress site and here on

Most of the times I’m able to help you without looking at your site, but sometimes I need to have a look at your installation to understand and fix the problem you are reporting.

Only in those few cases, I’ll let you know that I need a WordPress admin and an FTP access to your site. You can privately send the access credentials to my email address

If, when requested, you prefer not to send me your site’s access credentials, you can build a disposable test site, even on a free hosting, that displays the same problem as your main site. Then you can send me the access credentials of your test site instead of those of your main site.

Please note that the WordPress support forum policy does not allow a plugin author to access a user’s site, so if you are willing to grant me access if necessary, please use the support forums here on

BP Profile Search 4.0

BP Profile Search version 4.0 brings a much requested feature, that is support for multiple forms.

You can define any number of search forms and, as usual, you can display them in a widget, or in the Members Directory page, or in any post or page using a shortcode.

Other improvements are the ability to export and import forms, and the ability to choose the form method attribute, POST or GET.

If you choose GET, the form data are sent as URL variables and users can bookmark the results page; if you choose POST, the form data are not visible in the URL and it’s not possible to bookmark the results page.

Please note that version 4 is not compatible with version 3.

After you first upgrade to version 4, you have to reconfigure your BP Profile Search forms and widgets, and modify any BP Profile Search shortcodes and do_action codes you are using.

In a multisite installation, you’ll find the BP Profile Search settings page in the individual Site Admin(s), and no longer in the Network Admin.

BP Profile Search 3.6

I’ve just released BP Profile Search 3.6. My plan for this version was to remove the limitation of having only one Age Range Search and one Value Range Search option.

That change required a new settings UI, and the new UI also happens to allow the customization of the field label and description, and the reordering of the form fields.

This version also features a Help section, and two updated translations: Russian (thanks to Ivan Dyakov) and Italian.

If you have feature requests for the next version, this is the time to submit them (please use the Support Forum).

BP Profile Search 3.5

BP Profile Search 3.5 is now available.

Version 3.5 features a new option to automatically add your search form to your Members Directory page, so you won’t have to modify your theme any more.

Additionally, a few bugs in multisite installations have been fixed and the plugin is now ready for localization.

If you prepare a translation file for your language, please let me know. I’ll include it in the official plugin distribution, with acknowledgment of your work.

Please note that version 3.5 requires BuddyPress 1.8 or higher. The new option won’t work with earlier BuddyPress versions.

BP Profile Search 3.4

Version 3.4 adds the Value Range Search feature. The new code was contributed by Florian Shießl (thanks Florian) and lets you perform a value range search in a chosen numeric field.

An application suggested by Florian is a simple proximity search based on zip/postal code values. If your chosen field contains a numeric zip/postal code, you can perform a search for a range of zip codes containing yours, and you’ll get a list of BuddyPress members with a zip code numerically close to yours.

Of course you can find many more applications. Enjoy!