=== Gregarious ===
Contributors: AnkurKothari
Donate link: http://lipidity.com/donate
Tags: social, share this, digg, del.icio.us, gregarious, bookmark, social bookmarking, reddit, ajax, stats, sociable, advanced, post, statistics, integration, ma.gnolia, furl, blinklist, blogmarks, tailrank, newsvine, google, button, email, recommend, share, search, msn, stumbleupon, socialize, Technorati, e-mail, slashdot, live, netscape
Tested up to: 2.2
Stable tag: trunk

Gregarious is the ultimate social bookmarking plugin. Everything is configurable. Share link, Digg button, stats, FeedFlare, LiveSearch and more.

== 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*.

== 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
2. (If you're going to use the "Share This" module, CHMOD akst.js and akst.css in module/share-this/ to 777)
3. Activate the plugin through the 'Plugins' menu in WordPress
4. Configure your settings from the Gregarious options page (Options -& Gregarious)
5. 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.

== Frequently Asked Questions ==

= 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](http://lipidity.com/web/wordpress/wp-plugin-gregarious "Gregarious").

== 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](http://dev.lipidity.com/docs/ "Gregarious").

== 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](http://dev.lipidity.com/feature/wp-plugin-gregarious "Gregarious").