Social Backlinks documentation
- I. SOCIAL BACKLINKS INSTALL
- II. SOCIAL NETWORKS CONNECTION
- III. JOOMLA CONTENT SELECTION
The goal of Social Backlinks is to push Joomla content automatically on social networks, a real time saver regarding social marketing and SEO.
I. SOCIAL BACKLINKS 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.
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).
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.
Enter your JoomUnited credentials, the same you use to login here @ www.joomunited.com
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.
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.
Then accept the disclaimer that will be opened in a popup.
Then you need to connect to your Facebook account to post on a page.
Then you need to validate the permission about who will be able to access to your publication...
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.
It’s done! You’re connected, and the button will turn On, you can start posting on Facebook pages.
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.
Create an App
Then go to the Apps menu and add a new one
Create a new application, input an App name
A Add a product page will be appeared. Then click on Facebook Login > Set Up button.
Then select a platform Website
Then fill the App domain and site URL fields with your website domain (no https://www) and URL (with https://www)
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
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.
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.
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.
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
B. Get you page ID at the end of the URL
C. Fill the number or name in Social Backlinks in order to post on the proper page
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" button. Then 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.
Then validate the disclaimer and you'll be redirected to a Twitter login page. Login with your regular account.
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
In order to get your Consumer key and Consumer secret you’ll need fill some mandatory fields:
- 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
Then you can get your Consumer key and Consumer secret by clicking on the link manage keys and access tokens.
App credentials that needs to be copied in Social Backlinks
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.
Copy and paste your consumer key and consumer secret then click on Save button.
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.
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.
Congratulations, Twitter connexion successful!
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.
Then validate the disclaimer and you'll be redirected to a LinkedIn login page. Login with your regular account.
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
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
When your application is created you’ll get a success massage with your API Key and your Secret Key.
Add 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.
Copy and paste your API key and Secret Key then click on Save button.
In order to connect click on the LinkedIn On related button
Then you’ll be invited to authorize you App to access to your profile, please click OK, I’ll Allow It.
Your LinkedIn account is now fully connected with Social backlinks.
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.
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.
You can choose Community or your profile in your VK account, then click Continue button.
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.
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
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.
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.
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.
Copy and paste to your App ID and App Secret field then click on Save button.
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.
You will copy the LINK and paste to Full address field as the Automatic connection step above.
Congratulations, VK connection successful!
III. JOOMLA CONTENT SELECTION
3.1 Choose your Joomla content
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.
In order to choose the content you need to click on the Select button in the Joomla accordion.
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.
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.
3.3 Synchronization of 3rd party extensions
Social Backlinks is now integrated with other Joomla component:
- Yootheme Zoo
The content selection process is the same, select your category or your product/content and then Social Backlinks is doing the job for you.
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
3.5 Synchronization results
There is some tools included in Social backlinks to follow the content sent on social networks: An history & Error log