Twitter Mentions As Comments Plugin

Twitter Mentions as Comments does exactly what it promises to do – scours Twitter for people talking about your blog posts and silently inserts their Tweets alongside your existing comments. The plugin leverages the power of WordPress’s built-in commenting system – notification, comment moderation, author white/black listing – making Twitter an extension of your blog.

Features

• Searches for Tweets linking to your blog posts, regardless of the URL shortener used (using Twitter’s Search API)
• Pushes Tweets into WordPress’s existing comment workflow – notifications, comment moderation, and author whitelists/blacklists work just like any other comment
• Fetches user’s real name and profile picture and links directly to the original Tweet
• Checks automatically – no need to do a thing
• Option to automatically exclude ReTweets
• Option to store tweets as trackbacks/pingbacks
• Option to specify which posts to check (e.g., 10 most recent posts, all posts, front page only)
• Smart Caching of Tweets and user data – retrieves only what it needs to save on API calls and server load

Planned Features

• Dynamic resizing of Twitter profile images to fit WordPress theme
• Prioritization of newer posts
• Oauth Authentication to raise API limit (currently unlimited Tweets, but limited to 150 new comment authors per hour)
• Smarter API throttling

You can see it in action on the WP Resume Plugin page.

Questions? Comments? Feature Requests? Have a great idea? Please see where to get support or report an issue and how to contribute.

Developers, have a killer feature you’d love to see included? Feel free to fork the project on GitHub and submit your contributions via pull request.

Enjoy using Twitter Mentions as Comments? Feel free to make a small donation to support the software’s continued development.

[Photo via joshsemans]

Donate

Enjoy using Twitter Mentions as Comments? Please consider making a small donation to support the project’s continued development.

How To Contribute

Twitter Mentions as Comments is an open source project and is supported by the efforts of an entire community. We’d love for you to get involved. Whatever your level of skill or however much time you can give, your contribution is greatly appreciated.

• Everyone – help expand the projects documentation wiki to make it easier for other users to get started
• Users – download the latest development version of the plugin, and submit bug/feature requests.
• Non-English Speaking Users – Contribute a translation using the GlotPress web interface – no technical knowledge required (how to).
• Developers – Fork the development version and submit a pull request, especially for any known issues

Where To Get Support Or Report An Issue

There are various resources available, depending on the type of help you’re looking for:

• For getting started and general documentation, please browse, and feel free to contribute to the project wiki.

• For support questions (“How do I”, “I can’t seem to”, etc.) please search and if not already answered, open a thread in the Support Forums.

• For technical issues (e.g., to submit a bug or feature request) please search and if not already filed, open an issue on GitHub.

• For implementation, and all general questions (“Is it possible to..”, “Has anyone…”), please search, and if not already answered, post a topic to the general discussion list serve

Automatic Install

1. Login to your WordPress site as an Administrator, or if you haven’t already, complete the famous WordPress Five Minute Install
2. Navigate to Plugins->Add New from the menu on the left
3. Search for Twitter Mentions as Comments
4. Click “Install”
5. Click “Activate Now”
6. Visit https://dev.twitter.com/apps and create a new Twitter Application
7. Copy your Consumer Key and Consumer Secret into the plugin settings (WP Dashboard -> Settings -> Twitter -> Comments)
8. Click “Save Changes”

Manual Install

1. Download the plugin from the link in the top left corner
2. Unzip the file, and upload the resulting “wp-document-revisions” folder to your “/wp-content/plugins directory” as “/wp-content/plugins/twitter-mentions-as-comments
3. Log into your WordPress install as an administrator, and navigate to the plugins screen from the left-hand menu
4. Activate Twitter Mentions as Comments
5. Visit https://dev.twitter.com/apps and create a new Twitter Application
6. Copy your Consumer Key and Consumer Secret into the plugin settings (WP Dashboard -> Settings -> Twitter -> Comments)
7. Click “Save Changes”

Please see (and feel free to contribute to) the Frequently Asked Questions Wiki.Please see (and feel free to contribute to) the Frequently Asked Questions Wiki.

1.5.6

• Improved compatibility with Twitter API > 1.1, special thanks again to @raamdev (#32)

1.5.5

• Support for Twitter API v1.1, mad, mad props to @raamdev and @s3u
• NOTE: The plugin now requires PHP 5.3 or greater

1.5.4

• PHP 5.4 Compatibility, props @ceyson
• Updated external libraries (Plugin Boilerplate, TLC Transients)
• Minimum WordPress version supported bumped to 3.3 (2 legacy versions)

1.5.3

• Plugin documentation now maintained in a collaboratively edited wiki. Feel free to contribute!
• Created listserv to provide a discussion forum for users and contributors, as well as general annoucements. Feel free to join!
• Fixed bug in deploy script which failed to included required library (TLC-Transients) resulting in fatal error upon upgrade or activation

1.5.2

• Significant performance improvements to front end. Twitter avatars are now retrieved asynchronously (using TLC-Transients), and will update if the commenter’s avatar changes
• Plugin no longer looks for short URLs (e.g., domain.com/?p=100) to prevent issue where Twitter API would not return results in some instances
• Fix for hourly cron not properly registering after upgrade or deactivation and preventing hourly checks from firing
• Fix for manual cron instructions appearing on options page when hourly cron was selected

1.5.1

• Added Spanish translation support, special thanks to Eduardo Larequi.
• Better translation support.
• Fix for invalid argument supplied foreach() error on some installs.
• Fix for hourly cron not always firing on some installs.

1.5

• Codebase completely rewritten with performance, stability, customizability, and documentation improvements
• Additional API hooks added for developers to further customize plugin’s functionality
• Plugin now hosted on GitHub if developers would like to fork and contribute.
• Better internationalization support
• GPL license now distributed with plugin

1.0.4

*** NOTE: you must manually reactivate the plugin after upgrading to this version**
* Fix for bug where the name of authors with previous tweets would display the twitter username multiple times
* Changed name of primary plugin file to conform to traditional plugin format

1.0.3

• Fix for including RTs option toggling opposite behavior of what should be expected (Special thanks Joel Knight for the patch)

1.0.2

• Corrected bug that would prevent scheduled checks from properly firing.

1.0.1

• Improved scheduling of automatic checks

1.0

• Codebase completely re-written from the ground up
• Significant performance improvements by integrating with native WordPress caching class
• Extensive API hooks added for plugin developers to expand and customize functionality
• Debug information removed for performance considerations
• Added support for translations
• Added hideable donate button to the options page
• Moved javascript to a standalone file

0.4.3

• Fixed bug where TMAC debug info would appear on ALL duplicate comment errors

0.4.2

• Added support to check ?p=### formats for some shortened URLs

0.4.1

• Fixed bug where update check would fail if plugin had been upgraded from pre-0.4 version

0.4

• Fixed duplicate comment bug

0.3

• Fixed bug where Tweet ID was not being properly stored
• Added ability to run check manually based on cron job
• Better API throttling with feedback when limit reached

0.2

• Now relies solely on the public Twitter API, no API keys needed
• Ability to specify type of comment (Pingback/Trackback/Comment)
• Ability to specify which posts to check (e.g., 10 most recent posts, all posts, front page)
• Better caching of Twitter user’s real names
• Better caching of last checked ID (when no mentions were found)
• More descriptive feedback on options page for manual refreshes (# of Mentions found)
• API call throttling
• Fallback capability to use only Twitter handle as name if Twitter API limit is reached

0.1

• Initial release