From 4f796834e946897ffea87ee188a8c3caa3cb09d1 Mon Sep 17 00:00:00 2001 From: David Stone Date: Fri, 15 May 2026 14:12:42 -0600 Subject: [PATCH] docs: Add Hostinger integration and network import bundle documentation for v2.12.0 --- docs/user-guide/administration/site-export.md | 33 +++++ .../getting-started/release-notes.md | 12 ++ .../user-guide/host-integrations/hostinger.md | 135 ++++++++++++++++++ sidebars.js | 35 ++--- 4 files changed, 198 insertions(+), 17 deletions(-) create mode 100644 docs/user-guide/host-integrations/hostinger.md diff --git a/docs/user-guide/administration/site-export.md b/docs/user-guide/administration/site-export.md index d4c941c6dc..4e3d9420a7 100644 --- a/docs/user-guide/administration/site-export.md +++ b/docs/user-guide/administration/site-export.md @@ -19,6 +19,39 @@ Use **Network Export** on the Site Export page when you need a single archive co Because a network export can be much larger than a single-site export, run it during a low-traffic window and confirm the target storage has enough free space for uploads, plugins, themes, and generated ZIP files. +### Network Import Bundles + +Starting with Ultimate Multisite 2.12.0, Site Exporter can generate **network import bundles** — specialized archives designed for streamlined network-wide site restoration. A network import bundle contains all the necessary files and metadata to restore multiple sites to a new network installation. + +#### Generating a Network Import Bundle + +1. Go to **Ultimate Multisite > Site Export** +2. Click **Generate new Network Export** +3. Select **Network Import Bundle** as the export type +4. Choose whether to include uploads, plugins, and themes +5. Click **Generate** +6. Download the bundle ZIP from the **Existing Exports** list + +#### Restoring from a Network Import Bundle + +To restore sites from a network import bundle: + +1. Install Ultimate Multisite on your target host +2. Complete the multisite setup wizard +3. Go to **Ultimate Multisite > Site Export** on the new network +4. Click **Import Network Bundle** +5. Upload the network import bundle ZIP file +6. Follow the on-screen import instructions +7. The import process will restore all sites, their content, and configurations + +Network import bundles preserve: +- Site content (posts, pages, custom post types) +- Site settings and options +- User roles and permissions +- Plugins and themes (if included in the bundle) +- Media uploads (if included in the bundle) +- Custom database tables and data + ## Installing a self-booting export ZIP To restore a self-booting ZIP on a fresh host: diff --git a/docs/user-guide/getting-started/release-notes.md b/docs/user-guide/getting-started/release-notes.md index d34a57ef79..e32d50f89e 100644 --- a/docs/user-guide/getting-started/release-notes.md +++ b/docs/user-guide/getting-started/release-notes.md @@ -5,6 +5,18 @@ sidebar_position: 9 # Release Notes +## Version 2.12.0 — Released on 2026-05-15 + +- New: Added Hostinger (hPanel) as a supported host provider with domain mapping integration +- New: Site Exporter now handles network import bundles for streamlined network-wide site restoration +- Fix: BCC broadcast emails now use an undisclosed-recipients header to prevent exposing recipient addresses +- Fix: Membership expiration date is no longer corrupted when saving with a non-date value +- Fix: Stripe membership updates now correctly clear discounts without calling the deprecated deleteDiscount API +- Fix: SSO redirects on domain-mapped sites are now capped to prevent infinite redirect loops +- Fix: Setup wizard image picker selection now correctly updates the underlying data model +- Fix: Site Exporter CLI now preserves the correct default network site selection +- Improved: Removed bundled wp-cli from the plugin package, reducing plugin size + ## Version 2.11.0 — Released on 2026-05-11 - New: Site exports now bundle a self-booting `index.php` so the ZIP can be installed on a fresh host without a separate plugin install. diff --git a/docs/user-guide/host-integrations/hostinger.md b/docs/user-guide/host-integrations/hostinger.md new file mode 100644 index 0000000000..b6a741567d --- /dev/null +++ b/docs/user-guide/host-integrations/hostinger.md @@ -0,0 +1,135 @@ +--- +title: "Hostinger (hPanel) Integration" +sidebar_position: 7 +--- + +# Hostinger (hPanel) Integration + +## Overview + +Hostinger is a popular web hosting provider with a modern control panel called hPanel. The Ultimate Multisite Hostinger integration enables automatic domain syncing between Ultimate Multisite and Hostinger's hPanel, allowing you to automatically manage domain mappings and subdomains directly from your WordPress admin. + +## Features + +- Automatic addon domain creation in hPanel +- Automatic subdomain creation in hPanel (for subdomain multisite installations) +- Domain removal when mappings are deleted +- Seamless integration with hPanel's domain management API + +## Requirements + +To use the Hostinger integration, you need: + +1. A Hostinger account with hPanel access +2. An API token from Hostinger +3. The following constants defined in your `wp-config.php` file: + +```php +define('WU_HOSTINGER_API_TOKEN', 'your_hostinger_api_token'); +define('WU_HOSTINGER_ACCOUNT_ID', 'your_hostinger_account_id'); +``` + +Optionally, you can also define: + +```php +define('WU_HOSTINGER_API_URL', 'https://api.hostinger.com/v1'); // Default API endpoint +``` + +## Setup Instructions + +### 1. Generate Your Hostinger API Token + +1. Log in to your Hostinger account and access hPanel +2. Navigate to **Account Settings** → **API Tokens** +3. Click **Create New Token** +4. Give your token a descriptive name (e.g., "Ultimate Multisite") +5. Select the necessary permissions: + - Domain management + - Subdomain management +6. Copy the generated token and store it securely + +### 2. Find Your Account ID + +1. In hPanel, go to **Account Settings** → **Account Information** +2. Your Account ID is displayed on this page +3. Copy and save this ID for the next step + +### 3. Add Constants to wp-config.php + +Add the following constants to your `wp-config.php` file: + +```php +define('WU_HOSTINGER_API_TOKEN', 'your_hostinger_api_token'); +define('WU_HOSTINGER_ACCOUNT_ID', 'your_hostinger_account_id'); +``` + +If your Hostinger account uses a different API endpoint, you can customize it: + +```php +define('WU_HOSTINGER_API_URL', 'https://api.hostinger.com/v1'); +``` + +### 4. Enable the Integration + +1. In your WordPress admin, go to **Ultimate Multisite > Settings** +2. Navigate to the **Domain Mapping** tab +3. Scroll down to **Host Integrations** +4. Enable the **Hostinger (hPanel)** integration +5. Click **Save Changes** + +## How It Works + +### Addon Domains + +When you map a domain in Ultimate Multisite: + +1. The integration sends a request to Hostinger's API to add the domain as an addon domain +2. The domain is configured to point to your root directory +3. When a domain mapping is removed, the integration automatically removes the addon domain from hPanel + +### Subdomains + +For subdomain multisite installations, when a new site is created: + +1. The integration extracts the subdomain part from the full domain +2. It sends a request to Hostinger's API to add the subdomain +3. The subdomain is configured to point to your root directory + +## Important Notes + +- The integration uses Hostinger's REST API to communicate with your account +- Your API token must have the necessary permissions for domain and subdomain management +- The integration does not handle DNS configuration; domains must already be pointed to your Hostinger account +- API requests are made securely over HTTPS +- Keep your API token secure and never share it publicly + +## Troubleshooting + +### API Connection Issues + +- Verify that your API token is correct and has not expired +- Check that your Account ID is correct +- Ensure that your API token has the necessary permissions for domain management +- Verify that your Hostinger account is active and in good standing + +### Domain Not Added + +- Check the Ultimate Multisite logs for any error messages +- Verify that the domain is not already added to your Hostinger account +- Ensure that your Hostinger account has not reached its limit for addon domains +- Confirm that the domain is properly pointed to your Hostinger nameservers + +### SSL Certificate Issues + +- The integration does not handle SSL certificate issuance +- Hostinger typically provides free SSL certificates through AutoSSL +- You can manage SSL certificates directly in hPanel under **SSL/TLS** +- Alternatively, use Let's Encrypt with Hostinger's AutoSSL feature + +## Support + +For additional help with the Hostinger integration, please refer to: + +- [Hostinger API Documentation](https://support.hostinger.com/en/articles/4286-api-documentation) +- [Ultimate Multisite Documentation](/docs) +- [Ultimate Multisite Support](https://ultimatemultisite.com/support) diff --git a/sidebars.js b/sidebars.js index bd53963ddf..738df221df 100644 --- a/sidebars.js +++ b/sidebars.js @@ -69,23 +69,24 @@ const sidebars = { 'user-guide/domain-seller/checkout-and-dns', ], }, - { - type: 'category', - label: 'Host Integrations', - items: [ - 'user-guide/host-integrations/closte', - 'user-guide/host-integrations/cloudflare', - 'user-guide/host-integrations/cloudways', - 'user-guide/host-integrations/cpanel', - 'user-guide/host-integrations/enhance', - 'user-guide/host-integrations/gridpane', - 'user-guide/host-integrations/hestia', - 'user-guide/host-integrations/runcloud', - 'user-guide/host-integrations/serverpilot', - 'user-guide/host-integrations/wp-engine', - 'user-guide/host-integrations/wpmu-dev', - ], - }, + { + type: 'category', + label: 'Host Integrations', + items: [ + 'user-guide/host-integrations/closte', + 'user-guide/host-integrations/cloudflare', + 'user-guide/host-integrations/cloudways', + 'user-guide/host-integrations/cpanel', + 'user-guide/host-integrations/enhance', + 'user-guide/host-integrations/gridpane', + 'user-guide/host-integrations/hestia', + 'user-guide/host-integrations/hostinger', + 'user-guide/host-integrations/runcloud', + 'user-guide/host-integrations/serverpilot', + 'user-guide/host-integrations/wp-engine', + 'user-guide/host-integrations/wpmu-dev', + ], + }, { type: 'category', label: 'Payment Gateways',