Social Backlinks documentation

Introduction

The goal of Social Backlinks is to push Joomla content automatically on social networks, a real time saver regarding social marketing and SEO.

Social-Backlinks-main

 

1.1 Install

Our component is Joomla 3.x compatible. All the features and 3rd party integrations are included in all memberships.
In order to install our component you have to download the extension .zip file and use standard Joomla installer.

image7

 

Then click on Browse > Upload and Install button, component, modules and plugins will be installed activated by default.

 

1.2 Update & automatic updater

In order to update the extension you can install a new version over the old one by downloading the ZIP file from JoomUnited or use the automatic updater (recommended).

 

socialbacklink-update

 

The automatic updater, which push the update notification, is embedded in the Joomla extension you've installed. So you'll get notified like any other extension in the dashboard or using the menu: Extension > Manage > Update menu.

 

Login to your account to update

You need to login to your JoomUnited account to update all your JoomUnited Joomla extensions. In order to login access the main configuration of the component then click on the Live update tab. At the bottom, you'll find a login button. 

image10

 

Enter your JoomUnited credentials, the same you use to login here @ www.joomunited.com

image11

 

The button will turn orange, congrats! you can now update all the JoomUnited extensions on this website! If your membership is expired you'll get a renew link and a text that explain that.

image12

 

Note: one single login will allow you to update all the JoomUnited extensions (regarding your membership). Login won't expire unless you disconnect it. 

 

 

II. SOCIAL NETWORKS CONNECTION

2.1 Facebook automatic login

In order to post automatically on Facebook, there's 2 method:

  • Use our App with a single Facebook login: fastest method, detailed below
  • Use your App created on Facebook to get API key and/or secret key: better for high volume of social posting
     

We’ve created a dedicated Facebook App to help you posting on social networks easily. From Social Backlinks component view click on Off/On button.

image7


Then accept the disclaimer that will be opened in a popup.

popup-facebook


Then you need to connect to your Facebook account to post on a page. 

select-account

Then you need to validate the permission about who will be able to access to your publication...

permissions

 

Then, if you whish to post on a Facebook page, give access to the account related pages then select the page where to post. You need to be admin of the page to post on it.

 

page-manager-access

 

It’s done! You’re connected, and the button will turn On, you can start posting on Facebook pages.

connected

 

2.2 Connect to Facebook using an App

Login to Facebook developer portal

In order to get the App key and App secret from Facebook, login with your Facebook account on: https://developers.facebook.com/apps
All your Apps will be listed there.

facebook-dev-app-list

 

Note: For all new developer account, Facebook may ask you to validate your account first with your phone.

Create an App

Then go to the Apps menu and add a new one

add-app

Create a new application, input an App name

app-name

A Add a product page will be appeared. Then click on Facebook Login > Set Up button.

add-a-product

Then select a platform Website

website

Then fill the App domain and site URL fields with your website domain (no https://www) and URL (with https://www)

app-domain

On the left menu, Facebook Login > Settings, you should enable Embedded Browser OAuth Login option. Then, input your URL at Valid OAuth redirect URIs. With the 1st Facebook account, your Redirect URls should be: https://your-domain.com/administrator/index.php?option=com_socialbacklinks&view=plugin&task=networkConnect&network=facebook&callback=1&tmpl=component

The 2nd Facebook account, your Redirect URls should be: https://your-domain.com/administrator/index.php?option=com_socialbacklinks&view=plugin&task=networkConnect&network=facebook2&callback=1&tmpl=component

enable-oauth-login

Finally, click on Save Changes button.

Done! You just created you Facebook app. You can now grab your App ID and App secret. You’ll need both to fill Social Backlinks settings.

If you have authorization problem, you can check if your Facebook account is registered as admin in the  App.

Add your App ID and App secret in Social Backlinks

You should fill at least 2 fields the Facebook configuration in order to be connected.  First put your mouse over the Facebook block, on the right of your screen then click on “Settings” button.

image21

 

Those two field bellow need to be filled in order to post on your Facebook Page account. Paste the App ID and App secret then follow the next step to connect your Facebook page.

image22

Post on Facebook page

Social Backlink is smart, with your App ID and App Secret, the extension detect the page linked to your account. So, in order to post on the pages linked to your Facebook account you just need to get you page ID.

A. Go on you page linked to your account from you profile

image26

 

B. Get you page ID at the end of the URL

url


C. Fill the number or name in Social Backlinks in order to post on the proper page

image28


You can “post as user” like someone post on your wall or “post as admin” like a page administrator.

Your Facebook Page account in now configured but not connected yet, you just need to login to your account by clicking on the the "On" buttonThen you’ll get an authorization popup to publish on all your Facebook Page account.

Congratulation you are now successfully connected to Facebook!

Publish on Facebook group

This is not something is included in the API but more a trick.

Perform the manual setup – make sure your APP has the following permissions: publish_actions user_groups
Go to http://lookup-id.com/ and enter the URL to your Facebook group
Use the ID give and put that in the page_id within the settings

And ensure you “post as user” and it’ll work just fine.

2.3 Twitter automatic connection

We’ve created a dedicated Twitter App to help you posting on social networks easily. From Social Backlinks component view click on the Twitter Off/On button.

twitter-auto-connect

Then validate the disclaimer and you'll be redirected to a Twitter login page. Login with your regular account.

twitter-login

 

You're done, Twitter is now connected to Social Backlinks

2.4 Connect to Twitter using an App

You can also connect a twitter account using your own app. First of all you should create a Twitter application here: https://apps.twitter.com/
Connect to your Twitter account, then you’ll be invited to create an App

twitter-app

In order to get your Consumer key and Consumer secret you’ll need fill some mandatory fields:

  • Name
  • Description
  • Website
  • Access set to: Read and Write
  • Callback URL: include "administrator/index.php?option=com_socialbacklinks". E.g: https://joomunited.com/administrator/index.php?option=com_socialbacklinks

app-settings

Then you can get your Consumer key and Consumer secret by clicking on the link manage keys and access tokens.

secret

App credentials that needs to be copied in Social Backlinks

app-credentials

OK now your Twitter App is ready to be used!

Now you may copy Consumer key and Consumer secret the Twitter configuration of Social Backlinks in order to be connected. First put your mouse over the Twitter block, on the right of your screen then click on “Settings” button.

image33
Copy and paste your consumer key and consumer secret then click on Save button.

image34

Your Twitter account in now configured but not connected yet, you just need to login to your account by clicking on the Twitter On button.

image35

You’ll be invited by Twitter to connect to your account. Please fill your User name and Password and you will be automatically connected by Social Backlinks.

image36

Congratulations, Twitter connexion successful!

image37

2.5 LinkedIn automatic connection

We’ve created a dedicated LinkedIn App to help you posting on social networks easily. From Social Backlinks component view click on the LinkedIn Off/On button.

LinkedIn-auto-connect

Then validate the disclaimer and you'll be redirected to a LinkedIn login page. Login with your regular account.

linked-auto-connect

You're done, LinkedIn is now connected to Social Backlinks.

2.6 Connect to LinkedIn using an App

First of all you need to create a LinkedIn application here: https://www.linkedin.com/developer/apps
A LinkedIn account is required, then hit Create Application

linkedin-apps

In order to get your Consumer key and Consumer secret you’ll need fill all the fields. The website URL must be the domain only not a subdomain URL. 
Example of website URL: https://www.your-domain.com

linkedin-app-settings

When your application is created you’ll get a success massage with your API Key and your Secret Key.

auth-keyAdd LinkedIn credentials in Social Backlinks

You should fill 2 fields in the LinkedIn configuration of Social Backlinks in order to be connected. First put your mouse over the LinkedIn block, on the right of your screen then click on “Settings” button.

image42

Copy and paste your API key and Secret Key then click on Save button.

image43

 

In order to connect click on the LinkedIn On related button

image44

Then you’ll be invited to authorize you App to access to your profile, please click OK, I’ll Allow It.

LindedIn-login

Your LinkedIn account is now fully connected with Social backlinks.

image46

Great! was it hard to configure? not so much :) Now let’s see how to configure your Joomla content.

2.7 VK automatic connection

We’ve created a dedicated VK App to help you posting on social networks easily. From Social Backlinks component view click on the VK Off/On button.

auto-connect-vk

A pop-up window appears, you click to the LINK, it will be switched to new tab, then copy URL (e.g: https://oauth.vk.com/blank.html#code=a250ef9427c3925) and paste to Full address field. Next, press Continue button.

auto-link-vk
You can choose Community or your profile in your VK account, then click Continue button.

auto-step-vk

It’s done! You’re connected, and the button will turn On, you can start posting on VK.

2.8 Connect to VK using an App

You can also connect a VK account using your own app. First of all you should create a VK application here: https://vk.com/apps?act=manage
Connect to your VK account, then you click Create an Application button on the right.

create-vk-app

In order to get your Application ID and Application Secret you’ll need fill some mandatory fields:

  • Title: Your title
  • Platform: Website
  • Site address: http://yoursite.com
  • Base domain: yoursite.com

fill-infor-vk

Then, click on Connect Site button.

A pop-up window display, click Get code button, then you need to input the confirmation code sent to your mobile. Finally, press Confirm button.

confirm-code

You will see your App ID and Secure key in Settings on the left Menu. App credentials that needs to be copied in Social Backlinks.

vk-app-infor
OK now your VK App is ready to be used!

Add VK Credentials in Social Backlinks

Now you may copy App ID and App Secret to the VK configuration of Social Backlinks in order to be connected. First put your mouse over the VK block, on the right of your screen then click on “Settings” button.

vk-settings

Copy and paste to your  App ID and App Secret field then click on Save button.

fill-key-vk

Your VK account in now configured but not connected yet, you just need to login to your account by clicking on the VK On button.

on-vk

You will copy the LINK and paste to Full address field as the Automatic connection step above.

auto-link-vk
Congratulations, VK connection successful!

connected-vk

III. JOOMLA CONTENT SELECTION

3.1 Choose your Joomla content

Social Backlinks interface is built to be simple and fast; simple because everything is built around a single view, fast because the major part of the configuration is built with JavaScript.
On the left part of your screen you can choose content you want to synchronize and the way to synchronize it. On the center part of your screen you can see a button to force the content to be synchronized and the latest results bellow.

content-social-filter

 

In order to choose the content you need to click on the Select button in the Joomla accordion.

image48

 

Then you’ll be invited to select Joomla content using 2 main options: Select all contents or particular items.
All content will synchronize all new articles published on your website. Using select items you can choose particular categories or Joomla articles. Don’t forget to click Save to validate your choice.

When you’ve selected your content you can choose to synchronize your content when new article is published (recommended) or when article is updated.

image49

 

3.2 Sync an article or a category?

This is a big question! To reply shortly if you have a blog and you’re adding frequently some new articles, it’s better to select your category blog. Then Social Backlinks will send all your new blog articles on social networks.

If you select an existing article, you’ll need to set social backlinks to send content when article is updated. Why? Because Social backlinks is built to sync your new content with social network, if you save an old article, social backlinks will take the “latest update” date. It can be useful for example if you update a shop product and changing the price, your customers will be informed by Email.

Joomla-extension-content

 


3.3 Synchronization of 3rd party extensions

Social Backlinks is now integrated with other Joomla component:

  • K2
  • Yootheme Zoo
  • Hikashop
  • Virtuemart
  • Redshop
  • Eshop

The content selection process is the same, select your category or your product/content and then Social Backlinks is doing the job for you.

Content-selection-synchronization


3.4 Synchronization settings

Some additional parameters are available in the last left accordion:

  • The synchronization periodicity
  • The notifications in case of sync errors
  • The history cleaning interval
  • Name
  • Description

synchnization-social-history

 

3.5 Synchronization results

There is some tools included in Social backlinks to follow the content sent on social networks: An history & Error log

image53