Download the PHP package itzmekhokan/sitecargo without Composer
On this page you can find all versions of the php package itzmekhokan/sitecargo. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download itzmekhokan/sitecargo
More information about itzmekhokan/sitecargo
Files in itzmekhokan/sitecargo
Package sitecargo
Short Description SiteCargo — selectively promote WordPress FSE structure and content (patterns, templates, parts, global styles, navigation) between environments, without a full database migration.
License GPL-2.0-or-later
Homepage https://github.com/itzmekhokan/sitecargo
Informations about the package sitecargo
SiteCargo
Selectively promote WordPress FSE structure and content between environments — without a full database migration.
🔗 Website & docs: https://itzmekhokan.github.io/sitecargo/
WordPress full-site-editing structure (patterns, template parts, templates, global styles, navigation) lives in the database. Moving some of it from staging to production today means a full DB sync (destructive to orders/users/form entries) or manual copy-paste. SiteCargo packs exactly what you choose into a portable, git-trackable bundle and applies it elsewhere with stable identity, ID remapping, and media sideloading — never touching the data you didn't select.
Status:
0.1.1— early release. Patterns, templates, template parts, global styles, and navigation, with a full export→import loop. Not yet production-hardened.
How it works
Two ideas make it safe and repeatable:
- Stable identity. Standalone posts (patterns, navigation) are stamped with a portable UUID (
_sitecargo_guid) so re-applying updates the same entity instead of duplicating it. Templates, parts, and global styles key ontheme + sluginstead, since those are file-or-DB by nature. - Reference rewriting. Numeric IDs baked into block markup (image IDs, reusable-block refs, navigation refs, gallery ID lists) are extracted on export with their position in the block tree, then re-resolved to local IDs on import.
Installation
SiteCargo is a WP-CLI tool — WP-CLI is required to use it.
Via Composer (for Composer-managed sites such as Bedrock):
The wordpress-plugin package type installs it into wp-content/plugins/sitecargo. Then activate it:
From the WordPress.org Plugin Directory (once approved): search for "SiteCargo" under Plugins → Add New, or wp plugin install sitecargo --activate.
Manually: download a release, unzip it into wp-content/plugins/, and activate.
Usage
Supported entity types: patterns (wp_block), templates (wp_template), template parts (wp_template_part), global styles (wp_global_styles), and navigation (wp_navigation). Templates/parts must be customized in the database to be exported — unedited theme-file templates ship with the theme already.
Roadmap
| Phase | Scope | Status |
|---|---|---|
| 1 | wp_block patterns — export, media collection, reference extraction |
✅ done |
| 2a | Import side — diff (dry-run) + apply with ID remapping & media sideloading |
✅ done |
| 2b | Templates, template parts, global styles (theme+slug identity) | ✅ done |
| 3a | Navigation menus (wp_navigation) + wp:navigation ref remapping |
✅ done |
| 3b | Selected posts/CPTs by slug (+ navigation-link ID remapping) |
planned |
| 4 | Admin UI (checkbox tree + visual diff) | planned |
| 5 | Direct site→site push over REST (application passwords) | planned |
Development
Tests use the WordPress PHPUnit harness. Set WP_TESTS_DIR, or run from a workspace where wordpress-develop is a sibling directory (the bootstrap will find it automatically).
Contributing
Issues and pull requests are welcome:
- Report a bug or request a feature: github.com/itzmekhokan/sitecargo/issues
- Source & releases: github.com/itzmekhokan/sitecargo
Please run the test suite (composer test) and ensure it passes before opening a PR.
License
GPL-2.0-or-later. See LICENSE.