Skip to content

Skip plugin onboarding wizards in WooCommerce test-store blueprints - #227

Merged
adamziel merged 2 commits into
WordPress:trunkfrom
alopezari:skip-plugin-onboarding-wizards
Jul 29, 2026
Merged

Skip plugin onboarding wizards in WooCommerce test-store blueprints#227
adamziel merged 2 commits into
WordPress:trunkfrom
alopezari:skip-plugin-onboarding-wizards

Conversation

@alopezari

@alopezari alopezari commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Follow-up to #226. Three of the bundled plugins (Elementor, WPForms, WP Mail SMTP) grab the first wp-admin visit after activation and drop you into their setup wizard. That's exactly what you don't want from a blueprint whose point is landing on a ready-to-use store, so this adds one last runPHP step to both blueprints that marks the wizards as already done.

For Elementor that means setting elementor_onboarded, for WPForms wpforms_setup_wizard_completed, and for WP Mail SMTP wp_mail_smtp_activation_prevent_redirect, plus deleting each plugin's activation-redirect transient. The step has to run after the activation step because WPFORMS_VERSION only exists once the plugin is active. Nothing is removed: the wizards are still reachable from each plugin's menu, they just stop auto-launching.

This also adds the screenshots for both blueprints. The screenshot workflow doesn't run on fork PRs, so #226 merged without them and both stores show the "no screenshot" placeholder in the gallery.

Testing

  • A/B tested the WPForms path with @wp-playground/cli: a minimal blueprint that installs and activates wpforms-lite the same way these do renders "WPForms Setup Wizard" on the first /wp-admin/ load. With the new step, the same request renders the normal dashboard.
  • npm run validate:pr-blueprints passes for both blueprints.

🤖 Generated with Claude Code

Elementor, WPForms, and WP Mail SMTP hijack the first wp-admin visit
with their onboarding wizards after activation. Mark the wizards as
completed and delete the activation-redirect transients so the site is
ready to use immediately after provisioning.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions

github-actions Bot commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Test using WordPress Playground

The changes in this pull request can be previewed and tested using a WordPress Playground instance.

WordPress Playground is an experimental project that creates a full WordPress instance entirely within the browser.

Some things to be aware of

  • All changes will be lost when closing a tab with a Playground instance.
  • All changes will be lost when refreshing the page.
  • A fresh instance is created each time one of the links below is clicked.

For more details about these limitations and more, check out the Limitations page in the WordPress Playground documentation.

Blueprint previews

@adamziel
adamziel merged commit 8d0b3bc into WordPress:trunk Jul 29, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants