Soapia — Charity WordPress Theme

Soapia WordPress Theme is a feature-rich Beauty & Personal Care E-Commerce HTML5 WordPress theme built on Bootstrap 5, fully compatible with WordPress 6.x with full WooCommerce integration. It ships with 23 page templates, a filterable photo gallery, a full e-commerce module with cart and checkout, a countdown timer — all controlled from the WordPress admin and Customizer with zero coding required.

Built for WordPress developers, freelancers, and site owners delivering beauty & personal care e-commerce html5 websites. 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

• 23 page templates following the WordPress template hierarchy
• WordPress 6.x compatible — tested with the latest WordPress core
• WooCommerce integration — shop, cart, checkout, and order management with overridden WC templates
• Custom Post Types registered via register_post_type() with custom admin columns
• Custom Taxonomies registered via register_taxonomy() with filterable archive templates
• Bootstrap 5 — responsive grid, enqueued via wp_enqueue_style() in functions.php
• WordPress Customizer sections with live preview — colours, hero, social links, and footer settings
• Custom Walker_Nav_Menu for Bootstrap 5 dropdown markup in primary navigation
• Widget areas registered via register_sidebar() — sidebar, footer columns, and feature-specific zones
• Contact Form 7 integration on the contact page template
• Translation-ready — all strings wrapped in __() and _e() with the theme text domain
• Child theme ready — all action and filter hooks documented for safe overrides
• Retina-ready, fully responsive from 320px to 1920px+
• Escaped output throughout — esc_html(), esc_url(), esc_attr(), wp_kses_post() applied correctly

Theme Structure and WordPress Standards

• Template hierarchy: front-page.php, archive.php, single.php, page.php, and custom page templates
• functions.php: add_theme_support(), register_nav_menus(), register_sidebar(), register_post_type(), wp_enqueue_scripts()
• Action hooks: wp_enqueue_scripts, after_setup_theme, widgets_init, init, wp_footer
• Filter hooks: the_content, excerpt_length, excerpt_more, body_class, post_class
• Template parts in template-parts/ — header, footer, content cards, and section partials
• All Customizer settings use sanitize_hex_color(), esc_url_raw(), and sanitize_text_field() callbacks
• Folder structure: inc/, template-parts/, assets/css/, assets/js/, languages/

All 23 Page Templates

• page-home-v1.php / home-v1.php — v5 — Five distinct hero and beauty showcase layouts
• page-about.php / about.php — Brand story and beauty philosophy
• page-shop-left.php / shop-left.php — Shop with left sidebar filter
• page-shop-right.php / shop-right.php — Shop with right sidebar filter
• page-shop-details.php / shop-details.php — Individual product page
• page-checkout.php / checkout.php — Purchase completion page
• page-contact.php / contact.php — Contact form and order enquiry

Key Features

• 23 Fully Designed HTML5 Pages across home, shop, product, checkout, and contact
• 5 Unique Home Layouts — distinct hero styles and beauty showcase arrangements
• Bootstrap — responsive, mobile-first grid system
• Shop with Sidebar Variants — left sidebar and right sidebar shop filter layouts
• Product Detail Pages — individual beauty product page with gallery
• Checkout — purchase completion page
• ionRangeSlider — price range filtering for product browsing
• Swiper Carousel — featured product and beauty collection sliders
• Countdown Timer — animated sale and promotion countdowns
• Magnific Popup Lightbox — full-screen product and beauty image popup
• Flaticon Icon Set — comprehensive icon library for beauty retail UI
• Well Documented — step-by-step documentation for easy setup & customisation

Customizer Controls

• Hero Section — background image upload, headline text, subheading, and CTA button settings
• Colour Settings — primary accent colour, background colour, and card colour with live preview
• Social Links — all major social platform URL fields with live header/footer update
• Footer — copyright text, footer logo upload, and footer widget area configuration
• Typography — Google Fonts selector for heading and body font pairing
• All settings use proper sanitize callbacks — no unsanitised values stored in wp_options

Use Cases

• Beauty & Personal Care E-Commerce HTML5 Site Owners: Manage all content from the WordPress admin — no coding required after installation
• WordPress Developers: Child-theme-ready hooks, WooCommerce support, and translation-ready strings — built to extend
• Freelancers and Agencies: Deliver a beauty & personal care e-commerce html5 WordPress site to clients with Customizer control over all design settings
• Non-Technical Clients: Full Customizer live preview, widget areas, and Custom Post Types — empowers clients to self-manage

Credits and Dependencies

• WordPress 6.x — GPLv2 License
• WooCommerce — GPLv3 License
• Bootstrap 5 — MIT License
• Advanced Custom Fields (ACF) Free — GPLv2 License
• Contact Form 7 — GPLv2 License
• Swiper — MIT License
• Countdown — MIT License
• Magnific — MIT License
• Lightbox — MIT License
• ionRange — MIT License
• Font Awesome 6 — Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT
• Google Fonts — SIL Open Font 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.

v1.0  Initial WordPress Theme Release
- WordPress 6.x compatible with Bootstrap 5 and Walker_Nav_Menu
- 23 page templates following the WordPress template hierarchy
- Custom Post Types and Custom Taxonomies with archive templates
- Full WordPress Customizer integration with live preview
- WooCommerce template overrides — shop, cart, checkout, single product
- Contact Form 7 integration on contact page template
- Translation-ready — all strings use __() with theme text domain
- Child theme ready — all hooks documented
- Escaped output throughout — esc_html(), esc_url(), wp_kses_post()