/home/altere25/.trash/wp-to-sanity-migration.2
Edit: /home/altere25/.trash/wp-to-sanity-migration.2/readme.txt (8174B)
=== WP to Sanity Migration ===
Contributors: altereddigital
Tags: migration, sanity, headless, elementor, divi
Requires at least: 4.7
Requires PHP: 7.4
Stable tag: 2.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Migrate WordPress content (Gutenberg, Elementor, WPBakery, Divi, Beaver Builder) into your Sanity.io project via the Altered Digital migration service.
== Description ==
WP to Sanity Migration is the companion plugin for the [Altered Digital](https://altereddigital.io) migration service. It provides a guided 10-step wizard that analyzes your WordPress site, generates a quote, connects to your Sanity project, migrates your content, and provides post-migration tooling.
**This plugin is an interface to the Altered Digital migration service.** The content transformation, page builder parsing, SEO extraction, and redirect handling are performed by the Altered Digital Worker (a Cloudflare Worker) and AI service. The plugin sends your WordPress content to that service for processing.
= What data is sent to the external service? =
When you trigger a migration, the plugin sends the following data to the Altered Digital Worker:
* **Post content** — title, body (raw HTML, Gutenberg blocks, or page builder data), excerpt, slug, publish date, and status for each exported post/page.
* **Taxonomy terms** — categories and tags (name, slug, description, parent).
* **Authors** — display name, slug, and bio for post authors.
* **Media** — featured images and inline images (uploaded by reference URL to your WP site, then transferred to Sanity's asset CDN).
* **ACF fields** — Advanced Custom Fields field group data associated with exported posts.
* **SEO metadata** — Yoast or Rank Math SEO data (meta title, meta description, canonical URL, Open Graph data, Twitter card, schema.org JSON-LD) extracted from post meta.
* **Redirect rules** — redirect rules from the Redirection plugin (if installed), sent as a batch to the Worker.
* **Site analysis** — when you click "Analyze my site": post counts per type, page builder distribution, ACF field inventory, theme name/version, WordPress version, and PHP version.
All external calls are initiated by you (clicking wizard buttons) or by the auto-sync feature (which you must explicitly enable in the Content Settings step — it is off by default).
The plugin **does not** send: user passwords, API keys stored in other plugins, Stripe/PayPal/SMTP credentials, or any other sensitive post meta. A filter strips known sensitive meta keys before sending post data.
= External services =
This plugin communicates with the following services:
* **Altered Digital Worker** (Cloudflare Worker) — receives your content, transforms it, and writes it to your Sanity project. URL is configured during the Connect step.
* **Altered Digital AI Service** (Vercel) — performs site analysis, quote generation, QA checks, and AI-assisted content transformation. URL is configured during the Connect step.
* **Supabase** (auth.altereddigital.io) — handles user authentication (signup/login) for the Altered Digital platform. Your email and password are sent to Supabase's hosted auth service.
* **Stripe** — processes upfront and final payments. You are redirected to Stripe Checkout; the plugin does not handle or store card data.
Terms of Use: https://docs.altereddigital.io/terms
= Page builder support =
* **Gutenberg** — native block editor content
* **Elementor** — full JSON widget tree parsing
* **WPBakery** — shortcode-based content parsing
* **Divi 4** — shortcode-based content parsing
* **Divi 5** — block-comment-based content parsing
* **Beaver Builder** — full layout data parsing
= SEO support =
* **Yoast SEO** — all meta fields extracted and mapped to Sanity's `seo` object
* **Rank Math SEO** — all meta fields extracted and mapped to Sanity's `seo` object
= Redirect support =
* **Redirection plugin** — active redirect rules extracted and migrated to Sanity `redirect` documents
= Features =
* 10-step guided migration wizard
* Automatic site analysis with page builder detection
* Quote generation with upfront and final payment
* Sanity project connection (Project ID, dataset, API token)
* Staging dataset protection (content held in staging until final payment)
* Content type and taxonomy selection
* Full-site or incremental migration
* Real-time migration progress dashboard
* Auto-sync mode (automatic content sync on post publish/update)
* Post-migration tooling:
* Claude Connect — MCP hand-off for Claude Desktop
* Schema Preview — AI-generated Sanity schema review
* Migration Log — per-post migration history
* WP-CLI commands (`wp altered-digital export|analyze|status`)
* Multisite support (network-activate creates tables on all sites)
* Self-host mode for enterprise deployments
== Installation ==
1. Upload the `wp-to-sanity-migration` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Navigate to **WP to Sanity** in the admin menu
4. Follow the 10-step wizard to complete your migration
= Self-host mode =
For enterprise deployments running your own Worker instance, set the `SELF_HOST` environment variable on your Cloudflare Worker and configure `WP_WEBHOOK_SECRET`, `SANITY_PROJECT_ID`, `SANITY_DATASET`, and `SANITY_API_TOKEN` as Worker environment variables. The plugin will use the Worker URL you configure in the Connect step.
See the [self-hosting guide](https://docs.altereddigital.io/self-hosting) for details.
== Frequently Asked Questions ==
= Do I need a Sanity.io account? =
Yes. You need a Sanity project with a Project ID, dataset name, and an API token. You can create a free Sanity account at sanity.io. The plugin connects to your project during the Connect step.
= Do I need to pay to use this plugin? =
The Altered Digital migration service has a two-part pricing model: 50% upfront (analysis + setup) and 50% final (promotion to production). The plugin itself is free and all plugin code is fully available under the GPL. Content is held in a staging dataset until the final payment, at which point it is promoted to your production Sanity dataset.
= Is my content sent to external servers? =
Yes. When you trigger a migration, your WordPress content is sent to the Altered Digital Worker for transformation and written to your Sanity project. The plugin does not send data without your action (or without auto-sync being explicitly enabled). See the "What data is sent" section above.
= Does the plugin modify my WordPress site? =
No. The plugin reads your content and sends it to the external service. It does not modify your posts, pages, themes, or database content. The only database writes are to its own tracking tables (`ad_migration_log`) and its own settings option (`ad_settings`).
= Does the plugin work with multisite? =
Yes. Network-activate the plugin to create tracking tables on all sites. Network admin settings are pushed to all subsites.
= Can I use WP-CLI? =
Yes. The plugin registers `wp altered-digital export`, `wp altered-digital analyze`, and `wp altered-digital status` commands.
== Screenshots ==
1. The 10-step migration wizard
2. Site analysis with page builder detection
3. Migration progress dashboard with real-time stats
4. Next Steps tooling (Claude Connect, Schema Preview, Migration Log)
== Changelog ==
= 2.0.0 =
* Complete rewrite as a 10-step guided wizard
* Multi-tenant support with Supabase authentication
* Staging dataset payment protection
* SEO metadata extraction (Yoast + Rank Math)
* Redirect rule migration (Redirection plugin)
* Post-migration tooling: Claude Connect, Schema Preview, Migration Log
* WP-CLI commands and multisite support
* Beaver Builder and Divi 5 parser support
= 1.0.0 =
* Initial release: single-tenant WordPress to Sanity migration
== Upgrade Notice ==
= 2.0.0 =
Major upgrade. The plugin has been redesigned as a 10-step wizard. Your existing settings are migrated automatically on first load. If you were using the v1 `WP_to_Sanity_Plugin` class, it remains available as a backwards-compatible alias.