# Socials Block

Display social media links for the current record with customizable icon and URL display options.

## Overview

The Socials block shows social media links associated with the current record (listing, event, etc.). It automatically displays all social media links configured in the Tourismo admin platform, with options to show icons, URLs, or both.

**Use this block when you want to:**
- Display social media links for businesses or events
- Show social media icons with clickable links
- Provide visitors with ways to connect on social platforms
- Add social media presence to template pages

## Block Features & Options

### Display Options
- **Show Icon** - Display social media icons (default: enabled)
- **Show URL** - Display the actual social media URLs as text (default: disabled)

### Layout Options
- **Custom CSS Class** - Add custom CSS classes for styling

## How it Works

The Socials block automatically retrieves social media links from the current record's data. It displays each social media platform as a clickable link with an icon (if enabled) and/or the URL text (if enabled). The block uses WordPress dashicons for most social platforms and includes a custom TikTok icon.

## How to Add & Configure

1. **Add the block** to a template page (Region, Itinerary, Listing, Event, etc.)
2. **Configure display options** in the block sidebar:
   - Toggle "Show Icon" to display social media icons
   - Toggle "Show URL" to display the actual URLs as text
3. **Add custom CSS class** if needed for styling
4. **Preview the block** to see how social links appear

## Shortcode Usage

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

### Shortcode Options

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `show_icon` | boolean | `true` | Display social media icons |
| `show_url` | boolean | `false` | Display social media URLs as text |
| `custom_template_name` | string | `""` | Use a custom template file |
| `class_name` | string | `""` | Add custom CSS classes |

### Examples

**Show only icons (default):**
```
[tourismo-socials]
```

**Show only URLs:**
```
[tourismo-socials show_icon="false" show_url="true"]
```

**Show both icons and URLs:**
```
[tourismo-socials show_url="true"]
```

**Add custom styling:**
```
[tourismo-socials class_name="my-social-links"]
```

## Content Displayed

The block displays social media links from the current record, including:

- **Facebook** - Facebook page links
- **Instagram** - Instagram profile links
- **Twitter** - Twitter/X profile links
- **TikTok** - TikTok profile links (with custom icon)
- **Other platforms** - Any additional social media platforms configured

Each social link appears as:
- A clickable icon (if `show_icon` is enabled)
- The URL text (if `show_url` is enabled)
- Opens in a new tab when clicked

## Related Blocks

- **[Listing Info](listing-info.md)** - Shows comprehensive business information including social links
- **[Content](content.md)** - Display rich content areas
- **[Description](description.md)** - Show description text