Hapat e parë me Zinnector®, CLI për zhvilluesit

Zinnector® është mjeti falas i linjës së komandës i Zinn Digital® me licencë MIT për zhvilluesit e WordPress. Ai krijon strukturën e një faqeje, ekzekuton një WordPress të vërtetë në makinën tuaj pa asgjë tjetër të instaluar përveç Node — pa Docker, pa MAMP, pa PHP në PATH-in tuaj — më pas kontrollon atë që ndërtuat kundrejt hapësirës së pritjes (hosting slot) ku jeni gati të bëni shpërndarjen (deploy) dhe e ngarkon atë. Ky udhëzues ju çon nga hiçi në një faqe funksionale në rreth dy minuta, dhe ju tregon se si duket suksesi në çdo hap, në mënyrë 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 me Node. Zinnector® e përdor atë një herë, për të shkarkuar mjedisin e ekzekutimit të WordPress në memorien e tij të fshehur (cache).
• git, vetëm për zinnector push — shpërndarjet drejtohen nga depoja juaj.
• Docker, vetëm nëse e kërkoni me --runtime docker. Mjedisi i paracaktuar i ekzekutimit nuk ka nevojë për asnjë.

Asgjë më poshtë nuk kërkon një llogari. Një çelës API nevojitet vetëm kur arrini në një hapësirë pritjeje, te Shpërndarja 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 >=24.18.1 që paketa deklaron. Instalimi përfundon gjithsesi, por CLI do të refuzojë të ekzekutohet. Përmirësoni Node fillimisht, pastaj instalojeni përsëri.

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ë i instaluar, por versioni juaj i Node është shumë i vjetër; komanda përfundon me kodin 78 në vend që të kryejë ndonjë veprim.

Hapi 3 — lexoni ndihmën

zinnector --help

Sukses: një banderolë që emërton pesë komandat e procesit (new, dev, link, check, push) dhe më pas çdo komandë me një përshkrim një-rreshtor të qëllimit të saj. Çdo komandë pranon gjithashtu --help më vete — zinnector dev --help liston flamujt për mjedisin e ekzekutimit, PHP-në dhe portën. Lista e plotë, me shembuj, gjendet në referencën e komandave.

Hapi 4 — krijoni strukturën e një faqeje

zinnector new my-site

Sukses: një titull Created my-site dhe një listë e skedarëve që shkroi — zinnector.json, një pemë wp-content me plugins/, themes/ dhe një ndihmës mu-plugins/, një .gitignore dhe një README — të ndjekura nga komandat e ardhshme për t'u ekzekutuar. Asgjë në të nuk është një vendmbajtës; projekti nis ashtu siç është. --template plugin ose --template theme krijojnë strukturën e një shtojce ose të një teme blloku që aktivizohet në momentin që krijohet.

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 mbart çdo version të ndërtuar të PHP nga 5.2 deri në 8.5 — në dosjen e vet të memories së fshehur, kurrë në projektin tuaj. Përgjigjuni me Y, ose vendosni --yes për të anashkaluar pyetjen. Në Node 26 ose më të ri, ai gjithashtu shkarkon një Node 24 vetëm për mjedisin e ekzekutimit (rreth 30 MB, i verifikuar kundrejt shumave të kontrollit të nodejs.org), sepse moduli vendas i mjedisit të ekzekutimit ka skedarë binarë të parandërtuar vetëm për Node 24 dhe 25; nuk keni nevojë për një kompilues ose Visual Studio.

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

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

Hapi 6 — hapeni

Vizitoni http://127.0.0.1:9400 në një shfletues. Sukses: një faqe e re WordPress me titull My WordPress Website, e shërbyer nga versioni i PHP që kërkuat. http://127.0.0.1:9400/wp-admin hap panelin e kontrollit tashmë të identifikuar. Vendosni një shtojcë në wp-content/plugins/ ose një temë në wp-content/themes/ dhe ajo gjendet aty në rifreskimin e radhës — mjedisi i ekzekutimit i shërben ato dosje drejtpërdrejt nga projekti juaj.

Shtypni Ctrl-C për ta ndaluar. zinnector dev --once nis mjedisin e ekzekutimit, printon se çfarë po ekzekutohet realisht (versionin e PHP, versionin e WordPress, shtesat e ngarkuara) dhe ndalon — e dobishme kur dëshironi prova në vend të një premtimi.

Ku të shkoni më pas

• Zhvillimi lokal me zinnector dev — dy mjediset e ekzekutimit, zgjedhja e versioneve të PHP dhe WordPress, dhe çfarë shërbehet nga ku.
• Shpërndarja me Zinnector® — identifikohuni, lidhni projektin me një hapësirë, kryeni kontrollin paraprak, ngarkojeni.
• Referenca e komandave — çdo komandë, flamur dhe shembull.
• Zgjidhja e problemeve — gabimet me të cilat njerëzit përballen realisht, dhe zgjidhja për secilin.

I njëjti dokumentacion gjendet në skedarin README të paketës në npm dhe në GitHub, ku raportimet e problemeve dhe kërkesat për tërheqje janë të mirëpritura.