Voting Widget

Contents

Overview
Setup
Sorting
Layout
Options
Sharing
CSS Tips

Overview

Use the Voting Widget to display Form entries. 

Setup

Use the Select a Form drop-down menu to choose a Form.

Only show approved entries

Check the Only show approved entries box and the Voting Widget will display only the entries you have approved. To approve entries, go to  Forms/Entries, click View Entries for the database, and then click the Approvals button.

Voting Round

Use the Voting Round drop-down menu to select the number of voting rounds. Leave it set to  1 unless you are setting up a contest with multiple rounds of voting. Most contests employ just one voting round. To learn more about this setting, see How to Create a Multi-Round Voting Contest and Using the Voting Widget for Non-Voting Purposes.

Disable Voting

Check the  Disable Voting box to hide the vote button. When this box is checked, the Voting Widget simply displays the entries the Form receives.

Voting Restrictions

Use the Voting Restrictions check boxes to chose how ShortStack keeps track of voters.

  • No Restrictions: Anyone can vote as many times and for as many entries as they would like.
  • Cookies: Voting restrictions are enforced by storing a unique visitor ID in a cookie on the voter's browser. Voters can circumvent this restriction and vote again by clearing their browser's cookies.
  • Facebook Log In: Voting restrictions are enforced by requiring users to log in with Facebook.
    • Require Verified Facebook Accounts: Some Facebook users create multiple Facebook accounts so that they can cheat in voting competitions, even though Facebook’s Terms limit the number of personal profiles per individual to one. 

      Verified Accounts are personal Facebook profiles that are authenticated with a mobile phone number. First a user submits his or her phone number to Facebook. Facebook then sends a special code in a text message to that phone number. When the user enters that code, his or her account is verified. Since any given phone number can only be used to authenticate one Facebook profile, requiring a verified account for all voters is a reliable means of curbing voting fraud. We recommend enabling this field, especially when offering valuable prizes.

Note: With Facebook Log In restrictions enabled, ShortStack asks voters for permission to access their Facebook accounts by presenting them with the Permissions Prompt. This is required so that ShortStack can use the voter’s Facebook ID to enforce voting restrictions. ShortStack does not access, store, or distribute any of the voters’ other information. To customize the Permissions Prompt, see Customizing Your Custom Published Campaign.

Users can vote

Use the drop-down menus to select how many times and how often a user can vote.

Note: Setting voting to “every 1 day” is equivalent to every 24 hours. Because of confusion surrounding different time zones for users and the Pages they’re interacting with, we do not have an option to vote the next calendar day.

Sorting

Sort Entries

Use the Sort Entries field to select how the widget sorts entries. Most to Least is not typically used during the voting phase because it shows the entries with the most votes at the top. However, Most to Least is great when you want to show the entries with the most votes after voting has ended.

Randomly can only be used when all entries fit on one page (which is influenced by the Entries per Page setting). If you select Randomly and you have more than one page of entries, sorting will revert to Newest to Oldest.

Entries per Page

Enter a number between one and 30 to choose the number of entries per page. When the number of entries exceeds the number per page, page controls appear at the bottom of the widget for navigating between the pages.

Note: If a form has more than 1,000, ShortStack will alter the page controls to improve performance.

Layout

Choose from the pre-defined layouts, or choose Custom Layout to build your own.

All layouts can be customized with CSS. It is recommended to further customize custom layouts with CSS.

Options

Hide vote count

Check the Hide vote count box to hide the number of votes each entry has. This feature is especially useful when using the Voting widget for non-voting purposes.

Zoom shows extra large image

When a user submits a photo, ShortStack creates and stores four sizes of the image: thumbnail (100x100), medium (200x200), large (400x400), and extra large (1000x1000). Normally, clicking a thumbnail or medium size image will show the large size in a popup. To show the extra large size instead, check the Zoom shows extra large image box. You’ll probably want to turn on the Open images in new window option, too (see below).

Open images in new window when clicked

When a user clicks on a thumbnail or medium-sized photo, the large version of the image opens in a popup window. This popup is restricted because it is not a separate browser window, but part of the IFrame that’s displaying the Campaign. Check the Open images in new window when clicked box to open images in a new browser window.

Preserve whitespace in TextArea fields

Check the Preserve whitespace in TextArea fields box to preserve any line breaks and extra spaces users enter into the Photo Description field or any custom TextArea field. If you uncheck this box, user-submitted text will collapse into a single paragraph.

Hide other field labels

If you check a custom field’s box in the Form Designer to display the field in the Voting Widget, ShortStack also displays the field’s label. Check the Hide custom field labels box to hide custom field labels.

Options for ‘Facebook ID’ Field

The Facebook ID Field collects entrants’ profile pictures along with their unique Facebook User ID numbers. By default, those profile pictures will appear to the left of the Name field in the Voting Widget. Check the Hide profile pic box to remove the pictures.

Check the Hide View All, Mine and Friends buttons box if you don’t want these buttons to be available to your visitors.

Options for ‘Name’ Field

By default, anything entered into the Name field in a Form is displayed next to the entry in the Voting Widget. Use the name drop-down menus to choose how - or if - ShortStack displays an entrant’s name.

Sharing

To enable sharing, use the drop-down menu to select a  Share Widget to connect to the Voting Widget. This will place a Share button next to each entry in the Voting Widget, giving entrants a chance to share their own individual entries, instead of the contest or Campaign. However, the only fields that accompany the Share are the Photo, Photo Title, and Photo Description fields. If these fields are absent from your form, the values you entered in the Share menu of the Campaign Settings accompany the Share.

CSS Tips

Preserving white space and line breaks in the Photo Description and TextArea fields.

If you’re running an essay-style contest, you’ll want to preserve the white space and line breaks as entered by the user to improve readability of the stories. Here’s how:

<code>.entry_description { /* <- Photo Description field */
  white-space: pre-wrap;
}
.entry_custom_fields div{ /* <- Custom 'TextArea' fields */
  white-space:pre-wrap;
}
Hide the field labels for custom fields

By default, the Voting Widget shows the field label followed by the value for each custom field. To hide all field labels, enter the following code:

<code>.entry_custom_field_label{
  display:none;
}
Notes on the Fields Shown in the Voting Widget

When designing your form, keep in mind that the following Standard fields are shown automatically in the Voting Widget: Name, Photo Title, Photo Description, and Photo. These can be hidden with CSS.

Custom fields can also be displayed, but you must edit the field in the Form Designer and check the Display in Voting Widget box. The lone exception is the Video URL field, which has the box checked by default.