Widgets

Last updated on
27 December 2019

Drupal 7 will no longer be supported after January 5, 2025. Learn more and find resources for Drupal 7 sites

Introduction

Widget in Drupal 7 are stored in custom table that are used to register widgets using $p("register"). For full documentation about $p("register") please visit the official documentation page. Widget creation page has the following 4 sections. 

In order to create widgets, you need to enable LiftIgniter UI Sub Module. Atleast one published templates needed for creating or updating widgets.

Details

General details about the widgets to be register. It has the following properties.

SCREENSHOT TO BE ADDED

Widget

Provide a widget ID to register in LiftIgniter. This will be used in tracking the performance of the widget.

Selector

HTML selector were the widget will be rendered. While querying the selector in the frontend, if it is not present the widget will not be rendered.

No. of Items

Choose a method to calculate the Maximum no. of inventory items to be returned from LiftIgniter

Dynamic (Use Element length as Max)

Choosing this option will determine the Max. no. of items in the runtime while registering the widget.

Static

Choosing this option will display the blow field to get the maximum no. of items.

Maximum no. of items

This field will be shown only when the "No. of Items" choosed as "Static". This denotes the maximum no. of items that LiftIgniter need to return for rendering this widget.

Custom Options

Csutom options to be included in the query param. You can use custom rules by contacting LiftIgniter.

AB Testing

Option to use AB testing for the current widget

SCREENSHOT TO BE ADDED

Enable

Enable to add AB testing to the current widget.

Slice

Slice value for the AB testing.

Renderer

This section denotes how a widget needs to be rendered. It have the following properties

SCREENSHOT TO BE ADDED

Rendering Method

Below are the 2 methods that the widget will be rendered.

Render all Inventories

All the result Inventories will be rendered fully in the given selector. This will be usefull if the inventories needs to be rendered in one specific place of the current page.

Render Inventories one by one

This will render the resulted inventories one by one on each selector. Will be usefull if the inventories needs to be rendered in different places of the current page.

Selector

HTML Selector to render the widget.

Note: This can be same as widget selector. This can be different from the widget selector if you need to be more specific with the renderer selector for "Render Inventories one by one".

Template

Template option used to render the widget. All the published templates will be shown here.

Caution: Choose the templates based on the rendering method as the same template cannot be used for both the rendering methods. If same template is been followed for both the rendering methods for any two widgets, you need to create seperate templates as mentioned in the template section.

Tracking

There are 2 types of tracking LI (LiftIgniter) and Base (base). Each of the tracking options will have th following properties.

SCREENSHOT TO BE ADDED

Enable

This option is used to enable or disable a particular type (LI or Base) of tracking.

Tracking Method

There are 2 types of tracking method.

Anchor

Chosing this option will add anchor tracking (LI or Base) $p("track") to the current widget. Most of the widgets will use this method as almost all the widgets will have inventory field url while rendering. 

Non-Anchor

There are some cases where you might not use inventory field url while rendering the widgets. Such cases are treated as non-anchor tracking

Caution: This is under development. Choosing this will not track any LiftIgniter Items.

Selector

Selector for which the tracking needs to be added.

Note: This can be same as widget selector. This can be different from the widget selector if you need to be more specific with the tracking.

Debug

This option will be shown only when the tracking method is Anchor. Enabling will add debug property to the $p("track") function.

Help improve this page

Page status: No known problems

You can: