ochJSsocials (content plugin)

Requirements

• Basic Joomla! knowledge available between the chair and the keyboard :)

Installation is easy!

1. Download the plugin
2. in the Back-end go to menu Extensions > Manage
3. in the tab [Upload file package] click [browse]  and select your downloaded plugin
4. click [Upload & Install], wait for the installation to finish

Configuration

1. in the back-end go to menu Extensions > Plugins
2. search / locate the 'jsSocials' content plugin
3. open the plugin
4. in the tab [Plugin] set status to [Enabled]
5. in the tab [jsSocials buttons] configure your buttons > look at the tool-tips for information about what each button does
6. [FULL (subscription) version] in the tab [Custom campaigns] configure your UTM parameter (e.g. used for tracking Campaigns in Google Analytics)
7. in the tab [Auto buttons] configure the automatic insertion of the buttons on selected categories (top, bottom, readmore position) or views
8. in the tab [jsSocials theme] configure the theme that you want to use
9. click [Save & Close] and you are good to go

Manually add Social sharing buttons in your blog / article

You can place the buttons automatically on the top or bottom (or both) positions of the selected article categories, but the real power lies in the manual placement of the Social sharing buttons:

1. open the blog / article (or even HTML module!) that you want to place the Social sharing buttons in
2. insert:
   1. {jssocials} into the location where you want to automagically display the Social sharing buttons
   2. [FULL (subscription) version]:{jssocials url="https://your custom url", title="your custom text", buttonorder="F,T"} into the location where you want to automagically display the Social sharing buttons
3. click [Save & Close]
4. when surfing to your article / blog on the frontend, the Social sharing buttons should automagically show up: Cool :)

Overview of tag parameters (ochJSsocials: FULL (subscription) version)

You can set or override the configured plugin settings with the following parameters. Want to remove a configured setting? Just add the parameter with empty string (like: via=""):

• url="htps://your custom url"
• title="your custom title"
• buttonorder="your buttons in the order you like"
• via="X (twitter) via accountname"
• call2action="X (twitter) added text"
• hashtags="X (twitter) added hashtags"
• quote="your Facebook quote text"
• image="your Pinterest image"

Support for Custom Article Fields (ochJSsocials: FULL (subscription) version)

You can set or override the configured plugin settings with the following Custom Article Fields, you need to first create these Custom Article Fields and then map them to ochJSsocials in the plugins Integration tab:

• url (field type url)
• title (field type: text)
• buttonorder (field type text)

Facebook Like box (ochJSsocials: FULL (subscription) version)

In the ochJSsocials configuration you need to add the code from the Facebook Like Button Configurator. Here you can configure the Like box just the way you like it. You can leave the 'URL to Like' default because ochJSsocials will overwrite this url on the page with the page url or with the url you configred via a ochJSsocials parameter.

When done configuring the Like box, press [Get Code] and select your App-ID and Language.

Now you can copy the step 2 and Step 3 code into the respective configuration settings of ochJSsocials (tab [Facebook Like].

In the page where you want to show the Facebook Like box you can enter {jssocials fblike}. That tag will then be replace by the Facebook Like box you configured.

If you want to have the Facebook Like box point to a different URL then the current URL, you can set the following tag: {jssocials fblike url="https://your custom url"}.