=== Elementic ===

Contributors: harsh175, hardik2221
Tags: blog, news, e-commerce, one-column, two-columns, left-sidebar, right-sidebar, custom-background, custom-colors, custom-header, custom-logo, custom-menu, featured-images, flexible-header, footer-widgets, full-width-template, sticky-post, theme-options, threaded-comments, translation-ready, block-styles, wide-blocks, rtl-language-support, accessibility-ready, mega-menu, ajax-search, social-sharing, author-bio
Requires at least: 6.0
Requires PHP: 7.4
Tested up to: 6.9.1
Stable tag: 1.1.0
License: GNU General Public License v2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Elementic is a lightweight, multi-purpose WordPress theme that combines powerful customization capabilities with excellent performance.

== Description ==

Elementic is a modern, lightweight, and highly customizable WordPress theme designed for blogs, businesses, portfolios, and news websites. Features include advanced customizer options, multiple layouts, full Gutenberg support, WooCommerce compatibility, accessibility-ready design, mega menu, off-canvas mobile menu, ajax live search, reading time, post views counter, social sharing, related posts, author bio, and table of contents.

= Features =

* Responsive Design - Mobile-first approach ensures your site looks great on all devices
* Custom Colors - Choose your own color scheme with the customizer
* Multiple Layouts - Right sidebar, left sidebar, or no sidebar options
* Custom Header - Add your own header image
* Custom Logo - Upload your brand logo
* Gutenberg Ready - Full support for the block editor with custom block styles
* WooCommerce Support - Build an online store with full WooCommerce integration
* Translation Ready - Easily translate into any language
* RTL Support - Full right-to-left language support
* Accessibility Ready - WCAG 2.1 compliant for better accessibility
* SEO Optimized - Clean, semantic HTML5 markup
* Fast Loading - Optimized for Core Web Vitals
* Widget Areas - Multiple widget areas including sidebar and footer
* Custom Widgets - Recent posts with thumbnails and social links widgets
* Post Formats - Support for all standard post formats
* Sticky Header - Optional sticky header functionality
* Breadcrumb Support - Easy navigation for your users
* Footer Widgets - Up to 4 footer widget columns

= Advanced Features (New in 1.1.0) =

* Mega Menu Support - Create multi-column dropdown menus with custom layouts
* Off-Canvas Mobile Menu - Slide-in mobile navigation with widget area and social links
* Ajax Live Search - Real-time search results as users type (minimum 3 characters)
* Reading Time Display - Estimated reading time for posts (customizable position)
* Post Views Counter - Track and display post views with admin column sorting
* Social Sharing Buttons - Share posts on Facebook, Twitter, LinkedIn, Pinterest, WhatsApp, Telegram, Reddit, and Email
* Related Posts - Display related content by tags/categories with customizable layout
* Author Bio Box - Author information with avatar, social links, and post count
* Table of Contents - Auto-generated navigation from post headings with smooth scrolling

= Customization Options =

* Layout Settings - Choose sidebar position and container width
* Blog Settings - Control excerpt length and post meta display
* Color Settings - Customize primary and secondary colors
* Typography Settings - Choose from hundreds of Google Fonts
* Footer Settings - Add custom copyright text

= Recommended Plugins =

* Contact Form 7 - For contact forms
* Yoast SEO - For better SEO optimization
* WooCommerce - For e-commerce functionality

== Installation ==

1. In your admin panel, go to Appearance > Themes and click the Add New button.
2. Click Upload Theme and Choose File, then select the theme's .zip file. Click Install Now.
3. Click Activate to use your new theme right away.

== Frequently Asked Questions ==

= Does this theme support any plugins? =

Elementic includes support for WooCommerce, Contact Form 7, and all major page builders including Elementor, Beaver Builder, and more.

= How do I customize the colors? =

Go to Appearance > Customize > Color Settings to change the primary and secondary colors of your theme.

= Can I change the layout? =

Yes! Go to Appearance > Customize > Layout Settings to choose between right sidebar, left sidebar, or no sidebar layouts.

= Is this theme translation ready? =

Yes, Elementic is translation ready and includes a .pot file for easy translation.

= Does this theme support RTL languages? =

Yes, Elementic has full RTL (right-to-left) language support.

== Changelog ==

= 1.1.0 - February 12, 2026 =
* Added: Mega Menu Support with multi-column layouts
* Added: Off-Canvas Mobile Menu with slide-in animation
* Added: Ajax Live Search with real-time results
* Added: Reading Time Display for posts
* Added: Post Views Counter with tracking and display
* Added: Social Sharing Buttons for 8 networks
* Added: Related Posts by tags and categories
* Added: Author Bio Box with social links
* Added: Table of Contents with auto-generation
* Added: New customizer sections for all advanced features
* Added: 9 new CSS files for feature styling
* Added: 5 new JavaScript files for interactive features
* Improved: Template integration for reading time and post views
* Improved: Content display order (Author Bio → Social Sharing → Related Posts)
* Improved: Mega menu walker with safety checks
* Improved: Live search respects customizer post type settings
* Fixed: Function naming consistency across features
* Enhanced: Accessibility with ARIA attributes throughout
* Enhanced: Security with nonce verification on all AJAX handlers
* Enhanced: Performance with conditional loading of assets

= 1.0.0 - 2025 =
* Initial release

== License ==

Elementic WordPress Theme, Copyright 2025
Elementic is distributed under the terms of the GNU GPL

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.

== Third-Party Assets ==

The Elementic theme bundles the following third-party assets. License details are included in the theme `assets/` folder where applicable.

* Font Awesome Free 7.1.0
  - Source: https://fontawesome.com
  - Copyright: Fonticons, Inc. (https://fontawesome.com)
  - License: Font Awesome Free License
    * Icons: CC BY 4.0 License (https://creativecommons.org/licenses/by/4.0/)
    * Fonts: SIL OFL 1.1 License (http://scripts.sil.org/OFL)
    * Code: MIT License (https://opensource.org/licenses/MIT)
  - License URI: https://fontawesome.com/license/free
  - Location: assets/fonts/fontawesome/
  - Full license text: assets/fonts/fontawesome/LICENSE.txt
  - Note: Font Awesome Free is free, open source, and GPL friendly. You can use it for commercial projects, open source projects, or really almost whatever you want.

* Underscores (navigation.js, skip-link-focus-fix.js)
  - Source: https://underscores.me/
  - Copyright: 2012-2022 Automattic, Inc.
  - License: GPLv2 or later
  - License URI: https://www.gnu.org/licenses/gpl-2.0.html
  - Location: assets/js/navigation.js, assets/js/skip-link-focus-fix.js

* Default Page Banner (default-page-banner.svg)
  - Source: Created by elementic theme author
  - License: GPLv2 or later
  - License URI: https://www.gnu.org/licenses/gpl-2.0.html
  - Location: assets/images/default-page-banner.svg

== Screenshot Images ==

All images used in the screenshot are from Pexels and licensed under Creative Commons Zero (CC0) license:

* Screenshot Image 1
  - Source: https://www.pexels.com/
  - License: CC0 (Creative Commons Zero)
  - License URI: https://www.pexels.com/license/

* Screenshot Image 2
  - Source: https://www.pexels.com/
  - License: CC0 (Creative Commons Zero)
  - License URI: https://www.pexels.com/license/

* Screenshot Image 3
  - Source: https://www.pexels.com/
  - License: CC0 (Creative Commons Zero)
  - License URI: https://www.pexels.com/license/

Note: All images shown in the screenshot are for demonstration purposes only and are not included in the theme package. The CC0 license allows free use for any purpose without attribution, but we provide this information for transparency.

If you add any other third-party libraries or fonts to the theme in future, please include their license text and attribution here (and place the license file under `assets/` or `assets/<library>/LICENSE.txt`).
