Genesiv's WordPress SSO & Login API Plugin allows your community members to log in to the community directly from your website and assigns them roles based on preset criteria. This means that VIPs on your website who log in to your community can be automatically given a VIP (or another name of your choice) role upon joining your community. The following steps will help you with setting up your WordPress plugin to integrate your site and your community better.
Download & Installation
First, head over to Genesiv's download page. Scroll past 'All Downloads' to arrive at the page's 'Plugin Downloads' section. Locate the WordPress Plugin and simply press 'Download'. Simply save the .zip file on your PC, there is no need to extract its contents.
Once your plugin has been downloaded, head over to your WordPress admin settings. Navigate to your Plugins on the left-side menu and click 'Add New'
Once there, click 'Upload Plugin', select the .zip file that you downloaded, and click 'Install Now'.
Plugin Set-up
Once you've successfully installed the WordPress plugin, you will be able to access it in the side menu. Navigate to your Genesiv plugin settings on the left-sidebar, and you should be able to see entry fields for your API Key & Hostname, as well as a list of your site's roles. Your API Key & Hostname are located in your Genesiv community settings.
Getting your API Key
To obtain your API Key, head to the Login API page in your Community settings.
Here, you will be able to copy your API Key. Simply click on 'API Key' and copy the code that pops up.
Getting your API Hostname
Before obtaining your API Hostname, you will need to set up a custom domain. The WordPress plugin cannot be used with communities that do not have a custom domain set up.
If you have already set up your custom domain, you're already ready to go! Your custom domain is synonymous with your API Hostname, so simply input your custom domain link into the API Hostname field.
When inputting your API Hostname, do remember to exclude https:// or any slashes in the field. For example you would want to input your API Hostname as "community.genesiv.com" not "https://community.genesiv.com/"
Mapping Roles
Once you've copied and inputted both keys, you can now move on to mapping roles. Your current list of existing WordPress roles should already be reflected in your Plugin Settings. In your WordPress settings, first, assign the desired value to all of your roles and click on 'Save Settings'
Once you've configured your values in WordPress, we'll be linking those values to roles on Genesiv. If you haven't already created the roles that you want to automatically assign, do proceed with creating your roles first. Once that's done, head back to your Login API settings on Genesiv.
Click on the plus button next to 'Login API'". A pop-up window will allow you to enter a value and select a role in which said value will be mapped. Your value is what links your WordPress roles with your Genesiv ones. In this example, if you want a Shop Manager to have an Admin role, you would enter the same value that you've assigned them in your WordPress settings (In this case, 4) in the pop-up window, and check 'Admin' from the list of roles before clicking 'Add'.
Your Genesiv role will now be paired with its value. Now, whenever someone with the same value joins your community from WordPress, they will automatically be assigned the respective role.
Once you've mapped all your WordPress Access Values to Roles in Genesiv, you'll then be mapping a button on your WordPress site that links directly to your community.
WordPress SSO
To enable single-sign-on and direct logins for those on your WordPress site, you'll have to input the Genesiv Shortcode in your website! The Shortcode for Genesiv's WordPress SSO is [genesiv-login-link]. Simply input this Shortcode and it'll create a button that will send your site members to your community.
If your WordPress website uses Elementor, you can create a button and input the Shortcode into your button settings.
