Thesis Box display filters 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.
Single-instance, Independent Core Boxes
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 follow the simplest display filter naming convention:
[box_class_name]_show
Where [box_class_name] represents the PHP class name of the applicable Box.
Core Thesis Boxes that fall into this category are:
thesis_site_titlethesis_site_taglinethesis_comments_introthesis_previous_post_linkthesis_next_post_linkthesis_previous_posts_linkthesis_next_posts_linkthesis_archive_titlethesis_archive_contentthesis_attributionthesis_wp_admin
Setting a Display ID on Multi-instance 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 a Display ID that Skin developers can use to differentiate between Box instances:
/* multi-instance display filter naming convention */ [box_class_name]_[Display_ID]_show
Display 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 Display ID of sidebar. Here’s the resulting display filter for that Box, which has a base class name of thesis_html_container:
thesis_html_container_sidebar_show
Note: If no Display 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
thesis_html_containerthesis_post_boxthesis_commentsthesis_comment_formthesis_trackbacksthesis_query_box
Independent Boxes
thesis_wp_nav_menuthesis_comments_navthesis_wp_widgetsthesis_text_box
Dependent Boxes
thesis_post_headlinethesis_post_datethesis_post_authorthesis_post_author_avatarthesis_post_author_descriptionthesis_post_editthesis_post_contentthesis_post_excerptthesis_post_num_commentsthesis_post_categoriesthesis_post_tagsthesis_post_imagethesis_post_thumbnailthesis_wp_featured_imagethesis_comment_authorthesis_comment_avatarthesis_comment_datethesis_comment_numberthesis_comment_permalinkthesis_comment_editthesis_comment_textthesis_comment_replythesis_comment_form_titlethesis_comment_form_cancelthesis_comment_form_namethesis_comment_form_emailthesis_comment_form_urlthesis_comment_form_commentthesis_comment_form_submit