capell-app / wordpress-importer
Migrate your WordPress site into Capell with guided WXR import previews and rollback-safe Migration Assistant handoff.
Requires
- php: ^8.4
- ext-simplexml: *
- capell-app/admin: ^1.0
- capell-app/core: ^1.0
- capell-app/migration-assistant: ^1.0
- illuminate/support: ^11.0|^12.0|^13.0
- spatie/laravel-package-tools: ^1.15
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
- 4.x-dev
- dev-main / 1.x-dev
- v1.0.37
- v1.0.36
- v1.0.35
- v1.0.34
- v1.0.33
- v1.0.32
- v1.0.31
- v1.0.30
- v1.0.29
- v1.0.28
- v1.0.27
- v1.0.26
- v1.0.25
- v1.0.24
- v1.0.23
- v1.0.22
- v1.0.21
- v1.0.20
- v1.0.19
- v1.0.18
- v1.0.17
- v1.0.16
- v1.0.15
- v1.0.14
- v1.0.12
- v1.0.10
- v1.0.9
- v1.0.8
- v1.0.7
- v1.0.6
- v1.0.5
- v1.0.4
- v1.0.3
- v1.0.2
- v1.0.1
- v1.0.0-beta.2
- dev-release-backup/v0.0.9-main
- dev-release-backup/v0.0.8-main
This package is auto-updated.
Last update: 2026-09-15 20:51:11 UTC
README
What This Extension Adds
WordPress Importer is an Available, No schema impact Capell package in the Capell Operations product group. It ships as capell-app/wordpress-importer and extends these surfaces: admin, console.
Preview WordPress WXR posts and pages in Capell Migration Assistant with permalink, taxonomy, author, media-reference, Gutenberg, and shortcode metadata preserved.
After install, the package contributes admin-facing extension points. Docs gap: no concrete Filament resource or page was detected.
Status details:
- Status: Available
- Tier: premium
- Bundle: operations
- Composer package:
capell-app/wordpress-importer - Namespace:
Capell\WordPressImporter - Theme key: not applicable
Why It Matters
For developers: The package gives developers package-owned service providers, Actions, and Data objects instead of pushing this behaviour into core or application code.
For teams: Preview WordPress WXR posts and pages in Capell with durable metadata ready for Migration Assistant mapping.
Screens And Workflow
Screenshot contract: docs/screenshots.json.
- Migration Assistant import flow with WordPress WXR available as an import source (admin, required).
- Parsed WordPress WXR rows previewed in Migration Assistant (admin, required).
- Import session detail for a WordPress WXR import (admin, optional).
Technical Shape
- Service providers:
Capell\WordPressImporter\Providers\WordPressImporterServiceProvider. - Listeners:
CreateWordPressRedirectsForCompletedImport,ImportWordPressMediaForCompletedImport. - Actions:
ApplyWordPressPreviewIdempotencyAction,BuildWordPressImportPreviewAction,CreateWordPressPermalinkRedirectsAction,ImportWordPressMediaForPagesAction. - Data objects:
ResolvedWordPressMediaEndpointData,WordPressImportPreviewData,WordPressPermalinkRedirectReportData. - Command signatures:
wordpress-importer:import. - Console command classes:
ImportWordPressWxrCommand. - Manifest contributions:
console-command: Capell\WordPressImporter\Manifest\WordPressImporterConsoleCommandContribution,health-check: Capell\WordPressImporter\Health\WordpressImporterHealthCheck. - Health checks:
Capell\WordPressImporter\Health\WordpressImporterHealthCheck.
Data Model
This package has no schema impact. It does not declare package-owned migrations or required tables.
Docs gap: document extension points here if the package delegates persistence to a host package.
Install Impact
- Admin navigation: admin-facing extension points are declared, but no concrete Filament class was detected.
- Permissions: none declared in
capell.json. - Public routes: none detected in package route files.
- Database changes: no package migrations declared.
- Settings: no package settings declared.
- Queues or schedules: none detected in standard package paths.
- Cache tags: none declared.
- Commands:
wordpress-importer:import.
Common Pitfalls
- Run package commands from the host app; in this repository use
vendor/bin/pestfor package tests. - Keep
composer.json,composer.local.json,capell.json, docs, screenshots, and tests aligned when the package surface changes.
Troubleshooting
| Symptom | Likely cause | Check | Fix |
|---|---|---|---|
| Package surface is missing after install | Provider or manifest is not loaded | Confirm capell.json, package composer.json, and provider registration |
Reinstall the package, refresh Composer autoload, and clear host caches |
| Background work does not run | Queue worker or scheduled command is not active | Check package jobs, commands, and host scheduler configuration | Start the queue or scheduler, then run the focused command or package test |
Quick Start
- Install the package:
composer require capell-app/wordpress-importer. - Run the required setup: no package migrations are declared; clear cached config and routes if the host app uses caches.
- Verify the package provider is registered and the related frontend, command, or extension point is active.
Next Steps
- Package docs
- Overview
- Screenshot contract
- Marketplace assets
- Capell content language plan
- Capell documentation design system
- Capell and package ERD notes
- Related packages: Migration Assistant, Url Manager, Seo Suite.
- Focused tests:
vendor/bin/pest packages/wordpress-importer/tests --configuration=phpunit.xml.