Dottoro Theme Documentation

Tutorial to get your theme to work

PrologueFirst StepsFront PageCreating a custom front pageBlog, News and Portfolio post typesPost Type specific settingsGeneral settingsSingle post settingsCategory / Tag / Date archive page settingsPermalink settingsOptions on single post pagesGeneral page optionsImage optionsGallery settingsPage Templates and PagesPage SettingsPage TemplatesPages created from page templatesGeneral page settingsGallery settingsBlog page settingsNews page settingsPortfolio and Imagefolio page settingsContact page settingsArchives page settingsAuthors page settingsBoomarks page settingsSitemap page settingsSpecial pagesCategory and tag page settingsArchive and date page settingsSearch page settingsAuthor page settings404 page settingsHeader and MenuSubheadersSubheader specific shortcodesPredefined SubheadersCreating SubheadersAssigning subheaders to pagesFooterWidgets in the FooterCopyright and other notices in the FooterSidebarWidgets on the SidebarWidth and alignment of the sidebarWidget AreasWidgetsBreadcrumbShortcodesShortcodes In Alphabetical OrderShortcodes By CategoriesNested ShortcodesPost TemplatesOverlaysMedia and External MediaOverview of galleries, gallery listings and slideshowsGalleries and Gallery ListingsAbout Galleries In GeneralCreating And Managing Galleries[gallery_list] shortcodeSlideshows and Popup SlideshowsSlideshowsPopup SlideshowsSlideshow SettingsMost Often Used Slideshow OptionsAll Slideshow OptionsSlideshow Templates - Slideshow Specific ShortcodesStyling Guide For SlideshowsStyling Of Slideshow and Post TemplatesSlidesPopupsSelectorsWeb FontsGeneral Theme SettingsUser RolesExport / Import SettingsCreating theme designsLocalizationHeadingsChild ThemesCSS ClassesResponsive DesignCSS Extension JavaScript ToolkitJavaScript LibraryAction HooksFilter HooksCompatibility Issues
<

34. Filter Hooks

Dottoro filters allow you to change the way Dottoro theme works with your child themes and plugins. With the help of filters, you can modify the arguments and return values of methods in the Dottoro theme. The number of filters will increase in the next versions of the Dottoro theme.

Page Structure

dottoro_doctitle_text
Applied to the document title text.
dottoro_body_class
Applied to the class settings of the body element.
dottoro_headers_args
Applied to the arguments of the Dottoro_Headers::do_headers method that outputs the contents of the headers section. The headers section includes both header and subheader.
dottoro_subheader_title_text
Applied to the subheader title text.
dottoro_subheader_title_link
Applied to the target URL of the subheader title.
dottoro_subheader_teaser_text
Applied to the subheader teaser text.
dottoro_subheader_teaser_link
Applied to the target URL of the subheader teaser.
dottoro_open_page_body_args
Applied to the arguments of the Dottoro_Page_Body::do_open_page_body method that outputs the opening tags of the page body section.
dottoro_page_body_args
Applied to the arguments of the Dottoro_Page_Body::do_page_body method that outputs the contents of the page body section. This section includes the content of the page and the sidebar.
dottoro_open_body_content_args
Applied to the arguments of the Dottoro_Page_Body::do_open_body_content method that outputs the opening tags of the page content section.
dottoro_body_content_args
Applied to the arguments of the Dottoro_Page_Body::do_body_content method that outputs the contents of the page content section.
dottoro_content_title_text
Applied to the text of the content title.
dottoro_content_title_args
Applied to the arguments of the content title. Allows you to modify the headings of page titles. For post titles, use the dottoro_post_meta_title_args filter.
dottoro_blog_body_content_args
Applied to the arguments of the Dottoro_Blog::get_body_content method that outputs the contents of a Blog page content section.
dottoro_news_body_content_args
Applied to the arguments of the Dottoro_News::get_body_content method that outputs the contents of a News page content section.
dottoro_portfolio_body_content_args
Applied to the arguments of the Dottoro_Portfolio::get_body_content method that outputs the contents of a Portfolio page content section.
dottoro_imagefolio_body_content_args
Applied to the arguments of the Dottoro_Imagefolio::get_body_content method that outputs the contents of an Imagefolio page content section.
dottoro_footer_args
Applied to the arguments of the Dottoro_Footer::do_footer method that outputs the contents of the footer section. The footer section includes footer widget and text boces.

Post Types

dottoro_register_post_type_args
Allows to override the arguments used for news and portfolio post types registration.

Post Lists

dottoro_post_list_default_atts
Allows you to override the default attribute values of the [post_list] shortcode.
dottoro_news_list_default_atts
Allows you to override the default attribute values of the [news_list] shortcode.
dottoro_portfolio_list_default_atts
Allows you to override the default attribute values of the [portfolio_list] shortcode.
dottoro_blog_post_preview_path
This filter has been removed in version 1.17. Use Post Templates instead.
Applied to the path of the blog post preview file. This file displays an item of post lists (e.g. a blog post on blog pages).
dottoro_news_item_preview_path
This filter has been removed in version 1.17. Use Post Templates instead.
Applied to the path of the news item preview file. This file displays an item of news lists (e.g. a news item on news pages).
dottoro_portfolio_item_preview_path
This filter has been removed in version 1.17. Use Post Templates instead.
Applied to the path of the portfolio item preview file. This file displays an item of portfolio lists (e.g. a portfolio item on portfolio pages).
dottoro_portfolio_item_hover_preview_path
This filter has been removed in version 1.29. Use Overlay instead.
Applied to the path of the portfolio item preview file that is visible when the mouse hovers over an item.

Post Meta

dottoro_post_meta_title_defaults
Allows you to override the default argument values of the Dottoro_Post_Meta::get_title_html method that retrieves the html source of a post title.
dottoro_post_meta_title_args
Applied to the arguments of the Dottoro_Post_Meta::get_title_html method that retrieves the html source of a post title. Allows you to modify the headings of post titles. For page titles, use the dottoro_content_title_args filter.
dottoro_post_meta_title_html
Applied to the html source of the post titles.
dottoro_post_meta_date_defaults
Allows you to override the default argument values of the Dottoro_Post_Meta::get_date_html method that retrieves the html source of a post date.
dottoro_post_meta_date
Applied to the post date text.
dottoro_post_meta_date_html
Applied to the html source of the date post meta data.
dottoro_post_meta_category_defaults
Allows you to override the default argument values of the Dottoro_Post_Meta::get_category_html method that retrieves the html source of the category post meta.
dottoro_post_meta_category_html
Applied to the html source of the category post meta data.
dottoro_post_meta_tag_defaults
Allows you to override the default argument values of the Dottoro_Post_Meta::get_tags_html method that retrieves the html source of the tag post meta.
dottoro_post_meta_tags_html
Applied to the html source of the tag post meta data.
dottoro_post_meta_author_defaults
Allows you to override the default argument values of the Dottoro_Post_Meta::get_author_html method that retrieves the html source of the author post meta.
dottoro_post_meta_author_html
Applied to the html source of the author post meta data.
dottoro_post_meta_author_link_html
Applied to the html source of the link within the author post meta data.
dottoro_post_meta_comment_defaults
Allows you to override the default argument values of the Dottoro_Post_Meta::get_comment_html method that retrieves the html source of the comment post meta.
dottoro_post_meta_comment_html
Applied to the html source of the comment post meta data.
dottoro_get_edit_link
Applied to the html source of the post edit link.
dottoro_post_meta_readmore_defaults
Allows you to override the default argument values of the Dottoro_Post_Meta::get_readmore_html method that retrieves the html source of the read more link.
dottoro_post_meta_visitsite_defaults
Allows you to override the default argument values of the Dottoro_Post_Meta::get_visitsite_html method that retrieves the html source of the visit site link.

Post Templates

dottoro_post_template
Applied to the identifier of the post template. Allows you to modify the post template settings of posts.

To get the identifier of a post template, go to Templates » Post Templates and click on the template. Here you will find the id of the template.

Menu

dottoro_nav_menu_args
Allows you to change the arguments of the wp_nav_menu function call that displays the primary navigation. For example, you can display different menus on different pages with the help of this filter.

Breadcrumb

dottoro_breadcrumb_args
Applied to the arguments of the Dottoro_Breadcrumb::get_breadcrumb method that displays the breadcrumb.
dottoro_breadcrumb_items
Applied to the items of the breadcrumb.

Widget Areas

dottoro_header_widget_areas
Applied to the identifier of the header widget areas.
dottoro_sidebar_widget_areas
Applied to the identifier of the sidebar widget areas.
dottoro_footer_widget_areas
Applied to the identifier of the footer widget areas.

General

dottoro_finalize_output
Applied to the output of the page in the Dottoro_Page_Structure::finalize_output method.
dottoro_settings
Allows you to override the theme specific settings. Most of these settings can be changed through the admin panel, but if you need more flexibility, they can be changed dynamically with the help of the dottoro_settings filter.
dottoro_locale_settings
Applied to the path of folders where the language resource files are located.
dottoro_unique_id
Applied to the return value of the unique id generator method. If you want you can use your own unique id generator.
dottoro_wp_fixes
Dottoro theme fixes some post type related bugs in WordPress and extends default WordPress widgets. With this filter, you can enable and disable these fixes, features.
dottoro_matching_page_id
Applied to the return value of the Dottoro_Theme::get_matching_page_id method that retrieves the identifier of the matching post list page.
dottoro_dominant_category_id
Allows you to set the dominant category for a post. The category_title and [category_teaser] shortcodes display the title and description of the dominant category. By default, the dominant category is the first category of the post, in alphabetical order. Use this filter if you want to change it.
dottoro_shortcode_exec
Allows you to extend the functionality of Dottoro shortcodes.