Beschreibung
A simple, customisable share buttons solution designed specifically for theme developers.
If you would like to help out please contribute to the GitHub repository
Installation
Install the plugin in whatever way you deem fit. Once installed you can set the default settings on the options page.
FAQ
- What functions are available to use?
-
There are 4 functions available to use:
1.get_dev_share_buttons
returns html of share links
2.the_dev_share_buttons
a wrapper just to echoget_dev_share_buttons
3.get_dev_profile_links
returns an array of the links to social pages that are saved in the admin area
4.the_dev_profile_links
echos the links asa
tags in adiv
get_dev_share_buttons and `the_dev_share_buttons` both accept 5 optional parameters:
- services – An array of service ids eg
array( 'facebook', 'twitter', 'google' )
. Defaults to the options saved on the options page - url – The url to share. Defaults to value of
get_the_permalink()
- title – The title of the item to share. Defaults to the value of
get_the_title()
- text – The text that appears before a service title eg „Share on“. Defaults to the value set on the options page.
- image – The url of an image to go along with the main item, only used by certain services. Defaults to the post thumbnail.
- services – An array of service ids eg
- Are there default styles for this?
-
Yes there are! I have added some simple default styles that you can optionally enable:
add_filter( 'dev_share_buttons_css', '__return_true' );
- Adding more services
-
You can add more services using a filter:
add_filter( 'dev_share_buttons_services', 'my_new_service' ); function my_new_service( $services ) { $services['myserviceid'] = array( 'id' => 'myserviceid', 'title' => 'My Service Title', 'url_structure' => 'http://www.shareurl.com/?url=%1$s&title=%2$s&text=%3$s&image=%4$s', 'url_after_title' => false ); return $services; }
- Adding Icons
-
Icons can be added via pure css or the filters provided to add content before or after the button text:
// Add an svg icon to share buttons. function my_share_social_icons( $html, $service ) { $icon_url = get_stylesheet_directory_uri() . '/svg-icons.svg#' . $service['id']; $icon_html = '<svg><use xlink:href="' . $icon_url . '"></use></svg>'; return $html . $icon_html; } add_filter( 'dev_share_buttons_after_share_text', 'my_share_social_icons', 10, 2 ); // Add a png icon to profile links. function my_profile_social_icons( $html, $service ) { $icon_url = get_stylesheet_directory_uri() . '/social-icons/' . $service['id'] . '.png'; $icon_html = '<img src="' . $icon_url . '" />'; return $html . $icon_html; } add_filter( 'dev_share_buttons_after_profile_text', 'my_profile_social_icons', 10, 2 );
- Disabling the Web Share API
-
The Web Share API is disabled by default but I recommend enabling it as it will display a single share button instead of the multiple buttons if the browser supports it. If you wish to enable this feature you can add a filter:
add_filter( 'dev_share_buttons_share_api', '__return_true' );
Rezensionen
Mitwirkende & Entwickler
„Developer Share Buttons“ ist Open-Source-Software. Folgende Menschen haben an diesem Plugin mitgewirkt:
MitwirkendeÜbersetze „Developer Share Buttons“ in deine Sprache.
Interessiert an der Entwicklung?
Durchstöbere den Code, sieh dir das SVN Repository an oder abonniere das Entwicklungsprotokoll per RSS.
Änderungsprotokoll
1.0.1
- Prevent
the_
functions from returning values - Add spaces between profile links
1.0.3
- Fix profile link widget
1.0.4
- Improve support for non post object based pages
1.0.5
- Add
rel="me"
support for profile links
1.0.6
- Update to all https links
- Use updated twitter and pinterest urls
- Url encode more things for better character support
1.0.7
- Add extra filters to add content before and after button text (useful for icons)
- Update coding standard
1.0.8
- Use
rawurlencode
to improve compatibility with some services
1.1.0
- Add some optional default styles
- Add Medium, Messenger, Skype, Snapchat, WeChat, WhatsApp and YouTube profile links
1.2.0
- Add support for the Web Share API