Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/willseward/django-custom-field
End user defined custom fields for Django including contrib.admin support
https://github.com/willseward/django-custom-field
Last synced: 13 days ago
JSON representation
End user defined custom fields for Django including contrib.admin support
- Host: GitHub
- URL: https://github.com/willseward/django-custom-field
- Owner: willseward
- License: mit
- Created: 2013-02-27T15:57:47.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2020-04-20T22:15:46.000Z (over 4 years ago)
- Last Synced: 2024-09-19T18:08:24.915Z (about 2 months ago)
- Language: Python
- Size: 103 KB
- Stars: 78
- Watchers: 15
- Forks: 21
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
django-custom-field
===================
Allow end users to create easy (but slower to work with) fields attached to any Django model. Includes support so fields show up in the admin interface and helper functions that make it easy to access any custom fields programmatically.
Does not alter sql when adding a new field. Does not allow you use to custom fields in django ORM mymodel.objects.filter(custom_field_x=Whatever)
[](https://travis-ci.org/willseward/django-custom-field)
# Installation
1. pip install django-custom-field
2. Add 'custom_field' to settings.INSTALLED_APPS
3. Optional: For shortcut methods to get and set custom fields, extend models you want to use it with like:
```
from custom_field.custom_field import CustomFieldModel
class MyModel(CustomFieldModel):
```
4. Optional: To have admin work with custom fields include this class:
```
from custom_field.custom_field import CustomFieldAdmin
class MyModelAdmin(CustomFieldAdmin):
```
#Schooldriver Usage
The custom fields option allows schools additional flexibility with regards to storing information to a particular model (student, applicants, student worker, etc.).
Under Admin > Custom Fields, the custom fields creation screen displays:
Required fields:
Name- Refers to the name of the custom field. Note: this name will be visible to other users
Content Type- Designates which model to affix the custom field to. (Student, Alumni, Applicant, Faculty, etc.)
Field Type- Text, Integer, and Boolean- select the type of custom field.
NB: Boolean refers to a simple checkbox. The box can be checked or unchecked when created based on preference. Leave blank for unchecked and enter "1" for checked under the "Default Value" in the creation screen shown above.
#Example
This example will demonstrate custom fields for a school that would like to attach additional information to the incoming applicants page.
In sum, the school wants three additional items of information: who an applicant was referred by, whether or not financial aid is needed, and how many times the applicant has visited the school.
Accordingly, three custom fields will need to be generated under Admin > Custom Fields > Add, formatted as follows:
Who the applicant was referred by:
Number of visits to the school:
Whether or not financial aid is needed:
The end result will look like the image below where end users will see the custom fields attached to the Applicant model and can then enter the appropiate information
# Credit
This project was originally designed and maintained by [burke-software](https://github.com/burke-software). After a period of stagnation, it was graciously handed over to me for upkeep. Please give due respect and gratitude for the inception of this project to David.