Atlas Shopify Blueprint Developer Notes

The Atlas Shopify Blueprint stores configuration in an Atlas Content Modeler Blueprint zip file.

These files are exported from a WordPress installation where the Atlas Content Modeler plugin is installed using WP-CLI:

• wp acm blueprint export generates the zip file to save the state of the WP site.
• wp acm blueprint import [path-or-url] imports a zip file to restore the WP site state.

To update the blueprint zip file

The acm-blueprint.zip file in the repo root is fetched by Local and Atlas when creating new sites based on this blueprint.

To update the blueprint:

1. Create a fresh site in Local or your favourite dev environment.
2. Choose “Open Site Shell” to open a terminal and run WP CLI commands.
3. Install required plugins:

   wp plugin install --activate atlas-content-modeler faustwp wp-graphql
   

4. Clear default posts and pages:

   wp acm reset --yes --all
   

5. Import the current shopify blueprint directly from the main branch:

   wp acm blueprint import https://github.com/wpengine/atlas-shopify-blueprint/raw/main/acm-blueprint.zip
   

6. Make any changes to your WordPress site manually.
7. Make the new template:

   wp acm blueprint export --open --min-wp=5.9.2 --min-acm=0.15.0 --wp-options=category_base,permalink_structure,nav_menu_options,theme_mods_twentytwentythree,current_theme,stylesheet,template,page_on_front,show_on_front --post-types=nav_menu_item,page
   

8. Replace the acm-blueprint.zip file in this repo with the one that opens in the Finder window.
9. Commit your changes.

To test the blueprint zip file

1. Copy the local path to your blueprint zip file. (On macOS, select the file in the Finder and press ⌘C to copy the path to your clipboard.)
2. In WP-CLI, run wp acm blueprint import [path you copied in step 1]