Plugin / QuickShare

There are several ways to control where QuickShare is displayed: * You can automatically have QuickShare filter on the_content for posts, pages, attachments, or all posts of any type, from the QuickShare Config settings page. * You can hide QuickShare from certain posts/pages that are using the automatic filter (see above) by listing their post IDs in the field below the automatic filters. The post ID is numeric and can be found in the URL of a post’s edit screen. This is the preferred method of hiding QuickShare from the homepage, or a contact page, etc. REQUIRES VERSION 1.4+ * Conversely, you can show QuickShare on specific pages by using the [quickshare] shortcode. This shortcode can be placed anywhere within a post or page, including in multiple places. You can use the shortcode with or without the automatic filtering of displaying on posts/pages/attachments, but be careful not to accidentally use the shortcode at the end of a post where the automatic filtering is turned on, because you’ll get two instances of QuickShare right next to each other. To use the shortcode, simply add “[quickshare]” to your posts/pages wherever you want QuickShare to display. It’s that easy! REQUIRES VERSION 1.4+ * Theme developers can use in their template files wherever sharing is desired, with the optional parameters allowing custom share data to be provided (see details below, under “share bar doesn’t display”). * Plugin developers can do additional things like automatically displaying QuickShare at the beginning of the post instead of the end, or providing an alternate icon set. QuickShare is designed to be flexible, so (with the exception of stats) you should be able to do pretty much whatever you want.

Pinterest is image-centric, so any content to be shared via Pinterest should include an image. QuickShare attempts to find an image in each post by first looking for a featured image, then grabbing the first attached image, looking for a raw image tag, or finally falling beck to a site-wide default image that you can set. You can also hide Pinterest sharing if no post image is found. The post image will also be used for Facebook and Google+ sharing, by default (if open graph meta tags are enabled). For best results, always set a featured image in your post.

QuickShare provides many options for design customization, but if you want to go as far as changing the share images (if Genericons aren’t working for you either), you can! Just throw in some custom CSS, based on the code in quickshare.css. You could even use your own icon font in place of Genericons!

If you look at quickshare.css, you’ll notice that the majority of the plugin’s options are controlled through CSS. I recommend poking around in there to get some ideas, then adding your styles to the custom CSS field in the admin settings page. Placing the code here will ensure it overrides all plugin options. Depending on the share display type (icons/genericons/text), you can change icon and background colors and sizes, adjust shadows and borders, change how the plugin fits with your theme’s layout (margins, padding, horizontal separations), add more CSS3 effects, and more! Unfortunately, it will be necessary to use !important in some places.

An unfortunately large number of themes have not-fully-thought-out styling that interferes with QuickShare. Please post in the support forums with a link to your site and I can provide the appropriate custom CSS that will fix it for your site (I have seen themes do this in many, many different ways, so the steps QuickShare takes to resolve the issues are somethimes insufficient).

QuickShare can only display after posts use the_content(). One example of where QuickShare can’t display is in gallery post formats on index and archive (not single view) pages in the Twenty Thirteen theme. However, if you have a custom theme or a child theme, you can customize the QuickShare output by adding to your template files somewhere within the loop. For additional customization, you can use , where $url is the link to the content to share, $title is the title, $source is the name of your website/blog, $description is a short description, and $imgurl is the thumbnail image url. This version of the custom QuickShare output can be used anywhere in your templates, inside or outside of the loop, opening the door to many customization options. If any of the parameters are null, QuickShare will attempt to populate them with the default values (using the $post global). Please remember to wrap this and all other plugin functions with if(function_exists()) to avoid killing your site if/when the plugin is deactivated. An example of a website using QuickShare in a custom context is Euclid’s Muse, on app display pages.

QuickShare is designed for modern browsers. I do not (and will not make much effort to) support IE8 or below, and do not support features that aren’t achievable with minimal CSS in other outdated browsers (including, now, IE9). That being said, if you find a compatibility issue with an easy fix, let me know on the support forums and I’ll consider including it. In the meantime, you can always add any desired CSS to the custom CSS field without worrying about losing plugin edits to updates. For the most part, everything should fail gracefully; older browsers won’t see special effects like rounded corners, transitions/animations, box shadows, and opacity filters, but will be functionally fine. Genericons do not work in several browsers (including IE7 and IE9 mobile, but not IE9 desktop), so don’t use that display option if you need lots of browser support.

If you think QuickShare should support sharing to additional networks, please let me know in the support forums and I’ll consider adding support. I don’t intend to add any more networks that would be enabled by default (or automatically enabled after an update), though.

The one caveat to the bloat-less implementation and philosophy that QuickShare uses is that there is no good way to track shares. It is technically possible to track the number of times users take the initial action of pressing the share button on your site; however, there is no way to confirm that the action was completed without pulling in data from the various networks (typically via their javascripts). Furthermore, there is no clean way to store internal statistics (number of times each action was initiated) without polluting the database and making the sharing process more technically complex. Therefore, I don’t plan on adding this functionality; if you find a possible alternative solution, please let me know and I will consider it. You should be able to track QuickShare shares as external links with analytics software such as Google Analytics if you’re interested in tracking shares (versus displaying the data publicly).

QuickShare does not work in WordPress versions below 3.5 (it will probably throw a php fatal error when attempting to activate). For best results, always use the latest version of WordPress.