=== Enckboaz Website Audit ===
Contributors: enckboaz
Donate link: https://buy.stripe.com/9B64gB94AdB10eRfQX4Rq00
Tags: feedback, bug tracking, visual feedback, website review, tasks
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 8.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Visual feedback for WordPress: clients click any element on the live site to report issues — screenshot and context captured automatically.

== Description ==

**Enckboaz Website Audit** is visual feedback and task collection on top of any page of your WordPress site. Stop chasing vague emails and blurry screenshots: your clients and teammates click directly on the element that's wrong, write what they need, and it becomes a trackable task — complete with an automatic screenshot and full technical context.

Built for **web agencies and freelancers** who collect revisions from clients.

= How it works =

1. Open any page of your site while logged in (as a user with review permission).
2. Click the **"Avvia revisione"** button in the bottom-right corner.
3. Click the element you want to report.
4. Write a title, description and priority.
5. Done — Enckboaz Website Audit automatically captures the screenshot, the exact CSS element, the URL, browser, OS, device type and viewport size, and files it as an assignable task.

= Key features =

* **Element picker** — highlight and click any text, image, button or section on the live site.
* **Automatic screenshot** of the viewport with the reported element highlighted (no browser extension, runs client-side).
* **Automatic context capture** — URL, CSS selector, browser + version, OS, device type, viewport, timestamp.
* **Task dashboard** — open / in progress / in review / done, with filters and search.
* **Projects** — organise tasks per site or per client.
* **Assignments, comments (incl. internal notes), attachments and activity history.**
* **Email notifications** for new, assigned and completed tasks.
* **Privacy by design** — the overlay and admin area load only for authorised reviewers. Normal visitors never load a single byte.

Free and open source — unlimited projects and tasks, with every feature included.

== Source code and build process ==

This plugin ships both the compiled assets in `build/` and the unminified
sources they are generated from, so everything can be reviewed and rebuilt.

* Sources: `resources/` (TypeScript and React)
* Build configuration: `vite.config.ts`, `tsconfig.json`, `package.json`
* Output: `build/`

To rebuild the assets from source you need Node.js 18 or later:

`npm install`
`npm run build`

`npm run build` type-checks with `tsc --noEmit` and then bundles with Vite,
writing the result to `build/`. `npm run dev` rebuilds on change.

= Third-party libraries =

The bundles in `build/` include the following GPL-compatible libraries, all
installed from npm and listed in `package.json`:

* html2canvas 1.4.1 (MIT) — https://github.com/niklasvh/html2canvas
* React and React DOM 18.3.1 (MIT) — https://github.com/facebook/react
* React Router 6 (MIT) — https://github.com/remix-run/react-router
* Radix UI primitives (MIT) — https://github.com/radix-ui/primitives
* lucide-react (ISC) — https://github.com/lucide-icons/lucide
* clsx, tailwind-merge, class-variance-authority (MIT)
* Tailwind CSS 4 (MIT) — https://github.com/tailwindlabs/tailwindcss

== Installation ==

1. Upload the `enckboaz-website-audit` folder to `/wp-content/plugins/`, or install the ZIP via **Plugins → Add New → Upload Plugin**.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Open **Enckboaz Website Audit** in the admin menu.
4. Click the **info (ℹ) button** in the sidebar for the in-app quick guide.

== Frequently Asked Questions ==

= Who can create and see tasks? =
Only logged-in users with the review capability (administrators and editors by default). Regular site visitors don't see or load the overlay.

= Does it send my data to an external service? =
No. Screenshots are generated in the browser and stored in your own WordPress media library. No third-party service is required.

= Where are tasks stored? =
In dedicated tables in your WordPress database. Uninstalling the plugin removes them.

= Does the screenshot need a browser extension? =
No. Capture runs fully client-side.

== Screenshots ==

1. The review overlay on a live page with the element picker.
2. Compose panel: title, description and priority.
3. Tasks dashboard with filters.
4. Task detail with screenshot, context and comments.

== Changelog ==

= 1.0.0 =
* Initial public release.
* Review overlay with element picker, automatic screenshot and context capture.
* Task dashboard, projects, assignments, comments, attachments and activity history.
* Email notifications.

== Upgrade Notice ==

= 1.0.0 =
First public release.
