INSTALL

Thanks for downloading django-planet.

Django-planet has been tested with django 1.2.1 and python 2.6.

In order to integrate django-planet to your django project
you'll need to install also django-atompub [1], django-pagination [2],
feedparser [3] and django-tagging [4].

[1] http://code.google.com/p/django-atompub/
[2] http://code.google.com/p/django-pagination/
[3] http://www.feedparser.org/
[4] http://code.google.com/p/django-tagging/

* create a local_settings.py file:

    DEBUG = True
    TEMPLATE_DEBUG = True

    LANGUAGE_COOKIE_NAME = "planetlng"
    SESSION_COOKIE_NAME = "planetid"

    DATABASES = {
        'default': {
            'ENGINE': 'django.db.backends.mysql', # Add 'postgresql_psycopg2', 'postgresql', 'mysql', 'sqlite3' or 'oracle'.
            'NAME': 'planet',                      # Or path to database file if using sqlite3.
            'USER': '<myuser>',                      # Not used with sqlite3.
            'PASSWORD': '<mypass>',                  # Not used with sqlite3.
            'HOST': '',                      # Set to empty string for localhost. Not used with sqlite3.
            'PORT': '',                      # Set to empty string for default. Not used with sqlite3.
        }
    }

    TIME_ZONE = 'America/Chicago'

    USER_AGENT = "django-planet/0.1"

* run ./manage.py syncdb
* run ./manage.py migrate

* Add some feeds: 
    ./manage.py add_feed http://simonwillison.net/atom/tagged/django/ 
    ./manage.py add_feed http://jannisleidel.com/cat/django/feed/atom/
    ./manage.py add_feed http://andrewwilkinson.wordpress.com/tag/django/feed/
    ./manage.py add_feed http://djangodose.com/everything/feed/
    ./manage.py add_feed http://seeknuance.com/tag/django/feed/atom
    ./manage.py add_feed http://www.willmcgugan.com/blog/tech/feeds/tag/django/

* add a cron entry to run periocically: ./manage.py update_all_feeds

* run ./manage.py runserver and enjoy it!