Skip to main content

​
Overview

This guide will walk you through the initial setup and configuration of Zalbi Theme, including creating your first inflatable (hinchable) and event.
Before starting, ensure you’ve completed the installation and have ACF and Polylang plugins activated.

​
Initial Theme Setup

1

Configure Site Identity

Set up your basic site information:
  1. Navigate to Appearance > Customize
  2. Go to Site Identity
  3. Set your Site Title and Tagline
  4. Upload a Site Logo (recommended: 250x250px)
// The theme supports custom logo with these dimensions:
'custom-logo' => array(
    'height'      => 250,
    'width'       => 250,
    'flex-width'  => true,
    'flex-height' => true,
)
2

Set Up Menus

The theme supports two menu locations:
  1. Go to Appearance > Menus
  2. Create a new menu for Primary (main navigation)
  3. Create another menu for Menú Legal Footer (footer legal links)
  4. Assign pages to each menu
  5. Set the menu locations
3

Configure WhatsApp Button

Enable the floating WhatsApp contact button:
  1. In Appearance > Customize
  2. Find Botón WhatsApp section
  3. Enter your phone number with country code (e.g., 34658887358)
  4. Leave empty to hide the button
The WhatsApp button appears as a floating element on the frontend, allowing visitors to contact you directly.
4

Configure Polylang Languages

Set up bilingual content:
  1. Go to Languages settings
  2. Ensure Spanish and Basque are added
  3. For each menu, create language-specific versions
  4. Set language-specific URLs (e.g., /catalogo for Spanish, /katalogoa for Basque)

​
Create Your First Hinchable (Inflatable)

1

Navigate to Hinchables

  1. In WordPress admin, find Hinchables in the sidebar
  2. Click Add New
The custom post type uses the slug catalogo for SEO and multilingual compatibility.
2

Add Basic Information

Fill in the essential details:
  • Title: Name of the inflatable (e.g., “Castillo Medieval”)
  • Content: Detailed description of the inflatable
  • Featured Image: Main product photo (recommended: high-quality image)
  • Excerpt: Short summary for catalog listings
3

Configure Custom Fields (ACF)

Scroll down to find the custom fields:Medidas (Dimensions)
Example: 4m x 3m x 2.5m
Capacidad (Capacity)
Example: 8-10 niños
Etiqueta Color (Category Tag)Select the appropriate category:
  • tag-orange - Atracción deportiva / Kirola
  • tag-pink - Hinchable / Puzgarria
  • tag-blue - Acuático / Uretakoa
  • tag-green - Evento / Ekitaldia
  • tag-purple - Juego / Jokoa
The color tag affects both the visual appearance and category filtering on the catalog page.
4

Assign Taxonomy

  1. On the right sidebar, find Tipos de Hinchable
  2. Check the appropriate category
  3. This enables filtering on the catalog page
// Custom taxonomy registration:
register_taxonomy( 'tipo_hinchable', 'hinchable', array(
    'hierarchical' => true,
    'public'       => true,
    'show_in_rest' => true,
) );
5

Publish and Translate

  1. Click Publish
  2. In the Polylang language box, create translations:
    • Click + next to Euskara to create Basque version
    • Fill in translated content
    • Save both versions

​
Create Your First Event

1

Add New Event

  1. Go to Eventos in the WordPress admin
  2. Click Add New
Events use the slug eventos and are designed for service-based offerings.
2

Enter Event Details

Add the following information:
  • Title: Event name (e.g., “Fiesta de Cumpleaños Completa”)
  • Content: Full event description
  • Featured Image: Event photo or promotional image
3

Configure Event Fields (ACF)

Fill in the event-specific custom fields:Etiqueta Texto (Category Label)
Example: Cumpleaños / Urtebetetzeak
Etiqueta Color (Category Color)
Example: tag-green
Duración (Duration)
Example: 3-4 horas
Público (Target Audience)
Example: Niños de 5-12 años
4

Publish the Event

  1. Click Publish
  2. Create translations in Polylang if needed
  3. View the event on the frontend

​
Create Essential Pages

​
Catalog Page

1

Create Catalog Page

  1. Go to Pages > Add New
  2. Title: “Catálogo” (Spanish) / “Katalogoa” (Basque)
  3. Select template: Plantilla Catalogo
  4. Publish
2

How the Catalog Works

The catalog template automatically:
  • Displays all hinchables
  • Provides category filtering buttons
  • Orders items by custom taxonomy
  • Adapts content based on current language
// Detect language
$es_euskera = (function_exists('pll_current_language') 
    && pll_current_language() == 'eu');

// Get taxonomy terms
$terms = get_terms( array(
    'taxonomy' => 'tipo_hinchable',
    'hide_empty' => true,
) );

​
Events Page

1

Create Events Page

  1. Go to Pages > Add New
  2. Title: “Eventos” (Spanish) / “Ekitaldiak” (Basque)
  3. Content: Brief introduction to your event services
  4. Publish

​
Contact Page

1

Create Contact Page

Create a contact page for inquiry forms:
  1. Pages > Add New
  2. Title: “Contacto” / “Kontaktua”
  3. Add contact form (using Contact Form 7 or similar)
  4. This page is linked from hinchable and event detail pages
After creating custom post types, you must flush permalink rules.
  1. Go to Settings > Permalinks
  2. Ensure Post name structure is selected
  3. Click Save Changes
  4. Verify URLs work correctly:
    • Spanish: /catalogo/hinchable-name
    • Basque: /katalogoa/hinchable-name
    • Events: /eventos/event-name or /ekitaldiak/event-name

​
Testing Your Setup

  1. Navigate to your catalog page
  2. Verify hinchables appear correctly
  3. Test category filtering
  4. Click on a hinchable to view single page
  5. Check custom fields display properly
  6. Verify “Related Products” section shows 3 random items
  1. Visit the events page
  2. Click on an event
  3. Verify event details (duration, audience) display
  4. Test the “Request Quote” button links to contact page
  1. Use Polylang language switcher
  2. Verify content translates correctly
  3. Check that URLs change appropriately
  4. Confirm menus display in correct language
  5. Test UI elements translate (buttons, labels, breadcrumbs)
  1. Visit the site frontend
  2. Look for floating WhatsApp button
  3. Click to verify correct number
  4. Test on mobile devices

​
Understanding the Theme Structure

​
Custom Post Types

The theme registers two custom post types in functions.php:
functions.php:137-150
// Register Hinchables
function zalbi_register_hinchables() {
    $args = array(
        'labels' => array( 
            'name' => 'Hinchables', 
            'singular_name' => 'Hinchable' 
        ),
        'public' => true,
        'has_archive' => false,
        'menu_icon' => 'dashicons-smiley',
        'supports' => array( 'title', 'editor', 'thumbnail', 'excerpt' ),
        'rewrite' => array( 'slug' => 'catalogo' ),
    );
    register_post_type( 'hinchable', $args );
}
add_action( 'init', 'zalbi_register_hinchables' );

​
Template Files

Key templates to know:
  • single-hinchable.php - Individual inflatable display
  • single-evento.php - Individual event display
  • page-catalogo.php - Catalog template with filtering
  • page-eventos.php - Events listing page
  • front-page.php - Homepage template

​
Next Steps

Theme Structure

Learn about the theme’s file organization and template hierarchy

Customization

Explore customization options and theme settings

Custom Post Types

Deep dive into hinchables and eventos functionality

Template Development

Create custom templates and extend theme functionality

Build docs developers (and LLMs) love

Get started for freeTalk to us