Maildroppa

Popis

Maildroppa propojuje WordPress s vaším účtem Maildroppa. Vkládat formuláře vytvořené v Maildroppě, spravovat údaje o publiku a RSS zpravodaje přímo z WordPressu a propojovat vybrané události z WordPressu a Maildroppy.

Funkce

• Aktivní formuláře Maildroppa vložte pomocí zkráceného kódu, bloku Gutenberg nebo klasického widgetu.
• Vytvářejte registrační formuláře ve stylu vaší šablony (nativní HTML WordPressu) na základě aktivního vloženého formuláře Maildroppa a přizpůsobte jejich vzhled šabloně WordPressu.
• Umístěte aktivní vyskakovací okna a posuvníky na všechny nebo vybrané stránky/příspěvky, případně z nich vybrané stránky/příspěvky vynechte.
• Otevřete formuláře publikovaných stránek prostřednictvím odkazu na jejich vstupní stránku Maildroppa.
• Spravujte odběratele, pole, štítky a segmenty přímo z WordPressu.
• Zobrazujte náhledy kanálů RSS nebo Atom a vytvářejte, upravujte, aktivujte, pozastavujte, obnovujte, testujte, kontrolujte a archivujte RSS zpravodaje přímo ve WordPressu.
• Prohlédněte si historii kontrol kanálů a publikujte nebo zrušte vygenerovaná vydání RSS zpravodaje, aniž byste museli opustit WordPress.
• Nastavte plánované, okamžité nebo prahové doručování, segmenty, profily odesílatelů, kteří mohou v danou chvíli odesílat, text e-mailu a kontrolu či automatické odeslání.
• Nabídněte v Contact Form 7 volitelnou, nezaškrtnutou možnost přihlášení k odběru newsletteru s jasným výběrem polí a témat a centrálním dvojitým potvrzením.
• Volitelně můžete předávat vybrané události uživatelů WordPressu do automatizací Maildroppa prostřednictvím trvalé fronty s omezeným počtem opakovaných pokusů a vypršením platnosti na základě doby trvání.
• Volitelně lze podepsané události odběratelů služby Maildroppa zpřístupnit jako akce WordPressu chráněné proti neoprávněnému opakování.

Externí služby

Tento plugin vyžaduje Maildroppa, službu e-mailového marketingu třetí strany provozovanou společností Maildroppa. K následujícím přenosům dat dochází pouze v souvislosti s popsanými funkcemi.

API pro odesílání e-mailů

• Když správce testuje připojení nebo spravuje data Maildroppa v systému WordPress, server WordPress odešle nakonfigurovaný klíč API na adresu https://api.maildroppa.com. V závislosti na zvolené akci obsahuje požadavek také ID zdrojů a e-mailové adresy odběratelů, jména, stavy, hodnoty vlastních polí, přiřazení štítků, definice polí/štítků/segmentů, segmentové výrazy, kritéria vyhledávání/filtrování nebo parametry stránkování. Maildroppa používá tato data k ověření účtu a provedení požadované e-mailové marketingové akce.
• Funkce „Opening Maildroppa“ > „Subscribers“ odesílá prostřednictvím API služby Maildroppa žádost o denní počty odběratelů za posledních 30 kalendářních dnů pro celý účet. Žádost obsahuje klíč API, časové rozmezí a interval vykazování. Úspěšné výstupy se ukládají do lokální mezipaměti na pět minut, a to samostatně pro každý účet a každé připojení k API. Graf zobrazuje potvrzené celkové počty odběratelů, nikoli registrace přiřazené této webové stránce.
• Při otevření jakékoli připojené správcovské stránky Maildroppa, při připojení nebo výměně klíče API se odesílá požadavek https://api.maildroppa.com/account. Maildroppa vrátí stabilní ID účtu, název účtu a e-mail majitele, které se zobrazují v záhlaví správcovské stránky. WordPress ukládá hash tohoto ID a původ API, aby mohl své formuláře v mezipaměti a události v frontě přiřadit k danému účtu. Obměna klíče v rámci stejného účtu tuto vazbu zachovává. Přepnutí na jiný účet je blokováno, dokud místní formuláře, nastavení událostí, zásilky v frontě nebo webhooky účtu stále patří k předchozímu účtu.
• Otevření požadavku na přehled formulářů /report/form s vybraným časovým rozsahem a ID formulářů zobrazí počet registrací podle jednotlivých formulářů. Pro přehled o odběratelích se používá /report/subscriber-status-total. Ruční vyžádání potvrzení dvojitého souhlasu odešle zadané údaje o odběrateli, text souhlasu a zdroj souhlasu obsahující ID správce WordPressu a časové razítko UTC; Maildroppa může odeslat potvrzovací e-mail.
• Každý požadavek od serveru WordPress identifikuje v hlavičce HTTP User-Agent plugin a jeho verzi, verzi WordPressu a domovskou URL stránky. To platí i pro požadavky odesílané naplánovanými úlohami na pozadí.
• Když jsou hostované formuláře umístěny na webu nebo spravovány v administračním rozhraní, server WordPress načte definice formulářů, názvy, typy, stavy, možnosti umístění a URL adresy zveřejněných stránek z API Maildroppa a uloží tato metadata do lokální tabulky nastavení WordPressu. Jakmile se data v mezipaměti stanou zastaralými, dojde k jejich obnovení prostřednictvím naplánovaného požadavku na pozadí; tuto aktualizaci lze naplánovat také zobrazením veřejné stránky, na které je umístěn hostovaný formulář. Platnost mezipaměti obvykle vyprší po pěti minutách, v případě výpadku API může být použita až po dobu sedmi dnů a neúspěšné aktualizace se opakují po pětiminutové prodlevě. Data v mezipaměti se používají k vyplnění ovládacích prvků pro umístění formulářů a k ověření nakonfigurovaných umístění; neobsahují záznamy o odběratelích.
• Když správce otevře nebo spravuje RSS zpravodaje, server WordPress vyžádá data zpravodaje, dostupná témata odběru a stav doručení podle profilu odesílatele z adres https://api.maildroppa.com. Náhledy kanálů odesílají zadanou veřejnou URL kanálu. Při vytvoření nebo úpravě zpravodaje se odesílá jeho název, URL zdroje/webu/kanálu a název kanálu, plán doručování nebo prahová hodnota, vybraný segment, ID profilu odesílatele a ID témat odběru, předmět, obsah e-mailu, limit položek a zásady schvalování. Akce týkající se stavu, kontroly kanálu, historie vydání, zveřejnění, zrušení, testovacího e-mailu a archivace odesílají vybraný zpravodaj a případně ID vydání. Maildroppa používá tato data k vytvoření a provozování požadovaného RSS zpravodaje. Servery Maildroppa samy načítávají nakonfigurované veřejné RSS kanály.
• Když správce záměrně odešle žádost o podporu, server WordPress odešle zadané jméno správce, e-mailovou adresu a zprávu na adresu https://api.maildroppa.com/contact, aby na ni mohla Maildroppa odpovědět. Zaškrtávací políčko „Zahrnout technické podrobnosti“ je ve výchozím nastavení zaškrtnuto a lze jej před odesláním odškrtnout. Je-li zaškrtnuto, zpráva obsahuje také informace o verzi pluginu, WordPressu a PHP, o tom, zda je povoleno automatické cronování WordPressu, o posledním zaznamenaném spuštění cronu Maildroppa a o stavu ověření API klíče. Správce si může tyto údaje zkontrolovat ve formuláři. Automaticky připojené údaje neobsahují žádný API klíč ani údaje o předplatiteli; žádost o podporu neodesílá API klíč pro autentizaci.
• Jsou-li události uživatelů WordPressu výslovně povoleny, server WordPress uloží každou vybranou událost do lokální fronty a odešle název události, e-mailovou adresu uživatele, čas výskytu, idempotentní klíč a pouze vlastnosti profilu vybrané správcem na adresu https://api.maildroppa.com/events. Odesílání probíhá v naplánovaných požadavcích na pozadí, dočasné selhání se opakuje omezený početkrát a nevytváří se kontakt v Maildroppa. Čekající události vyprší 30 dní po vytvoření a již nebudou odeslány. Zápisy, jejichž platnost vypršela nebo u nichž došlo k trvalému selhání, včetně e-mailové adresy a vybraných vlastností, zůstávají k dispozici pro diagnostiku po dobu 30 dnů od selhání; nástroje WordPressu pro export a mazání osobních údajů tyto záznamy zahrnují. Úklid probíhá denně prostřednictvím WP-Cron, pokud je plugin aktivní. Vynechané nebo deaktivované spouštění cronu zpožďuje fyzické smazání; provozovatelé stránek musí zajistit pravidelné spouštění WP-Cronu. Pokud nelze událost zařadit do fronty, WordPress uloží diagnostický záznam s názvem události, ID uživatele, časem selhání, počtem a chybovou zprávou po dobu maximálně 30 dnů, přičemž podléhá dennímu čištění prostřednictvím WP-Cronu. Fronta nemá pevně stanovený limit počtu záznamů. Maildroppa odmítá události pro osoby, které nejsou předplatiteli služby Maildroppa, a události bez odpovídající automatizace; ty jsou uchovávány jako neúspěšné záznamy s stejnou dobou uchovávání.
• Jsou-li události Maildroppa ve WordPressu výslovně povoleny, server WordPress odešle veřejnou URL přijímače WordPressu a název vybrané události na adresu https://api.maildroppa.com/webhook-subscriptions. Jakmile dojde k vybrané události, Maildroppa odešle podepsaný HTTPS požadavek na tento veřejný přijímač. Žádost obsahuje ID a typ události, e-mail odběratele a pole profilu, štítky a podrobnosti o formuláři, potvrzení nebo štítcích specifických pro danou událost, spolu s časovým razítkem, podpisem a hlavičkami ID události a ID doručení. Plugin ověří podpis a potvrdí dokončené přehrání, aniž by událost během 90denní doby uchovávání znovu spouštěl. ID dokončených událostí lze po 90 dnech smazat z důvodu ochrany před opakovaným spuštěním. Denní čištění pomocí WP-Cron a příchozí požadavky webhooků odstraňují záznamy, jejichž platnost vypršela; zmeškaná spuštění cronu mohou smazání zpozdit. Deaktivací události se Maildroppa požádá, aby ji přestala odesílat.
• Základní URL rozhraní API může vlastník webu změnit pomocí zdokumentované konstanty MAILDROPPA_API_BASE_URL nebo proměnné prostředí, případně pomocí filtru WordPressu maildroppa_api_base_url. V případě změny budou požadavky na API, včetně ověřených požadavků s klíčem API a níže popsaných požadavků Contact Form 7, směřovat na nakonfigurovanou URL namísto https://api.maildroppa.com.

Volitelná registrace k odběru zpravodaje prostřednictvím Contact Form 7

• Tato integrace vyžaduje plugin Contact Form 7 a připojenou službu Maildroppa, která podporuje žádosti o registraci ve WordPressu. Správce musí tuto funkci povolit pro každý kontaktní formulář, přiřadit povolená vstupní pole, vybrat témata odběru a zadat text souhlasu. Otevření konfigurace vyžaduje dostupná pole a témata z API Maildroppa. Otevření nebo uložení povolených nastavení také odešle ověřený požadavek GET na https://api.maildroppa.com/subscribers/wordpress-signup-requests, aby se ověřilo, zda připojená služba tuto funkci podporuje. Přiřazení, ID a štítky témat, text souhlasu a propojení s účtem/webem se ukládají společně s kontaktním formulářem ve WordPressu.
• Návštěvník musí zaškrtnout volitelné políčko pro odběr zpravodaje, které je zpočátku nezaškrtnuté. Teprve poté, co Contact Form 7 úspěšně odešle kontaktní e-mail, zařadí plugin registraci k odběru zpravodaje do fronty. Demo režim a přeskočení odeslání e-mailu nejsou podporovány. Plugin zařadí do fronty namapovanou e-mailovou adresu a další hodnoty namapovaných polí, vybraná ID témat, zobrazený text souhlasu včetně popisků témat, zdroj souhlasu obsahující URL webu a ID kontaktního formuláře, čas odeslání a náhodné ID požadavku. Nemapovaná pole, víceřádková pole pro zprávy a přílohy nejsou touto integrací předávány.
• Funkce plánovaného odeslání odešle údaje o registraci, čas odeslání a ID požadavku ze serveru WordPress na adresu https://api.maildroppa.com/subscribers/wordpress-signup-requests/{requestId}, a to po ověření pomocí klíče API. Maildroppa tyto údaje použije ke zpracování registrace prostřednictvím výchozího registračního postupu účtu a k určení, zda má být odeslán potvrzovací e-mail s dvojitým potvrzením (double-opt-in). Zařazení registrace do fronty samo o sobě neznamená potvrzení odběru. Prohlížeč návštěvníka odešle kontaktní formulář do WordPressu; tuto registraci neodesílá přímo do API Maildroppa ani nenačítá hostované runtime prostředí formuláře Maildroppa pro toto zaškrtávací políčko.
• Dočasné chyby doručení se opakují s postupně se prodlužujícími prodlevami, a to až osmkrát u chyb, u nichž je možné opakování. Čekající registrace z kontaktního formuláře vyprší po 24 hodinách. Tato fronta registrací přijímá až 5 000 uchovaných záznamů o registraci a maximální velikost dat v frontě je 64 KiB. Přijaté požadavky se lokálně odstraní. Když registrace vyprší nebo trvale selže, její data v frontě se vymažou; e-mailová adresa, identifikátor požadavku, časová razítka, stav a podrobnosti o chybě zůstávají k dispozici pro diagnostiku, dokud nejsou 30 dní po selhání způsobilé k odstranění. Správci mohou neúspěšné záznamy okamžitě smazat, ale nemohou je ručně opakovat; nová registrace vyžaduje nový souhlas. Export a vymazání osobních údajů ve WordPressu zahrnuje i záznamy v frontě čekající na zpracování a neúspěšné záznamy. Čištění vyžaduje WP-Cron, zatímco je plugin aktivní; zmeškaná spuštění čištění zpožďují. Změna účtu, URL webu nebo odpovídající konfigurace integrace, případně deaktivace dané integrace, zabrání odeslání čekajících registrací podle staré konfigurace.

Hostované a nativní formuláře Maildroppa

• Na veřejných stránkách, na které správce umístil hostovaný formulář, načte prohlížeč návštěvníka spustitelný kód JavaScript z adres https://form.maildroppa.com/md-form-loader.js a styly formuláře z adres https://form.maildroppa.com. Prohlížeč tyto zdroje vyžádá při vykreslování stránky obsahující formulář. Skript poté vyžádá definici vybraného formuláře z adresy https://api.maildroppa.com/form/{formId} s využitím ID formuláře a otisku SHA-256 (vyžaduje Web Crypto, obvykle dostupné přes HTTPS), odvozeného z velikosti obrazovky, názvu a hlavní verze prohlížeče a názvu a verze operačního systému. Tím se načte a vykreslí vybraný hostovaný formulář a spočítá se počet jedinečných zobrazení formuláře. Načítací modul uloží lastSeen{formId} do localStorage, načte obrázky z https://static.maildroppa.com a může načíst videa z YouTube, Vimeo nebo jiné URL adresy nakonfigurované ve formuláři. Tito poskytovatelé obdrží IP adresu a hlavičky požadavku prohlížeče při načítání svých zdrojů.
• Nativní formulář WordPressu využívá HTML a styly poskytované tímto pluginem. Když návštěvník otevře stránku obsahující formulář, jeho prohlížeč si vyžádá aktuální definici formuláře, souhlas specifický pro daného návštěvníka a odkazy na právní informace z adresy https://api.maildroppa.com/form/{formId} s použitím stejného otisku. Nativní formuláře používají kratší nekryptografický otisk, pokud není k dispozici Web Crypto nebo dojde k jeho selhání. Tím se zajistí, že povinná pole a souhlas budou v souladu s Maildroppa a bude se počítat počet jedinečných zobrazení formuláře, zatímco šablona WordPressu řídí jeho vzhled.
• Již při načtení kteréhokoli z těchto typů formulářů se do služby Maildroppa odešle ID formuláře a jeho otisk ještě před odesláním. Maildroppa ukládá IP adresu, ID formuláře a jeho otisk za účelem denního počítání jedinečných zobrazení; denní záznamy lze smazat následující den.
• Když návštěvník odešle hostovaný nebo nativní formulář, prohlížeč odešle ID formuláře, e-mailovou adresu a další hodnoty nakonfigurovaných polí, zobrazená ID a názvy témat odběru, ID témat, která návštěvník vybral, ID souhlasu v případě, že je souhlas vyžadován, a stejný otisk přímo na adresu https://api.maildroppa.com/subscribe. K Maildroppě se rovněž dostávají běžná data z HTTPS požadavků, včetně IP adresy návštěvníka, user agentu a veškerých informací o odkazujícím webu, které prohlížeč povoluje. Maildroppa tato data využívá ke zpracování požadované registrace k odběru zpravodaje, výběru témat a souvisejícího procesu získávání souhlasu.
• Webové stránky s nastavenou politikou zabezpečení obsahu (Content Security Policy) musí pro tyto formuláře povolit skripty a styly z adres https://form.maildroppa.com a připojení k adresám https://api.maildroppa.com, a dále obrázky z adresy https://static.maildroppa.com a od jakýchkoli nakonfigurovaných poskytovatelů videa.
• URL veřejného načítacího skriptu formuláře může vlastník webu změnit pomocí zdokumentované konstanty MAILDROPPA_PUBLIC_FORM_BASE_URL nebo proměnné prostředí, případně pomocí filtru WordPressu maildroppa_public_form_base_url. Filtr maildroppa_public_form_loader_url může nezávisle přepsat URL skriptu hostovaného načítacího modulu. V případě změny se skripty a styly hostovaných formulářů načítají z nakonfigurované URL. Nativní definice formulářů a odesílání dat používají základní URL API. Hostovaný načítací modul používá vlastní nakonfigurovaný zdroj API.

Náhledy formulářů a RSS

• Při otevření náhledu hostovaného formuláře ve WordPressu, včetně náhledu vloženého do blokového editoru, se do prohlížeče správce načtou spustitelné soubory JavaScript z adres https://form.maildroppa.com/md-form-preview.js a styly z adres https://form.maildroppa.com/index.css do prohlížeče správce. K tomu dochází i v případě, že formulář nebyl umístěn na veřejnou stránku. Náhled vyžaduje přístup správce a platný nonce WordPressu. WordPress vyžádá data náhledu vybraného formuláře z API Maildroppa pomocí API klíče a ID formuláře a poskytne tato data rendereru náhledu. Náhledy nativních formulářů využívají lokální renderer pluginu a REST endpoiny WordPressu. Odeslání v rámci náhledu jsou zachycena lokálně a neodesílají registrace k odběru newsletteru ani potvrzovací e-maily. Žádosti o zdroje stále odesílají běžná data prohlížeče, včetně IP adresy a user agentu, na hostitele zdroje. Nakonfigurovaná základní URL veřejného formuláře také mění původ hostovaného skriptu náhledu a stylů.
• Při otevření e-mailového náhledu čísla RSS se nejprve vyžádá jeho obsah prostřednictvím rozhraní API Maildroppa s použitím ID zpravodaje a čísla. Prohlížeč správce poté zobrazí HTML kód v iframe v izolovaném prostředí. Obrázky a webová písma v protokolu HTTPS, na které tento obsah odkazuje, mohou být při zobrazení náhledu vyžádány přímo od jejich poskytovatelů hostingu, aniž by bylo nutné na každý zdroj zvlášť kliknout. Tito poskytovatelé obdrží URL požadovaného zdroje, IP adresu a hlavičky požadavku prohlížeče. Rámec iframe používá zásadu bez odkazu na zdroj (no-referrer) a nepovoluje skripty. Poskytovatelé médií se liší v závislosti na obsahu zpravodaje; při výběru externě hostovaného obsahu si prostudujte jejich podmínky a zásady ochrany osobních údajů. Zobrazení náhledu neznamená odeslání zpravodaje.

Webová aplikace a webové stránky Maildroppa

• Odkazy na ovládací panel, registraci, odběratele, kampaň, hostovaný formulář a úpravy obsahu RSS otevírají stránky https://app.maildroppa.com nebo https://maildroppa.com pouze poté, co na ně klikne správce. Odkazy na zdroje obsahují ID vybraného odběratele, kampaně, formuláře nebo zpravodaje; ostatní odkazy odesílají pouze běžná data požadavku prohlížeče.

Prohlášení o ochraně osobních údajů společnosti Maildroppa: https://maildroppa.com/data-protection

Podmínky používání služby Maildroppa: https://maildroppa.com/terms

Diagnostika

Volitelná nastavení debug v souboru maildroppa_options zaznamenávají neúspěšné požadavky na API pouze v případě, že je zapnuto ladicí protokolování WordPressu. Zaznamenávají metodu, skrytou trasu, stav a ID chyby; API klíče, těla zpráv a e-mailové adresy odběratelů jsou z protokolu vyloučeny. Logování ladění nechte vypnuté, pokud právě neřešíte nějaký problém, omezte přístup k logu a po diagnostice jej smažte.

Zdroj a reprodukovatelná kompilace

Všechny soubory PHP, JavaScript a CSS jsou nezkomprimované zdrojové soubory; není třeba provádět žádný kompilační krok. Přiložené překladové soubory .mo a .json jsou generovány z překladových zdrojů spravovaných ve vývojovém repozitáři.