Documentation Center

Setting up Context Engine Cartridge Custom Tags or Server Controls in the Content Deployer

Context Engine Cartridge ships with a custom element for rendering content only if a certain context expression evaluates to true, and another custom element for rendering the result of evaluating a context expression. This topic explains how to enable the transformation of these custom elements for JSP as Custom Tags, or for ASP.NET as Server Controls.

Procedure

  1. Access the server on which the Content Deployer worker runs that deploys content to the Web site on which you want to make the Custom Tags or Server Controls available. If you have multiple Content Deployer workers and/or servers that fit this description, change each of them in turn.
  2. On this server, navigate to the WEB-INF/lib/ subdirectory of the Content Deployer worker root location.
  3. On your SDL Web installation media, navigate to Content Delivery\roles\context\extension-deployer\lib\.
  4. Copy context-transformer.jar from the installation media to the server.
  5. On the server, navigate to the WEB-INF/classes/ subdirectory of the Content Deployer worker root location.
  6. Open tcdl-conf.xml for editing.
  7. Inside the <TCDLEngine> section, insert the following TagBundle element:
    <TagBundle Resource="com/sdl/context/transformer/contextTagTransformerBundle.xml" />
  8. Save and close tcdl-conf.xml.
  9. Repeat these steps for other Content Deployer workers that publish to the Web site on which you want to make these Custom Tags or Server Controls available.

What to do next

Content Deployer can now work with Context Engine Cartridge Custom Tags or Server Controls. If you use the deprecated in-process API on your Web site, rather than the new RESTful API introduced in SDL Web 8, you also need to set up these Custom Tags or Server Controls on your Web site.