# Paid Memberships Pro - Register Helper Add On

`meteorgpl-plugin/pmpro-register-helper` — a WordPress plugin as a Composer package.

Add custom form fields to membership checkout and user profiles with Paid Memberships Pro.

- Author: Paid Memberships Pro — https://www.paidmembershipspro.com
- Homepage: https://www.paidmembershipspro.com/add-ons/pmpro-register-helper-add-checkout-and-profile-fields/
- License: not declared
- Buy a license from the vendor: https://www.paidmembershipspro.com/add-ons/pmpro-register-helper-add-checkout-and-profile-fields/
- Page: https://meteorgpl.com/packages/meteorgpl-plugin/pmpro-register-helper
- Requires WordPress: 4.0
- Tested up to WordPress: 5.5
- Translations: fr_FR
- Vendor: Paid Memberships Pro — https://meteorgpl.com/vendors/paidmembershipspro.com

## About

Collect custom form fields at membership checkout and on the user profile. User fields can be added to the membership checkout page or captured on the user's frontend profile or "Edit Profile" screen in the WordPress admin.

This plugin also allows you to restrict membership registration for a list of approved email addresses or usernames.

[Read the full documentation for the Register Helper Add On](https://www.paidmembershipspro.com/add-ons/pmpro-register-helper-add-checkout-and-profile-fields/)

= Official Paid Memberships Pro Add On =

This is an official Add On for [Paid Memberships Pro](https://www.paidmembershipspro.com), the most complete member management and membership subscriptions plugin for WordPress.

= Supports Multiple Field Types =
Using Register Helper, you can add a variety of field types to capture additional information about your members. Fields can be customized by the member's selected or active membership level. Supported field types include:

* Text and Textarea
* Select and Select2 (multi-select)
* Checkbox, Grouped Checkboxes, and Radio Select
* Date
* File Upload
* Read-only
* HTML (generates any desired HTML)
* Hidden

Any registered field can be a conditional field. These fields use JavaScript to dynamically hide or show based on another field's value.

[Read the documentation on Adding Fields](https://www.paidmembershipspro.com/documentation/register-helper-documentation/adding-fields/)

= Adding Fields to Membership Checkout =
Register Helper allows you to add fields to a variety of places within the Membership Checkout page using Paid Memberships Pro. Fields can be added to existing locations including:

* after_username
* after_password
* after_email
* after_captcha
* after_billing_fields
* before_submit_button

If you would like to add fields to the profile only, specify the 'just_profile' location.

= Adding New Sections to Membership Checkout =
You can add a new box or 'section' to the Membership Checkout form using the 'checkout_boxes' feature. Your newly created box includes a title, description and specified location.

[Read the documentation on Checkout Boxes](https://www.paidmembershipspro.com/documentation/register-helper-documentation/adding-fields/#checkout-boxes)

= Restrict Membership Checkout by Email Address or Username =
Add your list of custom "approved" email addresses or usernames to the "Restrict by Email" or "Restrict by Username" field on the Memberships > Settings > Membership Levels > Edit Level admin page.

## Changelog

### 1.7 — 2020-10-14

* ENHANCEMENT: Files can now be deleted by setting the "allow_delete" field attribute.
* ENHANCEMENT: Images submitted through the "file" field can now be previewed.
* ENHANCEMENT: Added function to collect information saved in the "wp_users" table.
* ENHANCEMENT: Membership managers can now see admin only fields.
* BUG FIX/ENHANCEMENT: Class "pmpro_required" now being added to required fields.
* BUG FIX/ENHANCEMENT: "Required" asterisks are now being added by the core PMPro plugin.
* BUG FIX/ENHANCEMENT: Checkout box descriptions are now being shown on frontend profile.
* BUG FIX: Fixed issue where fields would be required even if they are not visible on checkout page.
* BUG FIX: select2 and checkbox_grouped fields will now successfully save when empty.
* BUG FIX: Fields depending on checkbox_grouped value will now show/hide as expected.
* BUG FIX: Line breaks will now be preserved in textareas.
* BUG FIX: Fixed issue where "0" in text field would not pass required check.

### 1.6.1 — 2020-04-30

* BUG FIX: Fixed warning shown for PMPro versions < 2.3

### 1.6 — 2020-04-27

* BUG FIX: Fixed issue with checkbox fields readonly attribute.
* BUG FIX: Adjusted images to ensure their encoding is correct.
* BUG FIX/ENHANCEMENT: Improved CSS for custom fields at checkout.
* ENHANCEMENT: Removed "profile_only" legacy conditional check. (Thanks, @wiethkaty)
* ENHANCEMENT: Support Paid Memberships Pro v2.3+ front-end profile edit page.
* ENHANCEMENT: Update select2.js to latest distributed version. Improves integration with other plugins/themes that may also include select2.js
* ENHANCEMENT: Removed unused assets.
* ENHANCEMENT: Added classes to radio buttons, grouped check boxes and hidden fields. These now support "class" => "my-class" attribute when creating these fields.
* ENHANCEMENT: Make "The X field is required" error message translatable.
* ENHANCEMENT: Added 'pmpro-required' class to custom fields, this improves error handling and will highlight fields when there is a problem with them at checkout.

### 1.5 — 2019-11-22

* FEATURE: Added number fields. (Thanks, William Crandell)
* BUG FIX: Fixed issue where date fields could save values off by one month when using WP 5.3+.
* BUG FIX: Avoiding warnings when using 2Checkout.
* BUG FIX: Now properly wrapping checkoutbox list items in a ul tag.
* ENHANCEMENT: Fixed integration with the GoURL Bitcoin Payment Gateway Add On
* ENHANCEMENT: Fixed integration with the Payfast Payment Gateway Add On
* ENHANCEMENT: Added support for Multiple Memberships per User. Fields with levels parameters will show at checkout if ANY of those levels are included at checkout.
* ENHANCEMENT: Fixed placeholders when used in select2 elements.

### 1.4

* BUG FIX: Some required fields could be left empty at checkout.
* BUG FIX: Required File Upload was not recognized. (Thanks, contemplate on GitHub)
* BUG FIX: Slight fix for already uploaded docs. (Thanks, contemplate on GitHub)
* BUG FIX: Leading zeros were being removed from numeric values.
* BUG FIX: RH Field CSV export failure under PHP7.
* BUG FIX: Removed redundant  tag. (Thanks, jbruggeling on GitHub)
* BUG FIX: Fixed issue where 0 valued options were not being selected in dropdowns, multiselects, and radio fields.
* ENHANCEMENT: Improved display of field elements and checkout boxes for compatibility for 1.9.4.
* ENHANCEMENT: Improved UI of the checkbox_grouped field type.
* ENHANCEMENT: Added French translation files. (Thanks, Alfonso Sánchez Uzábal)

Full changelog: https://meteorgpl.com/packages/meteorgpl-plugin/pmpro-register-helper/changelog

## Install

```sh
composer config repositories.meteorgpl composer https://composer.meteorgpl.com
composer require meteorgpl-plugin/pmpro-register-helper
```

The repository needs a token (see https://meteorgpl.com/docs). The vendor's license checks are intact: activate the plugin in WordPress with a key bought from the vendor.

## Versions

No version has been published yet.

