web/wp-content/plugins/add-to-any/README.txt
author hurons@caf4f556-3d62-0410-8435-a86758001935
Wed, 23 Dec 2009 17:55:33 +0000
branchwordpress
changeset 109 03b0d1493584
child 194 32102edaa81b
permissions -rw-r--r--
wordpress 2.8 () with the following extensions : - add-to-any - categories page - Event calendar (a custom version for IRI-Theme) - Executable PHP widget - FD feedburner - ggis subscribe - Google Xml site maple - post of current category - page redirection - related post by category AND IRI-Theme

=== Add to Any: Share/Bookmark/Email Button ===
Contributors: micropat
Donate link: http://www.addtoany.com/contact/
Tags: bookmarking, social, social bookmarking, social bookmarks, bookmark, bookmarks, sharing, share, sharethis, saving, save, Post, posts, page, pages, images, image, admin, statistics, stats, links, plugin, widget, e-mail, email, seo, button, delicious, google, digg, reddit, facebook, myspace, twitter, stumbleupon, technorati, wpmu, addtoany, add, any
Requires at least: 2.0
Tested up to: 2.9
Stable tag: 0.9.9.4.2

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, 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 history.

<a href="http://www.addtoany.com/" title="Sharing button widget" target="_blank">Share Button</a> (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 <a href="http://www.addtoany.com/blog/smart-menus-the-services-your-visitors-use-displayed-first/" target="_blank">Smart Menu</a>
* Individual service links (like Sociable)
* Includes all <a href="http://www.addtoany.com/services/" target="_blank">services</a>
* Menu updated automatically
* WordPress optimized, localized (English, Chinese, Spanish, Portuguese, Italian, Danish, Catalan, Russian, Albanian, Romanian, Belarusian)
* Google Analytics integration
* Many more publisher and user features!

See also:

* The <a href="/extend/plugins/add-to-any-subscribe/" title="WordPress RSS Subscribe widget plugin">Subscribe button</a> plugin
* The <a href="http://www.addtoany.com/buttons/for/wordpress_com" title="WordPress.com sharing button widget" target="_blank">Share button for WordPress.com</a> blogs
* The standard <a href="http://www.addtoany.com/buttons/">Share button</a> widget

<a href="http://www.addtoany.com/share_save" title="Share" target="_blank">Share this plugin</a>

== 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 ==

= How often is the list of services within the menu updated? =

Constantly... and it's done automatically without having to upgrade.

= Where can I choose which button and individual icons to display and other options? =

Go to `Settings` > `Share/Save Buttons`.

= Why isn't the drop-down menu appearing? =

It's likely because your theme wasn't <a href="http://codex.wordpress.org/Theme_Development#Plugin_API_Hooks" target="_blank">coded properly</a>.  Using the Theme Editor, make sure that the following piece of code is included in your theme's `footer.php` file just before the `</body>` line:

`<?php wp_footer(); ?>`

= How can I move 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:

`<?php echo '<ul class="addtoany_list">';
if( function_exists('ADDTOANY_SHARE_SAVE_ICONS') )
	ADDTOANY_SHARE_SAVE_ICONS( array("html_wrap_open" => "<li>", "html_wrap_close" => "</li>") );
if( function_exists('ADDTOANY_SHARE_SAVE_BUTTON') )
	ADDTOANY_SHARE_SAVE_BUTTON( array("html_wrap_open" => "<li>", "html_wrap_close" => "</li>") );
echo '</ul>'; ?>`

= How can I move just the button to another area of my theme? =

Directions are located within the plugin's settings panel located in `Settings` > `Share/Save Buttons` under `Button Placement`. In the Theme Editor, you will place this line of code where you want the button to appear in your theme:

`<?php if( function_exists('ADDTOANY_SHARE_SAVE_BUTTON') ) { ADDTOANY_SHARE_SAVE_BUTTON(); } ?>`

= How can I move 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):

`<?php echo '<ul class="addtoany_list">';
if( function_exists('ADDTOANY_SHARE_SAVE_ICONS') )
	ADDTOANY_SHARE_SAVE_ICONS( array("html_wrap_open" => "<li>", "html_wrap_close" => "</li>") );
echo '</ul>'; ?>`

Or you can place the icons as individual links (without being wrapped in an HTML list):

`<?php if( function_exists('ADDTOANY_SHARE_SAVE_ICONS') ) { ADDTOANY_SHARE_SAVE_ICONS(); } ?>`

= 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&amp;linkname=A2A_LINKNAME'
  );
  return $services;
}
add_filter('A2A_SHARE_SAVE_services', 'addtoany_add_services', 10, 1);`

= 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: `<!--sharesave-->`

= 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: `<!--nosharesave-->`

= 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. Add to Any Share/Save button, featuring the Open <a href="http://www.shareicon.com/">Share Icon</a>
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 Add to Any menus

== Changelog ==

= .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 <a href="http://www.romeolab.com/" target="_blank">Romeo Shuka</a>)
* Romanian translation (by <a href="http://www.stefandes.com/" target="_blank">Stefan</a>)

= .9.9.4 =
* Custom standalone service support
* Custom icon support
* Updated Twitter icon

= .9.9.3.5 =
* New standalone services
 * DailyMe
 * Google Reader
 * Mozilla.ca
 * 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 <a href="http://gidibao.net/">Gianni</a>)
* 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 `<div>`, not `<p>`
* Add to Any button now contained within `<ul><li>`

= .9.8.9.2 =
* Buttons include Facebook icon
* Catalan i18n

= .9.8.9.1 =
* Automatic localization/i18n
* Rename Spanish POT to proper
* Fixed "Display Share/Save button at the bottom of pages" option when "Display Share/Save button at the bottom of posts is disabled"

= .9.8.9 =
* wp_footer() detection
* Replaced short form of PHP's open tags with long form to work around configurations with shortopentag disabled
* Spanish translation (by <a href="http://pablo.poo.cl/" target="_blank">Pablo</a>)

= .9.8.8.4 =
* Settings panel submits to current page instead of unreliable REQUEST_URI which can omit querystring on IIS
 * See http://www.microsoft.com/downloads/results.aspx?freetext=954946

= .9.8.8.3 =
* Option "Display Share/Save button at the bottom of posts on the front page" applies to all pages that can contain multiple posts

= .9.8.8.2 =
* Fix button appearing in category list view despite setting

= .9.8.8.1 =
* Refine conditionals
* Highlight admin notices
* Danish translation (by <a href="http://wordpress.blogos.dk/" target="_blank">Georg</a>)

= .9.8.8 =
* Now customize the optional text next to the 16 x 16px icons

= .9.8.7.3 =
* Important syntax fix

= .9.8.7.2 =
* Additional options / JavaScript API clarification
* i18n update 

= .9.8.7.1 =
* Text-only button stripslashes

= .9.8.7 =
* Removes unnecessary inline styling in feeds per W3C recommendation

= .9.8.6.9 =
* Compressed Open Share Icon

= .9.8.6.8 =
* Chinese translation updated

= .9.8.6.7 =
* i18n
* Chinese translation
* Installation clarified

= .9.8.6.6 =
* Open Share Icon
* WordPress 2.7 admin styling
* Settings link on Plugins page
* Basename var

= .9.8.6.5 =
* Less JavaScript redundancy from Additional Options (saves bandwidth)
* Compressed PNGs added, select a button from settings to begin using PNG (saves bandwidth)

= .9.8.6.4 =
* Additional Options in Admin panel provides link to JavaScript API
* Option to have full addtoany.com legacy page open in a new window

= .9.8.6.3 =
* Replaced short form of PHP's open tags with long form to work around configurations with short_open_tag disabled

= .9.8.6.2 =
* Current page title + blog title are used if called outside The Loop

= .9.8.6.1 =
* Fixed buttons if WordPress files are in a subdirectory while the blog appears in the site root
 * For example: http://codex.wordpress.org/Giving_WordPress_Its_Own_Directory

= .9.8.6 =
* Fixed output buffering - button should appear below posts again if option is set

= .9.8.5 =
* Button targets the current page if called outside The Loop
* Accomodates renamed plugin directory

= .9.8.4 =
* Fixed a small syntax error (critcal if you're on .9.8.3)

= .9.8.3 =
* Language & localization update
 * "After clicking OK," removed from the Bookmark tab

= .9.8.2 =
* Event attributes removed (JS now takes care of button events)
 * This eliminates the chance of errors prior to JS fully loading

= .9.8.1 =
* Fixed repo problem

= .9.8 =
* JavaScript removed from blog feed
* Option to display button (without menu) or to not display it at all below posts in blog feed
* Replaced some UTF-8 encoding functions with core WordPress functions
* For XHTML validation, special characters are converted to HTML entities within JavaScript variables
* Reprioritized plugin to load later
* Text-only button option

= .9.7 =
* Internationalization
* Buttons updated

= .9.6 =
* Moved external JavaScript to bottom so that content is prioritized over HTTP requests to static.addtoany.com
 * Please note that some improperly-coded themes may prevent this from working. See the FAQ entry for "Why isn't the drop-down menu appearing?" if this is the case.

= .9.5.2 =
* Fixed bug in Internet Explorer 6 that caused custom buttons to have a height and width of 0
* Removed the XHTML depreciated `name` attribute from the button's anchor

= .9.5.1 =
* Fixed 1 line to support those without short_open_tag

= .9.5 =
* New: Custom buttons (specify a URL)
* Fix to permit XHTML Strict validation

= .9.4 =
* New Menu Styler lets you customize the color of the menus
* New Menu Option: "Only show the menu when the user clicks the Share/Save button"
* New: Set custom JavaScript variables for further customization
* Better support for CSS styling: .addtoany_share_save
* PHP support for short_open_tag
* PHP4 legacy and compatibility fixes