Use the Entry Display Widget to display entries that were submitted to your ShortStack lists via a Form Widget or via our Instagram/Twitter Feeds feature. You can also enable voting on those entries, for voting contests.
To add one of these widgets to your campaign, click the Entry Display Widget icon in the Add Widgets Panel, or click and drag the icon into your preview area.
The widget settings popup is where you'll make any needed changes to your Entry Display Widget. To change the widget name, click on the pencil icon in the top-left (next to the name) then type your new name.
You will also see the CSS ID (starting with a #) of your new widget listed in the top-right corner of the popup.
You'll want to move through each item in the menu on the left side to make sure you've completely customized the Entry Display Widget (and what you're displaying) in the way you'd like. You can navigate through these sections using the Back and Next buttons at the bottom.
When you're finished making changes to your widget, click the blue Save and Exit button.
In the Entry Source section, select the list that has the entries that you're wishing to display. To select a list, click on the link after Show entries from.
Then, select your list from the popup.
To create a new list, click on Create New Entry Source.
In the popup, enter a name, the number of test entries to add to the new list, and any needed tags. Then click the Create and Continue to Form Designer button to continue creating your form, which will be what feeds entries to your new list.
More information on building forms is available in the Form Designer help doc.
To arrange the order in which your entries are shown, use the settings in the Display Options section. To start, use the Sort entries from link to arrange your entries from newest to oldest, least to most votes, or most to least votes.
You can use the Entries per page field to set how many entries are shown before the widget starts adding additional pages. The maximum is 30 entries per page.
Note: If you need to display more than 30 entries per page, reach out to our support team for assistance.
You can choose Include or Do not include unapproved entries in the Filtering section. Not including unapproved entries allows you to curate entries before they're shown live on your campaign.
You can also choose if you want to filter your entries by the number of votes/points each entry has. The default is Do not filter.
Click to switch over to Filter and additional options will pop in. Use the field to change how many of the top entries you'd like to display, and use the dropdown to choose which voting round (if you have more than one).
The Fields section is where you can tweak different settings that affect how your entries are displayed in the widget.
The first thing you'll notice are the checkboxes on the right. These are how you'll determine what shows in the tiles for each entry (in the campaign view) and what shows in the popup that appears when you click any given tile. Simply check the box if you want that item to appear, or uncheck it if you don't.
There are additional options available for the Entrant name/user name field - click on the down arrow to expand that section.
Click on the link after Show to select how you want the name to be displayed on the entries. Your options are First name & Last initial (the default option), First name & Last name, First name & Last initial, First initial & Last name, First name only, Last name only, or you can choose to Hide the name completely.
If you've chosen to include Facebook Login as part of your entries, you can select whether to Show or Hide the entrant's Facebook Profile Image in the entry here.
Media sorting options can be changed by clicking the down arrow next to Photo/Videos on the right.
You'll then see how to change what media shows by default in the entry's tile. Clicking the link, you'll see your options are first uploaded media, first video uploaded, or first photo uploaded.
You also have more settings when it comes to the media that is uploaded with each entry. Click on Advanced Options to expand this section.
Here, you can toggle between the options for your custom field labels - select Hide or Do not hide.
If you're looking to let the public vote on your entries, you can set that up in the Voting section. Click the link after Voting is to set it to enabled or disabled.
Directly beneath that, you can set whether or not to show your votes. You can toggle the vote count link to Show or Hide.
For multi-round voting contests, you have the option here to switch between voting rounds.
Determine how many entries are shown in each round using the Filtering tab.
You can schedule when you want voting to start and end using the Start/Stop voting on specific dates section. Simply use the fields to set a Start and End date, and make sure to choose a Time Zone; to alleviate any confusion, you'd generally want the time zone set to the geographical location of your entrants.
Note: This section will only be visible if voting is enabled.
ShortStack gives you a few different tools for enforcing voting rules in your campaign in the Restriction section. Use the Restrict votes by link to choose between our four different restriction methods:
- No Restrictions: Anyone can vote as many times and for as many entries as they would like.
- Anonymous Fingerprint: This option uses a combination of the voter's browser version and anonymized IP address. Before storing, we anonymize the information with a one-way cryptographic hash. This ensures that no part of this information can trace the vote back to a specific person or machine; this method is GDPR compliant.
- Anonymous IP: This option is a little bit stricter than Anonymous Fingerprint, as it uses only an anonymized version of the voter's IP address without the browser data. Voters in the same network (typically in an office environment) may run into issues with voting more than once.
- Email address: (Available on Agency Plan or higher) Selecting this allows you to restrict votes by having the voter submit an email address, which then has to be verified via an emailed code for the vote to count.
Below that, you can set the frequency at which people can vote for entries. Enter a value into the Participants may vote field.
Next, select whether the visitor can vote that many times per entry or per campaign.
Then choose only or every.
Selecting every will provide more timing options. Click the link to choose between days, hours, minutes, seconds, or calendar days, then enter the number of your selected unit in the field.
When you're done, your options should read as a clear statement saying how often visitors can vote:
If you'd like to change the message that displays when someone has already voted, you can do so using the Error message... field.
In the Additional Options section, you can enable a hidden Captcha for the Voting Widget that is completely transparent to the voters. It uses Google's reCaptcha behind the scenes to decide if the voter is a bot. If it thinks they are, it will reject the vote. With the slider bar, you may adjust the sensitivity - higher is more restrictive.
For information on how reCaptcha decides who is a bot and who isn't, you can check out this page.
Note: A voter accessing the campaign in their browser's Incognito Mode will likely trigger the bot detection.
Additional Email Address Restriction Settings
Selecting the Email address restriction will require a bit of additional configuration. For more information on that process, check out our Setting Up Email Login for Voting help doc.
You can change any of the default Text that appears in the widget by making changes here. Find the text that you want to replace in the left column, then type your replacement text in the field immediately to the right.
Fine-tuning how the entries can be shared is done in the Sharing section. To start: you can toggle between whether sharing is enabled or disabled using this link at the top.
If you set the sharing to enabled, more options will pop in allowing you to get more granular with your entry sharing.
Now, choose between whether you want to use the entry settings or custom settings for the title, description, and image. Choosing entry will automatically pull from the information submitted in the Entry Title and Entry Description form fields.
If you toggle the options to custom, you'll be able to use the bottom section of the popup to adjust your title, description, and image for each social channel.
Check the box to the left of the channel name to include that channel in your sharing options. Click the channel name to highlight it, and you'll see the options for that channel appear on the right - write in your custom titles and descriptions in the fields provided. Click the + icon to upload your own custom image.
If you'd like to limit visibility of the widget to a specific date and time, make the widget a popup, only show the widget in your Builder, or limit in which country/countries the widget can be seen; you'd do so here. More information about these settings can be found in the Widget Visibility help doc.
In this section, you can add a CSS Class that will be associated with the Entry Display Widget - that way you can target it with custom CSS code. Rules and naming conventions are provided so that you don't use a class that won't work. Simply add your CSS class(es) to the Extra CSS Classes field.