Първи стъпки със Zinnector®, интерфейсът с команден ред за разработчици

Zinnector® е безплатният инструмент за команден ред с лиценз MIT на Zinn Digital® за разработчици на WordPress. Той създава базовата структура на сайт, стартира истински WordPress на Вашата собствена машина без инсталирано нищо друго освен Node — без Docker, без MAMP, без PHP във Вашия PATH — след което проверява създаденото от Вас спрямо хостинг слота, към който предстои да внедрите, и го качва. Това ръководство Ви превежда от нулата до работещ сайт за около две минути и Ви показва как изглежда успехът на всяка стъпка, за да знаете, когато нещо се обърка.

Какво Ви е необходимо

• Node 24 или по-нова версия. Изпълнете node --version; трябва да изведе v24 или по-висока. Инсталирайте текущата LTS версия от nodejs.org — на Windows winget install OpenJS.NodeJS.LTS, на macOS brew install node@24.
• npm, който идва заедно с Node. Zinnector® го използва еднократно, за да изтегли средата за изпълнение на WordPress в собствения си кеш.
• git, единствено за zinnector push — внедряванията се управляват от Вашето хранилище.
• Docker, единствено ако го изискате с --runtime docker. Средата за изпълнение по подразбиране не се нуждае от такъв.

Нищо от изброеното по-долу не изисква акаунт. API ключ е необходим само когато стигнете до хостинг слот, в Внедряване със Zinnector®.

Стъпка 1 — инсталирайте го

npm install -g zinnector

Ако npm изведе npm WARN EBADENGINE, Вашият Node е по-стар от >=24.18.1, както декларира пакетът. Инсталацията ще завърши въпреки това, но CLI ще откаже да се стартира. Първо надградете Node, след което инсталирайте отново.

Стъпка 2 — проверете версията

zinnector --version

Успех: номер на версия, например 0.1.2. Ако видите „Zinnector® needs Node 24 or newer — this is Node 20.x“, изпълнимият файл е инсталиран, но Вашият Node е твърде стар; командата прекратява изпълнението с код 78, вместо да прави каквото и да било.

Стъпка 3 — прочетете помощната информация

zinnector --help

Успех: банер с имената на петте команди от работния процес (new, dev, link, check, push) и след това всяка команда с нейното предназначение в един ред. Всяка команда също приема собствен --help — zinnector dev --help извежда флаговете за средата за изпълнение, PHP и порта. Пълният списък с примери се намира в справочника за команди.

Стъпка 4 — създайте базовата структура на сайт

zinnector new my-site

Успех: заглавие Created my-site и списък на записаните файлове — zinnector.json, дървовидна структура wp-content с plugins/, themes/ и помощен модул mu-plugins/, .gitignore и README — последвани от следващите команди за изпълнение. Нищо в него не е заместител; проектът стартира както си е. --template plugin или --template theme създават базовата структура на плъгин или блокова тема, която се активира в момента, в който бъде създадена.

Стъпка 5 — стартирайте го

cd my-site
zinnector dev

Първия път Zinnector® пита веднъж, преди да изтегли средата за изпълнение на WordPress — около 570 MB, тъй като съдържа всяка компилация на PHP от 5.2 до 8.5 — в собствената си кеш директория, никога във Вашия проект. Отговорете с Y или подайте --yes, за да пропуснете въпроса. При Node 26 или по-нова версия той също така изтегля Node 24 само за средата за изпълнение (около 30 MB, проверени спрямо контролните суми на nodejs.org), тъй като нейният нативен модул разполага с предварително компилирани двоични файлове само за Node 24 и 25; не се нуждаете от компилатор или Visual Studio.

Успех: блок, който посочва проекта, версията на PHP и версията на WordPress, последван от:

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

Стъпка 6 — отворете го

Посетете http://127.0.0.1:9400 в браузър. Успех: нов WordPress сайт, озаглавен My WordPress Website, обслужван от версията на PHP, която сте поискали. http://127.0.0.1:9400/wp-admin отваря таблото за управление с вече осъществен вход. Поставете плъгин в wp-content/plugins/ или тема в wp-content/themes/ и те са там при следващото презареждане — средата за изпълнение обслужва тези директории директно от Вашия проект.

Натиснете Ctrl-C, за да спрете. zinnector dev --once стартира средата за изпълнение, извежда какво точно работи (версия на PHP, версия на WordPress, заредени разширения) и спира — полезно, когато искате доказателство, а не просто обещание.

Накъде да продължите

• Локална разработка със zinnector dev — двете среди за изпълнение, избор на версии на PHP и WordPress и какво откъде се обслужва.
• Внедряване със Zinnector® — влизане в профила, свързване на проекта към слот, предварителна проверка, качване.
• Справочник за команди — всяка команда, флаг и пример.
• Отстраняване на неизправности — грешките, с които хората реално се сблъскват, и решението за всяка от тях.

Същата документация е налична в README на пакета в npm и в GitHub, където сигналите за проблеми и pull заявките са добре дошли.