142

Product support

Get help in the plugin support forum.

Categories

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.

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.