Getting Started - Creating Your First Poll Widget
Welcome to Klix. Let's get our widget added to your website!
It's really easy to do and shouldn't take you more than 15 minutes.
#What is a Widget Anyway?
Generally speaking a website widget is a small embedded tool on a web page that provides specific functionality or interactive features to that website. Widgets such as ours are often used to enhance user experiences, engage visitors and provide added information or services.
Is a widget it different from an embed?
We often use the term Widget and Embed interchangeably in our documentation and on our website.
#Creating Your First Poll Widget
We currently offer only one type of widget (more are coming!). The poll widget.
Before you can add our snippet of code to your website, you must first create a widget. You can do this from your dashboard.
- In the menu bar on the left side, select Poll Widgets.
- Then click the New Poll Widget button.
- A wizard screen should appear to ask you some initial information about your widget, such as:
- A friendly name
- An initial poll question.
- Whether and what to show in your 'call to action' overlay.
#Adding Klix Embed Code
Klix works by adding a small snippet of code to your website in each location that you want one of our widgets to appear. If you want to understand how our widget works, and why it works like it does read: How does it work?
Once your widget has been created, you will be able to copy the Embed Code that you need to install on your website in order for it to display.
This is simple to do, and we provide step-by-step instructions for many different platforms:
Each widget that you create within your dashboard has a unique code snippet associated with it.
This is because you can have multiple widgets on your website. For example you may want to create these polls for your website:
- A sidebar poll that allows users to rate the content of every page on your site.
- A poll inside a particular page or article that asks questions related to the topic of that article.
Each of these would be a different widget instance and have a different Embed Code or snippet.
#Adding More Questions to Your Poll Widget
When you create a poll widget you are asked for an initial question. However, each poll widget can actually have multiple poll questions.
Your widget will randomly select the initial question for each user when they visit. A widget with multiple questions configured will allow the user to click through to other questions after answering the first. Increasing their site engagement time.
To add more questions to your poll widget:
- From your dashboard, click Poll Widgets.
- Click on the widget you want to add more questions to.
- On the widget page, fin the Polls list at the bottom.
- Click New Poll
You may add as many polls as you want to a particular widget.
#Viewing Poll Results and Polling Activity
Your overall polling activity is shown on your dashboard.
In order to view the results of a specific poll you need to click the Poll Results link in your dashboard menu.
This will show you a list of all your configured poll questions across all your widgets, and allow you to view the results for that poll by clicking the question row, or clicking Results, or view the logs of votes cast by clicking Vote Logs.
