Login

INTRODUCTION


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.
B2J Social Sharer is a smart tool to improve your social presence!



FILES


admin/elements/b2jhidden.php
admin/elements/b2jupdate.php
admin/js/images/
admin/js/b2jsocial.js
admin/js/jscolor.js

language/en-GB/en-GB.plg_content_b2jsocial.ini

css/b2jsocial.css

images/

b2jsocial.php
b2jsocial.xml

Please note, that every folder contains an index.html file. Besides, I skipped all the images containing in images folder to keep the list short and to the point.

Lets start from the files in the main folder.

b2jsocial.xml is the xml file of the plugin. It contains information about the plugin itself and back-end fields.

b2jsocial.php is the starting point file of the plugin. The whole logic and rendering of the plugin is included here. It is basically the plugin itself.

admin folder is for the back-end part of the plugin. There is a color picker in back-end, jscolor.js is the library for it.

admin/elements/b2jupdate.php is responsible for updates. If new updates are available, it notifies the user about it.

admin/elements/b2jhidden.php is the helper file for back-end. It includes all the necessary files.

BACK-END


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 is only one tab for the plugin to be configured.

Basic Settings

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.



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.

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.

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.

Ordering of social icons - You can specify the ordering of social network icons, you can also Disable or Enable any of them.