The importer converts a weDocs site to PimiDocs in place: articles keep their post IDs, content, authors, dates and comments. Nothing is copied or recreated, so nothing that references a post survives as a broken pointer.
What maps to what
- weDocs root docs become products (the root post itself is drafted, kept as a backup).
- Sections become categories. A section that carries its own written content also becomes an article at its old URL, so that content is not lost.
- Articles stay articles — the section segment simply drops out of their URL, and the old URL 301s to the new one.
Run it
Use Docs → Import in the admin, or WP-CLI for the same result with a written record:
# See the full plan first. Writes nothing.
wp pimidocs migrate --from=wedocs --dry-run
# Apply, then verify every old URL lands where it should.
wp pimidocs migrate --from=wedocs --apply
wp pimidocs migrate --from=wedocs --verify
The dry run prints every product, category and article it will create, every slug it would rename, and every issue it can foresee — read it before applying. If a proposed slug is not what you want, override it with --rename=<source_id>:<slug>.
Redirects and verification
Every old URL is recorded and either served natively by the router or 301-redirected. --verify requests each one over HTTP and reports where it landed, so you know the same day whether anything broke — not when search traffic drops. The redirect inventory survives later base and slug changes and can be rebuilt at any time from Docs → Redirects.
If something goes wrong
wp pimidocs migrate --from=wedocs --rollback
Rollback restores post types, parents, slugs and statuses from markers written during apply, deletes only the terms the migration created, and restores your previous settings. BetterDocs migration works the same way with --from=betterdocs.
