[{"name":"Tweets Widget","slug":"tweets-widget","version":"1.0","author":"fossasia","author_profile":"https://profiles.wordpress.org/fossasia/","requires":"3.5.1","tested":"4.5.32","requires_php":false,"requires_plugins":[],"rating":100,"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"downloaded":1428,"last_updated":"2016-08-29 1:28pm GMT","added":"2016-08-27","homepage":"http://wordpress.org/extend/plugins/tweets-widget/","sections":{"description":"

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.

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.
\nTo override the default number of 5 tweets add the max attribute, e.g:

[tweets max=10 user=KhoslaSopan]<h3>Theming</h3>\n

For starters you can alter some of the HTML using built-in WordPress features.
\nSee Widget Filters
\nand 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:

.tweets {\n    /* style tweet list wrapper */\n}\n.tweets h3 {\n    /* style whatever you did with the header */\n}\n.tweets ul { \n    /* style tweet list*/\n}\n.tweets li {\n   /* style tweet item */\n}\n.tweets .tweet-text {\n   /* style main tweet text */\n}\n.tweets .tweet-text a {\n   /* style links, hashtags and mentions */\n}\n.tweets .tweet-text .emoji {\n  /* style embedded emoji image in tweet */ \n}\n.tweets .tweet-details {\n  /* style datetime and link under tweet */\n}\n

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

Here’s an example of using some of the above in your theme’s functions.php file:

add_filter('tweets_render_date', function( $created_at ){\n    $date = DateTime::createFromFormat('D M d H:i:s O Y', $created_at );\n    return $date->format('d M h:ia');\n}, 10 , 1 );\n\nadd_filter('tweets_render_text', function( $text ){\n    return $text; // <- will use default\n}, 10 , 1 );\n\nadd_filter('tweets_render_tweet', function( $html, $date, $link, array $tweet ){\n    $pic = $tweet['user']['profile_image_url_https'];\n    return '<p class=\"my-tweet\"><img src=\"'.$pic.'\"/>'.$html.'</p><p class=\"my-date\"><a href=\"'.$link.'\">'.$date.'</a></p>';\n}, 10, 4 );\n\nadd_filter('tweets_render_after', function(){\n    return '<footer><a href=\"https://twitter.com/me\">More from me</a></footer>';\n}, 10, 0 );<h3>Caching</h3>\n

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 ){\n    return 60;\n}, 10, 1 );\n

This would disable the cache (not recommended other than for debugging):

add_filter('tweets_cache_seconds', function( $ttl ){\n    return 0;\n}, 10, 1 );<h3>Emoji</h3>\n

If you want to disable Emoji image replacement, you can filter the replacement callback function to something empty, e.g:

add_filter('tweets_emoji_callback', function( $func ){\n    return '';\n} );\n

\n
or to strip Emoji characters from all tweets, return your own replacement function that returns something else, e.g:
\n
add_filter(‘tweets_emoji_callback’, function( $func ){
\n return function( array $match ){
\n return ‘‘;
\n };
\n} );
\n
Credits
\n
Screenshot taken with permission from http://stayingalivefoundation.org/blog
\n
\n
Portuguese translations by Leandro Dimitrio
\n
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.

Example code here uses PHP closures which require PHP>=5.3.0 and won’t work on older systems.

\n","installation":"

Unzip all files to the /wp-content/plugins/ directory
Log into WordPress admin and activate the ‘Tweets’ plugin through the ‘Plugins’ menu

Once the plugin is installed and enabled you can use Loklak API or bind your plugin to a Twitter account as follows:

Use Loklak API

Tick the ‘Loklak API’ checkbox in API authentication settings.
Click on ‘Save settings’

Use Twitter 1.1 API

Register a Twitter application at https://dev.twitter.com/apps
Note the Consumer key and Consumer secret under OAuth settings
Log into WordPress admin and go to Settings > Twitter API
Enter the consumer key and secret and click ‘Save settings’
Click the ‘Connect to Twitter’ button and follow the prompts.

Once your site is authenticated you can configure the widget as follows:

Log into WordPress admin and go to Appearance > Widgets
Drag ‘Tweets’ from ‘Available widgets’ to where you want it. e.g. Main Sidebar
Optionally configure the widget title and number of tweets to display.

\n","faq":"\n

How can I style the widget?

See the ‘Other Notes’ tab for theming information.

Do I have to register my own Twitter app?

Yes, if you want to use Twitter’s new API 1.1 . If you decide to use loklak.org’s anonymous API then no need. More info in the ‘Description’ tab.

How I do know what my Twitter OAuth settings are?

These details are available in the Twitter dashboard

What do I put in the third and fourth fields?

Once you’ve populated the first two fields, just click the Connect button and follow the prompts.

What is the “Minimum popularity” field?

Here you can specify a number of retweets and favourites that a tweet must have before it’s displayed.
\nThis is useful for only showing your most interesting content.

How can I prevent SSL certificate errors?

If you’re unable too fix your PHP cURL installation, you can disable SSL verification of twitter.com by adding this to your theme functions.php:
\n add_filter(‘https_ssl_verify’, ‘__return_false’);
\nBut, please do so at your own risk.

\n\n","changelog":"

1.0.1

Fixes FAQs
Fixes minor URL bugs

1.0

A whole new version!

\n","screenshots":"

$\"Tweets$
Tweets rendered via Loklak API
$\"Admin$
Admin screen shows Loklak and Twitter API connect button and OAuth settings
$\"Widget$
Widget screen shows feed options

"},"short_description":"Tweets Widget compatible with the new Twitter API 1.1","download_link":"https://downloads.wordpress.org/plugin/tweets-widget.1.0.1.zip","screenshots":{"1":{"src":"https://ps.w.org/tweets-widget/assets/screenshot-1.png?rev=1484619","caption":"Tweets rendered via Loklak API"},"2":{"src":"https://ps.w.org/tweets-widget/assets/screenshot-2.png?rev=1484619","caption":"Admin screen shows Loklak and Twitter API connect button and OAuth settings"},"3":{"src":"https://ps.w.org/tweets-widget/assets/screenshot-3.png?rev=1484619","caption":"Widget screen shows feed options"}},"tags":{"loklak":"loklak","loklak-api":"loklak api","oauth":"oauth","tweets":"tweets","twitter":"twitter"},"versions":{"1.0":"https://downloads.wordpress.org/plugin/tweets-widget.1.0.zip","1.0.1":"https://downloads.wordpress.org/plugin/tweets-widget.1.0.1.zip","trunk":"https://downloads.wordpress.org/plugin/tweets-widget.zip"},"donate_link":"","icons":{"default":"https://s.w.org/plugins/geopattern-icon/tweets-widget.svg"}},{"name":"Recent Tweet","slug":"recent-tweet","version":"1.0","author":"FOSSASIA","author_profile":"https://profiles.wordpress.org/fossasia/","requires":"3.4.1","tested":"4.5.32","requires_php":false,"requires_plugins":[],"rating":0,"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"downloaded":937,"last_updated":"2016-08-26 3:00am GMT","added":"2016-08-25","homepage":"http://wordpress.org/extend/plugins/recent-tweet/","sections":{"description":"

Recent Tweet plugin for anonymous Loklak API and Twitter API v1.1 with Cache. It supports the new Twitter API v1.1 and stores tweets in the cache. It means that it will read status messages from your database and it doesn’t query loklak.org or Twitter.com for every page load so you won’t be rate limited. You can set how often you want to update the cache.

\n","installation":"

Unzip the downloaded zip file.
Upload the recent-tweet folder and its contents into the wp-content/plugins/ directory of your WordPress installation
Activate Recent Tweet widget from Plugins page.
Go to your Widgets menu, add * Recent Tweet widget to a widget area.
Tick the checkbox to use Loklak API
\nOR
\nVisit https://apps.twitter.com/ in a new tab, sign in with your account, click on Create a new application and create your own keys if you haven’t already.
Fill all your widget settings.
Enjoy your new Tweet feed! 🙂

\n","faq":"\n

Why should I use Loklak API?

API from loklak.org is anonymous and does not require any registration. It provides twitter like experience without the cumbersome Twitter App Registration issues.

How can I get Consumer Key, Consumer Secret, Access Token and Access Token Secret?

You will need to visit https://apps.twitter.com/, sign in with your account and create your own keys.

\n\n","changelog":"

1.0

The first version of this plugin! Enjoy! 🙂

\n","screenshots":"

$\"The$
The widget
$\"How$
How it looks on frontend page

"},"short_description":"Recent Tweet plugin for anonymous Loklak API and new Twitter API v1.1 with CACHE, so you won't be rate limited!","download_link":"https://downloads.wordpress.org/plugin/recent-tweet.zip","screenshots":{"1":{"src":"https://ps.w.org/recent-tweet/assets/screenshot-1.png?rev=1498942","caption":"The widget"},"2":{"src":"https://ps.w.org/recent-tweet/assets/screenshot-2.png?rev=1498942","caption":"How it looks on frontend page"}},"tags":{"loklak":"loklak","loklak-api":"loklak api","loklak-widget":"loklak widget","recent-tweets":"recent tweets","twitter-widget":"twitter widget"},"versions":[],"donate_link":"","icons":{"1x":"https://ps.w.org/recent-tweet/assets/icon-128x128.png?rev=1498942","2x":"https://ps.w.org/recent-tweet/assets/icon-256x256.png?rev=1498942"}}]

Shortcodes

Credits

Notes

How can I style the widget?

Do I have to register my own Twitter app?

How I do know what my Twitter OAuth settings are?

What do I put in the third and fourth fields?

What is the “Minimum popularity” field?

How can I prevent SSL certificate errors?

1.0.1

1.0

Why should I use Loklak API?

How can I get Consumer Key, Consumer Secret, Access Token and Access Token Secret?

1.0

loklak widget

Tweets Widget

Recent Tweet

Get New Themes & Resources