Product Support

Participants Database WordPress User Profile

Expand the WordPress user profile with unlimited Participants Database fields. Automatically create a WP user account with a Participants Database signup form. Provide a frontend profile page for your WordPress users.

Product Setup

This plugin is primarily for the purpose of expanding the WordPress user account to include additional information which the user (or administrator) can edit on their profile page. It  provides several ways to connect a Participants Database record to a WordPress user. This works whether you already have WordPress users, or you have Participants Database records, or even if you have nothing to start with.

Start by Defining Your Data Fields

Unless you already have your Participants Database fields defined, you need to first set up the fields of data that will be stored with the user’s profile.

To do that, go to the Manage Database Fields page in Participants Database and define the fields you want for your users. Using field groups, you can define fields that are public, private (for the user only) or admin (only site admins will be able to see these). Once the fields have been defined, you can configure how it interacts with WordPress users and user registration.

You can define as many or as few extra fields as you want. Participants Database comes with a set of predefined fields, these can all be deleted if you don’t need them.

There are a few key fields in the WordPress user account that are usually linked to fields in the Participants Database record. This establishes synchronization between the two on these fields: First Name, Last Name, Email, User Login, and User Avatar (also known as the Profile Picture). It is not absolutely necessary to set up these fields, but it can be helpful to be able to see the user’s name, etc. in the Participants Database record.

To set this up, go to this plugin’s settings under the “WordPress User Profile/Participants Database Record Settings” heading. This is where you can determine which Participants Database fields relate to the core fields of the WordPress profile. In most cases, the defaults will be OK.

When a new WP user account is created from a Participants Database record (either an existing record or a new signup), the information in these fields will be used. The User Login field can be used as a way to let user determine their own user login name (this works for new signups only). In most cases, if this field is configured, it is for the purpose of showing the username in the PDB record.

Creating WordPress User Accounts

If you want new WP user accounts to be created automatically (there are several ways this can happen), check the “Create New WordPress User Settings.” If you want the new users to get a welcome email, make sure “Send the WordPress New User Email” is checked. If you’ve got the Email Expansion Kit installed, you can also define your own welcome email. If you’re doing that, you can uncheck the setting so only the custom email gets sent.

Creating WP User Accounts with a Signup Form

If you’re starting from nothing with your membership, or you want to let new members register, you can use the Participants Database signup form to provide a way for your new members to sign up. This is enabled using the “Create New WP User Mode” setting in the PDb User Profile plugin settings.

When a Participants Database signup form is submitted, you can set it up so that the person registering will be given a WP account. You can also set it up so that when they register, it stores their info but does not set up the WP account until the registration is approved by an administrator.

When the registration is approved, the info from the signup is used to create the new account. The Participants Database record is now associated with the new WP account.

The signup form can have as many fields as you like, so your new accounts can be established with a full set of information. The one exception is you cannot use the PDb signup to establish the password as explained below.

Note that when this setting is used, a logged-in user won’t see the signup form because they already have an account.

User Account Passwords

When using a Participants Database signup form to create new WP accounts, you cannot use a PDB password field to set the password on the new account. This is because WordPress requires that new accounts be verified via email with a link that forces them to create a password. User account passwords are handled by WordPress, not Participants Database.

Creating WordPress User Accounts on Approval

If you want to be able to approve the new user before granting them an account, you can use the approving records mechanism to create the user account. When a record is approved, a new WP user account will be created using the info in the signup submission. This can also be used to turn the user’s account access on and off. If a record id unapproved, the user won’t be able to log in. If the record is approved again, they will regain access.

If you have WP User accounts already, if you use this feature, be sure to set the approval field to default to “approved” so that your existing users won’t get deactivated.

Creating WordPress User Accounts Manually

If you’ve got people in Participants Database and you want to establish WordPress user accounts for them, you can easily do that on the admin List Participants page. Select the records you want to establish WP user accounts for, then select “create WordPress user account for record” then confirm the operation by clicking “apply.”

Select the users you want to establish accounts for, then use the “with selected” dropdown to select “Create WordPress user account for record” and click “apply.” Each of the people who got new user accounts will be sent the welcome email (with the login link) if you have that configured. It is probably a good idea to test this on a single user before doing it for a lot of them.

Starting with Existing WordPress Users

If you have WordPress users already registered and you want to give them expanded information storage in their account profile, it’s very easy. When the user visits their profile page, a new Participants Database record is created for them if it did not exist before. All the extra information that they enter on the profile page will be added to that record, which is now fully connected to the WP user.

The Profile Page

WordPress has a built-in profile page on the backend that is accessible to users where they can edit their profile info. This plugin can add Participants Database fields to that profile page. This is configured in the plugin settings under the “User Profile Settings” heading. There is a checkbox that enables this functionality.

You can also control which groups of Participants Database fields are shown in the profile. There is another setting where specific fields can be excluded.

When a logged-in WP user visits their profile page, the matching Participants Database record is used to add the extra fields. If there is no record for the user the “Create PDb Record for WP User” option creates a new record for them. That record is now attached to the WP user, and will be used to store their information.

Frontend Profile Page

If you want your users to be able to access their profile on a regular website page (instead of an admin page), you can do that using the [pdb_user_profile] shortcode. Just select or create a page for your profile and put the shortcode on that page. This is perfect if you don’t want your users going to the backend to edit their profile.

Placing the frontend user profile shortcode

 

When the frontend profile page is set up, the plugin automatically changes the user’s profile link to point to this page instead of the default profile page in the backend.

There are two built-in templates for the frontend user profile page. The default template is a responsive layout based on the Bootstrap framework. There is also a flexbox-based layout that can place the fields in columns and will generally be more compact. You can use the flexbox template by adding the name of the template to the user profile shortcode like this:

[pdb_user_profile template=frontend-profile-flexbox]

The frontend profile uses the same configuration settings as the backend profile page. The layout and appearance of the profile page is under the control of your WP theme. If you need to make changes to its appearance, you will need to use your own CSS rules to make the desired changes. The main Participants Database plugin has a place for your custom CSS rules in the settings.

It is also possible to create a custom template for the frontend user profile. The name of the template file must begin with “pdb-record-frontend-profile” and must be based on one of the two frontend profile template included in the plugin.

Using a Custom “Welcome” Email

If you have the Email Expansion Kit installed, you can easily create a custom email that goes out to the user when a new account is set up for them. If you are notifying your users this way, you should uncheck the “Send the WordPress New User Email” setting to avoid sending two emails.

When creating the email template, use the “WordPress User Profile:: New WP User Created” action to send a notification to the new user that they have a WP User account and need to activate it using the activation link.

This email must contain the “activation link” so that the user can activate their new account. This is a security feature that allows you to avoid putting a plaintext password in the email.

The user must visit the site using the activation link, where they will need to create a new password for themselves.

Here is an example content for your welcome email template:

If you do want to send them the plaintext password, you can use the tag [user_pass]. They will be able to use that with their user login to log into the account immediately without changing their password.

Showing a List of Users

You can use the Participants Database list shortcode to show a list of your users, showing only users with a specific role. For example, to list all the subscribers, use

[pdb_list role="subscriber"]

You can also name more than one role there, for example:

[pdb_list role="subscriber,member"]

This will work to show both subscribers and members if you have a custom role named “member.”

Showing the Current User’s Record

It is possible to show the current user’s record in a non-editable form by using the Participants Database single record shortcode. This is done by using the “current_user” key for the record_id shortcode attribute, like this:

[pdb_single record_id=current_user]

Of course, you can use the other available shortcode attributes to configure the display, including using a custom template.

Product Settings

User Profile Settings

Show PDb Fields in WP Profile

This is the overall enable switch for including the extra fields defined in Participants Database in the WordPress user’s profile page.

Profile Groups

Select which Participants Database field groups to include in the profile page. Only public and private groups will be available here.

Profile Excluded Fields

If there are specific fields within the selected field group that you wish to exclude, list them here. It should be a comma-separated list of Participants Database field names.

PDb Profile Title

This title is printed above the extra fields that Participants Database adds. Blank it out to show no title.

Create PDb Record for WP User

This determines whether a participants Database record should be assigned to the WP user if they visit their profile page and there is no PDB record associated with their account. In most cases, you will want this checked.

WordPress User/Participants Database Record Settings

These settings set up a correspondence between the key fields of the WordPress profile and the Participants Database record. These settings are optional, the plugin does not use these fields to determine which record belongs to the user. They are helpful, however, because it provides a readable way to know which WP user the PDB record belongs to.

These are configured by default to connect to the default fields in Participants Database if they exist.

First Name Field, Last Name Field, Email Field

These setting tell the plugin which PDB fields are connected to the WP user profile fields. In most cases, you won’t need to change these, they will be set up by default.

User Login Field

This setting provides a way to store the user login name in the PDB record. If the site was previously configured to use the user login as a way to identify which user the record belonged to, this setting should set that up automatically. This works by looking for a hidden field in the PDB field definitions that is set up to record the user’s user login name in a signup form.

User Avatar Field

This provides a way for the user to use a “local” avatar for their profile. Normally, WordPress would attempt to get the user’s avatar from Gravatar, but with this feature, the user can upload an image to use instead or if they don’t have a Gravatar image configured. This image will be used to identify the user anywhere on the site that the avatar is displayed.

This selection must be an “Image Upload” type field.

Create New WordPress User Settings

It is possible to use this plugin as a way to set up a WP user account for someone who is in a Participants Database record. This can happen in several ways, and these setting determine how that will work.

When a new WP user account is created, an email is sent to the person informing them of their new account, along with information to go to the site and set up their password. They will not be able to log in until they do this. This is standard WordPress functionality, but it can be overridden when using the Email Expansion Kit.

Create New WP User Mode

There are 3 ways a new WP user account is created in this plugin. This setting determines which one you want to use. If you don’t want WP user accounts to be created at all, use the “Manual” setting (which is the default).

When a new WP account is established by any method, an email is sent to the new account holder with their login instructions.

With the Manually setting, new WP user accounts can be created for people in Participants Database by using the “With Selected” function on the admin List Participants page. Note that you can always use the “With Selected” action, no matter what setting you have here.

The On Signup setting means that the WP user account is established immediately when the signup form is submitted.

The On Approval setting also works with the signup form, but instead of establishing the WP account immediately, it only does so when the record is approved. (See Approving Records for how this is configured in Participants Database). This setting also means that if you approve an unapproved record that was already in the database that does not have a WP account assigned to it, a new WP account will be created.

New WP User Role

This determines the role given to new WP users that are created by this plugin. If you  have custom roles defined, you will be able to assign new users to a custom role.

New User Login Name Source

When a new WP user is created, the account is given a username. This setting determines what information will be used to set up the account user name.

If you have a user login field defined, it is possible to let the person signing up determine their own username. The plugin will make sure it is unique.

Usernames cannot be changed once established.

There are 4 options for how the username is constructed:

  • First or Last Name – this will use the first name if possible, then the last name if the first name isn’t available as a username.
  • First and Last Name –  the first and last name will be combined to create the username.
  • Email Field – the user’s email address is used to create the username: the “@domain” part is removed and what is left is the username.
  • User Login Field –  this makes it possible for the user to set their own username, this is only possible in the signup form.

If the selected method creates a username that is alredy set for another user, a numeral is added to the username to make it unique.

Joining Character

When building the username, this setting sets the character that is used to join the parts together. This character is also used if a numeral is added to the username. “No Character” means the parts are joined together with nothing in between. The setting is limited to characters that are allowed in a username.

Send the WordPress New User Email

This preference determines whether the WordPress standard “welcome” email is sent to the new user when the account is established. If you are using the Email Expansion Kit to define a custom email for this purpose, you can uncheck this to prevent the built-in WordPress email from getting sent.

If you just don’t want that email going out at all or at a later time, you can uncheck this.

It’s always possible to resend the “welcome” email using the “With Selected” function on the admin List Participants page.

Deactivate WP User when Unapproved

When a record is unapproved (if it was approved before it was unapproved) the WP user account can be deactivated at the same time. The account is not deleted, it just becomes inactive and the person won’t be able to log in. This is done by setting the deactivated user’s role to “None.” If the record is approved again, the account will be reactivated, using the New WP User Role setting above to restore the user’s role.

Handle WP User Account on PDB Record Delete

When a Participants Database record is deleted, this setting determines what happens to the associated WP user account.

Deactivate means the account still exists, but the user will be unable to log in. Choose this if you think you may want to give the user access again in the future.

Do Nothing means they can still log in, but note that when they visit their profile page, a new Participants Database record will be created for them. The plugin doesn’t try to prevent that.

If you set it to Delete, the associated WP account will be deleted along with the PDB record. Admin accounts and accounts that have authored posts will not be automatically deleted.

Deactivated Account Message

This lets you define the error message that is shown to the user when they try to log in while their account is deactivated. You can include some simple HTML here.

F.A.Q.

Is it possible to use this add-on with Field Group Tabs to provide a tabbed interface for the frontend profile?

Yes, it requires the use of a special custom template. I’ve created an example of how this can be done, the template is available below.

Please read Using Participants Database Custom Templates so you understand how to install and use this custom template.

To use the template, set up your shortcode like this:

[pdb_user_profile template=frontend-profile-tabs tabs=true ]

You must (of course) have the Field Group Tabs add-on installed for this to work.

https://gist.github.com/xnau/e4480bb20d7d58d65dbb37535f5ea970

 

Support Discussions for Participants Database User Profile

  • I bought this plugin a few days ago, but when I save the user data, I got an error:

    PHP Fatal error:  Cannot redeclare add_user() (previously declared in /[url]/wp-admin/includes/user.php:17) in [url]/wp-admin/includes/user.php on line 17

    • Thanks for letting me know about this. What is happening is another plugin is loading the user.php script, so it’s getting loaded twice. I should have anticipated this possibility (you’re the first to have encountered this issue) and I’ll issue an update that fixes this soon.

      In the meantime, you can fix it immediately with this change. Using the plugin file editor, select the “Participants Database WordPress User Profile” plugin and find the pdbwpu/frontend_profile_submission.php file. On line 60, you’ll see:

      include ABSPATH . 'wp-admin/includes/user.php';

      Change this to:

      include_once ABSPATH . 'wp-admin/includes/user.php';

      and the error will be avoided.

  • Hi Roland,

    I’m using this plugin, and I have a question for which I did not find any answer in the FAQs.
    I’d like to know if it is possible to redirect the user to a specific page conform he chooses an radio button.
    For instance, suppose I have 4 radio buttons, 1, 2, 3 and 4. If the user chooses 1 I want to redirect him to page X when he saves the form. If he chooses 2 I’d like to redirect to page Y when he saves, and so on.
    Is there anyway to do this without PHP coding?

    Thanks a lot
    Artur

    • This is comething that will require custom code, the plugin doesn’t have the ability to redirect the user after they update their profile. If you can’t write the code yourself, you’lll need to use the services of a WordPress developer.

  • I am using WordPress.org, free ‘Doctor’ theme. I am beginning to set up the PDb plug-in so that visitors can register as participant. I think I am following the set-up instructions, I am selecting all given database fields, not creating custom ones. The Register form does not show the fields though. Not sure why. It is almost as if the checked participant database fields do not ‘stick.. When I ‘Update’ fields, and go back, the fields I just checked and updated, are unchecked. Thanks for any help. Ursula.

    • If you’re making settings changes that don’t stick, this is usually because of server caching. You should turn all caching off while setting up your site, then turn it back on once everything is working.

  • I am trying to upload a PDF cash receipt (image upload) in PDF in the payment log. I was able to configure. But when used it there was no display or icon. Is there a way to do this? One record could have multiple receipts.

    • I don’t have enough information to answer your question, I’m sorry. What “payment log” are you referring to? If it is a specific field, what kind of field is it and how do you have it configured?

  • I have this plug-in on my website and when i try to save the form it says Safari cannot open the page because the server cannot be found. I am using a mac.

    • Can you be more specific about what page you are on when the problem happens?

      A problem like this usually means things are not configured correctly, but it could also be a server security issue. You will need to ask you hosting provider about that.

  • I have a database with 18,000 records and 22 fields, from 5 years ago in WP Participant Data Base.
    I recently bought the WP USER PROFILE plugin, but I don’t know how I can do the following:
    I can only access in read/write mode from Admin and I want to be able to access from a lower ranking user or through a page with a shortcode in read/write mode.

    It’s possible ?

    Thanks

  • Dear Roland,
    after the latest update of the plugin (version 2.0) my records from the database in Greek started show funny symbols like: �” and �’ instead of some Greek symbols. The most strange thing is that on back-end everything is OK but on the front-end these funny symbols are shown.
    Do you have any idea how this can be fixed?

    Best regards,
    Iglika

  • Dear Roland,

    Is it possible to create a PDB record for already existing users?

    Best,
    Khalid Trad

    • Yes, if you are using the [pdb_user_profile] shortcode, when the logged-in user opens this page, a Participants Database record is automatically created for them if it doesn’t exist.

      A Participants Database record is also created for the WP user if an administrator opens their profile page in the backend.

  • Hi Roland,

    I have a site running the PDB with the Log and WordPress User Profile add-on installed.

    I want users to be able to edit their profiles and add log entries on their profile page. When I use the shortcode [pdb_user_profile] the log entry button causes an ‘uncaught typeerror: cannot read properties of undefined (reading ‘top’)’ in the log javascript file and fails to load the log entry window/popup. When accessing a record using the [pdb_record] shortcode and the pid in the url the log entry window/popup loads successfully. However, this doesn’t solve the problem for users to access and edit only their own profiles.

    Is it possible to use the log entry with the [pdb_user_profile} shortcode?

    • Hi Alex,

      I’m unable to duplicate the problem here with the information given. Can you be more specific about the state of the log before clicking and the action taken that results in the problem? If you’re seeing a message in the console, paste it in to a comment here so I can see the exact wording.

      Do you have the [pdb_user_profile] shortcode in some kind of special element on the page? Depending on the theme it may be necessary to place the shortcode in regular content, using a shortcode block.

      • Hi Roland

        I am using a Page Builder, but have reverted to the TwentyTwentyOne theme for testing and created a page with a single shortcode block with the [pdb_user_profile] shortcode in. No variables, just the shortcode. The console outputs this error:

        participant_log.min.js?ver=1.5.5.4:2 Uncaught TypeError: Cannot read properties of undefined (reading ‘top’)
        at f (participant_log.min.js?ver=1.5.5.4:2)
        at Object.success (participant_log.min.js?ver=1.5.5.4:3)
        at c (jquery.min.js?ver=3.6.0:2)
        at Object.fireWith [as resolveWith] (jquery.min.js?ver=3.6.0:2)
        at l (jquery.min.js?ver=3.6.0:2)
        at XMLHttpRequest. (jquery.min.js?ver=3.6.0:2)
        f @ participant_log.min.js?ver=1.5.5.4:2
        (anonymous) @ participant_log.min.js?ver=1.5.5.4:3
        c @ jquery.min.js?ver=3.6.0:2
        fireWith @ jquery.min.js?ver=3.6.0:2
        l @ jquery.min.js?ver=3.6.0:2
        (anonymous) @ jquery.min.js?ver=3.6.0:2
        load (async)
        send @ jquery.min.js?ver=3.6.0:2
        ajax @ jquery.min.js?ver=3.6.0:2
        s.ajax.s.ajax @ jquery-migrate.min.js?ver=3.3.2:2
        S. @ jquery.min.js?ver=3.6.0:2
        L @ participant_log.min.js?ver=1.5.5.4:3
        dispatch @ jquery.min.js?ver=3.6.0:2
        v.handle @ jquery.min.js?ver=3.6.0:2

        Thank you for looking at this,

        Alex

        • Also just to clarify. The console is clean/empty and when the page loads. When I click ‘Add Match’ (match is the name of the log) the error I posted above is outputted. This happens in a standard Guttenburg page on TwentyTwentyOne theme with the shortcode in a shortcode block.

          The [pdb_record] shortcode allows log entries in both the page builder and Guttenberg pages in both templates.

        • OK, can you turn plugin debugging on? Right now, its using the minified version of the script, if you turn plugin debugging on (this is in the plugin settings under the advanced tab), we’ll be able to see where in the code the problem came up.

          Also, I’m not clear on when this message comes in…what specific action triggers it?

        • Thanks Roland,

          The log file is below and the console out put is below that. The console message is triggered when I click the Add Log button and instead of the Log Entry box popping up I get a spinning icon that just continues.

          Log file initiated at: November 9, 2021 7:17 pm UTC
          [11/09/21 7:19pm UTC]
          Cannot modify header information – headers already sent
          in /home3/xqxiavmy/public_html/EPFAtraining/wp-content/plugins/participants-database/classes/PDb_Session.php on line 323
          [11/09/21 7:19pm UTC]
          PDb_Session::get_php_session_id headers sent before session start. trace: require_once(‘wp-load.php’), require_once(‘wp-config.php’), require_once(‘wp-settings.php’), do_action(‘plugins_loaded’), WP_Hook->do_action, WP_Hook->apply_filters, Participants_Db::init, PDb_Session->__construct, PDb_Session->get_session_id, PDb_Session->get_php_session_id
          [11/09/21 7:19pm UTC]
          session_start(): Cannot start session when headers already sent
          in /home3/xqxiavmy/public_html/EPFAtraining/wp-content/plugins/participants-database/classes/PDb_Session.php on line 210

        • This is related to having debugging on, not the problem you’re seeing with the log entry code.

        • Console output:
          Uncaught TypeError: Cannot read properties of undefined (reading ‘top’)
          at position_offset (participant_log.js?ver=1.5.5.4:44)
          at Object.success (participant_log.js?ver=1.5.5.4:72)
          at c (jquery.min.js?ver=3.6.0:2)
          at Object.fireWith [as resolveWith] (jquery.min.js?ver=3.6.0:2)
          at l (jquery.min.js?ver=3.6.0:2)
          at XMLHttpRequest. (jquery.min.js?ver=3.6.0:2)
          position_offset @ participant_log.js?ver=1.5.5.4:44
          (anonymous) @ participant_log.js?ver=1.5.5.4:72
          c @ jquery.min.js?ver=3.6.0:2
          fireWith @ jquery.min.js?ver=3.6.0:2
          l @ jquery.min.js?ver=3.6.0:2
          (anonymous) @ jquery.min.js?ver=3.6.0:2
          load (async)
          send @ jquery.min.js?ver=3.6.0:2
          ajax @ jquery.min.js?ver=3.6.0:2
          s.ajax.s.ajax @ jquery-migrate.min.js?ver=3.3.2:2
          S. @ jquery.min.js?ver=3.6.0:2
          open_add_entry @ participant_log.js?ver=1.5.5.4:62
          dispatch @ jquery.min.js?ver=3.6.0:2
          v.handle @ jquery.min.js?ver=3.6.0:2

        • OK, I probably need to see it for myself, I don’t understand why that object is coming up undefined there, not doing that for me here, so I need to see what it’s doing on your site.

          Use my email support@xnau.com to send me a login so I can test it myself.

  • Hi there,

    I have just set this up for a website I run and I am so happy with the product but I have a *lot* of details that I need to gather from users and have bought and implemented the tabs plugin. I would like to give the users the opportunity to save each tab before being stepped through to the next one. This would allow them to save a tab with all of the mandatory fields filled in even if the mandatory fields of other tabs are incomplete. I read up on the submit/next button options but the code for these is already in the plug in it would seem. Is there an easy-enough way to do what I’m looking for.

Leave a Reply to Roland Barker Cancel reply

Your email address will not be published. Required fields are marked *

Would you like to be notified of followup comments via e-mail? You can also subscribe without commenting.