Search Results for: short code

In order to keep things on the front end of the site where things are wrapped in your theme (as opposed to the WP back-end), the plugin allows you to set an area for registered users to manage their settings, change their password, and also reset a forgotten password.

Setting this page up is exactly like setting up a registration page, covered in the section on Registration.

Creating a User Profile Area

The User Profile is a page where logged in users can update their profile information and change their password.  Also on this page, a logged out user can have a forgotten password reset.  Create a new page and place the following shortcode in the body:

[wpmem_profile]

Note: If you have set the plugin to block pages by default, you should set this page to be unblocked.

User Profile Location

Once you create the User Profile page as outlined above, it is available as a page in your WP installation to be added to menus in the same way you handle other pages.  This is dependent upon you and your theme, and whether you display all pages in a default menu.

In the plugin’s main options tab there is a setting for you to select the user profile page.  This tells the plugin where the page is and uses this to generate a “Forgot Password” link in the login forms. It is also used to generate the return link in the password reset.

The plugin can be run without using the registration forms.

For users that might have some other method of registration, up to and including private blogs that don’t want anyone registering and thus sending invited users login information.  In this case, complete the following based on your specific setup needs:

• Uncheck the options to display registration in Options > Content > Show Registration Form.
• Do not establish a registration page for the plugin (shortcode [wpmem_form register]), and make sure Options > Pages > Register Page is unset.
• Add the register=hide attribute to the [wpmem_profile] shortcode.

IMPORTANT:

This is not the same as turning off registration for WordPress itself. That is a separate issue.  This is simply a setting to remove the WP-Members registration forms from display.

If you would like a specific registration page to direct users to register, create a new page with the following shortcode in the body of the page:

[wpmem_form register]

Note: If you have set the plugin to block pages by default, you will need to set this page to be unblocked.

Registration Page Location

Once you create the registration page as outlined above, it is available as a page in your WP installation to be added to menus in the same way you handle other pages.  This is dependent upon you and your theme, and whether you display all pages in a default menu.

WP-Members™ has an option setting for you to enter the URL of your registration page.  This is optional and does not effect the functioning of your registration page.  It merely provides the plugin with knowing where the page is and uses this to generate a “Register” link in the login forms.

The Emails tab is where you would go to manage the email messages that are sent by the plugin.  It is important to note that the only messages that are displayed in the tab are the ones that are used based on your plugin settings under the “Options” tab.

Under this tab, you may also set an email address to change the default address that WordPress® sends from (wordpress@yourdomain.com).  Note: you do not need to use this setting if you already have a plugin or some other filter to do this.

Email content can be customized (and it is expected that you will customize it).  There are a variety of shortcodes specifically for email content and custom fields and shortcodes can be added in.

There are a number of filters for customizing emails, their content, and the email process.

See additional documentation if you wish to send HTML formatted emails.

Having trouble with emails going out?  The plugin uses the WordPress wp_mail() function for sending email.  It is generally unlikely that the issue is the plugin or WordPress.  But there are a lot of other possible factors.  Check out this section of the FAQs for more information on troubleshooting email issues.

Dialogs are included for certain user dialog and error messages that are displayed, such as empty registration fields, login error, etc.  Simple HTML is allowed in these fields including <p> (paragraph), <b> (bold), <i> (italics), etc.

Built-in Dialogs

You can customize any of the built in dialogs through the dialogs tab without customization.  These include messages for the following:

• Restricted content (shows above the login form when a restricted page is viewed)
• Username is taken (registration error message)
• Email is registered (registration error message)
• Registration completed (shows upon successful registration)
• User update (shows upon success user registration data update)
• Passwords did not match (error message when changing a password)
• Password changes (shows on successful password change)
• Username or email do not exist when trying to reset forgotten password (error message for forgotten password reset)
• Password reset (shows on successful forgotten password reset)

Custom Dialogs

In addition to the above, custom dialogs can be added through the plugin’s API using the wpmem_add_custom_dialog().  This function adds a custom dialog to the dialogs tab.  Existing dialogs that are part of the plugin’s default dialogs can be added to this screen so that you can easily change them, or if a custom process is implemented that requires its own messaging, that can be added as well.

(Note: a custom dialog added with wpmem_add_custom_dialog() can be used with wpmem_use_custom_dialog()).

Terms of Service

The Dialogs tab is also where you can load your TOS (Terms of Service) content, if you are using one.  HTML is also allowed here, including <h1>, <h2>, <ul>, <li>, etc.

Alternatively, if you have set up a Terms of Service page as a WordPress® page and want the TOS link to open that page, you can enter the following shortcode into the TOS dialog box:

[wpmem_tos url="http://mysite.com/my-tos-page"]

Be sure to put the full URL of your WP TOS page in the URL value of the shortcode.

See shortcode documentation for more information on using this shortcode.

(You can also load a custom template for the TOS page by copying the plugin’s /templates/tos.php file to /wp-members/templates/tos.php in your theme folder. When using a custom template, you can customize the HTML in any way you wish – the template is loaded as a complete page. )

Dialogs on Multi-language Sites

The default values for all dialogs are included in the plugin’s core object class so that they will be part of the translation files.  If you are using a multi-language site, you should not change any of these dialogs unless you plan to use custom translation files that match your custom messages.  Translation through gettext() only occurs for strings that are an exact match, so once you change a dialog, it will no longer match what is stored in the translation file.