Better WordPress Theme Onboarding with Merlin WP

An upcoming WordPress theme setup wizard aimed at addressing the tedious WordPress theme onboarding process.

A shot of the Merlin WP theme setup wizard, coming soon.

You get one chance to make a fantastic first impression. Just one. WordPress itself isn’t particularly known for its first impressions, and WordPress themes in general are notoriously difficult to get rolling.

Sure, it’s easy to install WordPress and upload a theme. But what happens next? Why not make this first impression blow the user away, offering a simple, intuitive, and clever interface to help them get started?

Introducing Merlin WP

Merlin WP is my stab at addressing the tedious and exhausting WordPress theme setup and onboarding process. It makes installing a new WordPress theme, its recommended WordPress plugins, Customizer settings, widgets, and demo content, an exciting and gratifying user experience.

A while back, David Baker created a clever setup wizard class (Github), inspired by the WooCommerce welcome wizard. While it’s a solid move in the right direction, I wanted to build an onboarding wizard that was even more refined.

So I did.

A quick demo of Merlin WP in action

And while I originally developed Merlin WP as a side-project to exclusively include in my own theme catalog, I soon pivoted and committed to building the class to be easily deployed within most WordPress themes.

How does Merlin WP work?

I’m building Merlin WP to be added directly into theme files. Once added, you need to include the class, the merlin-config.php file and then your own demo content files (content, widgets & Customizer data).

The configuration file makes it easy to customize any text string throughout Merlin WP, as well as set the class directory and demo content locations.

The configuration file makes it easy to extend/customize Merlin WP

And if you have TGMPA included in your theme, Merlin WP will “just work” with it, pulling the recommended plugins right into the wizard.

I’m also working in support for EDD Software Licensing, which I use to power my own WordPress shop, so that users can activate their license key during the onboarding phase.

Why did I build Merlin WP?

There are a few WordPress plugins currently available, such as One Click Demo Import (OCDM), which import content well, but leave the user experience with quite a bit of room for improvement.

Even with an OCDM compatible WordPress theme, the user is required to install OCDM (likely using TGM Plugin Activation), navigate to the OCDM admin page, and then run the importer.

But wait, let’s backtrack to TGMPA. Now there’s another process added to the mix. The user needs to perform a plugin install and activation process to get any other recommended WordPress plugins ready to go. Sure, TGMPA makes the process of downloading, installing, and activating plugins simple-ish, but it has a convoluted approach that is not particularly user friendly.

Let’s not forget, any custom post type plugins not installed — will not be imported.

Now, if your theme is not compatible with OCDM (or any other importer), then the process is compounded. You’re locating XML files, installing and running the WordPress importer, Customizer Export/Import, and Widget Export/Import plugins, and then setting the home and blog pages.

That’s not easy for any user, not just beginners.

When will Merlin WP be available?

I’m working on the finishing touches, EDD Software Licensing support and a few odds and ends, but I’m shooting for the end of August.

I’ll be reaching out about beta testing Merlin WP as well, so if you’re interested click here to subscribe.

In Closing

Merlin WP is my stab at dramatically improving the WordPress theme onboarding experience. I’m really excited about how easy Merlin WP makes installing and setting up WordPress themes — it’s really “next-level.”

Hit me up on Twitter, or email me directly if you have any questions!


Originally published on my WordPress development blog.