Monarch Plugin Documentation

Back To Monarch Plugin Documentation

Using Network API’s In Monarch

Connecting to your social account allows Monarch to update your social follower counts automatically.

What Are Networking API’s?

Networking API’s allow Monarch to automatically grab follower counts from your social profiles and display them on your website. This means that, for the networks that support it, you never have to update your follower count since the plugin continually checks the API and caches the count for you. Only certain networks support API calls, and each of them need to be configured a little differently. For a full list of supported networks and their installation instructions, keep reading.

api settings

Before you can configure your API settings, you must first make sure that you have “Get Counts VIA API” enabled within the Networks tab of your Monarch settings panel. Once enabled, you can begin setting up each account as outlined below.

Twitter

Twitter uses OAuth for its API, which means it requires some additional authentication steps before it will allow Monarch to access your profile information. To begin the process, first log in to your Twitter.com account and then access the Application Manager. Here you will need to fill in several fields as outlined below:

Name

This can be anything you want. Just something to remember it by.

Description

This can be anything you want as well.

Website

The full URL to your website (for example, http://www.yourwebsite.com).

Callback URI

This setting requires a very specific URL to identify your app. The URL that must be pasted here is the URL that leads directly to the Social Follow Networks tab in the Monarch settings inside your WordPress Dashboard. To get this URL, log in to your WordPress Dashboard and click Tools > Monarch Settings> Social Follow > Networks and then copy and past the URL from your address bar. It will look something like this:

http://www.yourwebsite.com/wp-admin/tools.php

Once you have filled in the required information, click the “Create Your Twitter Application” button and you will be taken to a new page that contains the information you will need to link Monarch to your account. Copy and paste the Consumer Key, Consumer Secret, Access Token and Access Token Secret into the Twitter API settings within the Networks tab of your Monarch settings panel. Click the “Authorize” button the complete the process. Monarch will now grab your twitter follower counts automatically.

screenshot

Youtube

Youtube uses authorization keys for its API, which means it requires some additional authentication steps before it will allow Monarch to access your subscriber count. First, input the ID of your channel into the “name” field within the Monarch networks tab. The channel ID can be found at the end of your channel URL. For example:

https://www.youtube.com/channel/UCuasRuWliU48RwnKXf9GesA

screenshot

Obtain An API Key

Now, log in to your Youtube account and then access the Google Developers Console where you will create a new Project. Then in the sidebar on the left, click Overview. In the list of APIs, make sure YouTube Data API v3 is included in the list of Enabled APIs.

screenshot

In the sidebar on the left, select Credentials. Click the blue Create credentials button and select API key. For the key type, select Server key and then assign it a name to remember it by. Finally, select the blue Create button. You will now see your new API Key. You must copy and paste the API Key into the Youtube authentication fields within the Social Follow tab of the Monarch control panel. When you click the “Authorize” button, Monarch will automatically grab your Youtube share and follower counts.

Pinterest

Pinterest makes it easy to access the API for your account. Simply input the URL to your Pinterest profile page into the Pinterest URL field in the Networks tab of your Monarch settings panel. Monarch will now grab your follower counts automatically.

screenshot

Facebook

Facebook uses OAuth for its API, which means it requires some additional authentication steps before it will allow Monarch to access share and follow information. To begin the process, open Monarch’s control panel and go to the Social Follow Networks tab. If you have not done so already, go ahead and enable Facebook by clicking Add Networks. Now you will see four input fields. In the second field (from the left) input your Facebook Page’s complete URL. In the third field, input only your Facebook Page’s name. For more information on how to setup a name for your Facebook Page see this article in Facebook’s Help Center.

Page URLs will typically have the following format: http://facebook.com/your-page-name

To obtain an App ID & Secret for Monarch, log in to your Facebook account and then access the Facebook
Developers
 page. From the main menu, hover over “My Apps” and then click “Add a New App”.

Now, input a name for your App. This can be anything you want. It’s just something to remember it by. Next, adjust the contact email if necessary and click Create App ID.

In the next step you are prompted to “Select a Scenario” where you can select the first option “Integrate Facebook Login”. Click on “Confirm” to confirm the selection.

Now, from the main menu on the left, find the Products section and click Facebook Login > Settings.

Find the field labeled Valid OAuth redirect URIs and input your site’s redirect URL using the following format (replace the highlighted portion with your domain):

https://your-website.com/wp-admin/tools.php?page=et_monarch_options#tab_et_social_tab_content_general_main

Now click the button labeled Save Changes located at the bottom-right side of the page.

Note: As of March 2018 all new apps created have the “Enforce HTTPS” option enabled by default and it cannot be turned off. More information about this can be found here.

Finally, you must copy and paste the App ID and the App Secret into the Facebook authentication fields within the General Settings tab of Monarch’s control panel. You can find the ID and Secret in Settings > Basic from the left side menu.

Leave this tab opened and head out to your WordPress Dashboard > Tools > Monarch Settings > General Settings and enter the App ID and App Secret from your Facebook app.

Once you click on the Authorize button you will be redirected to the Facebook authorization page where you may see a popup with a warning message saying “Some of the permissions below have not been approved for use by Facebook. Submit for review now or learn more“. This warning message can be disregarded as long as the account you are using to authorize is administrator on both the app and the Facebook page. Click on “Continue as …” then “Ok” to complete the authorization and now Monarch will automatically grab your Facebook share and follower counts.

Instagram

Instragram uses OAuth for its API, which means it requires some additional authentication steps before it will allow Monarch to access your profile information. To begin the process, first access the developer clients manager. Once you have clicked the URL, you will be asked to log in to access the API tools.
Once logged in, click the “Register Your App” button to get started. Then, click the “Register a New Client” button at the top of the screen. On this screen, you will need to fill in the following fields:

Application Name

This can be anything you want. Just something to remember it by.

Description

This can be anything you want as well.

Website

Input the full URL to your website (for example, http://www.yourwebsite.com).

OAth Redirect URI

This setting requires a very specific URL to identify your app. The URL that must be pasted here is the URL that leads directly to the Social Follow Networks tab in the Monarch settings inside your WordPress Dashboard. To get this URL, log in to your WordPress Dashboard and click Tools > Monarch Settings> Social Follow > Networks and then copy and past the URL from your address bar. It will look something like this: http://www.yourwebsite.com/wp-admin/tools.php?page=et_monarch_options#tab_et_social_tab_content_follow_networks

screenshot

Once these fields have been filled out, click the “Register” button to complete the process. You will be brought to a new page that lists the information of your new app. You will need to copy and paste the Client ID and the Client Secret into the Twitter API settings fields within the Monarch Social Follow Networks tab, and then click the “Authorize” button to complete the process. Once authorized, your website will grab your social follow counts automatically.

screenshot

LinkedIn

LinkedIn uses OAuth for its API, which means it requires some additional authentication steps before it will allow Monarch to access your company profile information. To begin the process, first access the secure developer tools. After you click the URL, you will be asked to log in to access the API tools.

Once logged in, click the “Add New Application” button to get started. You will be taken to a new page where you will need to fill in the following fields as shown here:

Applicate Name

This can be whatever you like.

Description

This can be whatever you like.

Website URL

Input the full URL to your website (for example, http://www.yourwebsite.com).

Live Status

Set to “Live.”

Default Scope

r_basicprofile (only have this selected)

OAuth 2.0 Redirect URL

This setting requires a very specific URL to identify your app. The URL that must be pasted here is the URL that leads directly to the Social Follow Networks tab in the Monarch settings inside your WordPress Dashboard. To get this URL, log in to your WordPress Dashboard and click Tools > Monarch Settings> Social Follow > Networks and then copy and past the URL from your address bar. Next, delete everything after the # character within the URL (http://www.yourwebsite.com/wp-admin/tools.php?page=et_monarch_options#tab_et_social_tab_content_follow_networks). In the end, it will look something like this: http://www.yourwebsite.com/wp-admin/tools.php?page=et_monarch_options

OAuth 1.0 Accept Redirect URL

Input the same URL as used in the field above.

Next click the “Add Application” button to complete the process. This will bring you to a success page with some information that you will need to input into the LinkedIn API fields within the Networks tab of the Monarch settings page in your WordPress Dashboard. Copy and paste the API Key and the Secret Key into the required fields, and then click the Authorize button the complete the profess. Monarch will now be able to grab your company’s follower counts automatically from LinkedIn.

screenshot

Dribbble

Before Dribbble will give Monarch your follower count, you will first need to register an application and receive an access token. First, log in to Dribbble.com and then access the Register Application page. Here you will need to fill in the following fields:

Name

This can be anything you like.

Description

This can be anything you like.

Website URL

Input the full URL to your website (for example, http://www.yourwebsite.com).

Callback URL

Input the full URL to your website (for example, http://www.yourwebsite.com).

Next click the “Register Application” button. You will be taken to a new page with three pieces of information. Copy and paste the “Acess Token” into the Dribbble Access Token field within the Networks Tab of your Monarch settings page. Monarch will now grab your follower counts automatically.

screenshot

Vimeo

Vimeo uses OAuth for its API, which means it requires some additional authentication steps before it will allow Monarch to access your profile information. To begin the process, log in to your account and then access the Vimeo API Tools to get started.

Click the “Create A New App” button, and then fill in the required fields as outlined below:

App Name

This can be anything you want. Just something to remember it by.

App Description

This can be anything you want as well.

App URL

Input the full URL to your website (for example, http://www.yourwebsite.com).

Callback URI

This setting requires a very specific URL to identify your app. The URL that must be pasted here is the URL that leads directly to the Social Follow Networks tab in the Monarch settings inside your WordPress Dashboard. To get this URL, log in to your WordPress Dashboard and click Tools > Monarch Settings> Social Follow > Networks and then copy and past the URL from your address bar. It will look something like this: http://www.yourwebsite.com/wp-admin/tools.php?page=et_monarch_options#tab_et_social_tab_content_follow_networks

Click the “Create App” button to bring you back to the developer tools home page. Next click the “Authentication” tab, which will give you a list of information about your new app. You will need to copy and paste the Client Identifier and the Client Secret into the Vimeo authentication fields within the Network tab of the Monarch settings panel. Once you click the Authorize button, Monarch will automatically grab your Vimeo follower counts.

screenshot

Soundcloud

Soundcloud requires two pieces of information in order to grab your follower counts via their API: Name and Client ID. To access these details, you will first need to register an app within your Soundcloud account.

Log in to your Soundcloud.com account and then access the Soundcloud Apps Page to get started. Click the “Register A New Application” button to begin the app creation process.
Next you will be asked to fill in the following information:

Name

This can be anything you like.

Website of your app

Input the full URL to your website, such as: http://www.yourwebsite.com

Redirect URL

This setting requires a very specific URL to identify your app. The URL that must be pasted here is the URL that leads directly to the Social Follow Networks tab in the Monarch settings inside your WordPress Dashboard. To get this URL, log in to your WordPress Dashboard and click Tools > Monarch Settings> Social Follow > Networks and then copy and past the URL from your address bar. It will look something like this: http://www.yourwebsite.com/wp-admin/tools.php?page=et_monarch_options#tab_et_social_tab_content_follow_networks

Click the “Save App” button. After your application has been saved, copy and paste the “Client ID” (which will be listed on the app page your are currently on) and your SoundCloud Username into the SoundCloud API settings within the Networks tab of your Monarch settings panel. Monarch will now grab your follower counts automatically.

screenshot

Github

Github makes it easy to grab your follower counts. All you need to do is input your Github username into the Github “Name” field within the Networks tab of your Monarch settings panel.

screenshot

VK

Before you can configure VK, you first need to figure out your User ID, which is actually different than the VK username you use when logging in. To access this User ID, log in to VK and then go to the Account Settings page. Scroll down and look for the “Your Profile ID” section, and then copy and paste your Profile ID into the “User ID” field within the VK API settings inside the Network tab of your Monarch settings panel.

screenshot

Join To Download Today