Dottoro Theme Documentation

Tutorial to get your theme to work

Prologue First Steps Front Page Creating a custom front page Blog, News and Portfolio post types Post Type specific settings General settings Single post settings Category / Tag / Date archive page settings Permalink settings Options on single post pages General page options Image options Gallery settings Page Templates and Pages Page Settings Page Templates Pages created from page templates General page settings Gallery settings Blog page settings News page settings Portfolio and Imagefolio page settings Contact page settings Archives page settings Authors page settings Boomarks page settings Sitemap page settings Special pages Category and tag page settings Archive and date page settings Search page settings Author page settings 404 page settings Header and Menu Subheaders Subheader specific shortcodes Predefined Subheaders Creating Subheaders Assigning subheaders to pages Footer Widgets in the Footer Copyright and other notices in the Footer Sidebar Widgets on the Sidebar Width and alignment of the sidebar Widget Areas Widgets Breadcrumb Shortcodes Shortcodes In Alphabetical Order Shortcodes By Categories Nested Shortcodes Post Templates Overlays Media and External Media Overview of galleries, gallery listings and slideshows Galleries and Gallery Listings About Galleries In General Creating And Managing Galleries [gallery_list] shortcode Slideshows and Popup Slideshows Slideshows Popup Slideshows Slideshow Settings Most Often Used Slideshow Options All Slideshow Options Slideshow Templates - Slideshow Specific Shortcodes Styling Guide For Slideshows Styling Of Slideshow and Post Templates Slides Popups Selectors Web Fonts General Theme Settings User Roles Export / Import Settings Creating theme designs Localization Headings Child Themes CSS Classes Responsive Design CSS Extension JavaScript Toolkit JavaScript Library Action Hooks Filter Hooks Compatibility Issues

Shortcodes within listings and slideshows

There are a couple of shortcodes that are designed to make the listings and slideshows more flexible.
These are:

Shortcode	Supported in Post List shortcodes	Supported in [gallery_list] shortcode	Supported in [slideshow] shortcode	Supported in [slider_custom_slides] shortcode
[empty_list]	Yes	Yes	Yes	No
[before_list]	Yes	Yes	Yes	No
[after_list]	Yes	Yes	Yes	No
[query]	Yes	Yes	Yes	No
[selector]	Yes	Yes	Yes	Yes
[item_settings]	Yes	Yes	Yes	Yes
[popup_gallery_settings]	Yes	Yes	Yes	Yes
[pagination_settings]	Yes	No	No	No
[browsing_filter_settings]	Yes	No	No	No
[general_settings]	No	No	Yes	Partially
[dimension_settings]	No	No	Yes	No
[transition_settings]	No	No	Yes	No
[autoplay_settings]	No	No	Yes	No
[prev_next_settings]	No	No	Yes	No
[navigation_settings]	No	No	Yes	No
[range_settings]	No	No	Yes	No

[empty_list]

Shortcode	Supported in Post List shortcodes	Supported in [gallery_list] shortcode	Supported in [slideshow] shortcode	Supported in [slider_custom_slides] shortcode
[empty_list]	Yes	Yes	Yes	No

Allows you to specify a HTML content that will be displayed if the list/slideshow is empty.

Example:

[post_list ...]
	[empty_list]
		<h3>Sorry, no results found.</h3>
	[empty_list]
[/post_list]

Attributes: No attributes.

[before_list]

Shortcode	Supported in Post List shortcodes	Supported in [gallery_list] shortcode	Supported in [slideshow] shortcode	Supported in [slider_custom_slides] shortcode
[before_list]	Yes	Yes	Yes	No

Allows you to specify a HTML content that will be displayed above the list/slideshow, but only in the case if the list/slideshow is not empty.

Example:

[post_list ...]
	[before_list]
		<h3>Latest news</h3>
	[before_list]
[/post_list]

Attributes: No attributes.

[after_list]

Shortcode	Supported in Post List shortcodes	Supported in [gallery_list] shortcode	Supported in [slideshow] shortcode	Supported in [slider_custom_slides] shortcode
[after_list]	Yes	Yes	Yes	No

Allows you to specify a HTML content that will be displayed below the list/slideshow, but only in the case if the list/slideshow is not empty.

Example:

[post_list ...]
	[before_list]
		<h3>Latest news</h3>
	[before_list]
	[after_list]
		<a href="#">More news</a>
	[after_list]
[/post_list]

Attributes: No attributes.

[query]

Shortcode	Supported in Post List shortcodes	Supported in [gallery_list] shortcode	Supported in [slideshow] shortcode	Supported in [slider_custom_slides] shortcode
[query]	Yes	Yes	Yes	No

Allows you to specify the query parameters for a post list or slideshow.

Attributes:
categories	Search for posts from certain categories. Format: slug of categories, separated by commas.
excluded_categories	Exclude some categories from the post search. Format: slug of categories, separated by commas.
tags	Search for posts with certain tags. Format: slug of tags, separated by commas.
excluded_tags	Exclude some tags from the post search. Format: slug of categories, separated by commas.
day	Search for posts that have been created on a certain day of the month (1-31).
monthnum	Search for posts that have been created in a certain month. Possible values: 1-12.
year	Search for posts that have been created in a certain year. The year must be specified in 4-digit format (e.g. 2014).
exclude_current_post	Specifies whether the current post should be excluded from the list or not (true \| false). Default is false. If this attribute is set to true, the current post will always be excluded from the list regardless of the value of the excluded_post_ids attribute.
excluded_post_ids	The identifiers of posts to exclude from the list, separated by commas. To get the identifier of a post, open its page on the admin panel and look at the URL in the location bar of your browser. The URL contains a 'post=number' substring, where the number is the identifier of the post. If the exclude_current_post attribute is set to true, the current post will always be excluded from the list regardless of the value of the excluded_post_ids attribute.
filter_func	Specifies the name of a PHP function that allows you to modify the query parameters. The filter function is useful if you want to set the query parameters dynamically and also when the attributes provided by the [query] shortcode does not give you enough flexibility. For instance, if you want to show posts that have a category "tech" or "sport", then you can use the "categories" attribute for this purpose. But if you want to shows posts that are in both category "tech" and "sport", the "categories" attribute cannot be used. For this case, you can use the "filter_func" attribute. This example shows how to display posts that are in both category "tech" and "sport" in a 3 column layout. Page content: `[post_list col_num="3"] [query posts_per_page="6" filter_func="my_post_list_query" /] [/post_list]` functions.php of your child theme: `function my_post_list_query ($query_args) { if (!isset ($query_args['tax_query'])) { $query_args['tax_query'] = array (); } $query_args['tax_query'][] = array( 'taxonomy' => 'category', 'field' => 'slug', 'terms' => 'tech', ); $query_args['tax_query'][] = array( 'taxonomy' => 'category', 'field' => 'slug', 'terms' => 'sport', ); return $query_args; }` The filter function gets the query parameters as a first argument ($query_args in the example above) and must return the query parameters. The query parameters must be in the same syntax as for the WP_Query function.
ignore_sticky_posts	Specifies whether the sticky posts should be ignored (true \| false). Default is false.
meta_key	If the orderby attribute is set to meta_value or meta_value_num, the meta_key attribute specifies the name of the post meta to order by.
order	Specifies the sort order direction ( DESC \| ASC ). Default: DESC.
orderby	Specifies the name of the sort field. Possible values: ID: Order by post id post__in: the posts will be in the same order as they are specified for the post_ids attribute author: Order by author title: Order by title date: Order by date meta_value: Order by string meta value. The meta_key attribute specifiies the name of the post meta to order by. meta_value_num: Order by numeric meta value. The meta_key attribute specifiies the name of the post meta to order by. modified: Order by last modified date parent: Order by post/page parent id comment_count: Order by number of comments rand: Random order none: No order Default is date.
post_ids	The identifiers of posts to show, separated by commas. To get the identifier of a post, open its page on the admin panel and look at the URL in the location bar of your browser. The URL contains a 'post=number' substring, where the number is the identifier of the post.
post_type	Search for posts from the given post type. This option is supported only if the query shortcode is within a [slideshow] or [gallery_list] shortcode. The post type is always "post", "news" and "portfolio" for the [post_list], new_list, [portfolio_list] shortcodes.
posts_per_page	The number of posts to show.

[selector]

Shortcode	Supported in Post List shortcodes	Supported in [gallery_list] shortcode	Supported in [slideshow] shortcode	Supported in [slider_custom_slides] shortcode
[selector]	Yes	Yes	Yes	Yes

The selector shortcode allows you to specify individual settings for certain items in a listing or slideshow.

Attributes:
selector	Specifies the selector expression. Selectors allow you to target posts and pages according to their post types, formats, categories, tags, authors, CSS classes and custom fields. Additionally, selectors can also be used for media not just posts. See Selectors for details.

There is shortcode that can be nested into the selector shortcode, the [item_settings] shortcode that allows you to apply custom settings to posts and media.

Examples

I want to display the 15 latest blog posts in a 3-column list and I want the posts whose Post CSS Class option is set to "red" to have a different thumbnail size as the other posts in the list.

In this post list, the thumbnail size is 200x150 for posts with ".red" CSS class and 100x75 in any other cases:

[post_list col_num="3"]
	[query posts_per_page="15" /]
	[item_settings media_width="100" media_height="75" /]
	[selector selector=".red"]
		[item_settings media_width="200" media_height="150" /]
	[/selector]
[/post_list]

I want to display the 15 latest blog posts in a 3-column list and I want the posts from the "tech" category to have a different thumbnail size as the other posts in the list.

In the following post list, the thumbnail size is 200x150 for posts from the "tech" category and 100x75 in any other cases. Since the WordPress shortcode parser does not accept square brackets within attributes, use curly brackets instead ({category=tech} instead of [category=tech])!

[post_list col_num="3"]
	[query posts_per_page="15" /]
	[item_settings media_width="100" media_height="75" /]
	[selector selector="{category=tech}"]
		[item_settings media_width="200" media_height="150" /]
	[/selector]
[/post_list]

I want to display the 15 latest blog posts in a 3-column list and I want the posts from the "tech" category to have a totally different look and feel as other posts in the list.

You should select a different post template for posts from the "tech" category as for other posts (more on Post Templates):

[post_list col_num="3"]
	[query posts_per_page="15" /]
	[item_settings post_template="post_template1" /]
	[selector selector="{category=tech}" /]
		[item_settings post_template="post_template2" /]
	[/selector]
[/post_list]

I have a gallery containing images. I want to display the images in a 3-column layout and I want certain images to be larger as the others in the listing.

You should add a unique CSS class to the "large" images (CSS Class option on the Edit Media screen). For instance if the corresponding images have a "large" CSS class, then you will need something like this:

[gallery_list galleries="name_of_gallery" col_num="3"]
	[item_settings media_width="100" media_height="70" /]
	[selector selector=".large" /]
		[item_settings media_width="200" media_height="150" /]
	[/selector]
[/gallery_list]

I have a gallery containing posts. I want to display them in a 3-column list and I want the posts whose Post CSS Class option is set to "red" to have a different thumbnail size as the other posts in the list.

In this post list, the thumbnail size is 200x150 for posts with ".red" CSS class and 100x75 in any other cases:

[gallery_list galleries="name_of_gallery" col_num="3"]
	[item_settings media_width="100" media_height="75" /]
	[selector selector=".red"]
		[item_settings media_width="200" media_height="150" /]
	[/selector]
[/gallery_list]

Multiple selector shortcodes can also be used.

For instance, to apply individial settings for posts from the "tech" and "sport" categories:

[post_list col_num="3"]
	[query posts_per_page="15" /]
	[item_settings media_width="100" media_height="75" /]
	[selector selector="{category=tech}"]
		[item_settings media_width="200" media_height="150" /]
	[/selector]
	[selector selector="{category=sport}"]
		[item_settings media_width="300" media_height="225" /]
	[/selector]
[/post_list]

For further details, please see

Selectors
[post_list] shortcode
[gallery_list] shortcode
[item_settings] shortcode

[item_settings]

Shortcode	Supported in Post List shortcodes	Supported in [gallery_list] shortcode	Supported in [slideshow] shortcode	Supported in [slider_custom_slides] shortcode
[item_settings]	Yes	Yes	Yes	Yes

Allows you to specify the settings that determine the look and feel of posts and media in a listing or slideshow.
For examples of its use, please click on the shortcode in the table above for which you want to use the item_settings shortcode.

Attributes:
Item Sizes
width	Only supported for slideshows and specifies the width of the slide. Base options: Slide Width option of the slideshow
height	Only supported for slideshows and specifies the height of the slide. Base options: Slide Height option of the slideshow
Media - Thumbnail & Overlay
media_width	Specifies the width of media, in pixels. It has an effect on both self hosted an external media and on thumbnails as well. Technically, this attribute specifies the default value for the width attribute of the [post_media] and [post_thumbnail] shortcodes. Base options: Thumbnail Width option of post listing pages Media Width option of the slideshow
media_height	Specifies the height of media, in pixels. It has an effect on both self hosted an external media and on thumbnails as well. Technically, this attribute the default value for the height attribute of the [post_media] and [post_thumbnail] shortcodes. Base options: Thumbnail Height option of post listing pages Media Height option of the slideshow
media_sizing_method	Specifies the sizing method for media (exact \| max-cut \| max-nocut). exact: the media should be displayed in the size as specified by the media_width and media_height attributes. max-cut: if the media is wider and higher than the area specified by the media_width and media_height attributes, then works the same as "Exact", otherwise if needed, the media will be cut down to fit the area, but will never be enlarged. max-nocut: if the media is larger than the area specified by the media_width and media_height attributes, the media will be scaled down to fit the area while keeping the aspect ratio. In other words, it keep the aspect ratio and works the same as the CSS max-width and max-height properties. Please note that the sizing method is always "max-nocut" for external media. Technically, this attribute the default value for the "sizing_method" attribute of the [post_media] and [post_thumbnail] shortcodes. Base options: Media Sizing Method option of the slideshow
media_align	Set the alignment of media (center \| left \| left_float \| right \| right_float). It has an effect on both self hosted an external media and on thumbnails as well. Technically, this attribute the default value for the "align" attribute of the [post_media] and [post_thumbnail] shortcodes. Base options: Thumbnail Alignment option of post listing pages
media_show_frame	Specifies whether to add a frame around media, or not (true \| false). It has an effect on both self hosted an external media and on thumbnails as well. Technically, this attribute the default value for the "show_frame" attribute of the [post_media] and [post_thumbnail] shortcodes. Base options: Show Media Frame option of the slideshow
media_overlay	The identifier of the overlay that should appear over media. It has an effect on both self hosted an external media and on thumbnails as well. To get the identifier of an overlay, go to Templates » Overlays and click on the overlay. Here you will find the id of the overlay. Please note that the hover_datas_to_show attribute has an effect on the overlay. It specifies which meta data is enabled to be shown. Technically, this attribute the default value for the "overlay" attribute of the [post_media] and [post_thumbnail] shortcodes. Base options: Thumbnail Overlay option of post listing pages Media Overlay option of the slideshow More on Overlays.
hover_datas_to_show	Specifies which data is enabled to be shown in the overlay (see media_overlay above). Supported values are a comma separated list of the following values: preview, read_more, title. Base options: Hover Meta Info option of post listing pages
Link settings
link_to	Specifies which URL the post title ([post_title] shortcode), the read more link and button (post_read_more and [read_more_button] shortcodes) and for image attachments (self hosted images) the image itself ([post_media] shortcode) should point to. Supported values are a comma separated list of the following values: permalink: for posts and pages, point to the single post page for self hosted media, point to the attachment page for external media and slides, this value is not supported additional: for self hosted and external media, point to the URL specified by the Target URL option for slides, point to the URL specified by the Slide Link option for portfolio posts, point to the URL specified by the External URL option for other types of posts, this value is not supported. media: for self hosted media, point to the attachment file for external media, point to the source URL for posts and pages, this value is not supported. Default is "additional,permalink" for media and slides, and "permalink" for posts and pages. For instance, "additional,permalink" means, if "additional" is empty use "permalink". Or similarly, "additional,media,permalink" means, if "additional" exists, use it, else if "media" exists use it, otherwise use "permalink". Also see the thumbnail_link_to, media_as_link and show_title_as_link attributes.
link_type	Set whether to display the "read more" and "visit site" text as a button or link. ( button \| link ). Technically, this attribute specifies the default value for the "type" attribute of the post_read_more and [post_visit_site] shortcodes. Base options: How to show links option of post listing pages
media_as_link	Specifies whether the post media should be displayed as a link or not ( true \| false ). This settings has an effect only on thumbnails ([post_thumbnail] shortcode) and on image attachments (self hosted images). In other words, this setting specifies whether the [post_thumbnail] shortcode should put the thumbnail into a link or not and whether the [post_media] shortcode should put image attachments into a link or not. For other types of media (external media and self hosted videos), the [post_media] shortcode never puts the media into a link. Base options: Show Media as Link option of the slideshow Also see the link_to, thumbnail_link_to and show_title_as_link attributes.
show_title_as_link	Specifies whether the post titles should appear as a link or a plain text ( true \| false ). Technically, this attribute specifies the default value for the "show_as_link" attribute of the [post_title] shortcode. Base options: Show title as a link option of post listing pages Show Title as Link option of the slideshow
thumbnail_link_to	Specifies which URL the post thumbnail ([post_thumbnail] shortcode) should point to. Supported values are a comma separated list of the following values: permalink: for posts and pages, point to the single post page for self hosted media, point to the attachment page for external media and slides, this value is not supported additional: for self hosted and external media, point to the URL specified by the Target URL option for slides, point to the URL specified by the Slide Link option for portfolio posts, point to the URL specified by the External URL option for other types of posts, this value is not supported. media: for self hosted media, point to the attachment file for external media, point to the source URL for posts and pages, this value is not supported. thumbnail_permalink: point to the attachment page of the thumbnail image. thumbnail_additional: point to the URL specified by the Target URL option of the thumbnail image. thumbnail_media: point to the attachment file of the thumbnail image. Default is "additional,permalink" for media and slides, and "permalink" for posts and pages. For instance, "additional,permalink" means, if "additional" is empty use "permalink". Or similarly, "additional,media,thumbnail_permalink" means, if "additional" exists, use it, else if "media" exists use it, otherwise use "thumbnail_permalink". Also see the link_to, media_as_link and show_title_as_link attributes.
Post Layout
category_icon	Specifies a category icon. Basically, the 'folder', 'nav', 'nav-2', 'nav-3', 'nav-4' and 'flag' icons are for categories, but you can use any icon. For a complete list of icons, see Font Icons. If no category icon is specified, the skin settings of the theme determines the icon. If you want to hide the category icon, use the value of 'none'. Technically, this attribute specifies the default value for the "icon" attribute of the [post_category] shortcode. Base options: category icon skin settings of the theme (under Meta Info menu in the Theme Editor)
category_iconset	Specifies the icon set that contains the category icon (see category_icon above). If no icon set is specified, the theme automatically tries to find an icon set that contains the icon. For the supported icon sets, see Font Icons. Technically, this attribute specifies the default value for the "iconset" attribute of the [post_category] shortcode.
comments_icon	Specifies a comments icon. Basically, the 'comment', 'comment-wire', 'comment-2', 'comment-wire-2', 'comment-3', 'comment-4', 'comment-5', 'comment-6', 'comment-7', 'comment-8', 'comments', 'comments-wire', 'comments-2' and 'comments-wire-2' icons are for comments, but you can use any icon. For a complete list of icons, see Font Icons. If no comments icon is specified, the skin settings of the theme determines the icon. If you want to hide the comments icon, use the value of 'none'. Technically, this attribute specifies the default value for the "icon" attribute of the [post_comments_num] shortcode. Base options: comments icon skin settings of the theme (under Meta Info menu in the Theme Editor)
comments_iconset	Specifies the icon set that contains the comments icon (see comments_icon above). If no icon set is specified, the theme automatically tries to find an icon set that contains the icon. For the supported icon sets, see Font Icons. Technically, this attribute specifies the default value for the "iconset" attribute of the [post_comments_num] shortcode.
datas_to_show	The meta data to show, separated by commas (author, caption, category, comments, date, preview, read_more, tags, title). Technically, this attribute specifies the default value for the "show_caption" attribute of the post_media and [post_thumbnail] shortcodes. Base options: Meta Info option of post listing pages
date_icon	Specifies a date icon. Basically, the 'time', 'time-2', 'time-3', 'time-4', 'time-5', 'hour-glass', 'calendar', 'calendar-2' and 'calendar-3' icons are for dates, but you can use any icon. For a complete list of icons, see Font Icons. If no date icon is specified, the skin settings of the theme determines the icon. If you want to hide the date icon, use the value of 'none'. Technically, this attribute specifies the default value for the "icon" attribute of the [post_date] shortcode. Base options: date icon skin settings of the theme (under Meta Info menu in the Theme Editor)
date_iconset	Specifies the icon set that contains the date icon (see date_icon above). If no icon set is specified, the theme automatically tries to find an icon set that contains the icon. For the supported icon sets, see Font Icons. Technically, this attribute specifies the default value for the "iconset" attribute of the [post_date] shortcode.
excerpt_length	Set the length of excerpts in characters. Works for both media descriptions and excerpts of posts. Technically, this attribute specifies the default value for the "excerpt_length" attribute of the [post_content] shortcode. Base options: Excerpt Length option of post listing pages Excerpt Length option of the slideshow
excerpt_length_nothumb	Set the excerpt length for posts that appear without thumbnail, in characters. Technically, this attribute specifies the default value for the "excerpt_length" attribute of the [post_content] shortcode. Base options: Excerpt Length Without Thumbnail option of post listing pages
heading_class	Specifies a CSS class for the heading of post titles. Default is an empty string. The theme supports different classes for headings (see Headings) that allow you to display headings in different sizes, but you can also use custom CSS classes. An empty value means that the heading class is automatically calculated based on the number of columns in the list. The value of 'normal' means no need for heading class. Technically, this attribute specifies the default value for the "heading_class" attribute of the [post_title] shortcode.
heading_tag	Specifies the HTML heading element of post titles. Technically, this attribute specifies the default value for the "heading_tag" attribute of the [post_title] shortcode. Base options: Heading Tag option of the slideshow
post_preview	Specifies whether the whole content, the teaser, the excerpt or none of them should be shown. Possible values: full, excerpt, teaser_excerpt, teaser, only_title. Default is teaser_excerpt. This attribute does not have an effect on media and slides, only posts. Technically, this attribute specifies the default value for the "post_preview" attribute of the [post_content] shortcode. Base options: Content Preview option of post listing pages Post Content Preview option of the slideshow
post_template	Specifies the identifier of the post template that should be used for the 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. Base options: Post Template option of post listing pages Post Template option of the slideshow More on Post Templates.
read_more_button_skin	Set the skin of the read more button (available skins). Affects only if the read more text appears as a button (see link_type above). Technically, this attribute specifies the default value for the "skin" attribute of the [post_read_more] shortcode.
read_more_icon	Specifies a read more icon. Basically, the 'arrow-right', 'arrow-right-2', 'arrow-right-3', 'arrow-right-4', 'arrow-right-5', 'arrow-right-6', 'arrow-right-7' and 'arrow-right-8' icons are for read more, but you can use any icon. For a complete list of icons, see Font Icons. If no read more icon is specified, the skin settings of the theme determines the icon. If you want to hide the read more icon, use the value of 'none'. This attribute has an effect only if the read more text appears as a link (see link_type above). Technically, this attribute specifies the default value for the "icon_after" attribute of the [post_read_more] shortcode. Base options: read more icon skin settings of the theme (under Meta Info menu in the Theme Editor)
read_more_iconset	Specifies the icon set that contains the read more icon (see read_more_icon above). If no icon set is specified, the theme automatically tries to find an icon set that contains the icon. For the supported icon sets, see Font Icons. Technically, this attribute specifies the default value for the "iconset_after" attribute of the [post_read_more] shortcode.
tag_icon	Specifies a tag icon. Basically, the 'tag', 'tag-2', 'tag-3', 'tag-4', 'tag-5', 'paperclip', 'marker', 'marker-2', 'marker-3' icons are for tags, but you can use any icon. For a complete list of icons, see Font Icons. If no tag icon is specified, the skin settings of the theme determines the icon. If you want to hide the tag icon, use the value of 'none'. Technically, this attribute specifies the default value for the "icon" attribute of the [post_tags] shortcode. Base options: tag icon skin settings of the theme (under Meta Info menu in the Theme Editor)
tag_iconset	Specifies the icon set that contains the tag icon (see tag_icon above). If no icon set is specified, the theme automatically tries to find an icon set that contains the icon. For the supported icon sets, see Font Icons. Technically, this attribute specifies the default value for the "iconset" attribute of the [post_tags] shortcode.
user_icon	Specifies an icon to display for the post author. Basically, the 'user', 'user-2', 'users', 'users-2', 'v-card', 'v-card-2', 'v-card-3' and 'v-card-4' icons for authors, but you can use any icon. For a complete list of icons, see Font Icons. If no user icon is specified, the skin settings of the theme determines the icon. If you want to hide the user icon, use the value of 'none'. Technically, this attribute specifies the default value for the "icon" attribute of the [post_author] shortcode. Base options: author icon skin settings of the theme (under Meta Info menu in the Theme Editor)
user_iconset	Specifies the icon set that contains the user icon (see user_icon above). If no icon set is specified, the theme automatically tries to find an icon set that contains the icon. For the supported icon sets, see Font Icons. Technically, this attribute specifies the default value for the "iconset" attribute of the [post_author] shortcode.
visit_site_button_skin	Set the skin of the visit site button (available skins). Affects only if the visit site text appears as a button (see link_type above). Technically, this attribute specifies the default value for the "skin" attribute of the [post_visit_site] shortcode.
visit_site_icon	Specifies a visit site icon. Basically, the 'arrow-right', 'arrow-right-2', 'arrow-right-3', 'arrow-right-4', 'arrow-right-5', 'arrow-right-6', 'arrow-right-7' and 'arrow-right-8' icons are for visit site, but you can use any icon. For a complete list of icons, see Font Icons. If no visit site icon is specified, the skin settings of the theme determines the icon. If you want to hide the visit site icon, use the value of 'none'. This attribute has an effect only if the visit site text appears as a link (see link_type above). Technically, this attribute specifies the default value for the "icon_after" attribute of the [post_visit_site] shortcode. Base options: visit site icon skin settings of the theme (under Meta Info menu in the Theme Editor)
visit_site_iconset	Specifies the icon set that contains the visit site icon (see visit_site_icon above). If no icon set is specified, the theme automatically tries to find an icon set that contains the icon. For the supported icon sets, see Font Icons. Technically, this attribute specifies the default value for the "iconset_after" attribute of the [post_visit_site] shortcode.

[popup_gallery_settings]

Shortcode	Supported in Post List shortcodes	Supported in [gallery_list] shortcode	Supported in [slideshow] shortcode	Supported in [slider_custom_slides] shortcode
[popup_gallery_settings]	Yes	Yes	Yes	Yes

Popup slideshows can be opened from both listings and slideshows. The [popup_gallery_settings] shortcode allows you to specify their settings.

Attributes:
enable	Enable this option if you want to open popup slideshows from a listing or slideshow (true \| false). There are two shortcodes that are designed to open popup slideshows: the [gallery_button] and [popup_opener] shortcodes. If you select an overlay or post template for the posts (media_overlay and post_template attributes of a nested [item_settings] shortcode) that contains a [gallery_button] or [popup_opener] shortcode, then clicking on it will open a popup slideshow. The popup slideshow will display the given gallery (popup_galleries option below) of the corresponding post or all posts based on the setting of the "separate" option (see below). For performance reasons, do not enable this option if you don't need popup galleries.
popup_galleries	Comma separated list of galleries that should be open in the popup slideshow. For instance, "gallery1" means that the popup slideshow will display the "gallery1" gallery of posts, while "gallery1, gallery2" means that the popup slideshow will display both the "gallery1" and "gallery2" galleries of posts. Additionally, there are two special values: _default: identifies the default gallery. For instance, "_default" means the same as an empty string, "_default, gallery1" means that the popup slideshow will display both the default gallery and the "gallery1" gallery of posts. _same: the popup slideshow will display the same gallery (same posts) as the listing/slideshow. It works when the gallery is specified directly ("galleries" attribute of the [slideshow] and [gallery_list] shortcodes) and also when the slideshow or post list displays the result of a query ([query] shortcode nested into a [slideshow] or [post_list] shortcode). For instance, if you have a gallery containing 5 videos and every video has a thumbnail, you can display the thumbnails as a carousel slideshow or a list and clicking on the thumbnails opens a popup slideshow displaying the videos. Or for instance, you can display the thumbnails of the 5 latest posts in the carousel slideshow or a list and clicking on the thumbnails a popup slideshow opens displaying full size thumbnails, post titles and descriptions. See this demo page, it demonstrates the use the the "_same" value for post list pages.
separate	Specifies whether the popup slideshow should display the given gallery (popup_galleries option above) of only the corresponding post or all posts (true \| false). For instance, if the popup_galleries option is set to '_default', then: if the separate_popup_galleries option is enabled, then the popup slideshow will display only the default gallery of the corresponding post if the separate_popup_galleries option is disabled, then the popup slideshow will display the default galleries of all posts
gallery_popup	Specifies the identifier of the gallery popup (popup slideshow). To get the identifier of a gallery popup, go to Popups » Gallery Popups and click on the popup. Here you will find the id of the popup. There is a special value "_determined_by_gallery" that means that the (first) displayed gallery determines the gallery popup. For further details, please see Popup Slideshows.

[pagination_settings]

Shortcode	Supported in Post List shortcodes	Supported in [gallery_list] shortcode	Supported in [slideshow] shortcode	Supported in [slider_custom_slides] shortcode
[pagination_settings]	Yes	No	No	No

Allows you to specify the settings of the pagination for a post listing.

Attributes:
ajax	Set whether to use AJAX pagination or not (true \| false). Default is false.
load_more_above_bottom	Specifies the vertical distance from the bottom of the post list in pixels from where more content is being loaded dynamically when the user scrolls beyond. Default is 300. This option has only effect if the "type" attribute is set to "scroll" or "more_button_scroll".
align	Sets the alignment of pagination. If this attribute is not specified, the value will be taken from 'Theme Options' > General.
paging_animation	Here you can set an animation effect for AJAX pagination. none - none cards - Cards fade - Fade localmove - Local Move localmove_left_left - Local Move Left In Left Out localmove_left_right - Local Move Left In Right Out localmove_left_random - Local Move Left In Random Out localmove_right_right - Local Move Right In Right Out localmove_right_left - Local Move Right In Left Out localmove_right_random - Local Move Right In Random Out localmove_random_random - Local Move Random In Random Out localmove_random_left - Local Move Random In Left Out localmove_random_right - Local Move Random In Right Out move - Move move_left_left - Move Left In Left Out move_left_right - Move Left In Right Out move_left_random - Move Left In Random Out move_right_right - Move Right In Right Out move_right_left - Move Right In Left Out move_right_random - Move Right In Random Out move_random_random - Move Random In Random Out move_random_left - Move Random In Left Out move_random_right - Move Random In Right Out scale - Scale
paging_duration	Specifies the duration of the paging animation, in milliseconds. 0 means that the duration is calculated automatically. Default is 0.
type	Specifies the type of the pagination (text \| number \| more_button \| more_button_scroll \| scroll). text - default WordPress pagination (a previous and next link) number - numerical pagination more_button - a single button that allows to load more content more_button_scroll - initially a more button then, if the user clicks on it, works the same as "scroll" scroll - automatically load more posts as the user scrolls down the list The 'scroll' and 'more_button_scroll' pagination types require Ajax pagination. Also see the load_more_above_bottom attribute. If this attribute is not specified, the value will be taken from the "Page navigation type" option under Theme Options » General.
show	Specifies whether the pagination should be displayed or not (true \| false). Default is 'false'.

[browsing_filter_settings]

Shortcode	Supported in Post List shortcodes	Supported in [gallery_list] shortcode	Supported in [slideshow] shortcode	Supported in [slider_custom_slides] shortcode
[browsing_filter_settings]	Yes	No	No	No

Allows you to specify the settings of browsing filters for a post listing.

Attributes:
show	Specifies whether categories should be displayed as browsing filters or not (true \| false). Default is false. Browsing filters are displayed only if more than one category exists.
show_all_filter	Set whether to add the 'All' filter to the browsing filters or not. Default is true.
show_child_cats_as_filter	Specifies whether the child categories of the selected categories should be shown as browsing filters (true \| false). Default is false.

[general_settings]

Shortcode	Supported in Post List shortcodes	Supported in [gallery_list] shortcode	Supported in [slideshow] shortcode	Supported in [slider_custom_slides] shortcode
[general_settings]	No	No	Yes	Partially - hide_slides attribute is supported, others not

Allows you to override the general settings of a slideshow. You will find these settings in the "General" section on the Edit Slideshow Sreen (Slideshows » Slideshows).

Attributes:
slideshow_template	Specifies the identifier of the slideshow template used for the slideshow. To get the identifier of a slideshow template, go to Templates » Slideshow Templates and click on the template. Here you will find the id of the template. Overrides the Slideshow Template option of the slideshow.
classname	Space separated list of CSS classes to add to the container element of the slideshow. Overrides the CSS Class option of the slideshow.
active_idx	Specifies the zero-based index of the slide that should be initially active. Overrides the Active Slide Index option of the slideshow.
hide_slides *	Select the slides you want to hide from search engines (no \| all_except_active \| all). Overrides the Hide Slides From Search Engines option of the slideshow.
orientation	Select whether the slider should be horizontal or vertical (horizontal \| vertical). Overrides the Orientation option of the slideshow.
slide_align	Specifies the default alignment of slides in the direction corresponding to the orientation of the slider (left_or_top \| right_or_bottom \| center \| direction). Overrides the Slide Align option of the slideshow.
slide_op_orient_align	Specifies the alignment of slides in the direction opposite to the orientation of the slider (left_or_top \| right_or_bottom \| center). Overrides the Slide Align - Opposite Direction option of the slideshow.
slide_align_horizontal	Specifies the horizonal alignment of slides (left \| center \| right). Overrides the Horizontal Slide Alignment option of the slideshow.
slide_align_vertical	Specifies the vertical alignment of slides (top \| center \| bottom). Overrides the Vertical Slide Alignment option of the slideshow.
overscroll	Specifies the amount of space before the first and after the last slide (none \| min \| max) Overrides the Overscroll option of the slideshow.
circular	Specifies whether the slider should be circular, or not (true \| false). Overrides the Circular option of the slideshow.
slides_per_page	Specifies the number of slides in a page. Overrides the Slides Per Page option of the slideshow.
pause_on_over	Select whether slide transitions should be paused when the mouse is over the slideshow, the slides or no need to pause transitions (slideshow \| slides \| none). Overrides the Pause Autoplay On Over option of the slideshow.
pause_type	Specifies the type of pause (soft \| hard). Overrides the Pause Type option of the slideshow.
slide_activation	Select whether clicking on a slide activates it or not (none \| click). Overrides the Slide Activation option of the slideshow.
auto_slide_align	Select whether the slides should be aligned automatically after dragging and scrolling (true \| false). Overrides the Auto Slide Align option of the slideshow.
* attribute is supported within a [slider_custom_slides] shortcode also

[dimension_settings]

Shortcode	Supported in Post List shortcodes	Supported in [gallery_list] shortcode	Supported in [slideshow] shortcode	Supported in [slider_custom_slides] shortcode
[dimension_settings]	No	No	Yes	No

Allows you to override the dimensions of a slideshow. You will find these settings in the "Dimensions" section on the Edit Slideshow Sreen (Slideshows » Slideshows).

Attributes:
width	Specifies the width of slideshow, in pixels. Overrides the Slideshow Width option of the slideshow.
height	Specifies the height of slideshow, in pixels. Overrides the Slideshow Height option of the slideshow.
flex_height	Select whether the height of the slideshow should be reduced when there is not enough vertical space for the slideshow (true \| false). Overrides the Flexible Height option of the slideshow.
inner_view_width	Specifies the width of the inner view. Overrides the Inner View Width option of the slideshow.
inner_view_height	Specifies the height of the inner view. Overrides the Inner View Height option of the slideshow.
inner_view_flex_height	Specifies whether the height of the inner view should be reduced when there is not enough vertical space for it (true \| false). Overrides the Inner View Flexible Height option of the slideshow.
context_dep_slide_width	Specifies whether the slide width should depend on the context or the content of the slide (true \| false). Overrides the Context Dependent Slide Width option of the slideshow.
slides_scale_down	Specifies whether the slides should be scaled down when they are wider/higher then the visible area (true \| false). Overrides the Scale Slides option of the slideshow.
scale_highlight_slides_num	Specifies the maximum number of slides to highlight. Overrides the Scale Highlighting - Number of slides to highlight option of the slideshow.
scale_highlight_min_scale	Specifies the scale amount of non-highlighted slides. Overrides the Scale Highlighting - Minimum scale option of the slideshow.
scale_highlight_overlap	Specifies the measure of overlap of slides. Overrides the Scale Highlighting - Overlap option of the slideshow.
* attribute is supported within a [slider_custom_slides] shortcode also

[transition_settings]

Shortcode	Supported in Post List shortcodes	Supported in [gallery_list] shortcode	Supported in [slideshow] shortcode	Supported in [slider_custom_slides] shortcode
[transition_settings]	No	No	Yes	No

Allows you to override the transition settings of a slideshow.

Attributes:
type	Specifies the type of the transiton which settings you want to overwrite. Possible values: default, absolute, relative, autoplay. If the type is not specified, the default transition settings will be overridden.
Default Transitions
enable_autoplay	Specifies the state of autoplay after the transition (enable \| disable \| no_change). Overrides the Autoplay After Transition option of the slideshow.
slide_align	Specifies the alignment of slides at the end of the transition (auto \| dir). Overrides the Slide Align option of the slideshow.
change_active	Specifies whether the transition should change the active slide or not (no_change \| change). Overrides the Change Active Slide option of the slideshow.
active_pos	Specifies the position of the active slide relative to the alignment of slides. Overrides the Active Slide Position option of the slideshow.
move_slides	Specifies when you want the slides to be scrolled (always \| visible \| inward). Overrides the Move Slides option of the slideshow.
anim_duration	Specifies the duration of the transition animation, in milliseconds. Overrides the Animation Duration option of the slideshow.
min_speed	Specifies the minimum number of pixels the slides should be scrolled by during the transition animation per second. Overrides the Minimum Scrolling Speed option of the slideshow.
anim_type	Specifies the type of the transition animation. Overrides the Animation Type option of the slideshow.
anim_easing	Specifies the easing of the transition animation. Overrides the Animation Easing option of the slideshow.
Type-specific Transition Options
Relative Transitions
unit	Specifies the unit of the transition (slide \| page \| view \| view_slide_boundary \| px \| %). Overrides the Unit option of the slideshow.
value	The amount of units to scroll by. Overrides the Value option of the slideshow.
end_action	Set the action that should be taken when the transition cannot be performed because the slides are scrolled to the start/end position (stop \| rewind \| turn_back). Overrides the End Action option of the slideshow.
Autoplay Transition
dir	Select the direction of the autoplay animation (empty string \| prev \| next). Overrides the Direction option of the slideshow.
delay	Specifies the delay time, in milliseconds, before the transition begins. Overrides the Delay option of the slideshow.

[autoplay_settings]

Shortcode	Supported in Post List shortcodes	Supported in [gallery_list] shortcode	Supported in [slideshow] shortcode	Supported in [slider_custom_slides] shortcode
[autoplay_settings]	No	No	Yes	No

Allows you to override the settings of the automatic playing in a slideshow.

Attributes:
enabled	Enable or disable automatic playing. (true \| false). Overrides the Enable Autoplay option of the slideshow.
show_autoplay_button	Specifies whether to show the play/pause buttons, or not. (true \| false). Overrides the Show Autoplay Button option of the slideshow.
autoplay_button_visibility	Specifies whether the autoplay button should be always visible, only when it is enabled or only when the mouse hovers over the slideshow (always \| enabled \| hover \| hover_hide_change). Overrides the Autoplay Button Visibility option of the slideshow.
autoplay_button_skin	Specifies the skin for the autoplay button (empty string \| light \| dark). Overrides the Autoplay Button Skin option of the slideshow.
autoplay_button_shape	Specifies the shape of the autoplay button (empty string \| simple \| square \| square_border \| square_small \| square_small_border \| square_medium \| square_medium_border \| rect \| disc \| disc_border \| disc_small \| disc_small_border \| disc_medium \| disc_medium_border \| halfdisc). Overrides the Autoplay Button Shape option of the slideshow.
play_icon	Set the icon of the play button. For a complete list of icons, see Font Icons. If you want to hide the icon, use the value of 'none'. Overrides the Play Button Icon option of the slideshow.
pause_icon	Set the icon of the pause button. For a complete list of icons, see Font Icons. If you want to hide the icon, use the value of 'none'. Overrides the Pause Button Icon option of the slideshow.
show_timeline	Specifies whether to show the autoplay progress line, or not (true \| false). Overrides the Show Timeline option of the slideshow.
timeline_skin	Specifies the skin for the timeline (empty string \| light \| dark). Overrides the Timeline Skin option of the slideshow.

[prev_next_settings]

Shortcode	Supported in Post List shortcodes	Supported in [gallery_list] shortcode	Supported in [slideshow] shortcode	Supported in [slider_custom_slides] shortcode
[prev_next_settings]	No	No	Yes	No

Allows you to override the settings of the previous and next navigation and dragging in a slideshow.

Attributes:
show	Specifies whether to show the previous and next navigation buttons, or not (true \| false). Overrides the Show Prev/Next Buttons option of the slideshow.
visibility	Specifies whether the previous and next navigation buttons should be always visible, only when they are enabled or only when the mouse hovers over the slideshow (always \| enabled \| hover \| hover_hide_change). Overrides the Prev/Next Buttons Visibility option of the slideshow.
skin	Specifies the skin for the previous and next buttons (empty string \| light \| dark). Overrides the Prev/Next Buttons Skin option of the slideshow.
shape	Specifies the shape of the previous and next buttons (empty string \| simple \| square \| square_border \| square_small \| square_small_border \| square_medium \| square_medium_border \| rect \| disc \| disc_border \| disc_small \| disc_small_border \| disc_medium \| disc_medium_border \| halfdisc \| fullsize). Overrides the Prev/Next Buttons Shape option of the slideshow.
prev_icon	Sets the icon of the previous button. Empty string means that the icon is selected automatically. For a complete list of icons, see Font Icons. If you want to hide the icon, use the value of 'none'. Overrides the Previous Button Icon option of the slideshow.
next_icon	Sets the icon of the next button. Empty string means that the icon is selected automatically. For a complete list of icons, see Font Icons. If you want to hide the icon, use the value of 'none'. Overrides the Next Button Icon option of the slideshow.
pause_on_over	Specifies whether the slideshow should be paused when the mouse is over the previous or next button (true \| false). Overrides the Pause Autoplay On Over option of the slideshow.
enable_key_navigation	Specifies whether keyboard navigation is allowed, or not (true \| false). Overrides the Enable Keyboard Navigation option of the slideshow.
repeat_delay	Holding down the left mouse button or your finger on the previous or next navigation button changes the slides continuously. The same happens when the keyboard navigation is enabled and you hold down the left or right arrow key. The "Repeat Delay" option allows you to specify the pause time between slide transitions, in milliseconds. A negative value means that automatic playing is disabled. Overrides the Repeat Delay option of the slideshow.
drag_support	Specifies the devices you want the drag support to be enabled for (none \| mouse \| touch \| all). Overrides the Drag Support option of the slideshow.

[navigation_settings]

Shortcode	Supported in Post List shortcodes	Supported in [gallery_list] shortcode	Supported in [slideshow] shortcode	Supported in [slider_custom_slides] shortcode
[navigation_settings]	No	No	Yes	No

Allows you to override the navigation settings of a slideshow.

Attributes:
type	Specifies the type of the navigation (nonavigation \| custom \| images \| image_no_border \| numbers \| disc \| rect). Overrides the Navigation Type option of the slideshow.
skin	Specifies the skin of the navigation (available skins). Overrides the Navigation Skin option of the slideshow.
visibility	Specifies whether the navigation should be always visible or only when the mouse hovers over the slideshow (always \| hover \| hover_hide_change). Overrides the Navigation Visibility option of the slideshow.
pause_on_over	Specifies whether the slideshow should be paused when the mouse is over the navigation, or not (true \| false). Overrides the Pause Autoplay On Over option of the slideshow.
show_tooltip	Specifies whether to show a tooltip over the navigation items or not (true \| false). Works for all navigation types excluding the custom one. Overwrites the Show Tooltip option of the slideshow.
event	Specifies the event that should trigger the slide transition (click \| mousedown \| mouseenter). Overrides the Event option of the slideshow.
unit	Specifies the unit of the navigation. (slide \| page). Overrides the Navigation Unit option of the slideshow.
align	Specifies the alignment of the navigation (left \| center \| right). Overrides the Alignment option of the slideshow.
item_width	Specifies the width of the navigation items, in pixels. Overrides the Navigation Item Width option of the slideshow.
item_height	Specifies the height of the navigation items, in pixels. Overrides the Navigation Item Height option of the slideshow.
scale_down	Specifies whether the navigation should be scaled down if there is no enough space for it or the items should be displayed in multiple rows (true \| false). Overrides the Scale Down setting of the slideshow.
map_gallery	By default, the same gallery is used for the navigation as for the slideshow (slides), but you can change this behavior. Currently, only the _parent_post value is supported that means that the gallery used for the navigation will contain the parent posts of the gallery items used for the slideshow. Overwrites the Map Gallery setting of the slideshow.

[range_settings]

Shortcode	Supported in Post List shortcodes	Supported in [gallery_list] shortcode	Supported in [slideshow] shortcode	Supported in [slider_custom_slides] shortcode
[range_settings]	No	No	Yes	No

Allows you to override the settings of the range control in a slideshow.

Attributes:
show	Specifies whether to show a range navigation, or not (true \| false). Overrides the Show Range Navigation option of the slideshow.
skin	Specifies a skin for the thumb of the range navigation (empty string \| light \| dark). Overrides the Thumb Skin option of the slideshow.
anim_duration	Specifies how long the thumb should take, in milliseconds, to move to a new position. Overrides the Animation Duration option of the slideshow.
anim_easing	Specifies an easing for the thumb animation. Overrides the Animation Easing option of the slideshow.

Dottoro Theme Documentation

Tutorial to get your theme to work

Shortcodes within listings and slideshows

[empty_list]

[before_list]

[after_list]

[query]

[selector]

Examples

Multiple selector shortcodes can also be used.

[item_settings]

[popup_gallery_settings]

[pagination_settings]

[browsing_filter_settings]

[general_settings]

[dimension_settings]

[transition_settings]

[autoplay_settings]

[prev_next_settings]

[navigation_settings]

[range_settings]

Membership

Help & Support

Dottoro