Free Joomla PHP extensions, info, tutorials, etc.
| The Ultimate Social Bookmarking Plugin |
|
|
|
|
Please give this plugin a vote at the Joomla! Extensions Directory if you appreciate the time I've put into it. Thanks!
Features
Included Buttons Available
Joomla! 1.5 UsageHomepage 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:
There are 4 properties you can specify:
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: <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.
Joomla! 1.0.x UsageHomepage 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:
There are 4 properties you can specify:
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: <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. Requirements
SEF URLs are recommended but not required. DownloadLogin and download from the Download page . SupportPlease post all questions, comments, feature requests and bug reports to the JoomlaDigger.com forums: Ultimate Social Bookmarking Plugin Support Forums ChangeLog1.0.0 - Initial Release 1.0.1 - 4/17/2008
1.0.2 - 4/30/2008
1.0.3 - 11/19/2008
{/tabs} |