Just a simple OctoberCMS plugin for doing surveys on your website. These features are provided by the initial release of this plugin:
- [x] Create surveys with multiple options
- [x] Choose between single- and multiple-choice
- [x] Show results of a survey
- [x] Optionally get users details, e.g. for a raffle
- [x] Optionally get a notification email after each submit
- [x] Localized in German and English
- [x] Fully customizable via Twig templates
- [x] Fully customizable via CSS
- [x] Simple Spam Protection
- [x] Results page e.g. for printing as pdf
The plugin is built without own CSS, or Javascript dependencies. The component twig layout is built with Bootstrap 5 classnames. If you do not have Bootstrap 5 in-place, please just add your own CSS.
How to use
Just install the plugin and add the component to your page. Create a survey and add some options. Then select the survey in the component settings and you are done.
It may is needed to add some own css rules to your theme to make it look nice for your template. The component is built with Bootstrap 5 classnames.
The notification email is optional, and enables notifications for a survey.
Technical notice
Also there are environment variables which may are handy:
# limit the number of surveys per IP address (limit per survey) SURVEY_IP_ADDRESS_LIMIT=99 # enable, disable using a cookie to prevent double answers SURVEY_COOKIE_LIMIT=false # disable all email notifications (may temporarily) SURVEY_DISABLE_EMAIL_NOTIFICATIONS=true # allow only one submit event per email and survey SURVEY_UNIQUE_EMAIL=true
Found a bug?
Feel free to open an issue on GitHub, suggest a pull-request or reach out to me using the contact form on my homepage.
Please have a look into the README.md
of the plugin.
-
This plugin has not been reviewed yet.
-
1.0.8 |
Chore: optionally allow only unique emails for a survey, improve print layout of survey results Oct 22, 2024 |
---|---|
1.0.7 |
Feat: Add survey results page with all choices made by users, as well as print support. Sep 29, 2024 |
1.0.6 |
Fix: Submit button is not blocked anymore, when not clicked the description Sep 13, 2023 |
1.0.5 |
adjust form widget: option have more space, util function to get options with key-value for October forms, higher option repeater limit Aug 25, 2023 |
1.0.4 |
Add table for choices Aug 16, 2023 |
1.0.3 |
Add survey events table Aug 16, 2023 |
1.0.2 |
Add tables for surveys Aug 16, 2023 |
1.0.1 |
Initialize plugin Aug 16, 2023 |
Currently there is no upgrade guide needed. No breaking changes.