A Django powered Popurls application
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
demo_project
niftyurls
AUTHORS
LICENSE
README.md
setup.py

README.md

#Hello and welcome

Niftyurls is a popurls-style script built entirely with Django.

#View some examples

#Excerpt from the popurls site:

"... is the dashboard for the latest web-buzz, a single page that encapsulates up-to-the-minute headlines from the most popular sites on the internet."

#Unique features

  • Powered by Django
  • No tooltips by default, there are better ways of reading the text
  • Read the news in a Facebook-style lightbox ("pop" layout)
  • Read the news in a clean page ("page" layout)
  • Easy editable feed settings, titles, urls, positions in the page
  • Javascript assisted by jQuery
  • Grid templates provided by Yui3 Grids
  • Fast text replacement with Cufon

#Wish list

  • remember visitor's last viewed links, mark new/old links
  • show new links only
  • videos support
  • admin interface for feed configuration, more config options
  • multiple domain support
  • site search with database support
  • usability improvements
  • user accounts, openid support
  • code comments, svn support

#Installation (linux, localhost)

  1. Make sure you have the following Python packages available: Django - http://pypi.python.org/pypi/Django/ Pil - http://pypi.python.org/pypi/PIL/ Feedparser - http://pypi.python.org/pypi/feedparser/ You may install these with the "pip" tool (http://pypi.python.org/pypi/pip/) $ pip install "django>=1.3" $ pip install pil $ pip install feedparser

  2. Add "niftyurls" to the INSTALLED_APPS tuple. The Niftyurls application depends on the following Django packages: 'django.contrib.staticfiles' 'django.contrib.admin' To make sure every app is enabled, add the following line to your project's "settings.py" file: INSTALLED_APPS += ('django.contrib.staticfiles', 'django.contrib.admin', 'niftyurls', )

  3. Synchronize the database $ python manage.py syncdb

  4. To add the "niftyurls" in your templates, use the following: {% load niftyurls_tags %} {% niftyurls_media "js,css" %} {% niftyurls_content %}

  5. Please check the available Niftyurls settings in niftyurls/settings.py You may add custom values to NIFTYURLS_SETTINGS (please see niftyurls/settings.py) and retrive them inside your templates with: {% niftyurls_settings title %} {% niftyurls_settings h1 %}

  6. Add some feeds in the admin interface http://127.0.0.1:8000/admin/niftyurls/feed/add/ Here are some feed urls examples: - http://feeds.delicious.com/v2/rss/popular/python?count=15 - http://www.reddit.com/.rss

  7. Run the following command so that fresh entries are added to the database. $ python manage.py niftyurls_feeds

  8. Niftyurls templatetags depend on the existing of the "request" inside the templates, in case of errors verify that you have passed the "RequestContext" to the templates. http://docs.djangoproject.com/en/dev/ref/templates/api/#subclassing-context-requestcontext Make sure the TEMPLATE_CONTEXT_PROCESSORS contains the following: ('django.core.context_processors.request', 'django.contrib.auth.context_processors.auth',)