=== Hunter Dock – Mobile Bottom Navigation ===
Contributors: headerhunt
Tags: mobile navigation, bottom navigation, floating dock, navigation bar, app bar
Requires at least: 5.6
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.5.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a modern, responsive mobile bottom navigation to your WordPress website.

== Description ==

**Hunter Dock** is a lightweight, mobile-responsive, modern floating dock for WordPress. It adds an elegant bottom dock bar featuring quick navigation, an interactive search modal, and a smart contextual action button that dynamically adapts to your content.

### Key Features

* **Pre-built Theme Presets & Distinct CSS Styles**:
  - **Pill Capsule & Glassmorphism**: Floating translucent pill frosted glass with subtle neon glows.
  - **Neo-Brutalist**: High-contrast black outlines (3px), hard retro drop-shadows (5px solid offset), and vibrant pop colors.
  - **macOS Floating Dock**: Curvature island shelf with glass reflection bar and subtle icon lift animations.
  - **Cyberpunk HUD**: Futuristic angular neon borders, cyan & pink energy glow, and HUD frame styling.
  - **Minimal Wireframe**: Ultra-clean monochrome hairline wireframe dock for sophisticated corporate layouts.
  - **Custom Palette**: Full custom color pickers for Accent Color, Dock Background, and Icon Color.
* **Built-in Theme Color Customizer**: Right-side sticky Live Preview card with instant color pickers to tweak Accent Color, Dock Background, and Item Icon Color in real-time.
* **WordPress Media Library Icon Uploader**: Upload and assign any custom PNG, SVG, or WebP icon from your WordPress Media Library directly to navigation items with a 1-click preview and remove button.
* **Streamlined Built-in Icons**: 8 curated, essential high-definition vector icons (Home, Sparkles, Search, Grid, Compass, Heart, User, Download) plus custom SVG code support.
* **Spacious Fixed Navigation Grid**: Fully aligned 3-column admin navigation layout with zero horizontal squishing or overlapping inputs.
* **Dynamic Action Button Priority**:
  1. **Copy Prompt**: If an AI prompt is present in ACF / post meta (`ai_prompt`), displays a glowing "Copy Prompt" button with 1-click clipboard copying and instant feedback.
  2. **Direct Download**: If a download URL is present (`download_link`), automatically displays an animated "Download" action button.
  3. **Explore / Home**: On homepage and archive pages, gracefully defaults to an "Explore" action.
* **Instant Search Modal**: Clean modal with quick tags (PNG, PSD, Backgrounds, AI Prompts), backdrop blur, and Escape key support.
* **Zero Dependency**: Pure vanilla CSS and JavaScript with modern CSS glassmorphism and keyframe animations.
* **Customizable Settings**: Adjust navigation URLs, search tags, action button field keys, and dock behavior easily from WordPress Admin (Settings > Hunter Dock).
* **Fully Responsive**: Optimizes padding and hides non-critical items on mobile screens for seamless user experience.

== Installation ==

1. Upload the `hunter-dock` folder to the `/wp-content/plugins/` directory, or upload the zip file directly via **Plugins > Add New > Upload Plugin**.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Configure settings under **Settings > Hunter Dock** if desired (it works out of the box with defaults).

== External services ==

This plugin uses the following external services under specific conditions:

= QR Server (api.qrserver.com) =
**What it does:** When a visitor clicks the "QR Code" button in the floating dock, the plugin requests a QR code image from the QRServer API, encoding the current page URL for easy mobile sharing.

**What data is sent:** The current page URL (no personal data, no site credentials, no user data).

**When it is sent:** Only when a visitor actively clicks the QR Code button. No data is sent on page load.

**External service links:**
* Service: https://api.qrserver.com/v1/create-qr-code/
* Privacy Policy: https://goqr.me/de/rechtliches/datenschutz-goqrme.html
* Terms/Legal: https://goqr.me/legal/

= WhatsApp =
If a site owner configures a dock button with a WhatsApp action, clicking that button opens a `wa.me` link (standard WhatsApp short URL). No data is sent by the plugin itself — the visitor's browser follows the link to WhatsApp's own service.

* WhatsApp Privacy Policy: https://www.whatsapp.com/legal/privacy-policy

= Telegram =
Same as WhatsApp — if configured by the site owner, clicking a Telegram button follows a `t.me` link to Telegram's own service. No data is sent by the plugin itself.

* Telegram Privacy Policy: https://telegram.org/privacy

== Changelog ==

= 2.5.3 =
* Compliance: Updated plugin text domain to `hunter-dock-mobile-bottom-navigation` to match the official WordPress.org plugin slug.
* Security: Implemented point-of-output escaping using `wp_kses()` for all icon and SVG helpers, and `esc_attr()` / `esc_html()` for all dynamic outputs, resolving all unescaped output warnings without suppressing linters.

= 2.5.2 =
* Fix: Replaced QRServer privacy and terms URLs with valid, publicly accessible endpoints (https://goqr.me/de/rechtliches/datenschutz-goqrme.html and https://goqr.me/legal/).
* Fix: Fully resolved undefined admin function errors by reorganizing the admin initialization sequence so template functions and admin render callbacks are unconditionally declared before hook executions.
* Fix: Standardized function prefixes and naming for Hunter Dock rebranding with complete backward-compatibility aliases for all `web_dock_*` functions and hooks.
* Fix: Ensured user template storage strictly resides in `wp-content/uploads/hunter-dock/templates/` via `wp_upload_dir()`, with bundled templates restricted to read-only starters in `dock-templates/starter/`.

= 2.5.1 =
* Security: Removed arbitrary Custom CSS injection feature in compliance with WordPress.org Plugin Review Team requirements.
* Security: Moved user-generated template storage from the plugin directory to `wp-content/uploads/hunter-dock/templates/` using the WordPress Filesystem API.
* Security: Replaced all direct `file_put_contents` and `file_get_contents` calls with `WP_Filesystem` equivalents.
* Security: Added per-field schema validation for `smart_rules` and `context_overrides` settings.
* Compliance: Standardized all translation text domains to `hunter-dock-mobile-bottom-navigation` matching the plugin slug.
* Documentation: Added External Services section documenting QRServer, WhatsApp, and Telegram integrations.

= 2.5.0 =
* Feature: Added "Quick Customize" bar directly below the Live Preview canvas with dedicated controls for Radius, Colors, Spacing, Badges, and More Advanced Settings. Clicking each tab reveals only the relevant control panel without forcing users to scroll through huge stacked settings sections. Includes 1-click shape presets (Pill, Rounded Capsule, Smooth Modern, Subtle, Sharp), dual-slider bottom spacing with real-time elevation sync, and interactive 18-style designer badge testing & 1-click application.
* Feature: Added Modular Button Builder workflow: dynamic '+ Add Button', HTML5 drag-and-drop reordering, Action Selector (URL, Search Modal, Copy AI Prompt, Direct Download, Scroll to Top), Condition / Visibility Controls (All Pages, Desktop Only, Mobile Only, Single Posts, Homepage Only), and Design Customizer (Icon Picker, Media Library, Custom SVG, Label, Badge Chips 'HOT'/'NEW', and Accent CTA Gradient style) with real-time Live Dock synchronization.
* Feature: Transformed admin interface into an interactive Dock Builder Studio (mini page builder) featuring responsive device viewport switches (Desktop, Tablet, Mobile iPhone frame), categorized inspector tabs, Click-to-Inspect navigation, interactive canvas backdrops (Dark, Light, Realistic Webpage content), and in-admin Search Modal preview.
* Feature: Added Drag & Drop Dock Items Reordering in Admin (Settings > Hunter Dock) with instant Live Preview synchronization and frontend order rendering.
* Feature: Added Smart Scroll & Auto-Hide — smoothly slides the dock down out of sight when scrolling down to maximize screen reading space, and springs back up into view when scrolling up.
* Feature: Added distinct CSS theme styling archetypes (Neo-Brutalist with thick borders & hard drop shadow, macOS Dock Island with reflection & zoom, Cyberpunk HUD with pulsing neon, Pill Capsule Glass, Minimal Wireframe).
* Feature: Added Dock Effects & Appearance sidebar controls: "Remove Shadows" toggle (completely turns off drop shadows), "Remove Borders" toggle, "Disable Glass Blur", and live bottom margin control.
* Feature: Added WordPress Media Library uploader (`wp.media`) for navigation items — upload and use any custom PNG, SVG, or WebP image icon with instant preview and remove options.
* Feature: Real-time Theme Color Customizer directly inside the sticky Live Preview sidebar (customize Accent Color, Dock Background, and Icon Color live).
* Feature: Expanded to 35 Curated Designer Theme Presets with real-time live search by color or keyword, instant color-tag quick pills, individual color-dot swatches, and live canvas preview.
* Feature: Added 35 Ready-to-Use "Premade Docks" with genuinely distinct dock shapes, button shapes, layouts, and navigation styles with 1-click temporary Live Canvas preview and Use Preset capabilities.
* Feature: Quick Customize row directly under the Live Canvas — 5 quick-switch control tabs allowing users to adjust key dock styling in one place.
* Feature: Scoped "Reset Current Dock" — dedicated reset action that resets only the current dock appearance back to clean defaults, preserving all global plugin settings.
* Feature: Template Management & "My Docks" Studio — one-click "Save as Template" to preserve any dock configuration into a reusable template library, preloaded with 5 starter docks.

= 2.4.0 =
* Feature: 5 new distinct theme presets — Neo Minimal, Midnight Navy, Warm Sand, Candy Pop, Arctic Ice (11 total).
* Feature: Real-time Live Preview panel in admin — click any preset to instantly see how your dock will look, with smooth transitions on background, border, shadow, icon colors, and gradient button.
* Enhancement: URL fields now show your site's base URL as a hint so users know exactly what path to enter.

= 2.3.0 =
* Fix: "Reset to Factory Defaults" button changed from type="submit" to type="button" — prevents accidental settings wipe when pressing Enter in any form field.
* Fix: Preset selection now saves and applies correctly on every Save Settings click.

= 2.2.0 =
* Fix: Added prominent Master Switch toggle in WordPress admin dashboard to prevent accidental disabled states.
* Fix: Auto-healing migration routine to repair database options if previously saved without enabled flag.
* Fix: Fail-safe navigation item rendering so items always render by default.
* Fix: Added support for ACF File array return format and array prompt values.
* Feature: Added one-click "Reset to Factory Defaults" button in admin settings.
* Enhanced: Explicit CSS display and z-index priority for theme compatibility.

= 2.1.0 =
* Feature: Added 6 pre-built theme presets (Glass Light, Glass Dark, Flat Minimalist, Cyberpunk Neon, Sunset Coral, Emerald Forest).
* Feature: Added customizable SVG icon selector with 16 built-in modern icons and custom SVG code support for all navigation items.
* Enhanced: Live icon preview and preset card selector in WordPress admin dashboard.

= 2.0.0 =
* Major release: Self-contained styling and scripts, updated zip packaging, and full admin controls.

= 1.0.0 =
* Initial release of Hunter Dock.
