Version 3.3 © Copyright - codextrous.com
This is user documentation of Joomla! plugin B2J Social Sharer ( a smart tool to improve your social presence). Document describes plugin requirements and installation and how to use it.
B2J Social Sharer plugin is the the bridge which connects your website with social networking. The B2j Social Sharer adds social sharing icons to your items’ view pages. It works with Joomla native article management system, K2 component, and redShop component. It is lightweight, configurable, and comes with predefined set of presets.
Requirements & Installation
- PHP 5.3+
- MySQL 5+
- Joomla 3+
- K2 Component (Latest)[optional]
- Download install-able kit from Product Page.
- Go to your website's admin panel => Extensions => Extension Manager.
- Upload the downloaded kit and click on install.
To upgrade the plugin, you just need to install the new version kit on your existing setup. Need not to un-install the previously installed version.
Important: If you uninstall the plugin you will lose all the settings you have.
How to use it?
It's time now to install and use our plugin. The installation process is the same as for any other extension. When done with installation, make sure it is enabled. Let’s take a look at the back-end of the plugin now.
As you can see, there are 4 tabs other than Plugin. Lets discuss them one by one.
Content Manager - Here you can choose the plugin to work with all available content managers, or choose the only one. Currently the available ones are K2, Joomla native article manager and redSHOP. Note, that you can't filter redSHOP categories, but you can filter other content manager categories. (see more info below)
K2 Category Filter (only available if Content Manager is K2 or All) - You can choose the plugin to work with all K2 categories, or filter by choosing them manually.
Choose K2 categories (only available if Content Manager is K2 or All) - You can specify the K2 categories manually for the ones you want the plugin to work for. K2 Category Filter must be on Select option for this setting to work.
Article Category Filter(only available if Content Manager is Joomla Article Manager or All) - You can choose the plugin to work with all Joomla Article Manager categories, or filter by choosing them manually.
Choose Article Categories (only available if Content Manager is Joomla Article Manager or All) - Here you can specify the Joomla Article Manager categories manually for the ones you want the plugin to work for. Article Category Filter must be on Select option for this setting to work.
Show in category view - If you want the plugin to be shown in category views, you need to enable this option. Important note: when you enable 'Show Share Count', the plugin sends requests to social networking websites in order to get the number of shares, which may take some time. In category view, if you have many items, it will send requests for each of the items, and you page loading time may increase dramatically, so it is not recommended to use this option. Use this option only when Show Share Count is disabled.
Preset - There are many presets available to choose. You can choose the one, which is the most suitable for your template. There is one, called Social - Default with Counts, which has the standard style, provided by social networks. Please, note, this is the only preset, which always shows the number of shares of current page, no matter if 'Show Share Count' is enabled or not.
Buttons styles- allows you to control the look of 'Share' buttons. See what options are available.
Icon size- Select the size of the social icons
Position - Specify position for the social icons to appear. Currently it can be positioned after and before the content and both. Please note, that plugin uses events to render the social icons, so if you can't see the icons, it may be caused by your template override, which does not fire the events.
Alignment - You can specify the horizontal alignment of the icons here.
Add Facebook 'og' meta tags - If you don’t have any other plugin, which can make your website pages easily and directly accessible for Facebook, this option is here to help. It adds 'og' tags necessary for Facebook to grab the content right way. Please note, that when using Joomla Article Manager, wrong image may be taken by Facebook.
Twitter Via - You can specify the 'Via' option for the twitter.
Show Share Count - If you want the plugin to show the number of shares next to the social networking icons, you can enable this option. If this option is enabled, you can configure the color of the number and border.
Please note, that enabling this option will increase the page loading time, because it sends requests to social networking websites, and get the responses to fetch the number of shares, which takes some time.
Count Box Color (only available if Show Share Count is enabled) - Allows to specify the text color and border color for the number of shares.
Ordering of social Icons
You can specify the ordering of social network icons, you can also Disable or Enable any of them.
If you select Custom Icon in Preset, then you can upload your own icon, as displayed in below screenshot. After selecting this Preset, you must upload/select the icons which you want to display. Please do editing of icons, as there will be no css applied to them, like you should have same size for all icons.