2.3 KiB
Esun Blog Import
Imports the four extracted esun_*_details.json files and their referenced HTML files into Mageplaza Blog.
Deployment
Extract esun.zip directly into var/import, enable the module, and run Magento setup:
bin/magento module:enable Esun_BlogImport
bin/magento setup:upgrade
Validate before importing:
bin/magento esun:blog:import --dry-run
Run the import after validation succeeds:
bin/magento esun:blog:import
The default media location is pub/media/mageplaza/blog/post/uploads. Missing media fails validation by default.
The importer also detects JPG, PNG, and GIF files whose binary data has a different format (for example,
WebP data saved with a .jpg extension). A real import converts these files in place to the format declared
by the extension so Mageplaza can resize them; --dry-run only reports how many require conversion.
Animated WebP data requires ffmpeg, or the WebP command-line tools webpmux and dwebp, on the import host.
--allow-missing-media is available for an intentional partial media migration.
Image and video URLs on esun3d.com or www.esun3d.com, plus source-relative /uploads/... URLs, are rewritten to
Magento media directives under the configured media subdirectory. Media URLs on every other domain are left intact.
Each esun_*_all.json file supplies list-card data. summary is imported into short_description, while imageUrl
is reduced to its local filename and stored as uploads/<filename> in the post image field. Mageplaza resolves and
resizes these covers natively from pub/media/mageplaza/blog/post/uploads.
Use --store-id=<id> to assign posts to a particular store. The default is store ID 0 (all stores).
The importer is idempotent. It identifies imported posts by import_source, merges duplicate JSON entries into one
post with multiple category relations, and refuses to overwrite an unrelated post that uses the same URL key.
Imported posts are enabled, excluded from RSS (in_rss = 0), use the two-column left-sidebar layout
(layout = 2columns-left), and are saved with comments disabled (allow_comment = 0).
The module also changes mageplaza_blog_post.post_content from TEXT to MEDIUMTEXT. Processed HTML is validated
against the 16,777,215-byte MEDIUMTEXT limit before any post is written.