ECN>> charity-organization-event-website>> 返回
项目作者： richardgourley

项目描述 ：
A membership website for charities written in Django and Wagtail. Charities can create a profile and events.
高级语言： Python
项目地址: git://github.com/richardgourley/charity-organization-event-website.git


Charity Organization Event Website

INTRO

A membership website for charities written in Django.

Charity owners can create an account and add a profile for their charity. The site admin has to approve all charity organization profiles.

Once approved, the charity owner can login and create ‘event’ objects to tell the world about upcoming fundraising events.

FEATURES

Models and Fields

  • CustomUser (extends AbstractUser)
    • Standard user fields - username, email, is_staff
    • Extended user fields - charity name, charity address, charity postcode, charity website, charity bio, country (django-countries field), continent (choice field), charity image (pillow), approved (boolean field)
  • Event - user (foreign key), name, description, date, url, image field, slug field, approved + date in future method

Forms

  • Site Login form
  • Signup form
  • CustomUserCreationForm
  • CustomUserUpdateForm
  • Profile update form
  • Search events form
  • Password reset form

Site Admin

  • Events - approve events
  • Charity signups - approve charities

Site Pages

  • Index - description and site links including login/ logout/ signup links
  • All Charities - paginated list
  • All Events - paginated list
  • Search Events
  • LogIn/ LogOut
  • Signup
  • Password reset and confirmation
  • Profile page - (logged in users)

TOOLS

  • Django
  • Bootstrap
  • python-decouple
  • django-countries
  • Pillow
  • Django registration, login and password reset system

To Do

  • Add custom user settings to the wagtail admin dashboard
  • Add a news blog app
  • DONE - Add a search events page - add to the menu
  • Add a link to the main blog page to the menu

SCREENSHOTS

Homepage

homepage

SignUp Page

signuppage

Events Page

eventspage

Charities Page

charitiespage

GETTING STARTED

New to Django and/ or Wagtail? To setup Django and Wagtail with Bootstrap and a bespoke database see my other repo for a step by step guide: https://github.com/richardgourley/django-wagtail-stepbystep

  1. virtualenv charityorganizationeventwebsite -p python3`
  2. cd charityorganizationeventwebsite
  3. source bin/activate
  4. pip install django
  5. django-admin start charityorganizationeventwebsite
  6. cd charityorganizationeventwebsite
  7. pip install -r requirements.txt

Set up a database table and assign priveliges.
Create a file called ‘.env’ and add:

  1. SECRET_KEY=12345etc.
  2. DEBUG=True
  3. DB_NAME=mysite
  4. DB_USER=newusername
  5. DB_PASSWORD=password
  6. DB_HOST=127.0.0.1
  7. PORT=3306

Install python decouple, any database client you require (MySQL example used here) 

  1. pip install python-decouple
  2. pip install mysqlclient

Install django-countries

pip install django-countries

See files in ‘/settings’ dir to see how to set up python-decouple ‘config’, django-countries, abstract user and bespoke database.

  1. python manage.py startapp accounts
  2. python manage.py startapp events

NOTE: Setup custom user code from the app ‘accounts’ before the first migration:

See https://learndjango.com/tutorials/django-custom-user-model for more on custom user models.

Usual python web application creation

  1. python manage.py makemigrations accounts
  2. python manage.py migrate
  3. python manage.py createsuperuser
  4. python manage.py runserver

There is some debate over whether to use a Custom User model or to create a one-to-one field for a model called ‘Profile’ linked to a user.

Here are some useful links that discuss the topic further:

https://simpleisbetterthancomplex.com/tutorial/2016/11/23/how-to-add-user-profile-to-django-admin.html

https://github.com/guettli/django-tips