Please have the following ready or already installed.
- Latest version of WordPress installed on your hosting.
- Latest version of the Genesis Framework zip file.
- Your downloaded Mai Theme zip file.
Login to your WordPress website. First, you need to install the Genesis Framework if you haven’t already, and then install your purchased Mai Theme. You will need to activate Mai Theme when you are finished installing.
- In the WordPress menu, click on Appearance > Themes.
- At the top, click on Add New button.
- At the top, click the Upload Theme button.
- Click the Choose File button, and find the file for Genesis on your computer; it will have an ending of “.zip”.
- Click the Install Now button.
- Repeat steps 1-5 with Mai Theme.
- Finally, click the text link Activate next to Mai Theme.
Mai Engine plugin
Mai Theme requires the Mai Engine plugin to power much of its core layout, features, and functionality. Here are some things to understand about our engine plugin.
- The Mai Engine plugin will be automatically installed and activated when any Mai Theme is activated.
- If you activate a theme that doesn’t support Mai Engine, the plugin will automatically deactivate itself.
- 99% of our updates come safely via the Mai Engine plugin. You can simply update as you would any other plugin in WordPress.
Mai Icons plugin
Since Mai Engine version 2.14.0, Mai theme now requires a separate Mai Icons plugin. This is a big plugin that only really contains the thousands of SVG icons available in Mai Icons block and mai_icon shortcode. Since the plugin is so big and so rarely updated, we decided to make it a separate plugin. This helps make the process even quicker every time we have a new update to the Mai Engine plugin.
The Mai Engine plugin is a larger plugin like WooCommerce, Yoast SEO, Gravity Forms, etc. If you run into issues with the engine installation/update process you are likely using a shared hosting account like GoDaddy/Bluehost/HostGator/etc. These hosts typically have a really low PHP timeout set, and the process times out before the engine is done installing. Nothing is actually broken or wrong, there’s just not enough time to install. We’re looking into alternate ways to make this less of an issue in the future.
Here are the steps that should resolve the issue.
1. If the engine partially installed, you’ll need to delete the entire
mai-engine directory from
/wp-content/themes/mai-engine. You can also ask the host to do this.
2. Ask the host to increase your PHP timeout limit. We have yet to hear of any host denying this request.
3. Visit Dashboard > Plugins to trigger the auto-installer. You may have to refresh once. You should see a “Mai Engine installed” notice.
If you are still having trouble, please submit a support request.