Paga e parë me Zinnector®, CLI-ja e zhvilluesit

Zinnector® është mjeti falas për rreshtin e komandave i licencuar nën MIT nga Zinn Digital® për zhvilluesit e WordPress. Ai përgatit strukturën e një sajti, ekzekuton një WordPress origjinal në kompjuterin tuaj pa instaluar gjë tjetër veç Node — pa Docker, pa MAMP, pa PHP në PATH-in tuaj — më pas kontrollon atë që keni ndërtuar në raport me slotin e pritjes (hosting) ku jeni gati ta vendosni dhe e dërgon atë. Ky udhëzues ju çon nga asgjë te një sajt funksional në rreth dy minuta dhe ju tregon se si duket suksesi në çdo hap, që ta dini kur diçka ka shkuar keq.

Çfarë ju nevojitet

Node 24 ose më i ri. Ekzekutoni node --version; duhet të shfaqë v24 ose më të lartë. Instaloni versionin aktual LTS nga nodejs.org — në Windows winget install OpenJS.NodeJS.LTS, në macOS brew install node@24.
npm, i cili vjen së bashku me Node. Zinnector® e përdor atë një herë, për të shkarkuar mjedisin e ekzekutimit (runtime) të WordPress në memorien e tij fshehëse (cache).
git, vetëm për zinnector push — vendosjet (deploys) drejtohen nga depozitari juaj.
Docker, vetëm nëse e kërkoni me --runtime docker. Mjedisi i paracaktuar i ekzekutimit nuk kërkon asnjë.

Asgjë më poshtë nuk kërkon llogari. Një çelës API nevojitet vetëm kur arrini në një slot pritjeje (hosting), te Vendosja me Zinnector®.

Hapi 1 — instalojeni

npm install -g zinnector

Nëse npm shfaq npm WARN EBADENGINE, versioni juaj i Node është më i vjetër se ai >=24.18.1 që deklaron paketa. Instalimi përfundon gjithsesi, por CLI do të refuzojë të ekzekutohet. Përditësoni fillimisht Node dhe më pas instalojeni sërish.

Hapi 2 — kontrolloni versionin

zinnector --version

Sukses: një numër versioni, për shembull 0.1.2. Nëse shihni "Zinnector® needs Node 24 or newer — this is Node 20.x" skedari binar është instaluar, por versioni juaj i Node është shumë i vjetër; komanda ndërpritet me kodin 78 në vend që të bëjë diçka.

Hapi 3 — lexoni ndihmën

zinnector --help

Sukses: një baner që emërton pesë komandat e rrjedhës (new, dev, link, check, push) dhe më pas secilën komandë me një qëllim në një rresht të vetëm. Çdo komandë pranon gjithashtu --help të sajën — zinnector dev --help liston flamurët e mjedisit të ekzekutimit, PHP-së dhe portës. Lista e plotë, me shembuj, gjendet te referenca e komandave.

Hapi 4 — përgatitni strukturën e një sajti

zinnector new my-site

Sukses: një titull Created my-site dhe një listë e skedarëve që ka shkruar — zinnector.json, një pemë direktorish wp-content me plugins/, themes/ dhe një ndihmës mu-plugins/, një .gitignore dhe një README — e ndjekur nga komandat e radhës për t'u ekzekutuar. Asgjë në të nuk është vendmbajtëse (placeholder); projekti niset ashtu siç është. --template plugin ose --template theme krijojnë strukturën e një shtojce (plugin) ose një teme blloku që aktivizohet sapo ekziston.

Hapi 5 — ekzekutojeni

cd my-site
zinnector dev

Herën e parë, Zinnector® pyet një herë përpara se të shkarkojë mjedisin e ekzekutimit të WordPress — rreth 570 MB, sepse përmban çdo version të PHP nga 5.2 deri në 8.5 — në direktorinë e tij fshehëse, kurrë brenda projektit tuaj. Përgjigjuni Y, ose kaloni --yes për të anashkaluar pyetjen. Në Node 26 ose më të ri, ai merr gjithashtu një Node 24 vetëm për mjedisin e ekzekutimit (rreth 30 MB, të verifikuara kundrejt shumave kontrolluese (checksums) të nodejs.org), sepse moduli vendor i mjedisit të ekzekutimit ka binarë të parafabrikuar vetëm për Node 24 dhe 25; nuk ju nevojitet një përpilues (compiler) ose Visual Studio.

Sukses: një bllok që emërton projektin, versionin e PHP dhe versionin e WordPress, pastaj:

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

Hapi 6 — hapat e tjerë

Vizitoni http://127.0.0.1:9400 në një shfletues. Sukses: një sajt i ri WordPress i titulluar My WordPress Website, i shërbyer nga versioni i PHP që keni kërkuar. http://127.0.0.1:9400/wp-admin hap panelin e kontrollit tashmë të kyçur. Vendosni një shtojcë te wp-content/plugins/ ose një temë te wp-content/themes/ dhe ajo do të jetë atje në ringarkimin e radhës — mjedisi i ekzekutimit u shërben atyre direktorive drejtpërdrejt nga projekti juaj.

Shtypni Ctrl-C për të ndaluar. zinnector dev --once nis mjedisin e ekzekutimit, printon atë që po ekzekutohet aktualisht (versioni i PHP, versioni i WordPress, shtesat e ngarkuara) dhe ndalet — i dobishëm kur doni provë në vend të një premtimi.

Ku të shkoni më pas

Zhvillimi vendor me zinnector dev — dy mjediset e ekzekutimit, zgjedhja e versioneve të PHP dhe WordPress, dhe se çfarë shërbehet nga ku.
Vendosja me Zinnector® — kyçuni, lidhni projektin me një slot, bëni kontrollin paraprak, dërgojeni.
Referenca e komandave — çdo komandë, flamur dhe shembull.
Zgjidhja e problemeve — gabimet me të cilat ndeshen njerëzit në të vërtetë, dhe zgjidhja për secilin prej tyre.

I njëjti dokumentacion gjendet te README i paketës në npm dhe në GitHub, ku çështjet dhe kërkesat për bashkim (pull requests) janë të mirëpritura.