=== Schema Star ===
Contributors: wpstarplugins
Tags: schema, seo, structured-data, woocommerce, rich-snippets
Requires at least: 5.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 10.8.100
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

The Ultimate Schema.org & SEO Plugin for WordPress & WooCommerce - Boost your search rankings with powerful structured data.

== Description ==

**Schema Star** is a comprehensive WordPress plugin that adds Schema.org structured data markup to your website, helping you achieve rich snippets in Google search results and dramatically improve your SEO performance.

This is the **demo/free version**. Some advanced features (e.g. Product Reviews management page, Product Group settings page) are available in the Pro version. For step-by-step configuration and usage from a fresh install, see **Configuration Steps** and **How to configure and use** below.

= Key Features =

* **Product Schema** - Complete WooCommerce product markup with prices, availability, reviews, ratings, and merchant information
* **Organization Schema** - Company information with logo, contact details, social profiles, and business hours
* **Local Business Schema** - 30+ business types (Store, Restaurant, Hotel, Medical, Legal, etc.) with address, hours, and geo coordinates
* **FAQ Schema** - Rich FAQ snippets for posts, pages, and custom post types that appear in Google search results
* **BreadcrumbList Schema** - Navigation breadcrumbs for better site structure and user experience
* **SearchAction Schema** - Enable Google sitelinks searchbox in search results
* **SiteNavigationElement** - Structured data for main navigation menus
* **Custom Schema Builder** - Create 20+ different schema types (Article, Book, Course, Event, JobPosting, Recipe, Video, etc.) with visual builder
* **Multi-Currency Support** - Multiple currencies with exchange rates and country mapping
* **Auto ALT Tags** - Automatic image ALT text generation for better SEO
* **Shipping Details** - Delivery time and shipping costs in schema
* **Return Policy** - Merchant return policy schema with country-specific policies

= LMS Integrations (Course Schema) =

Schema Star adds Course and ItemList schema for:
* **Tutor LMS** - Course schema on single courses; ItemList on course-category and archive
* **LearnDash** - Course schema on sfwd-courses; ItemList on ld_course_category and archive
* **LearnPress** - Course schema on lp_course; ItemList on course_category and archive
* **Masteriyo** - Course schema on mto-course; ItemList on course_cat and archive

Each has a settings page under Schema Star (when the LMS is active): Enable Course Schema, Category & Archive Schema, Provider, Price.

= WooCommerce Integration =

Schema Star deeply integrates with WooCommerce:
* Automatic extraction of product data (name, price, SKU, images, stock status)
* Review synchronization with WooCommerce reviews
* Product variations support
* Category schema markup
* Advanced product settings (warranty, shipping, return policy)

= Performance & Security =

* **Performance Optimized** - Conditional loading, no frontend queries, minified assets
* **Secure** - ABSPATH checks, nonce verification, input sanitization, output escaping
* **HPOS Compatible** - Works with WooCommerce's High-Performance Order Storage
* **Translation Ready** - Full i18n support with .po/.mo files (Text Domain: schema-star)

= Perfect For =

* E-commerce stores (WooCommerce)
* Local businesses
* Content websites and blogs
* News and media sites
* Educational platforms
* Service providers
* Real estate websites
* Restaurant and hospitality businesses

== Source code for minified/compiled assets ==

This plugin includes minified JavaScript for compatibility and size. Human-readable source is available as follows:

* **admin/assets/js/crypto-js.min.js** – Minified build of the CryptoJS library, used for hashing/encoding in the admin. The full source code is available at: [CryptoJS on GitHub](https://github.com/brix/crypto-js). The plugin uses a local copy (no remote CDN). No build tools are required to review the plugin; the minified file is included for distribution.

== External services ==

This plugin uses the following third-party/external services:

* **WhatsApp (Meta)** – The plugin displays a "Need Help?" / "Chat on WhatsApp" button on Schema Star admin pages. When the user clicks it, their browser opens WhatsApp Web (web.whatsapp.com) or the wa.me link so they can contact the plugin author for support. **No data is sent automatically by the plugin.** The user chooses to open the link; no personal data or site data is transmitted to WhatsApp by the plugin. This is used only for optional customer support contact.
* **Service provider:** WhatsApp / Meta Platforms, Inc.
* **Terms of Service:** [WhatsApp Terms of Service](https://www.whatsapp.com/legal/terms-of-service)
* **Privacy Policy:** [WhatsApp Privacy Policy](https://www.whatsapp.com/legal/privacy-policy)

== Installation ==

= Automatic Installation =

1. Log in to your WordPress admin panel
2. Navigate to **Plugins → Add New**
3. Search for "Schema Star"
4. Click **Install Now**
5. Click **Activate Plugin**
6. Go to **Schema Star** in the admin menu to configure

= Manual Installation =

1. Download the plugin ZIP file
2. Extract the ZIP file on your computer
3. Upload the `Schema-Star` folder to `/wp-content/plugins/` directory
4. Activate the plugin through the **Plugins** menu in WordPress
5. Navigate to **Schema Star** in the admin menu to configure

= Configuration Steps =

1. **Dashboard** - Overview of all features and quick access
2. **Options** - Enable Product Schema and configure main settings
3. **Organization Markup** - Add your company information, logo, and contact details
4. **Local Business Markup** - Configure local business information (if applicable)
5. **WooCommerce (Category tab)** - Set up return policy, warranty, and shipping details for product schema
6. **FAQ Schema** - Enable FAQ for specific post types
7. **Custom Schema** - Create custom schemas for specific content

= How to configure and use (from a fresh install) =

* **Organization / Local Business:** Go to **Schema Star → Organization Markup** (or **Local Business Markup**). Fill in business name, URL, logo URL, and save. The schema is output automatically on the front-end.
* **Product Schema (WooCommerce):** Install and activate WooCommerce, then go to **Schema Star → Options** and enable "Product Schema". Product pages will then output Product schema with price, availability, and reviews.
* **FAQ Schema:** Go to **Schema Star → FAQ Schema**. Enable FAQ for "Post" and/or "Page". Edit any post or page and use the "FAQ" metabox to add questions and answers, then save. The FAQ schema appears on the front-end for that content. For categories: enable a taxonomy (e.g. Category), then edit a category under **Posts → Categories**; the FAQ field appears there—add Q&As and save.
* **Breadcrumbs:** In **Schema Star → Options**, enable BreadcrumbList if desired. Breadcrumb schema is output on the front-end automatically.
* **Verification:** View page source on the front-end and look for `<script type="application/ld+json">` blocks, or use [Google Rich Results Test](https://search.google.com/test/rich-results) with your page URL.

== Frequently Asked Questions ==

= Is WooCommerce required? =

No, WooCommerce is optional. Without WooCommerce, product-related features will be disabled, but all other schema features (Organization, Local Business, FAQ, Breadcrumbs, Custom Schema) work normally.

= How do I verify my schema is working? =

Use these free tools:
* [Google Rich Results Test](https://search.google.com/test/rich-results)
* [Schema.org Validator](https://validator.schema.org/)
* Google Search Console → Enhancements report

= Will this plugin slow down my website? =

No, Schema Star is performance-optimized:
* Schema is generated efficiently without additional frontend database queries
* Scripts and styles only load when needed
* Conditional loading based on page type
* Compatible with all major caching plugins

= Is it compatible with caching plugins? =

Yes, fully compatible with:
* WP Super Cache
* W3 Total Cache
* WP Rocket
* LiteSpeed Cache
* Cloudflare
* And other caching solutions

= Does it work with page builders? =

Yes, works seamlessly with:
* Elementor
* WPBakery Page Builder
* Divi Builder
* Beaver Builder
* Oxygen Builder
* Gutenberg blocks
* And other page builders

= Will it conflict with other SEO plugins? =

Schema Star works alongside:
* Yoast SEO
* Rank Math
* All in One SEO
* SEOPress

**Important:** Disable overlapping schema features in other SEO plugins to avoid duplicate schema markup.

= Is it translation-ready? =

Yes, fully translation-ready:
* Text Domain: `schema-star`
* Included .po/.mo files
* Translation-ready ( .pot / .po files included )
* Currently includes Turkish translation

= What schema types are supported? =

* Product (WooCommerce)
* Organization
* LocalBusiness (30+ types)
* FAQPage
* BreadcrumbList
* SearchAction
* SiteNavigationElement
* Custom Schema Builder: Article, Book, Course, Event, JobPosting, Person, Recipe, Service, SoftwareApplication, VideoObject, HowTo, Review, Vehicle, Podcast, Movie, ImageLicense, and more

= How do I add FAQ to my posts? =

1. Go to **Schema Star → FAQ Settings** and enable FAQ for your post types
2. Edit any post/page
3. Scroll down to the **FAQ Schema** metabox
4. Click **Add New Question**
5. Enter question and answer
6. Publish the post

FAQ will automatically appear on the frontend and in Google search results.

= Can I customize the FAQ display? =

Yes, go to **Schema Star → FAQ Settings**:
* Change section title
* Customize colors and styling
* Adjust layout and design
* Modify button text and labels

= How do I add custom schemas? =

1. Go to **Schema Star → Custom Schema**
2. Click **Add New Schema**
3. Select schema type (Article, Event, Recipe, etc.)
4. Choose target pages/posts
5. Fill in schema fields (with auto-fill from WordPress data)
6. Save and publish

= Does it support multiple currencies? =

Yes, full multi-currency support:
* Set base currency
* Add additional currencies with exchange rates
* Map currencies to specific countries
* Automatic currency conversion in schema

= Is there a Pro version? =

Yes, the Pro version includes:
* All free features
* Custom Schema Builder (unlimited schemas)
* Product Group Schema
* Advanced FAQ customization
* Priority support
* Regular updates

Visit [wpstarplugins.com](https://wpstarplugins.com) for Pro version details.

== Screenshots ==

1. Dashboard - Overview of all features and quick access
2. Options Page - Main plugin settings and configuration
3. Organization Markup - Company information setup
4. Local Business Markup - Local business configuration
5. FAQ Schema - FAQ settings and customization
6. Custom Schema Builder - Visual schema creation
7. Google Rich Results - Example of schema in search results

== Changelog ==

= 10.8.100 =
* Version bump 10.8.100

= 10.8.99 =
* Security and i18n: escaping, nonces, sanitization. Parse fix in admin index (wp_localize_script).

= 10.8.98 =
* Version bump 10.8.98

= 10.8.90 =
* Version bump 10.8.90

= 10.8.89 =
* Version bump 10.8.89

= 10.8.88 =
* Documentation: Full LMS & integration support in changelog, documentation.html, README, readme
* Help: New tabs per integration (WooCommerce, Tutor, LearnDash, LearnPress, Masteriyo) with detailed schema support
* documentation.html: LMS Integrations section; changelog updated
* README/readme: LMS features, FAQ, requirements

= 10.8.40 =
* Fixed register_setting() sanitization callbacks
* Removed Update URI header
* Rely on core for translation loading
* Updated Tested up to: 6.9

= 10.8.39 =
* Fixed fatal error with is_product() when WooCommerce is inactive
* Added WhatsApp support button for customer assistance
* Enhanced Help & Documentation page with comprehensive guides
* Improved Product Group Settings demo page
* Updated all function_exists checks for WooCommerce functions

= 10.8.38 =
* Added comprehensive Help & Documentation page with tabbed interface
* Enhanced Custom Schema Builder documentation
* Improved Product Group Settings explanations
* Added detailed feature explanations for all plugin pages

= 10.8.37 =
* Implemented freemium model for Product Group Settings
* Added locked demo pages for premium features
* Enhanced upgrade call-to-action buttons
* Improved user experience for free version

= 10.8.36 =
* Implemented freemium model for product page metaboxes
* Changed "Far Schema" metabox title to "Schema Star"
* Added locked demo for Schema Star metabox on product pages
* Added locked demo for FAQ metabox on product pages
* Enhanced upgrade messaging and design

= 10.8.35 =
* Fixed PHP parse errors in STAR-functions.php
* Improved FAQ schema page functionality
* Enhanced image display in FAQ demo pages
* Added function_exists checks for WooCommerce functions

= 10.8.34 =
* Implemented freemium model for FAQ Schema and FAQ Settings pages
* Added locked demo pages with benefits and upgrade CTAs
* Enhanced FAQ example images display
* Improved user experience for free version

= 10.8.33 =
* Implemented freemium model for Product Reviews page
* Added locked demo page with benefits and example image
* Enhanced upgrade call-to-action design
* Improved user messaging

= 10.8.32 =
* Added custom CSS to hide other plugin notifications on Schema Star pages
* Enhanced Dashboard page with organization information
* Improved plugin description and website links
* Updated all Help links to point to wpstarplugins.com

= 10.8.31 =
* Updated plugin metadata to wpstarplugins.com
* Changed Text Domain from STAR-lang to schema-star
* Updated all language file names to match new text domain
* Fixed all escaping and sanitization issues
* Added comprehensive security checks (ABSPATH, nonce, escaping, sanitization)
* Improved performance with conditional schema output
* Enhanced WooCommerce compatibility with function_exists checks

= 10.8.30 =
* Added multi-currency support with exchange rates
* Added currency-to-country mapping
* Improved return policy schema with country-specific policies
* Added new social media profile support
* Enhanced product schema with additional fields

= 10.7.x =
* Added Custom Schema Builder with 20+ schema types
* Added SiteNavigationElement schema
* Added SearchAction schema for Google sitelinks searchbox
* Improved visual schema builder interface
* Enhanced dynamic field auto-fill functionality

= 10.6.x =
* Added BreadcrumbList schema
* Added Category/Collection schema for product categories
* Improved product schema with more merchant data
* Enhanced WooCommerce integration

= 10.5.x =
* Added FAQ Schema support
* Added role-based access control
* Modern dashboard design
* Improved admin interface

[View full changelog](changelog.txt)

== Upgrade Notice ==

= 10.8.39 =
Important security and compatibility update. Fixes fatal error when WooCommerce is inactive. Recommended for all users.

= 10.8.38 =
New comprehensive Help & Documentation page added. All users should update for better documentation access.

= 10.8.37 =
Freemium model implementation. Free version users will see locked demo pages for premium features.

= 10.8.36 =
Product page metaboxes now show locked demos in free version. Update recommended for all users.

== Additional Information ==

= Plugin Website =
Visit [wpstarplugins.com](https://wpstarplugins.com) for:
* Full documentation
* Video tutorials
* Support tickets
* Pro version information
* Latest updates

= Support =
* **Website:** [wpstarplugins.com](https://wpstarplugins.com)
* **Documentation:** Available in plugin admin under Help & Documentation
* **WhatsApp Support:** Available in plugin admin pages (bottom right)
* **Email:** Contact through website

= Requirements =
* WordPress 5.0 or higher
* PHP 7.4 or higher
* WooCommerce 2.6+ (optional, for product features)

= Compatibility =
* **WordPress:** 5.0 - 6.5+
* **WooCommerce:** 2.6 - 8.5+
* **PHP:** 7.4 - 8.3+
* **Themes:** All WordPress themes
* **Page Builders:** Elementor, WPBakery, Divi, Beaver Builder, Oxygen, Gutenberg
* **Caching:** WP Rocket, W3 Total Cache, WP Super Cache, LiteSpeed Cache, Cloudflare
* **SEO Plugins:** Yoast SEO, Rank Math, All in One SEO, SEOPress

= Performance Tips =
1. Enable only the schema types you need
2. Use a caching plugin for better performance
3. Keep WordPress and plugins updated
4. Use a CDN for faster asset delivery
5. Optimize images before uploading

= Security Features =
* ABSPATH checks in all files
* Nonce verification for all forms and AJAX
* Input sanitization (sanitize_text_field, sanitize_textarea_field, etc.)
* Output escaping (esc_html, esc_attr, esc_url, esc_textarea, etc.)
* Capability checks (current_user_can)
* Prepared statements for database queries

= Developer Information =
* **Text Domain:** schema-star
* **Namespace:** None (functions prefixed with `star_` or `STAR_`)
* **Hooks:** Uses standard WordPress hooks (wp_head, wp_footer, the_content, etc.)
* **Filters:** Standard WordPress filters for extensibility
* **Actions:** Standard WordPress actions
* **Translation:** Full i18n support with .po/.mo files

= Credits =
* **Developer:** WP Star Plugins
* **Website:** [wpstarplugins.com](https://wpstarplugins.com)
* **Icons:** Dashicons (WordPress)
* **Standards:** Follows WordPress Coding Standards

= License =
This plugin is licensed under the 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.
```

== Support ==

For support, documentation, and updates, visit:
* **Website:** [wpstarplugins.com](https://wpstarplugins.com)
* **Help Page:** Available in WordPress admin under Schema Star → Help
* **WhatsApp:** Available in plugin admin pages (bottom right corner)

Before contacting support:
1. Ensure you're using the latest plugin version
2. Check WordPress and PHP requirements
3. Test with a default theme
4. Temporarily disable other plugins
5. Review the FAQ section in Help & Documentation

== Credits ==

**Schema Star** - Boost your SEO with powerful structured data!

*Version 10.8.100 | Copyright 2024-2026 WP Star Plugins | [wpstarplugins.com](https://wpstarplugins.com)*
