Conditional Keywords Screen

On each of the Type Formats Bodycopy, the Conditional Keywords screen can be found. This screen allows you to specify conditions that must be satisfied for a section of your content to be displayed. If the condition is not satisfied, the appropriate section of content is not displayed to the user.

Bookmarks to the headings on this page:

  1. Using a Conditional Keyword

The Conditional Keywords section of the Conditional Keywords screen is shown in the figure below.

The Conditional Keywords section of the Conditional Keywords screen
The Conditional Keywords section of the Conditional Keywords screen  

To add a condition select the type of condition you want to use from the Condition Type list and click Commit. Additional fields will then appear on the screen allowing you to configure that condition. You can add as many conditions as you want.

The Admin Access Condition, Form Posted Condition, Keyword Regexp Condition, User Type Condition and Write Access Condition should only be used under very specific circumstances and hence are not described in this manual. All other conditions are as follows:

  • Asset Status Condition: this condition specifies that the content will be shown if the asset is or is not a particular Status.
  • In User Group Condition: this condition specifies that the content will be shown if the user is part or not part of a User Group.
  • Logged In Condition: this condition specifies that the content will be shown if the user is either logged in or not logged in.
  • Logical Condition: this condition specifies that the content will be shown if a combination of keywords evaluates to either true or false.
  • Server Variable Condition: this condition specifies that the content will be shown if a specific user variable either matches or does not match the pattern specified. For example, you can specify that the content will be shown if the browser the user is using is Internet Explore. To do this, select The following server variable matches the specified pattern from the list provided, enter HTTP_USER_AGENT into the Server Variable field and enter MSIE into the Pattern field.
  • Simple Edit Mode Condition: this condition specifies that the content will be shown if the user is using or is not using the Simple Edit Interface.
  • User Agent Condition: this condition specifies that the content will be shown or will not be shown if the user is using a specific browser. For example, you can specify that the content will be shown if the browser the user is using is Internet Explore. To do this, select The user agent string matches the pattern from the list provided and enter MSIE into the User Agent Pattern field.
  • User Frequency Condition: this condition specifies that the content will be shown if the user has spent a certain amount of time on your Site or has visited the Site a certain number of times.
  • User IP Condition: this condition specifies that the content will be shown if the user has a particular IP range.

Using a Conditional Keyword

Once you have set up a condition on the Conditional Keywords screen, a number of keyword replacements will be available on the Edit Contents screen of the Bodycopy. These keyword replacements allow you to configure the content so that only certain areas will be visible if certain conditions are met and are as follows:

  • Begin <condition name>: if the condition is true, the content that is shown between this keyword replacement and either the keyword replacement Else <condition name> or End <condition name> will be shown.
  • Full Structure for <condition name>: this keyword replacement will add the keyword replacements Begin <condition name>, Else <condition name> and End <condition name> in the WYSIWYG Editor. You can then add the required content in between these keyword replacements.
  • <condition name>: this will show 1 if the condition is true or 0 if it is false.
  • Else <condition name>: if the condition is false, the content that is shown between this keyword replacement and the keyword replacement End <condition name> will be shown. This keyword replacement is optional
  • End <condition name>: use this keyword replacement to indicate where the conditional content ends.

Please note <condition name> is the name of the condition on the Conditional Keywords screen.
An example of the conditional keyword replacement structure is shown in the figure below.

An example Conditional Keyword structure in the WYSIWYG Editor
An example Conditional Keyword structure in the WYSIWYG Editor

PreviousFinish