Začínáme se Zinnector® – vývojářským CLI

Zinnector® je bezplatný nástroj příkazového řádku od společnosti Zinn Digital® s licencí MIT pro vývojáře v systému WordPress. Vytvořit strukturu webu, spustit skutečný WordPress na vašem vlastním počítači bez nutnosti instalace čehokoli kromě Node — bez Dockeru, bez MAMP, bez PHP v proměnné PATH — zkontrolovat to, co jste vytvořili, proti hostovacímu slotu, na který se chystáte nasadit, a odeslat to. Tato příručka vás provede cestou od ničeho k fungujícímu webu za přibližně dvě minuty a na každém kroku vám ukáže, jak vypadá úspěch, abyste věděli, kdy se něco pokazilo.

Co budete potřebovat

• Node 24 nebo novější. Spusťte node --version; musí se zobrazit v24 nebo vyšší. Nainstalujte si aktuální verzi LTS z webu nodejs.org — v systému Windows winget install OpenJS.NodeJS.LTS, v systému macOS brew install node@24.
• npm, který je součástí Node. Zinnector® jej použije jednou ke stažení běhového prostředí WordPress do vlastní mezipaměti.
• git, pouze pro příkaz zinnector push — nasazení se spouští z vašeho úložiště.
• Docker, pouze pokud jej vyžádáte pomocí přepínače --runtime docker. Výchozí běhové prostředí nevyžaduje žádný.

Nic z níže uvedeného nevyžaduje účet. Klíč API je vyžadován pouze při dosažení hostovacího slotu, v části Nasazení pomocí nástroje Zinnector®.

Krok 1 — instalace

npm install -g zinnector

Pokud npm vypíše npm WARN EBADENGINE, váš Node je starší než verze >=24.18.1, kterou balíček deklaruje. Instalace přesto proběhne do konce, ale rozhraní CLI odmítne běžet. Nejprve aktualizujte Node a poté proveďte instalaci znovu.

Krok 2 — kontrola verze

zinnector --version

Úspěch: číslo verze, například 0.1.2. Pokud se zobrazí text "Zinnector® needs Node 24 or newer — this is Node 20.x", binární soubor je nainstalován, ale váš Node je příliš starý; příkaz se ukončí s kódem 78, aniž by cokoli udělal.

Krok 3 — přečtení nápovědy

zinnector --help

Úspěch: banner uvádějící pět příkazů pracovního postupu (new, dev, link, check, push) a následně každý příkaz s jednorádkovým účelem. Každý příkaz má také vlastní přepínač --help — zinnector dev --help vypíše příznaky běhového prostředí, PHP a portů. Kompletní seznam s příklady najdete v příkazu reference.

Krok 4 — vytvoření struktury webu

zinnector new my-site

Úspěch: nadpis Created my-site a seznam zapsaných souborů — zinnector.json, strom wp-content s adresáři plugins/, themes/ a pomocným souborem mu-plugins/, soubor .gitignore a soubor README — následovaný dalšími příkazy ke spuštění. Nic v něm není zástupný symbol; projekt se spustí v takovém stavu, v jakém je. --template plugin nebo --template theme vytvoří strukturu pluginu nebo blokového schématu, které se aktivují v okamžiku, kdy existují.

Krok 5 — spuštění

cd my-site
zinnector dev

Při prvním spuštění se Zinnector® jednou zeptá před stažením běhového prostředí WordPress — přibližně 570 MB, protože obsahuje každou sestavu PHP od verze 5.2 do 8.5 — do vlastního adresáře mezipaměti, nikdy ne do vašeho projektu. Odpovězte Y, nebo předejte přepínač --yes pro přeskočení této otázky. V systému Node 26 nebo novějším se také stáhne Node 24 pouze pro běhové prostředí (přibližně 30 MB, ověřeno oproti kontrolním součtům na webu nodejs.org), protože nativní modul běhového prostředí má předem sestavené binární soubory pouze pro Node 24 a 25; nepotřebujete kompilátor ani Visual Studio.

Úspěch: blok, který uvádí název projektu, verzi PHP a verzi WordPressu, a poté:

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

Krok 6 — otevření

Navštivte adresu http://127.0.0.1:9400 v prohlížeči. Úspěch: nový web WordPress s názvem My WordPress Website, obsluhovaný verzí PHP, kterou jste požadovali. Adresa http://127.0.0.1:9400/wp-admin otevře řídicí panel s již provedeným přihlášením. Vložte plugin do adresáře wp-content/plugins/ nebo šablonu do adresáře wp-content/themes/ a při příštím načtení tam bude — běhové prostředí obsluhuje tyto adresáře přímo z vašeho projektu.

Stisknutím kláves Ctrl-C zastavíte provoz. Příkaz zinnector dev --once spustí běhové prostředí, vytiskne to, co skutečně běží (verzi PHP, verzi WordPressu, načtená rozšíření) a zastaví se — užitečné, když chcete důkaz namísto slibu.

Kam pokračovat

• Místní vývoj pomocí příkazu zinnector dev — obě běhová prostředí, výběr verzí PHP a WordPressu a to, co se odkud obsluhuje.
• Nasazení pomocí nástroje Zinnector® — přihlášení, propojení projektu se slotem, předletová kontrola, odeslání.
• Reference příkazů — každý příkaz, přepínač a příklad.
• Řešení potíží — chyby, se kterými se uživatelé skutečně setkávají, a řešení pro každou z nich.

Táž dokumentace je k dispozici v souboru README balíčku na webu npm a na webu GitHub, kde jsou vítány hlášení chyb a žádosti o stažení (pull requesty).