=== OrionX ===
Contributors: troeon
Stable tag: 1.3.1
Theme URI: https://troeon.com/orionx
Requires at least: 5.8
Tested up to: 6.7
Requires PHP: 7.4
Version: 1.3.1
License: GNU General Public License v2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Tags: one-column, two-columns, left-sidebar, right-sidebar, custom-background, custom-colors, custom-header, custom-logo, custom-menu, featured-images, footer-widgets, full-width-template, rtl-language-support, sticky-post, theme-options, threaded-comments, translation-ready, blog, e-commerce

OrionX is a fast, lightweight, and flexible WordPress theme for blogs, businesses, and online stores.

== Description ==

OrionX is a fast, lightweight, and flexible WordPress theme for blogs, businesses, and online stores. It features five layout configurations, sidebar options, Elementor page builder compatibility, WooCommerce support, a comprehensive Customizer with live preview, and six hook positions for injecting custom content.

Advanced functionality — overlays, mega-menu, side panel, WooCommerce template overrides, quick-start templates, and performance tweaks — is available through the free OrionX Core companion plugin.

Key features:

* Five layout configurations: No Sidebar, Right Sidebar, Left Sidebar, Double Sidebar, Opposing Sidebars
* Three header styles: Standard, Centered, Split — with optional sticky header
* Full Elementor page builder compatibility (registers all theme locations)
* WooCommerce support with automatic layout and shop column integration
* Customizer panels for Layout, Header, Colors, Typography, Footer, and Blog Settings
* Six hook positions for injecting Elementor templates at key page positions
* Four footer widget columns plus a Primary Sidebar, Secondary Sidebar, and Header Widget Area
* Full-Width page template
* Block editor (Gutenberg) support with custom editor styles
* RTL language support (rtl.css)
* Translation-ready with .pot file included
* Keyboard-accessible navigation with ARIA labels and skip links
* Mobile-first responsive design

== Installation ==

1. In your admin panel, go to Appearance > Themes and click Add New.
2. Search for "OrionX" and click Install, then Activate.

To install via ZIP:

1. Download the orion.zip file.
2. Go to Appearance > Themes > Add New > Upload Theme.
3. Upload the ZIP, then click Install Now and Activate.

After activation:

1. Go to Appearance > Customize to configure layout, colors, header, and footer.
2. Go to Appearance > Menus to assign menus to the Primary, Secondary, Split Header – Left Menu, Split Header – Right Menu, Footer, and Social locations.
3. Go to Appearance > Widgets to populate the sidebar and footer widget areas.

== Frequently Asked Questions ==

= How do I create a full-width page? =

Edit a page, then in the Page Attributes panel set the Template to "Full Width" and save.

= How do I change the layout? =

Go to Appearance > Customize > Orion Theme Options > Layout. You can set different layouts for the blog/archive, single posts, and static pages.

= How do I set menus for the Split header style? =

Go to Appearance > Menus, create or edit a menu, and assign it to the "Split Header – Left Menu" or "Split Header – Right Menu" location. These locations only appear in the header when the Split style is active in the Customizer.

= How do I enable a double sidebar? =

In the Customizer set the layout to "Double Sidebar", then go to Appearance > Widgets and add widgets to both the Primary Sidebar and Secondary Sidebar.

= Can I use Elementor with this theme? =

Yes. Orion registers all Elementor theme locations. Install Elementor and use the "Elementor Full Width" or "Elementor Canvas" page templates for complete control.

= How do I enable WooCommerce? =

Install and activate the WooCommerce plugin. Orion detects it automatically and applies appropriate wrappers, column counts, and toolbar styles.

= Does Orion support RTL languages? =

Yes. Orion includes a rtl.css file that WordPress automatically loads for right-to-left language sites.

= How do I change the primary color? =

Go to Appearance > Customize > Orion Theme Options > Colors > Primary Accent Color.

= Is the theme translation-ready? =

Yes. All strings use WordPress translation functions. The text domain is "orion". A .pot template file is provided in the /languages/ directory.

= Where is the screenshot? =

You must create your own screenshot.png (880x660px, 4:3 ratio) showing the theme's default appearance before submission to WordPress.org.

== Changelog ==

= 1.3.1 =
* Fix: Elementor editor buttons (structure picker, add-section, circular action handles) no longer turn blue — button styles now scoped to site content areas using body:not(.elementor-edit-mode) selector.
* Fix: Replaced over-aggressive `all: revert` Elementor preview override with surgical property-only reset, preserving Elementor's own circular/colored button styling.
* New: Multi-stage review notice — shown immediately, after 1 day, 14 days, and 1 month with stage-appropriate messaging.
* New: OrionX Core plugin promotion notice — shown when OrionX Core is not installed, with feature pills and Install button.

= 1.3.0 =
* New: Appearance → Layout Builder — create and assign Elementor templates to Header, Footer, Single Post, Archive, Page, Product, Shop, Search, and 404 areas directly from the WordPress admin with a one-click modal workflow.
* New: Appearance → Template Library — import pre-built Elementor page templates from troeon.com with one click (moved from OrionX Core plugin into the theme).
* New: WooCommerce Single Product and Shop/Archive template areas added to the layout assignment system.
* New: Admin notice (Elementor active, no templates set) now links directly to the Layout Builder page.
* Improvement: Elementor Templates section removed from the Customizer (OrionX Theme Options) — all template management is now handled through the dedicated Layout Builder page.
* Fix: Theme version constant in functions.php now correctly matches style.css version.

= 1.2.0 =
* Fix: Removed Theme URI field from style.css to comply with WordPress.org guidelines.
* Fix: Added missing CSS for JS-injected .submenu-toggle buttons — arrows now display as lightweight icon buttons instead of inheriting blue button styles.
* Fix: Mobile sub-menu now opens below the parent item instead of appearing beside it.
* Fix: Long post/page titles no longer cause horizontal overflow (added overflow-wrap and word-break).
* New: Customizer color control for submenu arrow icon color (Header → Submenu Arrow Icon Color).
* Improvement: Screenshot updated to 1200×900 with proper license noted in readme.txt.

= 1.1.8 =
* New: 40+ Google Fonts added to the Typography section (DM Sans, Inter, Montserrat, Poppins, Raleway, Playfair Display, Lora, Bebas Neue, Dancing Script, and many more).
* New: Separate Heading Font Family control — pick a different font for H1–H6 or leave as "Same as Body Font".
* Fix: Body font and heading font selections now actually apply on the front end (CSS variables were never being output before).
* Fix: Base font size setting now applies correctly via CSS variable.
* Improvement: Selected Google Fonts are loaded automatically from the CDN; system fonts require no external requests.
* Improvement: Changing fonts in the Customizer now updates the preview instantly without a reload.

= 1.1.7 =
* Fix: "Maximum Site Width" setting now actually applies — was saving to DB but never outputting a CSS variable.
* New: Separate "Header Inner Width" slider in the Header section to control header width independently of page content width.
* New: "Full Width Header" checkbox to stretch the header logo/nav edge-to-edge with no max-width constraint.
* Improvement: All width controls are now live-preview sliders (no page reload needed).

= 1.1.6 =
* Fix: Site title and tagline no longer appear in Customizer preview when a custom logo is set.
* New: Separate sticky header background and text color controls (visible when Sticky Header is enabled).
* New: Customizer live preview — all color, opacity, and typography controls now update the preview iframe instantly without a page reload.
* Improved: Opacity and size controls upgraded to visual range sliders for a better editing experience.
* Improvement: Footer background and text colors are now fully controlled by CSS variables for consistent live preview.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release. No upgrade steps required.

== Resources ==

All code and assets in this theme are original and licensed under GPL-2.0-or-later.

* OrionX Theme, Copyright (C) 2025 TROEON
  License: GNU General Public License v2 or later
  License URI: https://www.gnu.org/licenses/gpl-2.0.html

* SVG icons in assets/js/orion.js — original, inline, GPL-2.0-or-later

* screenshot.jpg — Original screenshot by theme author, Copyright (C) 2025 TROEON
  License: GNU General Public License v2 or later

* Building photograph used in screenshot.jpg — AI-generated image, no known copyright restrictions
  License: CC0 / Public Domain

No external fonts, images, scripts, or stylesheets are loaded. All assets are bundled in the theme ZIP.
