Merlin WP 1.0 is Here. Welcome Better Onboarding for WordPress Themes

Merlin WP 1.0 is Here. Welcome Better Onboarding for WordPress Themes

You have no idea how awesome it feels to finally have the first official version of Merlin WP released. After many months of development, Merlin WP 1.0 is finally here. I first wrote about improving the onboarding experience of WordPress themes late last year, and since publishing the initial beta, Merlin WP has received quite a lot of attention.

As of this writing, there are 352 stargazers on the GitHub repository, countless articles written about Merlin WP, and a wide array of themes that have implemented better onboarding for their users – including my own.

Merlin WP 1.0 is finally here. Welcome better onboarding for WordPress themes.

You see, nearly everyone has the same struggle when installing a new WordPress theme: how to get up and running. It doesn’t matter how versed you are with WordPress, novices and experts alike often struggle with replicating a WordPress theme based off of its live demo.

But this doesn’t have to be the case.

Activating the Tabor WordPress theme with Merlin WP

As a WordPress theme wrangler at ThemeBeans, I knew solving this problem would save me countless hours helping folks install plugins, deploy child themes, import demo content, set up widgets, assign menus, roll out Customizer settings and then finally creating and assigning both the front and blog pages. 

That’s a lot to do. In fact, it’s too much to do. And for most people, it’s confusing, time consuming and not exactly a pleasant experience.

That’s where Merlin WP fits in. ?‍♂️

A collective effort

Publicly releasing Merlin WP has shown me the true value of open source and how together, we can build something truly game-changing. On my own, I could not have personally committed the time it took to make Merlin WP as impressive as it is.

Since the projects inception, we’ve had 397 commits from 14 contributors, many of which were from the fine folks at ProteusThemes. I wrote about their contribution to the wizard earlier this year, but in short — they baked their One Click Demo Import plugin functionality into Merlin WP. That’s big.

Activating the Tabor WordPress theme with the Easy Digital Downloads Software Licensing add-on
Activating themes with the EDD Software Licensing add-on

Along with the superior content importer, we’ve added improved accessibility, support for a theme licensing activation step via Easy Digital Downloads, selective plugin installs, and a whole slew of interface improvements that touch on nearly every aspect of the wizard.

Decreased support burdens

Since rolling out Merlin WP on most of my WordPress themes, I’ve personally experienced a substantial drop in support tickets related to setting up a WordPress theme. 

Chris Robinson of Contempo Creative Inc, has been using Merlin WP since mid-March — and he’s loving the new wizard.

Here’s what he has to say about Merlin WP:

Integrating Merlin WP has removed all the unnecessary noise by simplifying the theme setup into a few easy to understand steps. It has cut my support down immensely and my customers absolutely love it.

Chris Robinson

Not only is Merlin WP saving a lot of time for developers like Chris and I, the wizard is saving our customers even more time.

Contributing to Merlin WP

Merlin WP wouldn’t be what it is today without the support of the fantastic WordPress community. If onboarding is a passion of yours and/or you sell WordPress themes, we could always use a hand making the wizard better.

You can contribute to Merlin WP on GitHub. And if you’re using the wizard in your projects, tell me about it in the comments below. I truly enjoy discovering how folks are using my projects in the wild. Cheers!

        1. Hi Regis, I don’t have a directory of Merlin WP enabled themes, but that’s a good idea! I’ll reach out to folks to see if I can get one started. In my catalog, I have York Pro, Tabor, Pinto, Snazzy and Stash running the wizard, with the others following closely behind.

  1. This is a great news, Rich, thank you!
    I have additional questions:

    1. Is this compliant with free repository theme guidelines/review process? Would the theme with Merlin be accepted into repository?

    2. If user decides to skip Merlin steps, will he/she be able to additionally run them later? For example, user skips demo content installation, but later would like to install the demo content, will this be possible?

    3. If user skips installing plugins (that are required for demo content) will demo content step be presented?

    Thanks for answers in advance.

    1. Thanks Oliver! Here are some answers:

      1. It’s actually not as the wizard currently shows up right after an activation. We could however probably port it as a standalone plugin and ask users to install/activate the plugin — then run the wizard. But then we’re adding another step to the process…

      2. Currently, if you get all the way to the end, you won’t be able to go back to the wizard.

      3. Yes, A theme’s demo content isn’t tied to the activated plugins. ?

  2. Looks fantastic! Really good job with the UX & UI. Can you guide me where is the licensing logic in the code? I’d like to see the complexity of optionally integrating Freemius licensing.

  3. Hi Rich,

    I am glad that the first version of Merlin WP is released, I was eagerly waiting for this, going to try this now. By the way, can we have a tutorial on how to integrate Merlin WP with a WordPress theme?

    Thank you

  4. I’m a stargazer, and I’ve been following the repo for a while. Love it!

    Will Merlin remain free and open source? Or will there be some sort of commercial license?

Leave a Reply

Your email address will not be published. Required fields are marked *

Up Next:

Tabor and Gutenberg + WordPress 5.0

Tabor and Gutenberg + WordPress 5.0