Storm Consultancy

Liam Gladdy

A Twitter API 1.1 compliant wordpress plugin that provides an array of a users timeline from Twitter for use by theme developers.
The new Twitter API requires you be oAuth’d before you can request a list of tweets, this means that all of the existing Twitter plugins that simply make an AJAX request for to the JSON API endpoint broke in March 2013.
This wass a major problem for the vast majority of websites that are currently using twitter, so we built a PHP class that implements all the new requirements for authentication and gives you an array of tweets out of the other end, for you to use in your PHP applications, or WordPress theme. You can find the stand-alone <a href="https://github.com/stormuk/storm-twitter" rel="nofollow ugc">StormTwitter</a> class on GitHub
This plugin wraps our Twitter class and provides a settings screen for easy integration into WordPress. However, it’s definitely for developers – you only get a PHP array out of it that contains Twitter tweet objects. You’ll still need to style the output and make it comply with the new display requirements.
This plugin does not provide sidebar widgets, shortcodes or any other form of drop-in functionality. You still need to do the styling, we’ve just done the heavy lifting for you!
Here’s some example code for outputting the tweets in HTML:
https://github.com/stormuk/storm-twitter-for-wordpress/wiki/Example-code-to-layout-tweets
<h3>Credits</h3>
Uses Abraham Williams’s Twitter OAuth class.
<h3>About</h3>
Version: 2.3.0
Written by Liam Gladdy of Storm Consultancy – <a href="http://www.stormconsultancy.co.uk" rel="nofollow ugc">http://www.stormconsultancy.co.uk</a>
Storm Consultancy are a web design and development agency based in Bath, UK.
If you are looking for a <a href="http://www.stormconsultancy.co.uk" rel="nofollow ugc">Bath WordPress Developer</a>, then <a href="http://www.stormconsultancy.co.uk/contact" rel="nofollow ugc">get in touch</a>!
<h3>License</h3>
Copyright (c) 2016 Liam Gladdy and Storm Consultancy (EU) Ltd, 
<a href="https://gladdy.uk/" rel="nofollow ugc">https://gladdy.uk/</a>, <a href="http://www.stormconsultancy.co.uk/" rel="nofollow ugc">http://www.stormconsultancy.co.uk/</a>
Permission is hereby granted, free of charge, to any person obtaining 
a copy of this software and associated documentation files (the 
“Software”), to deal in the Software without restriction, including 
without limitation the rights to use, copy, modify, merge, publish, 
distribute, sublicense, and/or sell copies of the Software, and to 
permit persons to whom the Software is furnished to do so, subject to 
the following conditions:
The above copyright notice and this permission notice shall be 
included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, 
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND 
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE 
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION 
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION 
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

oAuth Twitter Feed for Developers

For a developer, this is the best twitter plugin out there. Nice and simple. Very flexible. The correct solution.



The best way to connect to twitter.

Twitter API 1.1 compliant plugin that provides a function to get an array of tweets from the auth'd users Twitter feed for use in themes.

fossasia

Use anonymous Loklak API OR Connect your Twitter account to this plugin and the widget will display your latest tweets on your site.
This plugin is compatible with the new Twitter API 1.1 and provides full OAuth authentication via the WordPress admin area.
<h3>Shortcodes</h3>
You can embed tweets in the body of your posts using a WordPress the shortcode <code>[tweets]</code>.
To specify a different user’s timeline add the <code>user</code> attribute. 
To override the default number of 5 tweets add the <code>max</code> attribute, e.g:
<pre><code>[tweets max=10 user=KhoslaSopan]<h3>Theming</h3>
</code></pre>
For starters you can alter some of the HTML using built-in WordPress features. 
See <a href="https://codex.wordpress.org/Plugin_API/Filter_Reference#Widgets" rel="nofollow ugc">Widget Filters</a> 
and <a href="https://codex.wordpress.org/Widgetizing_Themes" rel="nofollow ugc">Widgetizing Themes</a>
CSS
This plugin contains no default CSS. That’s deliberate, so you can style it how you want.
Tweets are rendered as a list which has various hooks you can use. Here’s a rough template:
<pre><code>.tweets {
 /* style tweet list wrapper */
}
.tweets h3 {
 /* style whatever you did with the header */
}
.tweets ul { 
 /* style tweet list*/
}
.tweets li {
 /* style tweet item */
}
.tweets .tweet-text {
 /* style main tweet text */
}
.tweets .tweet-text a {
 /* style links, hashtags and mentions */
}
.tweets .tweet-text .emoji {
 /* style embedded emoji image in tweet */ 
}
.tweets .tweet-details {
 /* style datetime and link under tweet */
}
</code></pre>
Custom HTML
If you want to override the default markup of the tweets, the following filters are also available:
<ul>
<li>Add a header between the widget title and the tweets with <code>tweets_render_before</code></li>
<li>Perform your own rendering of the timestamp with <code>tweets_render_date</code></li>
<li>Render plain tweet text to your own HTML with <code>tweets_render_text</code></li>
<li>Render each composite tweet with <code>tweets_render_tweet</code></li>
<li>Override the unordered list for tweets with <code>tweets_render_list</code> </li>
<li>Add a footer before the end of the widget with <code>tweets_render_after</code></li>
</ul>
Here’s an example of using some of the above in your theme’s functions.php file:
<pre><code>add_filter('tweets_render_date', function( $created_at ){
 $date = DateTime::createFromFormat('D M d H:i:s O Y', $created_at );
 return $date->format('d M h:ia');
}, 10 , 1 );

add_filter('tweets_render_text', function( $text ){
 return $text; // <- will use default
}, 10 , 1 );

add_filter('tweets_render_tweet', function( $html, $date, $link, array $tweet ){
 $pic = $tweet['user']['profile_image_url_https'];
 return '<img src="'.$pic.'"/>'.$html.'<a href="'.$link.'">'.$date.'</a>';
}, 10, 4 );

add_filter('tweets_render_after', function(){
 return '<footer><a href="https://twitter.com/me">More from me</a></footer>';
}, 10, 0 );<h3>Caching</h3>
</code></pre>
Responses from the Twitter API are cached for 5 minutes by default. This means your new Tweets will not appear on your site in real time.
This is deliberate not only for performance, but also to avoid Twitter’s strict rate limits of 15 requests every 15 minutes.
You can override the 300 second cache by using the <code>tweets_cache_seconds</code> filter in your theme as follows:
This would extend the cache to 1 minute, which is the lowest value you should consider using on a live site:
<pre><code>add_filter('tweets_cache_seconds', function( $ttl ){
 return 60;
}, 10, 1 );
</code></pre>
This would disable the cache (not recommended other than for debugging):
<pre><code>add_filter('tweets_cache_seconds', function( $ttl ){
 return 0;
}, 10, 1 );<h3>Emoji</h3>
</code></pre>
If you want to disable Emoji image replacement, you can filter the replacement callback function to something empty, e.g:
<pre><code>add_filter('tweets_emoji_callback', function( $func ){
 return '';
} );
</code></pre>
<ul>
<li>
or to strip Emoji characters from all tweets, return your own replacement function that returns something else, e.g:
add_filter(‘tweets_emoji_callback’, function( $func ){ 
 return function( array $match ){ 
 return ‘‘; 
 }; 
} );
<h3>Credits</h3>
Screenshot taken with permission from http://stayingalivefoundation.org/blog
</li>
<li>
Portuguese translations by <a href="https://wordpress.org/support/profile/leandrodimitrio" rel="ugc">Leandro Dimitrio</a>
</li>
<li>German translations by <a href="https://twitter.com/FlorianFelsing" rel="nofollow ugc">Florian Felsing</a> and <a href="https://wordpress.org/support/profile/david_noh" rel="ugc">David Noh</a></li>
<li>Russian translations by <a href="https://twitter.com/YakovenkoAndrey" rel="nofollow ugc">Andrey Yakovenko</a></li>
<li>Dutch translations by <a href="https://twitter.com/dwichers" rel="nofollow ugc">Daniel Wichers</a></li>
<li>Spanish translations by <a href="http://minimizo.com" rel="nofollow ugc">Pedro Pica</a></li>
</ul>
<h3>Notes</h3>
Be aware of <a href="https://dev.twitter.com/terms/display-requirements" rel="nofollow ugc">Twitter’s display requirements</a> when rendering tweets on your website.
Example code here uses PHP <a href="http://www.php.net/manual/en/class.closure.php" rel="nofollow ugc">closures</a> which require PHP>=5.3.0 and won’t work on older systems.

Tweets Widget

Tweets Widget compatible with the new Twitter API 1.1

oAuth Twitter Feed for Developers vs Tweets Widget