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

Zinnector® е безплатният инструмент за команден ред на Zinn Digital® с лиценз MIT за разработчици на 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) и след това всяка команда с кратко описание на целта в един ред. Всяка команда поддържа и собствени параметри за помощ – 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 отваря таблото за управление (dashboard) с вече влязъл потребител. Поставете плъгин в wp-content/plugins/ или тема в wp-content/themes/ и тя ще бъде налице при следващото презареждане – изпълнимата среда обслужва тези директории директно от вашия проект.

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

Къде да отидете след това

• Локална разработка с zinnector dev – двете изпълними среди, избор на PHP и WordPress версии и какво откъде се обслужва.
• Деплой с Zinnector® – влизане в системата, свързване на проекта към слот, проверка преди полет (pre-flight), качване.
• Справочник на командите – всяка команда, флаг и пример.
• Отстраняване на неизправности – грешките, с които хората реално се сблъскват, и решението за всяка от тях.

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