Thesis Box display filters are specially designed to allow finite control over the output and functionality of some Boxes. In practice, Skin developers can use these filters to make their templates more flexible for users.
Box display filters follow a simple naming convention that depends on the type of Box as well as its admin properties (which can be controlled from the Skin Editor).
Single-instance, Independent Core Boxes
Single-instance, independent core Boxes follow the simplest display filter naming convention:
[box_class_name] represents the PHP class name of the applicable Box.
Core Thesis Boxes that fall into this category are:
Multi-instance Boxes and Dependent Boxes
Unlike the core Boxes listed above, multi-instance Boxes require special filter naming treatment.
Since each instance of a multi-instance Box has the same class name, it also has the same filter as all other instances of that Box. Obviously, this is bad if your goal is to exercise finite control over your template output.
To combat this problem, multi-instance Boxes contain either a hook name (for Boxes of
$type = 'rotator') or a programmatic ID (for
$type = 'box') that Skin developers can use to differentiate between Box instances:
/* multi-instance display filter naming convention */ [box_class_name]_[hook_or_ID]_show
Hook names and programmatic IDs can be supplied on a per-Box basis inside the Skin Editor; eligible Boxes will contain an Admin tab in the options popup where Skin developers can supply this information.
To illustrate how the display filter naming convention works, let’s look at a theoretical HTML Container Box that has a hook name of
sidebar. Here’s the resulting filter for that Box, which also has a class name of
Note: If no hook name or programmatic ID is supplied for a multi-instance or dependent Box, that Box will revert to the simple, class-based filter name described in the section above.
The following is a comprehensive list of class names for core Thesis Boxes that have display filter controls:
Independent Rotator Boxes with Hook Names
Independent Boxes with Programmatic IDs
Dependent Boxes with Programmatic IDs