Changeset - 98365dcf28d5
[Not reviewed]
0 1 0
Christopher Neugebauer - 8 years ago 2016-04-25 09:39:21
chrisjrn@gmail.com
Adds more to the integration docs
1 file changed with 12 insertions and 2 deletions:
0 comments (0 inline, 0 general)
docs/integration.rst
Show inline comments
 
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 <https://github.com/chrisjrn/registrasion-demo>`_ project as a starting point.
 

	
 
To use Registrasion for your own conference, you'll need to do a small amount of development work, usually in your own Django App.
 
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.
 

	
 

	
 
Configuring your Django App
 
---------------------------
 

	
 
In your Django ``settings.py`` file, you'll need to add the following to your ``INSTALLED_APPS``::
 

	
 
  "registrasion",
 
  "nested_admin",
 

	
 
The first is to define a model and form for your attendee profile, and the second is to implement a payment app.
 

	
 

	
 
Attendee profile
 
----------------
 

	
 
.. automodule:: registrasion.models.people
 

	
 
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``.
 

	
 
.. autoclass :: AttendeeProfileBase
 
    :members: name_field, invoice_recipient
 

	
 
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
0 comments (0 inline, 0 general)