Module name:
slotgear
The Targeted Content Gear lets you display targeted content to portal users using a slot component. Slots are often used to show images, but you can use them to display any repository items that you choose. See Using Slots section of the Creating Scenarios chapter in the ATG Personalization Guide for Business Users for an introduction to slots, and Using Slots in the ATG Personalization Programming Guide for a more detailed view of creating slots.
Installation Configuration
There is no installation configuration for the Targeted Content Gear itself. Note, however, that you may need to create slot components for the Targeted Content Gear to use. Use the ACC to create a slot component, as described in Using Slots in the ATG Personalization Programming Guide. You also need to create a SQL content repository to contain the content rendered in the Targeted Content Gear.
Targeted Content Gear Repository Configuration
When you configure a slot component, you specify a repository name and an item descriptor name. This defines what type of item the slot will display. How the item is rendered depends on the item’s media type (i.e. text, image, or a product). The Targeted Content Gear includes a Nucleus component that defines a mapping of repository item descriptors to the JSP files that are used to render that particular item type. The Nucleus address of this component is /atg/portal/gear/slotgear/SlotConfiguration. The slotPages property of the SlotConfiguration component contains this map. The default configuration (properties file) that is installed with the gear is shown below:
%cat SlotConfiguration.properties # Version: $Change: 234577 $$DateTime: 2002/04/03 09:25:14 $ # Global configuration properties for the portal $class=atg.portal.gear.slotgear.SlotConfiguration $scope=global # A mapping of itemDescriptorNames used for slots to jsp pages used to render them slotPages=\ media=mediaInternalBinary.jsp,\ media-internal-binary=mediaInternalBinary.jsp,\ media-internal-text=mediaInternalText.jsp,\ media-external=externalMedia.jsp,\ product=productSlot.jsp
When you design the repository that holds content for the Targeted Content Gear, you must either:
Use one or more item descriptors named
media,media-internal-binary,media-internal-text,media-external, orproduct.Configure the
slotPagesproperty to include a mapping of the item descriptor names you use in your slot content repository to the JSP pages used to render them in the Targeted Content Gear.
In addition, you may want to customize one of the JSP pages used to render content in the Targeted Content Gear. These JSP files are located in <ATG10dir>Portal/slotgear/slotgear-war.
Instance Configuration
The Configure Basics page for an instance of the Targeted Content Gear allows you to configure the usual gear basics:
Gear Name
Gear Description
Sharing
Make visible to
The additional configuration page for the Targeted Content Gear has three steps:
Click the define slot link.
Select the name of the Nucleus component for the slot. The dropdown list includes all slot components that are created in the ACC or otherwise created in the CONFIGPATH at
/atg/registry/Slot. The slot component defines the repository and item descriptor from which it derives repository items to display.Enter the pathname of an image to display if the slot is empty. Click Save.
Click the targeting link. A slot can use a targeting servlet bean that applies a set of targeting rules to a repository, retrieves a result set of repository items, and renders one or more of the repository items in the page region allocated to the slot.
On this page, you can set the input parameters for the targeting servlet bean that renders the slot. For information about these parameters, see the description of the
TargetingFirst,TargetingForEach,TargetingRange, orTargetingRandomservlet beans in the ATG Page Developer's Guide.After you configure the input parameters for the targeting servlet bean, click Save.
Click the property names link. A slot renders an image or text from a repository item. The URL property defines the property in the repository item that points to the location of an image on the file system. The data property represents text to be displayed in the slot.
The external media context root property is used to specify the root for external media item types. In the baseline Slot Gear, the external media you are using need to exist inside the Slot Gear Web application.
After you configure the property names, click Save.
