Poll Plugin Developer Guide - Template Composer - BloomReach Experience - Open Source CMS

This article covers a Hippo CMS version 10. There's an updated version available that covers our most recent release.

12-05-2015

Poll Plugin Developer Guide - Template Composer

Setup in the Template Composer

If you want to enable your webmaster to drag'n'drop poll components into one or more containers on your pages (rather than determining the page layout in advance by  instantiating poll components), this is how to setup the poll component in the Template Composer.

Create the container(s)

In order to be able to drop poll components into pages, the pages need to have one or more HST component containers. See  here for information on setting up containers. For starters, there is a container already setup for you on the homepage of the archetype project.

Prepare the component

The default poll component (class) provided by the Poll plugin is droppable out of the box since version 1.05.06. If you use your own poll component class, you have to add it to the CMS catalog of droppable components. You do this on the CMS Console: Navigate to  /hst:hst/hst:configuration/[your project]/hst:catalog/[your project]-catalog and add a  hst:containeritemcomponent with the name you want the droppable component to have in the CMS Channel Manager. Add the default attributes that should be copied when the dropped component gets instantiated.

The screenshot below shows the attributes of the droppable poll component provided by the plug-in. If you use your own custom component class, the hst:componentclassname should point to it. If you use your own custom rendering code, the hst:template should point to your own template. The  hst:xtype attribute must be present and set to  HST.Item.

The Configuration page explains how to add your Poll component to a page.

 

Did you find this page helpful?
How could this documentation serve you better?
On this page
    Did you find this page helpful?
    How could this documentation serve you better?