div<\/code><\/p>\n\nget_dev_share_buttons and `the_dev_share_buttons` both accept 5 optional parameters:\n<\/code><\/pre>\n\n\n- services - An array of service ids eg
array( 'facebook', 'twitter', 'google' )<\/code>. Defaults to the options saved on the options page<\/li>\n- url - The url to share. Defaults to value of
get_the_permalink()<\/code><\/li>\n- title - The title of the item to share. Defaults to the value of
get_the_title()<\/code><\/li>\n- text - The text that appears before a service title eg \"Share on\". Defaults to the value set on the options page.<\/li>\n
- image - The url of an image to go along with the main item, only used by certain services. Defaults to the post thumbnail.<\/li>\n<\/ol><\/dd>\n
- Are there default styles for this?<\/dt>\n
Yes there are! I have added some simple default styles that you can optionally enable:<\/p>\n\n
add_filter( 'dev_share_buttons_css', '__return_true' );\n<\/code><\/pre><\/dd>\n- Adding more services<\/dt>\n
You can add more services using a filter:<\/p>\n\n
add_filter( 'dev_share_buttons_services', 'my_new_service' );\nfunction my_new_service( $services ) {\n $services['myserviceid'] = array(\n 'id' => 'myserviceid',\n 'title' => 'My Service Title',\n 'url_structure' => 'http:\/\/www.shareurl.com\/?url=%1$s&title=%2$s&text=%3$s&image=%4$s',\n 'url_after_title' => false\n );\n return $services;\n}\n<\/code><\/pre><\/dd>\n- Adding Icons<\/dt>\n
Icons can be added via pure css or the filters provided to add content before or after the button text:<\/p>\n\n
\/\/ Add an svg icon to share buttons.\nfunction my_share_social_icons( $html, $service ) {\n $icon_url = get_stylesheet_directory_uri() . '\/svg-icons.svg#' . $service['id'];\n $icon_html = '<svg><use xlink:href=\"' . $icon_url . '\"><\/use><\/svg>';\n return $html . $icon_html;\n}\nadd_filter( 'dev_share_buttons_after_share_text', 'my_share_social_icons', 10, 2 );\n\n\/\/ Add a png icon to profile links.\nfunction my_profile_social_icons( $html, $service ) {\n $icon_url = get_stylesheet_directory_uri() . '\/social-icons\/' . $service['id'] . '.png';\n $icon_html = '<img src=\"' . $icon_url . '\" \/>';\n return $html . $icon_html;\n}\nadd_filter( 'dev_share_buttons_after_profile_text', 'my_profile_social_icons', 10, 2 );\n<\/code><\/pre><\/dd>\n- Disabling the Web Share API<\/dt>\n
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:<\/p>\n\n
add_filter( 'dev_share_buttons_share_api', '__return_true' );\n<\/code><\/pre><\/dd>\n\n<\/dl>\n\n\n1.0.1<\/h4>\n\n\n- Prevent
the_<\/code> functions from returning values<\/li>\n- Add spaces between profile links<\/li>\n<\/ul>\n\n
1.0.3<\/h4>\n\n\n- Fix profile link widget<\/li>\n<\/ul>\n\n
1.0.4<\/h4>\n\n\n- Improve support for non post object based pages<\/li>\n<\/ul>\n\n
1.0.5<\/h4>\n\n\n- Add
rel=\"me\"<\/code> support for profile links<\/li>\n<\/ul>\n\n1.0.6<\/h4>\n\n\n- Update to all https links<\/li>\n
- Use updated twitter and pinterest urls<\/li>\n
- Url encode more things for better character support<\/li>\n<\/ul>\n\n
1.0.7<\/h4>\n\n\n- Add extra filters to add content before and after button text (useful for icons)<\/li>\n
- Update coding standard<\/li>\n<\/ul>\n\n
1.0.8<\/h4>\n\n\n- Use
rawurlencode<\/code> to improve compatibility with some services<\/li>\n<\/ul>\n\n1.1.0<\/h4>\n\n\n- Add some optional default styles<\/li>\n
- Add Medium, Messenger, Skype, Snapchat, WeChat, WhatsApp and YouTube profile links<\/li>\n<\/ul>\n\n
1.2.0<\/h4>\n\n\n- Add support for the Web Share API<\/li>\n<\/ul>","raw_excerpt":"A super lightweight social sharing solution using either the Web Share API or simple sharing links.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/27991","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=27991"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/terminalpixel"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=27991"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=27991"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=27991"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=27991"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=27991"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=27991"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}