LG Social Bookmarks Add social bookmarking links to your weblog entries & templates

Download LG Social Bookmarks v1.4.3 Table of contents

Features

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_bookmarks directory to your /system/modules directory
Copy the language/english/lang.social_bookmarks.php file to your /system/languages/english directory
Copy the themes/cp_global_images/social_bookmarks directory to your /themes/cp_global_images directory

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

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.

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
Facebook
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
Reddit
Scoopeo
scuttle
Shadows
Simpy
Slashdot
Smarking
Spurl
SphereIt
StumbleUpon
Taggly
Technorati
TailRank
ThisNext
Webride
Windows Live Favourites
Wists
Wykop
YahooMyWeb

Variable Pairs

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