olddocs.userproplugin.com Open in urlscan Pro
2606:4700:3037::6815:2327  Public Scan

URL: https://olddocs.userproplugin.com/
Submission: On August 22 via automatic, source certstream-suspicious — Scanned from US

Form analysis 0 forms found in the DOM

Text Content

Back to top

Table of Contents / User Guide
 1. Getting Started
    1. Installing UserPro
    2. Default Setup
    3. Reinstalling UserPro
    4. Upgrading
 2. Troubleshooting
    1.  A Lot of Whitespace / Display Does Not Look Right
    2.  Profile pictures DO NOT appear
    3.  Profile links are broken - 404 error
    4.  Twitter login just refresh the page?
    5.  Redirects to my profile when user goes to the campaign application page
        in Fundify
    6.  Custom fields with shortcodes not working
    7.  Restrictions set by UserPro automatically
    8.  CSS FIX for Front-end editor.
    9.  Non-approved members show up even when not approved.
    10. Twitter API not working for login
    11. Author and comments picture out of frame
    12. Not all of the pre-installed fields are showing
    13. Cache plugin stopped UserPro from working
    14. UserPro slowing website down
    15. JSON.parse : SyntaxError error on site
    16. Langauge Translation
    17. Invite User Widget
    18. Facebook App is in development mode
    19. LinkedIn Redirect URL
    20. Instagram Redirect URL
    21. Saving fields group in admin section - keeps the circle spinning
    22. Hide WordPress login or register and replace it by UserPro login or
        register
    23. Activate UserPro License Manually
    24. Activate UserPro-Lite License Manually
    25. How to make an entry to PO file
    26. Fix for error - "Could not retrieve data"
    27. Fix for error - "Parse error: syntax error, unexpected ’=’, expecting ‘)
    28. Fix for error (Google Map) - "Parse error: syntax error, unexpected ’=’,
        expecting ‘)
 3. Setting up Social Connect
    1. Setting up Facebook Connect
    2. Setting up Linkedin Connect
    3. Setting up Instagram Connect
    4. Setting up Twitter Connect
    5. Setting up Google+ Connect
    6. Setting up VK.com Connect
 4. Viral Social Marketing
    1. How It Works?
    2. How can this help me?
    3. Examples of Automatic Posts
    4. Setting up Viral Marketing
 5. UserPro Add-ons
    1.  WordPress User Bookmarks for UserPro
    2.  User Rating Add-on for UserPro
    3.  Private Messaging Add-on for UserPro
    4.  Media Manager Add-on for UserPro
    5.  Social Wall Add-on for UserPro
    6.  Payment Add-on for UserPro
    7.  MyMail Addon for UserPro
    8.  FeedBlitz Addon for UserPro
    9.  Tags Addon for UserPro
    10. WooCommerce Integration for UserPro
    11. User Dashboard Addon for UserPro
    12. User profile Completeness Add-on for UserPro
    13. Livechat Add-on for UserPro
 6. Shortcodes
    1.  General Shortcode Options
    2.  View Profile
    3.  Edit Profile
    4.  Registration Form
    5.  Login Form
    6.  Member Directory
    7.  Enhanced Member Directory
    8.  Password Reset
    9.  Frontend Publisher
    10. Posts by User
    11. Members Directory in Alphabetical Order
    12. Show the author name of the comment
    13. Display custom fields
    14. Restrict users from viewing content based on their role
    15. Show profile page of user with posts by the user himself
    16. Assign a role to different registration forms
    17. Display memberlist of only verified members
    18. Add an author box
    19. Grid FX
    20. Collage view
 7. Social Shortcodes
    1. Activity Feed
    2. Followers
    3. Following
    4. Social Connect
 8. Integration guide
    1. Aweber Mailing List Integration
    2. MailChimp Integration
    3. Campaign Monitor Integration
    4. UserPro profile links, user badges in bbPress
    5. WooCommerce Integration
    6. Display a user custom field or data anywhere using php
    7. Getting the permalink (profile URL) for a user
    8. Display User Verified Badge (or other badges) beside his name
 9. How To / Tutorials
    1.  Customize UserPro templates
    2.  Open login/registration via modal
    3.  Show Members with Specific Custom Field
    4.  Show Members with Specific Roles
    5.  Memberlist not displaying all members or Memberlist not getting updated
    6.  Replacing user author link with userpro profile link
    7.  To link author to users and posts
    8.  Customize Profile Picture Size
    9.  UserPro + Envato purchase code verifications
    10. Make members of the site visible to public / community
    11. Add custom search filter to EMD & Members Directory
    12. bbPress – Integrate Social Icons Bar
    13. Create an icon to follow author link
    14. Change global language of UserPro
    15. Show profile information without using shortcode
    16. Make author profiles clickable for more info and all posts
    17. Display all comments by a user
    18. Return the profile image in full size
    19. Create custom index.html for login to restrict access to certain
        sections of the website
    20. Location of all the badges and achievements
    21. Display current count of bookmarks, followers and following for a user
    22. Check if viewing own profile
    23. Set an default image for profiles
    24. Link to URL Followers & Following
    25. Add badge by default to users
    26. Change badge size
    27. Display the social bar of a logged user outside view.php
    28. Integrate UserPro Badge in Author info (on posts)
    29. Customize template for following and followers
    30. Redirect to the same page after login
    31. Grant access to users registered through different registration process
    32. Translate forms in a specific language
    33. Set image size for profile image in header
    34. Completely remove the mail icon (above the button “view profile”)
    35. Help For Admins : Add Video, Music To Profiles The Easy Way
    36. Change the default state of the MailChimp's "subscribe to newsletter"
        checkbox to checked.
    37. Assign posts to a category automatically specified by admin
    38. Add My Uploads & Videos to the profile page
    39. Send hidden field data to user_meta table
    40. Let members post article in their profile page from frontend
    41. Integrate User Pro with Sahifa Theme Comments
    42. Link the author page to the user profile
    43. Change background image in the profile page
    44. Use the Date Picker Field
    45. Translate website to german language
    46. Show only a WooCommerce Review in activity feed
    47. Show only social buttons on comments
    48. Disable secondary button in modal login
    49. Create an Account button on the modal popup needs to be removed
    50. Get the instant messaging first registered message
    51. Show the user profile picture, profile link, user badges and display
        name to your comments
    52. Integrating your avatar & to get the UserPro profile link to theme
        comments
    53. Add a follow button
    54. Add the follow button to user posts/ images /other places on the site
    55. Display a list of members who are online
    56. Specify a custom URL for redirecting the user after login using
        login_redirect
    57. Show a welcome message to loggedin user
    58. Change date format for UserPro Pages
    59. Setup Invitation Based Registration
    60. Add a Invite Users Widget
    61. Import users
    62. Block/unblock users account
    63. Aspect ratio for profile pictures
    64. Multiple Registration Forms
    65. How to Setup User Connections
    66. Send Message to Connections using Private Messaging Add-on
    67. How to Manage Conditional Field




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

 * Find you purchase code to access updates and support. If you bought this
   plugin, see the following image tutorial to find your item purchase code. You
   will also need your purchase code to activate your copy.
 * Download the latest version from customer portal
 * Install the plugin to your WordPress plugin (either via your WordPress
   dashboard or FTP to /wp-content/plugins/ folder)


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:

 * Profile Pages
 * Default Fields
 * Default Forms (Register / Login / Profile)

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

 * Login to your site via WordPress dashboard
 * Remove the current UserPro plugin (old version)
 * Install the new UserPro version which you've downloaded from customer portal
 * Activate the plugin


METHOD 2: UPGRADING VIA YOUR FTP SERVER

 * Login to your site via FTP
 * Extract the latest plugin release which you've downloaded from customer
   portal
 * Upgrade by copying/overwriting all existing files (replacing old plugin files
   with the most recent files)
 * That's it!


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
 * Profile pictures DO NOT appear
 * Profile links are broken - 404 error
 * Twitter login just refresh the page?
 * Redirects to my profile when user goes to the campaign application page in
   Fundify
 * Custom fields with shortcodes not working
 * Restrictions set by UserPro automatically
 * CSS FIX for Front-end editor.
 * Non-approved members show up even when not approved.
 * Twitter API not working for login
 * Author and comments picture out of frame
 * Not all of the pre-installed fields are showing
 * Cache plugin stopped UserPro from working
 * UserPro slowing website down
 * JSON.parse : SyntaxError error on site
 * Langauge Translation
 * Invite User Widget
 * Facebook App is in development mode
 * LinkedIn Redirect URL
 * Instagram Redirect URL
 * Saving fields group in admin section - keeps the circle spinning
 * Hide WordPress login or register and replace it by UserPro login or register
 * Activate UserPro License Manually
 * Activate UserPro-Lite License Manually
 * How to make an entry to PO file
 * Fix for error - "Could not retrieve data"
 * Fix for error - Parse error: syntax error, unexpected "=", expecting ")"
 * Fix for error (Google Map) - Parse error: syntax error, unexpected "=",
   expecting ")"


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:

 * Your theme is adding auto-paragraph to all shortcodes
 * One of your plugins is adding auto-paragraph to all shortcodes

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

 * Deactivate current theme and plugins
 * Check that the issue is gone now
 * Activate your theme/plugins one by one until you find the conflicting plugin
 * Please disable the conflicting item

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:

 * GD library is installed and running properly on your server
 * PHP version 5.0 or better
 * You have write permissions to the cache folder as explained above
 * rename(), file_put_contents(), move_uploaded_file() PHP functions are enabled
   by your server and working properly

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


PROFILE LINKS ARE BROKEN - 404 ERROR

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:

 * Login to your WordPress dashboard (as admin)
 * From the dashboard menu, open Settings > Permalinks
 * Click Save Changes to save permalink structure again

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

 * Go to Setup Pages in the UserPro (as admin).
 * Click Check / Rebuild Profile Pages to see if pages need to be rebuilt. If
   pages are highlighted in red, Click Rebuild UserPro Pages.
 * Then go to WordPress Dashboard -> Settings -> Permalinks and click Save
   Changes to save the current Permalink settings
 * Then go back to Setup Pages and make sure the pages were rebuilt
   successfully.

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

 * Deactivate all other plugins and change your current theme
 * From the dashboard menu, open Settings > Permalinks
 * Click Save Changes to save permalink structure again

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.

 * Add your site homepage as the callback URL in your Twitter app settings.


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

 * Add this to your CSS

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 :

 * Users can now create more lively profiles by adding multiple files -
   pictures, videos and audio files to their profile ( using UserPro ).
 * Images can be opened in a lightbox.
 * Pagination for media files is available.
 * You can restrict the file types for uploads - e.g. jpeg, png etc.
 * You can restrict the file size for uploads.
 * You can enable/disable the setting for media gallery tab.
 * You can upload multiple files at a time.
 * For Admin User - Can limit the number uploads for users. You can set
   different limits for audio,video and images. For unlimited uploads, you can
   set it to minus 1 ( -1). That is the default value too.

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 :

 * Allow users to share posts with each other.
 * Allow users to share images with each other.
 * Allow users to comment on each other's posts.
 * Allow users to like / unlike posts.
 * Limit the number of posts displayed on the social wall.
 * Administrators can delete any user's post or comment.
 * Setting at UserPro backend to enable/disable the wall display to visitors.
 * Allow users to report the post as objectionable.
 * Allow admin to bulk delete the posts and comments by filering the post dates.

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 :

 * Charge users for registering on your site.
 * Integrated with PayPal for payments.
 * Users can log in to their account only after the payment is successfully
   received.
 * The account a registered user who has yet paid will show up under the "Admin
   Approval" screen. Choose to manually approve / enable these users for making
   an exception.
 * Admin can set the registration fee for the users of each role. By default,
   registration for all roles is free.
 * Admin can specify the currency.
 * Accept payments via Stripe.


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

 * max_width - Set the maximum width for plugin / shortcode. This option can be
   a % e.g. 100% or pixels. Default is 480px (To make the plugin take full
   width, set it to 100%)
 * profile_thumb_size - Controls the user profile photo or thumbnail size in
   profile view. Enter the size you want as numeric value only. Default is 80
   (Profile photo will be up to 80 pixels)
 * allow_sections - Enable/disable field sections globally. By default this is 1
   (enabled)
 * keep_one_section_open - Should the plugin keep only one section (group of
   fields) open at all times. Default: 0
 * margin_top - Distance to add to the top margin of plugin. Default: 0 (zero
   gap from top)
 * margin_bottom - Distance to add to the bottom margin of plugin. Default: 30px
   (Add 30 pixels margin to bottom)
 * align - Alignment of shortcode. This can be center, left, or right. Default:
   center
 * layout - Controls the layout of profile fields, this can be either "float" or
   "none". Default: float


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]

 * profile_thumb_size - This will change profile image width and height.
   Default: width & height is 80
 * header_only - If enabled,this shows the only header of the UserPro profile.
   Default: 0
 * logout_redirect - Redirect the URL after successfull logout.For example,enter
   the "http://www.example.com" Default: Login template


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]

 * register_heading - This controls the heading text that appears on Register
   form. Default: Register an Account
 * register_side - This is the text that appears on the top right of
   registration. Default: Already a member?
 * register_side_action - The action that is taken when the side link is
   clicked. Default: login
 * register_button_primary - The text that appears on the registration button.
   Default: Register
 * register_button_secondary - The text that appears on the 2nd button besides
   registration button. Default: Login
 * register_button_action - Which action is taken when the 2nd button is
   clicked. Default: login
 * register_redirect - Here you can set a custom URL users will be redirected
   here after registration
 * type - If you setup multiple registration forms, enter the form unique name
   e.g. type=new_student which will load new_student registration form fields as
   example.
 * form_role This assign the role to specific registration form.
   Defualt:Subscriber


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]

 * login_redirect - Redirect the URL after successful login.For example,enter
   the "http://www.example.com" Default: View template
 * login_heading - Change the name of heading in the left side of Login
   Template. Default: Login
 * register_heading - Change the name of heading in the left side of Register
   Template,after clicking on 'Create an Account' button on login form. Default:
   Register an Account
 * register_button_primary - Change the name of primary (Black) button given in
   the bottom of the Register Template ,after clicking on 'Create an Account'
   button on Login Template. Default: Register
 * login_button_primary - Change the name of primary (Black) button given in the
   bottom of the Login Template. Default: Login
 * login_button_secondary - Change the name of secondary (White) button given in
   the bottom of the Login Template. Default: Create an Account
 * register_button_secondary - Change the name of secondary (White) button given
   in the bottom of the Register Template. Default: Login
 * register_side - Change the name of heading given in the right side of the
   Register Template,after clicking on 'Create an Account' button on Login
   Template. Default: Already a member?
 * login_side - Change the name of heading given in the right side of the Login
   Template. Default: Forgot your password?
 * login_side_action - Change the link/action for the right side button which
   appears on Login Template. Default: Forgot your password? , you can change it
   into register
 * register_side_action - Change the link/action for the right side button which
   appears on Register Template,after clicking on 'Create an Account' button on
   Login Template. Default: Already a member? , you can change it into register


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

 * exclude - Hide specific users from appearing in member directory. e.g. 1,3,10
   will hide these users from the member list.
 * search - Turn on/off member search in member directory. Default: 1 (turned
   on)
 * memberlist_withavatar - If enabled, search will return only members with
   custom profile photo or avatar. Default: 0
 * memberlist_verified - If enabled, search will return only Verified accounts
   in member search. Default: 0
 * memberlist_default_search - Enable/disable the default search field in member
   directory. Default: 1
 * per_page - How many members to display per each page. Default: 12
 * memberlist_paginate - Turn on/off pagination in member directory. Default: 1
   (enabled)
 * memberlist_paginate_top - Show/hide pagination on top of member directory.
   Default: 1 to show
 * memberlist_paginate_bottom - Show/hide pagination on bottom of member
   directory. Default: 1 to show
 * turn_off_initial_results - If set to 1, this will turn off initial member
   results until user makes a search in the member directory. Default: 0
 * memberlist_filters - A comma seperated list of custom fields to support in
   member directory search e.g. country,age (When search is done through the
   default search field - this does not set custom filters/dropdowns in member
   directory) Default is empty, includes default WP user search.
 * sortby - A sortby parameter to sort your members in member directory. Allow
   all default and custom fields sort in alphabetical. Default: registered (Sort
   members by registration date, by default). Example : sortby=country
 * order - desc or asc sorting. desc for descending and asc for ascending.
   Default: desc
 * userpro_show_unapproved_members - If you dont want unapproved members to show
   up in the memberlist. Default: 1

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

 * memberlist_v2 - This can turn on/off the member directory (version 2).
   Default: 1 to use the new member directory layout.
 * memberlist_v2_pic_size - Control the size of member/user profile photo in
   member directory v2. Default: 86
 * memberlist_v2_bio - Show/hide user biography or description in member
   directory v2. Default: 1 to show
 * memberlist_v2_showbadges - Show/hide user earned badges in member directory
   v2. Default: 1 to show
 * memberlist_v2_showname - Show/hide user display name in member directory v2.
   Default: 1 to show
 * memberlist_v2_showsocial - Show/hide user social icons in the member
   directory v2. Default: 1 to show
 * memberlist_v2_fields - A comma seperated list of custom fields to display in
   member directory v2. For example, the default value is: age,gender,country
   which will display user's Age, Gender and Country. You can enter any custom
   fields you want seperated by a comma.

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

 * memberlist_pic_size - Control the size of member/user profile photo in member
   directory v1. Default: 120
 * memberlist_pic_topspace - Control the top distance between each user in
   pixels. Default: 15
 * memberlist_pic_sidespace - Control the side distance between each user in
   pixels. Default: 30
 * memberlist_pic_rounded - Display member photos rounded or square. Default: 1
   (rounded photo)
 * memberlist_width - The width of member directory div relative to its parent
   element. Default: 100% (full width)
 * memberlist_popup_view - If turned on, user profiles will open in a modal
   popup. Default: 0 (open user profile directly)


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

 * emd_filters - Show/hide search and filters on the sidebar of members. 0 to
   disable filters, and 1 to enable. Default: 1
 * emd_thumb - Avatar size as number only. e.g. 200 will display profile photos
   200px wide.
 * emd_social - Show/hide social icons bar in EMD shortcode. Default: 1 to show
 * emd_bio - Show/hide user bio in member directory. Default: 1 to show
 * emd_fields - A comma seperated list of custom fields to show for each user in
   list, e.g. emd_fields=first_name,last_name,gender,country will display name,
   gender and country. This option uses custom field keys.
 * emd_col_width - The width of each column in percentage, by default:
   emd_col_width=22%
 * emd_col_margin - The margin for each column in percentage. Example: 2% will
   leave 2% margin beside each item.
 * emd_per_page - Number of users to show per page, by default: 20 members are
   shown per page.
 * emd_paginate - Enable/disable pagination in EMD shortcode, default: 1 to
   enable pagination
 * emd_paginate_top - Enable/disable pagination display on top of member
   results. Default: 1 to show pagination on top as well as bottom.

> 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]

 * publish_heading - This is the title of frontend publisher widget. Default:
   Add a New Post
 * publish_button_primary - This is the "publish" button text which submits the
   post via frontend form. Default: Publish
 * deny_roles - If you want to disable specific roles from posting from frontend
   publisher, enter a comma seperated list of User Roles to disable frontend
   publisher for. e.g. subscriber (To not allow subscribers to use this frontend
   form)
 * taxonomy - To automatically add new posts to specific category (instead of
   letting user choose it) enter the category taxonomy here. e.g. category or
   post_tag or another taxonomy.
 * category - If you set specific taxonomy for new posts, enter the category
   ID/slug (or multiple category IDs/Slugs) for the new items. This option can
   be single or comma seperated category IDs or slugs. e.g. news,sports,soccer
   or 1,8,15
 * allowed_taxonomies - If you enable user to choose his own categories, enter
   the allowed taxonomies here (Seperated by a comma) Default: category,post_tag
   (Which will allow Categories/Tags and can be extended to custom taxonomies)
 * post_type - Enter allowed post types for the frontend publisher. For example,
   to allow user to make posts, or pages, or custom_type use this:
   post,page,custom_type. Default: post (Allow Posts only)
 * post_meta - A comma seperated list of meta keys to collect on the frontend
   publisher (Post Meta). The value should be keys only e.g.
   custom_url,_my_custom_meta_key,etc.
 * post_meta_labels - Required if you use the above option. A comma seperated
   list of labels to present the meta keys you want to collect.If you add the
   post meta it is important to used both option post_meta and post_meta_labels
   in shortcode. e.g. Custom URl,Thumbnail URL,etc.
 * require_title - To make the title field required or optional. Default is 1
   (required)
 * require_content - To make the content field required or optional. Default is
   1 (required)
 * require_featured - To make the featured image field required or optional.
   Default is 1 (required)
 * require_CUSTOM_FIELD - To make the any custom field (added with post_meta
   option above) required or optional. Default is 0 (optional)
 * publish_field_order - This option lets you control which fields are included
   in any frontend publisher shortcode, and also controls the order of fields.
   e.g. Add the fields you want in the order you want with comma as seperator.
   example:
   publish_field_order="title,content,featured_image,category,post_type,custom_field1,custom_field2,custom_field3,etc."


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]

 * postsbyuser_num - How many recent posts to display from this user. Default:
   12
 * postsbyuser_types - Allowed post types to include in the grid of posts. By
   default: post (Show posts only). You can allow one or multiple post types, or
   ALL post types. To show multiple post types use: "product,custom_post_type"
   (comma seperated list of allowed post types, or one post type) To enable ALL
   post types use: "any"
 * postsbyuser_mode - Control the display of posts, this value can be "grid" or
   "compact". Default value: grid
 * postsbyuser_thumb - For use in compact mode only. Defines the size of post
   thumbnail that appears in list. Default: 50
 * postsbyuser_showthumb - For use in compact mode only. Show/hide the thumbnail
   of post. Default: 1 (to show)
 * postsbyuser_taxonomy - This takes effect If you use postsbyuser_category
   option to show posts from specific categories. This value should be a valid
   taxonomy slug. Default: category
 * postsbyuser_category - To show posts from specific category (or categories)
   enter the IDs as value, comma-seperated. To show posts from category 1, 4,
   and 6 (using IDs) use postsbyuser_category=1,4,6 or use a single category ID
   for one category. Default: none to display posts from any category (Have no
   effect if empty!)
 * user - To show posts by user for author, use user=author (e.g. in Author
   posts), or user=CUSTOM_USER to show posts of specific user. If this option is
   not used, the user will be defined automatically based on user profile being
   viewed.
 * post_paginate - Enable/disable pagination with post_paginate, Default : 1
   (Pagination is On by default); and specify number of posts on a single page
   with postsbyuser_num.
 * usercanedit - Enable/disable edit and delete the post from frontend by user ,
   Default : 1


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:

 * 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 - By default it sorts members in descending mode, default value is
   ‘desc’.

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

 * sortby - By default this is set to ‘registered’ ordering members by
   registration date.
 * order - desc or asc. It means order results in Ascending vs Descending mode.


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]

 * restrict_to_verified - Show or hide content from verified members. Default :
   0
 * restrict_to_roles - Restrict the content to specific user roles.


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]

 * title - This is an optional parameter that lets you display a custom heading
   or title for your grid wall.
 * description - This is an optional parameter that lets you display a custom
   description below the title for your grid wall. You can use both text and
   HTML in this field.
 * theme - General theme to use, themes are located in /templates/themes folder.
   e.g. light or dark, etc. Default value : light
 * default_theme - Default theme fallback to use. The plugin will use this theme
   if the theme does not exist. Default value : light
 * transparent - Enable this option If you want to apply transparent background
   to your Grid FX grid to match your theme or parent background. Enabling this
   option will override Grid FX style background. Default value : 0
 * primary_font - Font to use in the plugin. You can see list of available fonts
   in the settings/generate pages. Default value : Open Sans
 * custom_css - Custom css rules that apply to the .gridfx container. You can
   add custom styles that will affect only the shortcode being shown. e.g. a
   special border, background, or any other css rule.
 * margin - This value controls the top margin above Grid FX items in pixels.
   Default value : 30
 * crop - Set this to 1 If your images have different dimensions and you want to
   apply the same height/crop all images to make them equal. Default value : 0
 * crop_quickmode - If you enable this, cropped image will be also used in quick
   mode. Turn off to make crop in grid items only (not quick view). Default
   value : 0
 * crop_width - If you enable the equal height/cropping, please enter the
   standard width of image here. Default value : 500
 * crop_height - If you enable the equal height/cropping, please enter the
   standard width of image here. Default value : 281
 * crop_pos - Enter your crop position here If you enable the crop option (equal
   image heights). The accepted value can be: t (Top) c (Center) b (Bottom)
   Default value : t
 * columns - The number of columns to show by default in the grid. This number
   should be logical and relative to the parent or window width, depending on
   screen/document width this number can be ignored in responsive mode. Default
   value : 3
 * items_container_width - The percentage width of the container that holds the
   items, not the width of whole Grid FX instance. This is useful if you want to
   leave gaps on the left and right of items. Default value : 100
 * image_max_width - This is the maximum percentage width an image can have in
   full/single mode. Default value : 100
 * item_content_width - This is the percentage width of full/single mode
   relative to its parent. Default value : 70
 * item_content_left_width - This is the percentage width of the left side in
   full mode and when content is available. e.g. Width of post image. Remember
   width of left and right containers must not exceed 100. Default value : 50
 * item_content_right_width - This is the percentage width of the right side in
   full mode and when content is available e.g. Width of post content. Remember
   width of left and right containers must not exceed 100. Default value : 45
 * instantsearch - This option can enable or disable instant search feature in
   your grid. The value can be 1 or 0. Default value : 1
 * search_placeholder - Set the default search placeholder if you enabled search
   feature. Default value : Search
 * integrate - The plugin offers integration with specific WordPress platforms.
   Note that this integration may override other options such as post type,
   taxonomies, and other template options. example: to integrate with
   WooCommerce instantly, enter woocommerce here. Default value : 0
 * posttypes - A comma seperated of allowed post types in the grid. This can be
   a single post type also. examples: post,page or attachment. Default value :
   post
 * sortmenu - This option can show or hide the sort results by dropdown where
   frontend users can sort the results by various ways. Default value : 1
 * taxonomy_filter - This can be a comma seperated list of taxonomies that you
   want to allow users to filter on the frontend. examples: category or
   category,post_tag, etc. This will display a list of these categories that
   user can filter by. Default value : category
 * hide_empty_cat - This option can hide/show empty categories from navigation.
   This option can be 1 or 0. Default value : 1
 * cat_list_orderby - Order of categories in the nav if you enable isotope
   filtering. This can be name, id, slug, or count. Default value : name
 * posts_per_page - Number of posts to show per page in the grid. To show all
   posts and disable pagination please use -1 as value to display all items.
   Default value : 9
 * orderby - This can control the order/sorting of posts and results in your
   grid. Accepted values are: date, title, name, ID, modified, comment_count.
   Default value : date
 * order - This will control the sorting order. This can be DESC or ASC. Default
   value : DESC
 * include_terms_tree - This can be a comma seperated list of parent categories
   IDs to include in the results. examples: 1,4,10. This will include the
   specified parent categories and their children categories in results. Default
   value : 0
 * include_terms - This can be a comma seperated list of children categories IDs
   to include in the results. examples: 1,4,10. This will include only the
   specified categories in results. 0
 * exclude_terms_tree - This can be a comma seperated list of parent categories
   IDs to exclude from the results. examples: 8,12,22. This will exclude the
   specified parent categories and their children categories from results.
   Default value : 0
 * exclude_terms - This can be a comma seperated list of children categories IDs
   to exclude from the results. examples: 8,12,22. This will exclude only the
   specified categories from results. Default value : 0
 * paged - This is the default page to display. It does not have effect when you
   display all items. Default value : 1
 * post_parent - If you want to display images from a specific post as a gallery
   for example, enter the parent post ID here. Leave blank to disable.
 * load_more - This option specify how you want loading more content to be
   handled. Possible values: button, pagination, navigation, full, or 0 to
   disable loading more items. Default value : button
 * load_more_text - The text that is shown on the button that loads more posts.
   examples: Load more themes. Default value : Load more
 * loaded_all_text - The text that is shown on the button after loading all
   items. examples: Loaded all content. Default value : Loaded all content
 * load_more_img - This is the path/URL of your loading spinner/image that get
   shown on the load more button until new results are loaded. Default value :
   http://localhost/wordpress/wp-content/plugins/gridfx/images/loading-more.png
 * enable_grid_media - Enable or disable media in grid gallery. Allow media in
   the grid too. Default value : 1
 * global_image_action - Here you can modify the action that happens on image
   click. Default is 0 and available values are open_fancybox or post_url to
   open post directly. Default value : 0
 * link_to_post - If you want to force link to post without messing up with
   custom template/buttons option please choose an appropriate option here.
   Default value : 0
 * link_to_post_text - If you choose to place the little icon over image to link
   to post, this is the text that will appear besides the icon. example:
   continue or full post. Default value : full post
 * show_title - This can show or hide the post title display below the item
   image in grid view. This option may not be supported by specific Grid FX
   themes. Default value : 1
 * pre_title - This can be optional prefix that gets shown before every title.
   For example If you are showing products, you can set this to Product.
 * excerpt_below_title - Enter number of words to display an excerpt below
   title. Leave blank to disable this excerpt.
 * excerpt_over_image - Enter number of words to display an excerpt over image.
   Leave blank to disable this excerpt.
 * tags_filter - This can be a comma seperated list of taxonomies to display
   post terms for each item in the grid. examples: post_tag or
   post_tag,category, etc. This will display a list of post terms/categories and
   enable isotope filtering automatically. This option may not be supported by
   specific Grid FX themes. Default value : post_tag
 * item_custom_field - This can be a custom meta key that displays data besides
   the title such as price, or any other meta data needed. Leave blank to
   disable. This option may not be supported by specific Grid FX themes.
 * item_custom_field_filter - If you store prices like this 1200 and want to
   apply automated filter or some sort of number format like converting the
   number to euro or US dollar format. Default value : 0
 * show_views - Enable views count in grid/overlay view. This option can be 1 or
   0. Default value : 1
 * show_likes - Enable likes in grid/overlay view. This option can be 1 or 0.
   Default value : 1
 * show_comments - Comments are not yet integrated in Grid FX plugin. Please
   leave this disabled and watch for plugin updates. Default value : 0
 * show_corner - Enable or disable the display of a custom field value in the
   top right corner over grid item image in grid mode. Default value : 0
 * show_corner_key - If you enable the above option, enter the meta field key
   here to grab the value from. This can be useful to show any specific meta
   field value.
 * show_overlay_title_v2 - This is an extra overlay style. Enabling this title
   may remove other controls on overlay because it is centered in the image and
   gives a simple look. Default value : 0
 * show_overlay_title - Enable or disable title on item overlay in grid view. If
   enabled, the post title will be displayed on top of the overlay. Default
   value : 0
 * show_overlay_title_class - If you enable the above option, you can enter one
   of these values: none or top. none will show the title in static style over
   the item image, while top will animate the title from top to bottom when you
   move the mouse over the item image in grid mode. Default value : top
 * overlay_title_css - Custom css rules that apply to the overlay title which
   shows up on grid If enabled.
 * shadow_layer - Hide or show the shadow layer over your grid items. This
   option can be 1 or 0. Default value : hide
 * transparent_layer - Hide or show the transparent layer over your grid items.
   This option can be 1 or 0. Default value : hide
 * overlay_lightbox_text - This enable or disable the fancybox photos trigger on
   each grid item overlay. This can be 1 or 0. Default value : 1
 * photos_label - This controls the word that describes photos in plural form.
   examples: photos, screenshots, pictures. Default value : photos
 * photos_label_singular - This controls the word that describes photos in
   singular form. examples: photo, screenshot, picture. Default value : photo
 * more_details_text - This is the text that is shown on grid item overlay to
   expand view. Leave blank to disable this behaviour. Default value : quick
   view
 * item_links - This is optional. You can use this option to display buttons on
   the image in grid view e.g. Live Demo, Buy Now, etc. This template needs to
   have a special syntax and format. example: meta_key or URL|Button Text|Button
   Style. Please check out the FAQs on top to learn about available buttons
   styles.
 * item_extended_links - Custom extended links may NOT be supported by all Grid
   FX themes. This is optional. You can use this option to display buttons below
   item image in grid mode. e.g. Live Demo, Buy Now, etc. This template needs to
   have a special syntax and format. example: meta_key or URL|Button Text|Button
   Style. Please check out the FAQs on top to learn about available buttons
   styles.
 * single_theme - Theme to use in single/expanded view, themes are located in
   /templates/themes/single folder. e.g. light or dark, etc. Default value :
   dark
 * default_single_theme - Default theme fallback to use in single view. The
   plugin will use this theme if the single_theme does not exist. Default value
   : dark
 * scrollbar_theme - This is the theme name that controls the appearance of
   custom scrollbar in single view to navigate post content. This can be:
   light-thick, light, light-2, light-thin, dark-thick, dark, dark-2, dark-thin.
   Default value : light-thick
 * single_show_content - This enable or disable post content in full view even a
   post has content available. You can turn off contents completely by turning
   this to 0. Default value : 1
 * single_hide_image - This enable or disable post image in full view. Default
   value : 0
 * single_show_views - Enable views count in full view. This option can be 1 or
   0. Default value : 1
 * single_show_likes - Enable likes in full view. This option can be 1 or 0.
   Default value : 1
 * single_show_comments - Comments are not yet integrated in Grid FX plugin.
   Please leave this disabled and watch for plugin updates. Default value : 0
 * single_show_corner - Enable or disable the display of a custom field value in
   the top right corner of image in full mode. Default value : 0
 * single_show_corner_key - If you enable the above option, enter the meta field
   key here to grab the value from. This can be useful to show any specific meta
   field value.
 * single_item_links - This is optional. You can use this option to display
   buttons on the image in expanded view e.g. Live Demo, Buy Now, etc. This
   template needs to have a special syntax and format. example: meta_key or
   URL|Button Text|Button Style. Please check out the FAQs on top to learn about
   available buttons styles.
 * single_item_custom_field - This can be a custom meta key that displays data
   besides the title such as price, or any other meta data needed. Leave blank
   to disable.
 * single_image_action - This will control the action that happens when they
   click the image under full view, this can be fancybox or permalink. Default
   value : fancybox
 * grid_image_size - The optimal image size to be considered in grid view
   display. This can be full, large, medium, or thumbnail. This can be decided
   based on grid width or number of items (columns). Default value : large
 * single_image_size - The optimal image size to be considered in full view or
   quick mode display. This can be full, large, medium, or thumbnail. This is
   the optimal image size in full view. Default value : large
 * placeholder - Enable or disable the image placeholder that gets displayed If
   your post does not have an image yet. This can be 1 or 0. Default value : 1
 * builtin_placeholder - If you enable placeholders, you can choose which
   placeholder image to use here. examples: light or dark or image name. Default
   value : light
 * custom_placeholder - If you prefer to use your own placeholder, enter your
   custom placeholder image URL here or leave blank to use builtin placeholder.
 * loader_mini - This is the URL of mini loading spinner that is used by the
   Grid FX plugin to update likes for example. Enter full URL here to change
   this image. Default value :
   http://localhost/wordpress/wp-content/plugins/gridfx/images/loader_mini.gif
 * lightbox_background - This is the RGBa background color to use for
   fancybox/lightbox images as a background. examples: rgba(255, 255, 255, 0.80)
   Leave blank for default fancybox background.
 * lightbox_padding - This controls the padding inside lightbox images. If you
   set this to 0, padding and borders in the lightbox will not be displayed.
   Default value : 0
 * lightbox_margin - This controls the margin outside lightbox images. The
   distance from the image edges to screen edges. Default value : 0
 * lightbox_title - Enables or disables display of image title in the lightbox.
   Default value : 0
 * lightbox_title_type - This is title type if you enable title in lightbox, you
   can set this to: over, inside, outside, or float. This will control the
   appearance of lightbox title. Default value : float
 * lightbox_closeclick - When enabled, lightbox content will be closed when user
   clicks on it. This option can be 1 or 0. Default value : 1
 * lightbox_closebtn - Shows or hides the close button in lightbox mode. This
   option can be 1 or 0. Default value : 0
 * lightbox_buttons - Shows or hides the lightbox buttons helper that helps you
   navigate between multiple images. Default value : 0
 * lightbox_thumbs - Shows or hides the small thumbnails that helps you browse
   photos in each post gallery. Default value : 1
 * taxonomy_filter_woo - You can use a comma seperated list of available
   WooCommerce taxonomies. Default value : product_cat


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

 * collage_per_page - How many collage to display per page. Default: all
 * sortby - A sortby parameter to sort your members in collage view. Supported
   sorting parameters are available in WordPress codex
   (http://codex.wordpress.org/Class_Reference/WP_User_Query#Order_.26_Orderby_Parameters)
   Default: registered (Sort members by registration date, by default)
 * order - desc or asc sorting. desc for descending and asc for ascending.
   Default: desc

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]

 * activity_all - If this is turned on, activity will be public (All users
   activity) - If this is turned off only activity of "followed users" will
   show. Default: 0
 * activity_per_page - Number of activities to display per each load. Default:
   10
 * activity_side - Enable/disable instant ajax refresh of activity with ajax
   loader. Default: refresh (enabled)
 * activity_user - A comma seperated list of users (as IDs) to include in
   activity feed. Example: to limit activity feed to specific users by IDs only.
   Default is empty (show all users)
 * activity_heading - The title of activity feed widget. Default: Recent
   Activity
 * activity_user - This will allow a user to see his/her own activity. Default:
   All user Acitivty. Example: [userpro template = activity activity_user =
   self]


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]

 * user - If you want to display followers list for specific user (outside the
   followers frontend page) you can use this option to embed the followers of
   any user anywhere on your blog. The value can be "author" or "loggedin" or
   "USERNAME". e.g. author will show followers list of post author, loggedin
   will show followers list for current logged user, and USERNAME will show the
   followers list for any custom user you specify.
 * followers_per_page - To display the pagination with specified number of
   followers. Specify any integer 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]

 * user - If you want to display following list for specific user (outside the
   following frontend page) you can use this option to embed the following of
   any user anywhere on your blog. The value can be "author" or "loggedin" or
   "USERNAME". e.g. author will show following list of post author, loggedin
   will show following list for current logged user, and USERNAME will show the
   following list for any custom user you specify.
 * following_per_page - To display the pagination with specified number of
   followings. Specify any integer 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]

 * width - Specify the width of the buttons in pixels


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);
?>


GETTING THE PERMALINK (PROFILE URL) FOR A USER

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 :

 * Create a folder named userpro in your themes folder. Should be ->
   theme/userpro
 * Then copy the template you want to change inside your theme/userpro folder.
   Example : theme/userpro/view.php
 * Modify the template in this folder as per your needs and apply the changes

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();


REPLACING USER AUTHOR LINK WITH USERPRO PROFILE LINK

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


TO LINK AUTHOR TO USERS AND POSTS

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

 * First, please make sure you are using the most up-to-date version from
   customer portal: http://userproplugin.com/userpro/customer_portal/
 * To customize/set the size of profile picture you need to use the shortcode
   option profile_thumb_size.
 * Example: Make the profile thumbnail 80px

EXAMPLE: MAKE THE PROFILE THUMBNAIL 80PX

[userpro template=view profile_thumb_size=80]

 * By default the profile thumbnail size is set to 100 as you can see here
   http://userproplugin.com/userpro/profile/admin/ but that can be overriden
   using the above shortcode option.
 * For full shortcode reference please visit this page:
   http://userproplugin.com/userpro/shortcode-reference/


USERPRO + ENVATO PURCHASE CODE VERIFICATIONS

 * For those looking for API way (outside edit/registration forms) to validate
   any user purchase, simply do the test using 1 line :

$userpro->verify_purchase('purchase_code_to_test');

 * This is NOT required, this line is for manual/advanced integration only
   (Outside userpro registration) on your custom page, custom php etc. then If
   API returned valid (true) you can simply make the user verified via

$userpro->do_envato('userid');

 * or UNVERIFY him (wrong number)

$userpro->undo_envato('userid');

 * Very simple logic and API oriented. This is for ADVANCED integration, for
   easy integration you do not need that – just drag and drop the field from
   field list (apply it to edit profile / register).


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


ADD CUSTOM SEARCH FILTER TO EMD & MEMBERS DIRECTORY

 * Create your custom field
 * After this drag & drop this field to your “Groups & Fields” section e.g.
   “Edit Profile Fields”
 * Open the file /userpro/addons/emd/functions/shortcode-main.php
 * Right under line 17 add this code:

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

 * Tip: Just copy line 17 & put it right under it (line 18) & then customise it.
 * On your “Enhanced Member Directory” page use this shortcode:

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

 * If there is a chance to not rely on the emd shortcode this way here is far
   more easier, simply use:

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

 * And no customisation is needed!


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.


CREATE AN ICON TO FOLLOW AUTHOR LINK

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

 * A .po file exists in your UserPro/Language directory.
 * For translating with Poedit follow the link :
   http://make.wordpress.org/polyglots/handbook/tools/poedit/
 * Create a .pot or .po File using Poedit here :
   http://betterwp.net/wordpress-tips/create-pot-file-using-poedit/


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

 * You need to display them with custom code to show comments.
 * UserPro does not show user's comments by default.
   Here are a link to help you :
   http://wordpress.org/support/topic/show-only-comments-by-specific-registered-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


LINK TO URL FOLLOWERS & FOLLOWING

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

 * You need to allow them access to backend via Global Settings of UserPro.
 * There’s an option that allows you to define user roles to access the backend,
   besides “admin”.
 * The option " Enable these roles to view the WP-admin (backend)" is inside
   UserPro > global options > Redirection settings


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

 * Go onto the posts category page, then in the add new category section enter
   the name as: Category_name_of_your_choice and the slug as:
   same_as_category_name
 * Use the shortcode

[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

 * Open up wp_list_comments.php file from dashboard>appearance>editor or from
   wp-contents/themes/sahifa/includes
 * Find the line :

.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;
}

 * Replace with

.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;
}


LINK THE AUTHOR PAGE TO THE USER PROFILE

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

 * Add that field to your forms.
 * Create a new field, and choose “Date Picker” as field type.
 * Move the field to your register/profile forms (Drag and drop the field you
   created).
 * You have a fully functional Date Picker field as seen in the Register demo of
   this website.


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.


DISABLE SECONDARY BUTTON IN MODAL LOGIN

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


CREATE AN ACCOUNT BUTTON ON THE MODAL POPUP NEEDS TO BE REMOVED

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.

 * STEP 1: Define global of UserPro : You must define this line global $userpro;
   just after the callback function has started. In this example, it looks like
   this :

 * STEP 2: Use UserPro profile picture (avatar) : Change the part that displays
   user avatar in your comments to:

 * STEP 3: Display user profile link & name : Find the part that displays
   comment author link or name and replace it with this function:

 * STEP 4: Display user badges :To display user badges in your comments, simply
   add this code to your comments function where you want to show the badges
   (This can be different for your needs) maybe beside commentor name is a good
   option. So you just need to insert the following snippet to show the badges
   for any registered user.


INTEGRATING YOUR AVATAR & TO GET THE USERPRO PROFILE LINK TO THEME COMMENTS

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]

 * You can use the settings from the UserPro WP dashboard to configure this as
   well if you dont want to use the shortcode.
 * Go to UserPro -> Custom Redirects -> Login Redirects. Here you can create
   rules for login redirects based on user roles / single or all users / custom
   fields.


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 :

 * dd-mm-yy
 * mm-dd-yy
 * yy-dd-mm
 * yy-mm-dd


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.

 * You need to have file in CSV format.
 * In your CSV file the column name should match with your userpro field
   name.Example : user_login field name represent username so in this case your
   column name should be user_login.
 * Go to Userpro > Import/Export Users > Import Users from CSV

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