This new 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.
Included Buttons Available
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 ModeThis 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 ExcludeThis 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 HTMLIf you want any kind of descriptive text or HTML above the bottom Social Bookmarking buttons, place it here.
Top Button SeparatorEnter 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 SeparatorEnter 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 FolderAll 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 ColorThe 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 UsernameIf 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 SettingsThis 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.
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:
<buttons> <button> <website>Website Button Name</website> <html> The HTML with UltimateSocialBookmarkingPlugin keywords </html> <enabled>true or false</enabled> <position>top or bottom</position> </button> </buttons>
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 buttonsThe 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.
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 ModeThis 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 ExcludeThis 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 HTMLIf you want any kind of descriptive text or HTML above the bottom Social Bookmarking buttons, place it here.
Top Button SeparatorEnter 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 SeparatorEnter 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 FolderAll 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 ColorThe 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 UsernameIf 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 SettingsThis 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.
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:
<buttons> <button> <website>Website Button Name</website> <html> The HTML with UltimateSocialBookmarkingPlugin keywords </html> <enabled>true or false</enabled> <position>top or bottom</position> </button> </buttons>
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 buttonsThe 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.
SEF URLs are recommended but not required.
Login and download from the Download page .
Please post all questions, comments, feature requests and bug reports to the JoomlaDigger.com forums:
Ultimate Social Bookmarking Plugin Support Forums
1.0.0 - Initial Release
1.0.1 - 4/17/2008
1.0.2 - 4/30/2008
1.0.3 - 11/19/2008
{/tabs}
I'm putting together a comprehensive training program to teach you everything you need to know about building websites with Joomla. Using the knowledge, tips and tricks I've learned over the last several years, I will teach you how to quickly create beautiful Joomla websites, avoid time-consuming web development pitfalls, make money with your site, and much more. Please take 3 minutes to tell me exactly what you want to learn about.
Copyright © 2007-2009 JoomlaDigger.com. All rights reserved. Website by P.J. Swesey. Owned and operated by Emergination, LLC.
