=== Hyper PWA - Bringing Modern Progressive Web App Experiences ===
Contributors: amanstacker
Tags: pwa, progressive web apps, offline, add to homescreen, manifest
Donate link: https://www.paypal.com/paypalme/amanstacker
Requires PHP: 7.4
Requires at least: 6.0
Tested up to: 7.0
Stable tag: 5.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Turn your WordPress site into a fast, installable Progressive Web App. Give users a seamless offline experience and native mobile app feel.

== Description ==

**Hyper PWA** transforms your WordPress website into a fast, installable **Progressive Web App (PWA)**. Give your visitors an app-like experience with offline support, Add to Home Screen prompts and many more powerful PWA features.

[Home](https://hyperpwa.com) | [Knowledge Base](https://hyperpwa.com/knowledge-base) | [Help & Support](https://hyperpwa.com/contactus/) | [Testimonials](https://hyperpwa.com/#testimonials) | [Premium](https://hyperpwa.com/premium/)

Built to be lightweight, fast, and flexible, Hyper PWA is designed with performance and ease of use in mind. Most settings can be configured from a modern accordion-based dashboard, keeping everything organized in one place without unnecessary scrolling or popups. Whether you're a beginner or an advanced user, Hyper PWA makes creating a Progressive Web App simple.

If you'd like to see a new feature or integration, please contact us. We're constantly improving Hyper PWA based on community feedback.

== Hyper PWA Core Features ==

* **Convert Your Website into a Progressive Web App (PWA)**: Instantly transform your WordPress website into an installable app that works seamlessly on Android, iPhone, iPad, Windows, macOS, and ChromeOS.
* **App Manifest Generator**: Automatically generate a valid Web App Manifest with complete customization.
* **Offline Mode**: Allow visitors to browse cached pages and assets even without an internet connection.
* **Caching Strategies**: Choose from multiple caching strategies to optimize performance, improve load times, and ensure the best offline experience for your Progressive Web App.
* **Pre Caching**: Cache essential pages and assets in advance so your Progressive Web App loads faster and remains available even when users are offline.
* **UTM Tracking**: Automatically preserve and track UTM parameters for PWA launches, helping you measure campaign performance and user acquisition in your analytics.
* **Connectivity Notice**: Display customizable browser pop-up notifications whenever users go offline or reconnect, keeping them informed about their internet connection status.
* **Start Page**: Choose the page that opens when users launch your Progressive Web App, creating a customized app experience from the very first screen.
* **Custom 404 Page**: Display a custom offline-friendly 404 page when requested content isn't available, providing a better user experience instead of a generic error page.
* **Custom Offline Page**: Display a beautiful offline screen when users lose connectivity.
* **Launch Modes**: Choose between Standalone, Fullscreen, Minimal UI, or Browser mode.
* **Screen Orientation**: Lock your app to Portrait, Landscape, or Auto mode.
* **Excluding from Caching**: Exclude selected pages or file types from offline caching.
* **Screenshots**: Add screenshots to improve the installation experience on supported browsers.
* **Legacy Icons**: Generate and support legacy app icons to ensure compatibility with older browsers, devices, and operating systems.
* **Force Update**: Automatically replace outdated cached files with the latest version, ensuring users always experience the most up-to-date Progressive Web App.
* **Preload App Manifest**: Preload the web app manifest to help browsers discover your Progressive Web App faster, improving installation readiness and launch performance.
* **Cache External Resources**: Cache external assets such as fonts, images, and scripts to improve performance, reduce load times, and enhance offline support.
* **File Serving Method**: Server and hosting configurations vary. If your server doesn't support WordPress rewrite rules or restricts writing files to the root directory, choose the alternative serving method.
* **PWA Health Check**: Monitor your Progressive Web App's health directly from the Hyper PWA dashboard, with instant insights into configuration, compatibility, and potential issues.
* **Multisite Support**: Fully compatible with WordPress Multisite.
* **Export & Import Settings**: Export your Hyper PWA settings for backup, then restore them on the same website or import them into another WordPress site with just a few clicks.
* **One-Click Migration**: Easily migrate your existing Progressive Web App settings from SuperPWA or PWA for WP to Hyper PWA with a single click.
* **Delete Data on Uninstall**: Optionally remove all Hyper PWA plugin data when uninstalling the plugin, leaving no leftover settings or database entries.
* **Performance Optimized**: Lightweight architecture focused on speed and low server overhead.
* **Regular Updates**: Continuous improvements, new features, and compatibility updates.
* **Fast Help & Support**: Our support team is always ready to help.


== Hyper PWA Premium Features ==

Unlock the full potential of your Progressive Web App with **Hyper PWA Premium** and deliver a faster, smarter, and more app-like experience for your visitors.

* **Custom Install App**: Create fully customized install buttons, banners, or triggers to encourage more app installations.
* **Initial Loader**: Display a beautiful loading screen while your app starts for a polished user experience.
* **App Install QR**: Generate a QR code that lets users instantly install your app from any supported device.
* **Bottom Navigation**: Add a native app-style bottom navigation bar for faster and more intuitive browsing.
* **Offline Forms**: Allow users to submit forms even without an internet connection and sync them automatically when back online.
* **Smart Analytics**: Track app installs, launches, user engagement, and other important PWA insights.
* **App Shortcuts**: Provide quick access to important pages directly from the app icon on supported devices.
* **Android APK Builder**: Convert your PWA into an Android APK for easy distribution and publishing on the Google Play Store.
* **Premium Features on Demand**: Request new premium features and enhancements tailored to your needs. We continuously add features based on user feedback and demand.
* **24/7 Priority Support**: Get fast, dedicated support from our team whenever you need assistance.

[Unlock Premium Features](https://hyperpwa.com/premium/)

== Browser Capabilities ==

Hyper PWA is built using modern Progressive Web App (PWA) standards and supports all major browsers that implement Service Workers and the Web App Manifest.

**Fully Supported**
* Google Chrome (Desktop & Android)
* Microsoft Edge (Desktop & Android)
* Samsung Internet
* Brave
* Opera
* Safari (macOS)
* Safari (iPhone & iPad)

**Partially Supported**
* Mozilla Firefox (Offline caching and Service Workers are supported, but native PWA installation experience is limited on desktop.)

**Notes**
* PWA installation is best supported in Chromium-based browsers (Chrome, Edge, Brave, Opera).
* On iPhone and iPad, users can install the app using **Share → Add to Home Screen**.
* Push notifications are supported on Android browsers and on iOS/iPadOS 16.4+ after the app is installed to the Home Screen.
* Some advanced PWA features (such as install prompts, app shortcuts, background sync, and link capturing) vary depending on the browser and operating system.
* Progressive Web Apps require your website to be served over **HTTPS (a secure origin)**.

== Progressive Web App Troubleshooting ==

If your Progressive Web App (PWA) is not working as expected or you don't see the **Install App** or **Add to Home Screen** prompt, try the following:

* Make sure your website is served over **HTTPS**. PWAs require a secure origin (SSL certificate) to enable installation, offline support, and other core features.
* Verify that you are using a **supported browser and device**. PWA installation is best supported in Chromium-based browsers (Chrome, Edge, Brave, Opera). Safari supports installation on iPhone and iPad using **Share → Add to Home Screen**.
* Ensure your **App Icon** is a valid PNG image. For best compatibility, provide at least **192×192 px** and **512×512 px** icons.
* Confirm that your **Web App Manifest** and **Service Worker** are loading correctly and are not blocked by your theme, security plugins, CDN, or server configuration.
* If you are using a CDN or caching plugin, purge all caches after updating your PWA settings.
* Some browsers delay or suppress the install prompt until the website meets all PWA installability requirements and the user has interacted with the site.
* If the issue persists, open a support ticket and include your website URL along with a description of the problem. We'll be happy to help investigate.

== Report Bug or Contribute fix ==

Encounter an issue with Hyper PWA? or wanted to contribute. Kindly visit Hyper PWA repository on [GitHub](https://github.com/amanstacker/hyper-pwa). Please be aware that GitHub is not a support forum, but rather a streamlined platform for effectively addressing and solving problems.


== Support & Documentation ==

For help, documentation, and tutorials, visit our official website:

[Knowledge Base](https://hyperpwa.com/knowledge-base/)
[Help & Support](https://hyperpwa.com/contactus/)

Inside WordPress, you can also go to:  
**Hyper PWA → Support tab**


== Installation ==

1. **Automatic Installation:**
   * Go to **Plugins > Add New** in your WordPress dashboard.
   * Search for **Hyper PWA**.
   * Click **Install Now**, then **Activate** the plugin.

2. **Manual Installation via WordPress:**
   * Download the Hyper PWA ZIP file.
   * Go to **Plugins > Add New** in your WordPress dashboard.
   * Click **Upload Plugin**, select the ZIP file, and click **Install Now**.
   * Activate the plugin after installation.

3. **Manual Installation via FTP:**
   * Extract the Hyper PWA ZIP file.
   * Upload the extracted `hyper-pwa` folder to the `/wp-content/plugins/` directory using an FTP client.
   * Log in to your WordPress dashboard, navigate to **Plugins > Installed Plugins**, and activate **Hyper PWA**.

4. Go to **Hyper PWA** in your WordPress dashboard.
5. Configure your Progressive Web App settings, including the app icon, splash screen, offline mode, install prompt, bottom navigation, shortcuts, and other features.
6. Save your settings and visit your website to enjoy your new Progressive Web App.


== Credits ==

Thanks to rickey29 for creating and maintaining this plugin for many years. We're proud to continue its development.

Hyper PWA uses the following third-party libraries:

2. **Select2** - A jQuery-based replacement for select boxes
   - Link: https://github.com/select2/select2
   - License: MIT


== Frequently Asked Questions ==

= What is Hyper PWA? =

Hyper PWA transforms your WordPress website into a Progressive Web App (PWA). Visitors can install your site on their devices, browse it like a native app, and enjoy features such as offline support, splash screens, app shortcuts, and more.

= Do I need to create separate Android or iOS apps? =

No. Hyper PWA lets you offer an app-like experience directly from your WordPress website without maintaining separate Android or iOS applications.

= Does Hyper PWA support offline browsing? =

Yes. Hyper PWA caches your website assets and can display an offline page when users lose their internet connection, providing a smoother user experience.

= Can users install my website on their device? =

Yes. Hyper PWA enables the Add to Home Screen experience on supported browsers, allowing users to install your website just like a native app.

= Can I customize the app icon and splash screen? =

Absolutely. You can upload your own app icons, configure splash screens, customize the app name, theme colors, startup screen, and other branding options.

= Does Hyper PWA support app shortcuts? =

Yes. You can create custom app shortcuts that appear when users long-press your installed app icon, making it easier to access important pages.

= Can I add a bottom navigation menu? =

Yes. Hyper PWA includes a customizable bottom navigation menu that is displayed only when users open your installed PWA, giving it a true native app feel.

= Is Hyper PWA compatible with my theme and plugins? =

Yes. Hyper PWA is designed to work with most well-coded WordPress themes and plugins without requiring any code changes.

= Will Hyper PWA slow down my website? =

No. Hyper PWA is built with performance in mind. It uses efficient caching strategies and optimized assets to deliver a fast browsing experience.

= Does Hyper PWA work with WooCommerce? =

Yes. Hyper PWA works with WooCommerce websites, allowing your online store to benefit from an installable app experience and offline capabilities where applicable.

= Is Hyper PWA mobile-friendly? =

Yes. Hyper PWA works on Android, iOS, desktop browsers, tablets, and other devices that support Progressive Web Apps.

= Is Hyper PWA free? =

Yes. The core version of Hyper PWA is free to use. A premium version with additional advanced features is also available.

= Where can I report a bug or request a feature? =

You can report bugs, request new features, or get support through any of the following channels:

* WordPress.org Support Forum: https://wordpress.org/support/plugin/hyper-pwa
* Contact Us: https://hyperpwa.com/contactus
* Email Us: support@hyperpwa.com

We actively monitor feedback and regularly release updates with bug fixes, improvements, and new features.


== Screenshots ==

1. coming soon


== Upgrade Notice ==

= 5.0 =
Major update! Hyper PWA has been rebuilt from scratch with a redesigned interface, better performance, and powerful new PWA capabilities.

== Changelog ==

= 5.0 =

* New: Completely rebuilt the plugin from the ground up with an entirely new codebase.
* New: Redesigned the plugin architecture for improved performance, scalability, and maintainability.
* New: Introduced a modern admin interface with an improved user experience.
* New: Added full Progressive Web App (PWA) support, including Web App Manifest generation.
* New: Added Service Worker support for offline functionality and asset caching.
* New: Added customizable install prompts for Android, iOS, and desktop devices.
* New: Added offline fallback page support.
* New: Added customizable splash screen and app icon support.
* New: Added configurable bottom navigation for installed PWAs.
* New: Added support for app shortcuts.
* New: Added startup loader and branding customization.
* New: Added offline message and connectivity detection.
* New: Added advanced caching controls and exclusion rules.
* New: Added comprehensive settings panel with live preview.
* Improved: Significantly enhanced plugin performance and reduced resource usage.
* Improved: Better compatibility with modern WordPress themes and plugins.
* Improved: Enhanced security, coding standards, and overall reliability.
* Removed: Legacy codebase and deprecated functionality from previous versions.