=== Pagora AI – AI Page Builder ===
Contributors: enkic
Tags: ai, page builder, landing page, page generator, content generation
Requires at least: 6.3
Tested up to: 7.0
Stable tag: 1.0.5
Requires PHP: 8.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI page builder for WordPress: describe a page, get complete HTML/CSS/JS, and refine it live in a code editor. Build landing pages in minutes.

== Description ==

[youtube https://youtu.be/MB0pOtGKngw]

**Pagora AI is an AI page builder for WordPress.** Instead of dragging blocks around, you describe the page you want in plain language and the AI generates a complete, ready-to-publish page — layout, copy, styling, and interactivity included. Need a landing page, a product page, a coming-soon page, or a full homepage? Describe it, review it, publish it.

Not happy with a detail? Keep chatting to refine it — or open the built-in code editor and adjust the HTML, CSS, and JavaScript yourself. That's what makes Pagora AI different: **beginners get a no-code, chat-driven page builder, and developers get full control of the generated code.** No black box, no lock-in.

= Why people use Pagora AI =

* **Build landing pages fast** — turn a one-line description into a finished page in minutes instead of hours.
* **Stay in control** — every page is real HTML/CSS/JS you can read, edit, and own.
* **Skip the block wrestling** — no complex block editor, no page-builder learning curve. Just describe and publish.
* **Iterate by chatting** — "make the hero darker", "add a pricing table", "shorten the intro" — the AI updates the page for you.

= Key features =

* **AI chat page generation** — describe your page in natural language; the AI produces a complete page with animations and UnoCSS utility styling (Tailwind-style classes).
* **Built-in code editor** — a Cursor-style editor (CodeMirror) with HTML/CSS/JS syntax highlighting, auto-formatting, and keyboard shortcuts for full manual control.
* **Live preview** — an isolated preview that updates instantly after every AI response or edit.
* **Version history** — every save creates a snapshot; restore any previous version in one click.
* **AI image generation** — generate and insert images directly from the editor.
* **Built-in SEO panel** — set the title, meta description, and featured image for each page.
* **Reusable templates** — save any page as a template and reuse it across your site.
* **Modern interactivity bundled** — Alpine.js and Motion One ship with generated pages for smooth animations and declarative behaviour, with no extra plugins to install.

= Free trial and pricing =

The **plugin is free to install**. Page generation is powered by the Pagora AI cloud service, which you connect from the plugin settings. New accounts start with a **free trial** so you can create your first pages before committing, then continue on a paid Pagora AI plan. Full pricing is available at [pagora-ai.com](https://pagora-ai.com/).

= How it works =

This plugin is a client for the Pagora AI service. No AI model runs on your server.

1. Install and activate the plugin.
2. Create an account at [pagora-ai.com](https://pagora-ai.com/) and connect it from **Settings → Pagora AI**.
3. Open any WordPress page and click **Edit with Pagora AI**.
4. Describe the page you want in the chat, refine it, and publish.

= Data and privacy =

This plugin connects exclusively to the Pagora AI service (`https://api.pagora-ai.com`) to process your prompts and generate page code. No data is sent to any other third party.

* Prompts and generated code transit through our servers for processing.
* See our [Privacy Policy](https://pagora-ai.com/index.php/privacy-policy-pagora-ai/) and [Terms of Service](https://pagora-ai.com/index.php/terms-of-service-pagora-ai/).
* The plugin collects no telemetry of its own.

= For developers =

Pagora AI generates standalone pages that only override theme rendering where you explicitly activate them. Under the hood: page content is stored in post meta with separated HTML/CSS/JS for draft and published states, compiled assets are written with hashed filenames to `wp-content/uploads/pagora-ai/`, and header/footer/custom template parts are inserted via named placeholders. The plugin includes cache-purge integrations for WP Rocket, W3 Total Cache, and LiteSpeed Cache.

= Bundled libraries =

All bundled libraries are GPL-compatible:

* [UnoCSS Runtime](https://unocss.dev/) — MIT
* [Alpine.js](https://alpinejs.dev/) — MIT
* [Motion One](https://motion.dev/) — MIT
* [CodeMirror](https://codemirror.net/) — MIT
* [Symfony DomCrawler / CssSelector](https://symfony.com/doc/current/components/dom_crawler.html) — MIT (isolated via php-scoper)
* [Masterminds HTML5-PHP](https://github.com/Masterminds/html5-php) — LGPL-2.1

= Source code and build instructions =

The JavaScript and CSS bundles are compiled from TypeScript/TSX source. The full, unminified source is public at:

https://github.com/Enkic/pagora-ai-plugin

To build from source:

1. Clone the repository.
2. Run `npm install`.
3. Run `npm run build` to compile bundles into `assets/build/` and `assets/editor/build/`.

Build tool: Webpack (via `@wordpress/scripts`). Node 18+ required.

== Installation ==

1. Upload the ZIP via **Plugins → Add New → Upload Plugin**, or extract it into `/wp-content/plugins/`.
2. Activate the plugin from the **Plugins** menu.
3. Go to **Settings → Pagora AI** and connect your account.
4. On any page, click **Edit with Pagora AI** to start building.

== Frequently Asked Questions ==

= How do I create a WordPress page with AI? =

Install Pagora AI, connect your account, open any page, and click **Edit with Pagora AI**. Describe the page you want in the chat ("a landing page for my bakery with a hero, menu, and contact form") and the AI generates the full page. Refine it by chatting or by editing the code directly, then publish.

= Is Pagora AI a no-code page builder? =

Yes — and more. You can build an entire page without touching code, purely by describing it in the chat. But unlike most no-code builders, Pagora AI also lets you open the generated HTML, CSS, and JavaScript and edit it directly, so it works for beginners and developers alike.

= Can I build landing pages with Pagora AI? =

Yes. Landing pages are one of the most common use cases. Describe your offer and target audience, and the AI generates a complete, conversion-focused landing page you can publish or refine.

= Can I edit the HTML, CSS, and JavaScript? =

Yes. The built-in CodeMirror editor gives you full access to the generated code with syntax highlighting and auto-formatting. Your manual edits and AI edits work side by side.

= Is there a free trial? How much does it cost? =

The plugin is free to install. Page generation runs on the Pagora AI cloud service, and new accounts start with a free trial. After the trial, generation continues on a paid Pagora AI plan. See [pagora-ai.com](https://pagora-ai.com/) for current pricing.

= Do I need an account to use the plugin? =

Yes. The plugin is a client for the Pagora AI service, so an account is required to access the AI.

= Will Pagora AI break my theme? =

No. Pagora AI only replaces theme rendering on the specific pages where you activate it. Every other page and your theme stay exactly as they are.

= Are Pagora AI pages compatible with caching plugins? =

Yes. Compiled assets use hashed filenames, and the plugin includes cache-purge integrations for WP Rocket, W3 Total Cache, and LiteSpeed Cache.

= What happens if I deactivate or uninstall the plugin? =

If you deactivate it, Pagora AI pages display their content normally through your active theme — no data is lost. Uninstalling (`uninstall.php`) removes plugin options, page metadata, user tokens, and generated asset files in `uploads/pagora-ai/`; your WordPress page content is preserved.

= What WordPress capabilities are required? =

Access to the editor requires the `unfiltered_html` capability (typically Administrators). Settings management requires `manage_options`.

== Screenshots ==

1. The Pagora AI page builder — chat panel on the left, live preview in the center, HTML/CSS/JS code editor on the right.
2. Generating a complete page from a single description in the AI chat.
3. The built-in code editor with syntax highlighting for full manual control.
4. Version history — restore any snapshot of your page in one click.
5. Settings — connect your Pagora AI account.

== Changelog ==

= 1.0.4 =
* Bug fixes and stability improvements.

= 1.0.3 =
* Editor and live preview improvements.

= 1.0.2 =
* Credit handling refinements and minor fixes.

= 1.0.1 =
* Credit system updates.

= 1.0.0 =
* Initial public release.
* Full AI editor with chat, live preview, and code editor.
* Version management and snapshots.
* AI image generation and insertion.
* Built-in SEO panel.
* Reusable template system.
* Alpine.js, Motion One, and UnoCSS bundled for generated pages.
* Complete REST API under `pagora-ai/v1/`.
* Cache purge integrations (WP Rocket, W3TC, LiteSpeed).

== Upgrade Notice ==

= 1.0.4 =
Stability and editor improvements. Recommended for all users.