About this plugin
Use anonymous Loklak API OR Connect your Twitter account to this plugin and the widget will display your latest tweets on your site.
1 and provides full OAuth authentication via the WordPress admin area.
Shortcodes
You can embed tweets in the body of your posts using a WordPress the shortcode [tweets].
To specify a different user’s timeline add the user attribute.
g:
[tweets max=10 user=KhoslaSopan]<h3>Theming</h3>
For starters you can alter some of the HTML using built-in WordPress features.
See Widget Filters
and Widgetizing Themes
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:
tweet-details { /* style datetime and link under tweet */ }
Custom HTML
If you want to override the default markup of the tweets, the following filters are also available:
- Add a header between the widget title and the tweets with tweets_render_before
- Perform your own rendering of the timestamp with tweets_render_date
- Render plain tweet text to your own HTML with tweets_render_text
- Render each composite tweet with tweets_render_tweet
- Override the unordered list for tweets with tweets_render_list
- Add a footer before the end of the widget with tweets_render_after
php file:
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 );
'</a></p>'; }, 10, 4 );
com/me">More from me</a></footer>'; }, 10, 0 );<h3>Caching</h3>
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 tweets_cache_seconds 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:
add_filter('tweets_cache_seconds', function( $ttl ){ return 60; }, 10, 1 );
This would disable the cache (not recommended other than for debugging):
add_filter('tweets_cache_seconds', function( $ttl ){ return 0; }, 10, 1 );<h3>Emoji</h3>
g:
add_filter('tweets_emoji_callback', function( $func ){ return ''; } );
-
g:
add_filter(‘tweets_emoji_callback’, function( $func ){
return function( array $match ){
return ‘ ‘;
};
} );
Credits
org/blog
-
Portuguese translations by Leandro Dimitrio
- German translations by Florian Felsing and David Noh
- Russian translations by Andrey Yakovenko
- Dutch translations by Daniel Wichers
- Spanish translations by Pedro Pica
Notes
Be aware of Twitter’s display requirements when rendering tweets on your website.
0 and won’t work on older systems.