WP-Members FAQs

I activated the plugin and it didn’t block my post…

Make sure you log out of the admin before you test. If you are logged in as admin, you will be able to click through to view the post. (To know if you are logged in, we suggest using the WP-Members login widget, included in the installation.)

Also, for posts, be sure you are using the `<!–more–>` tag. The blocking only takes place on single posts. Without this tag, a full post would display on your home page or on an archive/category page.

Check your settings for both posts and pages. The default installation is to block posts by default but not pages.

The plugin does not block archives, search results, category lists, or other summaries from view.  These templates display a list of post excerpts truncated at the `<!–more–>` tag.  If you want to block these completely from view, you need to customize the way your template displays the Loop.  This also is true for creating a “blog page.”  Even if you have the plugin set to block pages, WordPress still treats this as a summary of posts.

How can I show the user’s login status?

The best way to do this is to add the WP-Members widget to your sidebar.

While it is rare to find a theme these days that is not widget enabled, if you do not have widgets, you can call the function by adding this to your sidebar:

<?php wpmem_inc_sidebar(); ?>

I’m really only using this to add user fields and have the login integrated into the site. I would rather that posts be unblocked by default. How do I do that?

WP-Members gives you the ability to change the settings for how the plugin blocks content. The default setting is to block posts and allow individual posts to be set to unblock at the post level. You can change this setting so that all posts will be viewable by default. If you then have a post that you want blocked to registered members only, you can set the post to block at the post level.

How do I block (or unblock) an individual post (or page)?

If you are using the default settings (as mentioned above), and you have a post that you want to be unblocked (viewable by any user, not just logged in users), on the Edit Post page add a Custom Field with the name “unblock” and set the value to “true” or “1” (either will work). This post will be now be viewable by anyone.

If you have set WP-Members to unblock by default and you want to block an individual post, use a Custom Field with the name “block” and set the value to “true” or “1”. Important: custom fields are case-sensitive! Be certain that you use all lowercase or it will not work.

For more information, see Override the Default Setting for Posts in the Users Guide.

How to I change the registration fields that are used and which ones are required?

These settings can be managed on the WP-Members admin panel found under Settings > WP-Members

For more information, see Add Fields in the Users Guide

Where do I find the users registration information?

WP-Members was designed to fully integrate with WordPress to allow maximum compatibility not only with WP, but also with other plugins that rely on WP user registration information, such as discussion forums, email newsletters, etc. The user information is in the main WP users page under Users > Users, then click “Edit” under an individual user. Any non-native WP fields (WP-Members custom fields) are added to the bottom of this page and are fully editable. (Note: if you don’t have any registered users yet, i.e. a clean install, these fields will not display until there is data in them.)

There is a WP-Members bulk user edit panel where you can see a list of users, view key details such as email, phone, and country, as well as do bulk activations and exports. This is found under the WP Users menu: Users > WP-Members. For bulk user export, WP-Members keeps track of users that are exported so that you don’t have to export the full user list just to get a few new subscribers, but you can also export the full list.

For more information, see Managing Users in the Users Guide

Users are not being emailed their passwords, what is wrong?

WP-Members uses the native WP function wp_mail to email passwords. This is the same function the WP uses if you are using the WP registration process. If it’s not configured properly or for some other reason not working, neither will WP-Members’ registration process.

You can test this process by creating a new user via the WP admin panel. Go to Users > Add New in the menu and create a new user. Make sure when you do this “Send this password to the new user by email” is checked. If you do not get an email, then wp_mail is not working. If that is the case, you are probably going to have to do some troubleshooting to fix it. Try the WP support forums for this: http://wordpress.org/tags/wp_mail

Can I change the email address that messages are mailed from?

Most people are unaware that WP-Members uses the native function wp_mail, and that wp_mail sends messages from wordpress@mydomain.com. But it is easy to override this.

To change the email address that the WP-Members emails come from, you can set this address in the plugin’s email settings.  For more information, see Set a Custom Email Address in the Users Guide.

To change the email address that all WordPress emails come from, you can do it with a couple of filters added to your functions.php file or you can do it with a plugin.

Can I customize the way the login and registration forms look?

Yes! You can specify a custom style sheet for the default login and registration forms. These forms are tabless and customizable using CSS.

CSS can be applied to the legacy forms, but must be applied via an outside stylesheet (such as your theme), and since the forms are table-based, the customization options are limited.

The login and registration fields overlap my theme pages. How can I fix that?

WP-Members includes a default stylesheet that was developed using the (formerly) default TwentyTen theme. Depending on the theme you are using, this may not fit your theme right out of the box. But the forms have been developed to be very flexible by relying on CSS for their layout (see above). If you have issues of overlap or other issues with the form layout, these are addressed by customizing the CSS.

Can I customize the plugin?

It is not recommended to make direct code changes as they would need to be re-implemented in the event of a plugin upgrade.

The plugin has an extensible framework, so the proper way to approach customization is through the use of action and filter hooks.  There is a complete list of hooks here.  There are lots of examples in the premium support code snippet library of customized functions and features that utilize the framework of filter and action hooks.

I only want the login form to show in place of protected content and have a separate registration page. How can I do that?

If you turn off the registration in the plugin options, the registration form will not show on protected content posts/pages or the members area. Specify a registration page following the plugin instructions and set this page’s location in the plugin settings.

I need customized registration fields. How can I add/subtract fields?

The registration fields used by the plugin are stored in an array in the WP options table. New text, text area, and checkbox fields can be added in the Fields admin panel in the plugin’s settings menu. Alternatively, a description of how to customize the fields programmatically is available in this post.

Does the plugin have an upload feature so users can add an avatar?

No.  But WordPress already is compliant for use with Globally Recognized Avatars (or “gravatars“).

See this post on how to use the wpmem_sidebar_status filter to add a gravatar to the sidebar widget.  (For those of you that are not yet premium members, this article is a free sample of the great code snippets and tutorials available to members.)  And for premium members, this post shows you how to add an avatar to the Members Area profile page.

How do I get the login widget to display a link to register and/or forgot password?

If you have set up a members-area and register page using the shortcodes for these pages, you can enter the URL for each in the plugin’s options panel.  The register page URL will cause a register link to be included in all login forms.  The members-area page URL will cause a forgot password link to be included.

User passwords are invalid? What is wrong?

If the credentials work for the WP login, the credentials are valid.  Often then the issue is one of the following:
1. If the plugin is configured for moderated registration, there are some possible configuration issues.
  • If there is no password field included as part of the registration form, a random password is emailed when the user is activated. Any other password will be invalid.
  • If there is a password field included as part of the registration form, the password is the password from registration.
2. If you are using the Email as Username extension, any user that is loaded from prior to the extension being activated will not have an email address as their username. To change this, the user record must be updated directly in the database as there is no option to change usernames. Until this is done, the account (including admins) the login credentials are the username and password, not email and password.
3. If you are using another plugin that adds anything to the login process, such as SI CAPTCHA, you will need to either implement a workaround or disable the other plugin.