—Image—

Overview

A widget consists of 3 file types.

.ascx—contains a widget’s source code
.ascx.cs or .vb—contains widget’s code-behind
.ascx.jpg—image that represents a widget in the widget selection tool

When you create a widget, save the widget files to the siteroot/widgets folder. This folder path is defined in the site root/web.config file, so if you change the folder name or path, you must update the following web.config element:

<add key=”ek_widgetPath” value=”Widgets/" />.

NOTE: Your widget might use additional files, such as .css or .js files.You should place these files in a folder within siteroot/widgets, and give the folder the same name as the custom widget.

Ektron stores each page’s data (a serialized XML string) as a type of content in the Ektron Workarea. The string is stored like other content types, such as HTML content and XML Smart Forman Ektron-defined Web page that contains XML (hidden from the end user) to display content, and receive, verify, and save user input.s.

After you integrate widgets into Ektron, you can add them to a dashboard in your profile page or a community group’s page. You also can drag-and-drop these building blocks onto a PageBuilder page or a Personalized Web page. See Also: Creating Web Pages with PageBuilder and Personalizing a Web Page.

Content authors open the widget bar from the PageBuilder menu by clicking the up/down () or down () controls. For HTML5 CSS3-compliant browserAll browsers are supported EXCEPT for the following versions *and older*: IE 8, Chrome 3 and older, Firefox 3 and older, Safari 3 and older, and Opera 10 and older.s, click Switch to Edit, then click on Design. The PageBuilder menu appears; open the Widgets panel.

Creating the "Hello World" widget

Creating the “Hello World” Widget

NOTE: For more information on creating widgets, see Break It Down! Widget Development How-to (Part 1).

To learn how to create a widget, create a simple widget in the siteroot/widgets folder. This widget is based on the Hello World widget that is installed with the sample site with the following files:

HelloWorld.ascx—user control file
HelloWorld.ascx.cs—user control code-behind file
HelloWorld.ascx.jpg—image that represents this control on the widget menu

Understanding the user control (.ascx) file

Understanding the User Control (.ascx) File

Here is the new_widget.ascx file that is the basis of the widget.

<%@ Control Language=”C#” AutoEventWireup=”true”
  CodeFile=”new_widget.ascx.cs” Inherits=”widgets_new_widget” %>
<%@ Register Assembly="System.Web.Extensions,
  Version=1.0.61025.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"
  Namespace="System.Web.UI" TagPrefix="asp" %>
    <asp:MultiView ID="ViewSet" runat="server" ActiveViewIndex="0">
        <asp:View ID="View" runat="server">
            <!-- You Need To Do ..............................  -->
<asp:Label ID="TextLabel" runat="server"></asp:Label><br />
<asp:Label ID="CheckBoxLabel" runat="server"></asp:Label>
            <!-- End To Do ..............................  -->
        </asp:View>
        <asp:View ID="Edit" runat="server">
            <div id="<%=ClientID%>_edit">
                 <!-- You Need To Do .............................  -->
<asp:TextBox ID="TextTextBox" runat="server" Style="width: 95%">
</asp:TextBox><br />
<asp:CheckBox ID="MyCheckBox" runat="server" Checked="false" />
<br />
                 <!-- End You Need To Do .........................  -->
<asp:Button ID="CancelButton" runat="server" Text="Cancel"
  OnClick="CancelButton_Click" />
<asp:Button ID="SaveButton" runat="server" Text="Save" 
  OnClick="SaveButton_Click" />
            </div>
        </asp:View>
</asp:MultiView>

Notice the following elements of the file.

The asp:MultiView element declares that the control has 2 possible modes: View and Edit.
```
<asp:MultiView ID="ViewSet" runat="server" ActiveViewIndex="0">
```
in view mode, the marketing team can see the control but not change it.
in edit mode, the developers can change the control’s content and properties.

Between the multiview tags is information about the control in view mode. It has 2 fields: one is a text field, and the other is a check box.

<asp:View ID="View" runat="server">
<asp:Label ID="HelloTextLabel" runat="server"></asp:Label><br />
<asp:Label ID="CheckBoxLabel" runat="server"></asp:Label>
</asp:View>

Also between the multiview tags is information about the control in edit mode. In edit mode, a text box, a check box, and a Save button appear. The text box and check box collect end-user input, and the Save button saves that input to the database.

<asp:View ID="Edit" runat="server">
<div id="<%=ClientID%>_edit">
<!-- You Need To Do .............................. -->
<asp:TextBox ID="HelloTextBox" runat="server" Style="width: 95%"> 
</asp:TextBox><br />
<asp:CheckBox ID="MyCheckBox" runat="server" Checked="false" /> <br />
<!-- End You Need To Do .............................. -->
<asp:Button ID="CancelButton" runat="server" Text="Cancel" 
  OnClick="CancelButton_Click" />
<asp:Button ID="SaveButton" runat="server" Text="Save" 
  OnClick="SaveButton_Click" />

Understanding the code-behind (.ascx.cs) file

Understanding the Code-behind (.ascx.cs) File

Review the code-behind file,new_widget.ascx.cs.

A series of using statements are at the top of the file. Notice the Ektron ones in particular:

using Ektron.Cms.Widget;
using Ektron.Cms;Marketing team
using Ektron.Cms.API;
using Ektron.Cms.Common;
using Ektron.Cms.PageBuilder;
using System.Text.RegularExpressions;

Next, note a widget host class, which inherits the system.Web.UI.UserControl and IWidget classes.
```
public partial class widgets_new_widget: System.Web.UI.UserControl, IWidget
```

The following figure summarizes the remaining elements of the code-behind file.

In the next line, notice the widget’s properties: a string for the text field, and a boolean for the check box. You define the variables and their type here. Possible types are string, integer, long and date.

#region properties
private string _HelloString;
private bool _CheckBoxBool;
[WidgetDataMember(true)]
public bool CheckBoxBool { get { return _CheckBoxBool; } 
  set { _CheckBoxBool = value; } }
[WidgetDataMember("Hello Wolrd")]
public string HelloString { get { return _HelloString; } 
  set { _HelloString = value; } }
#endregion

The following is a widget host declaration.
```
private IWidgetHost _host;
```

The following is the widget’s page_init events.

protected void Page_Init(object sender, EventArgs e) 
  { _host = Ektron.Cms.Widget.WidgetHost.GetHost(this); 
    _host.Title = "Hello World Widget"; 
    _host.Edit += new EditDelegate(EditEvent); 
    _host.Maximize += new MaximizeDelegate(delegate() { Visible = true; }); 
    _host.Minimize += new MinimizeDelegate(delegate() { Visible = false; }); 
    _host.Create += new CreateDelegate(delegate() { EditEvent(""); }); 
    PreRender += new EventHandler(delegate(object PreRenderSender, EventArgs Evt)
      { SetOutput(); }); 
    ViewSet.SetActiveView(View); 
  }

Comments about the edit code

Comments about the edit code

IMPORTANT: You must register JavaScript and cascading style sheet (css) instructions in an external file.

The Edit event is triggered by the widgethost, and if you subscribed to it already, it will call the delegate here.
Use sitepath to ensure that the correct path for included files is used across installations.
Ensure that it works inside update panels by calling the scriptmanager to include the script. Alternatively, you can use Ektron.Cms.Api.Js.RegisterJSInclude ScriptManager.RegisterOnSubmitStatement(this.Page, this.GetType(), "gadgetescapehtml", "GadgetEscapeHTML('" + HelloTextBox.ClientID + "');");
The onsubmitstatement is JavaScript that is run when the widget is submitted. It calls escape html, which cleans the submitted text to avoid any XSS.
Notice the editing fields, so users can see the existing data.
HelloTextBox.Text = HelloString;
MyCheckBox.Checked = CheckBoxBool;
ViewSet.SetActiveView(Edit);

The following code is the widget’s save events.

protected void SaveButton_Click(object sender, EventArgs e) 
  { HelloString = ReplaceEncodeBrackets(HelloTextBox.Text); 
    CheckBoxBool = MyCheckBox.Checked; 
    _host.SaveWidgetDataMembers(); 
    ViewSet.SetActiveView(View); 
  }

The following code is the widget’s SetOutput events.

protected void SetOutput() 
  { HelloTextLabel.Text = HelloString; 
// client javascript remove brackets, server side adds back 
    CheckBoxLabel.Text = CheckBoxBool.ToString(); 
  }

The following code is the widget’s Cancel events.

protected void CancelButton_Click(object sender, EventArgs e) 
  { ViewSet.SetActiveView(View); }

The following code is for greater than and less than signs.

protected string ReplaceEncodeBrackets(string encodetext) 
  { encodetext = Regex.Replace(encodetext, "&lt;", "<"); 
    encodetext = Regex.Replace(encodetext, "&gt;", ">"); 
    return encodetext; }

Customizing a widget

Customizing a Widget

The following topics let you further customize widget behavior.

Applying global and local properties to a widget

Applying Global and Local Properties to a Widget

Global and local widget properties reduce your development effort by eliminating settings data classes. While you can still use these classes and manage your own serialization, for the vast majority of types, the built-in engine performs the necessary work.

Global properties apply to every instance of a widget. Local properties apply to one instance. If both local and global values are assigned to a property, local overrides global.

As an example of using a local property to override a global, consider a ListSummary widget. You may want its sort mostly by modified date in descending order, but in certain instances you want to sort by title in ascending order.

Global—Workarea > Settings > Configuration > Personalizations > Widgets

[GlobalWidgetData()]
public string NewWidgetTextData {
get {return _NewWidgetTextData;} set {_NewWidgetTextData = value;
}}

Local—Drop the widget onto PageBuilder page, then click edit (Pencil icon).

[WidgetDataMember()]
public string NewWidgetTextData 
  { get { return _NewWidgetTextData; } set { _NewWidgetTextData = value; } }

Adding a field to a widget

Adding a Field to a Widget

You can add a Content type drop-down to the ListSummary widget. The drop-down lets the person dropping the widget on the page select from these choices.

all types of content
HTML content only
assets only

The drop-down appears as follows after it is implemented.

To add this drop-down to the ListSummary widget:

In Visual Studio, open the ListSummary widget, siteroot/widgets/ListSummary.ascx.
Find the text DisplaySelectedContent.

Below DisplaySelectedContent, add the following code to create a drop-down list for the ContentType property.

Save the ListSummary.ascx file.
Open the code-behind file, ListSummary.ascx.cs.
In the properties region, declare a string variable for the ContentType property:
```
private string _ContentType;
```

Create a local property with default setting of AllTypes:

[WidgetDataMember("AllTypes")]
public string ContentType { get { return _ContentType; } 
  set { _ContentType = value; } }

In the EditEvent area, set the select list's value to ContentType:
```
ContentTypeList.SelectedValue = ContentType;
```
In the SaveButton_Click event, set ContentType as the select list's value:
```
ContentType = ContentTypeList.SelectedValue;
```
In the SetListSummary() function, set the List Summary server control's ContentType to the CMSContentType property:
```
ListSummary1.ContentType = 
  (CMSContentType)Enum.Parse(typeof(CMSContentType), ContentType);
```
Save the ListSummary.ascx.cs file.

Deleting a widget

Deleting a Widget

If you want to remove a widget from use:

Delete the widget’s files from the /siteroot/widgets/ folder.
Go to Settings > Configuration > Personalizations > Widgets and click Synchronize. The widget is removed from the list of widgets, and from the dashboard of any users and community groups.

Personalizing a website experience using the Targeted Content widget

Personalizing a Website Experience Using the Targeted Content Widget

The Targeted Content widget lets you personalize a site visitor's experience by providing content that matches their interests, thereby placing your site information in the context of your users. For example, the search keywords used to find your site might determine the best offer to show a prospect. Or, site members might explicitly state their interests by adding to their user profile or filling out a survey.

In both cases, the Targeted Content widget ensures the delivery of the right experience to compel each site visitor to take action. The widget lets you gather information from each interaction, and use that information to direct visitors to content that relates to their specific interests. See Also: 4 Trends that Shape the Future of Content Targeting

Targeting content is as easy as creating an email rule in Microsoft Outlook, or a playlist in iTunes. Each widget has 1 or more conditions. Each condition can have 1 or more criteria. For example, a condition may stipulate that the URL parameter terms contains either "pizza" or "Italian."

After assigning conditions to a Targeted Content widget, you assign one or more widgets to it. The widgets appear on the page only if a condition evaluates to true. To continue the example, if the page has a URL parameter that contains "pizza," display a Taxonomy Summary widget showing content to which the taxonomya content-level categorization system that uses one-to-many relationships (such as Ronald Reagan is to Actor, Governor, and President) to create a scalable organization of content. A taxonomy lets your site visitors navigate content independent of the folder structure. category "pizza" is assigned.

You can assign any number of conditions to the Targeted Content widget. As soon as one is true, its associated widgets appear, and any remaining conditions are ignored.

The Targeted Content widget can evaluate the following information about a page's site visitor.

search engine or URL that directed the person to the page
the page's URL parameters
the user's device, such as a Smart Phone
the page from which he was directed
regional information about the visitor: U.S state or country
information in the visitor's Facebook profile, such as if the person's marital status is single
whether a certain cookie is on the person's computer
if logged in
- user or membership group to which he belongs
- any of the person's custom user properties that match your criteria
the current date and time on the Ektron server

Creating a Targeted Content widget

Creating a Targeted Content Widget

Prerequisite

The Targeted Content widget must be on the list of widgets assigned to the page's template. See Also: Adding the Wireframe and Widgets into Ektron

Drag and drop the Targeted Content widget onto a PageBuilder page.
By default, the first condition is added to the widget. Click Edit Condition.
—Image—
Enter a condition name.
Click +or to set up the first condition and select an option from the drop-down list of condition criteria. See Also: Using Multiple Criteria in a Condition
—Image—
Criteria Options
- Search Engine—Use to specify widgets that appear
  - If a site visitor was referred to this page from any search engine (or not)
  - If the search engine from which the site visitor was referred is one of the following
    Google
    Bing
    Yahoo
    Other
    None
  - If the search engine's keywords are (are not, contain, start with, or end with) a specified value
- Referring URL—The referring host matches a string value (for example, www.example.com). Use this to determine the visitor 's originating site, such as a Facebook fan page.
- URL parameter—The current page contains the specified URL parameter. For example, you create a campaign selling gold jewelry and base its content on the URL parameter cid=gold.
  If the URL of the page that hosts the Targeted Content widget contains cid=gold (for example, http://www.mystore.com/product.aspx?cid=gold), then display widgets assigned to that Targeted Content widget.
- Cookie—A cookie matching the specified pattern is found on the site visitor's computer. Cookies are generally stored as name/value pairs, such as UserID—A9A3BECE0563982D. When checking for a cookie, you complete 3 fields.
  - cookie ID
  - logic (is, is not, contains, starts with, ends with)
  - a value
- Device Configuration—The user's device matches a Device Groups that you specify. For example, a content block displays only if a user accesses your website with a Smart Phone. See Also: Adding a Group by Device Models.
- BreakpointConfig—The user's device matches a breakpoint that was defined in Adding a Group by Breakpoint.
- Logged in—The user is or is not logged in.
- User is in group—Only applies to logged-in users. User is member of an Ektron User or Membership Group that you select from drop-down list.See Also: Membership Users and Groups, Managing Users and User Groups
- User is in community—Only applies to logged-in users. User is a member of an Ektron Community Group that you select from drop-down list. See Also: Managing Community Groups
- User Properties—Only applies to logged-in users. The value of the logged-in user's custom property satisfies the logic for the value you specify. See Also: Creating Custom User Properties
  Example:
  Zip code is a Custom User Property. You want to display a list of stores in New Hampshire for users whose Zip Code begins with 03.
  - Condition / result
  - Zip code = 03458 true
  - Zip code = 02103 false
- Date and Time: Day—The actual date (according to the Web server's clock) and a date you enter satisfy the specified logic.
  Logic operators:
  - is
  - is not
  - less than
  - greater than
  - equal to or less than
  - equal to or greater than
  Examples:
  - Assume today's date is 2010-01-01
  - Condition / result
  - Date = 2010-01-01 true
  - Date < 2010-01-01 false
  - Date >= 2009-12-01 true
- Date and Time: Day of Week—The current day (according to the Web server's clock) satisfies the specified logic.
  Logic operators:
  - is
  - is not
  Examples:
  - Assume today's date is 2010-03-01 (Monday)
  - Condition / result
  - Day of week is Monday true
  - Day of week is Tuesday false
  - Day of week is not Tuesday true
- Date and Time: Day of Month—The actual date (according to the Web server's clock) and a date you enter satisfy the specified logic.
  Logic operators:
  - is
  - is not
  - less than
  - greater than
  - equal to or less than
  - equal to or greater than
  Examples:
  - Assume today's date is 2010-03-01 (Monday)
  - Condition / result
  - Day of month is 01 true
  - Day of month is not 01 false
  - Date >= 2009-12-01 true
- Date and Time: Hour of Day—The actual hour (according to the Web server's clock) and number between 1 and 23 you enter satisfy the specified logic. The numbers are based on a 24 hour clock so, for example, 5 p.m. is 17.
  Logic operators:
  - is
  - is not
  - less than
  - greater than
  - equal to or less than
  - equal to or greater than
  Examples:
  - Assume current time is 18:30:00
  - Condition / result
  - Hour of day is 18 true
  - Hour of day is 23 false
  - Hour of day >= 12 true
- User Regional Info—Enter the user's country or state, or both. State selections are limited to states in the United States. This information is retrieved from the IP address of the person who is using your website. To retrieve this information, see Using GeoIP Information in the Targeted Content Widget.
- Facebook Info—If the criterion matches information in the user's Facebook profile, display the widgets inserted into this condition. For example, if the criterion is Marital Status is Single and the user's Facebook Profile matches that value, display the assigned widgets. This criterion only works with users who log in via Getting Started with Ektron. You can apply any of these Facebook fields.
  - Age
  - Gender
  - Marital Status
  - Likes
  - Employment
  Use Contains with Free Text Fields
  On fields that use free text (such as Likes), you should use the contains operator, as opposed to is or is not. Contains is more flexible and finds a partial match. For example, if the user likes U.S. Soccer and you enter the term soccer and the contains operator, a partial match is made, so the user sees the related widget. On the other hand, if the user likes U.S. Soccer and you enter the term soccer and the is operator, an exact match is not made, so the user does not see the related widget.
  The Likes Field
  The Likes field lets you search through users' Facebook profile Likes and Interests. Or, you can narrow it down to a specific like/interest. For example, you could display a widget promoting Red Sox merchandise if, in their Facebook profile, users like a Sports Team that contains Red Sox.
- Submitted For Data—Uses field and value for a form (by ID).
- Persona Title—The site visitor matches the persona that you define in this condition. See Also: Creating Personalized Web Experiences with Personas
- Otherwise—No condition evaluates to true.
  NOTE: You would typically use this criterion last, since it always evaluates to true. Any conditions below this are ignored.
Add additional criteria as desired.
Click Save.
Drag 1 or more widgets (that appear if the conditions evaluate to true) to the following area .
—Image—
If the widget requires you to fill out properties, click Edit and complete the screen.
—Image—

Reusing Targeted Content widgets on Web pages

Reusing Targeted Content Widgets on Web Pages

A Targeted Content Configuration is a Targeted Content widget that you create and save in the Ektron Workarea so that you can reuse the same Targeted Content widget on more than 1 Web page. When you drop a Targeted Content widget onto a PageBuilder page, you can choose a widget from the saved configurations in the Workarea.

After you choose a Targeted Content Configuration for a Targeted Content widget, you cannot edit its conditions on that page. You can edit the configuration only in the Workarea. If you later change a configuration setting, all widgets using that configuration are automatically changed. See Editing the Criteria of a Condition.

IMPORTANT: If you apply no conditions to a configuration and reference it in a Targeted Content widget on a PageBuilder page, nothing appears on the page.

Using the Flash widget

Using the Flash Widget

This widget supports both .flv and .swf file types.
If you will use .flv files, make sure it is added as a file type. See Also: Supported Types of Assets
If the Flash file you want to display has already been added to Ektron, use the Select File tab to it.
If the file has not been added to Ektron, first use the Select File tab to select a folder for the Flash file. Then, use the Upload tab to navigate your computer’s file system, and upload the file to the selected folder.
The thumbnail feature only works with .flv file types. If you select a Thumbnail, it appears within the Flash player when the page loads. See example below.
—Image—
The thumbnail is only applied to this instance of the widget—not the Flash file. If you apply this video to a different widget on this page, you must reapply a thumbnail.
The thumbnail is an image file that was dropped into Ektron as an asset. It cannot be a library image.
The autostart feature works only with .flv files.
—Image—

If you log in then upload a flash file, and certain requirements are not met for that file, you see the following image where the widget appears.
—Image—

The following conditions cause this image to appear.

The flash file’s folder properties require certain metadata and/or a taxonomya content-level categorization system that uses one-to-many relationships (such as Ronald Reagan is to Actor, Governor, and President) to create a scalable organization of content. A taxonomy lets your site visitors navigate content independent of the folder structure. category to be applied, and they have not.
The folder has an approval chain, and this content has not been approved.

Using the Brightcove video widget

Using the Brightcove Video Widget

IMPORTANT: You need an account on Brightcove to show videos in the Ektron Brightcove Video widget.

Your Brightcove.com account lets you upload, store, and play videos on your Web page with the Ektron Brightcove Video widget.

Adding the Brightcove video widget

Adding the Brightcove Video Widget

Follow these steps to play videos with the Brightcove Video widget.

Set the Brightcove Video widget Configuration in the Workarea if you did not use the first timer screen shown in the previous section.
Show how
1. From the Workarea, choose Settings > Configuration > Personalizations > Widgets.
2. Click Edit () next to BrightcoveVideo.ascx to set the properties shown below.
  NOTE: Brightcove provides the values for the Global Settings for this widget on your Brightcove Account pages. Log in to Brightcove and go to Account Settings > API Management.
3. Click Save.
Place the Brightcove widget on a PageBuilder page.
Show how
1. Edit a PageBuilder page.
2. Drag and drop the Brightcove widget into a dropzonean area on a Web page where you can drag and drop a widget..
  See Editing Content on a PageBuilder Page for more information about PageBuilder and widgets.
Upload Videos Using the Brightcove Video widget.
Show how
NOTE: You can upload your video using your Brightcove.com account or follow these steps and upload a video using the Ektron Brightcove Video widget.
1. Click Edit () on the Brightcove Video widget.
2. Notice there are 3 tabs across the top—Video List, Search, and Upload.
3. Click Upload.
4. Enter Video Name.
5. Enter Video Description.
6. Click Browse and choose the video file to upload.
7. Click Upload.
  A message on the Edit window shows that the Video is being uploaded. In this example, we are uploading the Training Program 8.0 video.
  NOTE: Your video may not be available to view immediately after uploading. Allow time for Brightcove to publish it or check its status on your Brightcove Account page.
Choose the Video to Play in the Brightcove Video widget.
Show how
1. Click Edit () on the Brightcove Video widget.
2. Click either the picture or title of the video you want to show in this widget.

The following image is an example of the Brightcove Video widget on an Ektron OnTrek website page.

Widget reference

Widget Reference

Widgets are located in the Ektron webroot/siteroot/widgets/ folder. Ektron assigns standard names to widgets, but Ektron administrators can change a widget's name on the Synchronize Widgets Screen.

Activity Stream—Displays activities of a user or group, depending on the type of page on which it is placed. See Also: Using the ActivityStream Widget

Blog—After you select a blog id, displays posts from that blog.

Brightcove Video—Plays a Brightcove video. See also Using the Brightcove Video Widget.

Collection—Displays a collectionA list of Ektron content links for display on a Web page.. You select a Collection ID.See Also: Working with Collections

ContentAnalytics—Displays information about a set of content or products. The following figure shows the Highest Rated products in the default Software taxonomya content-level categorization system that uses one-to-many relationships (such as Ronald Reagan is to Actor, Governor, and President) to create a scalable organization of content. A taxonomy lets your site visitors navigate content independent of the folder structure..

Content Block—Lets user enter a content ID and display that content in the widget. Alternatively, user can create new HTML content from the widget.

Content List—Displays a list of content blocks. In contrast to a List Summary, where content must be in a specified folder, the ContentList control displays content from any Ektron folder.

Content Review—Places a ContentReview server control on the page. This control allows site visitors to rate and review the current page. See Also: ContentReviewserver controla server control uses API language to interact with the CMS and Framework UI to display the output. A server control can be dragged and dropped onto a Web form and then modified.

Flash—Displays a selected flash file which resides in Ektron. You can also set the display’s height and width. See Also: Using the Flash Widget

Flickr—Display Flickr’s Most Recent or Most Interesting photos. The user also can select the number of rows and columns for the image display.

GoogleGadget—Select from several Google feeds to display in the widget.

HelloWorld—Very simple widget. Created by Ektron to help developers understand how to create their own widgets.

iFrame—Lets user enter a path to a Web page or an item on the Web page.

List Summary—Displays an Ektron List Summary, a list of certain types of content in a selected folder. See Also: ListSummary (deprecated) server control

MessageBoard—Allows user to leave comments on the page. See Also: MessageBoard server control

Metadata List—Displays content whose metadata fits a selected folder location and keywords. See Also: MetadataList (deprecated) server control.

Most Popular—Reports on the following categories of content on your website: Most Viewed, Most Emailed, Most Commented, or Highest Rated. See Also: Most Popular Widget

Multivariate Experiment—This controls the experiment. Settings include the target content number, start/stop button and the Report hide/show button. See Also: Setting up a Multivariate Experiment

Multivariate Section—Lets you drag and drop various content widgets. These produce the variations used during the experiment. See Also: Setting up a Multivariate Experiment

Multivariate Target—When a page view occurs on a page containing this widget, the conversion count is increased. See Also: Setting up a Multivariate Experiment

ProductAnalytics—Displays information about a set of content or products. The following figure shows the Highest Rated and most Viewed products in the Hardware taxonomya content-level categorization system that uses one-to-many relationships (such as Ronald Reagan is to Actor, Governor, and President) to create a scalable organization of content. A taxonomy lets your site visitors navigate content independent of the folder structure..

Responsive Image—Adds a responsive image to a page.

QRCode—Generates a QR code based on the information you provide.

RSS Feed—Allows a user to enter the path of an Really Simple Syndication (RSS) feed.

Spacer—Lets you create an unused space on the Web page.

TabPlus—Lets you display more than one type of content in a tabbed widget. You can display a tab for a Content Block, a List Summary, a Collection, or Upcoming Events.

Targeted Content—Lets you create a set of conditions. As soon as any condition evaluates to true, an appropriate widget appears. See Also: Personalizing a Website Experience Using the Targeted Content Widget

Taxonomy Summary—Displays content assigned to a taxonomya content-level categorization system that uses one-to-many relationships (such as Ronald Reagan is to Actor, Governor, and President) to create a scalable organization of content. A taxonomy lets your site visitors navigate content independent of the folder structure. category. See Also: Organizing Content with Taxonomies , Directory server control

Trends—By default, the Trends widget shows the Most Viewed content on your website. You can edit the widget so it displays any of these content categories instead: Most Emailed, Most Commented, or Highest Rated. See Also: Trends Widget

Upcoming Events—Shows a list of scheduled calendar events.

WebCalendar—Provides full calendar functionality, including adding events. See Also: Working with Calendars

YouTube Video—Lets you embed code for any YouTube video.

Creating the “Hello World” Widget

Step 1: Copy, Paste, and Rename HelloWorld.ascx and HelloWorld.ascx.jpg

Step 2: Update the Class Names in the New Files

Step 3: Add the Widget to the Wireframe Template

Understanding the User Control (.ascx) File

Understanding the Code-behind (.ascx.cs) File

Customizing a Widget

Working with JavaScript and Cascading Style Sheets

Verifying that a Page is a PageBuilder Page

Applying Global and Local Properties to a Widget

Setting Global Properties for a Widget

Setting Local Properties for a Widget

Adding a Field to a Widget

Including Help for a Widget

Deleting a Widget

Personalizing a Website Experience Using the Targeted Content Widget

Creating a Targeted Content Widget

Customizing the Targeted Content Widget

Using Multiple Criteria in a Condition

Editing the Criteria of a Condition

Editing a Widget that is Assigned to the Condition

Reusing Targeted Content Widgets on Web Pages

Creating a Targeted Content Configuration

Editing a Targeted Content Configuration

Deleting a Targeted Content Configuration

Choosing a Targeted Content Configuration

Using the Flash Widget

Using the Brightcove Video Widget

Setting Up Your Account Information for the First Time

Adding the Brightcove Video Widget

Additional Brightcove Information

Troubleshooting the Brightcove Video Widget

Widget Reference