=== Tecveq PWA Toolkit ===
Contributors: tecveq
Tags: pwa, progressive-web-app, offline, workbox, service-worker
Requires at least: 5.4
Tested up to: 7.0
Stable tag: 4.3.1
Requires PHP: 7.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn your WordPress site into a high-performance Progressive Web App (PWA) with Workbox offline caching, native install prompts, and mobile tab bar.

== Description ==

Tecveq PWA Toolkit provides a complete suite of developer features to turn your WordPress website into a native-like Progressive Web App.

= Features =
* Custom Web App Manifest (display modes, theme color, icons, shortcuts)
* Dynamic Workbox Service Worker caching (Network-First, Cache-First, Stale-While-Revalidate)
* Mobile bottom tab navigation bar with SVG vector icons and custom accent colors
* Intelligent install prompts (Popup Overlay, Top Smart Banner, Snackbar)
* iOS Safari installation guidance tooltip
* Offline page fallback (offline.html)
* Offline status toast notification
* Pull-to-refresh gesture support
* Shake-to-refresh device gesture support
* Haptic feedback vibrations on mobile menu taps
* Screen wake lock prevention
* Scroll progress indicator bar
* PWA Rewards shortcode `[tecveq_pwa_rewards]` to lock content until installation

== External Services ==

This plugin utilizes Google Workbox CDN to deliver the Service Worker framework needed for offline caching.

= Google Workbox (CDN) =
* Service URL: https://developers.google.com/web/tools/workbox
* Script loaded: `https://storage.googleapis.com/workbox-cdn/releases/6.4.1/workbox-sw.js`
* When: Loaded inside the Service Worker script when a user's browser installs the web app.
* Data transmitted: No personal data or user credentials are transmitted to Google. The browser fetches static JavaScript code.
* Privacy Policy: https://policies.google.com/privacy
* Terms of Service: https://policies.google.com/terms

== Installation ==

1. Upload the `tecveq-pwa-toolkit` folder to your `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Navigate to **Tecveq PWA** in the admin menu to customize your PWA settings.

== Frequently Asked Questions ==

= Do I need SSL / HTTPS? =
Yes. Modern web browsers require an active HTTPS connection to register Service Workers.

= Where are the manifest and service worker files stored? =
They are served dynamically via WordPress rewrite rules at `/manifest.json` and `/tecveq-sw.js`. No physical files are written to your filesystem root.

== Changelog ==

= 4.3.1 =
* Added register_activation_hook and register_deactivation_hook to automatically flush rewrite rules on activation.
* Added custom SVG kses rules allowed-list for wp_kses() so bottom navbar SVG icons render securely without being stripped.
* Fixed icon key sanitization order for case-insensitive icon matching.
* Fixed sub-directory installation active tab matching logic.
* Added index.php files across sub-folders to prevent directory listing.

= 4.3.0 =
* Initial WordPress.org repository compliance release.
* Refactored into a clean modular architecture (`admin/`, `frontend/`, `includes/`, `templates/`).
* Replaced ABSPATH root file writing with virtual rewrite endpoints.
* Replaced inline scripts and styles with `wp_enqueue_scripts` and `wp_localize_script`.
* Added Web App Shortcuts editor and Scroll Progress Bar indicator.
* Added PWA Rewards shortcode support `[tecveq_pwa_rewards]`.

