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
<

Nested Shortcodes

You can use shortcodes within shortcodes in the Dottoro theme. So for example the following code snippet displays a three-column layout, a button in the first column, a post list in the second one and a slideshow in the third one:

[row]
	[col3]
		[button href="#" skin="sand" size="medium"]
			[icon icon="users" /]Users
		[/button]
	[/col3]
	[col3]
		[post_list
			datas_to_show="title, preview, read_more"
			posts_per_page="6"
			col_num="1"
		/]
	[/col3]
	[col3]
		[slideshow name='Home' /] 
	[/col3]
[/row]

Sometimes the need arises to use the same shortcode within itself. For example when you want to use tabs in tabs, or toggles in toggles, or a two-column layout within a two-column layout. Unfortunately WordPress doesn't allow that, so for example the followings are invalid:

[foo]
	[foo]
	[/foo]
[/foo]
[row]
	[col2]
		content ...
		[row]
			[col2]
				content ...
			[/col2]
			[col2]
				content ...
			[/col2]
		[/row]
		content ...
	[/col2]
	[col2]
		content ...
	[/col2]
[/row]

Dottoro theme provides a solution to this issue. Just add a plus sign to the beginning of the shortcode's name at each nested level and your are done:

[foo]
	[+foo]
		[++foo]
		[/++foo]
	[/+foo]
[/foo]
[row]
	[col2]
		content ...
		[+row]
			[+col2]
				content ...
			[/+col2]
			[+col2]
				content ...
			[/+col2]
		[/+row]
		content ...
	[/col2]
	[col2]
		content ...
	[/col2]
[/row]

Please note that the plus sign can only be used in the right context:

[+foo]
[/+foo]
[foo1]
[+foo2]
[/+foo2]
[/foo1]
[foo]
[++foo]
[/++foo]
[/foo]
[row]
	[col2]
		content ...
		[+row]
			[+col3]
				content ...
			[/+col3]
			[+col3]
				content ...
			[/+col3]
			[+col3]
				content ...
			[/+col3]
		[/+row]
		content ...
	[/col2]
	[col2]
		content ...
		[+row]
			[col3]
				content ...
			[/col3]
			[col3]
				content ...
			[/col3]
			[col3]
				content ...
			[/col3]
		[/+row]
		content ...
	[/col2]
[/row]