This document describes the basic process of creating a placement and defining the placement settings.
To get started, watch the following tutorial to learn how to create a placement for a modification.
To create a placement:
- In the Frosmo Control Panel, select Modifications > Placements.
- Click Create placement.
- Define the placement settings.
- When you're done, click Save.
After creating the placement, you have several options for managing it.
For an example on how to create a simple banner placement, see Creating your first placement.
Table: Placement settings
Enter a name for the placement. Make sure the name identifies the placement's location on the page.
To easily identify your placements later, use a consistent naming convention. Frosmo uses the following convention:
<Page identifier> - <Placement position on page> - <Extra identifier, if any>
The first part identifies the page or pages where the placement is active. If the placement is active on several pages, the Frosmo convention is to name the first part "Multipage".
|Description||Enter a description for the placement. You can use the description to provide further details on where and how the placement is placed and why.||Optional|
Define the web page element or elements in relation to which the modification content is placed in the page code.
To define the element:
Here are a few example selectors:
Select how the placement and thereby the modification content are placed in relation to the target element in the page code:
If you do not want to add the placement and thereby the modification to every page on your site, create one or more URL rules that together resolve into the set of pages where you want to use the placement. A URL rule defines a comparison between a part of the URL and a string value that you expect that part to match. For example, you might check whether the protocol part of the URL matches "http" or "https".
If you define no URL rules, the placement is used on all pages on your site (unless you attach a trigger to the placement that only fires on specific URLs).
To create a new rule:
You have the following options for selecting the part of the URL:
If you create multiple rules, select how you want to combine the rules:
You can create as many rules as you need.
You can attach a trigger to the placement to control when the placement and thereby the modification content are added to a page. With a trigger, the placement is added to the page only when the trigger fires.
Be careful when using a trigger with the Hide & replace original display method, since the trigger is only evaluated after the target element is hidden. This may cause visitors to miss important content.
If you define both a URL matcher and a trigger, the placement is added only to pages that match the URL rules and only when the trigger gets fired. For example, if you define a URL rule that matches the path
If you define both a URL matcher and a trigger, make sure their URL rules do not conflict. Having conflicting URL rules can easily lead to a situation where the modification content is never shown.
To attach a trigger:
To change the attached trigger:
To remove the attached trigger:
Enter the name (without the namespace) of the custom renderer function that you've created for this placement. You can use custom renderers to change default placement functionality or add new functionality.
Limit the function name to 64 or fewer characters.
Only Frosmo customer teams can create custom renderers. For more information, contact your Frosmo representative.
Enter the names of the CSS classes that you want to use to style the placement and thereby the modification content. If you use multiple classes, separate the names by spaces.
The classes must be defined in the site source code or in the modification content.
Limit the string of class names to 256 or fewer characters.
The class names are added to the
Enter the inline CSS code that you want to use to style the placement and thereby the modification content.
Limit the code to 255 or fewer characters.
The code is added to the
Figure: Defining the placement settings