=== Groundworx Testimonial ===
Contributors: alexandrie
Tags: testimonial, reviews, block, gutenberg, block-theme
Plugin URI: https://wordpress.org/plugins/groundworx-testimonial
Author URI: https://groundworx.dev
Donate link: https://ko-fi.com/groundworx
GitHub URI: https://github.com/groundworx-dev/groundworx-testimonial
Requires at least: 6.5
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A modern testimonial plugin for WordPress block themes — custom post type, custom fields, and Gutenberg blocks with schema and accessibility built-in.

== Description ==
Groundworx Testimonial gives you a **dedicated testimonial post type** plus flexible blocks that fit seamlessly into the WordPress Block Editor.  

You can display testimonials in two ways:
- **Query Loop** – pull multiple testimonials automatically from the CPT.  
- **Standalone block** – insert a single block and select which testimonial post to display.  

Each testimonial supports a **quote, author, citation (e.g. company), and photo**. The main Testimonial block also includes **schema markup for SEO**, helping search engines recognize and display your reviews.

= Editing Experience =
When you add a new testimonial in the admin, the editor is streamlined for this purpose:
- The main block is a **Testimonial Quote**.  
- In the right sidebar, open the block settings panel (click the controls icon with sliders) to access fields for Author name, Citation (such as a company or title), and Photo. 

= Key Features =

**Custom Post Type + Fields**  
Manage testimonials in one place with quote, author, citation, and photo fields.

**Native Gutenberg Blocks**  
Insert testimonials directly in the Block Editor—no shortcodes or legacy templates needed.

**Main Testimonial Block**  
Full testimonial with schema support for SEO.

**Individual Field Blocks**  
Use Author, Citation, Quote, and Photo as standalone blocks if you want to design custom layouts.

**Flexible Display Options**  
- Show multiple testimonials in a Query Loop.  
- Drop in a single block and select which testimonial to feature.

**Accessible Markup**  
Semantic HTML with proper `<blockquote>`, `<figure>`, and `<figcaption>` for screen readers and SEO.

**Theme.json Integration**  
Typography, spacing, colors, and borders inherit from your theme.json design tokens.

== How it works ==

1. Go to **Testimonials → Add New** in the WordPress admin.  
2. Enter the testimonial quote, author, citation, and photo.  
3. Save and publish the testimonial.  
4. Display testimonials:  
   - Add the **Testimonial** block and select a specific testimonial to feature.  
   - Or use a **Query Loop** to show multiple testimonials automatically.  

== Blocks included ==

* **groundworx-testimonial/testimonial** – Main testimonial block (with schema support).  
* **groundworx-testimonial/quote** – Quote field.  
* **groundworx-testimonial/citation** – Citation field (e.g. company).  
* **groundworx-testimonial/author** – Author name.  
* **groundworx-testimonial/photo** – Photo block.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install via **Plugins → Add New**.  
2. Activate **Groundworx Testimonial**.  
3. In the WordPress admin, go to **Testimonials → Add New** and create your first testimonial.  
4. In the Block Editor, insert the **Groundworx Testimonial** block (or individual field blocks).  
5. Use it in a Query Loop to show multiple testimonials, or insert a standalone block and choose a testimonial to feature.  
6. Style it using your theme.json settings or the block sidebar controls.  

== Frequently Asked Questions ==

= Does this create a custom post type? =  
Yes. Groundworx Testimonial registers its own **testimonial post type** with custom fields (quote, author, citation, photo).  

= How do I display multiple testimonials? =  
Use the **Query Loop** block to pull in testimonials from the CPT. Add the Testimonial block (or individual field blocks) inside the loop, and each post will render automatically.

= Can I feature just one testimonial? =  
Yes. Insert a standalone Testimonial block and select a specific testimonial post to display.

= Does it work with classic themes? =  
Groundworx Testimonial is built for block themes using theme.json. In classic PHP themes, styling and block controls may not behave as expected.

= Is it accessible? =  
Yes. The plugin outputs semantic HTML using `<blockquote>`, `<cite>`, `<figure>`, and `<figcaption>`, following accessibility best practices.

== Screenshots ==
1. Testimonial post type with quote, author, citation, and photo fields.  
2. Manually curated testimonials in the editor.  
3. Global Styles and theme.json support.  
4. Displaying testimonials with Query Loop.  
5. Use testimonial content your way with Quote, Photo, Author, and Citation blocks. 

== Changelog ==

= 1.1.0 =
* Consolidated all block assets into central editor/style handles (removed per-block file references)
* Refactored all block registrations to use central entry point pattern
* Fixed: Job title block rendering empty due to wrong meta key
* Fixed: Taxonomy plural label default ("Testimonials Categories" → "Testimonial Categories")
* Fixed: JSON-LD script output now uses JSON_HEX_TAG to prevent script breakout
* Added sanitize_callback to all registered post meta fields
* Added attribute allowlists for textAlign and template values in render callbacks
* Improved internationalization across editor components and variation labels
* Made template type titles and descriptions translatable
* Removed unused navigation plugin files from inc/ directory
* Lowered PHP requirement to 7.4

= 1.0.0 =
* Initial public release – Custom post type, custom fields, main testimonial block with schema, plus author, citation, photo, and quote sub-blocks.

== Upgrade Notice ==

= 1.0.0 =
First stable release. Includes CPT, custom fields, schema support, accessibility, and block-based layouts for testimonials.
