=== Reputive — Sběr Google recenzí ===
Contributors: reputive
Tags: woocommerce, reviews, customer reviews, review request, reputation
Requires at least: 5.0
Tested up to: 6.7
Stable tag: 1.6.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Po dokončení objednávky předá zákazníka do Reputive a spustí automatizovanou žádost o recenzi.

== Description ==

Reputive propojuje WooCommerce e-shop se službou Reputive. Po zvolené změně
stavu objednávky předá zákazníka do Reputive, kde lze spravovat
automatizované žádosti o recenzi.

Aktuální funkce:

* automatické předání zákazníka po dokončení nebo zpracování objednávky,
* nastavitelná prodleva před vstupem zákazníka do sekvence zpráv (např. do doručení zboží),
* název a fotka objednaného produktu v žádosti o recenzi,
* hromadný import starších objednávek,
* volitelný opt-in nebo opt-out režim na klasické checkout stránce,
* podpora poboček,
* test API připojení,
* stav Reputive v seznamu objednávek a poznámka u objednávky.
* volitelný import produktových recenzí přes omezenou retry frontu (pouze v koordinovaném release buildu).

Plugin vyžaduje WooCommerce a aktivní účet Reputive. Nepředává data do
Reputive, dokud správce nevloží API klíč a nezapne integraci. Automatické
odesílání navíc vyžaduje souhlas uložený u objednávky.

== Installation ==

1. Nahrajte ZIP přes Pluginy > Instalace pluginů > Nahrát plugin.
2. Aktivujte plugin.
3. Otevřete WooCommerce > Reputive.
4. Vložte API klíč s oprávněním pro WooCommerce z Reputive dashboardu.
   Při prvním odeslání produktových recenzí se klíč naváže na HTTPS doménu
   tohoto e-shopu. Jeden klíč nepoužívejte ve více obchodech; při změně domény
   starý klíč odvolejte a vytvořte nový.
5. Otestujte připojení, nastavte souhlas a integraci zapněte.

== Frequently Asked Questions ==

= Jaká data plugin odesílá? =

Při splnění podmínek odešle jméno, příjmení, e-mail nebo telefon,
externí ID objednávky, případné ID pobočky, informaci o souhlasu a prodlevu
nastavenou správcem. Z objednávky odešle jen údaje o jedné položce, té s nejvyšším
součtem: název a adresu hlavního obrázku (jen https), a počet
položek v objednávce. Obrázek se v e-mailu načítá přímo z e-shopu. Neodesílá
platební údaje, ceny ani celý obsah objednávky.

Při výslovném zapnutí produktových recenzí odešle veřejné zobrazované jméno,
hodnocení, text a stav recenze, informaci o ověřeném nákupu a identitu produktu
(WooCommerce ID, SKU, název, URL a obrázek). Neodesílá e-mail, IP adresu ani
user-agent autora recenze.

= Jaký je rozdíl mezi opt-out a opt-in režimem? =

V režimu opt-out se žádost odešle zákazníkovi, který ji na checkoutu aktivně
neodmítne zaškrtnutím políčka. V režimu opt-in se odešle pouze zákazníkovi,
který políčko zaškrtne. Políčko se v obou režimech ve výchozím stavu zobrazuje
prázdné a jeho znění musí odpovídat zvolenému režimu. Za volbu právního titulu
odpovídá provozovatel e-shopu.

Nové instalace začínají v režimu opt-out. Existujícím instalacím zůstane
dosavadní opt-in a správce dostane v administraci nabídku případného přepnutí.

= Odešle plugin zákazníka bez souhlasu? =

Automatický tok zákazníka bez uloženého souhlasu přeskočí. Při ručním
hromadném importu lze výjimku označit, ale dokud Reputive API neumí uložit její
samostatný právní titul, plugin takovou objednávku neodešle a poznamená ji jako
nepodporovanou.

== External services ==

Plugin komunikuje se SaaS službou Reputive na `app.reputive.cz`. Komunikace je
nutná pro ověření API klíče a předání zákazníka pro vyžádanou službu.
Dochází k ní pouze po konfiguraci pluginu správcem.

* Zásady ochrany osobních údajů: https://reputive.cz/privacy
* Obchodní podmínky: https://reputive.cz/terms
* Web služby: https://reputive.cz

== Changelog ==

= 1.6.1 =

* Sloupec „Reputive" v seznamu objednávek ukazuje souhlas z pokladny už před odesláním: „Souhlas ano", „Souhlas ne" nebo „Souhlas nedoložen". Po odeslání se dál zobrazuje výsledek. Na samotné odesílání změna nemá vliv.

= 1.6.0 =

* Nové pole „Prodleva před odesláním (hodiny)" se skutečně uplatní: určuje, za jak dlouho po změně stavu objednávky zákazník vstoupí do sekvence zpráv v Reputive. Čekání se přičítá k prodlevě první zprávy nastavené v Reputive.
* Při aktualizaci se dosavadní prodleva (výchozí 24 hodin, kterou server dosud ignoroval) nastaví na 0, aby se časování stávajících e-shopů nezměnilo. Nové instalace začínají na 0.
* Žádost o recenzi může ukázat název a fotku objednaného produktu. Plugin posílá jen položku s nejvyšším součtem řádku, její název, obrázek (jen https) a počet položek objednávky; odkaz na produkt neposílá. Zobrazení lze v Reputive vypnout.
* Smazaný produkt, chybějící obrázek nebo nepublikovaný produkt odeslání objednávky nezastaví; chybějící údaje se jen vynechají.

= 1.5.1 =

* Přidán přepínač režimu souhlasu na checkoutu — opt-out nebo opt-in.
* Každé vykreslení checkboxu dostane kryptografický jednorázový token uložený pouze ve WooCommerce session; souhlas vznikne jen po vrácení platného a dosud nespotřebovaného tokenu ve finálním odeslání objednávky.
* Volbu při AJAX překreslení checkoutu obnovuje checkoutový skript; cart hash ani veřejný hidden marker se jako důkaz nepoužívají.
* Opt-out i opt-in nyní selžou bezpečně: chybějící, podvržený, expirovaný nebo již spotřebovaný token vždy znamená absenci důkazu a uloží nesouhlas.
* Prokázaný nesouhlas je neměnný; neprokázaný záznam bez evidence může pozdější platné rozhodnutí nahradit.
* Doklad u objednávky obsahuje konkrétní tokenem svázaný režim a text, surový stav políčka, počet zápisů, časy, IP adresu serverového spojení, otisk a verzi pluginu.
* U vlastního znění musí správce výslovně potvrdit jeho význam; nepotvrzená nebo chybná kombinace textu a režimu sběr souhlasu zablokuje a zobrazí upozornění.
* Existující instalace zůstávají v režimu opt-in a dostanou nabídku přechodu na opt-out; nové instalace začínají v režimu opt-out.
* Odškrtnutí políčka těsně před odesláním objednávky se nyní vždy promítne do uloženého souhlasu.
* E-shopy, na kterých krátce běžela stažená verze 1.5.0, se vrátí do režimu opt-in s bezpečným výchozím zněním a znovu dostanou nabídku volby.
* Automatické i hromadné odeslání přijímá jen order-specific prokázaný checkoutový souhlas; uživatelský nebo historický surový příznak nestačí.
* Správcovská výjimka se do podpory samostatného právního titulu v API bezpečně neodesílá a objednávka dostane stav `override_unsupported`.
* Checkout Blocks / Store API zůstává do doplnění vlastního checkboxu bezpečně bez automatického odeslání; správce na to plugin upozorní.

= 1.4.2 =

* Uzamčená karta produktových recenzí se obchodníkům v administraci již nezobrazuje.

= 1.4.1 =

* Checkout souhlas se vrátil k explicitnímu opt-inu (zaškrtnutý checkbox = souhlas).
* Přidán důkazní záznam souhlasu (metoda, čas, IP, snímek textu) pro čl. 7/1 GDPR.
* Zákazníci bez souhlasu se v seznamu objednávek zobrazují jako samostatný stav „Bez souhlasu" místo chyby.
* Migrace pouze známého opt-out znění z dřívějších verzí; vlastní text administrátora zůstává beze změny.

= 1.4.0 =

* Přidán tenantově a capability omezený batch import produktových recenzí.
* Přidána opt-in fronta s retry, dead-letter health stavem a importem existujících recenzí po 100 položkách.
* Neveřejné, spamové, smazané a starší události se na serveru fail-closed nezobrazí.
* Distribuční build ponechává funkci uzamčenou do koordinovaného nasazení backendu.

= 1.3.0 =

* Sjednocena verze pluginu a metadata pro distribuovatelný build.
* Doplněna dokumentace externí služby a předávaných dat.
* Připraven vypnutý, bezpečný frontový mechanismus pro budoucí synchronizaci produktových recenzí. Ve verzi 1.3.0 produktové recenze neodesílá.

= 1.2.0 =

* Přidán volitelný souhlas na checkoutu a konfigurace odkazu na informace.

= 1.1.0 =

* Hromadný import objednávek a stavový sloupec v administraci WooCommerce.

= 1.0.0 =

* První verze pluginu.
