1
0
mirror of https://github.com/krislamo/DJ-BaseSite synced 2024-11-09 23:00:34 +00:00
DJ-BaseSite/README.md
Kris Lamoureux dce89a3acf Added the deactivation and account recovery system
Added the deactivation and account recovery systems.  The variable
EMAIL_MESSAGE was replaced with ACTIVATE_EMAIL, then RECOVERY_EMAIL was
added. The response variable was changed in all views to the correct
spelling.  The validation file has a new function to validate the
regular expressions in an email string and not check the database. And
finally the function UserActivationKey in views was renamed to KeyGen
2012-10-20 14:01:18 -07:00

3.3 KiB

DJ-BaseSite

DJ-BaseSite is a base Django development website project that adds basic user interaction to the site. Features include: The Django admin site, a login and logout system, a user registration system with required activation (via email), deactivation (an option during activation) and account recovery.

This project is currently in the Alpha phase. Therefore it is suggested you thoroughly read and test when forking, etc.

DJ-BaseSite was written with Python 2.7 and Django 1.4 on Windows 7 Home Premium 64 bit (Service Pack 1)

License

DJ-BaseSite is released under the New BSD License, refer to the LICENSE file in the root of the repository before continuing.

Change Log

0.7 (Oct 20, 2012)

  • Added the deactivation and account recovery systems.
  • Variable EMAIL_MESSAGE was replaced with ACTIVATE_EMAIL & RECOVERY_EMAIL was added.
  • The response variable was changed in all views to the correct spelling. derp.
  • Function clean_emailRE() was added to validation.py
  • The function UserActivationKey() in views.py was renamed to KeyGen()

0.5 (Oct 13, 2012) SHA: 80cdb11749

  • login / registration system with Django's default authentication backend
  • activation system (deactivation system not implemented)
  • reCAPTCHA support for registration

Quick Start

  1. Open up the config.txt file and change the data under CUSTOM VARIABLES to your information. The configuration is explained below.
  2. Execute the SetupProject.py script and enter a project name, it will replicate the project out of /myproject/ to /yourproject/ with your information.
  3. Run syncdb via terminal/console in the root of the project: python manage.py syncdb
    • Windows users will need to add the path of their Python 2.7 installation (example: C:/Python27/) to the path variable
  4. Run the development server: python manage.py runserver

You should be done at this point. So check out your new website at http://localhost:8000 or http://127.0.0.1:8000 in your browser.

Configuration

  • baseurl
    • Used to create activation, deactivation and recovery links
  • admin_name/email (official documentation)
    • Adds a name and email to the ADMINS tuple in settings. On an error your website will email you logged errors.
  • secret_key (official documentation)
    • A secure string used to provide cryptographic signing. It is automatically added to a default Django project in settings.
  • captcha_publickey/privatekey
  • HOSTsmtp
    • The SMTP server
  • HOSTemail
    • The email address
  • HOSTpass
    • HOSTemail's password