Custom fields

Since RSMembership! revision 11 a new key feature has been introduced: possibility to add custom fields to your membership subscription form.

The subscription process still relies on some core fields that can't be removed: name and email. This information is a key part in creating a user to a assign the membership if required.

Besides the above mentioned fields you can now add as many fields you like, using the Custom fields tab. Adding or editing the already existing fields is an easy process - just click New or Edit and the field configuration will be displayed (as it can be seen below).


Available options:

  • Custom Field Name: the name of the actual field. This is used for internal reference only and it will not be displayed in the front-end.
  • Label: the label/caption of the field - this value will be displayed on the front-end.
  • Type: Custom HTML (can be used add text or any HTML) / Text box / Text area / Filter by type / Select List / Multiple Select List / Checkbox Group / Radio Group / Calendar / Hidden field.
  • Values (*): setting this area, in the case of text box, text area, custom HTML and calendar, will display a value by default in the frontend subscription form. In the case of select list, multiple select list, checkbox group and radio group, this area will actually define the items - each item on a new line.
  • Additional Attributes: here you can add CSS properties or Javascripts.
  • Required: Yes / No.
  • Show in Subscribers area: Yes / No - set to Yes in order to show the current field in the Subscribers' tab listing.
  • Validation rule: none / alphanumeric / numeric / email / website.
  • Validation Message: this message will be displayed if the field validation will fail.
  • Published: yes / no.

The value of these fields can be used by using the placeholders. If, for example, you have a field named test, the correct placeholder would be: {test}.

The field placeholders can be used on the following areas: Messages, Subscriber Emails and Administrator Email.

 
Note:
  • After upgrading from a previous version, the previous fields will be transformed in custom fields - these can be removed at any time: address, city, state, zip and country.
  • (*) In the Values area custom PHP coding can be used, enclosed in between the following tags: //<code>,//</code>. Example (will add the current server date):
    //<code>
    return date();
    //</code>
  • If you want to translate these custom fields in another language, just open the RSMembership! language file from /languages/ and add the custom field's label in uppercase. For example: GENDER=Gender translation.
  • To pre-select an item within slect lists, radio / checkbox groups, simply add [c] to it. Example:
    item 1
    item 2[c]
Watch the video tutorial:

Ep. 56: How to customize the RSMembership! subscription form



5 persons found this article helpful.


Was this article helpful?

Yes No
Sorry about that