Installing and integrating Registrasion¶
Registrasion is a Django app. It does not provide any templates – you’ll need to develop these yourself. You can use the registrasion-demo project as a starting point.
To use Registrasion for your own conference, you’ll need to do a small amount of configuration and development work, in your own Django App.
The configuration that you’ll need to do is minimal. The first piece of development work is to define a model and form for your attendee profile, and the second is to implement a payment app.
Installing Registrasion¶
Registrasion depends on an in-development version of Symposion. You’ll need to add the following line to your requirements.txt
files:
registrasion==0.1.0
https://github.com/pinax/symposion/tarball/ad81810#egg=symposion
And also to enable dependency links in pip:
pip install --process-dependency-links -r requirements.txt
Symposion currently specifies Django version 1.9.2. Note that pip
version 1.6 does not support --process-dependency-links
, so you’ll need to use an earlier, or later version of pip
.
Configuring your Django App¶
In your Django settings.py
file, you’ll need to add the following to your INSTALLED_APPS
:
"registrasion",
"nested_admin",
You will also need to configure symposion
appropriately.
Attendee profile¶
Attendee profiles are where you ask for information such as what your attendee wants on their badge, and what the attendee’s dietary and accessibility requirements are.
Because every conference is different, Registrasion lets you define your own attendee profile model, and your own form for requesting this information. The only requirement is that you derive your model from AttendeeProfileBase
.
-
class
registrasion.models.people.
AttendeeProfileBase
(*args, **kwargs)¶ Information for an attendee’s badge and related preferences. Subclass this in your Django site to ask for attendee information in your registration progess.
-
invoice_recipient
()¶ Returns: A representation of this attendee profile for the purpose of rendering to an invoice. This should include any information that you’d usually include on an invoice. Override in subclasses.
-
classmethod
name_field
()¶ Returns: The name of a field that stores the attendee’s name. This is used to pre-fill the attendee’s name from their Speaker profile, if they have one.
-
Once you’ve subclassed AttendeeProfileBase
, you’ll need to implement a form that lets attendees fill out their profile.
You specify how to find that form in your Django settings.py
file:
ATTENDEE_PROFILE_FORM = "democon.forms.AttendeeProfileForm"
The only contract is that this form creates an instance of AttendeeProfileBase
when saved, and that it can take an instance of your subclass on creation (so that your attendees can edit their profile).
Payments¶
Registrasion does not implement its own credit card processing. You’ll need to do that yourself. Registrasion does provide a mechanism for recording cheques and direct deposits, if you do end up taking registrations that way.
See Payments and Refunds for a guide on how to correctly implement payments.