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

Download LG Social Bookmarks v2.0.2 Table of contents

Updgrading from LG Social Bookmarks v1?

LG Social Bookmarks 2.0 is a complete rewrite from LG Social Bookmarks v1 and is not compatible. Version 1 was an ExpressionEngine module while version 2.0 is an ExpressionEngine extension.

To upgrade first backup your database and site then put your site offline. Disable the LG Social Bookmarks version 1.0 module and delete all files associated with the module.

After installing and activating the version 2.0 extension the only other change you will need to make is a small update to the LG Social Bookmarks tag. Put your site online and you are hot to trot.

Features

LG Social Bookmarks 2.0 is a Multi-Site Manager compatible ExpressionEngine extension that inserts popular social bookmarking links to any weblog post.

Allows content authors to add social bookmarking links (Digg, Del.icio.us) to any weblog entry
Set default social site submission links in your EE administration
Override listed sites on a per tag basis
Fully customisable html output
Easily add your own site to the default set

Never miss an update again! LG Social Bookmarks plays well with LG Addon Updater which is a recommended download.

Screenshots

Requirements

LG Social Bookmarks is an ExpressionEngine extension and has been tested on Expression Engine 1.6.1+.

This extensions administration also requires jQuery 1.2.6+.

Installation

The LG Social Bookmarks extension contains a extension folder, language file and some administration images.

To install the module follow the instructions below:

Download the latest version of the extension
Extract the .zip file to your desktop
Copy the extensions/ext.lg_social_bookmarks_ext.php file to your /system/extensions directory
Copy the extensions/lg_social_bookmarks_ext directory to your /system/extensions directory
Copy the language/english/lang.social_bookmarks_ext.php file to your /system/languages/english directory
Copy the themes/cp_global_images/lg_social_bookmarks directory to your /themes/cp_global_images directory
Open the Extension Manager
Enable Extensions if not already enabled
Enable the extension
Configure the extension settings

Configuration

The LG Social Bookmarks extension includes an simple administration to set the default list of sites that will be outputted.

The following extension settings are available:

Enable
Social Bookmarks
Scripts
Check for updates

Enable [required]

Yes|No

Enable LG Social Bookmarks for this site?

Which social bookmarking sites would you like to show by default?

To configure the default list of sites displayed follow the steps below:

Open the Social Bookmarks extension settings
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'

Scripts

http://ajax.googleapis.com/ajax/libs/jquery/1.2.6/jquery.min.js

LG Twitter requires jQuery Core v1.2.6+ to work correctly.

Check for updates?

LG Social Bookmarks can call home and check for recent extension updates. This feature requires LG Addon Updater.

Displaying social bookmarking links in your weblog entries

Displaying social bookmarking links in your weblog entries is as easy as adding a {lg_social_bookmarks} tag pair inside the {exp:weblog:entries} loop. A complete example of the {lg_social_bookmarks} tag can be seen below

{exp:weblog:entries weblog="news"}
  {lg_social_bookmarks title="{title}" permalink="{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/favicons/{social_site_img_url}" alt="{social_site_name} Favicon" />
            <span>Bookmark on {social_site_name}</span>
          </a>
        </li>
        {/social_sites}
    </ul>
  {/lg_social_bookmarks}
{/exp:weblog:entries}

Tag Reference

LG Social Bookmarks tag `{lg_social_bookmarks}`

The {lg_social_bookmarks} tag pair is the only tag pair used to show the sites you select in your administration Social Bookmarks page.

The {lg_social_bookmarks}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.

If you are upgrading from the LG Social Bookmarks v1 just remove the exp: prefix in the {lg_social_bookmarks} tag.

title= [optional]

title="{title}"

The title of of your weblog entry.

permalink= [required]

permalink="{path=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:

ASK
BarraPunto
blinkbits
BlinkList
BlogMemes
BlogMemes Fr
BlogMemes Sp
BlogMemes Cn
BlogMemes Jp
blogmarks
Blogosphere News
Blogsvine
blogtercimlap
Blue Dot
Book.mark.hu
Bumpzee
co.mments
connotea
del.icio.us
De.lirio.us
Diigo
Design Float
Digg
DotNetKicks
DZone
eKudos
Email
Facebook
Fark
feedmelinks
Furl
Fleck
Global Grind
Google
Gwar
Haohao
HealthRanker
Hemidemi
IndiaGram
IndianPad
Internetmedia
kick.ie
Kirtsy
laaik.it
LinkArena
LinkaGoGo
LinkedIn
Linkter
Live
Ma.gnolia
Meneame
MisterWong
MisterWong.DE
Mixx
muti
MyShare
N4G
Netscape
NewsVine
Netvouz
NuJIJ
PlugIM
PopCurrent
Pownce
ppnow
Print
Propeller
Ratimarks
RawSugar
Rec6
Reddit
SalesMarks
Scoopeo
scuttle
Segnalo
Shadows
Simpy
Shoutwire
Slashdot
Smarking
Socialogs
Spurl
SphereIt
Sphinn
Squidoo
StumbleUpon
Taggly
Technorati
TailRank
ThisNext
TwitThis
Upnews
Webnews.de
Webride
Wikio
Wikio FR
Wikio IT
Wykop
Xerpi
YahooMyWeb
Yigg

Variable Pairs

{exp:weblog:entries weblog="news"}
  {lg_social_bookmarks title="{title}" permalink="{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/favicons/{social_site_img_url}" alt="{social_site_name} Favicon" />
          <span>Bookmark on {social_site_name}</span>
        </a>
      </li>
      {/social_sites}
    </ul>
  {/lg_social_bookmarks}
{/exp:weblog:entries}

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