An often overlooked method of implementing social sharing buttons (without counters) on your site. Super lightweight without any external loaded resources, JavaScript, or CSS. Fully customisable using CSS and WordPress filters., (*1)
The social buttons are designed to work on sites already running a Bootstrap theme with FontAwesome icons. The plugin does not automatically load any JavaScript or CSS resources., (*2)
If you don't want to use Bootstrap or FontAwesome, you can still use this plugin by providing your own CSS or by using WordPress filters to change the button and icon classes., (*3)
Installation
Composer
composer require bostondv/bootstrap-share-buttons, (*4)
WordPress Plugin
Coming soon to the WordPress.org plugin repository., (*5)
- Upload the
bootstrap-share-buttons folder to the /wp-content/plugins/ directory
- Activate the Bootstrap Share Buttons plugin through the 'Plugins' menu in WordPress
Manually Include
Download the repository and upload to your project. Include bootstrap-share-buttons.php in your project somewhere., (*6)
Usage
Shortcode
Display social buttons anywhere shortcodes are supported., (*7)
[bs-share-buttons twitter="bostondv" display="facebook,twitter,google,pinterest" style="both" type="default" size="md" /], (*8)
Function Call
Display social buttons anywhere within your PHP templates., (*9)
<?php echo bootstrap_share_buttons( 'bostondv', 'facebook,twitter,google,pinterest', 'both', 'default', 'md' ); ?>, (*10)
Parameters
twitter Required
Your twitter account handle., (*11)
display Optional
Comma separated list of share buttons you wish to display., (*12)
Options: facebook, twitter, google, pinterest, linkedin, email, print, or all.
Default: all, (*13)
style Optional
Style of button to display., (*14)
Options:icon, text, or both.
Default: both, (*15)
type Optional
Bootstrap button type., (*16)
Options: default, primary, success, info, warning, or danger.
Default: default, (*17)
size Optional
Bootstrap button size., (*18)
Options: xs, sm, md, or lg.
Default: md, (*19)
Filters
bs_share_items
Allows you to change the share buttons displayed and any of their parameters., (*20)
Takes two arguments:
$displayed_items (Array) - All items that will be displayed.
$all_items (Array) - Array of all available social share buttons., (*21)
bs_share_btn_class
Allows you to change the share button classes., (*22)
Takes two arguments:
$classes (Array) - Array of all button classes.
$name (String) - Name of the share button eg. 'facebook'., (*23)
bs_share_icon_class
Allows you to change the share button icon classes., (*24)
Takes two arguments:
$classes (Array) - Array of all icon classes.
$name (String) - Name of the share button eg. 'facebook'., (*25)
bs_share_text
Allows you to change the share button text. Used for the link title attribute, and the button text if style equals text or both., (*26)
Takes two arguments:
$text (String) - Text for the button.
$name (String) - Name of the share button eg. 'facebook'., (*27)
About
Written by Boston Dell-Vandenberg of Pomelo Design. Pomelo Design is a web and mobile app development agency based in Toronto, Canada., (*28)
Wallogit.com
