Screenshots

WP to PWA App converts your WordPress site into a Progressive Web App that your visitors can install on their phones and use offline. No theme edits, no fragile hacks, just a clean manifest, a smart service worker, and a builder-friendly settings screen.

What it does

Installable app experience. Generates /manifest.webmanifest and registers a service worker at /wp2pwa-sw.js, so browsers can “Add to Home Screen”.
Fast and resilient. HTML uses a network-first strategy with an offline fallback page; static assets use cache-first for snappy loads.
Control what’s available offline. Per-page meta box (“Available offline”) plus route allowlist/denylist so you decide what’s cached.
WooCommerce-safe by default. Cart, checkout, account, add-to-cart, and wc-ajax are excluded from caching to keep sessions and orders safe.
Install UI you can place anywhere. Shortcode [wp2pwa_install] renders a banner or a compact button—now with alignment, width, and device targeting (devices="mobile|desktop|all"). iOS “Add to Home Screen” helper can be enabled/disabled from settings.
Update flow that makes sense. A “Clear PWA cache / Force update” button bumps the cache version. Visitors see a small update toast; the app refreshes cleanly.
Offline page you control. Provide your own HTML for the offline state—brand it, add links, or keep it minimal.
Diagnostics built in. One glance shows HTTPS, permalinks, endpoint reachability, and whether the service worker is active.

Why it’s different

Builder-first workflow. Every decision that normally requires theme edits is a checkbox or text field. Drop the install UI via shortcode where design needs it.
Safe out of the box. Respects Cache-Control: no-store, never touches /wp-admin, login, or REST by default, and only caches same-origin requests.
Woo or no Woo. Works fine without WooCommerce; when Woo is active, the plugin automatically applies the right exclusions.

What you get out of it

Faster repeat visits and better Lighthouse PWA scores
App-like UX your audience can pin next to their native apps
More resilient content that still works when the network doesn’t

Changelog:

# Changelog
All notable changes to this project will be documented in this file.

## [1.0.0] - 2025-08-10
### Added
- PWA master switch (enable/disable).
- Root endpoints: /manifest.webmanifest and /wp2pwa-sw.js.
- Manifest generator: name, short_name, description, start_url, scope, display, orientation, theme/background colors, icons (Site Icon + fallbacks).
- Service Worker: network-first for HTML (offline fallback) + cache-first for static assets.
- Route controls: allowlist & denylist.
- Woo-safe exclusions: auto-detect cart/checkout/account when Woo exists; safe defaults when it doesn’t.
- Per-page “Available Offline” meta box for public post types.
- Custom offline page (HTML) setting.
- Update flow: cache version bump button, “new version available” toast (skipWaiting + auto-reload).
- Install UI shortcode: [wp2pwa_install] (banner/button) with iOS “Add to Home Screen” hint.
- Diagnostics panel (HTTPS, permalinks, endpoint reachability, statuses).
- i18n: text domain, languages folder, localized strings, manifest lang from site locale.
- Admin/Frontend assets (CSS/JS), no theme edits.
- Security: bypass admin/auth, respect no-store, same-origin only, block Woo/query actions.

### Changed
- Default “custom install prompt” (toast) is disabled by default.

### Fixed
- WooCommerce calls guarded (no fatals when Woo isn’t installed; no IDE warnings).

## [1.0.1] - 2025-08-11
### Added
- iOS “Add to Home Screen” helper **toggle** in settings; shortcode respects it.
- Shortcode options: `align` (left|center|right), `width` (auto|full), `hide_later`, `class`.
- Shortcode visibility control: `devices` attribute (`mobile` default | `desktop` | `all`) → mobile/tablet only by default.
- “Install UI Shortcode” help card in settings (usage + attributes).
- “Support & Custom Work” card with contact links.

### Changed
- Admin settings page: all outputs/URLs escaped; replaced custom `wp2pwa_checked()` with core `checked()`.
- Shortcode markup: improved ARIA + disabled-state handling.

### Fixed
- Manifest icons are added only if the files exist (or Site Icon is set) to avoid 404 / “not a valid image”.
- Shortcode iOS helper modal: “Got it” button now closes reliably (event delegation + ARIA toggles).
- Shortcode no longer renders on disallowed devices per `devices` attribute.

## [1.0.2] - 2025-09-16
### Added
- **Separate “Install Prompt (Popup)” card** — fully independent from the shortcode and controlled by the master switch.
- **Popup targeting:** devices (`mobile|desktop|all`) and **page selection** (multi-select of Pages).
- **Popup styling:** theme (`dark|light`), position (`bottom-right|bottom-left|top`), and **delay** (seconds).
- **CSS Hooks & Custom CSS**: admin card listing all classes/IDs + optional sitewide Custom CSS textarea.
- **Base UI styles** for popup/shortcode (`assets/install.css`) and new localized strings (“Install”, “Later”).

### Changed
- **Frontend JS refactor:** popup logic split from shortcode, runs only when `beforeinstallprompt` is available, and respects device/page gates.
- **Sanitization:** page IDs sanitized; options validated; styles enqueued only when needed.

### Fixed
- Popup no longer depends on shortcode rendering or its attributes.
- Prevented duplicate popup renders and ensured reliable open/close behavior.