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
<

22. General Theme Settings

The theme supports a large number of options. Some of them apply to post types (see Post Type specific settings), to posts (see Options on single post pages), to pages (see Page Templates and Pages) and some to the whole website. The settings in this section apply to the whole site.

You will find these options under Theme Options » General » General:

Document Header Settings
Favicon A favicon (Favorites icon) is a file that contains icon or icons associated with a website or webpage. The favicon of a webpage will appear in the address bar and bookmarks list of browsers. To set a favicon, you can use the favicon.ico file provided by the theme, or any icon file you created; it is best to use a custom favicon.
Apple Touch Icon Set the location of your Apple touch icon. Use .png image only. This icon will be visible if your visitor adds the link of your website to the Home Screen on Apple Devices.
Header Includes Here you can set an HTML content that will be inserted at the end of every page's HEAD section. You can specify additional META tags, links to external CSS and JavaScript files (see link element), analytics code and other content usual in HEAD sections.
Responsive design Set whether to add responsive meta tags to the document header. These meta tags are necessary to adapt the layout to the viewing environment. You can read more about reponsive website design in the Responsive Design section.
Pagination
Page navigation settings (pagination) You will find paginations on multiple page pages and in long comment lists.

With these options you can specify the whether the paginations should be numerical or text (Page navigation type), the alignment of paginations (Page navigation alignment), for numbered paginations the number of page links displayed after and before the current page link (Page navigation range), and the texts displayed as links to the previous and next page (Page navigation previous/next text).

Content Settings
Here you can set the target of author's links. Author's links can lead to a page that contains the author's profile and posts, or a website specified on the settings page of the user.
Default Post Type In the theme you can set a number of widgets according to which post type to display the results. If these widgets are set to 'auto' mode, they will display the results according to the post type of the page the widgets are placed on; e.g. blog posts for blog pages and news items for news pages. There are also pages that are not related to post types (home, search, 404, etc.). If you use 'auto' widgets on these pages, they will be displayed by your Default Post Type settings.
Post Type in document title Here you can set whether the document title (HTML title tag) of category, tag and date pages should contain the post type text or not. The document title appears on the title bar of browsers and in search results pages. In the Dottoro Theme, the category, tag and date archive pages are post type dependent. If you use more than one post type in your theme, it is recommended to select this checkbox to avoid duplicated document titles.
Show 'comments are closed' Set whether to show the 'Comments are closed' text or not.
Show comments on attachment pages Set whether comments are allowed on attachment pages, or not.
Show scroll to top button Set whether to show the scroll to top button, or not. This is the button that appears on the bottom-right corner of the page when the document is scrolled down.
Aspect Ratio
Here you can specify which HTML elements should keep aspect ratio while resizing. This is a JavaScript feature that is intended to handle resizing of those elements for which CSS does not provide enough flexibility. Although this feature can be used for any elements, but since HTML image and video elements always keep aspect ratio (CSS), it is the most useful for iframe, embed and object elements. Especially for iframe, embed and object elements displaying videos.
It is also possible to enable/disable the "Keep Aspect Ratio" feature for a given element.
If the "Keep Aspect Ratio" feature is enabled on your site
  • any element that has a CSS class of js-keep-aspect-ratio keeps its aspect ratio
  • and this function can be disabled for any element with the js-no-aspect-ratio CSS class.
Keep Aspect Ratio Here you can enable the "Keep Aspect Ratio" feature.
HTML elements Comma separated list of HTML elements that should keep aspect ratio.
Do not add the image (img) and video eklements to this list, they are handled by CSS.
Furthermore, do not add "iframe" to the list if you want only certain iframes to keep aspect ratio. For this purpose use the Iframes option below.
Iframes Here you can specify which iframes should keep aspect ratio. The textarea on the right contains the URL patterns for iframes that should keep aspect ratio. Every URL pattern is a regular expression and must be written in a separate line. The predefined URL patterns on the left help you to specify the most commonly used values.
wpautop and wptexturize
Enable wpautop Here you can enable/disable the WordPress wpautop function for different post types.

The WordPress wpautop function automatically replaces double line-breaks with HTML paragraphs in the contents of pages and posts. That's fine in almost any situation, but it also generates p (paragraph) tags within shortcodes causing unwanted spaces. Unfortunately the wpautop function is buggy and sometimes generates unclosed paragraph tags within shortcodes resulting in invalid HTML output.

Therefore, if you use nested shortcodes, it is advisable to disable the wpautop function. In addition, disabling wpautop descreases the load time of your website (this also applies to the wptexturize function). The only drawback is that you must add paragraph tags manually to the contents of pages and posts to format their content.

The wpautop function is disabled in the demo content. If you enable it, you need to remove

  • unnecessary whitespaces within shortcodes to avoid invalid HTML output
  • unnecessary [br /] shortcodes to remove extra spacing

Please Note: after you enable/disable wpautop, you must check the look of your posts (line breaks may appear/disappear)! See wpautop (WordPress.org) for further details.

Enable wptexturize Here you can enable/disable the WordPress wptexturize function - the function that automatically replaces all special characters (quotes, apostrophes, dashes, etc.) with HTML numeric character references. If you don't need this feature, turn it off to descrease the load time of your website. See wptexturize (WordPress.org) for further details.
Sidebar and Footer Widget Areas
Here you can select the widget areas you want to display in the sidebar and footer on your site.
This setting can be overridden
  • for pages under Pages » Page Settings
  • for search, author and 404 pages under Theme Options » General » Author/Search/404
  • for post, category, tag and date pages under Posts » Post Settings / News » News Settings / Portfolio » Portfolio Settings
  • finally, for every single post and page on the edit post/page screen.
Sidebar Widget Area Here you can select the widget areas you want to display in the sidebar.
Here you can select the widget areas you want to display in the footer.
Enable/Disable Features and Options
News Post Type Here you can enable the News post type feature. This feature includes news posts, tags and categories, adds the news option to the post type selection lists in widgets (such as Popular Posts) and to the advanced search page. Please note that the News page template cannot be removed for technical reasons, but it makes no sense without the news post type.
Portfolio Post Type Here you can enable the Portfolio post type feature. This feature includes portfolio posts, tags and categories, adds the portfolio option to the post type selection lists in widgets (such as Popular Posts) and to the advanced search page. Please note that the Portfolio and Imagefolio page templates cannot be removed for technical reasons, but they make no sense without the portfolio post type.
Popup Here you can enable/disable the Popup feature.
Mega Menu Here you can enable/disable the Mega Menu feature.
Here you can select whether you want the links pointing to Dottoro sites to be displayed at the bottom of admin pages.
Here you can select whether you want the contextual help links next to theme options to be displayed on admin pages.
Show Theme Editor Option Here you can select whether you want the Theme Editor option to be displayed or not. This option is mostly useful if you want to give someone (e.g. your client) full control of the site, but the Theme Editor menu is not necessary to be seen.

Please note that does not mean your service key is kept private! If anyone else has access to your theme admin or database, please select the 'Store service key in a cookie' option under Theme Options » Theme Editor to ensure the security of your service key.

Thumbnail Settings
Thumbnails in Post Lists Select whether you want to use the Dottoro List Image or the WordPress Featured Image option for post thumbnails in post lists.
Thumbnails on Single Pages Select whether you want to use the Dottoro Single Image or the WordPress Featured Image option for post thumbnails on single post pages.
Gallery Settings
Here you can select the default gallery popup for the whole site. When a gallery should be shown in a popup slideshow, the gallery popup setting determines which one will it be.
The concept is as follows:
  • Here, under Theme Options » General, you can select the default gallery popup for the whole site.
  • This setting can be overridden
    • for pages, with the Gallery Popup option under "Page Settings"
    • for posts, with the Gallery Popup option in the Single Post Settings section under Posts » Post Settings / News » News Settings / Portfolio » Portfolio Settings
  • This setting can be overridden for every individual page or post with the Gallery Popup option on the edit post/page screen.
  • Finally, this setting can be overridden for every individual gallery with the Gallery Popup option of the gallery.
Additionally, post listings and slideshows also allow you to override this setting (see Gallery Popup option for portfolio pages and Gallery Popup option for slideshows).

Technically, this setting specifies the default value for the gallery_popup attribute of the [gallery_button] and [popup_opener] shortcodes. For instance, if you add an image to the content of a page or post and you select an overlay to it that contains a [gallery_button] or [popup_opener] shortcode, then clicking on it will open a popup slideshow. If the gallery_popup attribute of the [gallery_button] and [popup_opener] shortcodes are not specified, this setting will determine the popup slideshow.

For further details about popup slideshows, please see the Popup Slideshows section.
Plugin Settings
qTranslate Compatibility The qTranslate plugin does not work on custom post types by default. Here you can select whether you want to make the news and portfolio post types compatible with the qTranslate plugin.