SDS Astraport
Import and export Astra and Astra Pro settings with mandatory preflight, fixed write targets, and read-only Astra Pro module-state comparison.
- Version
- 0.1.13
- Updated
- WordPress
- Requires 6.5+
- Tested up to 7.1
- PHP
- Requires 8.1+
- Edition
- Core
- Maintenance
- Active
Overview
SDS Astraport is an administrator-only WordPress utility for exporting and importing Astra and Astra Pro settings.
Instead of writing settings as soon as a file is uploaded, every import goes through a mandatory preflight. Astraport validates the file, determines which settings are recognized by the currently active Astra configuration, identifies anything that will be skipped or treated as informational, and shows the results before any setting is changed.
Astraport supports All Settings, Header, and Footer transfers. It can also read JSON files produced by Brainstorm Force's Astra Import / Export Customizer Settings plugin.
Astra Pro module state is deliberately read-only. Astraport may compare the source site's enabled and disabled modules with the current site, but it never enables or disables Astra Pro modules.
The result is a focused Astra migration tool designed around explicit review, restricted write targets, and predictable behavior.
Features
Mandatory Import Preflight
Every import is validated and reviewed before any Astra setting is written. Astraport shows what can be imported, what will be skipped, and anything that needs attention before you approve the change.
Astra Settings Export
Export Astra configuration as All Settings, Header, or Footer JSON files for migration, backup, or reuse on another Astra site.
Astra-Compatible Imports
Import SDS Astraport files as well as compatible JSON exports created by Brainstorm Force's Astra Import / Export Customizer Settings plugin.
Current-Site Setting Validation
Astraport imports only setting keys recognized by the Astra and Astra Pro configuration currently active on the destination site. Unknown file contents never expand the import allowlist.
Safe Astra Pro Handling
When Astra Pro is active, Astraport can transfer currently recognized Pro settings. When Pro is inactive, unavailable settings are identified and excluded rather than forced into Astra Core.
Read-Only Pro Module Comparison
Astra Pro module states can be compared between the source export and the destination site during preflight. Astraport never enables or disables Astra Pro modules.
Scoped Header and Footer Imports
Header and Footer imports update only settings eligible for the selected scope while preserving unrelated stored Astra settings.
Protected Astra Housekeeping
Internal Astra and Astra Pro migration, update, and queue-tracking values are deliberately excluded so one site's housekeeping state is not transferred to another.
Restricted Write Targets
Imported files cannot choose arbitrary WordPress options. Astraport restricts writes to the supported Astra settings, global color palette, and typography preset option groups.
Verified Import Transactions
Astraport snapshots the affected option groups before an import, verifies the resulting writes, and attempts a verified rollback if the import transaction cannot be completed correctly.
Stale Preflight Protection
If relevant Astra, Astra Pro, module, scope, API, or Astraport conditions change after a preflight is created, the old approval is rejected and a fresh safety review is required.
Clear Preflight Status
A color-classified preflight grid clearly separates informational details, successful checks, warnings, differences, and blocking errors, with accessible explanations for each metric.
Legacy Astraport Compatibility
The current importer supports SDS Astraport v3 files as well as compatible legacy v1 and v2 exports.
Administrator-Only Operation
Astraport requires WordPress administrator-level manage_options permission, with nonce protection applied to import, export, approval, and cancellation actions.
Private by Design
Astraport performs its work inside WordPress with no telemetry, analytics, external API service, or remote requests.
Security & Privacy
SDS Astraport is designed to operate entirely within the WordPress installation.
Access
Astraport requires the WordPress manage_options capability and is intended for administrators. Import, export, confirmation, and cancellation actions use WordPress nonce protection and dedicated admin-post endpoints.
Import trust boundary
Uploading a JSON file never writes settings. The file is validated and converted into a temporary import plan before the administrator is shown the mandatory preflight.
Restricted writes
Astraport can write only these Astra-owned WordPress options:
- astra-settings
- astra-color-palettes
- astra-typography-presetsImported JSON cannot supply an arbitrary WordPress option name. Individual astra-settings keys must also be recognized by the currently active Astra/Astra Pro runtime and permitted by the selected import scope.
Astra Pro module state
Astra Pro module-state information is read-only. Astraport never enables or disables Astra Pro modules.
Preflight protection
Pending import plans use random, user-bound temporary tokens and are retained for no more than 15 minutes. A preflight is invalidated when relevant Astraport, Astra, Astra Pro, API, scope, or module-state conditions change before approval.
Transactional protection
Permitted option states are captured before writing. Writes and the complete final target state are verified. If the transaction cannot be verified, Astraport attempts to restore and verify the original values.
File handling
Imports are limited to 5 MB, require a verified PHP upload temporary file and a .json filename, and undergo strict JSON and structural validation before becoming eligible for preflight.
Privacy
Astraport does not collect telemetry and does not make remote requests. Import data and temporary preflight information remain within the WordPress installation.
Uninstall
Deleting the plugin removes only Astraport's own short-lived preflight transient rows. Astra settings and unrelated WordPress data are not removed.
Technical Details
| Current version | 0.1.13 |
|---|---|
| WordPress requirement | 6.5+ |
| WordPress tested up to | 7.1 |
| PHP requirement | 8.1+ |
| Edition | Core |
| Multisite support | Not tested |
| Maintenance status | Active |
| External-service use | None |
| Telemetry collection | None |
| WordPress | 6.6 or later |
| PHP | 7.4 or later |
| Theme requirement | Astra or an Astra child theme must be active |
| Supported import formats | - SDS Astraport format v3 - Legacy SDS Astraport v1 and v2 exports - Compatible with JSON generated by Brainstorm Force's Astra Import / Export Customizer Settings plugin |
| Supported export scopes | - All Settings - Header - Footer |
| Maximum import file size | 5 MB |
| Permitted WordPress option write targets | - astra-settings - astra-color-palettes - astra-typography-presets |
| Preflight lifetime | Up to 15 minutes, with independent age and environment validation before application. |
| Astra Pro module policy | Informational and comparison-only. Astraport never enables or disables Astra Pro modules. |
| Administration | Requires manage_options. |