10up / Autoshare For Twitter
Autoshare for Twitter
Automatically tweets the post title or custom message and a link to the post.
Overview
Disclaimer: TWITTER, TWEET, RETWEET and the Twitter logo are trademarks of Twitter, Inc. or its affiliates.
Note: Posts and pages are supported by default. Developers can use the autoshare_for_twitter_default_post_types
filter to change the default supported post types (for more, see #25). The plugin namespace changed to just 'autoshare' as of version 1.0.0.
Custom post types can now be opted into autoshare features like so:
function opt_my_cpt_into_autoshare() {
add_post_type_support( 'my-cpt', 'autoshare-for-twitter' );
}
add_action( 'init', 'opt_my_cpt_into_autoshare' );
In addition, adding support while registering custom post types also works. Post types are automatically set to autoshare. Future versions of this plugin could allow this to be set manually.
While the autoshare feature can be opted into for post types using the above filter, by default the editor still has to manually enable autoshare during the post prepublish flow. The autoshare_for_twitter_enabled_default
filter allows autoshare to be enabled by default for all posts of a given post type. Editors can still manually uncheck the option during the publishing flow.
Example:
function enable_autoshare_by_default_for_core_post_type( $enabled, $post_type ) {
if ( 'post' === $post_type ) {
return true;
}
return $enabled;
}
add_filter( 'autoshare_for_twitter_enabled_default', 'enable_autoshare_by_default_for_core_post_type', 10, 2 );
Plugin Compatibility
Distributor
When using with 10up's Distributor plugin, posts that are distributed will not be autoshared if they are already tweeted from the origin site. Autoshare for Twitter tracks posts that have been tweeted in post meta to avoid "double tweeting". To avoid this behavior, use the dt_blacklisted_meta
filter to exclude the 'autoshare_for_twitter_status' meta value from being distributed :
add_filter( 'dt_blacklisted_meta', function( $blacklisted_metas ) {
$blacklisted_metas[] = 'autoshare_for_twitter_status';
return $blacklisted_metas;
} )
Requirements
- PHP 7.2+
- WordPress 4.7+
Installation
- Upload the entire
/autoshare-for-twitter
directory to the/wp-content/plugins/
directory. - Activate the plugin
- Register post type support for types that should be allowed to autoshare.
add_post_type_support( 'post', 'autoshare-for-twitter' );
FAQs
Does this plugin work with Gutenberg?
Yes, yes it does! For more details on this, see #44.
Support Level
Active: 10up is actively working on this, and we expect to continue work for the foreseeable future including keeping tested up to the most recent version of WordPress. Bug reports, feature requests, questions, and pull requests are welcome.
Changelog
A complete listing of all notable changes to Autoshare for Twitter are documented in CHANGELOG.md.
Contributing
Please read CODE_OF_CONDUCT.md for details on our code of conduct, CONTRIBUTING.md for details on the process for submitting pull requests to us, and CREDITS.md for a listing of maintainers, contributors, and libraries for Autoshare for Twitter.