=== AlitaYoko Conversations ===
Contributors: alitayoko
Tags: conversations, dialogue, chat bubbles, storytelling, gutenberg
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Build visual conversations and dialogue stories with participants, narration, multiple styles, Gutenberg support, and progressive reveals.

== Description ==

AlitaYoko Conversations is an editorial storytelling plugin for presenting authored conversations on a WordPress site. It is designed for reconstructed chats, interviews, fictional dialogue, educational examples, customer conversations, and complete dialogue-driven stories.

It is not a live chat service and does not send messages between visitors.

= Conversation builder =

* Create any number of conversations as dedicated WordPress content items.
* Add multiple participants with individual names, bubble colors, text colors, left/right alignment, and optional avatars.
* Build a sortable conversation flow from four entry types: Message, Narration, Divider, and System notice.
* Use keyboard-accessible Move up / Move down controls in addition to drag-and-drop sorting.
* Add optional timestamps or narrative labels to participant messages.

= Storytelling and presentation =

* Five distinct presets: Modern, Material, Minimal, Classic, and Editorial / Book dialogue.
* Configure message and participant-name typography.
* Style narration independently, including size, color, alignment, and italic or regular text.
* Adjust bubble radius, shadow, and vertical spacing between flow entries.
* Preview appearance changes immediately on the per-conversation Settings screen.
* Choose whether participant names, timestamps, and avatars are shown visually.

= Progressive reveal modes =

* Instant.
* Reveal while scrolling.
* Tap / click to continue.
* Auto play with a configurable base delay.
* Show-all control for progressive modes.
* Reduced-motion preferences are respected.
* Progressive enhancement keeps authored content readable if JavaScript is unavailable.

= Gutenberg and shortcode support =

Use the native dynamic **AlitaYoko Conversation** block to select a published conversation in the block editor. The conversation is rendered dynamically, so later edits automatically appear everywhere it is embedded.

For shortcode-capable contexts, use:

`[alitayoko_conversation id="123"]`

= Examples and portability =

Three editable English example conversations are created after first activation. Administrators can recreate missing examples from Conversations > Settings without overwriting examples that still exist.

Conversations can be exported and imported as readable, versioned JSON. Imports create new conversations and never silently overwrite existing content. Persistent UUIDs detect repeated imports, while an explicit option allows an independent duplicate copy when desired.

Avatar references are portable when the matching image already exists on the destination site. AlitaYoko Conversations does not download external avatar files during import.

== Installation ==

1. Install the plugin ZIP through Plugins > Add Plugin > Upload Plugin, or copy the `alitayoko-conversations` directory to `/wp-content/plugins/`.
2. Activate AlitaYoko Conversations.
3. Open Conversations to edit an example or create a new conversation.
4. Define participants and build the Conversation flow.
5. Open Conversations > Settings to configure presentation and reveal behavior.
6. Add the AlitaYoko Conversation block to a post or page and select a published conversation.

== Frequently Asked Questions ==

= Is this a live chat plugin? =

No. AlitaYoko Conversations presents conversations that an editor authors in WordPress. It does not provide visitor-to-visitor or visitor-to-agent messaging.

= Can a conversation contain more than two participants? =

Yes. Each participant can have an individual name, color, avatar, and left/right alignment.

= Can I build a complete story instead of only chat bubbles? =

Yes. Messages can be mixed with Narration, Dividers, and System notices in any order. The Editorial preset also provides a bubble-free book/dialogue presentation.

= Are appearance settings global? =

No. Appearance and reveal settings are stored per conversation, so different conversations can use different presets and behavior.

= Does the plugin include a Gutenberg block? =

Yes. The AlitaYoko Conversation block is dynamic and is the recommended embedding method. The shortcode remains available for compatibility and non-block contexts.

= Can I move conversations between WordPress sites? =

Yes. Use Conversations > Import / Export. The versioned JSON format includes participants, conversation-flow entries, ordering, colors, appearance, narration, and reveal settings.

= Does importing overwrite an existing conversation? =

No. Imported content is created as a new conversation. UUIDs are used to detect repeated imports, which are skipped by default. You can explicitly allow an independent duplicate copy.

= What happens to my conversations if I uninstall the plugin? =

Authored conversation content is intentionally preserved. If you want to remove it, delete the conversations in WordPress before uninstalling the plugin.

== Privacy ==

AlitaYoko Conversations does not track visitors, create user accounts, send analytics, or contact external services. Conversation data is stored in the site's WordPress database. Avatar images use the site's existing WordPress Media Library.

JSON import reads only the file explicitly uploaded by an authorized WordPress user. Export is initiated explicitly by an authorized user. The plugin does not automatically download external media during import.

== Screenshots ==

1. Conversation list with entry counts, shortcodes, direct Settings links, and per-conversation export.
2. Conversation editor with participants and a sortable flow containing messages, narration, and system notices.
3. New Conversation screen ready for participants and flow entries.
4. Per-conversation Settings page with visual presets, reveal controls, typography, narration options, and sticky live preview.
5. Versioned JSON Import / Export screen for moving or backing up conversations.
6. Dynamic AlitaYoko Conversation Gutenberg block with published-conversation selection.
7. Frontend conversation with multiple participants, narration, and a modern bubble presentation.
8. Classic speech-bubble conversation with a divider and narration.
9. Editorial / Book dialogue preset combining left/right dialogue, narration, and a divider without chat bubbles.

== Changelog ==

= 1.0.0 =
* First public release.
* Build structured conversations and dialogue stories with Messages, Narration, Dividers, and System notices.
* Includes five visual presets, per-conversation styling, live preview, avatars, timestamps, and configurable vertical spacing.
* Includes Instant, Scroll Reveal, Tap / Click to Continue, and Auto Play presentation modes with accessibility support.
* Includes a dynamic Gutenberg block, shortcode support, editable example conversations, and versioned JSON import/export.
* Completed WordPress.org release audit and Plugin Check with no reported errors or warnings.

= 0.9.1 =
* Plugin Check cleanup after the release audit.
* Removed the hidden placeholder file from the languages directory.
* Added nonce-protected redirect notices for settings and import/export screens.
* Tightened request sanitization for nested editor data and import/export controls.
* Removed the example lookup meta query flagged as potentially slow by Plugin Check.

= 0.9.0 =
* Release-audit build for the first public 1.0 release.
* Hardened import/export request handling and uploaded-file validation.
* Tightened permissions for creating and restoring built-in example conversations.
* Added duplicate participant and entry-ID protection during editor saves.
* Added keyboard-accessible Move up and Move down controls for Conversation flow ordering.
* Improved form label associations in the conversation editor.
* Improved front-end conversation semantics and progressive-reveal accessibility, including an assistive live announcement region.
* Avoided querying the conversation list on ordinary front-end requests solely for Gutenberg editor choices.
* Removed inline JavaScript from the shortcode helper field.
* Updated public documentation and privacy information for WordPress.org review.

= 0.5.1 =
* Added configurable vertical entry spacing and completed the feature set planned before the 1.0 release audit.
