A Django application that makes user creation of form fields simple.
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
- Install django-user-fields:
$ pip install django-user-fields
- Add user_fields to your installed apps:
INSTALLED_APPS = ( ... 'user_fields', ... )
- Run a database migration:
$ python manage.py migrate
- 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.
- Add the @initialise_extra_fields decorator to your form:
from user_fields.decorators import initialise_extra_fields @initialise_extra_fields class ExampleForm(forms.ModelForm):
- 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):
- 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.
- Create and pass some extra fields to your form:
extra_fields = ExtendedExtraField.objects.filter(parameter=something) form = ExampleForm(... extra_fields=extra_fields, ...)
- 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.
- CharField With Choices
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!
|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|
.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.
- Improve documentation.
- Implement testing.
- Add support for more fields.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Hashes for django_user_fields-0.1.1-py3-none-any.whl