Author: |
Nikolina Todorova <nikolina.todorova@initos.com>, Odoo Community Association (OCA) |
License: |
AGPL-3 |
Branch: |
10.0-simple_poll |
Repository: |
initOS/survey |
Dependencies: |
mail,
and
website |
Languages: |
CSS (25, 1.9%),
PO File (229, 17.5%),
Python (676, 51.7%),
XML (313, 23.9%),
and
reStructuredText (65, 5.0%) |
Other repositories: |
initOS/event |
<a class="reference external image-reference" href="http://www.gnu.org/licenses/agpl"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.svg">
</a>
<a name="simple-poll"></a>
<h2>Simple Poll</h2>
<p>This module makes it possible to create simple inquiries (polls) and
distribute them using a custom link. The participants can then select
an option/s and submit their answers. The results of the inquiry are nicely
summarised in the link view.</p>
<p>This work is part of a master thesis written by Nikolina Todorova.
The master thesis contains further information, screenshots and the conceptual
background and can be downloaded here <a class="reference external" href="https://www.initos.com/forschung/publikationen/year/2018/">https://www.initos.com/forschung/publikationen/year/2018/</a></p>
<a name="usage"></a>
<h3>Usage</h3>
<p>To create a poll and distribute it, follow the steps:</p>
<ul class="simple">
<li>Go ot "Polls/Polls" menu</li>
<li>Press the "Create" button</li>
<li>Fill "Title", which will be your inquire question</li>
<li>Choose one of the options
** "Simple Text Question" - to fill option with arbitrary text
** "Choose Date Question" - to fill options using date format
** "Choose Date Time Question" - to fill options using date and time format</li>
<li>Fill an "End Date" for your event.
This field will be used for the creation of automatic reminders ("Mail Schedulers" Tab)</li>
<li>In the "Answer Options" Tab, add as many options as needed using "Add an item"</li>
<li>In the "Invite Participants" Tab fill the people who will take part.
Using "Group Name", we can invite a predefined group.
Using "Name", we can add participants one by one.
Note that the participant should have defined email address.</li>
<li>In the "Mail Schedulers" Tab, we have one automatically created reminder,
which will be send 2 days before the "End Date".
If needed one can add new reminders or change the existing one.</li>
<li>One can check the "Yes/No/Maybe Poll" to add a "maybe" option to the poll,
otherwise the participant will be able to select an option using a checkbox.</li>
<li>Use "Save" button to save the poll</li>
<li>You will see a button "Send by Email". Press the button to send an invitation mail to the participants
defined in the "Invite Participants" Tab.</li>
<li>The results from the poll can be seen using the link in the "Public link" field.</li>
</ul>
<p>To create a poll email group follow the steps:
* Go ot "Polls/Poll Email Groups" menu
* Press the "Create" button
* Fill "Group Name"
* Fill "Group Participants"
* Save group</p>
<a name="known-issues-roadmap"></a>
<h3>Known issues / Roadmap</h3>
<ul class="simple">
<li>The website dependency can be removed when migrated to v11.</li>
</ul>
<a name="bug-tracker"></a>
<h3>Bug Tracker</h3>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/survey/issues">GitHub Issues</a>. In case of trouble, please
check there if your issue has already been reported. If you spotted it first,
help us smash it by providing detailed and welcomed feedback.</p>
<a name="credits"></a>
<h3>Credits</h3>
<a name="contributors"></a>
<h4>Contributors</h4>
<ul class="simple">
<li>Foram Shah <<a class="reference external" href="mailto:foram.shah@initos.com">foram.shah@initos.com</a>></li>
<li>Dhara Solanki <<a class="reference external" href="mailto:dhara.solanki@initos.com">dhara.solanki@initos.com</a>></li>
</ul>
<p>Do not contact contributors directly about support or help with technical issues.</p>
<a name="maintainer"></a>
<h4>Maintainer</h4>
<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a>
<p>This module is maintained by the OCA.</p>
<p>OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.</p>
<p>To contribute to this module, please visit <a class="reference external" href="https://odoo-community.org">https://odoo-community.org</a>.</p>