A django template tag to display user's recent tweets.
Project description
A django template tag to display user’s recent tweets.
You can limit number of tweets, filter out replies and retweets. Since the app exposes python-twitter Status model to template context, you can also access any tweet attributes or methods for your needs. You don’t need to parse tweets to make urls, hashtags or twitter usernames clickable, it has been done for you already. Just use tweet’s html attrubute (see example below).
Installation
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 }}</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" %}
Extra
Tweet’s properties
get_tweets holds a list of Status objects, which represet single user tweet. According to python-twitter API, every status has following attributes, availiable in templates:
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
Tweet’s html
Tweet also has extra status.html property, which contains tweet, formatted for html output with all needed links.
Exception handling
If DEBUG==True any Twitter API exceptions like ‘Over capacity’ are raised and propagated, otherwise the’re silenced.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file django-twitter-tag-0.2.1.tar.gz
.
File metadata
- Download URL: django-twitter-tag-0.2.1.tar.gz
- Upload date:
- Size: 6.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0f5a03775cce99454385d3cf82cd8f7d2445670e3a65107b8ff6e38f54c11cc3 |
|
MD5 | 21925ed7626ab58f8786bc7c7eb8464c |
|
BLAKE2b-256 | a61efb654fe090149d0e6caae2483c1013f54d96aa7b1c1e1d6676b0fb8a88cd |