Skip to content
Site Management Core

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-presets

    Imported 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 version0.1.13
WordPress requirement6.5+
WordPress tested up to7.1
PHP requirement8.1+
EditionCore
Multisite supportNot tested
Maintenance statusActive
External-service useNone
Telemetry collectionNone
WordPress6.6 or later
PHP7.4 or later
Theme requirementAstra 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 size5 MB
Permitted WordPress option write targets- astra-settings - astra-color-palettes - astra-typography-presets
Preflight lifetimeUp to 15 minutes, with independent age and environment validation before application.
Astra Pro module policyInformational and comparison-only. Astraport never enables or disables Astra Pro modules.
AdministrationRequires manage_options.

Changelog

Version 0.1.13

Current

Version 0.1.12