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).

image9

 

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 (even for posting 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.

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, chose an App name and category

app-name

 

Then on the left menu, hit, Add a product > Facebook Login

add-a-product

Then go to the left menu: Setting > Basic > Add a platform (bottom button)

setting-platform

Select 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

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 “Config” button.

image21

 

Those two field bellow need to be filled in order to post on your Facebook personal account (not on page). Paste the App ID and App secret then click Save.

image22

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

Congratulation you are now successfully connected to Facebook!

 

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

Note: you can also choose to publish your content only on a page, only on profile or both.


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

 

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

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 “Config” 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-key

 

You should fill 2 fields in the LinkedIn 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 “Config” 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.

 

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