Share This EE Plugin!

Three weeks ago I just stumbled over the Share This Wordpress plugin from Alex King, which I found very helpful and thought that it would be pretty nice to have in EE as well. So I just had a look at that code and wrote a plugin for EE based on the digg this plugin from Vik Rubenfeld. The plugin can be used in an "light" and in an "advanced" mode. The "light" mode is without any email functionality. If you have the tell-a-friend module installed you can use the plugin in the advanced mode, which enables the email tab in the layer. Expression Engine 1.5.2. is required in order to run that plugin.
For more instruction and the download read here.

Installation Instructions

1. Unzip the zip file in your plugins directory.
2. Add a link to the css and the js files in your global header to be available on all templates. Alternatively you can please the code of these three files in one of your existing templates.
3. Place the plugin code within the {exp:weblog:entries} tag in your templates.

Parameter

entry_id
ID for the blog entry.

link_title
Title text for the Link to open up the layer. Default is "Share This!"

title
Title text for the syndication links. If no title is given it will be fetched from the database.

bodytext
Some services allow the submission of short abstracts. This paramater can be used to set the abstract, otherwise it will be fetched from database from the body field. All values will be cut after 255 characters.

url
The url parameter is used to set the url for the full text article or permalink. This parameter should be set, when the plugin is used on index pages, otherwise the index page url will be fetched from database.

orientation
This parameter allowes you to control where to display the layer [top|bottom].

exclude
By default all available syndication options will be displayed. This option allows you to exclude the options you don't like to have to be displayed. You can exclude multiple options in a comma separated list.
Option Overview:
delicious, digg, furl, netscape, yahoo, technorati, google, newsvine, blinklist reddit, blogmarks, magnolia, live, tailrank, mister wong, stumbleupon

Examples

Basic
{exp:share_this entry_id="{entry_id}" url="{title_permalink={my_journal_group}/comments}"}

Advanced
{exp:share_this entry_id="{entry_id}" title="{title}" url="{title_permalink={my_journal_group}/comments}" link_title="Share this!" bodytext="This is an article about plugins" orientation="top"}

Full
{exp:share_this url="{title_permalink={my_journal_group}/comments}" title="{title}" entry_id="{ entry_id}" orientation="top"}
{exp:email:tell_a_friend charset="utf-8" allow_html='n'}
tell-a-friend form
{/exp:email:tell_a_friend}
{/exp:share_this}


Download

• Plugin
• Readme

Notes

Some people tried to include the Share This! Plugin within the index templates of their sites and wondered why the tell-a-friend form wasn't showing up at all. This is due to the fact, that all forms including the comment form are only available in the pages where the url_title or the entry_id is given.
Here is the answer I got from Derek Jones (after stupidly asking without searching the documentation for any help):

This information actually is in the documentation in quite a few places, referring either to having an entry_id or url_title in the URL, or needing to be placed on a “single-entry” templates, which it explains, are pages that are linked to with an entry_id or url_title in the URL.

 

Requirements

Expression Engine 1.5.2. is required in order to run that plugin.

 

Comments

Leave a Comment

Commenting is not available in this weblog entry.