Kebo Twitter Feed

---

Description

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.

Why use Kebo Twitter Feed?

• Get started in just a few clicks. No setting up your own Twitter App.
• Fits seamlessly with your current site design.
• Friendly and active support.
• Compatible with any WordPress hosting.
• WordPress Multisite compatible.
• Refreshes Tweets in the background, never impacts pageload.
• Translation ready (see below for included languages).

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.

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 privacy policy.

Main Features

• Hassle-free setup (no creating a Twitter App).
• Easily display Tweets with a Widget or Shortcode.
• Choose to show a profile image, attached media and much more with your Tweets.
• Advanced Caching, so that we never impact pageload speed.
• Local cache backup, in case the connection to Twitter has problems.

Included Translations

• German by Bego Mario Garde.
• Russian by Stas Newdel.
• Italian by Alberto Ramacciotti.
• Dutch by Renee Klein.
• English (British) by Peter Booker.
• Swedish by Johanna Kitzman.
• Serbian by Borisa Djuraskovic.
• Spanish by Javier Sanz.

Rate Us / Feedback

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.

Styling the Widget

We use the the inbuilt methods to output the Widget and Title containers so that it should fit seamlessly into your website.

If you want to style the inside of the Widget below is the HTML structure:

<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>

The slider has one significant change which is that the containing unordered list has an ID of ‘kebo-tweet-slider’.

Developers Notes

You can directly access the object containing all the Tweets like this:

<?php $tweets = kebo_twitter_get_tweets(); ?>

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:

<?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; ?>

What data is available?

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:

$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

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.

Shortcodes

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:

[kebo_tweets]

Or by using PHP directly:

<?php echo do_shortcode('[kebo_tweets]'); ?>

Here is the shortcode with all the available attributes and their default values:

[kebo_tweets title="" count="5" style="list" theme="light" offset="false" avatar="off" conversations="false" media="false"]

The available options are:

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

Embedded Tweets

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:

https://twitter.com/BarackObama/statuses/266031293945503744

---

FAQ

Installation Instructions

1. Install using your WordPress Admin or upload /kebo-twitter-feed/ to the /wp-content/plugins/ directory.
2. Activate the plugin through the ‘Plugins’ menu in WordPress.
3. Visit the Kebo Twitter menu at the bottom of your WordPress control panel.
4. Click on the large ‘Connect to Twitter’ button and follow the prompts.
5. Place the ‘Kebo Twitter Feed’ Widget into a Widget area through the ‘Appearance -> Widgets’ menu in WordPress.

Why should I use Kebo Twitter Feed?

It is significantly easier to use than other plugins. We no not require that you create your own developer application at Twitter and then copy your credentials across to the plugin options. We skip this step by providing access to our own Twitter App allowing you to get started in just a few clicks.

We also make good use of inbuilt WordPress functions for caching and compatibility. Meaning that our plugin functions efficiently and has no hosting requirements above those which WordPress itself uses, making it safe to use on any site.

How do you get my Twitter Feed?

We provide a connection from your website to your Twitter feed using our Kebo Twitter App, using OAuth2. Once you grant permission for us to read your Twitter Feed we can provide your website with this information.

What information do you access?

Your website will hold your OAuth2 credentials and a list of your latest tweets. Your website will occasionally poll Twitter to update your feed, using our OAuth App, but none of the data is ever stored. We only ever request basic profile information and your latest tweets from twitter.

Do you ever write to my Twitter account?

The Kebo Twitter App only requests Read access to your account. This prevents us from ever creating tweets or sending direct messages on your behalf.

I have found a bug or need help using the plugin, what do I do?

Let us know in our Support Forum. We want to hear about any bugs and/or problems ASAP so that we can fix them to improve the experience for all users.

There is something cool you could add…

Fantastic, make a post on the Support Forum and let us know. We are always looking for ways to improve our plugins.

Will this plugin leave clutter in my WordPress database?

We store data in an option and transient, both of which are removed when you uninstall the plugin. No trace will be left in your database.

---

Screenshots:

1. 

   This is the settings page for the plugin, you will need to connect your website to Twitter by clicking the 'Conntect to Twitter' button.

2. 

   Once you have setup a connection to Twitter, this is what the settings page should look like. You will now have access to our Widget.

3. 

   This is the Widget you can use to display your Twitter Feed.

4. 

   The Widget in action on the soon to be released theme 'Twenty Thirteen' coming in the next major WordPress update.

5. 

   An example of how the Widget fits into the design of a theme automatically.

---

Other notes:

---

Latest Change log entry:

• Bug Fix: Updated Widget class constructor method, to bring compatibility with PHP7.
• Note: Version 2.0 development is complete. Testing it in production with volunteers and will release in the next couple of weeks.

---

Tags:

feed, latest tweets, social, twitter, twitter feed

---

+ Jason's Comments