WordPress.org
Get WordPress

Plugin Directory

Changeset 3490663


Ignore:
Timestamp:
03/25/2026 08:45:42 AM (8 days ago)
Author:
firetapltd
Message:

Fixed option key mismatch (locations → kpsp_locations)

File:
1 edited

Legend:

Unmodified
Added
Removed

  • firetap-knowledge-panel-schema/trunk/readme.txt

    r3478063 r3490663  
    11=== Firetap Knowledge Panel Schema ===
    22Contributors: firetapltd, rakshakmathur
    3 Tags: schema, json-ld, knowledge panel, localbusiness, seo
     3Tags: schema, json-ld, knowledge panel, localbusiness, structured data, seo, rich results, faq schema, product schema
    44Requires at least: 6.0
    55Tested up to: 6.9
    6 Stable tag: 2.5
     6Stable tag: 2.6
     7Requires PHP: 7.4
    78License: GPLv2 or later
    89License URI: https://www.gnu.org/licenses/gpl-2.0.html
    910
    10 Adds advanced Schema.org JSON-LD for Organizations, Local Businesses, FAQs, Products, and Courses with full URL targeting controls.
     11Generate clean, Google-compliant Schema.org JSON-LD for Organization, LocalBusiness, FAQs, Products, and Courses with full control and URL-level targeting.
    1112
    1213== Description ==
    1314
    14 Knowledge Panel Schema Pro is an all-in-one structured data plugin designed for SEO professionals and agencies.
     15Firetap Knowledge Panel Schema is a lightweight yet powerful structured data plugin designed for **SEO professionals, agencies, and local businesses** who want **accurate, error-free schema markup** without complexity.
    1516
    16 It generates clean, Google-compliant JSON-LD for:
     17Unlike many schema plugins, this plugin focuses on:
    1718
    18 * Organization and LocalBusiness entities
    19 * Multi-location businesses
     19✔ Clean JSON-LD output
     20✔ No duplicate structured data issues
     21✔ Full control over where schema appears
     22✔ Compliance with Google Rich Results guidelines
     23
     24It helps you build a complete **Google Knowledge Panel-ready schema setup** including:
     25
     26* Organization and LocalBusiness schema
     27* Multi-location support (primary + additional locations via `hasPart`)
    2028* Opening hours and special/holiday hours
    21 * FAQs (with page-level targeting to avoid duplicate markup)
    22 * Products (with image fallbacks and correct Offer markup)
    23 * Training Courses (using proper Course schema, not misused Product schema)
    24 * Optional Google Reviews integration via the Google Places API
     29* FAQ schema with URL targeting (prevents duplicate FAQ warnings)
     30* Product schema with valid `Offer` markup and image fallback
     31* Course schema using correct `Course` type (not misused Product schema)
     32* Optional Google Reviews integration (via Google Places API)
    2533
    26 The plugin is built to follow Google’s structured data guidelines closely, with a focus on accuracy, flexibility, and avoiding common schema implementation issues.
     34Developed by **FireTap Ltd**, a UK-based digital marketing agency focused on technical SEO.
    2735
    28 Developed and maintained by Rakshak Mathur (FireTap Ltd), a UK-based digital marketing agency.
     36== Why This Plugin? ==
     37
     38Most schema plugins:
     39
     40* Output unnecessary or bloated markup
     41* Cause duplicate FAQ or Product schema issues
     42* Misuse schema types (especially Courses)
     43
     44This plugin is built to **avoid those problems completely**.
     45
     46✔ No shortcodes
     47✔ No frontend rendering
     48✔ No unnecessary scripts
     49✔ Only clean JSON-LD output
    2950
    3051== Features ==
    3152
    32 * Business type selector (LegalService, ProfessionalService, Store, etc.)
    33 * Single primary address + multi-location support
    34 * FAQ schema with URL targeting (prevents duplicate FAQ errors)
    35 * Product schema with price, availability & image fallback
    36 * Course schema for training & education services
    37 * Page-level URL targeting for FAQs, Products & Courses
     53* Business type selector (ProfessionalService, LegalService, Store, etc.)
     54* Primary location + multiple additional locations
     55* FAQ schema with page-level targeting
     56* Product schema:
     57
     58  * Price
     59  * Availability
     60  * Image (with automatic logo fallback)
     61* Course schema for training and education
     62* URL targeting for:
     63
     64  * FAQs
     65  * Products
     66  * Courses
     67* Opening hours + special hours support
    3868* Google Rich Results compatible output
    39 * No shortcode or frontend rendering — schema only
     69* Live JSON-LD preview in admin panel
     70* Lightweight and fast (no frontend assets)
    4071
    41 == External services ==
     72== External Services ==
    4273
    43 This plugin can optionally connect to the Google Places API (Google Maps Platform) to fetch public review/rating data for your configured Place ID.
     74This plugin can optionally connect to the **Google Places API (Google Maps Platform)** to fetch public review and rating data.
    4475
    45 * What is sent: Your configured **Place ID** and **API key** are used to request place details from Google.
    46 * When: Only when the Google Reviews option is enabled and the schema is generated on the front-end.
    47 * Why: To output `aggregateRating` and `review` markup in the JSON-LD.
     76* What is sent:
    4877
    49 Service provider: Google (Google Maps Platform) 
    50 Terms: https://cloud.google.com/maps-platform/terms 
     78  * Your configured **Place ID**
     79  * Your **API key**
     80* When:
     81
     82  * Only when Google Reviews are enabled
     83  * Only during frontend schema generation
     84* Why:
     85
     86  * To output `aggregateRating` and `review` structured data
     87
     88Service provider: Google (Google Maps Platform)
     89Terms: https://cloud.google.com/maps-platform/terms
    5190Privacy: https://policies.google.com/privacy
    5291
    … …  
    56952. Activate the plugin
    57963. Go to **KPSP Schema** in the WordPress admin menu
    58 4. Configure your schema and save
     974. Configure your schema settings
     985. Save changes
    5999
    60100== Frequently Asked Questions ==
    61101
    62102= Will this cause duplicate FAQ errors? =
    63 No. You can restrict FAQ schema to specific URLs.
     103No. FAQ schema can be restricted to specific URLs to prevent duplication issues.
    64104
    65105= Can I use this for courses instead of products? =
    66 Yes. Courses use proper `Course` schema, not Product.
     106Yes. Courses use proper `Course` schema instead of incorrectly using Product schema.
    67107
    68 = Does it output schema sitewide? =
    69 Only if you leave URL targeting blank.
     108= Does schema output on every page? =
     109Only if URL targeting is left blank. You can control exactly where schema appears.
     110
     111= Does this slow down my website? =
     112No. The plugin only outputs lightweight JSON-LD in the `<head>` with no frontend scripts.
    70113
    71114== Changelog ==
    72115
     116= 2.6 =
     117
     118* Fixed location fields not saving correctly in admin
     119* Fixed locations option mismatch (locations → kpsp_locations)
     120* Improved location sanitisation and reliability
     121* Improved live JSON preview accuracy
     122* General stability and admin improvements
     123
    73124= 2.5 =
     125
    74126* Added Course schema support
    75127* Added Product image upload with logo fallback
    … …  
    82134This plugin is licensed under the GPL v2 or later.
    83135
    84 == Technical Details ==
     136== Technical Notes ==
    85137
    86 This plugin uses the `Contributors:` field to list all WordPress.org usernames who have contributed to the code. This enables link‑backs to the WordPress.org profiles of each contributor and publicly attributes development credits in the WordPress.org plugin directory. :contentReference[oaicite:1]{index=1}
     138The `Contributors:` field lists WordPress.org usernames to properly attribute development and link profiles in the plugin directory.
Note: See TracChangeset for help on using the changeset viewer.