=== Zorko Visual Website Feedback ===
Contributors: snapfeed
Tags: feedback, bug report, screenshot, client feedback, annotation
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Let clients report issues right on your site: they click, mark the spot and send. Screenshots land in your Zorko dashboard.

== Description ==

Zorko is a visual feedback tool for web agencies and freelancers. This plugin puts the Zorko widget on your WordPress site, so your clients and your team can report what they see without writing long e-mails.

* A click on the widget takes a screenshot of the visible page. The reporter drops a pin, draws an arrow or a box, blurs anything private and writes a sentence.
* Screen recordings with voice, up to three minutes, in desktop browsers.
* Every report arrives in your Zorko dashboard with the page address, the browser window size and the last console errors, and an AI summary of what is wrong.
* Review mode shows every report as a pin on the page it was made on.
* Hand the reports to your AI coding agent (Claude Code, Cursor and others) through Zorko's MCP server.

The plugin itself only adds the widget to your pages and lets you choose who sees it. You need a Zorko account (there is a free plan) and a project for this site.

= Who sees the widget =

* Everyone who visits the site, only logged-in users, or only the roles you pick.
* In the WordPress admin too, if you like (WordPress 6.7 or later).
* Your Zorko project can also show the widget only to people who open the site through its share link, which suits a live site where visitors should not see it.

= Works with caching and optimisation plugins =

The widget's script is marked so that LiteSpeed Cache, WP Rocket, Cloudflare Rocket Loader and similar plugins leave it alone. If your optimisation plugin still delays or bundles it, exclude `zorko.app/widget` in its settings.

== Installation ==

1. Install and activate the plugin.
2. In Zorko, open your project, choose Install, then Site builders > WordPress, and copy the widget key.
3. In WordPress, go to Settings > Zorko, paste the key and save.
4. Make sure this site's domain is among your project's domains in Zorko. The widget does not start on other sites.

== Frequently Asked Questions ==

= Do I need a Zorko account? =

Yes. The reports are stored in your Zorko project; the plugin connects your site to it. Zorko has a free plan with one project.

= The widget does not appear. What should I check? =

Check that the key is saved and shown as connected under Settings > Zorko, that you are someone the "Who sees the widget" setting includes, and that the site's domain is listed in your Zorko project. The browser console says `[Zorko]` and the reason when the project refuses the site. If the project is set to "Only people with the link", open the site through the share link from Zorko once.

= Does it slow my site down? =

The first script is small and loads without blocking the page. The rest of the widget loads only when a visitor moves the mouse, scrolls or taps.

= Where is the data stored? =

Reports, screenshots and recordings are stored by Zorko, not in your WordPress database. See "External services" below.

== External services ==

This plugin relies on Zorko (https://zorko.app), a hosted visual feedback service run by craftweb sp. z o.o., the company that makes this plugin. Without it the plugin has nothing to show. It connects to the services below. Nothing is sent to any of them until you save a widget key under Settings > Zorko.

= 1. Zorko key check =

What and why: when you save the widget key, the plugin asks Zorko whether the key belongs to a project, so the settings page can show "Connected" or point out a wrong key.
What is sent and when: only the widget key, from your WordPress server to https://zorko.app/api/verify-access-key. This happens when you save the key and when you open Settings > Zorko later, at most once every 12 hours. No personal data and nothing about your visitors is sent.
Provided by craftweb sp. z o.o. (Zorko): terms of service https://zorko.app/terms, privacy policy https://zorko.app/privacy.

= 2. Zorko widget =

What and why: the widget is the feedback button your visitors use. The plugin adds its script, https://zorko.app/widget/loader.js, to the pages you chose; the visitor's browser loads it from zorko.app.
What is sent and when:
* On every page where the widget is shown, the browser loads the widget files from https://zorko.app/widget/ and, when the visitor first moves the mouse, scrolls or taps, asks Zorko's back end (https://lybfpngjkkrrmzadipmf.supabase.co/functions/v1/) for the project's settings, sending the widget key, the page address and, on a site shared through a Zorko link, that link's access code.
* Only when a visitor sends a report: the description, their e-mail address if they typed one, the screenshot or screen recording, the page address, the pin position, the browser, operating system, device type, screen resolution and user agent, the window size, the time zone, the browser language and the last console errors and warnings. Files go to https://zorko.app/api/upload and the report to Zorko's back end at https://lybfpngjkkrrmzadipmf.supabase.co/functions/v1/.
* Like any web request, these reach the servers with the visitor's IP address.
Zorko's back end is hosted by Supabase (data in Ireland) and the files on Zorko's own servers (Hetzner, Finland).
Provided by craftweb sp. z o.o. (Zorko): terms of service https://zorko.app/terms, privacy policy https://zorko.app/privacy. Hosting: Supabase terms https://supabase.com/terms, Supabase privacy policy https://supabase.com/privacy.

= 3. Screenshot library from public CDNs =

What and why: the widget takes the screenshot inside the visitor's browser with the open source Snapdom library (MIT licence), which it loads from a public CDN.
What is sent and when: on pages where the widget is shown, the browser fetches the library in the background after the page has loaded, from unpkg (https://unpkg.com), and from jsDelivr (https://cdn.jsdelivr.net) only if unpkg fails. The CDN receives an ordinary file request with the visitor's IP address and browser details; no report data is sent to it.
Provided by unpkg, which runs on Cloudflare: https://unpkg.com, Cloudflare privacy policy https://www.cloudflare.com/privacypolicy/. And by jsDelivr: terms https://www.jsdelivr.com/terms, privacy policy https://www.jsdelivr.com/terms/privacy-policy-jsdelivr-net.

== Screenshots ==

1. Settings > Zorko: the widget key and who sees the widget.
2. The widget's buttons (screenshot and screen recording) on a WordPress site.
3. A report in the Zorko dashboard: the description, the screenshot with the pin and the page it came from.

== Changelog ==

= 1.0.0 =
* First release: widget key, who sees the widget (everyone, logged-in users, roles), WordPress admin, widget language.
