Display Options add serious flexibility to a Skin by giving users the ability to show/hide certain Skin elements or functionality.
Unlike typical Skin API components that involve only a single property or method, Display Options (and also Design Options) must be implemented in three different stages:
- Declare options
- Acquire user-selected options
- Implement selected options
The Thesis Skin API includes a Display Option component for each action listed above:
display()— declare items in the Display Options
formon the Skin Content page
$display— acquire user-selected Display Options
display_elements()— automatically implement Display Options
Given the nature of the
display_elements() method, you likely won’t need to reference the
$display property in your Skin. That said, the property is there if you need it for implementing non-standard Display Options.
Pro tip: Check out the Classic Responsive Skin’s
skin.php file for examples of non-standard Display Options that are implemented by referencing the
$display property (look for
$this->display in the code).