Back to top

Table of Contents / User Guide

Getting Started

Welcome to the online help and documentation for UserPro. If you have just purchased UserPro, please browse the following docs to get started as soon as possible with the plugin.

If you're looking for PHP / API Resources and Integration via PHP visit the following docs please

Go to Code Documentation

Installing UserPro

If you have just purchased UserPro, please make sure to download the most updated version of the plugin (which is available through our customer portal only) The first step is to make sure you already have the latest code running from here.

Get Latest Version

Installing UserPro on your WordPress site

Default Setup

When you activate UserPro, the plugin will automatically create the necessary frontend pages, and installs default settings. You're ready to use it immediately without doing any changes. The plugin automatically creates:

If for some reason, the fields appear missing or page setup looks incomplete, you can try to re-install UserPro completely from your admin panel. How to re-install UserPro?

Reinstalling UserPro

This option will reset plugin to factory settings including all fields and initial pages.

When something goes wrong, you can always try to reset UserPro to factory settings by re-installing it completely from the plugin admin panel.

Access your WordPress dashboard and navigate to UserPro > Customize Fields after that click on the button that says Re-Install UserPro (Warning: This will reset all fields and settings) to reset the plugin and reinstall everything!

Upgrading

There are two ways to upgrade UserPro to the latest version.

Do not worry! You will not lose any settings or custom fields If you upgrade using the following instructions.

Method 1: Upgrading via the WordPress dashboard

Method 2: Upgrading via your FTP server

Troubleshooting

This section will help you find and debug issues that you may encounter while using the UserPro plugin and how to resolve them. If your issue is not listed here, please submit a support request in our forums.

A Lot of Whitespace / Display Does Not Look Right

If your shortcodes or profile looks odd (e.g. Some big whitespaces, Facebook connect not working, and overall elements DO NOT look like the live demo!) this can be caused by:

Adding auto-paragraphs to all shortcodes is not a proper code and leads to cause problems to UserPro shortcodes. If you have such an issue, you can debug it yourself and fix it.

Here is the solution

To have your theme/plugin debugged, please submit a support request in our forums.

Profile pictures DO NOT appear

This can be due to incorrect file permissions preventing profile pictures cache from working properly. To resolve/debug this issue, please click on the profile picture to check what errors you get in the address bar.

Before trying the following solution please make sure that gravatars is turned on under your WordPress > Discussion Settings

Go to Settings -> Compatibility Settings -> Toggle URL Encodings value.

If still problem persists, please make sure you have the following on your server:

If you've done all that, and cannot get thumbnails to work, please submit a topic

This can happen accidentally, when you go to view another member profile you get a 404 error (Not found) what you need to do in most cases is just saving your permalink structure under WordPress settings. Try the following steps to correct this problem:

If the above solution didn't work please try the following solution:

If the above solution didn't work please try the following for test purposes only:

If it works now, then you have a plugin/theme that conflict with UserPro. You can try to figure out which plugin/theme is causing a conflict, but If you could not fix it, please submit a topic

Twitter login just refresh the page?

This may be due to invalid callback URL in your app settings. To fix this issue please do the following step, in addition to the standard Twitter setup.

Redirects to my profile when user goes to the campaign application page in Fundify

Use this shortcode on your page

[userpro template=login force_redirect_uri=1]
[userpro_private]
[appthemer_crowdfunding_submit]
[/userpro_private]

Custom fields with shortcodes not working

The 'Unique Field Key' must be lower case 'Field Title' can be any case, but the 'Unique Field Key' must be lower case.

Restrictions set by UserPro automatically

Try to remove this line from functions/template-redirects.php

add_action('template_redirect', 'userpro_global_page_restrict');

CSS FIX for Front-end editor.

Currently you can only type about 7 lines of text before your text disappears. This CSS needs to be added so that the editor will automatically add a scrollbar to your entry. Add this code to any CSS stylesheet to automatically add a scrollbar to your entry.

iframe#userpro_editor_ifr {
overflow: scroll !important;
}

Non-approved members show up even when not approved.

That’s normal, until you delete or accept a member. They cannot login though.

Twitter API not working for login

Try clearing it and re-saving it. If not, do clear out the unused junk, user stuff, purge online users under the quick maintenance.

Author and comments picture out of frame

div.userpro-awsm-pic {
margin-left: -48px !important;
top: -48px;
.comment-list .modified.avatar {
border-radius: 999px;
}
}
div.userpro-profile-img {
height: 80px; width: 80px;
}
.userpro-sc-left br {
display: none;
}
div.userpro-sc-bar {
height: 38px;
}
.author-image img {
border-radius: 999px;
}

Not all of the pre-installed fields are showing

There are 24 pre-installed fields with UserPro. Very rarely you may find that not all of the fields are showing when you install UserPro. If this happens on your install please try clicking the "restore default fields" button which is located on the fields page just above the 24 fields on the right hand side.

If this does not resolve the issue please try installing UserPro again.

Cache plugin stopped UserPro from working

For the time being we recommend exluding UserPro pages from being cached to ensure UserPro works on your site.

Most of the popular cache plugins available do not cache pages for logged in users anyway due to security issues.

UserPro slowing website down

If you are experiencing a slowdown in your site after installing UserPro it is probably due to your hosting provider not having the resources to handle our activity feature.

To speed up your site you can try turning off the activity log. Go to Settings > Compatibility > Turn-off activity log.

JSON.parse : SyntaxError error on site

This error can be caused by several factors but in the vast majority of cases it is due to a theme/plugin conflict.

To find out what is causing this error please first change your theme to the default theme.

If after changing to the default WordPress theme the error is still showing, please deactivate all other plugins and activate them one by one.

If after checking all the plugins and the error still does not go away, it may be due to a WordPress memory issue and will require you to increase the memory of your site.

If the error still exists after doing all of this, please get in touch via email and we will look into what is causing the error.

Langauge Translation

You can create a PO file for the translations in your language and then you can create a MO file out of that.

There are several PO to MO generator available online for free.

Invite User Widget

The Invite User widget will be displayed in the sidebar when you enable the "Allow only invited users to register" in the backend setting of UserPro plugin.

To do this, you need to go to : UserPro -> Invite User -> Allow only invited users to register , Set this option as "Yes" to display the invite users widget on the frontend of your website.

Facebook App is in development mode

You will need to enable the public access for the Facebook App : Facebook App -> App Review -> Make UserPro plugin test site public?

LinkedIn Redirect URL

The redirect URL for the LinkedIn app should be as follows : http://www.example.com/wp-content/plugins/userpro/lib/linkedin-auth/linkedinAuth.php

Instagram Redirect URL

The redirect URL for the LinkedIn app should be as follows : http://www.example.com/wp-content/plugins/userpro/lib/instagram-auth/instagramAuth.php

Saving fields group in admin section - keeps the circle spinning

Please check if php extension "mbstring" is enabled on the server.

Hide WordPress login or register and replace it by UserPro login or register

For redirecting the WordPress Login to UserPro Login : Go to UserPro -> Settings -> Redirection & Backend Settings -> Redirect backend login to frontend

For redirecting the WordPress Registration to UserPro Registration : Go to UserPro -> Settings -> Redirection & Backend Settings -> Redirect backend register to frontend

Activate UserPro License Manually

To activate license of UserPro manually you need to add code for this in your theme functions.php file. Please add the below code in your themes functions.php file and then refresh the page of your website from frontend and check , but please not that after refreshing the site please remove the below given code from your site. heres the code -

global $userpro; $userpro->validate_license('xxx');

Note :- please add this in theme functions.php file in place of XXX - please put this - 'purchase code'

Activate UserPro-Lite License Manually

To activate license of UserPro-Lite manually you need to add code for this in your theme functions.php file. Please add the below code in your themes functions.php file and then refresh the page of your website from frontend and check , but please not that after refreshing the site please remove the below given code from your site. heres the code -

global $userpro_lite; $userpro_lite->validate_license('xxx');

Note :- please add this in theme functions.php file in place of XXX - please put this - 'purchase code'

How to make an entry to PO file

For example you need to add : "Resend Verification Email" into the PO file. You have to add it manually. Please follow below steps to add text into PO file.

1. Go to wordpress/wp-content/plugins/userpro/languages directory and open the file for your language

2. Find "Forgot your password? " text and add "Resend Verification Email" text below "Forgot your password? " text

3. Add the translation for the above line and save it.

4. Then create new .mo file using http://po2mo.net and save it into plugins/userpro/languages folder.

Fix for error - "Could not retrieve data"

Recently some of our users are reporting this issue of "Could not retrieve data". The issue is arising due to some problem with the envato interfacing.

The problem will be fixed in the next release urgently - but you can get this resolved manually as mentioned below:

Please try deleting the "cache" folder in the root directory of your WordPress website - this should solve the issue about "Could not retrieve data".

If you are not comfortable doing that, please drop a note via - http://codecanyon.net/user/DeluxeThemes#contact , with the details of your website, so that our support team can have a look at it and get the issue to closure there?

Fix for error - "Parse error: syntax error, unexpected ’=’, expecting ‘)

For an intermediate fix, please try replacing the following file in this location - userpro/functions/ajax.php

Download and extract the zip file to get the "ajax.php" file.

Click here to download the zip for "ajax.php" file.

Fix for error (Google Map) - "Parse error: syntax error, unexpected ’=’, expecting ‘)

For an intermediate fix, please try replacing the following file in this location - userpro/addons/userpro-google-map/userpro-google-map.php

Download and extract the zip file to get the "userpro-google-map.php" file.

Click here to download the zip for "userpro-google-map.php" file.

Setting up Social Connect

This manual will help you through setting up your social connect apps and linking them with UserPro plugin to enable users to sign up/sign in with their social handles on your website.

Setting up Facebook Connect

  1. Create a new app in your Facebook account here: https://developers.facebook.com/
  2. In your app Settings screen, please make sure you have listed the website where you are going to use Facebook connect on listed in the App Domains and also make sure your domain matches the Site URL (see follow attachment for example)
  3. Copy your App ID from your Application Settings (you will need it later)
  4. Login to your WordPress dashboard and go to UserPro > Global Options
  5. Under Facebook Integration please enable Facebook connect and paste your App ID in the Facebook App ID field
  6. Save changes

You've now enabled Facebook connect on your WordPress site.

Setting up Linkedin Connect

  1. Create a new app in your Linkedin account here: https://developer.linkedin.com/
  2. Follow 1. Find your domain name and 2. Get an API key.
  3. In Application Form enter your Site URL for Website URL and JavaScript API Domains field.
  4. Look for Default Scope and check r_basicprofile and r_emailaddress
  5. Look for OAuth 2.0 Redirect URLs and enter

    http://your_site_url/wp-content/plugins/userpro/lib/linkedin-auth/linkedinAuth.php

  6. Fill remaining required fields & save your application.
  7. Login to your WordPress dashboard and go to UserPro -> Global Options
  8. Under Linkedin Integration please enable Linkedin connect and paste your Linkedin App key in the Linkedin App key field & Linkedin secret key in the Linkedin secret key field
  9. Save changes.

You've now enabled Linkedin connect on your WordPress site.

Setting up Instagram Connect

  1. Create a new app in your Instagram account here: http://instagram.com/developer/ . While creating the app remember to add Redirect uri as : 'http://your_site_url/wp-content/plugins/userpro/lib/instagram-auth/instagramAuth.php'.
  2. Edit the Instagram App's settings to make it work on your domain.
  3. Get your Client ID & Secret Key from the APP settings of your Instagram account. Copy the Client ID & Secret Key
  4. Login to your WordPress dashboard and go to UserPro -> Global Options
  5. Under Instagram Integration please enable Instagram connect and paste your Instagram Client ID in the Instagram Client ID field & Instagram Client Secret key in the Instagram Client Secret field
  6. Save changes.

You've now enabled Instagram connect on your WordPress site.

Setting up Twitter Connect

  1. Go to https://apps.twitter.com/ and create a new app
  2. In your Settings tab, you should setup your domain name like how we did for UserPro demo. Enter your website, and allow your app to be used to sign in Twitter. (See attachment for help)
  3. In your Permissions tab, please make sure you've enabled Read and Write Access to your application. Write access is required If you want to benefit from Twitter viral marketing, for example to allow automatic tweets posted to your user's timeline.
  4. Open your API Keys tab and copy your API Key and API secret you will need them later
  5. Now paste your API key and API secret (from previous step) to your WordPress admin under UserPro > Global Options > Twitter Integration settings (See following image)
  6. Make sure that Twitter Connect is enabled

For setting up Twitter App to fetch Email Address from users then please follow the steps below :

  1. Go to https://support.twitter.com/forms/platform
  2. Select the option "I need access to special permissions" and enter "Email Address" in "Permissions Requested" section
  3. Now sit back and relax - Twitter will get back to you after whitelisting your Twitter App with Additional Permissions for "Email Address"
  4. On Approval from Twitter Support, go to your Twitter app : https://apps.twitter.com/ and go to "Permissions" tab and you will get a section as "Additional Permissions"
  5. You can select the checkbox for the "Email Address" and now you should be able to pull "Email Address" from the users.

That is it. You should be ready to accept Twitter sign in via your WordPress site.

Setting up Google+ Connect

  1. Go to https://cloud.google.com/console/project and create a new project in your Google Console.
  2. Now go to : https://console.developers.google.com and select the project that you have recently created and Click on Enable API
  3. Now you will need to enable "Google+ API" under "Social APIs" and follow the steps to create a "OAuth Client ID". On next Screen you can select the "Web Application"
  4. From your OAuth Consent screen menu, ensure an email address is selected and product name is entered (your website name is fine). You may also wish to complete the optional sections further and add your website logo. Click Save.
  5. From your Credentials menu, please make sure that you have set your Redirect URIs to include your domain name where you will use Google connect and also added ?upslug=gplus to the URL to ensure that this auth will be specific to UserPro use only (See screenshot)
  6. Copy your Client ID and Client secret and your Redirect URIs from the same screen.
  7. Login to your WordPress dashboard and go to UserPro > Global Options > Google Integration
  8. Make sure that Allow Google Social Connect is turned on
  9. Paste your Client ID and Client secret and your Redirect URIs which you have collected at Step 5 in to the appropriate fields. Note: Your Redirect URI MUST MATCH and MUST INCLUDE ?upslug=gplus in both Google console and your settings

Setting up VK.com Connect

VK.com is a popular social network in Russia. Note: This feature is available only through VK.com Social Addon for UserPro plugin. To buy the VK.com social integration please click on the following link:

Buy VK.com Social Addon

Follow the next steps to setup VK.com social connect with UserPro plugin

  1. Go to https://vk.com/dev and create a new application
  2. In your app Settings, make your application visible and also make sure that your domain is listed in the base domain and site address
  3. Copy your Application ID and Secure key from your app Settings screen
  4. Login to your WordPress admin and go to UserPro > VK.com (Make sure you've already activated and installed the VK addon)
  5. Now enter your Application ID and Secure key in the admin settings and save changes

Viral Social Marketing

Viral Social Marketing is a key feature of UserPro plugin, It lets you market and reach unlimited number of social connected users without doing any extra work. This feature is completely optional, you can turn it on or off - and customize the post that is shared on user's wall.

How It Works?

When a new user connects to your website with his Twitter account, UserPro will automatically publish a custom post or tweet on his wall / timeline. The message can be fully customized in your UserPro admin panel.

How can this help me?

There are unlimited possibilities. If you're selling a product (Like how I do with UserPro), marketing or promoting a service, or just trying to bring traffic to your articles, e-shop, or online blog or business. You can customize the post/tweet and UserPro will do the rest! Reach thousands of users easily, because each tweet on user timeline will be visible to all his followers, and If you use hashtags your story can be popular and tagged under any specific hashtag - that means more people will reach you from social networks just when someone tries to connect to your site with his Twitter account.

This feature is being used actively to promote UserPro plugin. See how automatic posts/tweets look on users profile below.

Examples of Automatic Posts

These are real life samples from UserPro live demo, It helps with marketing the product - so you can use it for the same purpose, or any other purpose.

You can reach many users when someone signs up with Twitter, the tweet is automatically posted on his timeline. Here I have customized the message and added a hashtag that explains what the product is all about!

Setting up Viral Marketing

  1. Login to your WordPress dashboard and go to UserPro > Global Options
  2. Make sure you've already enabled Twitter connect and did the setup
  3. To enable Twitter Marketing scroll down, and turn on this option Auto Post on users Twitter timeline and customize your automatic tweet like the following example (taken from demo) and replace the tweet content with whatever you want.

You are now ready to go! Enjoy the social marketing of your app, product, or online website with this simple setup. You can change the message often whenever you need to adjust to new marketing needs and promote different things. Use your imagination, there's no limit.

UserPro Add-ons

UserPro has the following add-ons for your WordPress site

WordPress User Bookmarks for UserPro

WordPress User Bookmarks for UserPro Add-on will allow users to bookmark any content they want, posts, forum topics, custom posts, and also manage their bookmarks into collections. The add-on offers a simple way to show the bookmarks and bookmark widget and can be integrated into any theme.

You can embed the bookmark widget via shortcode (in addition sidebar widget and automatic embedding)

How to Embed This Shortcode in Editor

[userpro_bookmark]

How to Embed This Shortcode with PHP

global $userpro_fav;
echo $userpro_fav->bookmark();

To show collections

How to Embed This Shortcode in Editor

[userpro_bookmarklist]

How to Embed This Shortcode with PHP

global $userpro_fav;
echo $usrepro_fav->bookmarks();

To show public collections

How to Embed This Shortcode in Editor

[userpro_publicbookmark]

How to Embed This Shortcode with PHP

global $userpro_fav;
echo $usrepro_fav->bookmarks();

Note : You need the UserPro Bookmark add-on in order to use the above shortcodes. Please click the following link to download the add-on :

Get Bookmark Add-on for UserPro

User Rating Add-on for UserPro

User Rating Add-on for UserPro adds a user rating system to your WordPress site.

No back-end settings are required for the add-on. Just activate the add-on & only one shortcode is needed to enable user rating on your site.

How to Embed This Shortcode in Editor

[userpro template=rating] [userpro template=rating top_members="number_of_users_to_show"]

How to restrict particular role from rating?

Go to UserPro -> User Rating -> General Settings -> Restrict Roles From Ratings , and Enter the roles you want to restrict from rating and reviewing the users.

How to set certain roles to rate or submit review for other roles?

Go to UserPro -> User Rating -> General Settings -> Editor Can Rate or submit Review to or Author Can Rate or submit Review to etc , and Enter the roles you want to rate or submit review for other roles.

How to enable User Reviews in UserPro Rating add-on?

No back-end setting required for enabling reviews in add-on , you just have to create one page with this shortcode.

[userpro template=reviews]

Setting Anonymous reviews.

You can enable Anonymous review by going to : UserPro -> User Ratings -> General Settings -> Enable Anonymous Review.

Note : If enabled, then only review comments will be shown. If disabled, then user profiles and user names of the user who submitted the review comment will be shown on the review page.

Length of Characters in the Review

Embed the number of characters to set the length of characters in your Review.

About Widget as Top Members

You can show a widget in the your WordPress to let others know about the top rated members.To embed a wigdet - GoTo Apperance->Wigdets->Top Members-> Set Title and Number of Users to show in the list of rated members.

Note : You need the latest version of UserPro (or minimum version 2.4) & User Rating Add-on for UserPro in order to use the above shortcode. Please click the following link to download the add-on :

User Rating Add-on for UserPro

Private Messaging Add-on for UserPro

This plugin adds private messaging between users, and allow users to receive notifications about new messages, view conversations, reply to other users. It includes nice features such as emotions, nice Ajax notifications, easy conversations and quick-reply.

Just activate the add-on & only one shortcode is needed to enable private messaging on your site.

By default the Private Messaging feature will be added to your Profile Page. You can use the add-on on any post / page / widget with the help of the shortcode.

How to Embed This Shortcode in Editor

[userpro_mymessage]

How to change admin default message?

Go to UserPro -> Private Messagining -> Automated Welcome Message -> Message Body -> Change the message according to the need of an admin.

How to broadcast a message?

Go to UserPro -> Private Messagining -> Broadcast Message -> Enable the Broadcast Message Settings and enter the roles that will be able to broadcast messages to all other users

Show messages of logged-in user

[userpro_message_list]

Note : You need the latest version of Private Messages for UserPro in order to use the above shortcode. Please click the following link to download the add-on :

Private Messages for UserPro

Media Manager Add-on for UserPro

This plugin adds Media gallery capability to user profiles.

Just activate the add-on to enable Media Gallery on your site.

By default the MediaManager feature will be added to your Edit Profile Page / View Profile Page. A preview will be displayed for all the media uploaded by the user.

Some features of MediaManager Add-on for UserPro are as follows :

Note : You need the latest version of Media Manager for UserPro in order to enable the Media Gallery. Please click the following link to download the add-on :

Media Manager for UserPro

Social Wall Add-on for UserPro

Let your members interact with each other on a social wall.

Just activate the add-on & create a page "Social Wall" with the shortcode as follows :

[userpro template=socialwall]

For settings of the Social Wall add-on, go to WordPress Dashboard > UserPro > SocialWall. Specify a title for your Social Wall & the number of posts (social feed like status updates & comments) to display on the page.

Some features of Social Wall Add-on for UserPro are as follows :

Note : You need the latest version of UserPro (or minimum version 2.15) & Social Wall for UserPro in order to to use the above shortcode. Please click the following link to download the add-on :

You can also have a look at the Youtube video for more information : How to use UserPro Social Wall Add-on

Social Wall for UserPro

Payment Add-on for UserPro

This plugin allows you to charge your visitors to register on your site.

For settings of the Payment add-on, go to WordPress Dashboard > UserPro > Payment Settings. Enter the necessary details and click Save Changes when you are done.

Some features of Payment Add-on for UserPro are as follows :

How to Set up to pay via Stripe

Create an account on http://www.stripe.com and get the publishable key and secret key and set up the check out page at UserPro -> Payment Settings.

Note : You need the latest version of UserPro (or minimum version 2.15) to use this add-on. Please click the following link to download the add-on :

You can also have a look at the Youtube video for more information : How to use UserPro Payment Add-on

Payment Add-on for UserPro

MyMail Addon for UserPro

This addon integrates UserPro with MyMail , so you can now easily use MyMail to send mailers to your UserPro Members list.

For settings of the Mymail add-on, go to WordPress Dashboard > UserPro > Newsletter Option > MyMail Setting > Select the checkBox for MyMail Integration.

After selecting checkbox you only need to add the "Subscribe to newsletter" field in your Fields Group.

Note : You should have at least UserPro V2.31 or later and latest version of MyMail - Email Newsletter Plugin for WordPress to use it. Please click the following link to download the add-on :

MyMail Addon for UserPro

FeedBlitz Addon for UserPro

This addon integrates with FeedBlitz. Keep your users updated with the current news using the FeedBlitz UserPro addon.

  1. Create a new app in your Feedblitz account here: https://www.feedblitz.com/f?pl_api/
  2. Copy your API Key , Feed ID and Publisher ID from your Application Settings (you will need it later)
  3. Login to your WordPress dashboard and go to UserPro > Newsletter Option > FeedBlitz Settings
  4. Under FeedBlitz Settings paste your API Key,Feed ID and Publisher ID in the setting fields
  5. Save changes
  6. After saving the changes you only need to add the "Subscribe to newsletter" field in your Fields Group.

Note : You need the latest version of UserPro (or minimum version 2.31) to use this add-on. Please click the following link to download the add-on :

FeedBlitz Addon for UserPro

Tags Addon for UserPro

Tags add-on for UserPro allow users to add tags to their profiles easily. Tags provide a useful way to group related profiles together. Also make it easier for people to find out related user profiles.

How to add tags.

  1. Go to WordPress Dashboard > UserPro
  2. Here you can see multiple tabs. Click on Fields tab.
  3. Fields tab contains two sections named Groups & Fields and 31 fields available
  4. Under 31 fields available section tags field is available. You just have to drag and drop this field to Registration Fields or Edit Profile Fields
  5. Save changes

How to create Tags.

  1. Go to WordPress Dashboard > UserPro > Create Tags

How to search Tags.

  1. To search tags click on tag which is available on users profile or also you can search it by following url
    https://enter_your_site_url.com/members/?tags=php

You can also have a look at the Youtube video for more information : How to use UserPro User Tags Add-on

Tags Addon for UserPro

WooCommerce Integration for UserPro

Using WooCommerce integration addon you can integrate woocommerce orders and purchases with UserPro profiles.

How to integrate woocommerce orders and purchases with UserPro profiles.

  1. Go to WordPress Dashboard > UserPro > WooCommerce
  2. Here you can see Order Tab Settings and Purchase Tab Settings. By using these settings you can show or hide order/purchase tabs. Also you can change Order/Purchase tabs text.
  3. Save changes
  4. On user profile you can see your orders as well as purchases

WooCommerce Integration for UserPro

User Dashboard Addon for UserPro

This addon provides users the flexibility to edit their profiles from Frontend Dashboard and the capability to drag&drop and show the widgets on their Profile Page.

So Users can edit their profiles from frontend Dashboard and Save Changes .

  1. Activate User Dashboard Addon
  2. As soon as you enable User Dashboard addon , you will see User Dashboard option enabled under Userpro Tab and a page with shortcode - [userpro_dashboard] will automatically be created on your site .
  3. Note : If it doesn't get created - Create a page with name Dashboard and put the shortcode [userpro_dashboard] on it and Publish.
  4. User Dashboard Settings - Click on User Dashboard Tab -> General Settings-> Enable Dashboard view -> Save Changes (See screenshot)
  5. Open the dashboard page (Page having shortcode [userpro_dashboard] ) . Here you can see the options to See Profile , Edit profile , Upload Profile Picture , Change Password ,Profile Customizer, Logout from Profile . (See screenshot)
  6. Profile Customizer Settings - Click on User Dashboard Tab -> Widget Settings -> Enable profile customizer and Enter Number of columns to show (Maximum 3 columns are allowed) -> Save Changes (See screenshot)
  7. Now open the dashboard page (Page having shortcode [userpro_dashboard] ) . Click on the option "Profile Customizer" (See screenshot)
  8. Drag&Drop the modules you would like to display on your profile page then click the Save Changes button.
  9. How widgets will look on Profile ? (See screenshot)

You can also have a look at the Youtube video for more information : How to use UserPro Dashboard Add-on

Dashboard Addon for UserPro

User profile Completeness Add-on for UserPro

  1. Activate User profile Completeness Addon
  2. Go to UserPro > Profile Completeness Tab > Click on User Completeness Tab > General Settings
  3. Make settings for Threshold Percentage - Enter the percentage for Profile completion threshold (say 100, For example - if you have 10 fields to be compleated in profile, you can give each field Threshold percentage = 10 )
  4. Restriction to View Full Site - If this option is enabled, user won't be able to view the site until his/her profile is compleated.
  5. Restriction Redirect URL - Enter Redirect URL for users who have not completed profile upto threshold.(See screenshot)
  6. Click on Field Setup Tab > Setup Fields > Click on "Add Fields" Button
  7. Select Field - Select edit profile form field to be included in profile completeness.
  8. Enter Field's Percentage - Per field completion Threshold percentage. (See screenshot)
  9. How Completeness bar looks on Profile ? (See screenshot)

You can also have a look at the Youtube video for more information : How to use UserPro Completeness Add-on

User profile Completeness Add-on for UserPro

Livechat Add-on for UserPro

  1. First of all, open "server.php" file which is located in the zip file that you will download from CodeCanyon, and configure the required areas at the beginning of the file. For Example,

    define( 'HOST', '' ); // Database domain or IP number
    define( 'USER', '' ); // Database username
    define( 'PASSWORD', '' ); // Database password
    define( 'DATABASE', '' ); // Database name
    define( 'DATABASE_PREFIX', 'wp_' );

  2. Then, upload the file to your server that has SSH access. You don't have to use the same server where you have installed the WordPress.
  3. Activate Live Chat Addon for UserPro
  4. Go to UserPro > Live Chat Tab > Click on Settings Tab > General Settings
  5. Select Yes for Enable Live Chat
  6. After that enter the URL of the website (without http or https) where you have uploaded the server.php file. For Example - 'example.com'
  7. Once you are done with the above settings, you need to open WebSocket Listener Port. Default port is 9303. This will be dependent on the server. If you are unaware about how to open the port, you will need to contact your hosting provider.
  8. Now, start the WebSocket Listener using the following command in SSH console - php -q [PATH_TO_YOUR_WEBSITE]/server.php

Live Chat Add-on for UserPro

Shortcodes

This is a list of all available shortcodes and all possible options and variations for each shortcode. Shortcodes are quick and easy to display any specific UserPro feature wherever you want on your WordPress site.

General Shortcode Options

View Profile

This shortcode will display the user's profile, like this example.

How to Embed This Shortcode in Editor

[userpro template=view]

How to Embed This Shortcode with PHP

<?php echo do_shortcode('[userpro template=view]'); ?>

Shortcode Options

Example

Options are used to customize the shortcode and can be assigned as a pair option=value in your shortcode like this.

[userpro template=view option=value]

Edit Profile

This shortcode lets the user edit his profile directly, you can see a working example here. You can login with test account: test/test to test this feature.

How to Embed This Shortcode in Editor

[userpro template=edit]

How to Embed This Shortcode with PHP

<?php echo do_shortcode('[userpro template=edit]'); ?>

Registration Form

This shortcode will display the frontend registration form, like this example.

How to Embed This Shortcode in Editor

[userpro template=register]

How to Embed This Shortcode with PHP

<?php echo do_shortcode('[userpro template=register]'); ?>

Shortcode Options

Example

Options are used to customize the shortcode and can be assigned as a pair option=value in your shortcode like this.

[userpro template=register option=value]

Login Form

This shortcode will display the frontend login form, like this example.

How to Embed This Shortcode in Editor

[userpro template=login]

How to Embed This Shortcode with PHP

<?php echo do_shortcode('[userpro template=login]'); ?>

Shortcode Options

Example

Options are used to customize the shortcode and can be assigned as a pair option=value in your shortcode like this.

[userpro template=login option=value]

Member Directory

This shortcode will display a directory of your members on the frontend in a beautiful way (See live example) The member list supports pagination, and unlimited custom filtering/sorting options giving you a flexible way to showcase and present your members and choose which custom fields appear for each member.

How to Embed This Shortcode in Editor

[userpro template=memberlist]

How to Embed This Shortcode with PHP

<?php echo do_shortcode('[userpro template=memberlist]'); ?>

Shortcode Options

Example

Options are used to customize the shortcode and can be assigned as a pair option=value in your shortcode like this.

[userpro template=memberlist option=value]

Search Options and Parameters

The following shortcode options are only available for member directory (v2) memberlist_v2=1
The following shortcode options are only available for member directory (v1) memberlist_v2=0

Enhanced Member Directory

This shortcode will display a directory of your members on the frontend like EMD example here. The member list supports pagination, and unlimited custom filtering/sorting options giving you a flexible way to showcase and present your members and choose which custom fields appear for each member.

How to Embed This Shortcode in Editor

[userpro template=emd]

How to Embed This Shortcode with PHP

<?php echo do_shortcode('[userpro template=emd]'); ?>

Shortcode Options

Example

Options are used to customize the shortcode and can be assigned as a pair option=value in your shortcode like this.

[userpro template=emd option=value]

EMD Options and Parameters

How to Make Custom Search Filters in EMD?

Example 1: Make Gender as Custom Filter

Use this in your shortcode: emd_gender="Gender,radio"

The first part is the label that appears and presents your new filter, the 2nd part "radio" will make the filter choices as radio buttons.

Example 2: Make Country as Custom Filter

Use this in your shortcode: emd_country="Country,dropdown"

This example makes Country as custom filter and output the filter as "dropdown" choices.

Example 3: Make City Custom Field as Filter

Use this in your shortcode: emd_city="City"

If you do not set radio or dropdown for filter, it will be a default search input/text. You can make unlimited custom search filters using this method, including custom fields you created by using this pattern. emd_{custom_field}="Label,type" in your emd shortcode.

Password Reset

This shortcode will enable users to retrieve forgotten password from the frontend with unique secret key and email validation (It does not use WordPress password reset, the plugin offers a unique password reset tool completely from the frontend)

How to Embed This Shortcode in Editor

[userpro template=reset]

How to Embed This Shortcode with PHP

<?php echo do_shortcode('[userpro template=reset]'); ?>

Frontend Publisher

This shortcode will display the frontend publisher.

How to Embed This Shortcode in Editor

[userpro template=publish]

How to Embed This Shortcode with PHP

<?php echo do_shortcode('[userpro template=publish]'); ?>

Shortcode Options

Example

Options are used to customize the shortcode and can be assigned as a pair option=value in your shortcode like this.

[userpro template=publish option=value]

Enabled auto-posting on Facebook

When a user publishes a new post via frontend publisher or when a user follows someone,you can update this on Facebook.

Options to enable this auto-posting and editing the text available via UserPro -> Settings -> Facebook Integration

Posts by User

This shortcode will display the recent posts made by user in a nice grid or compact layout.

How to Embed This Shortcode in Editor

[userpro template=postsbyuser]

How to Embed This Shortcode with PHP

<?php echo do_shortcode('[userpro template=postsbyuser]'); ?>

Shortcode Options

Example

Options are used to customize the shortcode and can be assigned as a pair option=value in your shortcode like this.

[userpro template=postsbyuser option=value]

Members Directory in Alphabetical Order

THis shortcode will display members directory in alphabetical order

How to Embed This Shortcode with PHP

[userpro template=list option=value]

Shortcode Options

Option in particular you need for the list template could be as below:

Instead, in the case you are using memberlist shortcode, then option should be

Show the author name of the comment

This shortcode will show the author name of the comment.

How to Embed This Shortcode with PHP

<?php
echo $userpro;
permalink($comment->user_id);
?>

Display custom fields

This shortcode will display custom fields.

How to Embed This Shortcode in Editor

[userpro template=emd emd_fields='field_name1', 'field_name2']

Example

If you wish to display just the first name of the users your code should look like this

[userpro template=emd emd_fields='first_name']

Restrict users from viewing content based on their role

This shortcode will restrict users from viewing content based on their role.

How to Embed This Shortcode in Editor

[userpro_private restrict_to_roles=administrator,subscriber,author]
[userpro template=postsbyuser postsbyuser_type=product]
[/userpro_private]

The roles can be specified by the admin as desired.

Shortcode Options

Example

Options are used to customize the shortcode and can be assigned as a pair option=value in your shortcode like this.

[userpro_private option=value]
[/userpro_private]

Show profile page of user with posts by the user himself

This shortcode will show profile page of user with posts by the user himself.

You can try using the template functions

How to Embed This Shortcode in Editor

[userpro template=view]
[userpro template=postsbyuser user=author postsbyuser num=4]

Assign a role to different registration forms

This shortcode will assign a role to different registration forms.

You need to add this basic option in your register shortcode:

How to Embed This Shortcode in Editor

[userpro template=register form_role='user_role_for_this_registration_form']

Display memberlist of only verified members

This shortcode will display memberlist of only verified members.

How to Embed This Shortcode in Editor

[userpro template=memberlist memberlist_verified=1]

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.

Also try:

[userpro template=list list_per_page=3 list_verified=1]

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.

Add an author box

This shortcode will add an author box.

How to Embed This Shortcode in Editor

[userpro template=card user=author]

How to Embed This Shortcode with PHP

<?php
echo do_shortcode('[userpro template=card user=author]');
?>

Grid FX

This shortcode will implement the default Grid FX layout into your posts.

How to Embed This Shortcode in Editor

[gridfx]

Shortcode Options

Example

Options are used to customize the shortcode and can be assigned as a pair option=value in your shortcode like this.

[gridfx option=value]

Collage view

UserPro provides a collage view for listing users on your WordPress site.

How to Embed This Shortcode in Editor

[userpro template=collage]

Shortcode Options

Example

Options are used to customize the shortcode and can be assigned as a pair option=value in your shortcode like this.

[userpro template=collage option=value]

Search Options and Parameters

For a live demo please check this link : Collage View Demo

Social Shortcodes

Activity Feed

This shortcode will display an activity feed (public or private) like this example.

How to Embed This Shortcode in Editor

[userpro template=activity]

How to Embed This Shortcode with PHP

<?php echo do_shortcode('[userpro template=activity]'); ?>

Shortcode Options

Example

Options are used to customize the shortcode and can be assigned as a pair option=value in your shortcode like this.

[userpro template=activity option=value]

Followers

This shortcode will display the followers of user profile in a list way. See live example

How to Embed This Shortcode in Editor

[userpro template=followers]

How to Embed This Shortcode with PHP

<?php echo do_shortcode('[userpro template=followers]'); ?>

Shortcode Options

Example

Options are used to customize the shortcode and can be assigned as a pair option=value in your shortcode like this.

[userpro template=followers option=value]

Following

This shortcode will display the following of user profile in a list way. See live example

How to Embed This Shortcode in Editor

[userpro template=following]

How to Embed This Shortcode with PHP

<?php echo do_shortcode('[userpro template=following]'); ?>

Shortcode Options

Example

Options are used to customize the shortcode and can be assigned as a pair option=value in your shortcode like this.

[userpro template=following option=value]

Social Connect

This shortcode will allow you to increase sign-up rate using social accounts, and does not depend on UserPro login/register form.

Plug the social connect buttons anywhere on your site : Above registration form, below it, or beside it. See live example

How to Embed This Shortcode in Editor

[userpro_social_connect width="400px"]

How to Embed This Shortcode with PHP

<?php echo do_shortcode('[userpro_social_connect width="400px"]'); ?>

Shortcode Options

Example

Options are used to customize the shortcode and can be assigned as a pair option=value in your shortcode like this.

[userpro_social_connect option=value]

Integration guide

Note : You do not need this guide If you want a basic integration. Basic integration can be done using shortcodes only and customizing shortcode options, for a list of shortcodes and options please visit this page. Also check the live demo/examples for shortcodes. The following guide is for advanced (PHP/theme) integration only.

Ever wondered how can you embed specific UserPro features, profile data, or integrate it in your php code? This guide is for developers and users who want to integrate their UserPro plugin using php. Standard integration is already offered by shortcodes. This tutorial is ONLY for php functions, and accessing UserPro in a standard php file.

Aweber Mailing List Integration

  1. You can use your Aweber Authorization Code to allow integration with Aweber subscription on your WordPress site.
  2. To get your Aweber authorization code & Aweber List ID click here
  3. Copy your Aweber Authorization Code & Aweber List Id since you will need it later.
  4. Login to your WordPress dashboard and go to UserPro -> Global Options
  5. Under Aweber Settings paste your Aweber authorization code in the Aweber Authorization Code field & Aweber List ID in the Aweber List Id field.
  6. Save changes.

You've now enabled Aweber Mailing List integration on your WordPress site.

MailChimp Integration

  1. You can use your MailChimp API Key to allow integration with MailChimp mailing lists on your WordPress site.
  2. Make sure you have latest version of UserPro installed.
  3. To get your MailChimp API key click here
  4. Copy your MailChimp API key since you will need it later
  5. Then go to Global Options -> MailChimp Settings & paste your API key in the MailChimp API Key field and save the settings.
  6. In fields customizer, drag the subscribe to newsletter field to your registration form (EDIT FIELD) and enter your mail list ID.

You've now enabled MailChimp integration on your WordPress site.

Campaign Monitor Integration

  1. You can use your Campaign Monitor Authorization Code to allow integration with Campaign Monitor on your WordPress site.
  2. Make sure you have latest version of UserPro installed.
  3. To get your Campaign Monitor Authorization Code click here. Your API Key can be found in your Account Settings
  4. To get your Campaign Monitor List Name go to your Lists & Subscribers tab then select a list & click change name/type.
  5. Remember your API Subscriber List ID will be used as the Campaign Monitor List Name.
  6. Copy your Campaign Monitor API key & API Subscriber List ID since you will need it later
  7. Then go to Global Options -> Campaign Monitor Settings & paste your API key in the Campaign Monitor Authorization Code field & your API Subscriber List ID in the Campaign Monitor List Name field & save the settings.
  8. In fields customizer, drag the subscribe to newsletter field to your registration form.

You've now enabled Campaign Monitor integration on your WordPress site.

UserPro profile links, user badges in bbPress

Integrating UserPro profile links, user badges in bbPress. The integration requires some template tweaks.

Download the modified bbpress templates .zip file and read near the line that says /* Integrating UserPro */ in all the files and apply the changes to your bbPress template.

http://userproplugin.com/userpro/public/bbpress-userpro.zip

WooCommerce Integration

Integrate the cart section of the my-account page from WooCommerce into the profile page without two separate logins

Use the following shortcode on your page :

[userpro template=view login_button_secondary=0]
[userpro_private]
[woocommerce_my_account]
[/userpro_private]

Display a user custom field or data anywhere using php

You can use the userpro_profile_data() function to return any bit about a certain user using php

<?php
echo userpro_profile_data($field_to_retrieve, $user_id);
?>

Example : If we want to show a user's first name

<?php
$user_id=66; // or the user ID you want to retrieve
echo userpro_profile_data('first_name', $user_id);
?>

This also can grab custom fields that you create:

<?php
echo userpro_profile_data('profession', $user_id);
?>

It can retrieve role, profile picture URL, anything:

<?php
echo userpro_profile_data('role', $user_id);
?>

You can use the API function permalink() to get the permalink/profile URL for any user. This helps you integrate/replace author link in your theme with profile URL, or change author link in comments to profile URL.

You must define a global If you're going to use any API function like this:

<?php
global $userpro;
?>

Now, lets get the permalink for user ID 22

<?php
$profile_url=$userpro->permalink(22);
?>

As simple as that. Now lets say that you want to show/get the permalink of logged in user dynamically and not have to enter a custom ID, you would do this:

<?php
$profile_url=$userpro->permalink(get_current_user_id());
?>

Very simple. This way you can generate profile permalink automatically for your users dynamically by using the above API method.

Note : If you want to return this permalink in comments, get_current_user_id() won't work! You need to get the commenter ID via $comment->user_id if the commenter is an existing user.

Example:

<?php
if (isset($comment->user_id)){
$profile_url=$userpro->permalink( $comment->user_id );
}
?>

Display User Verified Badge (or other badges) beside his name

You can display the user verified badge beside his name where you want with this API function. You can use it to show the badge in his comments, or in post author info, or beside his name in your forums or anywhere else.

<?php
echo userpro_show_badges($user_id);
?>

The $user_id variable should be the User ID you want to show badges for. This can be dynamic for your authors/commenters if you figure how to retrieve the post user ID.

How To / Tutorials

Customize UserPro templates

It is possible to customize the UserPro templates by overriding them in your theme without touching the core files.

The steps are as follows :

This way you AVOID editing CSS/templates in CORE plugin and keep updates without an issue.

For more tutorials on Customizing your UserPro CSS follow this link : http://userproplugin.com/userpro/customize-your-userpro-css/

Open login/registration via modal

UserPro has built-in support for modal or lightbox view which you can use to display any of its shortcode, just like standard shortcodes.

How to display the login form via modal or lightbox?

You need a menu item or a custom HTML link that has this class: popup-login That's it. An example should be:

<a href="#" class="popup-login">Login</a>

How to display the registration form via modal or lightbox?

You need a menu item or a custom HTML link that has this class: popup-register That's it. An example should be:

<a href="#" class="popup-register">Register</a>

Show Members with Specific Custom Field

This is a built-in feature for the Member Directory shortcode. This quick tutorial will show you how to display members in your members list who have a specific custom field key/value.

To show members who have specific custom field simply enter the custom field key in shortcode as option and give it the value you want to return or retrieve members with that value only. Here are few examples to help you.

Example 1: Display members who have "Gender" custom field as "Male"

[userpro template=memberlist gender="Male"]

Example 2: Display members who have "City" custom field as "New York"

[userpro template=memberlist city="New York"]

Show Members with Specific Roles

This is a built-in feature for the Member Directory shortcode. This quick tutorial will show you how to display members in your members list who have a specific user role in your WordPress site.

If you want to show multiple roles seperate each role by a comma, see the following examples.

You can display members who have specific role only, or display all members who have specific roles by seperating the roles by comma.

Example 1: How to Display Subscribers Only?

[userpro template=memberlist role=subscriber]

Example 2: How to Display Subscribers and Administrators?

[userpro template=memberlist role=subscriber,administrator]

Example 3: How to Display Blog Authors?

[userpro template=memberlist role=author]

Memberlist not displaying all members or Memberlist not getting updated

UserPro has caching turned on. Some added members from other methods (not normal registration) can be delayed until cache is cleared. Try this in your functions.php

global $userpro;
$userpro->clear_cache();

The integration requires some template tweaks.

Download the modified bbpress templates .zip file and read near the line that says /* Integrating UserPro */ and apply the changes to your bbPress template.

http://userproplugin.com/userpro/public/bbpress-userpro.zip

In your functions/api.php change this

$link=apply_filters('userpro_user_profile_url', $link, $user_id);

To:

if ($request == 'profile' || $request == 'view';) {
$link=apply_filters('userpro_user_profile_url', $link, $user_id);
}

This will affect only profile permalinks and keep login, register, other pages un-affected.

Customize Profile Picture Size

Example: Make the profile thumbnail 80px

[userpro template=view profile_thumb_size=80]

UserPro + Envato purchase code verifications

$userpro->verify_purchase('purchase_code_to_test');

$userpro->do_envato('userid');

$userpro->undo_envato('userid');

Make members of the site visible to public / community

  1. Just do not check any privacy setting within fields, that’s it.
  2. Under “Global Options” be sure to have the settings checked

$args['emd_custom_field_name']='Search by custom_field_name,dropdown';

[userpro template=emd emd_fields='gender,country,custom_field_name']

[userpro template=memberlist search_artistry='custom_field_name,dropdown']

bbPress – Integrate Social Icons Bar

Integrate Social Icons Bar to your threads (icons alongside each user reply) which gives quick access to user social profiles

The bbpress template that you need to edit is: loop-single-reply.php

Add the line

<?php
echo $userpro->show_social_bar_clean(bbp_get_reply_author_id(),'userpro-centered-icons');
?>

The first option is the user ID (reply author), and the second is a common wrap for social bar (allowing you to customize the element wrapping the icons). Any social profiles that user didn’t CHOOSE to hide will appear.

You can use the UserPro API to achieve this.

<?php
global $userpro_social;
echo $userpro_social->follow_text('author_id_here', get_current_user_id());
?>

Author ID must be changed with your dynamic author ID, this could be get_the_author_meta(‘ID’) or different according to your theme. This will let current user follow the author.

Change global language of UserPro

Show profile information without using shortcode

Use the follwing code :

global $userpro;
$user_id=get_current_user_id();
echo userpro_profile_data('first_name', $user_id);

Just change the first_name to any other information.

Make author profiles clickable for more info and all posts

For this don't assign a parent to the profile page in the Page Attributes section.

Display all comments by a user

Return the profile image in full size

To return the profile picture URL, which you can use as full width image, you need to use API:

userpro_profile_data('profilepicture', $user_id);

This will display the FULL IMAGE SIZE url. Now you can use it anyway you want.

Create custom index.html for login to restrict access to certain sections of the website

UserPro creates pages for you automatically, if you do not want them as pages or pages that all people can see just edit these pages and take the shortcodes you want and build your custom pages.

There's a shortcode reference here http://userproplugin.com/userpro/shortcode-reference/ it is the KEY of userpro, everything is done with shortcodes so you can put the profile features anywhere.

If you want things to be restricted to logged in members, use the content restriction shortcode, there's a few examples of everything on the main page. But you have to rebuild profile page if you changed its location, actually under Setup Pages you can choose new slug for profile and recreate your profile permalinks /profile/ can be /account/ or /userpanel/ or anything.

Location of all the badges and achievements

All the badges are inside userpro/addons/badges/badges

Display current count of bookmarks, followers and following for a user

To display the count of following for a user:

get_current_user_id() is current logged in user ID.

We assume you will check that the user has logged in already

<?php
global $userpro;
echo $userpro_social->following_count_plain(get_current_user_id());
?>

To display the count of followers for a user:

<?php
global $userpro;
echo $userpro_social->followers_count_plain(get_current_user_id());
?>

These will return the count in "plain" format. You can customize everything else.

To show total number of pages that user has bookmarked: You will need the updated version of Bookmarks addon API

<?php
bookmarks_count(get_current_user_id());
?>

Check if viewing own profile

You can use existing API function that returns true if you are in your own profile, or viewing another profile (false)

<?php
global $userpro;
if ($userpro->viewing_his_profile()){
// viewing his own profile
} else {
// viewing another user profile }
?>

Set an default image for profiles

You can change default_avatar_male and default_avatar_female in img folder

Note : On updates, you will need to replace them again. Use default gravatars until users upload a custom avatar for this site under Profile Settings, if you set this to "NO"; default male/female avatars will be used (not the gravatar by default).

Note : For translations : Just make sure that img/default_… matches your male/female words

You can use API to do this. Use this to generate link for FOLLOWERS

echo $userpro->permalink($user_id, 'followers', 'userpro_sc_pages');

For FOLLOWING same

echo $userpro->permalink($user_id, 'following', 'userpro_sc_pages');

Remember to change $user_id with the dynamic user id you want. This will link to followers/following page for specific user.

Add badge by default to users

You can hook into badges filter/functions here: addons/badges/functions/hooks-actions.php

Change badge size

The badges are adjusted by this class by default

img.userpro-profile-badge {
margin: 0 2px !important;
top: 0 !important;
vertical-align: middle !important;
box-shadow: none !important;
padding: 0 !important;
max-width: 16px !important;
max-height: 16px !important;
position: relative !important;
display: inline !important;
}

Change the max-width and max-height and create specific badge width/height based on parent element if you know CSS. That way you get larger badges to appear.

Display the social bar of a logged user outside view.php

To use/show the social icons outside view.php you can use the integratable version (with easy API method) here is an example:

echo $this->show_social_bar_clean('user_id');

This is an example already used in bbPress forum integration, you can integrate the social icons bar anywhere you want via the UserPro API function above.

If you want to use a wrapper (custom div wrapping) do it like this:

echo $userpro->show_social_bar_clean( $user_id, 'userpro-icons');

Please remember user_id is dynamic, so you need to adapt it depending on how your user ID is stored (bbpress, buddypress, etc..)

Example :

echo $userpro->show_social_bar_clean(bbp_get_reply_author_id(), 'userpro-icons' );

Integrate UserPro Badge in Author info (on posts)

You need to edit the template file (php file) and insert it as php code

$user_id=get_the_author_meta('ID');
echo userpro_show_badges($user_id, $inline=true);

Customize template for following and followers

Paste this code /userpro/followers.php in your theme.

if (locate_template('userpro/' . $template . '.php') != '') {
include get_template_directory() . '/userpro/'. $template . '.php';
}
else {
include userpro_sc_path . "templates/$template.php";
}

So it works/gets loaded the same way you customize a standard login.php or view.php template.

Redirect to the same page after login

You can do so by adding this in your shortcode:

[userpro template=login force_redirect_uri=1]

You can also set “Refresh page” after connection in UserPro admin panel

Grant access to users registered through different registration process

Grant access to users who have registered through different registration process other than UserPro registration

Translate forms in a specific language

You have to translate the forms (login, register ect in your wordpress backend). Visit your dashboard and go to UserPro -> UserPro tab.

There you will found all available forms. Just push the little “plus” or “gear” and you can translate this forms into your language.

Set image size for profile image in header

You can set the size via CSS only.

[profilepicture]

The above shortcode should get the profile image, see the demo profile for example. It gets the class up-profilepicture so style it in your css.

span.up-profilepicture {

}

Completely remove the mail icon (above the button “view profile”)

Completely remove the mail icon (above the button “view profile”) to completely hide the email addresses to users already registered.

Go to UserPro admin and remove email field from Social Fields list & save.

Help For Admins : Add Video, Music To Profiles The Easy Way

Temporary work-around for Admins who want to give users/members the ability to Add Video, Music to their Profile Pages. Included is Sample Embed Codes that you can use to see how it works.

NOTE 1 : Be sure to add Tool-Tip for members…(Use Youtube, Vimeo, Soundcloud etc Embed Code Only! Add 5 Spaces Between Every newly Added Code)
NOTE 2 : You can add Embed Code after saving previous Embeded Video or Music Player.

  1. Create A New Field In UP’s “Customize Fields” Section & Save It (Example: Add Video or Music Player).
  2. Place it in the Edit Profiles Field Settings and click Save.
  3. Go to your Admin Profile or A Test Profile and Test the new feature.
  4. Go to Edit Profile Button and click it. Look for newly created field in Profile (Add video or Music Player)
  5. Add html embed codes supplied to textarea (All at once, or find your own video, music players to test 1 by 1)
  6. Be sure to click SAVE after adding embeds.
  7. Go to View Profile. Then See what everything you added looks like. If satisfied add feature for your members. Embeded Code Example Added For Testing Purposes Only (Each Embed has 5 spaces after, before next media is added):

<object height="720" width="1280">
<param name="movie" value="//www.youtube.com/v/LY7oEA79LQk?version=3&hl=en_US" />
<param name="allowFullScreen" value="true" /><param name="allowscriptaccess" value="always" />
<embed allowfullscreen="true" allowscriptaccess="always" height="720" src="//www.youtube.com/v/LY7oEA79LQk?version=3&hl=en_US" type="application/x-shockwave-flash" width="1280"></embed>
</object>
<object height="315" width="560">
<param name="movie" value="//www.youtube.com/v/jl3ilZ5aBbI?version=3&hl=en_US" />
<param name="allowFullScreen" value="true" /><param name="allowscriptaccess" value="always" />
<embed allowfullscreen="true" allowscriptaccess="always" height="315" src="//www.youtube.com/v/jl3ilZ5aBbI?version=3&hl=en_US" type="application/x-shockwave-flash" width="560"></embed>
</object>
<object height="315" width="560"><param name="movie" value="//www.youtube.com/v/Squv4KI751w?hl=en_US&version=3&rel=0" />
<param name="allowFullScreen" value="true" />
<param name="allowscriptaccess" value="always" />
<embed allowfullscreen="true" allowscriptaccess="always" height="315" src="//www.youtube.com/v/Squv4KI751w?hl=en_US&version=3&rel=0" type="application/x-shockwave-flash" width="560"></embed>
</object>
<object height="315" width="560">
<param name="movie" value="//www.youtube.com/v/HRJx-boOTzA?version=3&hl=en_US&rel=0" />
<param name="allowFullScreen" value="true" /><param name="allowscriptaccess" value="always" />
<embed allowfullscreen="true" allowscriptaccess="always" height="315" src="//www.youtube.com/v/HRJx-boOTzA?version=3&hl=en_US&rel=0" type="application/x-shockwave-flash" width="560"></embed>
</object>
<object height="315" width="560">
<param name="movie" value="//www.youtube.com/v/u8FFoVDAszc?version=3&hl=en_US&rel=0" />
<param name="allowFullScreen" value="true" />
<param name="allowscriptaccess" value="always" />
<embed allowfullscreen="true" allowscriptaccess="always" height="315" src="//www.youtube.com/v/u8FFoVDAszc?version=3&hl=en_US&rel=0" type="application/x-shockwave-flash" width="560"></embed></object>

Change the default state of the MailChimp's "subscribe to newsletter" checkbox to checked.

In fields-functions.php

Edit:

$res .= "<div class='userpro-checkbox-wrap'>";
$res .= "<label class='userpro-checkbox full'><span ";
$res .= '></span><input type="checkbox" value="unsubscribed" name="'.$key.'-'.$i.'" ';
$res .= " />".$array['list_text']."</label>";
$res .= "</div>";

To

$res .= "<div class='userpro-checkbox-wrap'>";
$res .= "<label class='userpro-checkbox full'><span class='checked'";
$res .= '></span><input type="checkbox" value="unsubscribed" checked="checked" name="'.$key.'-'.$i.'" ';
$res .= " />".$array['list_text']."</label>";
$res .= "</div>";

Add "Checked" state to field by default.

Assign posts to a category automatically specified by admin

[userpro template=publish publish_heading="Write an article" taxonomy=category category=category_name_of your_choice publish_button_primary=submit]

Add My Uploads & Videos to the profile page

Go to Fields tab > You can add A NEW FIELD (videos are html fields or text fields that have youtube video url) if you make a new html field, user can put html code (embed code of video) for photos, add a new field > Picture field > and set the other options.

Please note that, this is done with the Fields customizer (Add new field)

Send hidden field data to user_meta table

There are hooks in register

do_action(‘userpro_before_fields’, $hook_args);

You can use that hook to add a hidden input or any kind of inputs before fields.

These fields can later be processed after new registration – there’s another hook that runs when profile is updated (e.g. when someone register, edit profile, etc)

do_action(‘userpro_profile_update’, $form, $user_id);

These 2 hooks allow you to connect any custom fields.

Let members post article in their profile page from frontend

Do not send your regular members to backend, let them publish directly from frontend with a simple shortcode.

[userpro template=publish post_meta="custom_url" post_meta_labels="Custom URL (Post Meta)"]

Integrate User Pro with Sahifa Theme Comments

.comment-avatar {
overflow:hidden;
width:45px;
height:45px;
margin:0 10px 5px -30px;
background: white;
padding: 2px;
-moz-border-radius: 1px;
-webkit-border-radius: 1px;
box-shadow: 0 0 3px #B5B5B5;
-moz-box-shadow: 0 0 3px #b5b5b5;
-webkit-box-shadow: 0 0 3px #B5B5B5;
float:left;
}

.comment-avatar {
overflow:hidden;
width:60px;
height:60px;
margin:0 10px 5px -30px;
background: white;
padding: none;
-moz-border-radius: 1px;
-webkit-border-radius: 1px;
box-shadow: 0 0 3px #B5B5B5;
-moz-box-shadow: 0 0 3px #b5b5b5;
-webkit-box-shadow: 0 0 3px #B5B5B5;
float:left;
}
.comment-date {
float: right;
padding-top: 5px;
}
.comment-edit {
float: right;
}

Do it with a function (add code inside the functions.php of your template). With plugins you may have problems with permalinks. Before: website.com/author/john.doe After: website.com/profile/john.doe Code:

add_action(‘init’, ‘change_author_base’);
function change_author_base() {
global $wp_rewrite;
$author_slug=‘profile’; // change the name for ‘author’
//here
$wp_rewrite->author_base=$author_slug;
}

Change background image in the profile page

Go to UserPro -> fields. Theres a Profile Background option for customizing in the list of available fileds. Click on the gear icon to make changes.

Use the Date Picker Field

Translate website to german language

Follow step-by-step on the link http://userproplugin.com/userpro/forums/topic/how-to-install-the-german-language-pack/

Show only a WooCommerce Review in activity feed

1. Open userpro > addons > social > functions >api.php.

2. Look for the function “log_action()”. You can add a new log action case and markup here.

3. Open userpro > addons > social > functions >log_actions.php.

4. This is where you can see examples of hooking into tha action filters to trigger a log event to be created.

Example :

$userpro_social->log_action( ‘new_comment’, $comment['user_id'], $comment['comment_post_ID'], $post->post_title );

5. You simply need to create a function that passes the necessary args to your new log case you created in api.php.We would recommend doing all this in your functions.php or some other file so it is not lost when you upgrade the plugin OR just make a note to manually update these two files and merge in your changes.

Show only social buttons on comments

In your comments template you could do something like

<?php
echo do_shortcode('[userpro_social_connect]');
?>

See http://userproplugin.com/userpro/forums/topic/finally-social-connect-shortcode-only/ for shortcode options.

Simply delete this in userpro/templates/login.php

<?php if ($args["{$template}_button_secondary"]) { ?>
<input type=”button” value=”
<?php echo $args["{$template}_button_secondary"]; ?>” class=”userpro-button secondary” data-template=”<?php echo $args["{$template}_button_action"]; ?>” />
<?php } ?>

You can create a folder in your themes directory “userpro” with a subfolder “templates” an put the modified file login.php there. In this way it will not get lost in case of updates

You can remove / create an account button from popup or shortcode by doing so in your modal login link do this:

data-login_button_secondary='...'

Get the instant messaging first registered message

Download the latest version of messaging add-on and go to private messaging area, there is option to enable or disable it.

Show the user profile picture, profile link, user badges and display name to your comments

This guide will help you show the user profile picture, profile link, user badges and display name to your comments. Each theme is different but often you have a comments.php file, open that file and find this part: wp_list_comments( array( 'callback' => 'presscore_comment' ) ); The callback will be different for each theme, so you just need to find this function inside your theme files, in this example, we are using the dream-theme and the callback presscore_comment is located in functions.php this can be different for each theme though. The callback function includes your actual comment template. Once you locate this function, edit the following parts to in the function to replace existing comments and integrate UserPro stuff in it. Here are steps:

function presscore_comment( $comment, $args, $depth ) {
global $userpro;
}

echo get_avatar( $comment, 60 );

This short line will display user avatar, 60 is the size you want. You can customize the comments avatar size using this option. That’s it for the avatar, UserPro avatars now integrated in comments.

<?php
if ($comment->user_id) {
printf('%s', '<a href="'.$userpro->permalink( $comment->user_id ).'">'.userpro_profile_data('display_name', $comment->user_id) . '</a>');
?>
}
else {
printf('%s', get_comment_author_link());
}
?>

What did we do? Simply we need to check if the commenter has an ID (profile) by testing $comment->user_id, then we display his permalink, and profile data (display name) that’s all. If he does not have an account, the normal author link will display.

<?php
echo userpro_show_badges($comment->user_id, $inline=true);
?>

That will show the user badges for comment author. Ofcourse you need to check that he is not a guest using $comment->user_id check.

Each theme is different but often you have a comments.php file, open that file.

First to integrate your avatar, change this

print '';

To:

echo get_avatar($comment,60);

To get the UserPro profile link change get_comment_author_link() to:

global $userpro;
echo ".userpro_profile_data('display_name', $comment->user_id).";

Add a follow button

You need to use the API for that.

<?php
global $userpro_social;
echo $userpro_social->follow_text('following_who_user_id', get_current_user_id());
?>

The first parameter is the user id to follow, the second parameter is who will follow him.

Add the follow button to user posts/ images /other places on the site

Use this php code:

$author_id=get_the_author_ID();
$current_user_id=get_current_user_id();
if($author_id != $current_user_id) {
echo $userpro_social->follow_text($author_id, $current_user_id);
}

This will allow users to follow the author of the post/page. This will prevent the follow button to be displayed if you are logged in and it’s your own post as well.

Display a list of members who are online

Use this shortcode to display online users in horizontal list :

[userpro template=online no_style=true disable_name_hooks=true online_mode=horizontal max_width="100%"]

Use this shortcode to display online users in vertical list:

[userpro template=online no_style=true disable_name_hooks=true]

Specify a custom URL for redirecting the user after login using login_redirect

You need to use this shortcode

[userpro template=login login_redirect=http://xyz.com]

Show a welcome message to loggedin user

You need to use this shortcode

[userpro_loggedin]
Welcome, [user_login]! Your current user role is [role] and here is your current profile picture [profilepicture round]
[/userpro_loggedin]

This shortcode will work only if the user is loggedin on your site. The fields can be customized as per the information you want to display.

Change date format for UserPro Pages

You can change the date format for UserPro Pages (UserPro version 2.8 & above)

Go to UserPro > Global Options > General > Date format

You can set the date format as one of the following :

Setup Invitation Based Registration

  1. Go to Userpro > Invite User (UserPro version 2.17 & above)
  2. Enable invivation based registration
  3. Add desired content in Email template alongwith {inivitelink} code - which will send the invitation link
  4. In Invite Users section, enter comma seperated list of email ids and click on Invite button.

Add a Invite Users Widget

Now your users can also invite users for registration from frontend.

Go to Appearance > Widgets > Userpro invite user

Import users

You can easily import users from your another sites.

Note : You can't import the profile picture of users.

Block/unblock users account

Admin can block/unblock users account.

Go to WordPress Dashboard > Users

Aspect ratio for profile pictures

You can now decide whether to keep aspect ratio for profile pictures

Go to UserPro > General > Keep aspect ratio

Multiple Registration Forms

You can create multiple registration forms

Go to UserPro > Multiple Registration Forms > Setup Multiple Forms

Enter the form unique name e.g. type=new_student which will load new_student registration form fields as example.

Example

[userpro template=register type="new_student"]

How to Edit your multiple registration forms

Go to UserPro > Multiple Registration Forms > Edit Forms

How to Setup User Connections

Login to your WordPress dashboard and go to UserPro > Settings > General

Enable Connections Set as "Yes"

After Enabling Connections Feature , It will Display Connection Button on Members Directory page :

Logged in User Can Accept/Reject Connection Request from their profile page.

How to Delete Connection :

Go to Profile page

Click on Connections Button

Send Message to Connections using Private Messaging Add-on

Login to your WordPress dashboard and go to UserPro -> Private Messaging -> Messaging Options

Allow users to send message to their connections Set as "Yes"

After Enabling this option , It will Display "Send message to connections" Button on profile page :

Using the same button you can send message to your connections.

How to Manage Conditional Field

Login to your WordPress dashboard and go to UserPro > Fields

Click on Setting button of the field

In Field Setting Section you can see option for "Manage Conditional Field"

Field: First select the field, using which you want to change the behavior of the current field.

Condition: Select the condition for which you want to manipulate the fields.

Result: Result for the field to be shown or make hidden as per the condition.

Conditional Text: Set the conditional text only for Equal to/Not Equal condition