The Ultimate Social Bookmarking Plugin

March 22nd Joomla Extensions \ Plugins

This Joomla! plugin was built as a superior replacement for the old Social Bookmarking Buttons plugin for Joomla 1.0.x. The Ultimate Social Bookmarking plugin is the best extension available because it puts the buttons where you want them, allows an unlimited amount of customization, and is compatible with Joomla! 1.0.x and Joomla! 1.5 natively.

 

 

Features

• Quickly and easily build up your web traffic and PageRank by making it easy for your website visitors to add your pages to any social bookmarking website.
• All styling is done through CSS, no inline styling or tables.
• Manage your buttons through an editable XML file. Choose which buttons you want enabled, or add new buttons yourself.
• Native versions for Joomla 1.0.x and Joomla 1.5

Included Buttons Available

1. Digg.com small button
2. Digg.com JavaScript badge
3. Digg.com compact JavaScript badge
4. Reddit.com small button
5. Reddit.com Javascript badge style 1
6. Reddit.com Javascript badge style 2
7. Reddit.com Javascript badge style 3
8. Del.icio.us small button
9. Del.icio.us JavaScript tall badge
10. Del.icio.us JavaScript one line badge
11. Google Bookmarks small button
12. Live.com small button
13. Facebook.com small button
14. Slashdot.org small button
15. Netscape.com small button
16. Technorati.com small button
17. StumbleUpon.com small button
18. Spurl.net small button
19. Wists.com small button
20. Simpy.com small button
21. Newsvine.com small button
22. BlinkList.com small button
23. Furl.net small button
24. Fark.com small button
25. BlogMarks.net small button
26. Yahoo! My Web small button
27. Smarking.com small button
28. Netvouz.com small button
29. Mister-Wong.com small button
30. RawSugar.com small button
31. Ma.gnolia.com small button
32. Squidoo.com small button
33. FeedMeLinks.com small button
34. BlinkBits.com small button
35. TailRank.com small button
36. linkaGoGo.com small button
37. Cannotea.org small button
38. Diigo.com small button
39. Faves.com small button
40. Ask.com small button
41. DZone.com small button
42. DZone.com JavaScript tall badge
43. DZone.com JavaScript wide badge
44. Swik.net small button
45. Shoutwire.com small button
46. MyLinkVault.com small button
47. Maple.nu small button
48. BlogRolling.com small button
49. AddThis.com JavaScript drop down badge
50. AddThis.com button style 1
51. AddThis.com button style 2
52. AddThis.com button style 3
53. AddThis.com button style 4
54. AddThis.com button style 5
55. MySpace.com small button
56. GodSurfer.com small button
57. GodSurfer.com JavaScript Badge
58. GodSurfer.com JavaScript Compact Badge
59. Mixx.com small button
60. EntirelyOpenSource.com small button

 

Joomla! 1.5 Usage

Homepage Display

This option allows you to choose how your Social Bookmarking buttons will appear on the homepage and any content listing pages for blogs, sections, categories, etc. Basically what you want to be displayed on any page that lists content items with a "Read more..." link to the full article.

Top: Only display the top group of buttons.

Bottom: Only display the bottom group of buttons.

Both: Display all buttons.

None: Display nothing (only display buttons when the full content item is listed).

URL Mode

This option allows you to choose which type of URLs to be generated.

Standard: Generate full URLs based on your menu structure (the default way Joomla! applications generate URLs). This will create different URLs based on how a user navigated to the content item.

Current URL: If you don't use Search Engine Friendly (SEF) URLs then you must use this option. This will also not allow you to display any buttons on the homepage or content listing pages. If you use language packs or other components that change your site's URL structure and you don't have a Search Engine Friendly (SEF) component installed then you will probably need to use this option.

Categories to Exclude

This option allows you to specify categories that won't display the buttons. Separate category ids with a comma, ex: 2,5,12,17. Add 0 to exclude uncategorized content items.

Preceding HTML

If you want any kind of descriptive text or HTML above the bottom Social Bookmarking buttons, place it here.

Top Button Separator

Enter the text or HTML that you want to separate each item in the top button group here. Linebreaks are provided by default, but you can change this to anything you want.

Bottom Button Separator

Enter the text or HTML that you want to separate each item in the buttom button group here. A space is provided by default, but you can change this to anything you want.

Image Folder

All button images are stored in a folder called "default". If you want to create your own image set, create a new folder on your server under /JoomlaDirectory/mambots/content/usbp_images/ and place your image set into it.

Background Color

The CSS color property for the background of dynamic buttons like the large Digg badge. Set this to the background color of your website. Use a proper CSS color like #ffffff, #000000, White, Blue, Red, etc.

AddThis.com Username

If you want to enable one of the AddThis.com buttons you will need to register at their website first. Get your username, or PubId, and enter it here.

Check For Manual Settings

This is set to "No" by default becuase it will require a little more processing time. Set this to "Yes" if you want to manually change the submitted title or URL for any content items.

Here is how you can manually change the submitted URL or title of a content item:

Add this tag to the INTRO CONTENT of a content item:
{ socialbookmarker}sburl="http://www.yourwebsite.com/url.htm" sbtitle="The title you want submitted to the Social Bookmarking websites" sbdescription="Description of this content."{/socialbookmarker}

There are 4 properties you can specify:
sburl: The URL you want submitted for this content item.
sbtitle: The title you want submitted for this content item.
sbdescription: The description you want submitted for this content item.
sbenabled: This is used to disable the buttons from being displayed on this particular content item. This is useful if you want the buttons displayed on all content items except for a few Set this to "false" to disable the buttons.

Managing your buttons through the XML file

You can edit the Social Bookmarking buttons you want displayed on your website by editing the XML file on your server at /JoomlaDirectory/mambots/content/ultimate_social_bookmarking_plugin_buttons.xml.

Here is the XML format:

Website Button Name

The HTML with UltimateSocialBookmarkingPlugin keywords

true or false
top or bottom

website: Name of the Website and Button

html: The HTML that will create this button. This can be any combination of text, HTML and JavaScript. Make sure you use CDATA escaping so the buttons are properly displayed.

enabled: Set to "true" or "false". Determines whether the button is displayed or not.

position: Set to "top" or "bottom". Determines whether the button is placed in the top or bottom button groups.

UltimateSocialBookmarkingPlugin Keywords

You can add the following keywords to the html of each button. They will be dynamically replaced with the correct data for each content item:

***url*** - The URL of the current content item.

***url_encoded*** - The uri_encoded URL of the current content item. Encoded URLs are required by some sites like Digg.com

***title*** - The title of the current content item.

***title_encoded*** - The uri_encoded title of the current content item.

***description*** - The description of the current content item.

***description_encoded*** - The encoded description of the current content item.

***imageDirectory*** - The full URL of your image directory.

***bgcolor*** - The background color specified in the plugin parameters.

***addThisPubId*** - The AddThisPubId specified in the plugin parameters.

Changing the styling of the Social Bookmarking buttons

The Ultimate Social Bookmarking Plugin is styled completely through CSS. To change the styling, edit the CSS file on your server at /JoomlaDirectory/mambots/content/ultimate_social_bookmarking_plugin.css.

 

Joomla! 1.0.x Usage

Homepage Display

This option allows you to choose how your Social Bookmarking buttons will appear on the homepage and any content listing pages for blogs, sections, categories, etc. Basically what you want to be displayed on any page that lists content items with a "Read more..." link to the full article.

Top: Only display the top group of buttons.

Bottom: Only display the bottom group of buttons.

Both: Display all buttons.

None: Display nothing (only display buttons when the full content item is listed).

URL Mode

This option allows you to choose which type of URLs to be generated.

Permalink: Generate URLs that never change. This involves removing the Itemid from the URL so that your submitted URLs remain the same no matter how a user navigated to the content. Unless you have a Search Engine Friendly (SEF) component installed which condenses all URLs for a given content item into one URL, this is the only way to ensure that dynamic buttons (like the Digg badge) show the correct number.

Standard: Generate full URLs based on your menu structure (the default way Joomla! applications generate URLs). This will create different URLs based on how a user navigated to the content item.

Current URL: If you dont' use Search Engine Friendly (SEF) URLs then you must use this option. This will also not allow you to display any buttons on the homepage or content listing pages. If you use language packs or other components that change your site's URL structure and you don't have a Search Engine Friendly (SEF) component installed then you will probably need to use this option.

Categories to Exclude

This option allows you to specify categories that won't display the buttons. Separate category ids with a comma, ex: 2,5,12,17. Add 0 to exclude static content items.

Preceding HTML

If you want any kind of descriptive text or HTML above the bottom Social Bookmarking buttons, place it here.

Top Button Separator

Enter the text or HTML that you want to separate each item in the top button group here. Linebreaks are provided by default, but you can change this to anything you want.

Bottom Button Separator

Enter the text or HTML that you want to separate each item in the buttom button group here. A space is provided by default, but you can change this to anything you want.

Image Folder

All button images are stored in a folder called "default". If you want to create your own image set, create a new folder on your server under /JoomlaDirectory/mambots/content/usbp_images/ and place your image set into it.

Background Color

The CSS color property for the background of dynamic buttons like the large Digg badge. Set this to the background color of your website. Use a proper CSS color like #ffffff, #000000, White, Blue, Red, etc.

AddThis.com Username

If you want to enable one of the AddThis.com buttons you will need to register at their website first. Get your username, or PubId, and enter it here.

Check For Manual Settings

This is set to "No" by default becuase it will require a little more processing time. Set this to "Yes" if you want to manually change the submitted title or URL for any content items.

Here is how you can manually change the submitted URL or title of a content item:

Add this tag to the INTRO CONTENT of a content item:
{ socialbookmarker}sburl="http://www.yourwebsite.com/url.htm" sbtitle="The title you want submitted to the Social Bookmarking websites" sbdescription="Description of this content."{/socialbookmarker}

There are 4 properties you can specify:
sburl: The URL you want submitted for this content item.
sbtitle: The title you want submitted for this content item.
sbdescription: The description you want submitted for this content item.
sbenabled: This is used to disable the buttons from being displayed on this particular content item. This is useful if you want the buttons displayed on all content items except for a few Set this to "false" to disable the buttons.

Managing your buttons through the XML file

You can edit the Social Bookmarking buttons you want displayed on your website by editing the XML file on your server at /JoomlaDirectory/mambots/content/ultimate_social_bookmarking_plugin_buttons.xml.

Here is the XML format:

Website Button Name

The HTML with UltimateSocialBookmarkingPlugin keywords

true or false
top or bottom

website: Name of the Website and Button

html: The HTML that will create this button. This can be any combination of text, HTML and JavaScript. Make sure you use CDATA escaping so the buttons are properly displayed.

enabled: Set to "true" or "false". Determines whether the button is displayed or not.

position: Set to "top" or "bottom". Determines whether the button is placed in the top or bottom button groups.

UltimateSocialBookmarkingPlugin Keywords

You can add the following keywords to the html of each button. They will be dynamically replaced with the correct data for each content item:

***url*** - The URL of the current content item.

***url_encoded*** - The uri_encoded URL of the current content item. Encoded URLs are required by some sites like Digg.com

***title*** - The title of the current content item.

***title_encoded*** - The uri_encoded title of the current content item.

***description*** - The description of the current content item.

***description_encoded*** - The encoded description of the current content item.

***imageDirectory*** - The full URL of your image directory.

***bgcolor*** - The background color specified in the plugin parameters.

***addThisPubId*** - The AddThisPubId specified in the plugin parameters.

Changing the styling of the Social Bookmarking buttons

The Ultimate Social Bookmarking Plugin is styled completely through CSS. To change the styling, edit the CSS file on your server at /JoomlaDirectory/mambots/content/ultimate_social_bookmarking_plugin.css.

Requirements

• PHP 5 with SimpleXML Installed
• Jooma! 1.0.x or 1.5

SEF URLs are recommended but not required.

Download

Login and download from the Download page .

Support

Please post all questions, comments, feature requests and bug reports to the JoomlaDigger.com forums:

Ultimate Social Bookmarking Plugin Support Forums

ChangeLog

1.0.0 - Initial Release

1.0.1 - 4/17/2008

• JavaScript Error fixed ("missing ;")
• MySpace.com button added
• GodSurfer.com button and badges added

1.0.2 - 4/30/2008

• Root directory fixed for sites not in root directory of server
• Root directory fixed for sites with a Windows server environment (WAMP)

1.0.3 - 11/19/2008

• JoomlaVote.com buttons removed
• Mixx.com button added
• EntirelyOpenSource.com button added
• Top and bottom homepage display issue resolved for Joomla 1.5

{/tabs}