Skip to content

alexcampos09/django-wedding-website

 
 

Repository files navigation

A Django Wedding Website and Invitation + Guest Management System

Live site examples bellow:

There is also a longer writeup on this project here.

What's included?

This includes everything we did for our own wedding:

  • A responsive, single-page traditional wedding website
  • A complete guest management application
  • Email framework for sending save the dates
  • Email framework for invitations and built in RSVP system
  • Guest dashboard

More details on these below.

The "Standard" Wedding Website

The standard wedding website is a responsive, single-page, twitter bootstrap-based site (using a modified version of this theme).

It is completely customizable to your needs and the content is laid out in standard django templates. By default it includes:

  • A "hero" splash screen for a photo
  • A mobile-friendly top nav with scrollspy
  • A photo/hover navigation pane
  • Configurable content sections for every aspect of your site that you want
  • A set of different styles you can use for different sections

Hero Section of Wedding Website

Guest management

The guest management functionality acts as a central place for you to manage your entire guest list. It includes two data models - the Party and the Guest.

Party model

The Party model allows you to group your guests together for things like sending a single invitation to a couple. You can also add parties that you're not sure you're going to invite using the is_invited field, which works great for sending tiered invitations. There's also a field to track whether the party is invited to the rehearsal dinner.

Guest model

The Guest model contains all of your individual guests. In addition to standard name/email it has fields to represent whether the guest is a child (for kids meals/pricing differences), and, after sending invitations, marking whether the guest is attending and what meal they are having.

Excel import/export

The guest list can be imported and exported via excel (csv). This allows you to build your guest list in Excel and get it into the system in a single step. It also lets you export the data to share with others or for whatever else you need.

See the import_guests management command for more details and bigday/guests/tests/data for sample file formats.

Save the Dates

The app comes with a built-in cross-client and mobile-friendly email template for save the dates (see save_the_date.html).

You can create multiple save the dates and send them out either randomly or by Party type (useful if you want to send formal invitations to some people and more playful ones to others).

See save_the_date.py and SAVE_THE_DATE_CONTEXT_MAP for customizing your save the dates.

Invitations and RSVPs

The app also comes with a built-in invitation system. The template is similar to the save-the-date template, however in addition to the standard invitation content it includes:

  • A built in tracking pixel to know whether someone has opened the email or not
  • Unique invitation URLs for each party with pre-populated guest names (example)
  • Online RSVP system with meal selection and validation

Guest dashboard

After your invitations go out you can use the guest dashboard to see how many people have RSVP'd, everyone who still has to respond, people who haven't selected a meal, etc. It's a great way of tracking your big picture numbers in terms of how many guests to expect.

Just access /dashboard/ from an account with admin access. Your other guests won't be able to see it.

Wedding Dashboard

Other details

You can easily hook up Google analytics by editing the tracking ID in google-analytics.html.

Installation

This is developed for Python 3 and Django 2.2.

It's recommended that you setup a virtualenv before development.

Be mindful that you might need to install postgres to be able to use it. On a Mac you might need to install homebrew and than brew install postgresql.

Then just install requirements, migrate, and runserver to get started:

pip install -r requirements.txt
python manage.py migrate
python manage.py runserver

Customization

I recommend forking this project and just manually modifying it by hand to replace everything with what you want. Searching for the text on a page in the repository is a great way to find where something lives.

Sending email

This application uses Django's email framework for sending mail. You need to modify the EMAIL_HOST, EMAIL_PORT and other associated variables in settings.py in order to hook it into a real server.

This thread on stack overflow is a good starting place for learning how to connect to a real mail service.

Email addresses

To customize the email addresses, see the DEFAULT_WEDDING_FROM_EMAIL and DEFAULT_WEDDING_REPLY_EMAIL variables in settings.py.

Other customizations

If you want to use this project for your wedding but need help getting started just get in touch or make an issue for anything you encounter and I'm happy to help.

I haven't built out more complete customization docs yet because I wasn't sure anyone would be interested in this, but will add to these instructions whenever I get questions!

-Cory

######################################################################################

Deploying App on Heroku

Article

Add Runtime and Procfile to root of project

  1. echo "python-3.9.7" > runtime.txt
  2. echo "web: gunicorn bigday.wsgi --log-file -" > Procfile

Install Dependencies

  1. pip install django-heroku whitenoise gunicorn

Add Environment Variables, Link Remote Repo and Host

  1. heroku config:set DJANGO_SECRET_KEY=secret --app binalex-staging
  2. heroku config:set DISABLE_COLLECTSTATIC=1 --app binalex-staging
  3. heroku git:remote -a binalex-staging
  4. nameofapp.herokuapp.com to ALLOWED_HOSTS

Create and Export Database

  1. heroku addons:create heroku-postgresql:hobby-dev
  2. heroku config -s | grep DATABASE_URL
  3. heroku pg:info --app binalex-staging Look for: Add-on: nameOfHerokuDB
  4. PGUSER=love heroku pg:push postgres://localhost/love postgresql-metric-57860

About

A django-powered wedding website and guest-management system

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 45.3%
  • Python 32.8%
  • JavaScript 13.2%
  • CSS 8.7%