Maildroppa

Опис

Maildroppa повезује Вордпрес са вашим Maildroppa налогом. Постављајте обрасце дизајниране у Maildroppa-и, управљајте подацима о публици и RSS билтенима из Вордпреса и повежите изабране догађаје Вордпреса и Maildroppa-е.

Функције

• Постављајте активне уграђене Maildroppa обрасце помоћу кратког кôда, блока Gutenberg-а или класичног виџета.
• Правите обрасце за пријаву у стилу теме (изворни HTML Вордпреса) од активног уграђеног Maildroppa обрасца и стилизујте их својом темом Вордпреса.
• Постављајте активне искачуће и клизне обрасце на све или на изабране странице/чланке, или изузмите изабране странице/чланке.
• Отварајте обрасце објављених страница преко њихове везе ка одредишној страници у Maildroppa-и.
• Управљајте претплатницима, пољима, ознакама и сегментима из Вордпреса.
• Прегледајте RSS или Atom доводе и правите, уређујте, укључујте, паузирајте, настављајте, тестирајте, проверавајте и архивирајте RSS билтене у Вордпресу.
• Прегледајте историју провера довода и пошаљите или откажите направљене бројеве RSS билтена без напуштања Вордпреса.
• Подесите заказано, тренутно слање или слање по прагу броја ставки, сегменте, профиле пошиљалаца који тренутно могу да шаљу, текст е-поруке и преглед или аутоматско слање.
• Понудите необавезну, неозначену пријаву на билтен у Contact Form 7, уз изричит избор поља и тема и централну двоструку потврду пријаве.
• Необавезно испоручујте изабране корисничке догађаје Вордпреса Maildroppa аутоматизацијама преко трајног реда чекања са ограниченим бројем поновних покушаја и истеком према старости.
• Необавезно изложите потписане догађаје Maildroppa претплатника као радње Вордпреса заштићене од поновног слања.

Спољне услуге

Овај додатак захтева Maildroppa, услугу маркетинга путем е-поште треће стране којом управља Maildroppa. Следеће везе се успостављају само за описане функције.

Maildroppa API

• Када администратор проверава везу или управља Maildroppa подацима у Вордпресу, сервер Вордпреса шаље подешени API кључ на https://api.maildroppa.com. У зависности од изабране радње, захтев садржи и ИБ-ове ресурса и е-адресе претплатника, имена, статусе, вредности произвољних поља, доделе ознака, дефиниције поља/ознака/сегмената, изразе сегмената, критеријуме претраге/филтрирања или параметре страничења. Maildroppa користи ове податке за проверу идентитета налога и извршење тражене радње маркетинга путем е-поште.
• Отварање Maildroppa > Претплатници захтева од Maildroppa API-ја дневни број претплатника на нивоу целог налога за последњих 30 календарских дана. Захтев садржи API кључ, опсег датума и интервал извештаја. Успешни извештаји се локално чувају у кешу пет минута, засебно за сваки налог и API везу. Графикон приказује укупан број потврђених претплатника, а не пријаве приписане овом веб сајту.
• Отварање било које повезане Maildroppa администраторске странице, или повезивање или замена API кључа, захтева https://api.maildroppa.com/account. Maildroppa враћа стални ИБ налога, назив налога и е-адресу власника приказане у заглављу администрације. Вордпрес чува хеш тог ИБ-а и извор API-ја да би кеширане обрасце и догађаје у реду чекања повезао са налогом. Замена кључа у оквиру истог налога задржава ову везу. Прелазак на други налог је блокиран док локални обрасци, подешавања догађаја, испоруке у реду чекања или веб-куке налога још припадају претходном налогу.
• Отварање извештаја о обрасцима захтева /report/form са изабраним опсегом датума и ИБ-овима образаца да би се приказао број пријава по обрасцу. Извештај о претплатницима користи /report/subscriber-status-total. Ручно тражење двоструке потврде пријаве шаље унете податке претплатника, текст сагласности и извор сагласности који садржи ИБ администратора Вордпреса и UTC временску ознаку; Maildroppa може да пошаље е-поруку за потврду.
• Сваки захтев са сервера Вордпреса у свом HTTP заглављу User-Agent наводи додатак и његово издање, издање Вордпреса и почетни URL сајта. Ово важи и за захтеве заказаних позадинских задатака.
• Када се обрасци на серверу Maildroppa-е поставе на сајт или се њима управља на администраторским екранима, сервер Вордпреса чита дефиниције образаца, називе, врсте, статусе, могућности постављања и URL-ове објављених страница са Maildroppa API-ја и чува ове метаподатке у локалној табели могућности Вордпреса. Кеш освежава у заказаном позадинском захтеву када застари; јавни приказ странице са постављеним обрасцем може да закаже то освежавање. Кеш обично истиче након пет минута, може да се користи до седам дана током квара API-ја, а неуспела освежавања се понављају након паузе од пет минута. Подаци у кешу се користе за попуњавање контрола за постављање образаца и за проверу подешених постављања; не садрже записе о претплатницима.
• Када администратор отвори RSS билтене или њима управља, сервер Вордпреса захтева податке о билтенима, доступне теме претплате и статус испоруке профила пошиљалаца са https://api.maildroppa.com. Прегледи довода шаљу унети јавни URL довода. Прављење или уређивање билтена шаље његов назив, URL-ове извора/сајта/довода и наслов довода, распоред или праг слања, изабрани сегмент, ИБ-ове профила пошиљаоца и тема претплате, наслов поруке, садржај е-поруке, ограничење броја ставки и правило одобравања. Радње статуса, провере довода, историје бројева, слања, отказивања, пробне е-поруке и архивирања шаљу ИБ изабраног билтена и, када је применљиво, ИБ броја. Maildroppa користи ове податке за прављење и рад траженог RSS билтена. Сервери Maildroppa-е сами преузимају подешене јавне RSS доводе.
• Када администратор намерно пошаље захтев за подршку, сервер Вордпреса шаље унето име администратора, е-адресу и поруку на https://api.maildroppa.com/contact како би Maildroppa могла да одговори. Поље за потврду „Укључи техничке податке“ подразумевано је означено и може да се поништи пре слања. Када је означено, порука садржи и издања додатка, Вордпреса и PHP-а, да ли је аутоматски cron Вордпреса укључен, последње забележено покретање Maildroppa cron-а и статус провере API кључа. Администратор може да прегледа ове податке у обрасцу. Аутоматски приложени подаци не садрже API кључ ни податке о претплатницима; захтев за подршку не шаље API кључ ради провере идентитета.
• Када су кориснички догађаји Вордпреса изричито укључени, сервер Вордпреса чува сваки изабрани догађај у локалном реду чекања и шаље назив догађаја, е-адресу корисника, време догађаја, кључ идемпотентности и само својства профила која изабере администратор на https://api.maildroppa.com/events. Испорука се обавља у заказаним позадинским захтевима, привремени неуспеси се понављају ограничен број пута и не прави се Maildroppa контакт. Догађаји на чекању истичу 30 дана након настанка и више се неће слати. Истекли и трајно неуспели записи, укључујући е-адресу и изабрана својства, остају доступни ради дијагностике 30 дана након неуспеха; алати Вордпреса за извоз и брисање личних података обухватају ове записе. Чишћење се обавља дневно преко WP-Cron-а док је додатак укључен. Пропуштена или искључена cron покретања одлажу физичко брисање; руковаоци сајта морају да обезбеде редовно извршавање WP-Cron-а. Ако догађај не може да се стави у ред, Вордпрес чува дијагностичку ознаку са називом догађаја, ИБ-ом корисника, временом неуспеха, бројем и поруком о грешци најдуже 30 дана, уз дневно чишћење помоћу WP-Cron-а. Ред нема утврђено ограничење броја записа. Maildroppa одбија догађаје за особе које нису Maildroppa претплатници и догађаје без одговарајуће аутоматизације; они се чувају као неуспели записи уз исто задржавање.
• Када су Maildroppa догађаји у Вордпресу изричито укључени, сервер Вордпреса шаље јавни URL пријемника на Вордпресу и назив изабраног догађаја на https://api.maildroppa.com/webhook-subscriptions. Када се изабрани догађај деси, Maildroppa шаље потписани HTTPS захтев том јавном пријемнику. Захтев садржи ИБ и врсту догађаја, е-адресу и поља профила претплатника, ознаке и детаље обрасца, потврде или ознаке специфичне за догађај, заједно са заглављима временске ознаке, потписа, ИБ-а догађаја и ИБ-а испоруке. Додатак проверава потпис и потврђује завршена поновна слања без поновног извршавања догађаја током периода задржавања од 90 дана. ИБ-ови завршених догађаја могу да се избришу након 90 дана заштите од поновног слања. Дневно чишћење помоћу WP-Cron-а и долазни захтеви веб-кука уклањају истекле записе; пропуштена cron покретања могу да одложе брисање. Искључивање догађаја тражи од Maildroppa-е да престане да га шаље.
• Власник сајта може да промени основни URL API-ја помоћу документоване константе или променљиве окружења MAILDROPPA_API_BASE_URL или филтера Вордпреса maildroppa_api_base_url. Ако се промени, API захтеви, укључујући проверене захтеве са API кључем и доле описане захтеве за Contact Form 7, иду на подешени URL уместо на https://api.maildroppa.com.

Необавезне пријаве на билтен из Contact Form 7

• Ова интеграција захтева Contact Form 7 и повезану Maildroppa услугу која подржава захтеве за пријаву из Вордпреса. Администратор мора да је укључи за сваки контакт образац, мапира дозвољена поља за унос, изабере теме претплате и унесе текст сагласности. Отварање њених подешавања захтева доступна поља и теме од Maildroppa API-ја. Отварање или чување укључених подешавања шаље и проверени GET захтев на https://api.maildroppa.com/subscribers/wordpress-signup-requests да би се проверило да ли повезана услуга подржава ову функцију. Мапирање, ИБ-ови и натписи тема, текст сагласности и веза за налог/сајт чувају се уз контакт образац у Вордпресу.
• Посетилац мора да означи необавезно, у почетку неозначено поље за потврду за билтен. Тек пошто Contact Form 7 успешно пошаље контакт е-поруку, додатак ставља пријаву на билтен у ред. Демонстрациони режим и прескочено слање е-поште нису подржани. Додатак ставља у ред мапирану е-адресу и вредности осталих мапираних поља, ИБ-ове изабраних тема, приказани текст сагласности са натписима тема, извор сагласности који садржи URL сајта и ИБ контакт обрасца, време слања и насумични ИБ захтева. Немапирана поља, вишередна поља поруке и прилози се не прослеђују овом интеграцијом.
• Заказана испорука шаље пријаву, време слања и ИБ захтева са сервера Вордпреса на https://api.maildroppa.com/subscribers/wordpress-signup-requests/{requestId}, уз проверу API кључем. Maildroppa користи ове податке да обради пријаву кроз подразумевани ток пријаве налога и да одлучи да ли ће послати е-поруку за двоструку потврду пријаве. Стављање пријаве у ред само по себи не потврђује претплату. Прегледач посетиоца шаље контакт образац Вордпресу; не шаље ову пријаву директно Maildroppa API-ју нити учитава Maildroppa извршно окружење за обрасце за ово поље за потврду.
• Привремени неуспеси испоруке понављају се са све дужим размацима, до осам покушаја за неуспехе који могу да се понове. Пријаве из контакт образаца на чекању истичу након 24 сата. Овај ред пријава прихвата до 5.000 задржаних записа о пријавама и највише 64 KiB података у реду чекања. Прихваћени захтеви се уклањају локално. Када пријава истекне или трајно не успе, њени подаци у реду чекања се бришу; е-адреса, идентификатор захтева, временске ознаке, статус и детаљи грешке остају ради дијагностике док не буду могли да се избришу 30 дана након неуспеха. Администратори могу одмах да избришу неуспеле записе, али не могу ручно да их поново покушају; нова пријава захтева нову сагласност. Извоз и брисање личних података у Вордпресу обухватају записе у реду чекања на чекању и неуспеле записе. Чишћење захтева WP-Cron док је додатак укључен; пропуштена покретања одлажу чишћење. Промена налога, URL-а сајта или одговарајућег подешавања интеграције, или искључивање те интеграције, спречава слање пријава на чекању по старом подешавању.

Maildroppa обрасци на серверу Maildroppa-е и изворни обрасци

• На јавним страницама на које је администратор поставио образац на серверу Maildroppa-е, прегледач посетиоца учитава извршни JavaScript са https://form.maildroppa.com/md-form-loader.js и стилове обрасца са https://form.maildroppa.com. Прегледач захтева ове ресурсе када приказује страницу са обрасцем. Скрипта затим захтева дефиницију изабраног обрасца са https://api.maildroppa.com/form/{formId} помоћу ИБ-а обрасца и SHA-256 отиска (захтева Web Crypto, обично доступан преко HTTPS-а) изведеног из величине екрана, назива прегледача и главног издања, као и назива и издања оперативног система. Тиме се учитава и приказује изабрани образац и броје јединствени прикази обрасца. Учитавач чува lastSeen{formId} у localStorage, учитава слике са https://static.maildroppa.com и може да учитава видео снимке са YouTube-а, Vimeo-а или другог URL-а подешеног у обрасцу. Ти пружаоци примају IP адресу и заглавља захтева прегледача када се њихови ресурси учитају.
• Изворни образац Вордпреса користи HTML и стилове које испоручује овај додатак. Када посетилац отвори страницу са обрасцем, прегледач посетиоца захтева тренутну дефиницију обрасца, сагласност за посетиоца и правне везе са https://api.maildroppa.com/form/{formId} помоћу истог отиска. Изворни обрасци користе краћи некриптографски отисак ако Web Crypto није доступан или не успе. Тиме обавезна поља и сагласност остају усклађени са Maildroppa-ом и броје се јединствени прикази обрасца, док тема Вордпреса управља изгледом.
• Учитавање било које врсте обрасца већ пре слања шаље ИБ обрасца и отисак Maildroppa-и. Maildroppa чува IP адресу, ИБ обрасца и отисак ради дневног бројања јединствених приказа; дневни записи могу да се избришу следећег дана.
• Када посетилац пошаље образац на серверу Maildroppa-е или изворни образац, прегледач шаље ИБ обрасца, е-адресу и вредности осталих подешених поља, ИБ-ове и натписе приказаних тема претплате, ИБ-ове тема које је посетилац изабрао, ИБ сагласности када је сагласност обавезна и исти отисак директно на https://api.maildroppa.com/subscribe. Maildroppa прима и уобичајене податке HTTPS захтева, укључујући IP адресу посетиоца, кориснички агент и податке о упућивачу које прегледач дозвољава. Maildroppa користи ове податке за обраду тражене пријаве на билтен, избора тема и повезаног поступка сагласности.
• Сајтови са правилима безбедности садржаја (Content Security Policy) морају за ове обрасце да дозволе скрипте и стилове са https://form.maildroppa.com и везе ка https://api.maildroppa.com, као и слике са https://static.maildroppa.com и свих подешених пружалаца видео снимака.
• Власник сајта може да промени URL јавног учитавача образаца помоћу документоване константе или променљиве окружења MAILDROPPA_PUBLIC_FORM_BASE_URL или филтера Вордпреса maildroppa_public_form_base_url. Филтер maildroppa_public_form_loader_url може независно да замени URL скрипте учитавача на серверу Maildroppa-е. Ако се промене, скрипте и стилови образаца на серверу Maildroppa-е учитавају се са подешеног URL-а. Дефиниције и слања изворних образаца користе основни URL API-ја. Учитавач на серверу Maildroppa-е користи сопствени подешени извор API-ја.

Прегледи образаца и RSS-а

• Отварање прегледа обрасца на серверу Maildroppa-е у Вордпресу, укључујући преглед уграђен у уређивач блокова, учитава извршни JavaScript са https://form.maildroppa.com/md-form-preview.js и стилове са https://form.maildroppa.com/index.css у прегледач администратора. Ово се дешава и када образац није постављен на јавну страницу. Преглед захтева администраторски приступ и важећи једнократни кôд Вордпреса. Вордпрес захтева податке за преглед изабраног обрасца од Maildroppa API-ја помоћу API кључа и ИБ-а обрасца и прослеђује те податке приказивачу прегледа. Прегледи изворних образаца користе локални приказивач додатка и REST крајње тачке Вордпреса. Слања из прегледа се пресрећу локално и не шаљу пријаве на билтен нити е-поруке за потврду. Захтеви за ресурсе и даље шаљу уобичајене податке захтева прегледача, укључујући IP адресу и кориснички агент, домаћину ресурса. Подешени јавни основни URL обрасца мења и извор скрипте и стилова прегледа на серверу Maildroppa-е.
• Отварање прегледа е-поруке RSS броја прво захтева његов садржај преко Maildroppa API-ја помоћу ИБ-ова билтена и броја. Прегледач администратора затим приказује HTML у изолованом iframe-у. HTTPS слике и веб словни ликови на које тај садржај упућује могу да се захтевају директно од њихових пружалаца смештаја када се преглед прикаже, без посебног притиска на сваки ресурс. Ти пружаоци примају URL траженог ресурса, IP адресу и заглавља захтева прегледача. Iframe користи правило no-referrer и не дозвољава скрипте. Пружаоци медија зависе од садржаја билтена; прегледајте њихове услове и правила о приватности када бирате садржај смештен на спољним серверима. Приказивање прегледа не шаље билтен.

Maildroppa веб апликација и веб сајт

• Везе за контролну таблу, пријаву, претплатнике, кампање, обрасце на серверу Maildroppa-е и уређивање RSS садржаја отварају https://app.maildroppa.com или https://maildroppa.com тек када их администратор притисне. Везе ка ресурсима садрже ИБ изабраног претплатника, кампање, обрасца или билтена; остале везе шаљу само уобичајене податке захтева прегледача.

Обавештење о приватности Maildroppa-е: https://maildroppa.com/data-protection

Услови коришћења Maildroppa-е: https://maildroppa.com/terms

Дијагностика

Необавезно подешавање debug у maildroppa_options бележи неуспеле API захтеве само када је у Вордпресу укључено бележење за отклањање грешака. Бележи методу, скраћену путању, статус и ИБ грешке; API кључеви, садржај порука и е-адресе претплатника се изостављају. Држите бележење за отклањање грешака искљученим осим када истражујете проблем, ограничите приступ дневнику и избришите га након дијагностике.

Извор и поновљива изградња

Све PHP, JavaScript и CSS датотеке су неумањене изворне датотеке; корак изградње није потребан. Приложене .mo и .json датотеке превода направљене су из извора превода који се одржавају у развојном складишту.