# DMOs Block

The DMOs block displays a collection of Destination Marketing Organizations (DMOs) in either a grid or carousel layout. This block is typically used on collection pages to showcase tourism organizations and their information.

## Overview

The DMOs block fetches and displays DMO data from your Tourismo admin platform. It can show DMOs from a specific region when used on region template pages, or display all DMOs when used on other page types. The block automatically filters out the current DMO when used on a DMO template page.

## Block Features & Options

### Display Modes
- **Grid Layout**: Displays DMOs in a responsive grid with configurable columns (1-4)
- **Carousel Layout**: Displays DMOs in a sliding carousel with automatic navigation

### Layout Options
- **Columns**: Choose 1, 2, 3, or 4 columns for grid layout
- **Alignment**: Left, center, or right alignment options
- **Custom CSS Class**: Add custom styling classes

### Content & Display Options
- **Show Image**: Display DMO logo images (enabled by default)
- **Show Name**: Display DMO organization names (enabled by default)
- **Show Description**: Display DMO descriptions (disabled by default)
- **Show Tags**: Display DMO tags/categories (disabled by default)

## How it Works

The DMOs block queries the Tourismo Platform API to fetch DMO data based on the current page context. When used on a region template page, it shows DMOs from that specific region. On other page types, it displays all available DMOs. The block automatically excludes the current DMO when used on a DMO template page to avoid redundancy.

## How to Add & Configure

1. **Add the Block**: In your collection page, add the "DMOs" block from the Itinerator blocks category
2. **Choose Layout**: Select either "Grid" or "Carousel" from the Layout dropdown
3. **Configure Grid Options**: If using grid layout, choose the number of columns (1-4)
4. **Set Display Options**: Toggle which content elements to show (image, name, description, tags)
5. **Customize Styling**: Add custom CSS classes or alignment as needed

## Shortcode Usage

### Basic Shortcode
```
[tourismo-dmos]
```

### Available Options

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `view_type` | string | `grid` | Layout type: `grid` or `carousel` |
| `columns` | string | `3` | Number of columns for grid layout (1-4) |
| `show_image` | boolean | `true` | Display DMO logo images |
| `show_name` | boolean | `true` | Display DMO organization names |
| `show_description` | boolean | `false` | Display DMO descriptions |
| `show_tags` | boolean | `false` | Display DMO tags/categories |
| `align` | string | `''` | Block alignment: `left`, `center`, `right` |
| `class_name` | string | `''` | Custom CSS class name |

### Practical Examples

**Grid layout with 2 columns, showing all content:**
```
[tourismo-dmos view_type="grid" columns="2" show_image="true" show_name="true" show_description="true" show_tags="true"]
```

**Carousel layout with minimal content:**
```
[tourismo-dmos view_type="carousel" show_image="true" show_name="true" show_description="false" show_tags="false"]
```

**Centered grid with custom styling:**
```
[tourismo-dmos view_type="grid" columns="4" align="center" class_name="my-custom-dmos"]
```

## Content Displayed

The DMOs block displays the following content for each DMO:

- **Logo Image**: DMO organization logo (if available and enabled)
- **Organization Name**: DMO name as a clickable link to their website
- **Description**: DMO description text (if available and enabled)
- **Tags**: DMO categories/tags as styled badges (if available and enabled)

The block uses card-based layouts with consistent styling that integrates with your theme's design system. Images are displayed in a contained format to maintain aspect ratios, and missing images show a placeholder message.

## Related Blocks

- **Regions Block**: Display geographic regions that contain DMOs
- **Listings Block**: Show business listings managed by DMOs
- **Events Block**: Display events organized by DMOs
- **Itineraries Block**: Show itineraries created by DMOs