=== 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, wpmu, addtoany, add, any Requires at least: 2.0 Tested up to: 3.0 Stable tag: 0.9.9.5.1 Help readers share, bookmark, and email your posts and pages using any service, such as Facebook, Twitter, Digg, Delicious and over 100 more. == Description == Help readers **share**, **save**, **bookmark**, and **email** your posts and pages using **any service**, such as Facebook, Twitter, Google Buzz, Digg, Delicious, and 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 Mail, 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 * WordPress optimized, localized (English, Chinese, Spanish, Japanese, Portuguese, Italian, Danish, Catalan, Russian, Albanian, Romanian, Belarusian) * Google Analytics integration (access guide) * Many more publisher and user features! 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( function_exists('ADDTOANY_SHARE_SAVE_ICONS') ) ADDTOANY_SHARE_SAVE_ICONS( array("html_wrap_open" => "
  • ", "html_wrap_close" => "
    • ") ); if( function_exists('ADDTOANY_SHARE_SAVE_BUTTON') ) ADDTOANY_SHARE_SAVE_BUTTON( array("html_wrap_open" => "
  • ", "html_wrap_close" => "
    • ") ); echo ''; ?>` If you want to customize the shared URL and title for the button and standalone services, use the following code as a template: `'; $addtoany_linkname = "Example Page"; $addtoany_linkurl = "http://example.com/page.html"; if( function_exists('ADDTOANY_SHARE_SAVE_ICONS') ) ADDTOANY_SHARE_SAVE_ICONS( array( "html_wrap_open" => "
  • ", "html_wrap_close" => "
    • ", "linkname" => $addtoany_linkname, "linkurl" => $addtoany_linkurl )); if( function_exists('ADDTOANY_SHARE_SAVE_BUTTON') ) ADDTOANY_SHARE_SAVE_BUTTON( array( "html_wrap_open" => "
  • ", "html_wrap_close" => "
    • ", "linkname" => $addtoany_linkname, "linkurl" => $addtoany_linkurl )); echo ''; ?>` = 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? = Type the following tag into the page or post 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), type the following tag into the page or post 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. = 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.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 = .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 `