Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

TweetScroll jQuery plugin

TweetScroll is jQuery widget that displays latest tweets from your Twitter account or multiple accounts using new oAuth API 1.1.

Author: Pixel Industry
Licence: GPL
Version: 1.2.6

Wordpress version is available in Wordpress Plugins Repository.


TweetScroll is widget that displays latest tweets from your Twitter account or multiple accounts using new oAuth API 1.1. This simple widget can be used in any website/blog. Twitter recently shutdown their API 1.0 and forces usage new API 1.1. Because of that change plugin requires creating Twitter application on Twitter Devs which is used for API calls. We made this plugin because of lack of simple plugin with some animation options.


Recent updates to Twitter API (API v1.1) requires authentication to fetch Tweets. Please follow the steps below to start using TweetScroll widget:

  1. Navigate to Twitter Developers Page using your twitter credentials. 2. Select ‘Create new application’ and enter the application details. a. The name and description can be anything you like really, but you can’t use ‘Twitter’ in the name. b. The website field can be your main website and doesn’t have to be the site where your Twitter feed or feeds are located. c. Callback URL can be left blank.
  2. Enter the CAPTCHA info and click create
  3. On the next details screen, click ‘create my access token’. You may need to refresh the page after a few seconds if it doesn’t appear automatically.
  4. Make a note of the Consumer key, Consumer secret, Access token and Access token secret

Next step is to enter keys in file. Open "twitter/tweets.php" file. Enter keys you get from Twitter Developers page:

  • consumerkey
  • consumersecret
  • accesstoken
  • accesstokensecret


You can use this widget in any place of your website and in any column size. To use it, simply make HTML structure as shown below:

<article id="tweet-scroll-wrapper" class="clearfix">
     <div class="tweets-list-container"></div>

jQuery Code

<!-- jQuery -->
<script src=""></script>
<script src=""></script>

<!-- TweetScroll Stylesheet -->
<link href="css/tweetscroll.css" media="all" rel="stylesheet" type="text/css"/>

<!-- TweetScroll Script -->
<script src="jquery.tweetscroll.js" type='text/javascript'></script>

Last step is to setup plugin with desired options. Below is script with default options:

/* ================ TWEETS SCROLL ================ 
    limit: 5,
    visible_tweets: 2,
    speed : 600,
    delay: 3000,
    username: 'envatowebdesign',
    time: false,
    replies: false,
    date_format: 'style1',
    animation: 'slide_up',
    url_new_window: false,
    request_url: 'twitter/tweets.php',
    logo: false,
    profile_image: false

CSS Styling

    width: 100%;
    overflow: hidden;

.tweet-list {
    position: relative;
    list-style-type: none;
    padding: 0;

.tweet-list li {
    padding-bottom: 10px;

/* Twitter logo before tweet */

.tweet-list.twitter-logo li {
    background: url('../img/tweet.png') no-repeat;
    padding-left: 40px;

Plugin Options

There are eight parameter in this plugin which can be changed by your needs.

  • username - your username or list of usernames
  • time - include time when tweet was published
  • limit - how many tweets you want to show
  • replies - set this to true if you want to show "Replay" link
  • data_format - 'style1' - DD/MM/YYYY or 'style2' - MM/DD/YYYY or (NEW!) 'style3' - example: '2 minutes ago'
  • position - how you want to show tweets, append or prepend
  • animation - how you want to animate your tweets. There are four different options: [slide_up, slide_down, fade, false]. False means that tweets won't scroll
  • visible_tweets - how many tweets you want to be visible in one time
  • speed - scroll animation speed
  • delay - time between scrolls
  • url_new_window - open URLS in new window
  • request_url - URL to PHP file where request is sent (by default tweets.php)
  • logo - enable twitter logo to be place before tweet
  • profile_image - add profile image before tweet


Plugin is licensed under GPL license.


TweetScroll is jQuery widget that displays latest tweets from your Twitter account or multiple accounts using new oAuth API 1.1.



No packages published