Installing Hyper PWA On A Multisite Environment

Introduction

This documentation provides step-by-step instructions on how to install and configure the Hyper PWA plugin on a WordPress Multisite environment. This guide is intended for network administrators and site owners who want to enable Progressive Web App (PWA) functionality across multiple websites in a WordPress Multisite network.

---

Prerequisites

Before installing the Hyper PWA plugin on a WordPress Multisite setup, ensure that:

• You have a WordPress Multisite Network configured.
• You have Super Admin privileges.
• You have access to the server via FTP or cPanel for manual installations (if needed).
• Your WordPress version is compatible with the Hyper PWA plugin.

---

Installation Steps

1. Install the Plugin

You can install the Hyper PWA plugin either via the WordPress dashboard or manually.

Using the WordPress Dashboard:

1. Log in to your WordPress Network Admin dashboard.
2. Navigate to Plugins > Add New.
3. Search for Hyper PWA.
4. Click Install Now and then Activate.

Manual Installation (via FTP or cPanel):

1. Download the Hyper PWA plugin ZIP file from the official website or WordPress.org.
2. Extract the ZIP file on your local machine.
3. Use an FTP client (such as FileZilla) or cPanel to upload the extracted folder to the /wp-content/plugins/ directory.
4. Go to Network Admin > Plugins and click Network Activate to enable Hyper PWA across the entire multisite network.

---

Configuration

Network Activation

• After activation, go to Network Admin > Plugins and ensure the Hyper PWA plugin is enabled for all subsites.
• If you want individual site administrators to manage PWA settings independently, activate the plugin on each site instead of using network activation.

Setting Up PWA Features

1. Navigate to Settings > Hyper PWA in the Network Admin dashboard.
2. Configure global Progressive Web App settings such as the Web App Manifest, Service Worker, offline functionality, install prompt, icons, and theme colors.
3. If individual subsites require different PWA configurations, allow site administrators to customize their own Hyper PWA settings.

Permissions & Role Management

• By default, only Super Admins can manage network-wide Hyper PWA settings.
• Site Admins can configure PWA settings for their own websites if the appropriate permissions are granted.

---

Troubleshooting

Common Issues & Fixes

• Plugin Not Appearing in Subsites: Ensure the plugin has been Network Activated.
• PWA Features Not Working: Clear your browser cache and verify that the Service Worker has been successfully registered.
• Install Prompt Not Appearing: Confirm that your website meets the Progressive Web App installation requirements, including HTTPS and a valid Web App Manifest.
• Permissions Issues: Verify that site administrators have the required capabilities to manage Hyper PWA settings.

---

Uninstallation

To remove the Hyper PWA plugin from your WordPress Multisite Network:

1. Navigate to Network Admin > Plugins.
2. Deactivate the Hyper PWA plugin.
3. Click Delete to remove it completely.
4. If desired, remove any remaining Hyper PWA configuration data from your database.