=== Pull Quote Author ===
Contributors:      snehalpancholi
Tags:              pull quote, blockquote, gutenberg, quote block, author attribution
Requires at least: 6.2
Tested up to:      6.7
Requires PHP:      8.1
Stable tag:        1.0.0
License:           GPL-2.0+
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

A Gutenberg block for beautiful pull quotes with author attribution. Three visual styles, accent colour picker, inline editing. No build step required.

== Description ==

**Pull Quote Author** adds a native Gutenberg block that lets you place styled pull quotes anywhere in your content — complete with author name and role attribution. Everything is editable directly in the block editor with an accurate live preview. The block is server-side rendered, making it compatible with full-site editing, REST API endpoints, and all major caching solutions.

**Key features:**

* Three built-in visual styles: Classic, Minimal, and Bordered
* Inline rich-text editing for the quote, author name, and role
* Accent colour picker to match your brand
* Toggle the decorative opening quotation mark on or off
* Text alignment: centre or left
* Server-side rendered — no JavaScript on the frontend
* CSS custom property (`--pqa-accent`) for easy theme override
* Responsive at all screen sizes
* No build step, no jQuery, no external dependencies
* Accessible: semantic `<figure>`, `<blockquote>`, `<figcaption>`, and `<cite>` elements

**Classic style**

Large decorative opening quotation mark, white card background with a soft box shadow, and an accent-colour left border at the bottom of the card. Text is centred.

**Minimal style**

Clean and typographic — larger italic quote text with a thin accent-colour underline. No background, no shadow. Ideal for editorial layouts.

**Bordered style**

Accent-colour left vertical bar, grey background, left-aligned text. Feels at home in technical articles or sidebars.

== Installation ==

1. Upload the `pullquote-author` folder to `/wp-content/plugins/`.
2. Activate the plugin through **Plugins → Installed Plugins**.
3. In the block editor, search for **Pull Quote** or browse the **Text** category.
4. Insert the **Pull Quote Author** block.
5. Click the quote text to edit it inline, and fill in author details in the same way.
6. Use the right-hand **Block** panel to switch styles, change the accent colour, adjust text alignment, and toggle the open-quote mark.

== Frequently Asked Questions ==

= Does this block need a build step? =

No. The editor script is plain ES6 using `wp.element.createElement`. No webpack, no Node.js required.

= Can I customise the colours with CSS? =

Yes. The block exposes `--pqa-accent` as a CSS custom property on the wrapper element. You can override it in your theme stylesheet or child theme.

= Is the block accessible? =

Yes. The block uses semantic HTML5: `<figure>`, `<blockquote>`, `<figcaption>`, and `<cite>`. The decorative quotation mark is hidden from assistive technology with `aria-hidden="true"`.

= Does it work with full-site editing (FSE) themes? =

Yes. The block is registered as a dynamic (server-side rendered) block, which is fully compatible with FSE themes and the Site Editor.

= Can I have more than one pull quote per page? =

Yes — unlimited. Each block instance is independent.

= What happens to my content if I deactivate the plugin? =

The block attributes remain stored in the post content. If the plugin is deactivated, the block will display as an "unknown block" in the editor but the saved content is preserved and recoverable by reactivating the plugin.

== Screenshots ==

1. Pull Quote Author block — Classic style with open quote mark and author attribution.
2. Pull Quote Author block — Minimal style, centred layout.
3. Pull Quote Author block — Bordered style, left-aligned layout.
4. Block inspector controls: style selector, accent colour picker, alignment toggle, and open-quote toggle.

== Changelog ==

= 1.0.0 — 2026-06-14 =
* Initial release.
* Three visual styles: Classic, Minimal, Bordered.
* Accent colour picker.
* Inline rich-text editing for quote, author, and role.
* Text alignment control.
* Open-quote toggle.
* Server-side render with full escaping.
