|
1 === Add to Any: Share/Bookmark/Email Button === |
|
2 Contributors: micropat |
|
3 Donate link: http://www.addtoany.com/contact/ |
|
4 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 |
|
5 Requires at least: 2.0 |
|
6 Tested up to: 2.9 |
|
7 Stable tag: 0.9.9.4.2 |
|
8 |
|
9 Help readers share, bookmark, and email your posts and pages using any service, such as Facebook, Twitter, Digg, Delicious and over 100 more. |
|
10 |
|
11 == Description == |
|
12 |
|
13 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. |
|
14 |
|
15 <a href="http://www.addtoany.com/" title="Sharing button widget" target="_blank">Share Button</a> (demo) |
|
16 |
|
17 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.). |
|
18 |
|
19 Individual **service icons** let you optimize your blog posts for specific social sites. Choose from over 100 individual services. |
|
20 |
|
21 * AddToAny <a href="http://www.addtoany.com/blog/smart-menus-the-services-your-visitors-use-displayed-first/" target="_blank">Smart Menu</a> |
|
22 * Individual service links (like Sociable) |
|
23 * Includes all <a href="http://www.addtoany.com/services/" target="_blank">services</a> |
|
24 * Menu updated automatically |
|
25 * WordPress optimized, localized (English, Chinese, Spanish, Portuguese, Italian, Danish, Catalan, Russian, Albanian, Romanian, Belarusian) |
|
26 * Google Analytics integration |
|
27 * Many more publisher and user features! |
|
28 |
|
29 See also: |
|
30 |
|
31 * The <a href="/extend/plugins/add-to-any-subscribe/" title="WordPress RSS Subscribe widget plugin">Subscribe button</a> plugin |
|
32 * 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 |
|
33 * The standard <a href="http://www.addtoany.com/buttons/">Share button</a> widget |
|
34 |
|
35 <a href="http://www.addtoany.com/share_save" title="Share" target="_blank">Share this plugin</a> |
|
36 |
|
37 == Installation == |
|
38 |
|
39 1. Upload the `add-to-any` directory (including all files within) to the `/wp-content/plugins/` directory |
|
40 1. Activate the plugin through the `Plugins` menu in WordPress |
|
41 |
|
42 == Frequently Asked Questions == |
|
43 |
|
44 = How often is the list of services within the menu updated? = |
|
45 |
|
46 Constantly... and it's done automatically without having to upgrade. |
|
47 |
|
48 = Where can I choose which button and individual icons to display and other options? = |
|
49 |
|
50 Go to `Settings` > `Share/Save Buttons`. |
|
51 |
|
52 = Why isn't the drop-down menu appearing? = |
|
53 |
|
54 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: |
|
55 |
|
56 `<?php wp_footer(); ?>` |
|
57 |
|
58 = How can I move both the button and the individual icons to another area of my theme? = |
|
59 |
|
60 In the Theme Editor, place this code block where you want the button and individual icons to appear in your theme: |
|
61 |
|
62 `<?php echo '<ul class="addtoany_list">'; |
|
63 if( function_exists('ADDTOANY_SHARE_SAVE_ICONS') ) |
|
64 ADDTOANY_SHARE_SAVE_ICONS( array("html_wrap_open" => "<li>", "html_wrap_close" => "</li>") ); |
|
65 if( function_exists('ADDTOANY_SHARE_SAVE_BUTTON') ) |
|
66 ADDTOANY_SHARE_SAVE_BUTTON( array("html_wrap_open" => "<li>", "html_wrap_close" => "</li>") ); |
|
67 echo '</ul>'; ?>` |
|
68 |
|
69 = How can I move just the button to another area of my theme? = |
|
70 |
|
71 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: |
|
72 |
|
73 `<?php if( function_exists('ADDTOANY_SHARE_SAVE_BUTTON') ) { ADDTOANY_SHARE_SAVE_BUTTON(); } ?>` |
|
74 |
|
75 = How can I move just the individual icons to another area of my theme? = |
|
76 |
|
77 In the Theme Editor, place this line of code where you want the individual icons to appear in your theme (within an HTML list): |
|
78 |
|
79 `<?php echo '<ul class="addtoany_list">'; |
|
80 if( function_exists('ADDTOANY_SHARE_SAVE_ICONS') ) |
|
81 ADDTOANY_SHARE_SAVE_ICONS( array("html_wrap_open" => "<li>", "html_wrap_close" => "</li>") ); |
|
82 echo '</ul>'; ?>` |
|
83 |
|
84 Or you can place the icons as individual links (without being wrapped in an HTML list): |
|
85 |
|
86 `<?php if( function_exists('ADDTOANY_SHARE_SAVE_ICONS') ) { ADDTOANY_SHARE_SAVE_ICONS(); } ?>` |
|
87 |
|
88 = How can I add a new custom standalone service? = |
|
89 You can create a plugin or customize the following PHP sample code to add to your theme's function.php file: |
|
90 |
|
91 `function addtoany_add_services( $services ) { |
|
92 $services['google_example'] = array( |
|
93 'name' => 'Google Example', |
|
94 'icon_url' => 'http://www.google.com/favicon.ico', |
|
95 'icon_width' => 16, |
|
96 'icon_height' => 16, |
|
97 'href' => 'http://www.example.com/add?linkurl=A2A_LINKURL&linkname=A2A_LINKNAME' |
|
98 ); |
|
99 return $services; |
|
100 } |
|
101 add_filter('A2A_SHARE_SAVE_services', 'addtoany_add_services', 10, 1);` |
|
102 |
|
103 = How can I force the button to appear in individual posts and pages? = |
|
104 |
|
105 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-->` |
|
106 |
|
107 = How can I remove a button from individual posts and pages? = |
|
108 |
|
109 Type the following tag into the page or post that you do not want the button to appear in: `<!--nosharesave-->` |
|
110 |
|
111 = Why do embedded objects (like Flash) disappear when the menu is displayed? = |
|
112 |
|
113 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. |
|
114 |
|
115 == Screenshots == |
|
116 |
|
117 1. Add to Any Share/Save button, featuring the Open <a href="http://www.shareicon.com/">Share Icon</a> |
|
118 2. Drop-down menu that appears instantly when visitors use the share button |
|
119 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 |
|
120 4. Settings panel |
|
121 5. Color chooser for your Add to Any menus |
|
122 |
|
123 == Changelog == |
|
124 |
|
125 = .9.9.4.3 = |
|
126 * Automatic support for over 50 languages |
|
127 * The drop-down menu automatically detects the visitor's set language and localizes accordingly |
|
128 * Less JavaScript output; removed redundant code |
|
129 * No longer outputs language strings if WordPress locale is set to the default "en_US" |
|
130 * Forward support for WordPress 2.9 |
|
131 |
|
132 = .9.9.4.2 = |
|
133 * Updated button text |
|
134 * Further localized strings |
|
135 |
|
136 = .9.9.4.1 = |
|
137 * Twitter icon included in standard sharing button |
|
138 * Albanian translation (by <a href="http://www.romeolab.com/" target="_blank">Romeo Shuka</a>) |
|
139 * Romanian translation (by <a href="http://www.stefandes.com/" target="_blank">Stefan</a>) |
|
140 |
|
141 = .9.9.4 = |
|
142 * Custom standalone service support |
|
143 * Custom icon support |
|
144 * Updated Twitter icon |
|
145 |
|
146 = .9.9.3.5 = |
|
147 * New standalone services |
|
148 * DailyMe |
|
149 * Google Reader |
|
150 * Mozilla.ca |
|
151 * NewsTrust |
|
152 * Plurk |
|
153 * PrintFriendly |
|
154 * WordPress |
|
155 * Fixed bug affecting certain standalone services |
|
156 * Identi.ca |
|
157 * Bookmarks.fr |
|
158 * Ask.com MyStuff |
|
159 * Catalan translation update (Robert Buj) |
|
160 * Clarified when template code is appropriate |
|
161 |
|
162 = .9.9.3.4 = |
|
163 * Use button IMG instead of background-image for button without text |
|
164 * Defaults to 171 x 16px button |
|
165 |
|
166 = .9.9.3.3 = |
|
167 * Left-padding for icon+text link changed from 39px to 30px |
|
168 * Text-index for parent UL reset |
|
169 * Output buffering replaced |
|
170 * Fixed admin action link |
|
171 * Russian translation (by Elvis) |
|
172 |
|
173 = .9.9.3.2 = |
|
174 * Clarified button placement and theme editing |
|
175 * Arabic translation |
|
176 |
|
177 = .9.9.3.1 = |
|
178 * Fix for possible global/object variable confusion with themes |
|
179 |
|
180 = .9.9.3 = |
|
181 * Add service icons |
|
182 * Changelog markup update |
|
183 |
|
184 = .9.9.2.9 = |
|
185 * Removed extra character from button querystring |
|
186 * New standalone services |
|
187 * Amazon Wish List |
|
188 * Blogger |
|
189 * Evernote |
|
190 * Folkd |
|
191 * Identi.ca |
|
192 * Instapaper |
|
193 * Meneame |
|
194 * Netvouz |
|
195 * TypePad |
|
196 |
|
197 = .9.9.2.8 = |
|
198 * Translations |
|
199 |
|
200 = .9.9.2.7 = |
|
201 * Updated standalone services and icons |
|
202 |
|
203 = .9.9.2.6 = |
|
204 * CSS changed to support more themes |
|
205 * Admin UI updated for 2.8 |
|
206 * Slightly cleaner UI |
|
207 * Includes template code for both button and standalone links (previously only found in FAQ) |
|
208 |
|
209 = .9.9.2.5 = |
|
210 * Removed dragability of dummy image in standalone services list |
|
211 |
|
212 = .9.9.2.4 = |
|
213 * Alt attribute added to standalone service image |
|
214 * Title attribute added to standalone service link |
|
215 * Selected standalone services in admin are more distinguishable |
|
216 * Italian translation (by <a href="http://gidibao.net/">Gianni</a>) |
|
217 * i18n folder renamed to languages due to a problem with the CodeStyling Localization plugin |
|
218 * Contrast improvements to Open Share Icon |
|
219 |
|
220 = .9.9.2.3 = |
|
221 * Support for themes that do not support modern Loop methods |
|
222 * Permalinks now targeted for these older themes |
|
223 * AddToAny URI scheme gives precedence to link URL parameter, then Title |
|
224 * Sitename & Siteurl parameters depreciated for WP (they are usually redundant) |
|
225 |
|
226 = .9.9.2.2 = |
|
227 * Fixed display when all standalone services are removed in admin |
|
228 * Services label renamed Standalone Services for clarity |
|
229 * Updates to Danish translation |
|
230 * Added Belarusian translation |
|
231 |
|
232 = .9.9.2.1 = |
|
233 * Feed icons shown inline, no longer displayed in unordered list |
|
234 |
|
235 = .9.9.2 = |
|
236 * Services array output fixes |
|
237 |
|
238 = .9.9.1 = |
|
239 * Add services.php (critical fix) |
|
240 |
|
241 = .9.9 = |
|
242 * NEW: Individual service links! |
|
243 * Drag & Drop interface with preview |
|
244 * .addtoany_share_save_container is now `<div>`, not `<p>` |
|
245 * Add to Any button now contained within `<ul><li>` |
|
246 |
|
247 = .9.8.9.2 = |
|
248 * Buttons include Facebook icon |
|
249 * Catalan i18n |
|
250 |
|
251 = .9.8.9.1 = |
|
252 * Automatic localization/i18n |
|
253 * Rename Spanish POT to proper |
|
254 * Fixed "Display Share/Save button at the bottom of pages" option when "Display Share/Save button at the bottom of posts is disabled" |
|
255 |
|
256 = .9.8.9 = |
|
257 * wp_footer() detection |
|
258 * Replaced short form of PHP's open tags with long form to work around configurations with shortopentag disabled |
|
259 * Spanish translation (by <a href="http://pablo.poo.cl/" target="_blank">Pablo</a>) |
|
260 |
|
261 = .9.8.8.4 = |
|
262 * Settings panel submits to current page instead of unreliable REQUEST_URI which can omit querystring on IIS |
|
263 * See http://www.microsoft.com/downloads/results.aspx?freetext=954946 |
|
264 |
|
265 = .9.8.8.3 = |
|
266 * Option "Display Share/Save button at the bottom of posts on the front page" applies to all pages that can contain multiple posts |
|
267 |
|
268 = .9.8.8.2 = |
|
269 * Fix button appearing in category list view despite setting |
|
270 |
|
271 = .9.8.8.1 = |
|
272 * Refine conditionals |
|
273 * Highlight admin notices |
|
274 * Danish translation (by <a href="http://wordpress.blogos.dk/" target="_blank">Georg</a>) |
|
275 |
|
276 = .9.8.8 = |
|
277 * Now customize the optional text next to the 16 x 16px icons |
|
278 |
|
279 = .9.8.7.3 = |
|
280 * Important syntax fix |
|
281 |
|
282 = .9.8.7.2 = |
|
283 * Additional options / JavaScript API clarification |
|
284 * i18n update |
|
285 |
|
286 = .9.8.7.1 = |
|
287 * Text-only button stripslashes |
|
288 |
|
289 = .9.8.7 = |
|
290 * Removes unnecessary inline styling in feeds per W3C recommendation |
|
291 |
|
292 = .9.8.6.9 = |
|
293 * Compressed Open Share Icon |
|
294 |
|
295 = .9.8.6.8 = |
|
296 * Chinese translation updated |
|
297 |
|
298 = .9.8.6.7 = |
|
299 * i18n |
|
300 * Chinese translation |
|
301 * Installation clarified |
|
302 |
|
303 = .9.8.6.6 = |
|
304 * Open Share Icon |
|
305 * WordPress 2.7 admin styling |
|
306 * Settings link on Plugins page |
|
307 * Basename var |
|
308 |
|
309 = .9.8.6.5 = |
|
310 * Less JavaScript redundancy from Additional Options (saves bandwidth) |
|
311 * Compressed PNGs added, select a button from settings to begin using PNG (saves bandwidth) |
|
312 |
|
313 = .9.8.6.4 = |
|
314 * Additional Options in Admin panel provides link to JavaScript API |
|
315 * Option to have full addtoany.com legacy page open in a new window |
|
316 |
|
317 = .9.8.6.3 = |
|
318 * Replaced short form of PHP's open tags with long form to work around configurations with short_open_tag disabled |
|
319 |
|
320 = .9.8.6.2 = |
|
321 * Current page title + blog title are used if called outside The Loop |
|
322 |
|
323 = .9.8.6.1 = |
|
324 * Fixed buttons if WordPress files are in a subdirectory while the blog appears in the site root |
|
325 * For example: http://codex.wordpress.org/Giving_WordPress_Its_Own_Directory |
|
326 |
|
327 = .9.8.6 = |
|
328 * Fixed output buffering - button should appear below posts again if option is set |
|
329 |
|
330 = .9.8.5 = |
|
331 * Button targets the current page if called outside The Loop |
|
332 * Accomodates renamed plugin directory |
|
333 |
|
334 = .9.8.4 = |
|
335 * Fixed a small syntax error (critcal if you're on .9.8.3) |
|
336 |
|
337 = .9.8.3 = |
|
338 * Language & localization update |
|
339 * "After clicking OK," removed from the Bookmark tab |
|
340 |
|
341 = .9.8.2 = |
|
342 * Event attributes removed (JS now takes care of button events) |
|
343 * This eliminates the chance of errors prior to JS fully loading |
|
344 |
|
345 = .9.8.1 = |
|
346 * Fixed repo problem |
|
347 |
|
348 = .9.8 = |
|
349 * JavaScript removed from blog feed |
|
350 * Option to display button (without menu) or to not display it at all below posts in blog feed |
|
351 * Replaced some UTF-8 encoding functions with core WordPress functions |
|
352 * For XHTML validation, special characters are converted to HTML entities within JavaScript variables |
|
353 * Reprioritized plugin to load later |
|
354 * Text-only button option |
|
355 |
|
356 = .9.7 = |
|
357 * Internationalization |
|
358 * Buttons updated |
|
359 |
|
360 = .9.6 = |
|
361 * Moved external JavaScript to bottom so that content is prioritized over HTTP requests to static.addtoany.com |
|
362 * 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. |
|
363 |
|
364 = .9.5.2 = |
|
365 * Fixed bug in Internet Explorer 6 that caused custom buttons to have a height and width of 0 |
|
366 * Removed the XHTML depreciated `name` attribute from the button's anchor |
|
367 |
|
368 = .9.5.1 = |
|
369 * Fixed 1 line to support those without short_open_tag |
|
370 |
|
371 = .9.5 = |
|
372 * New: Custom buttons (specify a URL) |
|
373 * Fix to permit XHTML Strict validation |
|
374 |
|
375 = .9.4 = |
|
376 * New Menu Styler lets you customize the color of the menus |
|
377 * New Menu Option: "Only show the menu when the user clicks the Share/Save button" |
|
378 * New: Set custom JavaScript variables for further customization |
|
379 * Better support for CSS styling: .addtoany_share_save |
|
380 * PHP support for short_open_tag |
|
381 * PHP4 legacy and compatibility fixes |