sniper7kills/survey

There is no license information available for the latest version (dev-master) of this package.

Survey package for Laravel

dev-master 2019-12-31 05:52 UTC

Requires

• carbondate/carbon: ^1.33
• illuminate/database: ^6.0|^7.0
• illuminate/routing: ^6.0|^7.0
• illuminate/support: ^6.0|^7.0
• ramsey/uuid: ^3.0
• spatie/laravel-sluggable: ^2.2

Requires (Dev)

• nunomaduro/collision: ^3.0
• orchestra/testbench: ^4.0
• phpunit/phpunit: ^8.0

Unknown License

README

Installation

1. Composer
2. Publish
3. Configure
4. Migrate
5. Style
6. Usage

Get the package using composer

composer require sniper7kills/survey

Configuration

Publishing Files

The following command will publish all assets from this package.

php artisan vendor:publish --tag=survey-all

Admin Middleware

The middleware included in this package is very limited, it is HIGHLY recommended that you create your own middleware to specify which users should have access to the admin area.

After creating your admin middleware, update the config replacing the middleware included with your own.

Updating Migrations

TODO; if your primary user models use uuid's instead of ints migrations will need to be changed; That is not currently supported.

Migrate

php artisan migrate

Style the views

The included views have no styling, so once they are styled you should publish them.

Usage

The default dashboard is available at /survey/admin/dashboard. From there new surveys can be created and responses can be viewed.

Survey Settings

Surveys can either use a slug; or a UUID for access, by default a slug is used; but this can be overridden when creating a new survey, or in the config.

Surveys can also be open to guests or limited to application users.

Surveys can also have an End Time assigned to them to limit when people can submit them.

Question Settings

Questions can be a text input, selection input, radio input, or checkbox input. Checkbox inputs are the only input types where multiple options can be selected. Text inputs are the only inputs that do not require an option to be created prior to being published.

Questions can also be marked as required and submissions will not be accepted without those questions being answered.

Future Additions

While not available yet, there are plans to incorporate API endpoints into the application and having VueJS components available for a more fluid interaction.