Gregarious is a social bookmarking plugin that integrates the new Digg API and Alex King’s Share This plugin, as well as the Reddit button and Feedburner’s Feedflare into one powerful, easy to use package. The AJAX interface makes customization a breeze, and the options put you in control. Gregarious works on a module based system, which means that it can have as many or as little features as you like. Modules available include:
- Digg button
- Digg extra (advanced template tags)
- Share This
- Reddit button
- Feedburner FeedFlare
Everything can be configured from the options page. There are absolutely zero template edits required.
You have the option to choose which modules are enabled, and in turn, how many features you’d like to have.
The plugin has been written with usablility and performance in mind, so it shouldn’t have any adverse affects on the speed of your blog while providing you with the most comprehensive social bookmarking system ever.
Gregarious provides various avenues for template for theme / template designers to make use of. Tags are distributed in the individual modules as follows:
digg_button()– displays a dynamic Digg-style button with the number of Diggs.
dugg_posts()– displays a HTML list of the most recent Dugg posts
dugg_posts_count()– displays the number of posts in total that have been Dugg
reddit_button()– displays a dynamic Reddit button
share_this()– displays a Share This link to submit post to social sites
feed_flare()displays the FeedFlare as defined in the Feedburner settings
post_badge()– displays content as defined in the PostBadge section of the Gregarious options page (appended to the post by default)
All the template tags are extremely customizable and take a whole range of parameters, but for brevity, they are omitted from this guide. A full documentation is in the works. You can see the progress at the official website.
It is possible, and very easy, for developers wishing to add functionality to Gregarious to develop a module. Modules follow a standard protocol so they can be developed in minutes. Documentation is still in the works, but an easy way to extend Gregarious while it’s being written is to look at how the existing modules are written and follow on from there.
Support is always available – just post a comment at the official website.
Installing Gregarious into your WordPress blog is extremely straightforward.
- Download and unzip
- Upload the
gregariousfolder to the
- (If you’re going to use the “Share This” module, CHMOD akst.js and akst.css in module/share-this/ to 777)
- Activate the plugin through the ‘Plugins’ menu in WordPress
- Configure your settings from the Gregarious options page (Options -& Gregarious)
- Make sure to hit save at least once even if you don’t change anything so the plugin is fully configured.
Note: To make use of the functionality of Gregarious, you may need to activate some modules. The PostBadge module is usually required if you would like to append the links / buttons to your posts automatically, otherwise you may use template tags.
- Why am I getting a Share This page instead of popup?
Firstly, make sure that the
<?php wp_footer(); ?>call is included in your template, usually in footer.php. Without this, the popup wont work. This will fix 99% of issues.
If you’re still not getting the popup, make sure you’ve turned on the relevant setting in the options page, and try saving and / or resetting the options.
- Nothing’s showing on my blog
Gregarious gives you the option of either using template tags or the PostBadge module to show links / badges on your posts. The easiest way to show links on your posts automatically is to activate and configure the PostBadge module.
When all else fails, we’re still here to help. Contact the developer for assistance by posting a comment at the official website.