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
<

3. Blog, News and Portfolio post types

Along with the standard blog post type Dottoro Theme supports news and portfolio post types as well.

WordPress 3 has introduced post types, so one could display on his pages different types of content separated from each other. To take full advantage of this feature, along with the main type - Post - Dottoro Theme provides two further post types: Portfolio and News.

To help you display your tag and category pages separated for all three post types, tags and categories are also made post type dependent. You can assign a different permalink structure to every post type, making the types which your contents belong to visible in the URLs of your website. Some of the widgets also support post types; e.g. for the Recent Posts widget you can set the desired post type, but you can also set it to post type independent mode.

The settings options for all post types are separated on the admin panel as well in the Posts, News and Portfolio boxes. Posts, categories and tags for all three post types can be managed in the very same way. There are various setting options for every post type. Some of them are located under Posts » Post Settings / News » News Settings / Portfolio » Portfolio Settings and there are options for individual pages and posts as well.

You can read about individual page options in the Page Templates section. For other options, read further.

3.1 Post Type specific settings

Under Posts » Post Settings / News » News Settings / Portfolio » Portfolio Settings you will find options for a whole post type (e.g. Permalink structure), for tag and category pages and for single posts as well. The values of options for posts can be overridden on the admin page of every post. Thus you will not have to set the same values for every single post again and again; the default values can be set here.
3.1.1 General settings
General Settings
Page Priority This setting is available only if there are more than one post list pages. Here you can set the priority of your post list pages; the first one will have the highest priority. The appearance of date and tag pages is based on the settings of the post list page with the highest priority. For a category page, the appearance is based on the settings of the post list page that has the highest priority and matches the category.
Add post type RSS In the Dottoro Theme you can use both post type dependent and post type independent RSS feeds. Post type-independent RSS feeds contain posts from all three kinds of post types, while post type dependent feeds contain only posts from a certain post type. You can decide for every post type what RSS subscription options you would like to grant your visitors.
3.1.2 Single post settings
Settings
Post Template Allows selecting a post template for single post pages. This setting can be overridden for every single post (see Post Template option on single post pages). More on Post Templates.
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. This setting can be overridden for every single post.
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. This setting can be overridden for every single post.
Thumbnail Width The width of the thumbnail displayed on single post pages, in pixels. This setting can be overridden for every single post.
Thumbnail Height The height of the thumbnail displayed on single post pages, in pixels. This setting can be overridden for every single post.
Thumbnail Alignment Here you can choose whether to display the thumbnail image in left, right or center position or in left or right float position. Float means that the thumbnail and the content will be placed side by side. This setting can be overridden for every single post.
Thumbnail Target Here you can choose whether clicking on the thumbnail should open the attachment page, a page that only contains the image or set the thumbnail to unclickable.

Note that this option also has an effect if an overlay is set for the thumbnail (Thumbnail Overlay option). If the Thumbnail Target option is set to "image" or "attachment", the thumbnail will be placed in an anchor and the href attribute of the anchor will be set based on the value of the Thumbnail Target option. This could be important for SEO.

Thumbnail Overlay Here you can select an overlay to appear over the post thumbnail on single pages. This setting can be overridden for every single post. More on Overlays.
Header Here you can select a header for single post pages. This setting can be overridden for every single post.
The "Default" means that this value will be taken from the Header option under Theme Options » General » Header. The items (site logo, title and description, primary navigation and Header widget area) are positioned absolutely in the "Standard" header that enables you to set their positions in the theme editor.
For further details, please see the Header Customization section.
Subheader Allows selecting a subheader to be displayed on single pages. This setting can be overridden for every single post. Read more in the Subheaders section.
Show Breadcrumb Select whether the breadcrumb should be displayed on single post pages or not. The "default" value means that this value will be taken from "Theme Options" > General > Breadcrumb.
For further details, please see the Breadcrumb section.
Gallery Popup Select a gallery popup for single post pages. The "default" value means that this value will be taken from "Theme Options" > General > Gallery Settings.
For details, please see the Gallery Popup option under Theme Options » General.
Sidebar Position Set the position of the sidebar or remove the sidebar on single post pages. The 'default' value means that the sidebar position is determined by the skin settings of the theme. This setting can be overridden for every single post.
Sidebar Widget Areas Select the widget areas you want to display in the sidebar on single post pages. The 'Default' value means that this value will be taken from the Sidebar Widget Areas option on Theme Options » General » General. Read more in the Widget Areas section.
Footer Widget Areas Select the widget areas you want to display in the footer on single post pages. The 'Default' value means that this value will be taken from the Footer Widget Areas option on Theme Options » General » General. Read more in the Widget Areas section.
Footer Type Select the type of the footer for single post pages. You can select whether to show the full footer (widgets and copyright), only the copyright, only the widgets, or no need footer at all. The 'Default' value means that this value will be taken from the Footer Type option on Theme Options » General » General.
3.1.3 Category / Tag / Date archive page settings
Settings
Header Here you can select a header for category / tag / date archive pages. The "Default" means that this value will be taken from the Header option under Theme Options > General > Header. The items (site logo, title and description, primary navigation and Header widget area) are positioned absolutely in the "Standard" header that enables you to set their positions in the theme editor.
For further details, please see the Header Customization section.
Subheader Allows selecting a subheader to be displayed on category / tag / date archive pages. Read more in the Subheaders section.
Show Page Title This option allows you to specify whether the page title should be displayed in the contents of the page.
Show Breadcrumb Select whether the breadcrumb should be displayed on category / tag / date archive pages or not. The "default" value means that this value will be taken from "Theme Options" > General > Breadcrumb.
For further details, please see the Breadcrumb section.
Sidebar Position Set the position of the sidebar or remove the sidebar on category / tag / date archive pages. The "default" value means that the sidebar position is determined by the skin settings of the theme.
Sidebar Widget Areas Select the widget areas you want to display in the sidebar on category / tag / date archive pages. The 'Default' value means that this value will be taken from the Sidebar Widget Areas option on Theme Options » General » General. Read more in the Widget Areas section.
Footer Widget Areas Select the widget areas you want to display in the footer on category / tag / date archive pages. The 'Default' value means that this value will be taken from the Footer Widget Areas option on Theme Options » General » General. Read more in the Widget Areas section.
Footer Type Select the type of the footer for category / tag / date archive pages. You can select whether to show the full footer (widgets and copyright), only the copyright, only the widgets, or no need footer at all. The 'Default' value means that this value will be taken from the Footer Type option on Theme Options » General » General.
3.1.4 Permalink settings

These settings only take effect when the value of WordPress Permalink Common Setting differs from Default (Settings » Permalinks)! Here you can specify a custom permalink structure to every post type. You can also specify a custom permalink prefix to category and tag pages by post types.

For further details, please see WordPress Permalink Settings.

Please note: to avoid unwanted behavior, use different values for different post types!

3.2 Options on single post pages

3.2.1 General page options
Settings
Header Here you can select a header for the page. The "Default" means that this value will be taken from Post/News/Portfolio Settings. The items (site logo, title and description, primary navigation and Header widget area) are positioned absolutely in the "Standard" header that enables you to set their positions in the theme editor.
For further details, please see the Header Customization section.
Subheader Allows selecting a subheader for the page. The default value for this select list can be set under Post/News/Portfolio Settings. Read more in the Subheaders section.
Body CSS Class Space separated list of CSS classes to add to the BODY class attribute on the single post page. This option allows you to style the post page individually.
Additionally, since selectors allow you to target posts according to their attributes, such as CSS class, this option is also useful to apply individual settings to the single post page. For instance, you can select different headers for single post pages according to their Body CSS Class (more on selectors).
Post CSS Class Space separated list of CSS classes to add to the holder HTML element of the post. You can use this option to apply individual styles to the post in listings, slideshows and on the single page as well.

Please note that if the post template used for displaying the post contains a [post_article] shortcode and the "add_post_classes" attribute of the post_article shortcode is set to true, then the CSS classes will be added to the HTML article element. Otherwise, the CSS classes will be added to the HTML wrapper element of the list item/slide that contains the post. On single post pages, the Post CSS Class option will not be used.

Additionally, since selectors allow you to target posts according to their attributes, such as CSS class, this option is also useful to apply individual settings to the post in slideshows and listings. For instance, you can select different post templates for posts according to their CSS class in a slideshow or listing (more on selectors).

Post Template Allows selecting a post template for the page. The 'Default' value means that the post template is determined by the Post Template option on Post/News/Portfolio Settings. More on Post Templates.
Thumbnail Overlay Allows selecting an overlay to appear over the post thumbnail on the page. The 'Default' value means that the overlay is determined by the Thumbnail Overlay option on Post/News/Portfolio Settings. More on Overlays.
Show Breadcrumb Select whether the breadcrumb should be displayed on the page or not. The "default" value means that this value will be taken from the Show Breadcrumb option on Post/News/Portfolio Settings.
For further details, please see the Breadcrumb section.
Gallery Popup Select a gallery popup for the page. The "default" value means that the popup is determined by the Gallery Popup option on Post/News/Portfolio Settings.
For details, please see the Gallery Popup option under Theme Options » General.
Sidebar Position Here you can set the position of the sidebar or remove the sidebar. The 'default' value means that the sidebar position is determined by the Sidebar Position option on Post/News/Portfolio Settings.
Sidebar Widget Areas Select the widget areas you want to display in the sidebar. The 'Default' value means that this value will be taken from the Sidebar Widget Areas option on Post/News/Portfolio Settings. Read more in the Widget Areas section.
Footer Widget Areas Select the widget areas you want to display in the footer. The 'Default' value means that this value will be taken from the Footer Widget Areas option on Post/News/Portfolio Settings. Read more in the Widget Areas section.
Footer Type Select the type of the footer. You can select whether to show the full footer (widgets and copyright), only the copyright, only the widgets, or no need footer at all. The 'Default' value means that this value will be taken from the Footer Type option on Post/News/Portfolio Settings.
Editorial Recommendation This setting is specific for the News post type. It allows marking a news item as recommended. Recommended news are displayed as headlines (in a recommended box slideshow) on news list pages. Recommended news that are left out of the recommended box (you can set the number of items in the recommended box for each page, see Number of Recommended News option) will be displayed among other news items, according to the date of publishing.
External URL This setting is specific for the Portfolio post type. With this feature you can assign an external URL to a portfolio item. A 'Visit site' link or button will appear on portfolio list pages opening the specified website.
3.2.2 Image options
Settings
Post List Image Here you can set an image you want to display for the post when it is displayed in a list or slideshow.
Single Post Image Here you can set an image you want to display on the single post page.
You can also set the size and alignment of the image. The default image size is specified under Posts » Post Settings / News » News Settings / Portfolio » Portfolio Settings. If you want to use other image size, you can set it here. A 0 value means the original width/height of the image.
Here you can create galleries for the current post. Each gallery can contain any number of images, videos and other media, slides, pages and posts. Self hosted (attachments) and external media (such as YouTube and Vimeo videos) are also supported. Every single gallery or even a group of galleries can be displayed as a list (similar to post list), as a slideshow and they can also be shown in popup windows.

For further details, please see the Galleries section.