Download this help site
(PDF 82MB)


Customizing theme controls

This functionality is only intended for experienced web designers


Please read this page before you proceed: Advanced customization warning
Theme override is intended for people with advanced web design skills. Incorrect use may result in your website malfunctioning.
Note: our technical support team does not provide support related to theme overrides.

Controls are small reusable chunks of code that perform a specific action – usually, to render a piece of HTML. Wild Apricot uses controls mainly for wrapping gadgets in styled containers. Thus we achieve a form of separation – controls define gadget appearance, and gadgets themselves define their functionality.

You can call controls from gadgets and master layout templates.

Control types

In Wild Apricot, we use the following types of controls:

  • Captcha – HTML to render Captchas
  • Divs – wrapper DIVS used in old themes
  • Form – form wrapper
  • FormHelpers – helper for rendering standard form elements
  • MessageBox – wrapper for message boxes used in our system
  • StyledWrappers – wrappers for gadget styles (see Customizing gadget styles in themes for more details)

Calling controls

The basic syntax for calling controls is:

Please note that you pass parameters to controls in the same way as you pass parameters to gadgets. For more information, see Passing parameters.

Creating controls

To create a control, follow these steps:

  1. Create a folder under the Controls folders.
  2. Create a ControlTemplate.tpl file in the new subfolder (from scratch or by copying an existing file from another Controls subfolder).
  3. Modify the ControlTemplate.tpl file.

On this page: 

  • No labels