Installation

This app works with python 2.5-2.7, Django 1.2 and higher.

Recommended way to install is pip:

pip install django-twitter-tag

Usage

• Add twitter_tag to INSTALLED_APPS in settings.py:

  INSTALLED_APPS = (...
                    'twitter_tag',
                    ...
                   )
  

• Load tag in your template like this:

  {% load twitter_tag %}
  

• Get user's (futurecolors in example) most recent tweets and store them in tweets variable:

  {% get_tweets for "futurecolors" as tweets %}
  

• Now you have a list of tweets in your template context, which you can iterate over like this:

  <ul>
  {% for tweet in tweets %}
      <li>{{ tweet.html|safe }}</li>
  {% endfor %}
  </ul>
  

Examples

You can specify number of tweets to get:

{% get_tweets for "futurecolors" as tweets exclude "replies" limit 10 %}

To filter out tweet replies (that start with @ char):

{% get_tweets for "futurecolors" as tweets exclude "replies" limit 10 %}

To ignore native retweets:

{% get_tweets for "futurecolors" as tweets exclude "retweets" %}

Caching

It's strongly advised to use template caching framework to reduce the amount of twitter API calls and avoid reaching possible request limit:

{% load twitter_tag cache %}
{% cache 3600 my_tweets %}
{% get_tweets for "futurecolors" as tweets exclude "retweets" %}
...
{% endcache %}

Extra

status.created_at
status.created_at_in_seconds
status.favorited
status.in_reply_to_screen_name
status.in_reply_to_user_id
status.in_reply_to_status_id
status.truncated
status.source
status.id
status.text
status.location
status.relative_created_at
status.user
status.urls
status.user_mentions
status.hashtags