Memory Wiki

I'll start by exploring the PMPro plugin structure and running the initial checks you asked for.

Good — `pmpro-signup-shortcode` is active! Let me now explore both the PMPro plugin and the shortcode plugin.

The files are inside a Docker container — `read_file` can't reach them directly. I'll use `docker exec` to read the contents.

Now let me dig deeper into the core files.

Let me now examine the field classes and the membership shortcode that loads the checkout page.

Now let me check the checkout block and the admin settings for user fields, then check for the pmpro_pages option.

Let me check for the checkout block and also look at the pmpro_pages option more carefully to see what page IDs are set.

Let me check how the pmpro_signup shortcode handles form submission processing.

Now I have all the information. Here's the comprehensive report: --- ## PMPro Signup/Checkout Form Fields — Complete Analysis ### 1. Active Plugins (related to PMPro) | Plugin | Status | Version | |--------|--------|---------| | `paid-memberships-pro` | Active | 3.7.4 | | `pmpro-signup-shortcode` | Active | 1.2 | | `pmpro-update-manager` | Active | 1.0.1 | `pmpro_pages` option does not exist yet (PMPro pages may not have been set up via the PMPro settings wizard). --- ### 2. How the Checkout Page is Rendered The checkout page can be loaded in three ways: **A. PMPro Page Shortcode** (`[pmpro_checkout]`) - **File:** `/var/www/html/wp-content/plugins/paid-memberships-pro/includes/init.php` (line 82-95) - Function `pmpro_pages_shortcode()` dynamically handles ALL `[pmpro_*]` shortcodes including `[pmpro_checkout]` - Loads the preheader first: `preheaders/checkout.php` - Then renders the template: `pages/checkout.php` - The preheader does all the processing logic (form validation, user creation, order processing) - The template just outputs the HTML form **B. pmpro_signup Shortcode (pmpro-signup-shortcode plugin)** - **File:** `/var/www/html/wp-content/plugins/pmpro-signup-shortcode/pmpro-signup-shortcode.php` - Function `pmprosus_signup_shortcode()` (line ~200) - Registers via `add_shortcode('pmpro_signup', 'pmprosus_signup_shortcode')` - This is a **self-contained form** that renders its own fields and submits to the standard `pmpro_url("checkout")` URL - Calls `do_action('pmpro_checkout_preheader', $pmpro_level)` to trigger the standard checkout preheader processing - Supports attributes: `level`, `levels` (multi-level), `short`, `intro`, `submit_button`, `login`, `redirect`, `hidelabels`, `custom_fields`, `confirm_email`, `confirm_password`, `title` **C. Checkout Block** - `/var/www/html/wp-content/plugins/paid-memberships-pro/blocks/src/checkout-page/` --- ### 3. Form Fields — Definition and Field Names #### Core fields in `pages/checkout.php` (standard checkout template): | Section | Field Name (HTML ID/Name) | Label | Type | |---------|--------------------------|-------|------| | **Pricing Fields** | `pmpro_level` (hidden) | Membership level ID | hidden | | | `pmpro_discount_code` | Discount code | hidden/text | | | `pmpro_other_discount_code` | Discount Code | text | | **Account Information** | `username` | Username | text | | | `password` | Password | password | | | `password2` | Confirm Password | password | | | `bemail` | Email Address | email/text | | | `bconfirmemail` | Confirm Email Address | email/text | | | `fullname` (honeypot) | Full Name | text (hidden) | | **Billing Address** | `bfirstname` | First Name | text | | | `blastname` | Last Name | text | | | `baddress1` | Address 1 | text | | | `baddress2` | Address 2 | text | | | `bcity` | City | text | | | `bstate` | State | text | | | `bzipcode` | Postal Code | text | | | `bcountry` | Country | select | | | `bphone` | Phone | text | | **Payment Information** | `CardType` | Card Type | hidden | | | `AccountNumber` | Card Number | text | | | `ExpirationMonth` | Expiration Month | select | | | `ExpirationYear` | Expiration Year | select | | | `CVV` | Security Code (CVC) | text | | **Form Meta** | `pmpro_checkout_nonce` | Nonce | hidden | | | `submit-checkout` | Submit trigger | hidden | #### pmpro_signup shortcode fields (`pmpro-signup-shortcode.php`, function `pmprosus_signup_shortcode`): | Field Name | Label | Notes | |-----------|-------|-------| | `level` (hidden or select) | Membership Level | Hidden for single-level, select for multi-level | | `username` | Username | Hidden when `short='emailonly'` | | `password` | Password | Hidden when `short='emailonly'` | | `password2` | Confirm Password | Skipped when `short` or `!confirm_password` | | `bemail` | E-mail Address | Always shown | | `bconfirmemail` | Confirm E-mail | Skipped when `short` or `!confirm_email` | | `fullname` (honeypot) | Full Name | Hidden | | `pmprosus_referrer` | Referrer URL | Hidden | | `redirect_to` | Redirect after signup | Hidden | | `pmpro_signup_shortcode` | Flag | Hidden, value `1` | | `submit-checkout` | Submit trigger | Hidden | --- ### 4. Action Hooks for Adding Custom Fields These hooks are fired inside `pages/checkout.php` (standard checkout template): | Hook Name | Position in Form | When it fires | |-----------|-----------------|---------------| | `pmpro_checkout_before_form` | Before `<form>` tag | With `$pmpro_level` param | | `pmpro_checkout_after_level_cost` | After pricing cost display | With `$pmpro_level` param | | `pmpro_checkout_after_pricing_fields` | After pricing section | With `$pmpro_level` param | | `pmpro_checkout_after_username` | After username field | No params | | `pmpro_checkout_after_password` | After password field | No params | | `pmpro_checkout_after_email` | After email field | No params | | `pmpro_checkout_after_user_fields` | After account info section | No params | | `pmpro_checkout_boxes` | After user fields, before billing | With `$pmpro_level` param | | `pmpro_checkout_after_billing_fields` | After billing address | No params | | `pmpro_checkout_after_payment_information_fields` | After payment info | With `$pmpro_level` param | | `pmpro_checkout_before_submit_button` | Before submit button | With `$pmpro_level` param | | `pmpro_checkout_after_form` | After closing `</form>` | With `$pmpro_level` param | The pmpro_signup shortcode fires these additional hooks: | Hook Name | Position | |-----------|----------| | `pmpro_signup_form_before_fields` | Before field wrapper | | `pmpro_signup_form_before_submit` | Before submit button (inside fields wrapper) | | `pmpro_signup_form_after_submit` | After submit button | | `pmpro_signup_form_after_form` | After closing `</form>` | --- ### 5. Custom Fields System (PMPro 3.4+) #### Architecture **Files:** - `/var/www/html/wp-content/plugins/paid-memberships-pro/classes/class-pmpro-field.php` — `PMPro_Field` class (1960 lines) - `/var/www/html/wp-content/plugins/paid-memberships-pro/classes/class-pmpro-field-group.php` — `PMPro_Field_Group` class (557 lines) - `/var/www/html/wp-content/plugins/paid-memberships-pro/includes/fields.php` — Functions for field management (1243 lines) **Key Classes:** - `PMPro_Field` — Represents a single field with properties: `name`, `type`, `label`, `required`, `hint`, `levels`, `profile`, `options`, `class`, `divclass`, `meta_key`, `showmainlabel`, `showrequired` - `PMPro_Field_Group` — Groups fields together. Supports methods: `add()`, `get()`, `get_all()`, `get_field()`, `add_field()`, `display()`, `save_fields()`, `get_fields_to_display()` **Field Types supported by PMPro_Field:** text, textarea, email, number, password, checkbox, checkbox_grouped, radio, select, select2, multiselect, date, file, url, phone, html, hidden #### Predefined Field Groups (where custom fields can be added) These are the `$where` locations used with `pmpro_add_user_field()`: | Group Name | Hook Location | Description | |-----------|---------------|-------------| | `after_username` | `pmpro_checkout_after_username` | Shown after username field | | `after_password` | `pmpro_checkout_after_password` | Shown after password field | | `after_email` | `pmpro_checkout_after_email` | Shown after email field | | `after_captcha` | `pmpro_checkout_before_submit_button` | Shown before submit (captcha area) | | `after_pricing_fields` | `pmpro_checkout_after_pricing_fields` | After pricing section | | `after_billing_fields` | `pmpro_checkout_after_billing_fields` | After billing section | | `before_submit_button` | `pmpro_checkout_before_submit_button` | Before submit button | | `after_tos_fields` | `pmpro_checkout_before_submit_button` (priority 6) | Before submit, after other fields | | `checkout_boxes` (and custom names) | `pmpro_checkout_boxes` | Shown as cards between user fields and billing | #### How custom fields are registered and rendered Programmatic API (using `includes/fields.php` functions): ```php // Add a field group (optional) pmpro_add_field_group('my_group', 'My Group Label', 'Description'); // Add a field to a group pmpro_add_user_field('after_email', new PMPro_Field( 'my_field_name', 'text', array( 'label' => 'My Field', 'required' => true, 'profile' => true, 'levels' => array(1, 2), // Only show for levels 1 and 2 ) )); ``` UI-based (stored in WordPress option `pmpro_user_fields_settings`): - Loaded by `pmpro_load_user_fields_from_settings()` hooked into `init` at priority 1 - File: `/var/www/html/wp-content/plugins/paid-memberships-pro/adminpages/user-fields/` #### How fields are rendered at checkout 1. `includes/fields.php` hooks `pmpro_checkout_*` action hooks to function `pmpro_display_fields_in_group()` which calls `PMPro_Field_Group::display()` 2. `PMPro_Field_Group::display()` iterates over fields and calls `$field->display($value)` for each 3. `PMPro_Field::display()` outputs the HTML for the specific field type #### How fields are saved at checkout 1. **User creation fields** (`after_username`, `after_password`, `after_email`): Saved via `pmpro_checkout_before_user_auth_save_fields()` hooked into `pmpro_checkout_before_user_auth` 2. **Other checkout fields**: Saved via `pmpro_after_checkout_save_fields()` hooked into `pmpro_after_checkout` 3. Validation via `pmpro_checkout_user_creation_checks_user_fields()` and `pmpro_registration_checks_for_user_fields()` --- ### 6. Processing Pipeline (preheaders/checkout.php) **File:** `/var/www/html/wp-content/plugins/paid-memberships-pro/preheaders/checkout.php` (733 lines) Key processing steps: 1. Detects token orders from URL 2. Sets `$pmpro_level` via `pmpro_getLevelAtCheckout()` 3. Determines if billing is required (`$pmpro_requirebilling`) 4. Fires `do_action('pmpro_checkout_preheader', $pmpro_level)` 5. Reads all field values from `$_REQUEST` into globals (`$username`, `$password`, `$bemail`, `$bfirstname`, etc.) 6. Sets required field arrays (`$pmpro_required_billing_fields`, `$pmpro_required_user_fields`) 7. Checks nonce via `wp_verify_nonce()` 8. Validates required fields 9. Creates user via `wp_insert_user()` (if not logged in) 10. Creates order via `new MemberOrder()` 11. Processes payment via `$pmpro_review->process()` 12. On success: calls `pmpro_complete_checkbox()` and redirects to confirmation **Filter hooks for validation/middleware:** - `pmpro_skip_account_fields` — Skip account fields if user is logged in - `pmpro_checkout_confirm_password` — Show/hide confirm password field - `pmpro_checkout_confirm_email` — Show/hide confirm email field - `pmpro_include_billing_address_fields` — Show/hide billing address - `pmpro_include_payment_information_fields` — Show/hide payment info - `pmpro_require_billing` — Force billing fields - `pmpro_checkout_checks` — Custom checkout validation - `pmpro_registration_checks` — Legacy registration checks - `pmpro_checkout_user_creation_checks` — User creation checks - `pmpro_checkout_order_creation_checks` — Order creation checks - `pmpro_required_billing_fields` — Filter required billing fields array - `pmpro_required_user_fields` — Filter required user fields array - `pmpro_checkout_new_user_array` — Filter user data before creation --- ### 7. pmpro-signup-shortcode Plugin Summary **File:** `/var/www/html/wp-content/plugins/pmpro-signup-shortcode/pmpro-signup-shortcode.php` (591 lines) Key features: - Shortcode `[pmpro_signup]` with attributes: `level`, `levels` (multi-level dropdown), `short`, `intro`, `submit_button`, `login`, `redirect`, `hidelabels`, `custom_fields`, `confirm_email`, `confirm_password`, `title` - Automatically copies email to username when no username field (using `pmpro_generateUsername()`) - Automatically generates password when no password field - Stores auto-generated password in session for email confirmation - Saves referrer data in user meta - Supports `redirect_to` / `pmprosus_referrer` for post-signup redirect - Fires `pmpro_checkout_preheader` action so standard PMPro hooks work - Includes a Block Editor block in `blocks/build/pmpro-signup-block/` - Uses `pmprosus_skip_username_password()` on `init` to auto-populate username/password from bemail