Title: Get Tweets in PHP Author: azanelli Published: August 24, 2015 Last modified: December 28, 2016 --- Search plugins ![](https://ps.w.org/get-tweets-in-php/assets/banner-772x250.png?rev=1240948) This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://ps.w.org/get-tweets-in-php/assets/icon.svg?rev=1240948) # Get Tweets in PHP By [azanelli](https://profiles.wordpress.org/azanelli/) [Download](https://downloads.wordpress.org/plugin/get-tweets-in-php.1.2.zip) * [Details](https://tzm.wordpress.org/plugins/get-tweets-in-php/#description) * [Reviews](https://tzm.wordpress.org/plugins/get-tweets-in-php/#reviews) * [Installation](https://tzm.wordpress.org/plugins/get-tweets-in-php/#installation) * [Development](https://tzm.wordpress.org/plugins/get-tweets-in-php/#developers) [Support](https://wordpress.org/support/plugin/get-tweets-in-php/) ## Description This plugin will add the PHP class `GetTweetsInPhp`. You can use this class as described below for retrieving **latest tweets** from a Twitter account, then handle the tweets as you want in your PHP code. **Note**: you should create a Twitter app before using this plugin. You can do it from here: [http://apps.twitter.com](http://apps.twitter.com). #### Features * Get latest N tweets from a Twitter account. * Get the tweet’s text formatted as HTML (with links for each entities). * Cache support. * Made for developers. * Really light and simple. * Works with the v1.1 Twitter API. * Trivial install/uninstall (only add/remove the plugin’s files). * No any data will be permanently stored in your database (only transient data if the cache is enabled). * Proudly coded by [Netgloo](http://netgloo.com/en). #### Example usage Get and show latest tweets from [@netglooweb](http://twitter.com/netglooweb): ``` // Set configurations $configs = [ // Set here tokens from your Twitter's app 'consumer_key' => 'CONSUMER_KEY', 'consumer_secret' => 'CONSUMER_SECRET', // The Twitter account name 'screen_name' => 'netglooweb', // The number of tweets 'count' => 5, ]; // Get latest tweets using the function get_tweets $tweets = \Netgloo\GetTweetsInPhp::get_tweets($configs); // ... // For each tweet show the HTML text and the attached image foreach ($tweets as $tweet) { echo "

"; echo $tweet->n_html_text; if ($tweet->n_has_media_photo) { echo ""; } echo "

"; } // ... ``` That’s all! Have fun! #### Configurations The `get_tweets()` function takes an array of configurations: ``` $configs = [ // --- Required --- // The tokens from your Twitter's app 'consumer_key' => '...', 'consumer_secret' => '...', // The Twitter account name 'screen_name' => '...', // --- Optional --- // The number of tweets 'count' => 20, // Include also the retweets 'include_rts' => true, // In the HTML text will be showed "Retweeted by ..." if the tweet // is a retweet 'show_retweeted_by' => true, // Enable the cache // It is recommended to activate the cache, when you put live // your website, in order to avoid to reach the Twitter's api rate // limit of 300 requests / 15-min. 'cache_enabled' => false, // Cache expiration (in seconds) // Increase the value to optimize the website's speed, decrease // the value if you want a more real-time behaviour (but not // less than 4 seconds to avoid to reach the rate limit). 'cache_expiration' => 60, // Templates // Retweeted by text template 'retweeted_by_template' => ' Retweeted by {{user_name}}', // Hash tag link template 'hashtag_link_template' => '' . '#{{hashtag_text}}', // Url link template 'url_link_template' => '{{url_text}}', // User mention link template 'user_mention_link_template' => '@{{user_mention_text}}', // Media link template 'media_link_template' => '{{media_text}}' ]; $tweets = \Netgloo\GetTweetsInPhp::get_tweets($configs); ``` #### Returned values The `get_tweets()` function will return an Array of tweets. On each tweet object are available these properties: * `n_html_text` (String) The tweet text formatted as HTML, with links on each entities. * `n_is_retweeted` (Boolean) True if the curret tweet is a retweet. * `n_has_media_photo` (Boolean) True if the current tweet has an attached photo. * `n_media_photo_url` (String) The url of the tweet’s attached photo. * `n_media_photo_urls` (Array) If the tweet has more than one attached photos this properties contains all the urls. Other available properties are those returned from the [user_timeline Twitter’s API](https://dev.twitter.com/rest/reference/get/statuses/user_timeline). These are some useful ones: * `created_at` * `retweet_count` * `user->name` * `user->screen_name` * `user->profile_image_url` If the properties `n_is_retweeted` is true the current tweet is a “re-tweet” and the `retweeted_status` object is available: * `retweeted_status->user->name` * `retweeted_status->user->screen_name` * `retweeted_status->retweet_count` **Example** This code use some of the above properties: ``` // ... $tweets = \Netgloo\GetTweetsInPhp::get_tweets($configs); foreach ($tweets as $tweet) { echo $tweet->created_at . "
"; echo $tweet->n_html_text . "
"; if ($tweet->n_has_media_photo) { echo $tweet->n_media_photo_url . "
"; } } // ... ``` #### Limitations Since we rely on the Twitter’s `user_timeline` API, you should read the following docs for taking in account any API’s limitation: * https://dev.twitter.com/rest/reference/get/statuses/user_timeline * https://dev.twitter.com/rest/public/timelines #### Contributing For patches, bug reports, suggestions, requests for features there is a Git repository on GitHub here: https://github.com/netgloo/get-tweets-in-php ## Installation #### Requirements To work this plugin, following component need to be installed in your server. * PHP version 5.3 or higher * cURL * WordPress 4.2.2 or higher #### Install Put the plugin to your WordPress’ plugins folder and activate it from the Admin Backend. #### Uninstall Just delete the plugin from WordPress. ## FAQ Why the “n” before your custom tweet’s properties? Our custom properties (i.e. properties not from the Twitter’s API) are prefixed with an “n”. The “n” is the first character in “Netgloo” ;). ## Reviews ![](https://secure.gravatar.com/avatar/15829714ade181f443b5babbcfd2f8634d06590561563a123f796b592ab3d0fc? s=60&d=retro&r=g) ### 󠀁[Awesome!](https://wordpress.org/support/topic/awesome-4691/)󠁿 [gmanfredi](https://profiles.wordpress.org/gmanfredi/) June 7, 2017 Awesome! [ Read all 2 reviews ](https://wordpress.org/support/plugin/get-tweets-in-php/reviews/) ## Contributors & Developers “Get Tweets in PHP” is open source software. The following people have contributed to this plugin. Contributors * [ azanelli ](https://profiles.wordpress.org/azanelli/) * [ Netgloo ](https://profiles.wordpress.org/netgloo/) * [ aboutnick ](https://profiles.wordpress.org/aboutnick/) [Translate “Get Tweets in PHP” into your language.](https://translate.wordpress.org/projects/wp-plugins/get-tweets-in-php) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/get-tweets-in-php/), check out the [SVN repository](https://plugins.svn.wordpress.org/get-tweets-in-php/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/get-tweets-in-php/) by [RSS](https://plugins.trac.wordpress.org/log/get-tweets-in-php/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.2 * Custom HTML templates for links and “retweeted by” text. * New hashtag link: https://twitter.com/hashtag. * Get media urls with https. * Cache disabled by default (as in the documentation). #### 1.1 * Bug fix setting transient cache name. #### 1.0 * First release. ## Meta * Version **1.2** * Last updated **9 ⵉⵙⴳⴳⵯⴰⵙⵏ ago** * Active installations **60+** * WordPress version ** 4.0 or higher ** * Tested up to **4.7.33** * Language * [English (US)](https://wordpress.org/plugins/get-tweets-in-php/) * Tags * [developers](https://tzm.wordpress.org/plugins/tags/developers/)[latest tweets](https://tzm.wordpress.org/plugins/tags/latest-tweets/) [tweet](https://tzm.wordpress.org/plugins/tags/tweet/)[tweets](https://tzm.wordpress.org/plugins/tags/tweets/) [twitter](https://tzm.wordpress.org/plugins/tags/twitter/) * [Advanced View](https://tzm.wordpress.org/plugins/get-tweets-in-php/advanced/) ## Ratings 5 out of 5 stars. * [ 2 5-star reviews ](https://wordpress.org/support/plugin/get-tweets-in-php/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/get-tweets-in-php/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/get-tweets-in-php/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/get-tweets-in-php/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/get-tweets-in-php/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/get-tweets-in-php/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/get-tweets-in-php/reviews/) ## Contributors * [ azanelli ](https://profiles.wordpress.org/azanelli/) * [ Netgloo ](https://profiles.wordpress.org/netgloo/) * [ aboutnick ](https://profiles.wordpress.org/aboutnick/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/get-tweets-in-php/)