The most popular Click To Tweet Plugin for WordPress (by a mile), for good reason.
Create tweetable content for your readers, using a simple shortcode or Gutenberg block. Readers are encouraged to tweet out both a quote, and a link to your content.
- Add Premium Styles with just a few clicks.
- Using the shortcode method in the classic editor? See our Power User Guide for all the tricks (remove or change the “via,” make links nofollow, change the callback URL, and more!).
Back in the day, there was only one or two options for Click to Tweet plugins. They didn’t do a lot of things I wanted them to do, so I made this plugin. I’m bad at naming things, so “Better Click To Tweet” it is. Since then, I’ve made so many changes and enhancements that any resemblance to the original inspiration plugins are long gone.
Developer? Designer? Geek of any sort? Please hop in and suggest improvements. You can create issues or submit pull requests at the github repository for this plugin.
Translation is managed at the official WordPress translation page.
This plugin provides 1 block.
- Better Click to Tweet
To install the plugin manually in WordPress:
- Login as Admin on your WordPress blog.
- Click on the “Plugins” tab in the left menu.
- Select “Add New.”
- Click on “Upload” at the top of the page.
- Select the ‘better-click-to-tweet.zip’ on your computer, and upload. Activate the plugin once it is uploaded.
To install the plugin manually with FTP:
- Unzip the ‘better-click-to-tweet.zip’ file. Upload that folder to the ‘/wp-content/plugins/’ directory.
- Login to your WordPress dashboard and activate the plugin through the “Plugins” tab in the left menu.
Are there other style options?
Yes! If you are a developer or handy with CSS, there are limitless options for styling.
If you are not a developer, I have released a premium add-on for selecting among several (and growing) different style options. Check out Premium Styles
How does Better Click To Tweet work?
Better Click To Tweet enables you to create beautiful Click To Tweet boxes in your blog posts. Once you’ve installed and activated the plugin, click on the settings link to put in your Twitter username, and save the settings.
Then, wherever you want to insert a Click to Tweet quote, use a shortcode in the format
[bctt tweet="xxxxxxxxxxxx"]replacing the
xxxxxxxwith your tweetable quote.
In the visual editor, you can click the blue birdy icon in the toolbar and a correctly formatted shortcode will be inserted in your text. For more info or clarifications, start a support thread. I’ll actively answer.
How does the URL shortener functionality work?
Better Click To Tweet gives you the maximum number of characters possible. Allow me to explain:
Twitter automatically routes every link through its own URL shortener (you might recognize t.co as the domain they use). For their t.co links, the length is automatically truncated to 23 characters for URLs. This leaves 253 characters after the URL for you to use to compose your tweet. Even a link that is run through bit.ly or a yourls.org install is still routed through t.co in the tweet.
The benefit of URL shorteners goes beyond just character length, though. Many users use bit.ly or a similar service to track numbers of clicks and other analytical data. I personally use yourls.org to power http://benlikes.us for my shortened links.
Better Click To Tweet works alongside url shortening plugins to harness that power, if you choose to.
WordPress has a feature called “shortlinks” which changes the long URL to something like example.com/?p=3435. Various plugins in the official plugin directory exist to change that shortlink to one using other outside services. Using a combination of those plugins and mine, your Better Click To Tweet boxes can now display a trackable link.
On the settings page for Better Click To Tweet, simply check the box indicating you’d like to use the short URL, and save changes. If you’ve got a plugin that correctly hijacks the built-in WordPress shortlink functionality, you’re all set! I’ve tested my plugin with the following plugins, and will make every effort to keep this list updated:
If you run into any issues with my plugin not working alongside a certain link shortener, start a support thread and include a link to the other plugin. I’ll see what I can do to work with the other developer.
I’ve also written a tutorial for how to set up the shortlinks with bit.ly and yourls.org.
Yes! Because I want the majority of users (who aren’t as concerned with options like nofollow links and getting rid of the URL in the tweet) to be happy, most options are hidden. I’ve written a tutorial for using those advanced options. Most of those options are visible in the Gutenberg block, so that tutorial really only applies to the classic editor.
What do I do if it’s not working right?
I am active in the support forums, and in patching the plugin. Start a thread there, and I will gladly help you out. Most of the time you can expect a day or two before a response. I’m in the eastern US, and I like playing with my kids at night, so you might not hear back immediately. Don’t panic.
How can I help?
Issues, feature requests, and Pull Requests: https://github.com/Benunc/better-click-to-tweet
Contributors & Developers
“Better Click To Tweet” is open source software. The following people have contributed to this plugin.Contributors
- security — prevent unauthenticated access some settings.
- updated compatibility for PHP 8.0 and 8.1
- checked to make sure it works on the forthcoming WordPress 6.1
- fix – patch minor security issue. Short version: if an attacker already has admin access to your site (or feeds a vulnerable admin user a specific string) they could execute code remotely on sites with very specific server configurations. But if an attacker already has admin access to your site, there are much easier and effective ways of doing nefarious things. Still, it’s good to remove unescaped potential vulnerable inputs. So we did.
- chore – tested for compatibility with WordPress 6.0
- chore – the number of people using promo codes is too (darn) low. Use promo code CHANGELOG at https://benlikes.us/bcttps
- fix — resolved a bug where Better Click To Tweet was not playing nicely with other plugins that made changes to the title related filters.
- chore — unrelated to the plugin, there’s so much pollen in the air in South Carolina. You can see it like a cloud. Use promo code CHANGELOG at https://benlikes.us/bcttps
- feature — adding a blank [bctt] shortcode populates the Better Click To Tweet box with the post/page’s title.
- bonus — moved to the country. Incorrectly assumed I’d eat a lot more peaches, based on my extensive knowledge of Presidents Of The United States songs from the 90s
- chore — confirm compatibility with WordPress 5.7 and PHP 8.0
- sale — you should reward yourself with the promo code CHANGELOG at https://benlikes.us/bcttps
- chore — check for compatibility with the upcoming WordPress version 5.6
- enhancement — update some of the links and text on the settings page.
- fix — the upsell nag was previously showing on any page that was related to plugins, including the update interface. now it only shows up on the plugins page itself.
- chore — tested up to WordPress version 5.5
- fix — a woocommerce function somehow made it into my setup wizard, which has been removed now. It was causing errors on a select few installs on installation.
- switcheroo — going back to featuring the Premium styles add-on in the plugins page upsell. You should buy that with a coupon of CHANGELOG at https://benlikes.us/bcttps
- fix — the links being sent to mailchimp for those opting into the newsletter were sending an incorrect subset, resulting in incorrect data.
- fix — resolve a minor error on the Premium Styles tab of the settings with folks who had their own custom styles enqueued but not the offical Premium Styles add-on.
- bonus — there’s still not-so-much usage for the CHANGELOG discount code at https://benlikes.us/bcttps I’m personally fine with folks paying full price, tho.
- enhancement — new onboarding/welcome wizard to help users maximize their productivity with the plugin.
- fix — at long last, this plugin doesn’t eat up valuable Top Level Menu space, and all menu items for the free plugin or premium addons are moved to tabs.
- chore — tested up to 5.3, and listen, if you’re not on at least 5.2 for the massive enhancements like recovery mode, you definitely should be.
- bonus — people keep giving me extra money when they check out at betterclicktotweet.com because they don’t read changelogs. You’ve got a leg up and can get a discount with code CHANGELOG.
- fix — resolving PHP notices related to the custom URL not being set.
- fix — resolve outstanding errors around UTM tags add-on integration.
- chore — tested up to WordPress version 5.2. you should definitely be on 5.2. It’s awesome.
- bonus — I feel like you people aren’t reading my changelogs. I’m over here handing out discounts, and y’all just keep paying full price. try CHANGELOG to see if you get 10% off!
- new — created a new nag for the plugins page announcing the UTM tags add-on.
- new — added a link to the main settings page for folks to check out the new UTM Tags addon.
- bonus — people who read change logs should get a discount. Use the code CHANGELOG at checkout for 10% off. http://benlikes.us/bcttaddons (good on the bundle, too!)
- new — adding a filter and various other enhancements to support a new UTM tags add-on
- fix — testing with the newest version of the block-based editor (Gutenberg)
- new — added a constant to define the core BCTT version, allowing add-ons to make sure that BCTT core is up to date before activating.
- fix — two spelling typos in the new License activation page. Thanks to @garrett-eclipse on Github for the fix.
- fix — on certain installs I was getting a front end notice about an undefined variable. This patch fixes that. Thanks to @dannycooper for the help!
- fix — replace premium styles page for premium styles users.
- feature — moved license management for premium add-ons (get them at https://www.betterclicktotweet.com today!) to the core plugin. Free plugin users will not notice a difference here at all. Premium users: check your email!
- enhancement — several updates to code comments for clarity.
- enhancement — the callback URL (from tweet back to website) is now filterable.
- fix — added a parameter to the mailing list signup in the admin to help determine where some suspicious signups are originating from.
- enhancement — gave the readme file a makeover so that the page on the plugin directory is more focused and provides greater value.
- fix — resolve an error for folks running both WordPress 5.0 and PHP version 5.3.x
- fix — changes to make the code more legible for humans. But only the total geeks.
- fix — update language on the settings page about the tweet length (280 character support added earlier, this is updating the help text to reflect that)
- fix — tested up to WordPress 5.0
- random — updated the text on the email signup box on the settings page. I don’t offer a PDF any more… It’s more of a email drip sequence at this point.
- fix — resolving zip problem.
- fix — another attempt at the “invalid headers” intermittent problem.
- fix — improving compatibility with WordPress 5.0 and the new block-based (Gutenberg) editor. Thanks again to @ajitbohra for the help
- fix — resolve “invalid headers” problem on certain new installs
- Enhancement — added compatibility with WordPress 5.0’s new editor, codenamed Gutenberg (thanks to Ajit Bohra @ajitbohra for all the great work!)
- Enhancement — Some CSS modifications to make the plugin play nicely with the new editor.
- Enhancement — changed the twitter bird icon for an updated one on the front end. (Thanks to @oliverpitsch for the PR on Github.)
- Security fix — added a line to the output that secures the target _blank vulnerability. Thanks to @dmv912 on the wordpress forums for the call-out!
- Fix — removed a line that was breaking things.
- Fix — made the settings page more accessible with the help of Rachel Cherry’s fantastic wa11y plugin. https://wordpress.org/plugins/wa11y/ Thanks Rachel!
- Started tinkering with Gutenberg compatibility, the new editor experience coming to WordPress, to make BCTT compatible with the Future of WordPress (no file changes on this, just wnate to let you know it’s on the radar. Learn more at https://wordpress.org/gutenberg
- Enhancement — Now supports Twitter’s new 280 character limit. Note that non-roman characters may effect the new truncation in strange ways. Please report any such strangeness to me in the support forums.
- Enhancement — updated some links in the back end to link to the all new (and still kinda bland) https://www.betterclicktotweet.com
- Security Fix — potential XSS vulnerability on settings page. (mild security risk only affecting logged-in administrator accounts previously compromised). Thanks Robbie at DXW @robbiepaul on Github for the responsible disclosure.
- If the last point didn’t make any sense, please translate it to “UPDATE NOW. Previous versions of the plugin are mildly vulnerable to enterprising attackers.”
- enhancement — cleaned up the various options checks that were happening on the front end (thanks @igmoweb on GitHub!)
- Readme changes. I also celebrated a milestone of 20K active installs, which was cause for great celebration, and at least one undocumented happy dance.
- fix — unused $handle_code variable has been removed. Was causing some errors for folks.
- fix — code introduced in 5.2 messed up the “via” option and the option to not include the URL. This has been fixed.
- security fix — adds (more) escaping throughout the plugin. Thanks to Paul de Wouters from HumanMade for the PR!
- enhancement — tested for compatibility with WordPress core 4.8
- but seriously, you should check out Premium Styles. http://benlikes.us/bcttps
- enhancement — I added a highly dismissable notice to the plugins page upon update, encouraging people to purchase my Premium styles add-on. The notice only shows to folks who have not previously customized their own styles, and once dismissed will never be shown to that user again.
- enhancement — I made several changes to the readme file so that the plugin is showcased nicely in the WordPress Plugin Directory’s new design.
- fix — I was incorrectly calling translation module, breaking things when people updated to the latest version of Yoast SEO.
- fix — “subscribe” text on plugin settings page was not translatable.
- New customers are enjoying Premium Styles: http://benlikes.us/bcttps
- enhancement — settings page now looks good on mobile. Before it looked a bit like someone was actively hitting it with a bat.
- enhancement — added multiple action hooks to the settings page. This provides third party developers with the ability to add things to that page without hacking the core code.
- enhancement — made the function enqueuing the front end styles DRYer.
- change — the previous way (version 4.9) I had filtered the function enqueuing styles was throwing PHP warnings when I used it, so I introduced an options-based method for never enqueueing it in the first first place. Updated gist for that: http://benlikes.us/bcttgist2 This method will also pave the way for the most exciting update (for me) in the history of Better Click To Tweet:
- change — introduced the first premium add-on (Premium Styles), and made some changes to the settings page to facilitate that. The goal is threefold: (1) Don’t introduce the option to folks who have already replaced the custom stylesheet using the power user guide http://benlikes.us/7r or by dequeueing the stylesheet using this gist http://benlikes.us/bcttgist1 (2) Introduce the option to purchase custom styles in a non-sleazy way. (3) Um, introduce the option to my tens of thousands of happy users to pay me for something.
- enhancement — added a ‘prompt’ shortcode attribute, so not you can change the words “Click To Tweet” on a per-box basis. Thanks to @apearlman on the WordPress.org support forums for the suggestion!
- fix — changed the way the shortcode attributes are called, because my IDE kept throwing strange errors because the code wasn’t clean enough.
- fix — removed some unused local variables because I used to not know how to code things good.
- dream — thought about ways to monetize this plugin, but ultimately decided against it for now, because I hate dashboard nags. But if you like it, donate: http://benlikes.us/donate
- change — decided to go with 4.10 instead of 5.0 in an attempt to move toward a version numbering system that makes sense, because I have learned much since 0.X —> 1.0.
- just for kicks and totally unrelated — wrote a cool post about rolling back WordPress plugins: http://benlikes.us/fk
- enhancement — Made the function that registers and enqueues the scripts filterable, so that developers who want to put all styles for Better Click To Tweet boxes in their theme files are able to do so using this snippet: https://gist.github.com/Benunc/533985231bbfde551d019620f628a921
- two updates in a row with no love for the non developer, but MUCH love for the developer. Trust me, this one is big time for CSS developers to be able to add styles to themes.
- changed some specifics in the FAQ, and the Readme in general. Encouraged people to donate at http://benlikes.us/donate
- made span classes filterable, so that other developers don’t hate me when they try to extend the plugin.
- I know that first point doesn’t sound like much, but it’s huge for developer geeks. You’re just gonna have to trust me.
- removed the names of translators from the “description” since they are now being handled by official language packs, and giving credit where it is due was getting complicated.
- updated links throughout the back end of the plugin to send me money, for people who are into that sort of thing. Shoutout to https://givewp.com for the SWEET donation integration on my site.
- added the ability to change the “via” addendum on a per-box basis using the new “username” shortcode attribute. The default behavior is (still) to go with the username you saved on the settings page.
- (non-geek explanation of that first point) Now if you have a guest post by @KanyeWest, your Better Click To Tweet box can add “via @KanyeWest” automatically to your reader’s tweets!
- made some changes to the toolbar popup in the visual editor to facilitate the new “username” attribute, limiting confusion and causing much rejoicing.
- Made unsuccessful attempt at getting Kanye West to guest post as the ultimate demonstration of the new feature.
- Tested for compatibility with the upcoming WordPress 4.5, and I don’t mean to sound arrogant, but it pretty much NAILS compatibility with 4.5.
- Added a module that shows up when a user is using WordPress in a language for which there is incomplete (or non-existent) translations for this plugin. For users where there is a complete (+90%) translation, nothing will show up. But for users where the translation is incomplete, they’ll be encouraged to help with the translation efforts!
- Removed extra (old and unused) js file.
- changed some back-end links to go to my new page, www.wpsteward.com
- realized that my use of tags in the WP repo miiiight have been a touch on the obnoxious and unhelpful side, so now I just use 3.
- successfully overthrew an oppressive regime in my 5-year-old’s preschool “mystery reader” cartel. Take that, Fox in Socks.
- Removed call to external twitter script for security concerns.
- changed some wording on the description.
- The click to tweet box is now output as a
<spaninstead of a
<div>giving the ability (with custom CSS) to “inline” a click to tweet box.
- fixed an issue that was causing browsers to load older cached versions of the css.
- made no noticable attempts at overthrowing governments, but I did post something on facebook about Donald Trump which made some waves.
- updated css for compatibility with the twenty sixteen theme.
- updated compatibility to WordPress 4.4.
- unsuccessful overthrow of all world governments. I would have gotten away with it too, if it weren’t for those meddling kids.
- fixed bug introduced in v 4.5 incorrectly displaying ellipses on truncated tweets.
- added Greek translation.
- fixed issue causing tweets to display incorrectly on iOS Twitter App (thanks to Cameron Conaway for the bug report in the forums)
- Ampersands are now correctly displayed.
- began master plan moving toward world domination.
- Fixed CSS issue with spacing in the default theme.
- Twitter now opens in a new modal box instead of a new tab, (developers: this is done using a call to platform.twitter.com/widgets.js within the code of the output from the shortcode. This means that the script won’t be loaded on pages or posts where it’s not needed.)
- added Italian language
- added translation support (internationalization or i18n) to the button on the visual editor. Now the entire plugin is translatable!
- updated swedish, finnish, and spanish language files.
- added German and Swedish translations, updated info in readme with link to instructions for migrating from Click To Tweet to Better Click To Tweet.
- made minor change to the bcttstyle.css (sample) file that was bugging me on hover.
- added the ability to specify a custom URL as a shortcode parameter. (more info at the power user tutorial at http://benlikes.us/7r )
- added Russian translation
- added sample bcttstyle.css file (for moving to the root of the /uploads folder) to assets/css
- the plugin now looks for a custom css stylesheet before falling back to the default style, giving designers and developers full access to the CSS, without disrupting user experience for folks just looking to plug and play.
- added Finnish (fi) translation courtesy of Sampsa Daavitsainen at http://calltoaction.fi
- complete overhaul of the visual editor button courtesy @norcross
- added the ability to make all links “nofollow” by adding the parameter
nofollow="yes"to the shortcode.
- complete overhaul of the settings page for better readability.
- added Serbian translation courtesy of Borisa Djuraskovic
- small change to the outputted URL for vc3 compliance. Thanks to @tomazzaman on Github for the fix!
- fixed a bug that was creating (rare, server-configuration-related) “Fatal Error” notices for
mb_strlen()and related multibyte functions.
- various code tweaks for readability and compliance with WordPress standards.
- fixed bug that was causing the URL not to display on certain clicks after the 3.2 update (thanks @aa_stardust for the heads up!)
- fixed the truncation math given the new options to remove the url (as of 3.2) and via (as of 3.1), to correctly get back all those lost characters.
- added the ability to leave off the url on a tweet-by-tweet basis (handwritten shortcodes only, the visual editor will not show it as an option on the popup window)
- code modifications for clarity.
- added the ability to leave off the
via @YourTwitterNameon a tweet-by-tweet basis.
- added option to use WordPress shortlink in place of full URL.
- further refinement of the math used in calculating tweet truncation length.
- updated CSS to remove underline on “Click to Tweet” on Twenty Fifteen theme (and others!)
- added in support for RSS feeds: when outputting to an RSS feed, the click-to-tweet text will be smartly formatted.
- added css declarations to deal with issues in the Twenty Fifteen theme.
- readme enhancements for better user experience.
- Major version release for internationalization: added Spanish (ES) translation, and updated code throughout for internationalization. Still to-do: add translation support for the tinymce plugin on the visual editor.
- updated the tweet length math to correctly parse text with non-standard characters. Thanks to WordPress forum user zachop at https://wordpress.org/support/topic/incorrect-handling-length-count-of-multi-byte-strings for the tip.
- various code cleanup issues, to make my code more readable and complaint with WordPress standards.
- rescued 9 characters that were being stolen by some incorrect math in my tweet-generating function. (now tweets won’t be truncated until they actually need to be).
- added margin on the bottom of the bcct-clicktotweet div
- fixed a bug that was not displaying the CSS correctly.
- updated the FAQ and other readme items.
- Initial release.