PWD Custom WCFM Registration
Documentation

Introduction

PWD Custom WCFM Registration is a professional multi-step vendor registration form for WCFM Marketplace. It provides a polished, fully configurable registration experience with email verification, auto-save drafts, conditional logic, file uploads, and complete styling controls — all managed from a dedicated admin panel.

Requirements

Installation

Method 1 — WordPress Admin

Method 2 — FTP / File Manager

License Activation

PWD Custom WCFM Registration requires an active license to display the registration form. The shortcode, multi-step builder, conditional logic, and all admin functionality are blocked until a valid license is entered.

Activating Your License

Daily Verification

Once activated, the plugin silently verifies your license once per day via a background cron job (pwd_wcfm_daily_license_check). Up to 3 consecutive network failures are tolerated before the license is marked invalid — protecting you from brief server outages.

Plugins Page Indicators

The WordPress Plugins page shows License Active when valid, or Activate License when not. A red ! badge also appears on the Vendor Registration nav menu item when activation is required. The License tab is always accessible regardless of plugin state.

Quick Start

Settings

All settings are managed from Vendor Registration → Settings and saved via AJAX — no page reload required.

Multi-Step Builder

The Multi-Step builder is found at Vendor Registration → Multi-Step. It provides a drag-and-drop interface where you can organise any WCFM field — including custom fields and upload fields — across multiple form steps.

How It Works

Recommended Organisation

Step 1: Account Basics
  — Username, Email, Password, Confirm Password

Step 2: Personal Information
  — First Name, Last Name, Phone

Step 3: Store Details
  — Store Name, Store Description

Step 4: Additional / Custom Fields
  — Any WCFM custom fields, Terms acceptance

Conditional Logic

Create rules that show or hide fields dynamically based on other field values — found at Vendor Registration → Conditional Logic.

Conditions

Actions

• show — Show the target field(s) when the condition is met
• hide — Hide the target field(s) when the condition is met

Styling

Found at Vendor Registration → Styling. Gives you complete control over the registration form's appearance without touching any CSS files.

Mode Selector

• Inherit from theme — Zero overrides applied. The form inherits all colours, fonts, and button styles from your active WordPress theme. This is the default and is fully non-destructive.
• Custom styling — Enables the controls below. Any field left at its default value uses the form's built-in fallback.

Form Container

Typography

Input Fields

Buttons

Progress Bar

• Fill Color — the active progress fill
• Track Color — the unfilled background track
• Height — 2 to 20px

Shortcode

The registration form is embedded with a single shortcode:

[pwd_wcfm_registration]

Where You Can Use It

• Classic Editor — paste directly into the text or visual editor
• Block Editor (Gutenberg) — use a Shortcode block
• Page Builders — Elementor, Divi, Beaver Builder, WPBakery all support shortcodes
• Widget Areas — use a Text or Custom HTML widget
• Theme Files — do_shortcode('[pwd_wcfm_registration]')

Fields Reference

The plugin builds its field pool from three sources: standard fields, WCFM custom fields, and WCFM upload fields.

Standard Fields

WCFM Custom Fields

Any custom fields defined in WCFM → Settings → Vendor Registration Custom Fields and marked as enabled are automatically detected and added to the builder pool. Supported types: text, email, tel, number, select, radio, checkbox, textarea, content (read-only), and upload.

Vendor Guide

Completing Registration

WCFM Approval Flow

After a vendor completes registration, the plugin reads the WCFM membership's required_approval setting and routes accordingly — no manual configuration needed.

Approval Not Required

• WCFMvm::register_vendor() is called to activate the account immediately
• WCFMvm::store_subscription_data() assigns a free subscription record
• The vendor is auto-logged in via wp_set_auth_cookie()
• The wcfm_membership_registration action hook fires for third-party integrations
• The vendor is redirected to the WCFM dashboard (or custom URL)

Approval Required

• WCFMvm::send_approval_reminder_admin() notifies the site admin of the pending account
• The vendor account is created but left in a pending state
• If Include Approval Link is enabled, the admin notification email includes a one-click approval button

Troubleshooting

Form not displaying on the frontend

• Confirm your license is active — go to Vendor Registration → License
• Confirm the shortcode [pwd_wcfm_registration] is on the page
• Check that WCFM Marketplace and WooCommerce are active and up to date
• Try clearing any page/server cache

Custom fields not appearing in the builder

• Ensure fields are enabled in WCFM → Settings → Vendor Registration Custom Fields
• Ensure all field labels are unique — duplicate labels cause only one to appear
• Hard-refresh the Multi-Step builder page (Ctrl+Shift+R)

Verification email not sending

• Check the spam/junk folder first
• Install and configure WP Mail SMTP plugin
• Test email delivery with the Check Email plugin
• Check wp-content/debug.log for mail errors

Styling not applying to the form

• Confirm the Styling page is set to Custom styling mode (not Inherit)
• Clear any page caching or CDN cache after saving
• Inspect the page source for the inline <style> block appended after pwd-wcfm-form

License activation fails

• Confirm you are using the correct license key from your purchase confirmation email
• Confirm the email matches the one used at purchase exactly
• Check that your server can make outbound HTTP requests — some hosts restrict this
• If already activated on another domain, deactivate there first

Enabling Debug Logging

// Add to wp-config.php before "That's all, stop editing!"
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Check wp-content/debug.log after reproducing the issue.

Changelog