Ladění
Template JSON Debugger
Zkontroluje exportovaný soubor šablony Ecomailu (.json) ještě před importem: rozbitý JSON, strom prvků, atributy, nebezpečné HTML, obrázky, merge tagy a písma. Umí opravy a stažení opravené kopie.
- Běží ve vašem prohlížeči
- Spuštění zdarma
- Zadáváte
- Soubor šablony .json (nahrání, přetažení nebo vložení) nebo hromadný export .zip.
- Dostanete
- Verdikt, seznam problémů s cestami v JSONu, strom, zdroj s označenými řádky, náhled rozvržení, obrázky, merge tagy, písma a statistiky.
- Dobrý výsledek
- „Připraveno k importu“: žádné chyby ani varování.
Na této stránce
#K čemu slouží
Ecomail ukládá šablonu z editoru jako definici v JSONu (mjml → mj-body → mj-section → mj-column → obsah) a takový soubor naimportuje bez jakékoli kontroly. Ručně upravený, poškozený nebo cizí soubor pak selže později, v editoru nebo v odeslaném e-mailu. Soubor proto nejdřív projděte tímto nástrojem; hodí se i ve chvíli, kdy klient hlásí, že importovaná šablona vypadá špatně.
#Co zadáváte
- Přetáhněte nebo vyberte soubor
.json, případně JSON vložte. Načtou se soubory do 20 MB; Ecomail importuje nejvýš 4 MB. - Hromadný export
.zip: zkontroluje a vypíše každý.jsonuvnitř (až 300 souborů) a upozorní na HTML uložené pod koncovkou.json, protože to nejde naimportovat. - Tři ukázky: platná šablona, šablona s mnoha problémy a rozbitý JSON.
#Jak funguje
Vše běží ve vašem prohlížeči na pozadí (ve workeru), takže ani velký soubor stránku nezasekne. Nic se nenahrává na server. Kontroly podle oblastí:
| Oblast | Co najde |
|---|---|
| Soubor | Neplatný JSON s řádkem a sloupcem, HTML místo JSONu, soubor nad 4 MB, dvakrát zakódovaný JSON (řetězec, ve kterém je JSON), šablonu zabalenou v jiném objektu, značku BOM. |
| Struktura | Kořen musí být mjml s jedním mj-body; sekce obsahují sloupce, sloupce obsah. Šířky sloupců přes 100 %, smíšené jednotky, prázdné sekce a sloupce, zdvojené klíče. |
| Prvky | Neznámé tagy (s návrhem, co bylo myšleno), prvky, které vykreslovač zahodí nebo přepíše, obrázky bez src či alternativního textu, tlačítka bez odkazu nebo textu. |
| Atributy | Neznámé atributy, atributy jen pro editor, které vykreslovač odstraní, a hodnoty: barvy, velikosti, odsazení, zarovnání, adresy a písma. |
| Bezpečnost HTML | <script>, <iframe>, obsluhy on… a odkazy javascript: v obsahu, neuzavřené nebo osamocené tagy. Ecomail je při importu nečistí, takže se dostanou do e-mailu. |
| Obrázky | Kde je který obrázek uložený: úložiště Ecomailu, staré úložiště S3, externí servery, vložená data, adresy http:// a relativní adresy. |
| Merge tagy | Poškozené nebo neznámé *|TAG|*, špatná velikost písmen a chybějící *|UNSUB|*. |
| Písma a styly | Písma bez záložního písma, vlastní písma, globální atributy a pravidla stylů. |
#Jak číst výsledky
Verdikt je „Připraveno k importu“ (bez chyb a varování), „Naimportuje se, ale projděte varování“ nebo „Naimportuje se a pak se rozbije“ (jakákoli chyba). Každý problém má úroveň, větu, svou cestu v JSONu (například children[0].children[2].attributes.width) a tlačítka, která skočí na řádek ve zdroji nebo na prvek ve stromu.
- Strom
- Strom prvků s ikonami a odznaky problémů. Po výběru prvku uvidíte jeho atributy, problémy a obsah v HTML; Náhled obsahu ho ukáže v izolovaném rámu se zablokovanými skripty.
- Zdroj
- Soubor tak, jak byl nahrán, nebo zformátovaný, s označenými řádky s problémy.
- Rozvržení
- Hrubá mapa sekcí, sloupců a bloků.
- Obrázky a tagy
- Každý obrázek s jeho serverem, tlačítko pro ověření, že se obrázky načtou, merge tagy a písma.
- Statistiky
- Velikost, hloubka a počet každého prvku.
Opravy a stažení vytvoří opravenou kopii: dekóduje dvakrát zakódovaný soubor, odstraní zahazované prvky, atributy jen pro editor a nebezpečné HTML, přepíše začátek adres obrázků a uloží výsledek zformátovaný nebo zhuštěný. Původní soubor se nikdy nemění. Zkontrolovat opravenou kopii otevře výsledek přímo v nástroji. Zprávu lze zkopírovat jako Markdown nebo stáhnout jako JSON.
#Příklad
"attributes": {
"width": "600px",,
"background-color": "#f4f4f4"
}Nástroj napíše „Neplatný JSON na řádku 22, sloupec 26: čekal se název vlastnosti ve dvojitých uvozovkách, je tam ,“ a otevře zdroj na tomto řádku s označeným místem.
#Omezení a záludnosti
- Pravidla odpovídají editoru a vykreslovači Ecomailu; nový prvek nebo atribut se může ukázat jako neznámý, dokud ho nástroj nezná.
- Ověření obrázků je načte ve vašem prohlížeči z vaší IP adresy. Obrázek za přihlášením nebo ze serveru, který blokuje cizí vkládání, se může ukázat jako nenačtený.
- Panel historie si pamatuje jen název souboru a počty problémů. Samotný soubor zůstává v tomto prohlížeči (posledních pět, každý do 1,5 MB), aby šel odtud znovu otevřít.
- Na šablonu v HTML použijte Email HTML Inspector; na převod obrázků Image Converter.