Home General Blocks Overview

Blocks Overview

Last updated on Sep 16, 2025

Blocks Overview

The Itinerator plugin provides two main categories of blocks to display tourism content on your WordPress site.

Block Categories

Content Blocks

Individual content display blocks that show specific pieces of information.

Use these when you want to:

  • Display a single piece of content
  • Show specific information about an item
  • Create custom layouts with individual elements

Available Content Blocks:

Collection Blocks

Blocks that display multiple items from your Itinerator content.

Use these when you want to:

  • Show lists of content (itineraries, listings, events)
  • Display multiple items in grids or carousels
  • Create browseable content sections

Available Collection Blocks:

How to Choose the Right Block

For Single Items

Use Content Blocks when you want to display:

  • A specific title or heading
  • Individual content pieces
  • Custom forms or maps
  • Social media links
  • Business contact information

For Multiple Items

Use Collection Blocks when you want to display:

  • Lists of itineraries
  • Business directories
  • Event calendars
  • Challenge listings
  • Regional content

For Custom Layouts

Combine both types to create:

  • Hero sections - Title + Map + Description
  • Content grids - Multiple Content blocks in columns
  • Business pages - Listing Info + Listing Buttons + Map
  • Event pages - Event details + Related Events + Socials

Block Configuration

Common Settings

Most blocks share these configuration options:

Display Options:

  • Show Title - Display/hide the title
  • Show Description - Display/hide description text
  • Show Image - Display/hide featured images
  • Show Tags - Display/hide content tags

Layout Options:

  • Columns - Number of columns for grid layouts
  • Alignment - Left, center, or right alignment
  • Custom CSS Class - Add custom styling classes

Content Options:

  • Content Type - Filter by specific content types
  • Tag Filters - Filter by specific tags
  • Sort Order - How to sort the content

Block-Specific Settings

Each block has unique settings relevant to its purpose:

  • Map blocks - Zoom level, map style, marker options
  • Form blocks - Form fields, submission settings
  • Carousel blocks - Auto-play, navigation options
  • Filter blocks - Filter categories, display options

Shortcode Usage

Every block can also be used as a shortcode for page builders and classic editors.

Basic Shortcode Format

[tourismo-[block-name]]

Example Shortcodes

[tourismo-itineraries]
[tourismo-listings show_title="true" columns="3"]
[tourismo-map zoom="12"]
[tourismo-title text="Welcome to Our Region"]

Getting Shortcodes

See Editor Options for detailed shortcode usage instructions.

Best Practices

Content Organization

  • Use consistent settings across similar blocks
  • Group related content with appropriate blocks
  • Consider user flow when arranging blocks

Performance

  • Limit the number of blocks per page
  • Use appropriate caching settings
  • Optimize images in your Itinerator admin

User Experience

  • Test on mobile devices to ensure responsiveness
  • Use clear titles and descriptions
  • Provide clear calls-to-action with button blocks

Troubleshooting

For detailed troubleshooting information, see the Troubleshooting guide.

Next Steps