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 folders under plugins/content/usbp_images/. Included are the folders glossy, glossy-top and 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. A photoshop template for the glossy buttons can be found in the plugin zip file.
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.
]]>