After the official launch three months ago and some minor releases to adjust previous bugs, the first major named 1.1 has finally come. This new version adds two new functions: a template tag and a widget.
Template Tag social_ring_show()
This function allows webmasters to place social buttons in their favourite position. This function must be used inside the loop, otherwise it will not be working properly.
In order to recover it you can use the following code (the if statement on function existance avoids errors in case of deactivation)
<?php if(function_exists('social_ring_show')){ social_ring_show();} ?>
This function is very useful expecially to exceed the limits of the visualisation before or after the content. By working directly on the theme you can now place buttons before the title or between the title and date etc.
You can also use it with themes that show only the excerpt of the post on archives and home. In this case the old plugin was not usable, while with the new one you can recall the template tag before the excerpt function.
Social Ring Widget
This is a widget to add social buttons on sidebars. Its goal is to promote the home page, in fact the shared address is the same on all pages. You can see social Ring Widget in action here on the sidebar on the right.
The widget has some options, let’s see them:

- Widget Title: is the title above the widget.
- URL: is the address shared on social networks. It’s the same on all pages and its default value is the home page of the blog. If you insert your Fan Page address as Facebook Like URL, people who click on it become fans.
- Twitter: Besides the URL, you can insert text and account (“via @account”) which will appear in the Tweet. You can also recommend a Twitter accounts for users to follow after they share content from your website.
- Style: widget graphic is not so much customizable. You can change only button distance, widget padding and border colour.
The minimum width required for the sidebar to show the widget properly is 200px. Default values for button margin and widget padding are optimized for a 300px sidebar. If your theme has a smaller one, you can reduce those values to adapt Social Ring widget to it.
If you find any bug you can report it in the comments, I’ll fix it as soon as possible. These are the features that will be added in next versions:
- Shortcode to add buttons inside posts.
- CSS editing by admin page.
- Twitter settings.
- Flattr and linkedin.
For any suggestion write me.
