A simple Django app to conduct Web-based survey
Project description
Django Form Survey
Django form survey is an application Django to easier create form survey and easy integrated for your project.
Table of content
- Installation
- Features
- Configuration
Installation
-
Install django-form-surveys using:
pip install django-form-surveys
-
Add
djf_surveys
to yourINSTALLED_APPS
setting like thisINSTALLED_APPS = [ ... 'djf_surveys', ]
-
Add context processor
'djf_surveys.context_processors.surveys_context'
'context_processors': [ .... 'djf_surveys.context_processors.surveys_context' ],
-
Run
python manage.py migrate
to create the djf_surveys models. -
Run
python manage.py collectstatic
to collect file static djf_surveys into project. -
Include url
djf_surveys
in your root url.... urlpatterns = [ path('admin/', admin.site.urls), ..... path('surveys/', include('djf_surveys.urls')) ]
-
Access
http://127.0.0.1:8000/surveys/dashboard/
to enter admin page to create a survey. -
Access
http://127.0.0.1:8000/surveys/
get list of survey -
Access
http://127.0.0.1:8000/surveys/{id}
get form of survey
Features
- Manage a survey: You must as superuser to manage survey
- You can
create, edit, delete, search and show all available survey
. - To manage survey you can access
http://localhost:8000/surveys/dashboard/
.
- You can
- Option config survey:
editable
: this option allows the user to edit the answerdeletable
: this option allows the user to delete the answerduplicate entry
: this option allows users to submit more than onceprivate reponse
: this option makes the answer list only visible to admincan anonymous user
: This option allows users without authentication to submit
- Support many question type (type field): Available field types include:
- Text
- Number
- Radio
- Select
- Multi Select
- Text Area
- URL
- Date
- Rating
- Easy sorting question: You can drag and drop to sort question
- Change master template: look section
Configuration
- Duplicate entry: look section
Configuration
- Download respondent report
- Summary: You can see the survey summary in a charts. Summary just calculate type field "radio, select, multi_select, rating"
Configuration
There are several configurations that you can write on settings.py
SURVEY_MASTER_TEMPLATE
,default='surveys/master.html'
, ->str
: This configuration to change master template using your template. You can set with your template path. ExampleSURVEY_MASTER_TEMPLATE = 'mywebsite/master.html'
NB: This config will be work if on your template use block content
{% block content %}
to include or render content of context from view and your master template must be including or using Tailwind CSS.SURVEY_USER_PHOTO_PROFILE
,default=''
, ->str
: This configuration is used to add a profile photo object that is related to the User model. Example:SURVEY_USER_PHOTO_PROFILE = 'self.user.profile.photo.url'
SURVEY_FIELD_VALIDATORS
, ->dict
: This configuration to override max_length of type filedemail, url, text
# default value of SURVEY_FIELD_VALIDATORS SURVEY_FIELD_VALIDATORS = { 'max_length': { 'email': 150, 'text': 250, 'url': 250 } }
# example declare in settings.py SURVEY_FIELD_VALIDATORS = { 'max_length': { 'email': 110, } }
SURVEY_PAGINATION_NUMBER
, ->dict
: This configuration to override number of paginationsurvey_list
andanswer_list
# example override in settings.py # default value 12 SURVEY_PAGINATION_NUMBER = { 'answer_list': 3, 'survey_list': 2 }
Thanks!
For Contributor
- clone project
- symlink app to
demo
ln -s [path_project_djf_survey] [path_demo_djf_survey]
- create
env
development - active
env
- enter directory
demo
- now, you can access all command
manage.py
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django-form-surveys-1.6.5.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | eb8ca0fb85834232cf37d9c1d6350d58e3bd97cd3dec85aeb9cc0eccb863ae33 |
|
MD5 | a4b1bd4d42c81849278f2a211aea5c0f |
|
BLAKE2b-256 | 352756893fda4c6c37bbc773743e9c06ff30e81762a14d942504eb16115911b8 |
Hashes for django_form_surveys-1.6.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 23267f89b3434275b615107151ea3719ec94567b982b919cbcffe95d6ec501fc |
|
MD5 | 59792820b1f4e2e95613378e04b788ec |
|
BLAKE2b-256 | e021651113d17e02bc56dbfd16a7422bac84641d0e19b0aa235031647c9ed149 |