azanelli

aboutnick

Netgloo

<p>This plugin will add the PHP class <code>GetTweetsInPhp</code>. You can use this class as described below for retrieving <strong>latest tweets</strong> from a Twitter account, then handle the tweets as you want in your PHP code.</p>
<p><strong>Note</strong>: you should create a Twitter app before using this plugin. You can do it from here: <a href="http://apps.twitter.com" rel="nofollow ugc">http://apps.twitter.com</a>.</p>
<h4>Features</h4>
<ul>
<li>Get latest N tweets from a Twitter account.</li>
<li>Get the tweet’s text formatted as HTML (with links for each entities).</li>
<li>Cache support.</li>
<li>Made for developers.</li>
<li>Really light and simple.</li>
<li>Works with the v1.1 Twitter API.</li>
<li>Trivial install/uninstall (only add/remove the plugin’s files).</li>
<li>No any data will be permanently stored in your database (only transient data<br />
if the cache is enabled).</li>
<li>Proudly coded by <a href="http://netgloo.com/en" rel="nofollow ugc">Netgloo</a>.</li>
</ul>
<h4>Example usage</h4>
<p>Get and show latest tweets from <a href="http://twitter.com/netglooweb" rel="nofollow ugc">@netglooweb</a>:</p>
<pre><code>// 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 "<p>";
  echo $tweet->n_html_text;

  if ($tweet->n_has_media_photo) {
    echo "<img src='{$tweet->n_media_photo_url}' width='100%' />";
  }

  echo "</p>";

}

// ...
</code></pre>
<p>That’s all! Have fun!</p>
<h4>Configurations</h4>
<p>The <code>get_tweets()</code> function takes an array of configurations:</p>
<pre><code>$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' => 
    '<em> Retweeted by {{user_name}}</em>',

  // Hash tag link template
  'hashtag_link_template' => 
    '<a href="{{hashtag_link}}" rel="nofollow" target="_blank">' .
    '#{{hashtag_text}}</a>',

  // Url link template
  'url_link_template' => 
    '<a href="{{url_link}}" rel="nofollow" target="_blank" ' .
    'title="{{url_title}}">{{url_text}}</a>',

  // User mention link template
  'user_mention_link_template' => 
    '<a href="{{user_mention_link}}" rel="nofollow" target="_blank" ' .
    'title="{{user_mention_title}}">@{{user_mention_text}}</a>',

  // Media link template
  'media_link_template' => 
    '<a href="{{media_link}}" rel="nofollow" target="_blank" ' .
    'title="{{media_title}}">{{media_text}}</a>'

];

$tweets = \Netgloo\GetTweetsInPhp::get_tweets($configs);
</code></pre>
<h4>Returned values</h4>
<p>The <code>get_tweets()</code> function will return an Array of tweets. On each tweet object are available these properties:</p>
<ul>
<li><code>n_html_text</code> (String) The tweet text formatted as HTML, with links on each entities.</li>
<li><code>n_is_retweeted</code> (Boolean) True if the curret tweet is a retweet.</li>
<li><code>n_has_media_photo</code> (Boolean) True if the current tweet has an attached photo.</li>
<li><code>n_media_photo_url</code> (String) The url of the tweet’s attached photo.</li>
<li><code>n_media_photo_urls</code> (Array) If the tweet has more than one attached photos this properties contains all the urls.</li>
</ul>
<p>Other available properties are those returned from the <a href="https://dev.twitter.com/rest/reference/get/statuses/user_timeline" rel="nofollow ugc">user_timeline Twitter’s API</a>.<br />
These are some useful ones:</p>
<ul>
<li><code>created_at</code></li>
<li><code>retweet_count</code></li>
<li><code>user->name</code></li>
<li><code>user->screen_name</code></li>
<li><code>user->profile_image_url</code></li>
</ul>
<p>If the properties <code>n_is_retweeted</code> is true the current tweet is a “re-tweet” and the <code>retweeted_status</code> object is available:</p>
<ul>
<li><code>retweeted_status->user->name</code></li>
<li><code>retweeted_status->user->screen_name</code></li>
<li><code>retweeted_status->retweet_count</code></li>
</ul>
<p><strong>Example</strong></p>
<p>This code use some of the above properties:</p>
<pre><code>// ...

$tweets = \Netgloo\GetTweetsInPhp::get_tweets($configs);

foreach ($tweets as $tweet) {
  echo $tweet->created_at . "<br/>";
  echo $tweet->n_html_text . "<br/>";
  if ($tweet->n_has_media_photo) {
    echo $tweet->n_media_photo_url  . "<br/>";
  }
}

// ...
</code></pre>
<h4>Limitations</h4>
<p>Since we rely on the Twitter’s <code>user_timeline</code> API, you should read the following docs for taking in account any API’s limitation:</p>
<ul>
<li>https://dev.twitter.com/rest/reference/get/statuses/user_timeline</li>
<li>https://dev.twitter.com/rest/public/timelines</li>
</ul>
<h4>Contributing</h4>
<p>For patches, bug reports, suggestions, requests for features there is a Git repository on GitHub here:<br />
https://github.com/netgloo/get-tweets-in-php</p>


Get Tweets in PHP

Get latest tweets from a Twitter account with a couple of lines of PHP, and do anything you want with them.

AdrianApan

<p>A wordpress plugin which will allow you to show the latest tweets about a certain word or phrase in a draggable and resizable jQuery tooltip window.</p>


Latest Tweets Tooltip

A wordpress plugin which will allow you to show the latest tweets about a certain word or phrase in a draggable and resizable jQuery tooltip window.

Get Tweets in PHP vs Latest Tweets Tooltip