MyListing Third User Role
The {CODICTS} MyListing Third User Role plugin adds a third user role option to MyListing’s registration form. By default, MyListing offers two role choices — a Primary role (e.g., “Customer”) and a Secondary role (e.g., “Business Owner”). This plugin lets you offer an additional registration pathway with a custom label and any WordPress role you choose.
The third option clones its registration form fields from the Secondary (Customer Alt) role, so users selecting the third option see the same form fields as the secondary role. On registration, the plugin assigns your configured role instead
Installation & Activation
Start by downloading the plugin from the Downloads page on your dashboard on the CoDicts website.
After downloading, install and activate the plugin in WordPress by navigating to “Plugins” > “Add New” > “Upload Plugin” and selecting the downloaded zip file. Click “Install Now” and then “Activate”.
After activation, navigate to Third User Role in the admin sidebar to configure the role label, assigned WordPress role, and display options.
Key Features
| Feature | Description |
|---|---|
| Third Registration Role | Adds a third radio button option to MyListing’s registration form alongside Primary and Secondary. |
| Configurable Role Label | Customize the display text for the third option (e.g., “Vendor,” “Agent,” “Freelancer,” “Investor”). |
| Configurable WordPress Role | Assign any existing WordPress role to users who register via the third option. |
| Default Selection | Optionally set the third option as the pre-selected default on the registration form. |
| Position Control | Choose whether the third option appears first (before Primary) or last (after Secondary) in the role tabs. |
| Full Form Field Support | Automatically includes all registration fields from the Customer Alt form, including file uploads, social links, and custom profile fields. |
How It Works
The plugin adds a third radio button to MyListing’s registration form role tabs. The form fields displayed for the third option are cloned from the Secondary (Customer Alt) registration form.
When a user selects the third option and submits the registration form:
1. MyListing processes the registration normally and initially assigns the customer_alt role (because the form fields match the secondary form).
2. The plugin detects that the third option was selected (via a hidden form field) and swaps the role — removing customer_alt and assigning your configured role instead.
3. If the configured role doesn’t exist in WordPress yet, the plugin creates it automatically with basic read permissions.
Important: The third option’s form fields always come from MyListing’s Customer Alt registration form. Whatever fields you configure for the Customer Alt role in MyListing’s settings will appear when users select the third option.
Settings Page
Navigate to Third User Role in the WordPress admin sidebar.
| Setting | Default | Description |
|---|---|---|
| Set Third User Role as Default? | Unchecked | When enabled, the third option is pre-selected when the registration form loads. Users can still switch to Primary or Secondary. |
| Put Third User Role option first? | Unchecked | When enabled, the third option appears first in the role tabs (before Primary). When disabled, it appears last (after Secondary). |
| Third User Role Label | Subscriber | The display text shown next to the third radio button. Enter any label that fits your site (e.g., “Vendor,” “Agent,” “Freelancer”). |
| Assigned Role | Subscriber | The WordPress role assigned to users who register via the third option. Lists all available roles including custom roles from other plugins. |
Notice: This plugin copies the form structure of the MyListing Customer Alt account. Make sure your Customer Alt registration fields are properly configured in MyListing’s settings.
Example Setup: Adding a “Vendor” Role
1. Activate the plugin with the MyListing theme active.
2. Go to Third User Role in the admin sidebar.
3. Set Third User Role Label to “Vendor.”
4. Set Assigned Role to a custom role (e.g., vendor) or an existing role like subscriber. If you choose a role name that doesn’t exist yet, the plugin will create it automatically when the first user registers through the third option.
5. Optionally check “Put Third User Role option first?” to make “Vendor” appear as the first tab.
6. Save settings.
7. Visit the MyListing registration page. Three role options now appear: the original Primary and Secondary, plus “Vendor.” Users who select “Vendor” and register will be assigned the vendor role.
Tip: If the plugin creates a new role automatically, it only has basic
readpermissions. Use a role management plugin (such as User Role Editor) to add the specific capabilities your new role needs.
Frequently Asked Questions
Does this require a child theme?
No. The plugin does not copy any template files and works entirely via JavaScript and backend hooks.
What form fields does the third option show?
The third option clones all registration form fields from MyListing’s Secondary (Customer Alt) role. Whatever fields are configured for the Customer Alt registration in MyListing’s settings will be displayed.
Can I choose to clone from the Primary form instead of Customer Alt?
No. The plugin always clones from the Customer Alt (secondary) form. This is not configurable.
What happens if the assigned role doesn’t exist in WordPress?
The plugin creates the role automatically on the first registration with only the read capability. You should then configure additional capabilities using WordPress or a role management plugin.
Can I add more than three role options?
No. This plugin adds exactly one additional (third) option. It does not support a fourth or fifth option.
Will existing users be affected?
No. The plugin only affects new user registrations. Existing users’ roles are not modified.
Is “Set as Default” the same as forcing the third option?
No. “Set as Default” simply pre-selects the third option’s radio button when the page loads. Users are still free to choose any of the three options.
Can I use a custom role created by another plugin?
Yes. The “Assigned Role” dropdown lists all editable WordPress roles, including custom roles created by other plugins like User Role Editor.
What happens when I deactivate the plugin?
The third option disappears from the registration form. Users who were previously assigned the third role retain their role — the plugin does not remove roles or modify existing users on deactivation.
The third option only shows on the MyListing registration form?
Correct. It only appears on MyListing’s registration form. It does not affect the default WordPress registration form or any other registration plugins.
Troubleshooting
Third Option Not Appearing on the Registration Form
| Cause | Solution |
|---|---|
| MyListing secondary roles not enabled | The plugin requires MyListing’s secondary role system to be enabled. In MyListing’s settings, ensure that the Primary and Secondary (Customer Alt) role options are active on the registration form. |
| JavaScript disabled or error | The third option is injected via JavaScript. Check the browser console (F12 → Console) for errors. Ensure JavaScript is enabled. |
| Not on a MyListing registration page | The third option only appears on pages with MyListing’s .mylisting-register form. Verify you’re on the correct registration page. |
| Plugin not activated | Go to Plugins → Installed Plugins and verify the plugin is active. |
| MyListing not active | The MyListing theme must be active. Check Appearance → Themes. |
Third Option Form Fields Are Empty
| Cause | Solution |
|---|---|
| Customer Alt fields not configured | The third option clones fields from the Customer Alt registration form. If no fields are configured for Customer Alt in MyListing’s settings, the third option will also have no fields. Configure the Customer Alt registration fields in MyListing. |
User Registered with Wrong Role
| Cause | Solution |
|---|---|
| User selected Primary or Secondary, not the third option | The role swap only happens when the third option is selected. If the user chose Primary or Secondary, they receive the standard MyListing role. |
| Settings not saved | Verify the correct role is selected in the Assigned Role dropdown on the settings page and that settings were saved. |
Social Links or File Upload Fields Not Working in Third Option
| Cause | Solution |
|---|---|
| JavaScript conflict | The plugin re-initializes social links repeaters and file upload handlers in the cloned form. A conflicting plugin or custom script may interfere. Check the browser console for errors. |
| MyListing scripts not loaded | The social links repeater relies on MyListing’s bundled jQuery Repeater plugin and Select2 library. Ensure MyListing’s scripts are loading properly on the registration page. |
Layout Looks Wrong with Three Options
| Cause | Solution |
|---|---|
| Custom CSS overriding the plugin | The plugin sets each role tab to 33.33% width. If custom CSS or another plugin overrides this, the layout may break. Check for competing styles on the .role-tabs .md-checkbox elements. |
| Very long role label | Extremely long label text may cause the tab to wrap awkwardly. Use a shorter label or adjust via custom CSS. |
“MyListing Theme Not Detected” Error
The MyListing theme must be installed and active. Go to Appearance → Themes to verify.
For further support, visit codicts.com or contact us at support@codicts.com.