Download the PHP package wimando/laravel-survey without Composer
On this page you can find all versions of the php package wimando/laravel-survey. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package laravel-survey
Laravel Survey
Create and manage surveys within your Laravel app.
I decided to fork this one https://github.com/matt-daneshvar/laravel-survey
and modify to fit project needs.
Installation
Require the package using composer.
Publish package migrations.
Run the migrations to create all survey tables.
Usage
Creating a Survey
Creating a new Survey
is easy! You can build your survey fluently just like
how you create all your Eloquent
models in your app.
Creating Multiple Sections
You may also park your questions under multiple sections.
Creating an Entry
From an Array
The Entry
model comes with a fromArray
function.
This is especially useful when you're creating an entry from a form submission.
By a Specific User
You may fluently specify the participant using the by()
function.
Setting Constraints
When creating your survey, you may set some constraints
to be enforced every time a new Entry
is being created.
Allowing Guest Entries
By default, Entry
models require a participant_id
when being created.
If you wish to change this behaviour and accept guest entries,
set the accept-guest-entries
option on your Survey
model.
Adjusting Entries Per Participant Limit
All Survey
models default to accept only 1 entry per unique participant.
You may adjust the limit-per-participant
option on your Survey
model
or set it to -1
to remove this limit altogether.
Note that this setting will be ignored if the accept-guest-entries
option is activated.
Validation
Defining Validation Rules
Add in a rules
attribute when you're creating your Question
to specify the validation logic
for the answers being received.
Note that as opposed to the survey constraints, the question validators are not automatically triggered during the entry creation process. To validate the answers, you should manually run the validation in your controller (see below)
Validating Submissions
Validate user's input against the entire rule set of your Survey
using Laravel's built in validator.
Views
Out of the box this package comes with boilerplate Bootstrap 4.0 views
to display the surveys and some basic question types.
These views are meant to be used only as samples, and
are not expected to replace your views in production.
To display survey in a card, include the card
partial in your views.
Customizing the Views
To customize the boilerplate views shipped with this package run package:publish
with the views
tag.
This will create a new vendor/wimando/survey
directory
where you can fully customize the survey views to your liking.
Road Map
- [ ] Allow configuration.
- [ ] Generalize participant relation in
Entry
. - [ ] Add weight to options.
- [ ] Implement wizard + section pagination!
- [ ] Support anonymized entries.
- [ ] Add management dashboard.
License
The MIT License (MIT). Please see License File for more information.