Abirga — Music Festival WordPress Theme

Abirga WordPress Theme is a bold, energetic Music Festival and Event Promotion WordPress theme built on Bootstrap 5, fully compatible with WordPress 6.x and WooCommerce. It ships with a custom Music Festival page builder via the WordPress Customizer, a custom audio player widget, a filterable festival photo gallery using a custom post type, an album showcase with custom taxonomy, a built-in WooCommerce event ticket shop, and a Particles.js hero — all controlled from the WordPress admin with zero coding required.

Built for WordPress developers, freelancers, and site owners delivering music festival websites, concert promotion platforms, artist portfolio sites, or event e-commerce stores. The theme follows WordPress coding standards throughout: template hierarchy, action and filter hooks, wp_enqueue_scripts for all assets, and a child-theme-ready structure. Every visible element is customisable via the Customizer live preview — no page builder plugin dependency required.

Everything in the Package

• 9 page templates across Home, Albums, Gallery, Blog, Shop (WooCommerce), and Contact
• WordPress 6.x compatible — tested with the latest WordPress core
• WooCommerce integration — event ticket and merchandise shop with cart, checkout, and order management
• Custom Post Types: Albums, Gallery Items — registered via register_post_type() with custom admin columns
• Custom Taxonomies: Album Genre, Gallery Category — registered via register_taxonomy() with filterable archive pages
• Bootstrap 5.0.1 — responsive grid, enqueued via wp_enqueue_style() in functions.php
• Customizer sections: Hero Settings, Festival Colours, Countdown Timer, Social Links, Audio Player, Footer — all with live preview
• Particles.js hero with Customizer-controlled background colour and particle density
• Audio Player widget — register_widget() custom widget for the sidebar or any widgetized area
• Countdown Timer widget — set the next event date from the Customizer; widget displays live timer
• Festival Gallery custom post type with category taxonomy filter on the archive page
• Album CPT with tracklist stored as ACF repeater field — tracklist rendered on the single-album template
• Blog module using standard WordPress posts with custom category and tag archives
• Contact page template with WP Contact Form 7 integration and custom styled form output
• Newsletter opt-in via MailChimp for WordPress plugin integration section
• Swiper carousel for albums and featured content — enqueued conditionally via wp_enqueue_scripts
• Magnific Popup lightbox for gallery images — applied via wp_footer hook
• WOW.js scroll animations enqueued globally
• Retina-ready, fully responsive from 320px to 1920px+
• Child theme ready — all hooks documented for safe overrides
• One-click demo import via WP All Import or Customizer import/export

Theme Structure and WordPress Standards

• Template hierarchy: front-page.php, archive-album.php, single-album.php, archive-gallery.php, page-contact.php, page-gallery.php
• functions.php: add_theme_support(), register_nav_menus(), register_sidebar(), register_post_type(), register_taxonomy(), wp_enqueue_scripts()
• Custom walker class — Walker_Nav_Menu extended for Bootstrap 5 dropdown markup in primary navigation
• Action hooks used: wp_enqueue_scripts, after_setup_theme, widgets_init, init, wp_footer
• Filter hooks used: the_content, excerpt_length, excerpt_more, body_class, post_class
• Template parts: template-parts/header/, template-parts/footer/, template-parts/album/, template-parts/gallery/, template-parts/blog/
• All Customizer settings registered via add_setting(), add_control(), and add_section() with sanitize callbacks
• Escaped output throughout — esc_html(), esc_url(), esc_attr(), wp_kses_post() applied correctly
• Translation-ready — all strings wrapped in __() and _e() with the abirga text domain
• Folder structure: inc/, template-parts/, assets/css/, assets/js/, languages/

All 9 Page Templates

• front-page.php — Customizer-controlled hero, WP_Query festival slider, album spotlight, gallery preview, newsletter, countdown widget
• archive-album.php — Album CPT grid archive with genre taxonomy filter and WP_Query pagination
• single-album.php — Album detail with ACF tracklist repeater, photo gallery, and concert description
• archive-gallery.php — Gallery CPT archive with category taxonomy filter and Magnific Popup lightbox
• index.php / archive.php — Standard WordPress blog archive with category and tag filter
• single.php — Blog post detail with related posts WP_Query by shared category
• woocommerce/cart.php — WooCommerce cart template styled to match the Abirga theme
• woocommerce/checkout/form-checkout.php — WooCommerce checkout template with Bootstrap 5 form layout
• page-contact.php — Custom contact page template with Contact Form 7 shortcode integration

WooCommerce Event Ticket Shop

• Full WooCommerce support declared via add_theme_support('woocommerce') in functions.php
• Overridden WooCommerce templates in woocommerce/ folder — cart, checkout, product archive, product single
• Shop product grid styled with Bootstrap 5 card layout matching the Abirga design system
• Single product template with Swiper gallery for multiple ticket type images
• woocommerce_before_shop_loop and woocommerce_after_shop_loop hooks used for custom promo banners
• Cart widget registered in the primary navigation area for quick cart access
• WooCommerce AJAX add-to-cart enabled — no page reload on ticket purchase

Customizer Controls

• Hero Section — background image upload, headline text, subheading, CTA button label and URL
• Festival Colours — primary accent colour, background colour, and card colour with live preview
• Countdown Timer — next event date picker, event name text
• Audio Player — default track URL, player position (bottom bar or sidebar)
• Social Links — Facebook, Instagram, Twitter, Soundcloud, YouTube URL fields
• Footer — copyright text, footer logo upload, footer column 2 and 3 widget area assignment
• All settings use sanitize_hex_color(), esc_url_raw(), and sanitize_text_field() callbacks

Use Cases

• Music Festival Organisers: Manage lineups, gallery, albums, and ticket shop entirely from the WordPress admin
• Concert Promoters: Customizer-controlled countdown timer and hero — update event details without touching code
• Artists and Bands: Album CPT with ACF tracklist repeater — add releases directly from the WP dashboard
• Event Ticket Sellers: WooCommerce handles ticket inventory, orders, and payment gateways out of the box
• WordPress Developers and Agencies: Child-theme-ready hooks, translation-ready strings, and WooCommerce template overrides — built to extend
• Non-Technical Site Owners: Full Customizer control over design, content, and settings — no coding required after delivery

Credits and Dependencies

• WordPress 6.x — GPLv2 License
• WooCommerce — GPLv3 License
• Bootstrap 5.0.1 — MIT License
• Advanced Custom Fields (ACF) Free — GPLv2 License
• Contact Form 7 — GPLv2 License
• Font Awesome 6 — Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT
• Google Fonts — SIL Open Font License
• Swiper.js — MIT License
• Particles.js — MIT License
• Magnific Popup — MIT License
• WOW.js — MIT License
• Demo images: Unsplash — Unsplash License (free for commercial use, no attribution required)
• Demo images: Freepik — Freepik License (free for commercial use with attribution)
• All demo images are for preview purposes only and are NOT included in the download. Replace with your own licensed images before publishing.

v1.0  Initial WordPress Theme Release
- WordPress 6.x compatible with full WooCommerce event ticket shop integration
- Custom Post Types: Albums (with ACF tracklist repeater), Gallery Items
- Custom Taxonomies: Album Genre, Gallery Category — filterable archive templates
- Bootstrap 5 Walker_Nav_Menu for dropdown navigation
- Full Customizer: hero, colours, countdown timer, audio player, social links, footer
- WooCommerce template overrides in woocommerce/ — cart, checkout, shop, single product
- Audio Player custom widget and Countdown Timer widget registered
- Contact Form 7 integration on page-contact.php template
- Translation-ready — all strings use __ () with abirga text domain
- Child theme ready — all action and filter hooks documented
- Escaped output throughout — esc_html(), esc_url(), wp_kses_post()