Content Plugin ValAddThis for Joomla - Configuration #6
Friday, 27 April 2012 12:00
2.7. Plugin Tags
The content plugin ValAddThis can also be displayed in any Joomla article, by using plugin tags. In order to do that you have to use the opening tag { valaddthis }, followed by any desired parameters with their values and at the end comes the closing tag { /valaddthis } (Note: don't use any spaces between the {} !). Parameters and their values are separated by using the pipe character |. Example: { valaddthis }type=button|button_type=default{ /valaddthis }.
Important note: when you trigger the plugin display by using tags, you automatically override any of the plugin parameters, which are already defined in the configuration backend! (even if for example an article is in the "Excluded articles" list)
Parameter Name | Possible Values | Description |
---|---|---|
type | button | Renders an AddThis Button |
toolbox | Renders an AddThis Toolbox | |
button_type | default | Renders a default AddThis Button |
rss | Renders an RSS Feed Button | |
Renders an Email Button | ||
button_img | addthis-long | ![]() |
addthis | ![]() |
|
bm-long | ![]() |
|
bm | ![]() |
|
share-long | ![]() |
|
share | ![]() |
|
plus | ![]() |
|
rss-feed-big | ![]() |
|
rss-feed-long | ![]() |
|
rss-feed | ![]() |
|
subscribe-big | ![]() |
|
subscribe-long | ![]() |
|
subscribe | ![]() |
|
![]() |
||
counter | ![]() |
|
lang | A Two-Character Language Code | A Two Letter Code of the language you want to explicitly use for the AddThis User Interface (UI) |
share_caption | Any Text | Text for "Bookmark & Share" |
email_caption | Any Text | Text for "Email a Friend" |
Any Text | Text for "Email" | |
favorites | Any Text | Text for "Favorites" |
more | Any Text | Text for "More" |
compact | List of Services | A comma-separated List of Services for the Compact Menu |
expanded | List of Services | A comma-separated List of Services for the Expanded menu |
exclude | List of Services | A comma-separated List of Services to be excluded from all Menus |
tool_services | List of Services | A comma-separated List of Services for the AddThis Toolbox |
tool_style | default | Toolbox Service Icons will be displayed horizontally |
default32 | Toolbox Service Icons will be displayed horizontally with 32px width | |
vertical | Toolbox Service Icons will be displayed vertically | |
vertical32 | Toolbox Service Icons will be displayed vertically with 32px width | |
css-hor | Toolbox Service Icons will be displayed horizontally with a Hover Effect | |
css-vert1 | Toolbox Service Icons will be displayed vertically with a Hover Effect #1 | |
css-vert2 | Toolbox Service Icons will be displayed vertically with a Hover Effect #2 | |
css-user | Toolbox Service Icons will be styled according to user-defined CSS file | |
tool_width | Any CSS width value | Width of the AddThis Toolbox using a CSS value. Example: 100px, 95%, auto etc. |
tool_share | Any Text | Text that will be used either as a title for the Toolbox and it will be displayed next to it or as the alt text of the optional share image (see: tool_shareurl) |
tool_show_names | yes | Display Service Names next to the Toolbox Service Icons |
no | Do not display any Service Names next to the Toolbox Service Icons | |
tool_show_more | yes | Display "More" Icon in Toolbox |
no | Do not display a "More" Icon in Toolbox | |
tool_more | Any Text | Toolbox Text for "More" |
tool_separator | Any Text | Toolbox Text for Separator (use "pipe" for |) |
swfurl | URL | URL of a Flash Object to share, along with the Link |
swf_width | Width value | Ideal Width of any provided Flash Object |
swf_height | Height value | Ideal Height of any provided Flash Object |
screenshot | URL | URL of an Image that shows a Preview of the Content being shared |
tooltip | Any Text | Text that will be used in place of "Send to" for the tooltips of the service icons |
html_before | HTML code | HTML code, which is going to be displayed before the AddThis Button/Toolbox. Use ">>" inside your HTML instead of the equal sign "="; Example: <p class>>test> |
html_after | HTML code | HTML code, which is going to be displayed after the AddThis Button/Toolbox. Use ">>" inside your HTML instead of the equal sign "="; Example: <p class>>test> |
tool_quick | Value between 1-12 | Choose one of the 12 predefined toolboxes |
tool_shareurl | URL | URL of a share image that will be displayed next to the Toolbox (see also: tool_share; is used to define the alt text of the image) |
2.8. Save Configuration
In order to activate the plugin ValAddThis, on the top left click on the radio button "Yes" next to "Enabled":
When you are ready click on "Save" (or "Save & Close" in J1.7) to save the plugin's configuration.
Comments
ValAddThis has no control of what Facebook shares. The FB script reads your meta tags automatically. In order to control what is being shared you have to use OpenGraph tags: developers.facebook.com/.../...
It grabs the description metatext from the homepage, instead of the description from the article page.
I also have no control of what image it grabs and shares.
Can this feature be added?
As it regards the options for the various Buttons/Quick Toolbox I haven't found a way to style it; J1.6+ uses a totally different way to display images that were embedded in the XML file. In J1.5 all look just fine. As I already mention in the documentation, use the screenshots found here as a guide.
The code that is appended at the end of the URL being shared is an issue of AddThis and not ValAddThis. This is the case for the services that are displayed by AddThis; most of the times it helps if you enter you personal AddThis ID in the corresponding configuration field.
On the plugin screen you need to separate the different Button and Toolbox Parameters options in new lines. Its quite confusing to know what radio button chooses what.
Maybe simpler would be to choose services one by one in the Toolbox.
Data Track Linkback its off but a code its added to the URL shared to facebook (as in /index.php/a-rede-de-bibliotecas#.T516nMf-jso.facebook )
This plugin is not only great but is highly customizable.
The only problem i face is with twitter counter. It doesn't count +1 after tweeting.
I am using Joomla 1.7.3
Any ideas?
Thanks in advance,
I'm having some minor trouble with J2.5! though...
When I use the new built-in introtext/fulltext image options, the social bookmarking icons appear *below* the embedded image.
Maybe it's not even the plugin's fault, I don't know, just thought I'd mention it and hope for a fix.
Those included image options are very useful
Easy install, configurable, good working, nice looking, speaks many languages.
I only suggest 1 thing, lets include all icon in 32px size too.
Th
RSS feed for comments to this post