Importing from Bludit

The Bludit import reads an extracted Bludit installation from the local filesystem. It can target the root site or an author space.

The source directory must contain the expected Bludit bl-content data. The browser accepts a server-local path; it does not upload a ZIP file or fetch a remote site.

Imported data

The importer reads supported posts and pages, publication state, timestamps, page order, and page hierarchy. Local files under bl-content/uploads/ are imported through the normal media service. Internal source links are rewritten when they resolve to imported content.

Comments, plugin data, theme settings, and broader Bludit configuration are not imported.

Targets and replacement

An author can import only into their own author space. A superadmin can choose the root site or another existing account, including an account with sign-in disabled.

The post and page replacement options are independent. Each enabled option deletes every existing entry of that type in the selected target before import.

CLI

Preview a root import:

php8.4 bin/tinymash.php bludit-import preview /path/to/bludit --root

Preview an author-space import:

php8.4 bin/tinymash.php bludit-import preview /path/to/bludit --author=cajo

Replace preview with import after checking the report. Use bludit-import --help for replacement, unpublished-entry, batch, retention, and lock options.

Check the result

Verify the page tree, page order, public paths, publication state, dates, internal links, localized images, and every skipped or missing-media item in the final report.