Skip to main content

​
Requirements

Ensure your environment meets these requirements before installing Zalbi Theme.

​
WordPress Environment

  • WordPress 5.4 or higher
  • PHP 5.6 or higher
  • MySQL 5.6+ or MariaDB 10.0+

​
Development Dependencies

For theme development and customization:
  • Node.js (for asset compilation)
  • Composer (for PHP dependency management)
  • npm or yarn (package manager)

​
Required Plugins

The theme requires these plugins for full functionality:
  • Advanced Custom Fields (ACF) - For custom product/event fields
  • Polylang - For multilingual support (Spanish/Basque)

​
Installation Steps

1

Download the Theme

Clone the repository from GitHub or download the theme files:
git clone https://github.com/Garridoparrayeray/zalbi-theme.git
Alternatively, download the ZIP file from the GitHub repository.
2

Upload to WordPress

There are two ways to upload the theme:Option A: Via WordPress Admin
  1. Navigate to Appearance > Themes in your WordPress dashboard
  2. Click Add New → Upload Theme
  3. Choose the theme ZIP file
  4. Click Install Now
Option B: Via FTP/File Manager
  1. Upload the zalbi-theme folder to /wp-content/themes/
  2. Ensure proper file permissions (typically 755 for folders, 644 for files)
3

Install PHP Dependencies

Navigate to the theme directory and install Composer dependencies:
cd wp-content/themes/zalbi-theme
composer install
This installs development tools like PHP CodeSniffer for code quality checks.
4

Install Node.js Dependencies

Install npm packages for asset compilation:
npm install
The theme uses Node.js for compiling SASS to CSS and other build processes.
5

Compile Assets (Development)

Compile the theme’s stylesheets:
npm run compile:css
For RTL (right-to-left) language support:
npm run compile:rtl
  • npm run compile:css - Compiles SASS files to CSS
  • npm run compile:rtl - Generates RTL stylesheet
  • npm run watch - Watches SASS files and recompiles on changes
  • npm run lint:scss - Checks SASS files against CSS coding standards
  • npm run lint:js - Checks JavaScript files against coding standards
  • npm run bundle - Creates a distribution ZIP file
6

Activate the Theme

  1. Go to Appearance > Themes in WordPress admin
  2. Find zalbi-theme
  3. Click Activate
Before activating, ensure Advanced Custom Fields and Polylang plugins are installed and activated.

​
Install Required Plugins

​
Advanced Custom Fields (ACF)

1

Install ACF

  1. Go to Plugins > Add New
  2. Search for “Advanced Custom Fields”
  3. Install and activate the plugin
2

Configure Custom Fields

The theme expects the following ACF field groups:For Hinchables (Inflatables):
  • medidas (text) - Dimensions
  • capacidad (text) - Capacity
  • etiqueta_color (select) - Category color tag
For Eventos (Events):
  • etiqueta_texto (text) - Category label
  • etiqueta_color (select) - Category color tag
  • duracion (text) - Duration
  • publico (text) - Target audience
You’ll need to create these field groups manually in ACF or import them if a configuration file is provided.

​
Polylang

1

Install Polylang

  1. Go to Plugins > Add New
  2. Search for “Polylang”
  3. Install and activate the plugin
2

Configure Languages

  1. Navigate to Languages in the WordPress admin
  2. Add Spanish (Español) and Basque (Euskara)
  3. Set your default language
  4. Configure URL modifications (subdirectories recommended)
3

Translate Strings

The theme includes language detection for UI elements. Polylang will automatically:
  • Create language-specific versions of posts and pages
  • Manage menu translations
  • Handle URL structure per language

​
Verification

After installation, verify everything is working:
  • Theme is activated in Appearance > Themes
  • Custom post types appear: Hinchables and Eventos
  • ACF fields are available when editing posts
  • Polylang language switcher is visible
  • No PHP errors in debug log
  • Stylesheet loads correctly on frontend

​
Troubleshooting

  1. Go to Settings > Permalinks
  2. Click Save Changes (this flushes rewrite rules)
  3. Refresh your admin panel
  • Ensure ACF plugin is activated
  • Check that field groups are assigned to the correct post types
  • Verify field group location rules
  • Run npm run compile:css to compile SASS
  • Clear browser cache
  • Check file permissions on style.css
  • Ensure you have the correct versions of Node.js and Composer
  • Delete node_modules and vendor folders, then reinstall
  • Check for permission issues in the theme directory

​
Next Steps

Quick Start Guide

Learn how to configure the theme and create your first hinchable or event

Build docs developers (and LLMs) love

Get started for freeTalk to us