Documentation Center

Setting up Context Engine Cartridge Custom Tags or Server Controls (deprecated in-process setup)

Only if you still use the deprecated in-process API on your website, you need to enable two custom elements. This topic explains how to enable these custom elements for JSP as Custom Tags, or for ASP.NET as Server Controls, on your website.

Procedure

  1. Access the library location of your web application that contains Context Engine Cartridge.
    • In a .NET web application, navigate to bin\lib\.
    • In a Java web application, navigate to WEB-INF/lib/.
  2. On your SDL Tridion Sites installation media, navigate to Content Delivery\roles\context\extension-deployer\lib\.
  3. Copy context-transformer.jar from the installation media to the web application library location.
  4. If you intend to publish to REL (typically true if your web application is a web service), navigate to the configuration location of Dynamic Content Delivery:
    • In a .NET web application, navigate to bin\config\.
    • In a Java web application, navigate to WEB-INF/classes/.
  5. In this location, open the Dynamic Content Delivery configuration file, cd_dynamic_conf.xml, for editing.
  6. Inside the <TCDLEngine> section, insert the following TagBundle element:
    <TagBundle Resource="com/sdl/context/renderer/contextTagRendererBundle.xml" />
    <TagBundle Resource="com/sdl/context/transformer/contextTagTransformerBundle.xml" />
  7. Save and close cd_dynamic_conf.xml.
  8. If your website is a .NET website, on your SDL Tridion Sites installation media, navigate to Content Delivery\roles\context\extension-web\dotNet\.
  9. Copy the following files from the installation media to the bin\ subfolder of the web application on your server:
    • Sdl.Web.Context.Interop.dll
    • Sdl.Web.Context.ServerControls.dll
  10. From the installation media folder Content Delivery\roles\context\api\in-process\dotnet\bin\, copy Sdl.Web.Context.Interop.dll to the bin\ subfolder of the web application on your server.
  11. Also, open web.config in the root of your web application for editing, and in the pages section, within the controls subsection, add the following line to register the server controls:
    <add tagPrefix="context" namespace="Tridion.Context.ServerControls.Web.UI" assembly="Tridion.Context.ServerControls" />
  12. Save and close web.config.
  13. Restart your .NET web application.
  14. Perform the same steps for all other web applications that contain Context Engine Cartridge.