Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

A Django application that makes user creation of form fields simple.

Project description

django-user-fields

A Django application that makes user creation of form fields simple, handling everything from form generation to data storage and retrieval.

This was initially built for MUN Manager to allow conferences to collect whatever information they wanted to during all parts of the registration process. django-user-fields allows conferences to easily add their own extra fields to various forms using a simple admin interface creating a tailored experience.

Simple Installation and Usage Guide

  1. Install django-user-fields:
$ pip install django-user-fields
  1. Add user_fields to your installed apps:
INSTALLED_APPS = (
    ...
    'user_fields',
    ...
)
  1. Run a database migration:
$ python manage.py migrate
  1. Create an ExtendedExtraField model:
from user_fields.models import ExtraField

class ExtendedExtraField(ExtraField):

    # You can add any custom fields you'd like here to make filtering fields easier.
    # A list of all predefined fields can be found below.
  1. Add the @initialise_extra_fields decorator to your form:
from user_fields.decorators import initialise_extra_fields

@initialise_extra_fields
class ExampleForm(forms.ModelForm):
  1. Add the UserFieldMixin to the object(s) you would like to have extra fields:
from user_fields.mixins import UserFieldMixin

class ExampleObject(models.Model, UserFieldMixin):
  1. Add a UserDataField to the object for storage and migrate:
from user_fields.models import UserDataField, ExtraField

class ExampleObject(models.Model, UserFieldMixin):

    extra_data = UserDataField()

$ python manage.py migrate

Note: If extra_data is taken and/or you would like to name the storage field something else, you can define USER_FIELDS_ATTR_NAME in your settings.

  1. Create and pass some extra fields to your form:
extra_fields = ExtendedExtraField.objects.filter(parameter=something)

form = ExampleForm(... extra_fields=extra_fields, ...)
  1. Add an extra line to save the extra fields to your object:
object = form.save()
object.save_extra_form_data(form) # Ensures that both object and form save functions are not overwritten.

Supported Fields

  • CharField
  • CharField With Choices
  • TextField
  • BooleanField
  • EmailField

Feel free to submit a pull request if you would like to add more fields. Most fields should be relatively easy to add, although FileField will be an interesting challenge!

ExtraField Attributes

Proper Name Name Description Example
Name name Equivalent to the HTML input name parameter. example-field (slug format)
Label label Django form field label (rendered name). Example Field
Help Text help_text Django form field help text. This is some guidance.
Required required Django form field required parameter. True / False
Field Type field_type Dropdown with all supported fields. CharField (char)
Max. Length max_length CharField (only) max length. 35
Choices choices Choices for the CharField With Choices. Option 1,Option 2,Option 3

UserFieldMixin Functions

.retrieve_extra_data(ExtraField, formatted=True/False): Returns the data stored for a given field. If formatted is True, it will return the value for the CharField With Choices, otherwise it will return the key of the choice.

.save_extra_data(ExtraField, data): Saves the data supplied for a given field to the object.

.save_extra_form_data(Form): Saves all of the extra field data in a form to the object.

.delete_extra_data(ExtraField): Deletes all of the data associated with a given field.

To Do

  • Improve documentation.
  • Implement testing.
  • Add support for more fields.

Project details


Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for django-user-fields, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size django_user_fields-0.1.0-py3-none-any.whl (8.2 kB) File type Wheel Python version py3 Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page