This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Gregarious

Description

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
  • PostBadge

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.

Template Tags

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

  • digg_button() – displays a dynamic Digg-style button with the number of Diggs.

Digg extra

  • 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

  • reddit_button() – displays a dynamic Reddit button

Share This

  • share_this() – displays a Share This link to submit post to social sites

Feedburner FeedFlare

  • feed_flare() displays the FeedFlare as defined in the Feedburner settings

PostBadge

  • 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.

Module development

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.

Installation

Installing Gregarious into your WordPress blog is extremely straightforward.

  1. Download and unzip gregarious
  2. Upload the gregarious folder to the /wp-content/plugins/ directory
  3. (If you’re going to use the “Share This” module, CHMOD akst.js and akst.css in module/share-this/ to 777)
  4. Activate the plugin through the ‘Plugins’ menu in WordPress
  5. Configure your settings from the Gregarious options page (Options -& Gregarious)
  6. 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.

FAQ

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.

Other

When all else fails, we’re still here to help. Contact the developer for assistance by posting a comment at the official website.

Contributors & Developers

“Gregarious” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Gregarious” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.