=== AddToAny: Share/Bookmark/Email Button === Contributors: micropat Tags: sharing, share, sharethis, bookmarking, social, social bookmarking, social bookmarks, bookmark, bookmarks, save, Post, posts, page, pages, images, image, admin, statistics, stats, links, plugin, widget, e-mail, email, seo, button, delicious, google buzz, buzz, google, digg, reddit, facebook, myspace, twitter, stumbleupon, technorati, icon, icons, wpmu, addtoany, add, any Requires at least: 2.0 Tested up to: 3.0 Stable tag: 0.9.9.5.7 Help people share, bookmark, and email your posts & pages using any service, such as Facebook, Twitter, Google Buzz, Digg and many more. == Description == The most complete plugin to help people **share**, **bookmark**, and **email** your posts and pages using **any service**, such as Facebook, Twitter, Google Buzz, Digg, Delicious, and well over 100 more social bookmarking and sharing sites. The button comes with AddToAny's customizable **Smart Menu**, which **places the services visitors use at the top of the menu**, based on each visitor's browsing and usage history. Share Button (demo) The E-mail tab makes it easy to share via Google Gmail, Yahoo! Mail, Hotmail, AOL, and any other web-based e-mailer or desktop program. The **Add to Favorites** button (or Bookmark tab) helps users bookmark using any browser (Internet Explorer, Firefox, Chrome, Safari, Opera, etc.). Individual **service icons** let you optimize your blog posts for specific social sites. Choose from over 100 individual services. * AddToAny Smart Menu * Individual service links (like Sociable) * Includes all services * Menu updated automatically * Google Analytics integration (access guide) * WordPress optimized, localized (English, Chinese, Spanish, Japanese, French, Portuguese, Italian, Danish, Catalan, Russian, Albanian, Romanian, Belarusian) * Many more publisher and user features! After **years of ongoing development**, close to **1 million downloads**, and **ongoing support** from the community, AddToAny still strives to be the best WordPress plugin for sharing. We hope it's perfect for everyone by version 1.0. Share this plugin See also: * The Subscribe button plugin * The Share button for WordPress.com blogs * The standard Share button widget AddToAny Blog | Privacy Policy == Installation == 1. Upload the `add-to-any` directory (including all files within) to the `/wp-content/plugins/` directory 1. Activate the plugin through the `Plugins` menu in WordPress == Frequently Asked Questions == = Where are the options? = In your Admin panel, go to `Settings` > `Share/Save Buttons`. Among other options, you can choose which button and individual icons to display, and where and how to display them. = Why isn't the drop-down menu appearing? = It's likely because your theme wasn't coded properly. Using the Theme Editor, make sure that the following piece of code is included in your theme's `footer.php` file just before the `` line: `` = How can I add both the button and the individual icons to another area of my theme? = In the Theme Editor, place this code block where you want the button and individual icons to appear in your theme: `` If you want to customize the shared URL and title for the button and standalone services, use the following code as a template: ` "Example Page", "linkurl" => "http://example.com/page.html") ); } ?>` = How can I add just the button to another area of my theme? = In the Theme Editor, you will place this line of code where you want the button to appear in your theme: `` If you want to customize the shared URL and title for this button, use the following code as a template: ` "Example Page", "linkurl" => "http://example.com/page.html") ); } ?>` = How can I add just the individual icons to another area of my theme? = In the Theme Editor, place this line of code where you want the individual icons to appear in your theme (within an HTML list): `'; if( function_exists('ADDTOANY_SHARE_SAVE_ICONS') ) ADDTOANY_SHARE_SAVE_ICONS( array("html_wrap_open" => "
  • ", "html_wrap_close" => "
    • ") ); echo ''; ?>` If you want to customize the shared URL and title for these icons, use the following code as a template: `'; ADDTOANY_SHARE_SAVE_ICONS( array( "html_wrap_open" => "
  • ", "html_wrap_close" => "
    • ", "linkname" => "Example Page", "linkurl" => "http://example.com/page.html" )); echo ''; } ?>` Or you can place the icons as individual links (without being wrapped in an HTML list): `` If you want to customize the shared URL and title for these icons, use the following code as a template: ` "Example Page", "linkurl" => "http://example.com/page.html") ); } ?>` = How can I add a new custom standalone service? = You can create a plugin or customize the following PHP sample code to add to your theme's function.php file: `function addtoany_add_services( $services ) { $services['google_example'] = array( 'name' => 'Google Example', 'icon_url' => 'http://www.google.com/favicon.ico', 'icon_width' => 16, 'icon_height' => 16, 'href' => 'http://www.example.com/add?linkurl=A2A_LINKURL&linkname=A2A_LINKNAME' ); return $services; } add_filter('A2A_SHARE_SAVE_services', 'addtoany_add_services', 10, 1);` = How can I align the button and/or icons to the center or to the right side of posts? = It depends on your theme, but you can try adding the following CSS code to your main stylesheet. To align right: `.addtoany_share_save_container { text-align:right; }` To align center: `.addtoany_share_save_container { text-align:center; }` = How can I remove a button from individual posts and pages? = Insert the following tag into the page or post (HTML tab) that you do not want the button to appear in: `` = How can I force the button to appear in individual posts and pages? = If your button isn't already set up to appear (it is by default), insert the following tag into the page or post (HTML tab) that you want the button to appear in: `` = Why doesn't Facebook use the page title and how can I set the image Facebook uses? = Facebook does link sharing a little differently than most other services. Facebook will sometimes use the Meta Description of a shared page instead of the page's title or the title you have set for AddToAny. To change the title, description and/or image on Facebook, you will need to modify your theme header file according to Facebook's specification. With WordPress, this can be accomplished with plugins like the All in One SEO Pack plugin. Please see that plugin to for details, and post in the WordPress or plugin author's forums for more support. = Does the plugin output W3C valid code? = Yes, AddToAny outputs 100% W3C valid XHTML and W3C valid CSS 3.0. If you move the plugin's CSS code to your theme's stylesheet, note that one proprietary vendor prefix (`filter`) is used. It's utilized for cross-browser compatibility with Internet Explorer. For more information about the W3C CSS Validator and the `filter` property, see Why don't my scrollbar properties, filters, etc. validate? If you feel compelled, you can move the line into an Internet Explorer-only stylesheet, or remove the line at the cost of the opacity hover effect in Internet Explorer. = How can I move the plugin's inline CSS into my theme's main external stylesheet? = Go to `Settings` > `Share/Save Buttons` > uncheck `Use inline CSS` and place the CSS code in your theme's main stylesheet. = Why do embedded objects (like Flash) disappear when the menu is displayed? = This is done to overcome browser limitations that prevent the drop-down menu from displaying on top of intersecting embedded objects. If you would like to disable this, uncheck the `Hide embedded objects (Flash, video, etc.) that intersect with the menu when displayed` option on the plugin's settings page. == Screenshots == 1. AddToAny Share/Save button, featuring the Open Share Icon 2. Drop-down menu that appears instantly when visitors use the share button 3. E-mail tab, with direct links to the most popular web-based e-mailers' auto-filled Compose page, a web-based sender for use with any e-mail address, and a link for desktop email clients 4. Settings panel 5. Color chooser for your AddToAny menus == Changelog == = .9.9.5.7 = * Work around "Featured Posts" excerpt scenarios that would stop button auto-placement below post content * Work around WP core issue to use HTTPS/SSL for static content files, like standalone icons and files in admin * http://core.trac.wordpress.org/ticket/13941 * Admin style consistency = .9.9.5.6 = * Fix PHP warnings when there are no arguments from functions ADDTOANY_SHARE_SAVE_BUTTON or ADDTOANY_SHARE_SAVE_ICONS * Italian translation update (by Gianni) = .9.9.5.5 = * Fix notices when in debug mode * Replaced extend functions with associative arrays * Some caching = .9.9.5.4 = * Inline CSS moved to external stylesheet * CSS minification = .9.9.5.3 = * SSL - HTTPS support * Button will display automatically below posts (by default) only after the_title has been called * Avoids premature calling from miscellaneous the_content filters from themes and other plugins * Thesis theme workaround * French translation (by Julien) * Belarusian translation update (by Marcis G) = .9.9.5.2 = * W3C XHTML validation fix (invalid from .9.9.5) * Removed Mozilla-proprietary opacity, which supported opacity before Firefox 1.0 * Moved Microsoft's filter CSS property to conditional inline stylesheet for validation * Template code blocks require significantly less code * Note: If you're using a template code to add the icons or 'icons + button' to another area of your theme, updating the template code is recommended (see FAQ) * Updated FAQ * Template code updated * Updated template code in admin * Switched API URL to customize URL in admin * Fixed unbracketed noscript tag in admin * Brazilian Portuguese translation (by Rodolfo Rodrigues) = .9.9.5.1 = * Fixed issue with excerpts (JavaScript text output within excerpts since .9.9.5) * Button(s) will now display below excerpts (per the fix above) * Replaced depreciating add/remove action functions with synonymous filter functions = .9.9.5 = * Important note: If you are using the AddToAny Subscribe plugin, be sure to update that plugin to version 9.8+ * Faster menu initialization * Switched to AddToAny's new API spec * Fixed localization * Also no longer outputs language strings if WordPress locale is set to "en" (or the default "en_US") * Updated AddToAny icon = .9.9.4.9 = * New params to customize the shared link and title for buttons/icons placed in theme file(s) * See plugin FAQ for template code * Ensure line break within feeds by enclosing AddToAny in a paragraph tag * Offer CSS code in the settings panel to copy & paste into a stylesheet * Increase opacity on standalone icons by 10% * New standalone services * Google Buzz (using Google Reader endpoint - automatic update to come) * Blip * Grono * Wykop = .9.9.4.8 = * Inline CSS toggle * If turned off, copy the CSS to your theme's stylesheet * Provided a link on plugin page to AddToAny's privacy policy * Pro tip: Sharing to Google Reader right now is equivalent to sharing to Google Buzz * You can enable Google Reader as a standalone service * Google Reader is included in AddToAny's smart menu * New standalone services * Balatarin * Vodpod * IWIW * Svejo * Oknotizie * Favoriten * Hatena * NUjij * Read It Later * diHITT * Removed standalone service * Global Grind * Japanese translation (by kz) = .9.9.4.7 = * Just a slight rename * Spaces in "Add to Any" removed, now camel-case: "AddToAny" * Clarified FAQ entries * Updated translations * Fixed some fuzzy translations = .9.9.4.6 = * Updated standalone service URIs and code names * Renamed service codes; must re-add if you have selected * Ask.com * Gmail * Identi.ca * Mozillaca * New standalone services * Box.net * Orkut * Posterous * Removed standalone service * Furl * Yahoo! MyWeb = .9.9.4.5 = * Fixing standalone services admin panel because version .9.9.4.4 broke this feature * Standalone services are available for WordPress version 2.6+ = .9.9.4.4 = * Backwards compatibile to version 2.0 * Fixes PHP is_tag error * Fixes PHP wp_enqueue_script error in settings panel = .9.9.4.3 = * Automatic support for over 50 languages * The drop-down menu automatically detects the visitor's set language and localizes accordingly * Less JavaScript output; removed redundant code * No longer outputs language strings if WordPress locale is set to the default "en_US" * Forward support for WordPress 2.9 = .9.9.4.2 = * Updated button text * Further localized strings = .9.9.4.1 = * Twitter icon included in standard sharing button * Albanian translation (by Romeo Shuka) * Romanian translation (by Stefan) = .9.9.4 = * Custom standalone service support * Custom icon support * Updated Twitter icon = .9.9.3.5 = * New standalone services * DailyMe * Google Reader * Mozillaca * NewsTrust * Plurk * PrintFriendly * WordPress * Fixed bug affecting certain standalone services * Identi.ca * Bookmarks.fr * Ask.com MyStuff * Catalan translation update (Robert Buj) * Clarified when template code is appropriate = .9.9.3.4 = * Use button IMG instead of background-image for button without text * Defaults to 171 x 16px button = .9.9.3.3 = * Left-padding for icon+text link changed from 39px to 30px * Text-index for parent UL reset * Output buffering replaced * Fixed admin action link * Russian translation (by Elvis) = .9.9.3.2 = * Clarified button placement and theme editing * Arabic translation = .9.9.3.1 = * Fix for possible global/object variable confusion with themes = .9.9.3 = * Add service icons * Changelog markup update = .9.9.2.9 = * Removed extra character from button querystring * New standalone services * Amazon Wish List * Blogger * Evernote * Folkd * Identi.ca * Instapaper * Meneame * Netvouz * TypePad = .9.9.2.8 = * Translations = .9.9.2.7 = * Updated standalone services and icons = .9.9.2.6 = * CSS changed to support more themes * Admin UI updated for 2.8 * Slightly cleaner UI * Includes template code for both button and standalone links (previously only found in FAQ) = .9.9.2.5 = * Removed dragability of dummy image in standalone services list = .9.9.2.4 = * Alt attribute added to standalone service image * Title attribute added to standalone service link * Selected standalone services in admin are more distinguishable * Italian translation (by Gianni) * i18n folder renamed to languages due to a problem with the CodeStyling Localization plugin * Contrast improvements to Open Share Icon = .9.9.2.3 = * Support for themes that do not support modern Loop methods * Permalinks now targeted for these older themes * AddToAny URI scheme gives precedence to link URL parameter, then Title * Sitename & Siteurl parameters depreciated for WP (they are usually redundant) = .9.9.2.2 = * Fixed display when all standalone services are removed in admin * Services label renamed Standalone Services for clarity * Updates to Danish translation * Added Belarusian translation (by Marcis G) = .9.9.2.1 = * Feed icons shown inline, no longer displayed in unordered list = .9.9.2 = * Services array output fixes = .9.9.1 = * Add services.php (critical fix) = .9.9 = * NEW: Individual service links! * Drag & Drop interface with preview * .addtoany_share_save_container is now `
    `, not `

    ` * AddToAny button now contained within `