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.

Peter Booker

<p>Hassle-free and user-friendly way to add a Twitter Feed to your website. Get started in just a few clicks without the need to setup your own Twitter App. Use the provided Widget or Shortcode to easily display your Tweets on your website.</p>
<h4>Why use Kebo Twitter Feed?</h4>
<ul>
<li>Get started in just a few clicks. No setting up your own Twitter App.</li>
<li>Fits seamlessly with your current site design.</li>
<li>Friendly and active support.</li>
<li>Compatible with any WordPress hosting.</li>
<li>WordPress Multisite compatible.</li>
<li>Refreshes Tweets in the background, never impacts pageload.</li>
<li>Translation ready (see below for included languages).</li>
</ul>
<p>Other solutions usually require you to create a Twitter App and provide the plugin with oAuth credentials yourself. We don’t believe it should be that hard, and with our plugin you can get the Tweets displayed on your website with just a few clicks.</p>
<p>We make this so easy by managing all the complex oAuth requests on our own server using our Twitter app. Our app only asks for read permission and we only ever request publically available information. Your data is never stored on our system and you can read more about how we treat your information in our <a href="http://kebopowered.com/privacy-policy/#social-connections" title="Kebo Privacy Policy" rel="nofollow ugc">privacy policy</a>.</p>
<h4>Main Features</h4>
<ul>
<li>Hassle-free setup (no creating a Twitter App).</li>
<li>Easily display Tweets with a Widget or Shortcode.</li>
<li>Choose to show a profile image, attached media and much more with your Tweets.</li>
<li>Advanced Caching, so that we never impact pageload speed.</li>
<li>Local cache backup, in case the connection to Twitter has problems.</li>
</ul>
<h4>Included Translations</h4>
<ul>
<li>German by <a href="https://twitter.com/pixolin" rel="nofollow ugc">Bego Mario Garde</a>.</li>
<li>Russian by <a href="http://newdel.net" rel="nofollow ugc">Stas Newdel</a>.</li>
<li>Italian by <a href="http://ramacciotti.altervista.org" rel="nofollow ugc">Alberto Ramacciotti</a>.</li>
<li>Dutch by <a href="http://restaurantthemes101.com" rel="nofollow ugc">Renee Klein</a>.</li>
<li>English (British) by <a href="https://kebopowered.com" rel="nofollow ugc">Peter Booker</a>.</li>
<li>Swedish by <a href="https://www.facebook.com/johannakitzmanphotography" rel="nofollow ugc">Johanna Kitzman</a>.</li>
<li>Serbian by <a href="http://www.webhostinghub.com/" rel="nofollow ugc">Borisa Djuraskovic</a>.</li>
<li>Spanish by <a href="http://escueladebaileelalmacen.com/" rel="nofollow ugc">Javier Sanz</a>.</li>
</ul>
<h4>Rate Us / Feedback</h4>
<p>Please take the time to let us and others know about your experiences by leaving a review. If your use of our plugin has not been a five star experience we would like to understand why, so that we can improve the plugin for you and other users.</p>
<h3>Styling the Widget</h3>
<p>We use the the inbuilt methods to output the Widget and Title containers so that it should fit seamlessly into your website.</p>
<p>If you want to style the inside of the Widget below is the HTML structure:</p>
<pre><code><ul class="kebo-tweets">

    <li class="ktweet">

        <div class="kmeta">
            <a class="kaccount"></a>
            <a class="kdate"></a>
        </div>

        <p class="ktext">
            <a><img class="kavatar" /></a>
        </p>

        <div class="kfooter">
            <a class="ktogglemedia"></a>
            <a class="kreply"></a>
            <a class="kretweet"></a>
            <a class="kfavourite"></a>
        </div>

        <div class="kmedia">
            <a><img /></a>
        </div>

    </li>

</ul>
</code></pre>
<p>The slider has one significant change which is that the containing unordered list has an ID of ‘kebo-tweet-slider’.</p>
<h3>Developers Notes</h3>
<p>You can directly access the object containing all the Tweets like this:</p>
<pre><code><?php $tweets = kebo_twitter_get_tweets(); ?>
</code></pre>
<p>This function checks the cache and refreshes the data if needed. Then returns the object containing all the Tweets. Below is an example of how you might use the data:</p>
<pre><code><?php $tweets = kebo_twitter_get_tweets(); ?>

<?php $i = 0; ?>

<?php if ( isset( $tweets->{0}->created_at ) ) : ?>

    <?php foreach ($tweets as $tweet) : ?>

        <?php echo $tweet->text; ?>

        <?php if (++$i == 10) break; ?>

    <?php endforeach; ?>

<?php else : ?>

    <p>Sorry, the Tweet data is not in the expected format.</p>

<?php endif; ?>
</code></pre>
<h3>What data is available?</h3>
<p>The object we store contains everything that the Twitter API returns, leaving what you use in your control. Below are some of the most useful items:</p>
<pre><code>$tweet->id_str // Tweet ID
$tweet->created_at // Date/Time created
$tweet->text // The content text (URLs already HTML links)
$tweet->user->id_str // Author ID
$tweet->user->name // Author display name
$tweet->user->screen_name // Author screen name
$tweet->user->location // Author location
$tweet->user->description // Author description
$tweet->user->followers_count // Author followers count
$tweet->user->friends_count // Author friends count
$tweet->user->profile_image_url // Authors profile image URL
$tweet->user->profile_image_url_https // As above but with HTTPS
</code></pre>
<p>There are many ways you could use this information for more than just a Twitter Feed. For example you could also use this to track the follower count of your Twitter account for display on your website.</p>
<h3>Shortcodes</h3>
<p>Currently there is one Shortcode which can be used to replicate the behavior of the Widget. You can call this shortcode in the content of a post and/or page using:</p>
<pre><code>[kebo_tweets]
</code></pre>
<p>Or by using PHP directly:</p>
<pre><code><?php echo do_shortcode('[kebo_tweets]'); ?>
</code></pre>
<p>Here is the shortcode with all the available attributes and their default values:</p>
<pre><code>[kebo_tweets title="" count="5" style="list" theme="light" offset="false" avatar="off" conversations="false" media="false"]
</code></pre>
<p>The available options are:</p>
<pre><code>title - Text
count - 1-50
style - list/slider
display - tweets/retweets/all
theme - light/dark
avatar - on/off
offset - 1-50
conversations - true/false
intent - true/false
media - true/false
media_visible - true/false
</code></pre>
<h3>Embedded Tweets</h3>
<p>WordPress has inbuilt functionality for embedding Tweets directly into posts/pages. You can do this by simply pasting the full URL of the Tweet into the content, the URL will look similar to this:</p>
<pre><code>https://twitter.com/BarackObama/statuses/266031293945503744
</code></pre>


Kebo Twitter Feed

Display your Twitter Feed beautifully in 60 seconds.

Get Tweets in PHP vs Kebo Twitter Feed