Skip to content

Installation

This guide walks you through installing and activating MIDDAG Account on your WordPress site.

Before you start

Make sure your environment meets all requirements. In particular:

  • PHP 8.4+ is running on your server
  • WordPress 6.5+ is installed
  • WooCommerce 9.0+ is installed and activated

Use a staging site first

We strongly recommend installing on a staging or test site before your production environment. This lets you explore the plugin and verify compatibility with your existing plugins and theme.

Step 1: Upload the plugin

  1. Download the MIDDAG Account plugin ZIP file
  2. In your WordPress admin, go to Plugins > Add New Plugin
  3. Click Upload Plugin at the top of the page
  4. Click Choose File and select the ZIP file you downloaded
  5. Click Install Now
  6. Wait for WordPress to finish extracting and installing the plugin

Alternatively, if you have SFTP or file manager access:

  1. Extract the ZIP file on your computer
  2. Upload the middag-account folder to /wp-content/plugins/ on your server
  3. The final path should be /wp-content/plugins/middag-account/middag-account.php

Step 2: Activate the plugin

  1. Go to Plugins > Installed Plugins
  2. Find MIDDAG Account in the list
  3. Click Activate

On activation, MIDDAG Account will:

  • Register its custom post types in the database
  • Set up required database tables and options
  • Create default capabilities and roles
  • Register its REST API endpoints

Step 3: Verify the installation

After activation, confirm everything is working:

  1. Check the sidebar. You should see a new MIDDAG Account menu item in the WordPress admin sidebar.
  2. Open the dashboard. Click MIDDAG Account to open the admin interface. You should see the main dashboard loading without errors.
  3. Check Site Health. Go to Tools > Site Health and verify there are no critical issues related to MIDDAG Account.

First time?

If this is a fresh installation, proceed to Initial Setup to configure your business entity and create your first organization.

Troubleshooting

"MIDDAG Account requires PHP 8.4 or higher"

Your server is running an older PHP version. You need to upgrade PHP before activating the plugin.

How to fix:

  • Check your hosting control panel (cPanel, Plesk, or similar) for a PHP version selector
  • If you use managed WordPress hosting, contact your provider to request PHP 8.4
  • Verify the change at Tools > Site Health > Info > Server > PHP Version

"MIDDAG Account requires WooCommerce 9.0 or higher"

WooCommerce is either not installed, not activated, or running a version below 9.0.

How to fix:

  • Go to Plugins > Installed Plugins and make sure WooCommerce is active
  • If WooCommerce is active but outdated, update it to 9.0 or higher via Plugins > Updates
  • After updating WooCommerce, try activating MIDDAG Account again

Plugin activates but sidebar menu is missing

This usually means a conflict with another plugin or a permissions issue.

How to fix:

  1. Make sure you are logged in as an Administrator (not Editor or Shop Manager)
  2. Try deactivating other plugins one at a time to identify conflicts
  3. Switch to a default WordPress theme (like Twenty Twenty-Five) temporarily to rule out theme conflicts
  4. Check Tools > Site Health for any critical issues

White screen or fatal error on activation

This typically indicates a PHP memory or compatibility issue.

How to fix:

  1. Increase PHP memory limit to at least 256 MB (edit wp-config.php and set define('WP_MEMORY_LIMIT', '256M');)
  2. Check your server error log (usually at /var/log/ or accessible through your hosting panel) for the specific error
  3. Verify all required PHP extensions are installed
  4. If the error mentions a specific extension (e.g., ext-intl), ask your hosting provider to enable it

Admin UI shows a blank page or JavaScript errors

The React-based admin interface requires a modern browser.

How to fix:

  • Make sure you are using Chrome 90+, Firefox 90+, Edge 90+, or Safari 15+
  • Clear your browser cache and reload the page
  • Check that no browser extensions (ad blockers, script blockers) are interfering
  • Open the browser developer console (F12) and check for error messages

Updating the plugin

When a new version is available:

  1. Download the updated ZIP file
  2. Go to Plugins > Add New Plugin > Upload Plugin
  3. Upload the new ZIP file
  4. WordPress will prompt you to replace the existing version — confirm and proceed
  5. Re-activate if necessary

MIDDAG Account handles database migrations automatically on update. Your data is preserved during version upgrades.

Uninstalling

If you need to remove MIDDAG Account:

  1. Go to Plugins > Installed Plugins
  2. Deactivate MIDDAG Account first
  3. Click Delete to remove the plugin files

Data removal

Uninstalling the plugin removes its files but your data (organizations, entitlements, orders, etc.) remains in the WordPress database. This is by design — your business data is not deleted accidentally. To fully remove all data, use the cleanup option in MIDDAG Account > Settings before deactivating.

Next steps