/

CM Registration (CMREG) - Shortcodes - Displaying Login Button, Registration Form, Changing Password, and More


Using Shortcodes

Back to User Guide

How Shortcodes Work

Shortcodes are simple codes contained within square brackets such as   [example-shortcode].

Some have parameters, which can be written before closing the bracket, as in [example-shortcode parameter="value"]

To learn about them, go to the WordPress dashboard and navigate to  CM Registration Pro → Shortcodes.  This page shows every supported shortcode, with explanations and examples. 

Table of Contents

  1. Login
    1. Login Button
    2. Logout Button
    3. Login Form
    4. Social Login
  2. Registration
    1. Registration Form
    2. Registration Button
    3. Login and Registration
  3. Password and Utilities
    1. Lost Password
    2. Change Password
    3. Reset Password
    4. Edit Profile Form
    5. Show Last Login Date
  4. Invitation Codes
    1. Let User Create Invitation Code
    2. Show Invitation Codes Created by User
    3. Show People Invited by User
    4. Show Text to Invited User

1) Login Shortcodes

Login Button

[cmreg-login]

Add this shortcode to display a login button on pages or posts.

Optionally, you can:

  • Customize the button's text - add it inside the shortcode, as shown:
      [cmreg-login]Enter the custom text here[/cmreg-login]
  • Add a redirect page - use the "redirect-to" parameter (feature added in version 2.7.5). The following example will direct the users to www.yoursite.com/dashboard:
    [cmreg-login redirect-to="/dashboard"]
  • Show a simple button after user logs in - instead of the logout button. Use the "after-login" parameter with the value 1, as shown:
      [cmreg-login after-login=1]
    • Customize the after login button - use the "after-text" parameter and specify the label. Can only be used with after-login=1: [cmreg-login after-login=1 after-text="Insert Text Here"]

[cmreg-logout-btn]

Add this shortcode to display a logout button on pages or posts. 

Optionally, you can 

  • Customize the button's text - add it inside the shortcode, as shown:
      [cmreg-logout-btn]Text[/cmreg-logout-btn]

Login Form

[cmreg-login-form]

Displays login form.

Optionally, you can:

  • Add a link to the registration page - By using the "registration_url" attribute. For example, this shortcode will display a link to the registration page. In this case, www.yoursite.com/registration:
    [cmreg-login-form registration-url="/registration"] 
  • Define the text for the registration page link - By using the "registration_link" attribute, as shown:
    [cmreg-login-form registration-link="Click here to register"] 
  • Show different info to logged in users - Pass text or HTML that will be displayed for the logged-in users instead of the login form by putting it between the shortcode tags:
    [cmreg-login-form] You are already logged-in[/cmreg-login-form]
  • Show social login buttons - Use the parameter "social_login" with 1 to show or 0 to hide. Examples:
    [cmreg-login-form social_login=1] [cmreg-login-form social_login=0]
  • Redirect users after login - Use the parameter "redirect-to" to send logged in users to a certain page. (Feature added in version 2.7.5)
    This example will send them to www.yoursite.com/welcome:
    [cmreg-login-form redirect-to="/welcome"]

Social Login 

[cmreg-social-login]

Displays the button that site visitors can use to login using Facebook.


2) Registration Shortcodes

Registration Form

[cmreg-registration-form]

Displays registration form.

Optionally, you can:

  • Add a link to the login page - By using the "login_url" attribute. For example, this shortcode will display a link to the login page. In this case, www.yoursite.com/login:
    [cmreg-registration-form login-url="/login"] 
  • Define the text to the login page link - By using the "login_link" attribute, as shown:
    [cmreg-registration-form login-link="Click here to login"] 
  • Choose a role that the new users will receive - By using the "role" attribute. For example, this shortcode will register users as editors:
    [cmreg-registration-form role="Editor"]
  • Show social login buttons - Use the parameter "social_login" with 1 to show or 0 to hide. Examples:
    [cmreg-registration-form social_login=1] [cmreg-registration-form social_login=0]
  • Redirect users after register - Use the parameter "redirect-to" to send logged in users to a certain page. (Feature added in version 2.7.5)
    This example will send them to www.yoursite.com/welcome:
    [cmreg-registration-form redirect-to="/welcome"]

Registration Button

[cmreg-registration-button]

Displays the registration button and the registration form is being opened in the overlay after clicking the button.

  • Customize the button's text - add it inside the shortcode, as shown:
    [cmreg-registration-btn]Click here[/cmreg-registration-btn]

Login and registration buttons

Attributes

Note on using URL attributes

Use a # before the first parameter, ? before the second and & before the subsequent ones. This ensures the URL will be proper.

Learn more: Query string - Wikipedia

You can add the login action on any link using the following URLs (href attributes).

  • #cmreg-login-click - will produce both login and registration form in the overlay.
  • #cmreg-only-login-click - will produce only the login form in the overlay.
  • #cmreg-only-registration-click - will produce only the registration form in the overlay.
  • #cmreg_popup_open=1 - will automatically trigger the pop-up box. Requires that the destination link has the [cmreg-login] shortcode.
  • ?redirect_to=/dashboard- add a URL to redirect to this address.
    • &after_login=1 - shows a simple button after the user logs in, instead of the logout button.
    • &after_text=AnyText - Customize the text of the after login button.
Examples
  • Link to login
    <a href="#cmreg-login-click">Add label here</a>
  • Link to login and redirect to the dashboard page
    <a href="#cmreg-login-click?redirect_to=/dashboard">Add label here</a>
  • <a href="#cmreg-login-click?redirect_to=/dashboard&after_login=1&after_text=AnyText">Add label here</a>

How to Customize Links

The following example shows how to add the separate Login button and the Registration button to your Wordpress menu ( wp-admin Dashboard → Appearance → Menus):

You can add also the button which will show the login and registration forms at once:

This will produce the new menu links on the front-end:

Notice: the login buttons will be replaced by the Logout buttons when the user is logged-in.

Clicking on each link will show the login or/and registration forms up floating over the website content:


3) Password and Utilities Shortcodes

Lost Password

[cmreg-lost-password]

Displays lost password form.


Change Password

[cmreg-change-password]

Displays fields to reset the password.

Parameters

  • showheader - whether to show or not the header with the text "Change Password" (0 for no, 1 for yes). The default is 0.

Optionally, you can:

  • Show the header with the "Change Password" text - By using the "showheader" attribute with 1 to show and 0 to hide. Examples:
    [cmreg-change-password showheader=1] [cmreg-change-password showheader=0] 

Reset Password (For The Lost Password Page)

[cmreg-reset-password]

Displays one field to reset the password.


Edit Profile Form

[cmreg-edit-profile]

Displays the form that registered users can use to update their profile information.


Show Last Login Date of Specific User

[cmreg_login_date id="user_id"]

Displays the last login date of a specific user. 

This shortcode requires the option "Log user last login date" to be enabled. You can find it under   CM Registration Pro  Settings → Login. Learn more: Settings - Login Settings


4) Invitation Codes Shortcodes

Let User Create Invitation Code

[cmreg-create-invitation-code]

Displays the form that a user can utilize to invite his friends or just create the invitation codes.

Parameters:

  • expiration - set the invitation code's expiration date in format YYYY-MM-DD HH:MM:SS or give the time period as 30 days.
    You can  use the following English words: minutes, hours, days, weeks, months or years.

  • userslimit - number of users that can use the invitation code.

  • verifyemail - one of: global, 1, 0. Whether to require a user registered with this code to verify his email address.

  • emailinput - 0 or 1 - whether to show the email address input field to send the invitation code to or not.

  • role - set a Wordpress role that a user registered with this invitation code will be assigned to. If empty then use the role from the plugin settings.

  • showparams - 0 or 1. Show the parameters that the invitation code will have.

  • showlink - 0 or 1. Shows a link that can be followed to claim the code

Examples

[cmreg-create-invitation-code expiration=2 weeks' role=client userslimit=1 emailinput=1 showparams=1 showlink=1]


Show Invitation Codes Created by User

[cmreg-list-users-invitations]

Displays the table with all invitation codes created by the current user.

Parameters:

  • used - Filter which should be displayed. 
    • all - all invitations (default)
    • yes - invitations that were accepted
    • no - invitations that were not used

Example:

[cmreg-list-users-invitations used="yes]


Show People Invited By User

[cmreg-my-users-from-codes]

Displays the table with all people invited by the current user and that accepted the invite. Includes their ID, name, email and invitation code.


Show Text to Invited User

[cmreg-Invited-by-info]

Shows the username of the person that has invited the current user. If the user is not logged-in or was not invited by any one, he/she will not see any content.

Parameters:

  • show-label - Show additional text other than the username (0 for no, 1 for yes). The default is 1.
  • label-text - Customize the text. The default is "Invited by: ".

Examples

  • [cmreg-Invited-by-info]
  • [cmreg-Invited-by-info show-label="0"] - Will only display the username.
  • [cmreg-Invited-by-info show-label="1" label-text="You were invited by the user: "] - Will display "You were invited by the user: username"

More information about the CM Registration and Invitation Codes Bar WordPress  Plugin

Other WordPress products can be found at CreativeMinds WordPress Store

Let us know how we can Improve this Product Documentation Page

To open a Support Ticket visit our support center