LG Social Bookmarks Add social bookmarking links to your weblog entries & templates
Download LG Social Bookmarks v1.4.3 Table of contentsFeatures
The LG Social Bookmarks module allows you to insert social bookmarking links to any weblog post.
- Allows content authors to add social bookmarking links (Digg, Del.icio.us) to any weblog post
- Set default site links in your EE administration
- Override listed sites on a per template basis
- Fully customisable output
Screenshots
Requirements
LG Social Bookmarks is an Expression Engine module and has been tested on Expression Engine 1.6.1+.
Installation
The LG Social Bookmarks module contains a module folder, language file and some administration images.
To install the module follow the instructions below:
- Download the latest version of the module
- Extract the .zip file to your desktop
- Copy the
modules/social_bookmarksdirectory to your/system/modulesdirectory - Copy the
language/english/lang.social_bookmarks.phpfile to your/system/languages/englishdirectory - Copy the
themes/cp_global_images/social_bookmarksdirectory to your/themes/cp_global_imagesdirectory
Activation
- Log in to your sites administration
- Click the modules tab
- Scroll down to the Social Bookmarks module
- Click the 'install' link
To display a Social Bookmarks tab in your admin follow these simple steps:
- Click on the modules tab
- Scroll down to the Social Bookmarks module and click the title to open the Social Bookmarks administration page
- Click the 'New Tab' link the top right of your sites administration panel
- Press the 'Add New Tab' button to confirm
Configuration
The LG Social Bookmark module includes an simple administration to set the default list of sites that will be outputted.
To configure the default list of sites displayed follow the steps below:
- Open the Social Bookmarks administration page
- To activate a site click on the corresponding grey button
- To de-activate a site click on the corresponding green button
- Confirm the change to the active sites by pressing the 'Update social bookmarks button'
Displaying social bookmarking links in your weblog entries
Displaying social bookmarking links in your weblog entries is as easy as adding a {exp:lg_social_bookmarks} tag pair inside the {exp:weblog:entries} loop. A complete example of the {exp:social:bookmarks} tag can be seen below
{exp:weblog:entries weblog="news"}
{exp:lg_social_bookmarks title="{title}" permalink="{url_title_path="template_group/comments"}"}
<p>Enjoy this post? Share it with others.</p>
<ul>
{social_sites}
<li>
<a href="{social_site_url}" title="Bookmark on: {social_site_name}">
<img src="/themes/cp_global_images/lg_social_bookmarks_module/favicons/{social_site_img_url}" alt="{social_site_name} Favicon" />
<span>Bookmark on {social_site_name}</span>
</a>
</li>
{/social_sites}
</ul>
{/exp:lg_social_bookmarks}
{/exp:weblog:entries}
Tag Reference
LG Social Bookmarks tag
The LG Social Bookmarks tag is the only tag used to show the sites you select in your administration Social Bookmarks page.
The LG Social Bookmarks tag can be used to render both the default active set of links selected in your sites administration or a custom set of sites on a per template basis.
Parameters
title= [required]
title="{title}"
The title of of your weblog entry.
permalink= [required]
permalink="http://leevigraham.dev/{template_group/template/}"
The permalink to your weblog entry which must contain the full url.
sites= [optional]
sites="Digg|del.icio.us|Blinklist"
The default list of sites you have chosen on the Social Bookmarks administration page can be over ridden with a custom set of social bookmarking sites using the sites parameter. The parameter accepts a pipe '|' delimited list of the supported social bookmarking sites.
The supported list of social bookmarking sites include:
- blinkbits
- BlinkList
- BlogMemes
- BlogMemes Fr
- BlogMemes Sp
- BlogMemes Cn
- BlogMemes Jp
- blogmarks
- blogtercimlap
- Blue Dot
- Book.mark.hu
- Bumpzee
- co.mments
- connotea
- del.icio.us
- De.lirio.us
- Digg
- DotNetKicks
- DZone
- Fark
- feedmelinks
- Furl
- Fleck
- Google Bookmarks
- Gwar
- Haohao
- Hemidemi
- IndiaGram
- IndianPad
- Internetmedia
- kick.ie
- LinkaGoGo
- Linkter
- Ma.gnolia
- MisterWong
- MyShare
- NewsVine
- Netscape
- Netvouz
- PlugIM
- PopCurrent
- ppnow
- RawSugar
- Rec6
- Scoopeo
- scuttle
- Shadows
- Simpy
- Slashdot
- Smarking
- Spurl
- SphereIt
- StumbleUpon
- Taggly
- Technorati
- TailRank
- ThisNext
- Webride
- Windows Live Favourites
- Wists
- Wykop
- YahooMyWeb
Variable Pairs
{social_sites} ... {/social_sites} [required]
{exp:weblog:entries weblog="news"}
{exp:lg_social_bookmarks title="{title}" permalink="{url_title_path="template_group/comments"}"}
<p>Enjoy this post? Share it with others.</p>
<ul>
{social_sites}
<li>
<a href="{social_site_url}" title="Bookmark on: {social_site_name}">
<img src="/themes/cp_global_images/lg_social_bookmarks_module/favicons/{social_site_img_url}" alt="{social_site_name} Favicon" />
<span>Bookmark on {social_site_name}</span>
</a>
</li>
{/social_sites}
</ul>
{/exp:lg_social_bookmarks}
{/exp:weblog:entries}
The {exp:lg_social_bookmarks} tag contains one variable pair, {social_sites}. The {social_sites} variable pair loops through all your chosen sites and outputs html code replacing the following nested single variables.
Single Variables
{social_site_name} [nested in {social_sites}]
Replaced with a human readable version of the social bookmarking sites name.
{social_site_url} [nested in {social_sites}]
Replaced with the url for the social bookmarking site including passed parameters.
{social_site_img_url} [nested in {social_sites}]
Replaced with the filename of the corresponding site favicon without a directory path. Favicons for all supported sites are provided in the themes/cp_global_images/social_bookmarks directory in the .zip download.
Change Log
1.0.0
- Initial Release
1.4.0
- Tweaked Facebook bookmark url
- Changed method names to follow new internal coding standards
- Source code commenting in PHPDoc syntax
- Added Slovak language file
1.4.1
- URL encoded titles
1.4.2
- Fixed URL encoded titles
1.4.3
- Fixed Stumble Upon url validation
- Fixed admin images path
License
LG Social Bookmarks is licensed under a Creative Commons Attribution-Share Alike 3.0 Unported License.
Contributors
Page created on: Oct 22, 2007
Last updated on: Jun 14, 2008
Enjoy LG Social Bookmarks v1.4.3? Bookmark and share it with others.