WordPress.org

Ready to get started?Download WordPress

Plugin Directory

Share Buttons by AddToAny

Share buttons for WordPress including AddToAny's universal sharing button, Facebook, Twitter, Google+, Pinterest, StumbleUpon and many more.

Where are the options, and how can I customize the sharing plugin?

In your Admin panel, go to Settings > AddToAny. Among other options, you can choose individual sharing icons, a universal share button, and official 3rd party sharing buttons (Facebook Like Button, Twitter Tweet Button, Pinterest Pin It Button, Google+ Share Button, Google +1 Button) to display, and where and how to display them.

To place the buttons as a "widget" in your theme (if your theme supports WordPress Widgets), go to Appearance > Widgets, then drag AddToAny to an available Widget Area and click Save.

To further customize AddToAny, see the WordPress sharing documentation for the AddToAny plugin. Many customizations will have you copy & paste one (or just a few) lines of JavaScript code into "Additional Options" box. The Additional Options box is in Settings > AddToAny.

Something is wrong. What should I try first?

Try temporarily switching themes and disabling other plugins to identify a potential conflict. If you find a conflict, try contacting that theme or plugin author. If an issue persists on a default theme with all other plugins disabled, perform a google search across the WordPress forums using a query such as: site:wordpress.org/support -reviews addtoany [your issue issue here]

Feel free to post here, where the community can hopefully help you. Describe the issue, what troubleshooting you have already done, and provide a link to your site, and any other potentially relevant information.

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

It's likely because your theme wasn't coded properly. With many themes you can use the Theme Editor to edit your theme's header.php and footer.php files.

In header.php place the following line of code just before the </head> line:

<?php wp_head(); ?>

In footer.php place the following line of code just before the </body> line:

<?php wp_footer(); ?>

Is there a shortcode for sharing?

Yes, you can place your sharing buttons exactly where you want them by inserting the following shortcode in a post or page:

[addtoany]

You can also customize the shared URL like so:

[addtoany url="http://www.example.com/page.html" title="Some Example Page"]

For Facebook sharing, how can I set the thumbnail image and description Facebook uses?

Facebook does link sharing differently than most other services. Facebook expects the Title, Description, and Thumbnail of a shared page to be defined in the actual HTML code of a shared page. Unlike other services that accept common parameters, Facebook only accepts a URL, then Facebook scans the actual page for details. To change the title, description or image on Facebook, you will need to modify your theme or use another plugin that filters your theme.

Try running Facebook's URL Debugger on your pages to see how Facebook reads your site.

To change the title, description and/or image on Facebook, your theme's header file should be modified according to Facebook's OpenGraph specification. With WordPress, this can be accomplished with plugins such as the WordPress SEO by Yoast or the All in One SEO Pack. Please see those plugins for details, and post in the WordPress or plugin author's forums for more support.

For more technical information on setting your pages up for Facebook sharing, see "Facebook Sharing Checklist" in Facebook's documentation.

How can I use custom icons?

Upload sharing icons in a single directory to a public location, and make sure the icon filenames match the icon filenames packaged in the AddToAny plugin. In your Admin panel, go to Settings > AddToAny > Advanced Options > check the "Use custom icons" checkbox and specify the URL to your custom icons directory (including the trailing /). For AddToAny's universal button, go to Universal Button, select Image URL and specify the exact location of your AddToAny universal share icon (including the filename).

How can I add both the universal 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 if ( function_exists( 'ADDTOANY_SHARE_SAVE_KIT' ) ) { ADDTOANY_SHARE_SAVE_KIT(); } ?>

If you want to customize the shared URL and title for the universal button and standalone services, use the following code as a template:

<?php if ( function_exists( 'ADDTOANY_SHARE_SAVE_KIT' ) ) { 
    ADDTOANY_SHARE_SAVE_KIT( array( 'linkname' => 'Example Page', 'linkurl' => 'http://example.com/page.html' ) );
} ?>

If you want to share the current URL and title (detected on the client-side), use the following code:

<?php if ( function_exists( 'ADDTOANY_SHARE_SAVE_KIT' ) ) { 
    ADDTOANY_SHARE_SAVE_KIT( array( 'use_current_page' => true ) );
} ?>

If you want to hardcode the shared current URL and modify the title (server-side), use the following code as a template:

<?php if ( function_exists( 'ADDTOANY_SHARE_SAVE_KIT' ) ) { 
    ADDTOANY_SHARE_SAVE_KIT( array( 'linkname' => ( is_home() ? get_bloginfo( 'description' ) : wp_title( '', false ) ), 'linkurl' => ( is_ssl() ? 'https://' : 'http://' ) . $_SERVER["HTTP_HOST"] . $_SERVER['REQUEST_URI'] ) );
} ?>

How can I add just the universal 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:

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

If you want to customize the shared URL and title for this button, use the following code as a template:

<?php if ( function_exists( 'ADDTOANY_SHARE_SAVE_BUTTON' ) ) { 
    ADDTOANY_SHARE_SAVE_BUTTON( array( 'linkname' => '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):

<?php echo '<div class="a2a_kit a2a_kit_size_32 addtoany_list">';
if ( function_exists( 'ADDTOANY_SHARE_SAVE_ICONS' ) ) { ADDTOANY_SHARE_SAVE_ICONS(); }
echo '</div>'; ?>

If you want to customize the shared URL and title for these icons, use the following code as a template:

<?php
if ( function_exists( 'ADDTOANY_SHARE_SAVE_ICONS' ) ) {
    echo '<div class="a2a_kit a2a_kit_size_32 addtoany_list">';
    ADDTOANY_SHARE_SAVE_ICONS( array(
        'linkname' => 'Example Page', 'linkurl' => 'http://example.com/page.html'
    ) );
    echo '</div>';
} ?>

(If you are using the small icons, remove a2a_kit_size_32 from the line <div class="a2a_kit a2a_kit_size_32 addtoany_list"> so that you have <div class="a2a_kit addtoany_list">.)

Or you can place the icons as individual links without styling:

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

If you want to customize the shared URL and title for these icons, use the following code as a template:

<?php if ( function_exists( 'ADDTOANY_SHARE_SAVE_ICONS' ) ) {
    ADDTOANY_SHARE_SAVE_ICONS( array( 'linkname' => '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 sharing button(s) 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 the button(s) from individual posts and pages?

When editing a post or page, uncheck "Show sharing buttons", which is located at the bottom of the editor page. Be sure to update or publish to save your changes.

An older method was to insert the following tag into the page or post (HTML tab) that you do not want the button(s) to appear in: <!--nosharesave-->

How can I force the button(s) to appear in individual posts and pages?

When editing a post or page, check the "Show sharing buttons" checkbox, which is located at the bottom of the editor page. Be sure to update or publish to save your changes. Note that, by default, AddToAny is setup to display on all posts and pages.

An older method was to insert the following tag into the page or post (HTML tab) that you want the button(s) to appear in: <!--sharesave-->

How can I remove the button(s) from category pages, or tag/author/date/search pages?

Go to Settings > AddToAny > uncheck Display at the top or bottom of posts on archive pages. Archive pages include Category, Tag, Author, Date, and also Search pages.

Why does the Facebook Like Button, Twitter Tweet Button, Pinterest Pin It Button, Google+ Share Button, or Google +1 Button have so much whitespace to the right of it?

The minimum width for the Facebook Like Button is 90 pixels. This is required to display the total number of Likes to the right of the button. See Facebook's Like Button documentation for details

It's not recommended, but you can change the width of the Facebook Like Button using CSS code, for instance: .a2a_button_facebook_like { width:50px !important; }

The Twitter Tweet Button with 'show count' enabled is 130 pixels. You can change the width using CSS code, for instance: .a2a_button_twitter_tweet { width:100px !important; }

The Pinterest Pin It Button with 'show count' enabled is 76 pixels. You can change the width using CSS code, for instance: .a2a_button_pinterest_pin { width:90px !important; }

The Google +1 Button with 'show count' enabled is 90 pixels. You can change the width using CSS code, for instance: .a2a_button_google_plusone { width:65px !important; }

The Google+ Share Button width can be changed using CSS code, for instance: .a2a_button_google_plus_share { width:57px !important; }

Does the plugin output W3C valid code?

Yes, this plugin outputs 100% W3C valid HTML5 & XHTML and W3C valid CSS 3 by default.

If you use the Facebook Like, Twitter Tweet or Google +1 buttons in an HTML5 theme, note that the button iframes use the scrolling attribute, which is valid XHTML but the attribute has been deprecated in HTML5. It's needed to prevent scrollbars from appearing over the Like, Tweet, and +1 buttons inside of the iframes.

Regardless of circumstances for passing W3C tests, the plugin will always output semantically valid and robot-readable code, so publishers do not have to worry about search engine crawler errors due to invalid code. Both web standards and cross-browser are taken very seriously.

How can I move the plugin's inline CSS into my theme's main external stylesheet?

Go to Settings > AddToAny > uncheck Use inline CSS and place the CSS code in your theme's main stylesheet.

Why does the menu appear behind embedded objects (like Flash)?

Please read this document for an explanation and possible fix. For WordPress, an easier fix is to have the plugin hide intersecting embedded objects. Just copy & paste the recommended code into the Additional Options box in Settings > AddToAny, then save changes.

For a WordPress Multisite Network (MS), how can I set the plugin as a "Must-Use" plugin to automatically execute for all blogs?

Upload the plugin directory (including all files and directories within) to the /wp-content/mu-plugins/ folder, then move the add-to-any.php file from the plugin directory to the mu-plugins folder so that it can auto-execute.

Requires: 2.8 or higher
Compatible up to: 4.0
Last Updated: 2014-8-18
Downloads: 3,210,556

Ratings

4 stars
4.1 out of 5 stars

Support

24 of 49 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

4 people say it works.
0 people say it's broken.

100,1,1
100,1,1 100,1,1
100,1,1 100,1,1
100,1,1
100,4,4 100,2,2 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1
100,12,12 100,4,4 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,3,3 100,1,1
89,9,8 100,4,4 100,3,3 100,1,1 100,1,1 100,3,3 100,1,1 100,2,2 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,2,2 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 0,1,0 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1
50,2,1 100,4,4 100,9,9 67,3,2 91,11,10 100,2,2 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,2,2 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 0,1,0 100,3,3 100,1,1 100,1,1
100,5,5 100,21,21 91,34,31 100,2,2 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1
97,37,36 100,16,16 82,11,9 100,10,10 83,12,10 100,24,24 100,3,3 0,1,0 100,2,2 100,3,3 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,2,2 100,1,1 100,1,1 100,2,2 100,1,1 100,1,1 100,1,1 100,1,1 100,2,2 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1
80,10,8 100,7,7 67,3,2 80,5,4 81,43,35 100,3,3 100,2,2 100,8,8 67,3,2 100,1,1 100,2,2 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 50,2,1 50,2,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1
100,8,8 92,24,22 94,17,16 95,19,18 100,4,4 100,1,1 91,11,10 100,5,5 78,9,7 95,20,19 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1
100,3,3 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1
100,10,10 100,2,2 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1
100,3,3 100,4,4 100,1,1 75,8,6 100,4,4 100,1,1 100,1,1
100,1,1 100,1,1 67,3,2 100,1,1 100,6,6 100,4,4 100,2,2 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1 100,2,2 100,1,1 100,1,1 100,1,1 100,1,1
100,1,1 80,15,12 100,1,1 100,1,1 100,1,1 100,2,2 75,4,3 50,2,1 71,7,5 67,9,6 100,9,9 92,12,11 100,12,12 100,3,3 100,2,2 100,2,2 100,2,2 100,2,2 100,1,1 100,1,1
86,7,6 100,2,2 100,4,4 100,2,2 100,1,1 100,2,2 100,1,1 100,2,2 100,2,2 100,1,1 100,1,1
75,4,3 100,5,5 90,10,9 100,1,1 100,3,3 100,2,2 100,1,1 100,1,1 100,1,1
100,4,4 67,6,4 91,11,10 88,8,7 100,3,3 100,1,1
83,6,5 100,2,2
100,1,1 70,10,7 100,2,2 0,1,0
75,12,9 96,24,23 100,14,14
100,8,8 100,1,1
86,7,6 92,12,11 100,6,6 100,6,6 100,7,7 33,3,1 100,2,2 100,3,3 100,1,1
100,3,3 81,16,13 100,1,1
64,11,7
92,13,12
87,15,13
75,4,3
67,9,6
100,1,1 100,2,2 100,4,4 100,1,1 100,1,1 100,1,1 100,1,1 100,1,1
100,2,2 50,2,1 100,2,2 100,2,2 100,4,4 100,1,1 100,1,1 100,2,2 100,2,2
100,2,2 100,3,3 67,3,2 100,4,4 100,2,2 100,3,3 100,2,2 100,2,2 100,2,2 100,2,2 100,2,2
100,1,1 100,3,3 100,2,2 100,2,2 100,2,2 100,1,1 100,2,2 100,2,2 100,2,2
100,1,1 67,3,2 100,3,3 100,5,5 100,3,3 100,3,3 100,2,2 100,2,2 100,1,1 100,2,2 100,2,2 100,2,2 100,2,2 100,2,2 100,2,2 100,2,2 100,2,2 100,2,2 100,2,2 100,2,2 100,1,1 100,1,1 100,2,2
100,3,3 88,8,7 100,4,4 100,2,2 100,3,3 100,2,2 100,2,2 100,2,2 100,2,2 100,2,2 100,2,2 100,2,2 100,2,2 100,2,2 100,2,2 100,2,2 100,1,1 100,2,2 100,1,1
100,3,3 80,5,4 100,3,3 100,2,2 100,4,4 100,2,2 100,2,2 67,3,2 100,2,2 100,3,3 100,3,3 100,2,2 100,2,2 100,1,1 100,2,2 100,1,1
100,2,2 100,2,2 100,1,1 100,2,2 100,1,1
100,2,2 100,2,2 100,2,2 100,2,2 100,1,1 100,2,2 100,2,2
100,2,2 100,3,3 100,2,2 100,2,2 100,2,2 100,2,2 100,3,3
67,3,2 100,6,6 100,5,5 100,5,5 100,4,4
100,4,4