Add a separator line of text in the registration form (wpmem_register_form_rows version)

Yes, that would be the filter I would start with. I’m guessing that if you are only concerned with the custom fields, you are probably also only concerned with the labels for the fields.

If you take a look at the documentation for this filter, you can just filter the elements you need to. Note that the labels all contain the HTML markup as well as the label.

Hope this helps get you started.

Yes – there are filters for most (if not all) of the dialogs. Some of the older filters are a little more tricky because they receive a string of the HTML output together with the actual message. However, in most cases, I have been able to add filters that come before these that provide an array of all the parts (so that the message part can be edited directly).

With the exception of the login failed message, I think every message goes through the wpmem_inc_regmessage() function in the wp-members-dialogs.php file. In this function there is a filter – wpmem_msg_dialog_arr – that receives an array of the message parts. This array includes two keys that you’ll want to use in your filter function.

The first is “toggles”. This array key will tell you what message is being displayed (if it is one of the defaults). Note that the toggle is not a requirement because all messages come through this filter. So in the case of a custom error, the toggle may be “other”. But all of the default messages editable in the plugin’s settings are one of the toggle values.

The other key is “msg”. This array key contains the dialog message as a string. This is what you will want to change for the return value.

Similar to this is the login failed message, which only handles the failed login error message. There is a filter that contains all the message parts in an array. The filter is wpmem_login_failed_args and I have not documented it fully yet. But you can look at what the pieces are in the wpmem_inc_loginfailed() function in wp-members-dialogs.php. The two keys you’ll want to filter are “heading” and “message” which contain strings for the message.

The sidebar failed login has its own filter and does not yet have one of these “array filters” – the message is a string of the HTML plus the message. But it is documented here.

Hope this helps get you started. Let me know if you need more direction/clarification.

To answer the question “Is there was a way to create multiple separators with this code snippet?” – Yes. You can add additional blocks within the loop.

I understand that can be complicated if you don’t know what you’re doing. But it was the best option when I wrote this article originally.

Now, however, there’s a new API function in the plugin that actually makes this process easier. I will need to rewrite the article to take advantage of this.

The API function wpmem_array_insert() allows you to insert an array element into an existing array either before or after a specific key. There’s no need to loop through the array and rebuild it, no need for complicated if/then statements in the loop.

wpmem_array_insert() works like this: You give it the array you want to insert something into (in the case, $rows), the item you want to insert (which in this example is “$new_row”), and the array key in the original array that you want to insert the new item after.

The example from the article using wpmem_array_insert() instead could be done like this:

add_filter( 'wpmem_register_form_rows', 'my_field_separator_alternate', 10, 2 );
function my_field_separator_alternate( $rows, $toggle ) {
	
	// put together an array for the heading/separator that 
	// includes *all* of the possible keys so that you don't
	// get errors. Any keys you don't use should be empty ('')
	$new_rows['address_heading'] = array(
		'order' => '',
		'meta' => '',
		'type' => '',
		'value' => '',
		'row_before' => '',
		'label' => '<label class="text"></label>',
		'field_before' => '<div class="div_text">',
		'field' => '<h3>Please include your address information</h3>',
		'field_after' => '</div>',
		'row_after' => ''
	); // end of address_heading row array
	
	// Insert new row into existing rows after "last_name"
	$rows = wpmem_array_insert( $rows, $new_rows, 'last_name' );
	
	return $rows;
}

(Note I simplified a little farther by putting the heading directly in the array – in the previous example is was in a variable so it would be set apart to be a little more obvious. But if you do multiple headings, it’s probably easier to just put it directly in the ‘field’ key for simplification.)

So here’s an example with an additional heading using this process. Basically, the things you need to change as you add additional elements are the array key (i.e. $new_row[‘address_heading’] and $new_row[‘my_other_heading’]), the heading you have in the ‘label’ key, and lastly, the key that you’ll insert the item into the $rows array after (in this example, ‘last_name’ and ‘some_other_key’).

add_filter( 'wpmem_register_form_rows', 'my_field_separator_alternate', 10, 2 );
function my_field_separator_alternate( $rows, $toggle ) {
	
	$new_row['address_heading'] = array(
		'order' => '',
		'meta' => '',
		'type' => '',
		'value' => '',
		'row_before' => '',
		'label' => '<label class="text"></label>',
		'field_before' => '<div class="div_text">',
		'field' => '<h3>Please include your address information</h3>',
		'field_after' => '</div>',
		'row_after' => ''
	);
	$rows = wpmem_array_insert( $rows, $new_row, 'last_name' );
	
	
	$new_row['my_other_heading'] = array(
		'order' => '',
		'meta' => '',
		'type' => '',
		'value' => '',
		'row_before' => '',
		'label' => '<label class="text"></label>',
		'field_before' => '<div class="div_text">',
		'field' => '<h3>Please include the following information</h3>',
		'field_after' => '</div>',
		'row_after' => ''
	);
	$rows = wpmem_array_insert( $rows, $new_row, 'some_other_key' );	
	
	
	return $rows;
}

Hope that makes sense and makes it easier for you.