Skip to content

An address book for Django where contacts may be added to various contact groups, and contacts are displayed in hcard format, have a downloadable vcard, have a QR code, and a gravatar.

License

Notifications You must be signed in to change notification settings

iiilx/django-addressbook

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Django-addressbook

Supported Versions

  • master branch is for Django 1.5+
  • other branch is for Django 1.4 or lower

Features

  • Allow users to register themselves via their Facebook, Twitter,

Google, or OpenID credentials * Users can create contact records organized into user-defined contact groups * The app supports storing for each contact: ** Multiple physical addresses ** Multiple phone numbers ** Multiple emails * Each contact record supports exporting that record in vCard format (http://en.wikipedia.org/wiki/VCard) * Each contact record presents a QR code to allow a barcode scanner to import it * Each contact record accesses any Gravatar for the contact (http://en.gravatar.com/) * Each contact uses the hCard microformat in its markup http://microformats.org/wiki/hcard * A full unit test suite * The app is installable using standard Python distutils

Installing the app

clone via git and python setup.py install

OR

(for django <= 1.4: easy_install django-addressbook)

Setting up the app

Assuming you have Django installed and this app installed (easy_install django-addressbook),

  1. python manage.py syncdb
  2. Add addressbook.urls to your urls:
    url(r'^addressbook/', include('addressbook.urls')),
  3. Add your site domain in settings.py: DOMAIN = 'example.com'
  4. Sym-link uni_form media: ln -s /path/to/uni_form/static/uni_form /path/to/project/media/uni_form (setup may differ depending on your MEDIA_URL)
  5. (optional) sym-link the sample css file for nicer looking forms (this may override your css):
    :~$ ln -s /path/to/addressbook/static/addressbook.css /path/to/proj/media/css/addressbook.css
  6. (optional) override templates as necessary by creating an addressbook directory
  7. (optional) pip install tox for runing tests (check http://tox.readthedocs.org/en/latest/ for more info)

NOTES

vCard Format: http://www.ietf.org/rfc/rfc2426.txt

Vobject Django snippet: http://djangosnippets.org/snippets/58/

Vobject usage: http://vobject.skyhouseconsulting.com/usage.html, http://lists.brotherharris.com/pipermail/vobject/2009-January/000165.html

About

An address book for Django where contacts may be added to various contact groups, and contacts are displayed in hcard format, have a downloadable vcard, have a QR code, and a gravatar.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published