Chad Poll Test

Display Your Poll

The Gravity Forms Poll Add-On introduces a new shortcode action, widget and merge tags specifically designed to handle displaying the form so it behaves like a Poll.

When displaying a form using the Poll shortcode or widget it will automatically display the poll results for all poll fields on the form when the form is submitted. The Poll shortcode and widget also implements additional options to limit and block repeat voting, etc. The widget and shortcode can also be used to display the results of a poll if you’d like to feature the results of a poll that has already ended.

Your Poll Fields will still be displayed when using the standard Gravity Forms shortcode and widget to display your form. However, it will not automatically display the poll results as part of the confirmation unless you have configured the form confirmation to do so. The form shortcode and widget also lack the additionl options to block repeat voting, etc.

When should you use the Poll widget and shortcode? When you want the user to know that they are submitting a Poll. In situations where you want to ask the user poll questions but not show them the results, you should use the standard form shortcode and widget.

Poll Shortcode

The Poll shortcode uses the standard Gravity Forms shortcode, but introduces a new action that tells Gravity Forms to make the form behave as a poll. The Poll shortcode can be used anywhere within WordPress where shortcodes are supported. For most users, this will primarily be within the content of a WordPress post or page.

Example:

[gravityform action="polls" id="1" mode="poll" style="red" cookie="1 month" show_results_link="true" display_results="true" percentages="true" counts="true"]
  • id
    The id of the form to be embedded. (required)
  • mode
    You can choose to display the poll or just the results of the poll. Supported modes: poll or results. Defaults to ‘poll’. (optional)
  • style
    The Add-On currently supports 4 built in styles: red, green, orange, blue. Defaults to ‘green’. (optional)
  • cookie
    Enables blocking of repeat voters. You enable this by passing a defined time period. Available time periods are: 1 day, 1 week, 1 month, or a specific date in the YYYY-MM-DD date format. Defaults to an empty string, which means no repeat voters are blocked.
  • show_results_link
    Display a link to view poll results without submitting the form? Supported values are: true, false. Defaults to ‘true’.(optional)
  • display_results
    Display poll results automatically when the form is submitted? Support values are: true, false. Defaults to ‘true’.(optional)
  • percentages
    Display results percentages as part of results? Support values are: true, false. Defaults to ‘true’. (optional)
  • counts
    Display number of times each choice has been selected when displaying results? Support values are: true, false. Defaults to ‘true’. (optional)

Most of the parameters available for the Poll shortcode action are optional. A form can be presented as a Poll without including most of these parameters. For example, to present a form as a poll using a minimal numer of options and relying on defaults you could use the following:

[gravityform action="polls" id="1"[

At a minimum you will most likely want to use the cookie parameter to enforce blocking repeat voting via cookie.

Poll Widget

The Poll widget is a new Gravity Forms widget that will be installed and available when the Gravity Forms Polls Add-On is activated. You can add the Poll widget to any Sidebar on your site and use this widget to display a form as a poll.

When adding a Poll widget to a sidebar, you will be able to configure several options related to displaying the poll.

  • Title
    Enter the title of the widget. This will be displayed in your theme as the header title for that widget.
  • Select A Form
    Select the form you would like to display. This should be a form containing Poll Fields.
  • Display Form Title
    Checkbox to enable or disable display of the Form Title when the form is displayed in the sidebar. Defaults to disabled.
  • Display Form Description
    Checkbox to enable or disable display of the Form Description when the form is displayed in the sidebar. Defaults to disabled.
  • Display Form Confirmation
    Checkbox to enable or disable display of the Form Confirmation message then the form is submitted. The Poll Results will automatically be displayed, so only enable this option if you would also like to show your form confirmation message. Defaults to disabled.
  • Display Mode
    Select if you would like to display a Poll or Results. Setting the Display Mode to Results allows you to display the results of a Poll without allowing the user to actually submit the Poll. This is useful when you would like to feature the results of a past Poll. Defaults to Poll.
  • Display Results After Voting
    Checkbox to enable or disable display of the poll results after the form is submitted. Defaults to enabled.
  • Show Link to View Results
    Checkbox to enable or disable display of link to view results prior to submitting the form. Defaults to enabled.
  • Show Percentages
    Checkbox to enable or disable display of individual choice counts as percentages when poll results are displayed. Defaults to enabled.
  • Show Counts
    Checkbox to enable or disable display of individual choice counts when poll results are displayed. Defaults to enabled.
  • Style
    Select which visual style you would like for the poll results display. Available choices are: Red, Green, Orange and Blue. Defaults to Blue.
  • Repeat Voters
    Select if you would like to block repeat voting via cookies. If you opt to block repeat voting you will then be able to configure an optional expiration for the cookie. Defaults to disabled.

Poll Merge Tags

The Polls Add-On introduces two new Gravity Forms Merge Tags that can be used anywhere within Gravity Forms where merge tags supported. Merge Tags are primarily used in the Form Confirmation message and Notification messages to output the results of a Poll Field or All Poll Fields within the content of the message. The Polls related merge tags also introduce parameters to the Gravity Forms Merge Tags.

{all_poll_results}
Displays the results of all Poll Fields that exist in the form.

Example:

{all_poll_results: style="green" percentages="true" counts="false"}
  • style
    The Add-On currently supports 4 built in styles: red, green, orange, blue. Defaults to ‘green’. (optional)
  • percentages
    Display results percentages as part of results? Support values are: true, false. Defaults to ‘true’. (optional)
  • counts
    Display number of times each choice has been selected when displaying results? Support values are: true, false. Defaults to ‘true’. (optional)

{gpoll}
Displays the results of a specific Poll Field defined in the merge tag.

Example:

{gpoll: field=2 style="red" percentages="true" counts="true"}
  • field
    The id of the field you would like to display. (required)
  • style
    The Add-On currently supports 4 built in styles: red, green, orange, blue. Defaults to ‘green’. (optional)
  • percentages
    Display results percentages as part of results? Support values are: true, false. Defaults to ‘true’. (optional)
  • counts
    Display number of times each choice has been selected when displaying results? Support values are: true, false. Defaults to ‘true’. (optional)

Frequently Asked Questions

How do I reset the results of a poll?

As with PollDaddy and other more advanced poll solutions, the poll results are calculated using form entry data. This means a Poll cannot be reset by simply resetting some sort of count. It can only be reset by deleting the data.

If you have a form which has the primary function of being a Poll Form we would suggest deleting the entries. You may export them before deleting them if you would like to archive the existing data.

If you have a form which asks non-Poll questions and you’d like to retain the entry data for that form while resetting the Poll Field related data, you would need to edit the form and delete the Poll Field(s) which would then delete the entry data for those specific fields. You could then re-add new Poll Field(s).

How do I view the results of a poll?

You can view the results of a Poll Field by either using the view results link when displaying a Poll via a widget or shortcode OR by viewing any entry submitted by the form in question.

We do plan on creating more robust reporting capabilities, but those will come in a later release.

Go here to poll documentation

CONTACT US

We're not around right now. But you can send us an email and we'll get back to you, asap.

Sending

©2017 Chad E. Cooper.com Site using a premium theme updated by  Cognizion.com

Log in with your credentials

or    

Forgot your details?

Create Account