Začínáme se Zinnector®, rozhraním příkazového řádku pro vývojáře

Zinnector® je bezplatný nástroj příkazového řádku s licencí MIT od společnosti Zinn Digital® určený pro vývojáře WordPress. Vytvoří kostru webu, spustí skutečný WordPress na Vašem vlastním počítači bez nutnosti instalovat cokoli kromě Node — žádný Docker, žádný MAMP, žádné PHP ve Vaší proměnné PATH — poté zkontroluje vytvořený projekt vůči hostingovému slotu, do kterého se chystáte nasazovat, a odešle jej. Tento průvodce Vás provede od úplného začátku až ke spuštěnému webu přibližně za dvě minuty a u každého kroku Vám ukáže, jak vypadá úspěšný výsledek, abyste poznali, když se něco pokazí.

Co budete potřebovat

• Node 24 nebo novější. Spusťte node --version; výstupem musí být v24 nebo vyšší. Nainstalujte aktuální verzi LTS z webu nodejs.org — ve Windows pomocí winget install OpenJS.NodeJS.LTS, v macOS pomocí brew install node@24.
• npm, které je součástí instalace Node. Zinnector® jej použije pouze jednou, a to ke stažení běhového prostředí WordPress do své vlastní mezipaměti.
• git, pouze pro příkaz zinnector push — nasazení jsou řízena z Vašeho repozitáře.
• Docker, pouze pokud jej výslovně vyžádáte pomocí --runtime docker. Výchozí běhové prostředí jej vůbec nepotřebuje.

Nic z níže uvedeného nevyžaduje uživatelský účet. Klíč API je zapotřebí až ve chvíli, kdy přejdete k hostingovému slotu, v části Nasazení pomocí nástroje Zinnector®.

Krok 1 — instalace

npm install -g zinnector

Pokud npm vypíše npm WARN EBADENGINE, Vaše verze Node je starší než deklarovaná verze >=24.18.1. Instalace se přesto dokončí, ale rozhraní CLI se odmítne spustit. 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í hlášení „Zinnector® needs Node 24 or newer — this is Node 20.x“, binární soubor je nainstalován, ale Vaše verze Node je příliš stará; příkaz namísto jakékoli akce skončí s návratovým kódem 78.

Krok 3 — zobrazení nápovědy

zinnector --help

Úspěch: úvodní přehled uvádějící pět příkazů celého pracovního postupu (new, dev, link, check, push) a následně každý příkaz s jednořádkovým popisem jeho účelu. Každý příkaz navíc podporuje svůj vlastní přepínač --help — zinnector dev --help zobrazí seznam příznaků pro běhové prostředí, PHP a porty. Kompletní seznam včetně příkladů naleznete v přehledu příkazů.

Krok 4 — vytvoření kostry webu

zinnector new my-site

Úspěch: nadpis Created my-site a seznam zapsaných souborů — zinnector.json, stromová struktura wp-content se složkami plugins/, themes/ a pomocným souborem v mu-plugins/, dále .gitignore a README — následované dalšími příkazy ke spuštění. Žádná část neobsahuje zástupný obsah; projekt se spustí v přesně takovém stavu, v jakém je. Přepínače --template plugin nebo --template theme vytvoří kostru pluginu nebo blokové šablony, která se aktivuje okamžitě po svém vytvoření.

Krok 5 — spuštění

cd my-site
zinnector dev

Při prvním spuštění se Zinnector® jednou dotáže, než stáhne běhové prostředí WordPress — o velikosti přibližně 570 MB, jelikož obsahuje každé sestavení PHP od verze 5.2 do 8.5 — do své vlastní mezipaměti, nikdy do Vašeho projektu. Odpovězte Y, nebo předejte přepínač --yes, abyste tuto otázku přeskočili. Na Node 26 nebo novějším stáhne také Node 24 určený výhradně pro běhové prostředí (přibližně 30 MB, ověřeno vůči kontrolním součtům z nodejs.org), protože nativní modul běhového prostředí má předpřipravené binární soubory pouze pro Node 24 a 25; nepotřebujete překladač ani Visual Studio.

Úspěch: blok informací uvádějící název projektu, verzi PHP a verzi WordPress, 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í webu

Otevřete adresu http://127.0.0.1:9400 ve svém prohlížeči. Úspěch: nově nainstalovaný web WordPress s názvem My WordPress Website, obsluhovaný požadovanou verzí PHP. Adresa http://127.0.0.1:9400/wp-admin otevře nástěnku administrace již v přihlášeném stavu. Vložte plugin do složky wp-content/plugins/ nebo šablonu do wp-content/themes/ a při dalším načtení stránky bude okamžitě k dispozici — běhové prostředí tyto adresáře obsluhuje přímo z Vašeho projektu.

Stisknutím Ctrl-C běh ukončíte. Příkaz zinnector dev --once spustí běhové prostředí, vypíše skutečně běžící konfiguraci (verzi PHP, verzi WordPress, načtená rozšíření) a zastaví se — což je praktické, pokud potřebujete spíše ověřený důkaz než příslib.

Kam pokračovat dál

• Místní vývoj pomocí zinnector dev — dvě běhová prostředí, výběr verzí PHP a WordPress a co je odkud obsluhováno.
• Nasazení pomocí nástroje Zinnector® — přihlášení, propojení projektu se slotem, předletová kontrola, odeslání.
• Přehled příkazů — všechny příkazy, přepínače a příklady.
• Řešení problémů — chyby, se kterými se uživatelé v praxi setkávají, a řešení pro každou z nich.

Stejnou dokumentaci naleznete v souboru README daného balíčku na platformách npm a GitHub, kde můžete také hlásit problémy a zasílat pull requesty.