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
<

Slideshow Shortcode

[slideshow]

In the Dottoro theme, slideshows can be created and managed under Slideshows » Slideshows. Every time you want to add a slideshow to your pages, you should specify the slideshow and the gallery you want to display in the slideshow. The gallery contains the items (images, posts, etc.) you want to display while the slideshow determines the way they should be displayed (more on Galleries and Slideshows).

There are two ways of adding slideshows to your pages: the [slideshow] shortcode and the Slideshow Widget. Both allow you to specify the slideshow and the gallery you want to display.
Additionally, it is also possible to query for posts and display the result in a slideshow. For instance, you can display the 5 latest blog posts in a slideshow. You don't need to do anything else just put a [query] shortcode into the slideshow shortcode by specifying the query parameters. Or if the slideshow is displayed with a Slideshow Widget, then you can use the "Extra Settings" field for this purpose.

There are a couple of shortcodes that can be nested into a slideshow shortcode. These are:

These shortcodes allow you to:

Attributes:
name The identifier of the slideshow you want to display.
To get the identifier of a slideshow, go to Slideshows » Slideshows and click on the slideshow. Here you will find the id of the slideshow.
galleries Specifies the name of a gallery or a comma separated list of gallery names that should be displayed in the slideshow.
  • If a [query] shortcode is nested into the slideshow shortcode:
    • If the "galleries" attribute is specified, the slideshow will display the given galleries of the queried posts.
    • If the "galleries" attribute is not specified, the slideshow will display the queried posts.
  • If there is no [query] shortcode within the slideshow shortcode:
    • If the "galleries" attribute is specified, the slideshow will display the given galleries of the current post.
    • If the "galleries" attribute is not specified, the slideshow will display the default gallery of the current post.
Some examples:
  • If the "galleries" attribute is set to "gallery1" and there is no [query] shortcode within the slideshow shortcode, the slideshow will display the "gallery1" gallery of the post where the slideshow is shown.
  • If the "galleries" attribute is set to "gallery1, gallery2" and there is no [query] shortcode within the slideshow shortcode, the slideshow will display both the "gallery1" and "gallery2" galleries of the post where the slideshow is shown.
  • If the "galleries" attribute is set to "gallery1" and a [query] shortcode nested into the slideshow shortcode, the slideshow will display the "gallery1" galleries of the queried posts.
  • If the "galleries" attribute is not set or set to an empty string and a [query] shortcode nested into the slideshow shortcode, the slideshow will display the queried posts.

Additionally, you can also use the post_id:gallery_name syntax to refer to a gallery of another post or a global gallery. For instance, "23:gallery1" refers to the "gallery1" gallery of the post with id of 23, "0:gallery1" refers to the "gallery1" global gallery.

Finally, there is a special value, the "_default" that identifies the default gallery of a post. For instance, if the "galleries" attribute is set to "_default" and a [query] shortcode nested into the slideshow shortcode, the slideshow will display the default galleries of the queried posts. More on Galleries and the Default Gallery.
group Specifies a group identifier or a comma separated list of group identifiers for the posts appearing in the list. This attribute is useful if there are multiple post lists, gallery lists and/or slideshows on the same page and you want each post to appear at most once. In this case, just give the same group identifier to the post lists, gallery lists and slideshows and they will display different posts.

Quick Examples:
This example displays the "name_of_gallery" global gallery in the "id_of_slideshow" slideshow:

[slideshow name="id_of_slideshow" galleries="0:name_of_gallery" /]

This example displays the "name_of_gallery" gallery of the post in the "id_of_slideshow" slideshow:

[slideshow name="id_of_slideshow" galleries="name_of_gallery" /]

This example displays the 5 latest blog posts in the "id_of_slideshow" slideshow:

[slideshow name="id_of_slideshow"]
	[query post_type="post" posts_per_page="5" /]
[/slideshow]

For further details and examples, please see the Slideshows section.

Live example

Flash Slideshow Shortcode

[flash_slideshow]
The development of the Dottoro Flash Slideshow application has been finished and it is deprecated from version 1.42. Use the JavaScript Slideshow instead.

With this shortcode you can add Flash slideshows to your pages and post. Since the Dottoro theme provides a highly flexible JavaScript slideshow, we highly recommend to use it instead of the Flash slideshow.

For further details, please see Dottoro Flash Slideshow application.

Attributes:
align The horizontal alignment of the slideshow (left | center | right). The default is center.
width The width of the slideshow, in pixels.
height The height of the slideshow, in pixels.
name The name of your Flash slideshow, created under 'Flash Slideshows'.
url The URL of the slideshow XML file.