=== Homerix ===
Contributors: FARAZFRANK
Tags: one-column, two-columns, right-sidebar, custom-menu, custom-logo, featured-images, threaded-comments, translation-ready, theme-options, block-styles, blog, portfolio, e-commerce
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A modern, fully customizable home repair services WordPress theme with dynamic service management, technician profiles, and advanced booking system.

== License & GPL Compliance ==

Homerix and all related products distributed by WPFrank, including the free theme, the Homerix Pro add-on, and the WPFrank Companion plugin, are 100% GPL compatible.

* Homerix (Free Theme): Licensed under GPL v2 or later
* Homerix Pro (Premium Add-on): Licensed under GPL v2 or later  
* WPFrank Companion Plugin: Licensed under GPL v2 or later

All code, designs, and assets distributed with these products are released under the GNU General Public License v2 or later, ensuring you have the freedom to use, modify, and redistribute them.

License URI: https://www.gnu.org/licenses/gpl-2.0.html

== Description ==

Homerix is a professional WordPress theme designed specifically for home repair businesses, handyman services, plumbing companies, electrical contractors, HVAC specialists, and maintenance companies. Built with modern design principles and powerful customization options, Homerix helps you create a stunning online presence without any coding knowledge.

= Key Features =

**Homepage Sections**
* **Hero Slider** – Full-width hero section with image/video support and customizable call-to-action buttons
* **Services Section** – Showcase your services with icons, descriptions, and links
* **Why Choose Us** – Highlight your unique selling points with customizable feature cards
* **Technicians Section** – Display your team members with photos, specialties, and booking buttons
* **Testimonials Section** – Customer reviews with ratings and locations
* **Blog Section** – Latest posts with customizable display options
* **Call-to-Action Banner** – Conversion-focused section with customizable styling

**Page Templates**
* Homepage (Homerix Home)
* About Us – Company story, timeline, leadership team, and core values
* Services – Complete service listing with details and pricing
* Book Now – Multi-step booking form with service selection
* Find a Technician – Searchable technician directory
* Contact Us – Contact form with customizable fields and reCAPTCHA
* FAQ – Accordion-style frequently asked questions
* Privacy Policy – Pre-styled legal page template
* Terms of Service – Pre-styled legal page template
* Full Width – Blank canvas for custom content

**Booking System**
* Multi-step booking form with intuitive UI
* Service selection with icons and descriptions
* Time slot scheduling with flexible options
* Technician assignment and tracking
* Custom bookings post type with admin management
* Email notifications for customers and administrators
* Professional HTML email templates with template tags

**Email & SMTP**
* Built-in SMTP configuration (Gmail, Yahoo, Outlook, custom)
* Professional HTML email templates
* 16 template tags for dynamic content
* Separate customer and admin email templates
* Email failure warnings with booking reference

**Newsletter System**
* Built-in subscriber management
* Admin dashboard for subscriber list
* CSV export functionality
* Source tracking (footer/sidebar)
* Duplicate prevention
* Third-party shortcode support

**Customizer Options**
* Comprehensive color controls for all sections
* Typography settings (font family, size, weight)
* Header customization (logo, menu, button styles)
* Footer customization (columns, widgets, social icons)
* Section enable/disable toggles
* Live preview for all settings
* Color override system for granular control

**Design Features**
* Fully responsive design
* Mobile-friendly navigation
* Tailwind CSS framework
* Semantic color system
* Custom CSS properties for theming
* Block editor support with custom patterns and styles
* Accessibility-ready focus states

**Widgets**
* Blog Sidebar
* Single Post Sidebar
* 4 Footer Widget Columns
* Footer Bottom Area
* Custom Footer Menu Widget
* Recent Posts Widget

**Developer Features**
* Modular file structure
* Kirki Customizer Framework integration
* Clean, well-documented code
* WordPress coding standards compliant
* Translation-ready with text domain
* Child theme compatible

== Installation ==

1. In your WordPress admin panel, go to **Appearance > Themes** and click **Add New**
2. Click **Upload Theme** and choose the `Homerix.zip` file
3. Click **Install Now** and then **Activate**
4. Go to **Appearance > Customize** to configure theme settings
5. The theme will automatically create default pages and menus on activation

= Quick Setup =

After activation, Homerix creates these pages automatically:
* Homerix Home
* Homerix Services
* Homerix Book Now
* Homerix About
* Homerix Contact
* Homerix Find Technician
* Homerix FAQ
* Homerix Privacy Policy
* Homerix Terms of Service

To set up your homepage:
1. Go to **Settings > Reading**
2. Select "A static page"
3. Set "Homerix Home" as your homepage
4. Set your blog page if desired

== Frequently Asked Questions ==

= How do I customize the theme? =

Go to **Appearance > Customize** to access all theme options. The customizer is organized into panels:
* **Homerix Homepage Sections** – Configure hero, services, technicians, testimonials, etc.
* **Pages Settings** – Customize individual page templates
* **Typography** – Font settings for headings and body text
* **Colors** – Global color scheme and section-specific colors

= How do I set up the booking system? =

1. Go to **Appearance > Customize > Pages > 📅 Book Now Page**
2. Configure services, time slots, and form fields
3. Set up SMTP settings in **📧 Booking Mail Settings** for email notifications
4. Create a Gmail App Password if using Gmail SMTP

= Can I use my own SMTP settings? =

Yes! Homerix includes built-in SMTP configuration. Go to **Appearance > Customize > Pages > 📧 Booking Mail Settings** and enter your SMTP host, port, encryption type, username, and password.

= Is the theme translation-ready? =

Yes, Homerix is fully translation-ready. All text strings use the `Homerix` text domain. You can translate the theme using plugins like Loco Translate or WPML.

= Does the theme work with page builders? =

Homerix is designed to work with the WordPress block editor (Gutenberg). While it may work with some page builders, the custom page templates are optimized for the native block editor.

= How do I manage newsletter subscribers? =

Go to **Dashboard > Homerix Newsletter** to view, manage, and export your newsletter subscribers.

== Screenshots ==

1. Homepage with hero slider and services section
2. Technicians section with team profiles
3. Booking form with multi-step wizard
4. Customizer with live preview
5. Footer with widget areas

== Changelog ==

= 1.0.6 =
* Updated Terms of Service default content to explicitly state 100% GPL compatibility.
* Deleted development files (input.css) and empty build folders.
* Removed destructive menu reset functionality and homerix_reset_footer_menu() helper to prevent data loss.

= 1.0.5 =
* GPL compliance declaration, title overflow handling, inline styling refactoring, companion assets relocation, and PHPCS standards fixes.

= 1.0.4 =
* Major security, prefixing, standards, and asset refactoring fixes for WordPress Theme Review.

= 1.0.0 =
* Initial release
* Customizable homepage sections (Hero, Services, Why Choose Us, Technicians, Testimonials, Blog, CTA)
* Kirki Customizer Framework integration
* Custom page templates (About, Book Now, Contact, FAQ, Find Technician, Services, Privacy, Terms)
* Booking system with custom post type
* Responsive design with Tailwind CSS
* Hero slider with image/video support
* Footer menu management
* Blog sidebar widgets

For full changelog, see CHANGELOG.md file.

== Upgrade Notice ==

= 1.0.6 =
GPL terms of service updates, input.css file cleanup, and removal of menu reset.

= 1.0.5 =
GPL compliance, title overflow fixes, and PHPCS standard audit completions.

= 1.0.4 =
Major security, prefixing, standards, and asset refactoring fixes for WordPress Theme Review.

= 1.0.0 =
Initial release of Homerix theme.

== Resources ==

= Fonts =
* Font Awesome 6 Pro – Icons throughout the theme
  License: Font Awesome Pro License (https://fontawesome.com/license)

= CSS Framework =
* Tailwind CSS v3.4.17 – Utility-first CSS framework
  License: MIT License (https://github.com/tailwindlabs/tailwindcss/blob/master/LICENSE)

= JavaScript Libraries =
* Swiper.js – Hero slider functionality
  License: MIT License (https://github.com/nolimits4web/swiper/blob/master/LICENSE)

= PHP Libraries =
* Kirki Customizer Framework – Enhanced customizer controls
  License: MIT License (https://github.com/kirki-framework/kirki/blob/master/LICENSE)

= Images =
* Demo images are for preview only and not included in the theme package
* Users should replace with their own licensed images.
* about-3.jpg - License: CC0 Public Domain : https://pxhere.com/en/photo/926209
* about-bg.jpg - License: CC0 Public Domain : https://pxhere.com/en/photo/1668668
* about-team-volunteering.jpg License: CC0 Public Domain : https://pxhere.com/en/photo/597224
* contact-bg.jpg License: CC0 Public Domain : https://pxhere.com/en/photo/1071700
* customer-1.jpg Licence: CC0 Public Domain : https://pxhere.com/en/photo/564732
* customer-2.jpg Licence: CC0 Public Domain : https://pxhere.com/en/photo/1695274
* customer-3.jpg Licence: CC0 Public Domain : https://pxhere.com/en/photo/1695274
* hero-bg.jpg Licence: CC0 Public Domain : https://pxhere.com/en/photo/1179393
* services-bg.jpg Licence: CC0 Public Domain : https://pxhere.com/en/photo/913995
* technician-1.jpg Licence: CC0 Public Domain : https://pxhere.com/en/photo/1700686
* technician-3.jpg Licence: CC0 Public Domain : https://pxhere.com/en/photo/705049
* technician-4.jpg Licence: CC0 Public Domain : https://pxhere.com/en/photo/1697572
* Screenshot.png Licence: CC0 Public Domain : https://pxhere.com/en/photo/1691914




== Credits ==

* Developed by [WPFrank](https://wpfrank.com)
* Built with love for the WordPress community

== Support ==

* Documentation: https://wpfrank.com/
* Support Forum: https://wpfrank.com/support
* Feature Requests: https://wpfrank.com/feature-request

== Copyright & Licensing ==

Homerix WordPress Theme, Copyright 2026 WPFrank
Homerix, the Homerix Pro plugin, and the WPFrank Companion plugin are distributed under the terms of the GNU GPL v2 or later.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
