Follow for free plugins, new theme releases and theme news
Plugin Description
This is a small, lightweight plugin that will allow you to add content from Choozler. At choozler.com, users create polls and opinions–we call them Choozlets–to foster discussion and debate. With this plugin, you can select any Choozlet and add it as a widget to your site.
We’ve also made Choozler’s powerful notification system available to the widget. This means that any time a user from your site votes on a Choozler poll used in your widget, a notification (via message/email/browser push) is sent to the Choozler community. The notification includes an active link to your site. Why did we do this? Because we want to send you traffic and, hopefully, you convert some to regular visitors to your site. The idea here is that this plugin will benefit your site as well as Choozler. Note that this plugin is free. 100%, completely, totally free. We aren’t going to try to upsell or make you pay for extra features.
Although the Choozler website has its own branded look and feel, our widget has many options for you to customize the content that will be displayed on your site. But only one option is required.
* Choozlet Id: This is a unique, fifteen character Id that is given to every Choozlet. You’ll find this Id on each Choozlet page.
You can use any Choozlet Id in your widget, but polls with user selectable choices (as opposed to opinions which may not have any choices) probably make the most sense so that your users can interact with the widget. The best thing to do is sign up at choozler.com and create your own Choozlets, then use them on your site to compliment your page.
So, the process is pretty straight-forward:
1. Create a Choozlet at Choozler (or find an existing one).
2. Copy the Choozlet Id.
3. Paste the Id into the “Choozlet Id” option.
Social Media
- Follow us on Twitter: (http://www.twitter.com/choozler)
- Like us on Facebook: (http://www.facebook.com/choozler)
Feedback
Thank you for using the Choozler plugin. We are open to–and look forward to–suggestions and feedback.
* Email me at: rich@choozler.com
* Contact page: (https://www.choozler.com/contact)
Options and Option Values
- When an option uses a color value, any valid hex color code or HTML color name is acceptable. For example: “#dcdcdc” or “yellow.”
- When an option uses a size value, the value should inlcude the unit type “px” or “%” at the end. For example: “5px” or “80%.” If you leave out the unit type, then “px” will be used. Note that “em”, “pt” or any other units are not valid.
- Some options require a number that is not units. For example: “Main Text Length.”
Choozlet Id
Description: The unique Id given by Choozler to each Choozlet. This tells the widget what content to display.
Values: Any valid Choozlet Id. Find this Id at choozler.com. Go to any Choozlet page and you will see an “Id” link. Clicking this link will display the Id. Copy/paste it into this widget option.
Placement
Description: The location on the page where you want the widget to display.
Values:
* slide-from-left: The content is hidden offscreen. A tab is placed on the left side of the screen. Click the tab and the content will slide into view from the left.
* slide-from-right: Same as above, but the tab is on the right side of the screen and the content slides in from the right.
* slide-from-bottom: Same as above, but guess where the tab is located 🙂 ?
* inline-widget-area: The widget will display in the flow of widgets in the widget area.
* inline-body: The widget will display in the flow of content in the body of your page. Note that this requires the copy/paste of a WordPress Shortcode that is generated when you select this value.
Align
Description: Only for inline widgets. Aligns the widget relative to its parent container. If you don’t create a parent container, then the widget area or body is the container.
Values: left, middle, right.
Background Color
Description: Sets the background color of the widget.
Values: Any valid hex color or html color name.
Border Color
Description: Only for inline widgets. Sets the color of the widget’s border.
Values: Any valid hex color or html color name.
= Border Size=
Description: Only for inline widgets. Sets the thickness of the widget’s border.
Values: Valid number in pixels. Set to 0px for no border.
Height
Description: Sets the height of the widget.
Values: Any valid number in pixels or percent.
Notes: For sliders, the default value is 100% of the browser window. For inline widgets, we calculate the needed size based on the content. You can override this default value by setting “Height.” You might want to do this for a number of reasons. When we calculate the needed height, we don’t know the width you will use. The width might vary depending on the parent container. We also don’t know how much text you will choose to display (see Main Text Length option). Because of these variables, the calculation may be a little too low, resulting in scrollbars when you wouldn’t expect them. In this case, just set the height manually. Remember, this only applies to inline widgets as sliders are, by default, 100% in height.
Link Love
Description: Allows a link back to Choolzer to be placed in the lower right corner of the widget. By default, this is off, but turning it on will give a better user experience as well as provide SEO value to both your site and Choozler.
Values: yes, no.
Main Text
Description: When a Choozlet is created, it must have a title (75 characters max). It can also, optionally, contain a question that is longer. In your widget, you can choose whether to display the title, the question, or both. We refer to this as the “main text” of the widget.
Values: title, question, both.
Main Text Bold
Description: Sets whether or not to display the main text as bold.
Values: yes, no.
Main Text Color
Description: Sets the color of the main text.
Values: Any valid hex color or HTML color name.
Main Text Length
Description: Sets the limit for the number of characters of main text to display.
Values: Any valid number. Set to 0 for no limit.
Main Text Size
Description: Sets the font size of the main text.
Values: Any valid number in pixels.
Main Text Weight
Description: Sets the weight of the main text font.
Values: fine, light, medium, heavy, heaviest.
Margin
Description: Only for inline widgets. Sets the margins for the widget. This will override the setting in the “Align” option. You might want to use this to alter spacing with elements above or below the widget.
Values: Valid CSS syntax for margin values. For example: “5px 10px 5px 20px” or “10px”
Option Trim Background Color
Description: Sets the background color for the left and right sides of the user-selectable choices in the widget. This includes the checkbox on the left and the statistics box on the right.
Values: Any valid hex color or HTML color name.
Option Trim Foreground Color
Description: Sets the foreground color for the left and right sides of the user-selectable choices in the widget. This includes the checkbox on the left and the statistics box on the right.
Values: Any valid hex color or HTML color name.
Rounded Corners
Description: Only for inline widgets. Sets the amount of rounding the widget corners will have.
Values: Any valid number in pixels. Set to 0 for no rounding.
Shadow
Description: Sets whether a shadow should be displayed around the widget.
Values: yes, no.
Shadow Color
Description: Sets the color of the shadow.
Values: Any valid hex color or HTML color name.
Show Image
Description: When a Choozlet is created, an image can be included. You decide if you want to show the image or not.
Values: yes, no.
Status
Description: Sets the widget to active or inactive. This is useful for taking a widget from view temporarily, but not losing its settings.
Values: active, inactive.
Tab Style
Description: For slide-from widgets only. Sets the size of the tab.
Values: large, medium, small
Tab Position
Description: For slide-from widgets only. Sets the position of the tab along the side of the screen (left, bottom, right–depending on the “Placement” option).
Values:
* left: Positions the tab at the far left of the screen when “Placement” option is “slide-from-bottom.”
* right: Positions the tab at the far right of the screen when “Placement” option is “slide-from-bottom.”
* bottom: Positions the tab at the bottom of the screen when “Placement” option is “slide-from-right” or “slide-from-left.”
* middle: Positions the tab in the middle long the left, right, or bottom border.
* Any valid number in pixels or percent. This number will be used to position the top of the tab (for slide-from-left/right) or the left of the tab (for slide-from-bottom).
Titlebar Color
Description: For slide-from widgets only. Sets the color of the title bar.
Values: Any valid hex color or HTML color name.
Width
Description: Sets the width of the widget.
Values: Any valid number in pixels or percent.
Z Index
Description: For slide-from widgets only. Sets the z-index of the tab and slide in content. This determines whether other elements might display on top of the widget. We start with a very high value (1000000) so this should not need to be changed. However, if there is another element on the screen with a higher z-ndex, you can increase this value to keep the Choozler widget always on top.
Values: Any valid number.
Screenshots
Two widgets: one in the widget area and one in the document body.
A widget in the document body.
A “slide-from-left” tab on the left side of the screen.
A widget that slid in from the left.
Widget options screen showing Choozlet Id filled in, and an information popup.
Find the Choozlet Id at choozler.com
Widget options screen showing the Shortcode needed for putting a widget in the document body.
The Shortcode pasted in to the body during edit mode.
A screen with nine slide-in tabs with various locations and sizes.
