General Shortcode Options

The shortcode reference includes all shortcodes available for UserPro, plus all options you can use within the shortcodes and what they do exactly. Use this guide to create the shortcode you want and customize it to your needs.

This is documentation for general shortcode options. For detailed options for each shortcode, you can skip that part.

Available Options

template

The template tells UserPro which template to show. E.g. template=login, template=view, template=register etc.

max_width

This sets the plugin width. By default this is set to 480px. (Or whatever option you set for width in backend) To make the plugin shortcode expand to 100%, use max_width=100% % or px values are accepted. This option can be set globally in plugin settings.

profile_thumb_size

This option controls the thumbnail size of profile picture in view/edit mode. Enter numeric size. By default this is set to 100. e.g. profile_thumb_size=80 will show 80 pixels profile picture.

no_header

If you set this option to true, the shortcode header will not be displayed allowing you to put your custom header.

no_style

If you set this option to true, the shortcode will appear in a plain style to match your own design/background.

layout

This controls the layout of fields. The value can be ‘float’ or ‘none’, by default this value is ‘float’ It means the label will try to float to left of field. If you set this to none, the label will be on a seperate line in your form.

margin_top

Set the top margin of your shortcode. By default, the top margin is 0.

margin_bottom

Set the bottom margin of your shortcode. By default, the bottom margin is 30px.

align

This option controls the alignment of your shortcode. By default align is set to ‘center’. Possible values are center, left, right, or none.

skin

Skin name to use for this shortcode. By default, skin is set in plugin settings. Default skin is ‘default’.

keep_one_section_open

This can be 1 or 0. If this is turned on, only one collapsible section will be open at one time. To disable this, please set this option to 0.

allow_sections

This option can turn on/off field groups/sections even If you have sections enabled on your form. If you set this to 0, sections will be disabled and fields will appear without sections. Default value is 1.


 

[userpro template=view]
Responsible for showing profiles on the frontend.

Available Options

user

To show the profile of post author, use user=author, and If you want to show or promote the profile of specific user, set user=Username in your shortcode. By default the shortcode displays the current profile, or viewed profile via URL.

header_only

Set header_only=true to show the profile header only (compact view) without the full profile details. Perfect if you want to show profile heading only including social icons and not the complete profile.

include_fields

A comma seperated list of custom fields (or field keys) you want to show in the profile view only. This will exclude any other fields than the one you specify in that option.

include_fields_by_name

The same as above option but uses field name instead of field key (e.g. include_fields_by_name=”First Name,Last Name”) will show only first and last name on the profile.

include_fields_by_type

This include fields based on the allowed field types you set here. A comma seperated list of field types will work. Example: include_fields_by_type=select,radio will show only these fields that are select dropdown or radio group. include_fields_by_type=picture,file will include only photo upload fields and files.

exclude_fields

A comma seperated list of custom fields (or field keys) you want to exclude from profile view.This will include any other fields than the one you specify in that option.

exclude_fields_by_name

The same as above option but uses field name instead of field key (e.g. exclude_fields_by_name=”Age,Region,etc.”) will exclude these fields from appearing on profile.

exclude_fields_by_type

This exclude fields based on field types you set here. A comma seperated list of field types will work. Example: exclude_fields_by_type=textarea will hide any fields that are textarea fields. exclude_fields_by_type=picture,file will exclude photo upload fields and files.

[userpro template=memberlist]

This shortcode displays the member directory. The shortcode has many options that you can customize.

Available Options

memberlist_v2

This can be 1 or 0. Enable/disable the new member directory (v2) It is enabled by default, but you can turn it off by setting this to 0.

memberlist_v2_pic_size

This controls the size of user picture in memberlist v2, default is 86 (pixels)

memberlist_v2_fields

A comma seperated list of fields that will be displayed below user name in member directory. By default this option is set to memberlist_v2_fields=age,gender,country by default. To customize this option pass a comma seperated list of fields to display here. Example: memberlist_v2_fields=city,age,country

memberlist_v2_bio

Show/hide the user description in member directory v2, by default this is set to 1. To turn it off set it to 0.

memberlist_v2_showbadges

This option can be 1 or 0, it shows/hides the user badges from member directory v2.

memberlist_v2_showname

This option can be 1 or 0, it shows/hides the user display name from member directory v2.

memberlist_pic_size

This controls the user image size in the standard member directory, by default the image is 120 (pixels)

memberlist_pic_topspace

This is the top margin of each result in member directory in pixels. Enter 0 to remove all margin on top. Default is 15 pixels.

memberlist_pic_sidespace

This is the side margin of each result in member directory in pixels. Enter 0 to remove all margin on sides. Default is 30 pixels.

memberlist_pic_rounded

This can be 1 or 0. Enable/disable rounded user images in member directory.

memberlist_width

This controls the maximum width of member directory relative to its parent. For example, if you want it to take only 50% of the parent, enter 50% in this option. By default it is set to 100% of its parent.

memberlist_paginate

Turn on/off pagination on member directory. By default this is set to 1 (Enabled)

memberlist_paginate_top

Turn on/off top side pagination on member directory. By default this is set to 1 (Enabled)

memberlist_paginate_bottom

Turn on/off bottom side pagination on member directory. By default this is set to 1 (Enabled)

memberlist_show_name

Show or hide the user name in member directory. This can be 1 or 0.

memberlist_popup_view

If set to 1, profiles will open in a popup instead of opening in new link. By default this is disabled (set to 0)

memberlist_withavatar

Show only members who have custom avatar. This is turned off by default, to enable set it to 1.

memberlist_verified

When turned on (set to 1) it will list only these members that have been verified by admin and have the Verified badge beside their name. By default this is turned off.

memberlist_filters

A comma seperated list of custom fields that you want to allow for searching thru the main search input. Left blank by default. (Since you can now add custom search filters seperately! Please look at the tutorial in the forum.)

per_page

How many members do you want to show per page. Default is 12

sortby

This controls the way members are sorted. By default this is set to ‘registered’ ordering members by registration date.

order

This can be desc or asc. It means order results in Ascending vs Descending mode.

relation

This can be either ‘and’ or ‘or’. It controls the relation between custom queries sent to do a custom filter/search on member. Example, when using ‘and’ as relation, you can filter users who are Male and live in Japan, and If set to ‘or’ you can get users who are Male OR live in Japan.

search

Turns on/off search feature on your member directory shortcode. By default this is set to 1.

role

Passing role=X will return users who have a specific role only. This can be multiple roles also. Example: role=author will return authors only, role=author,editor will return both authors and editors, etc.

Custom Field Filtering

To return users who meet a custom field condition. You can pass in this format custom_field=custom_value. Examples: country=”United States” will return all users from United States, you can also use comparison for example age=”18:25″ will match condition that user must be between 18 and 25 years whilst mixing custom fields like this: age=”>18″ country=”United States” will return users who live in Unites States and are older than 18 years old. You can use your custom fields to do custom filters the same way.


 

[userpro template=card]

Display beautiful profile cards anywhere for the users you want. By default this shortcode shows the profile card of current profile.

Available Options

user

This can be ‘author’ or ‘custom_username’, if you set this to author, the card of post author will be dynamically shown (e.g. on his posts/pages, etc). If you set user to a custom username, the card of that user will be displayed. Most regular usage is user=”author” which will display the card of author automatically.

card_width

This is the optimal card width, should be a complete value including pixels. The default value is 250px.

card_img_width

Should match the card width except that you do not need ‘px’ in the value.The default value is 250.

card_showsocial

This can turn on/off the social links in the elegant card profile. Default value is 1.

card_showbio

This can turn on/off the user description in the elegant card profile. Default value is 1.


 

[userpro template=list]

Show members in a compact list/style.

Available Options

list_heading

This overrides the default heading title for this widget. Default heading is ‘Latest Members’.

no_heading

Setting this to true will disable the heading from this widget so you can apply your custom coded heading.

no_style

Setting this to true will disable the default box style applied to the compact members list so you can integrate/make it look like part of your background and design.

list_per_page

Number of members to return. By default the plugin will return 5 users in compact list. You can adjust that number via this option list_per_page=X.

list_sortby

Sort members by which rule, by default it sort members by ‘registered’ (Registration date) you can change this setting to sort members by name, e-mail, or another supported sorting method by WordPress.

list_order

The order in which members are displayed. By default it sort members in descending mode, default value is ‘desc’.

list_users

A comma seperated list of the users you want to promote or show in your compact members list. This will override the default members and will show only users you specify here. For example, you can show staff, or specific users (list_users=user1,user2,user3) etc.

list_thumb

This controls the width of thumbnail that is being displayed in compact member list. By default this is set to 50.

list_showthumb

This can turn on/off the thumbnail display in compact members list. Default value is 1.

list_showsocial

This can turn on/off the social links in compact members list. Default value is 1.

list_showbio

This can turn on/off the user description in compact members list. Default value is 1.

list_verified

If you set this to 1 It means you will show only members who have the verified badge on their profile. Default is 0 turned off.

list_relation

This controls the relation of meta queries, can be either ‘and’ or ‘or’. The default value is ‘or’.


 

[userpro template=register]

Embeds the registration shortcode where the shortcode is placed.

Available Options

register_heading

This overrides the default heading that displays in Registration form. Default heading is Register an Account.

register_side

This controls the side text link in Registration heading. Default is ‘Already a member?’

register_side_action

This is the action that is taken when the link is clicked on side. Default to ‘login’ will show a login form to user.

register_button_primary

This is the text that appears on Register button. Default to Register.

register_button_secondary

This is the text that appears on 2nd button, default to Login. Leave blank to disable this button.

register_button_action

This is the action that happens when the 2nd button is active (if it is enabled). By default it is set to ‘login’ (Will login user instead of register)

register_redirect

This is blank by default. Enter a custom URL if you want users to be redirected to a specific page after registration.

register_recaptcha

This can turn on/off recaptcha on registration forms. By default this is set to the global option you specified in plugin options for this.


 

[userpro template=login]

Embeds the login shortcode where the shortcode is placed.

Available Options

login_heading

This overrides the default heading that displays in Login form. Default heading is Login.

login_side

This controls the side text link in Login form heading. Default is ‘Forgot your password?’

login_side_action

This is the action that is taken when the link is clicked on side. Default to ‘reset’ will show a password reset form.

login_button_primary

This is the text that appears on Login button. Default to Login.

login_button_secondary

This is the text that appears on 2nd button, default to Create an Account. Leave blank to disable this button.

login_button_action

This is the action that happens when the 2nd button is active (if it is enabled). By default it is set to ‘register’ (Will register user instead of login)

login_redirect

This is blank by default. Enter a custom URL if you want users to be redirected to a specific page after login.

login_recaptcha

This can turn on/off recaptcha on login forms. By default this is set to the global option you specified in plugin options for this.


 

[userpro template=postsbyuser]

Display the posts made by user in grid or simple list layout.

Available Options

postsbyuser_mode

This can be ‘grid’ or ‘compact’. Choose in which layout to show the posts made by user.

postsbyuser_num

Number of posts to return. Default is 12.

postsbyuser_types

This controls which post types are included in the post list. By default it shows ‘posts’ only. You can enter a comma seperated list of post types, e.g. to show posts, products, and custom post type enter postsbyuser_types=post,product,custom_type and to show all post types use postsbyuser_types=any (This option uses custom post type slugs)

postsbyuser_thumb

This controls the size of post thumbnail if you are using ‘compact’ mode to display post list. By default this is set to 50 pixels.

postsbyuser_showthumb

This show/hide the thumbnail of post when using the ‘compact’ mode to display post list. By default this is set to 1.

user

This option can specify which user to return post list for. By default, it displays current user posts, or current profile posts. To show posts made by AUTHOR, set user=author and to show posts made by specific user set user=Custom_user

Was this article helpful?

Related Articles

Leave A Comment?