Geliştirici CLI aracı olan Zinnector® ile çalışmaya başlama

Zinnector®, Zinn Digital®'ın WordPress geliştiricileri için sunduğu ücretsiz ve MIT lisanslı komut satırı aracıdır. Bir siteyi iskeletlendirir, makinenizde Node dışında hiçbir şey kurulu olmadan — Docker yok, MAMP yok, PATH'inizde PHP yok — gerçek bir WordPress çalıştırır, ardından oluşturduğunuz yapıyı dağıtım yapmak üzere olduğunuz barındırma yuvasına göre denetler ve gönderir. Bu kılavuz sizi yaklaşık iki dakika içinde sıfırdan çalışan bir siteye ulaştırır ve bir şeylerin ne zaman ters gittiğini anlayabilmeniz için her adımda başarının nasıl göründüğünü gösterir.

İhtiyacınız olanlar

• Node 24 veya daha yenisi. node --version komutunu çalıştırın; v24 veya daha yükseğini yazdırmalıdır. nodejs.org adresinden güncel LTS sürümünü kurun — Windows'ta winget install OpenJS.NodeJS.LTS, macOS'ta brew install node@24.
• Node ile birlikte gelen npm. Zinnector®, WordPress çalışma zamanını kendi önbelleğine indirmek için bunu bir kez kullanır.
• Yalnızca zinnector push için git — dağıtımlar deponuz üzerinden yürütülür.
• Yalnızca --runtime docker ile talep ederseniz Docker. Varsayılan çalışma zamanı hiçbirine ihtiyaç duymaz.

Aşağıdakilerin hiçbiri bir hesap gerektirmez. API anahtarına yalnızca bir barındırma yuvasına ulaştığınızda, Zinnector® ile Dağıtım bölümünde ihtiyaç duyulur.

1. Adım — kurun

npm install -g zinnector

npm npm WARN EBADENGINE uyarısı verirse, Node sürümünüz paketin bildirdiği >=24.18.1 sürümünden daha eskidir. Kurulum yine de tamamlanır, ancak CLI çalışmayı reddeder. Önce Node sürümünü yükseltin, ardından tekrar kurun.

2. Adım — sürümü kontrol edin

zinnector --version

Başarı: örneğin 0.1.2 gibi bir sürüm numarası. "Zinnector® needs Node 24 or newer — this is Node 20.x" uyarısını görürseniz ikili dosya kurulmuştur ancak Node sürümünüz çok eskidir; komut herhangi bir işlem yapmak yerine 78 çıkış koduyla sonlanır.

3. Adım — yardımı okuyun

zinnector --help

Başarı: akışın beş komutunu (new, dev, link, check, push) adlandıran bir başlık ve ardından tek satırlık amacıyla birlikte her komut. Her komut ayrıca kendine ait bir --help bağımsız değişkeni alır — zinnector dev --help çalışma zamanı, PHP ve bağlantı noktası işaretçilerini listeler. Örneklerle birlikte listenin tamamı komut referansı bölümündedir.

4. Adım — bir site iskeleti oluşturun

zinnector new my-site

Başarı: bir Created my-site başlığı ve yazdığı dosyaların bir listesi — zinnector.json, plugins/, themes/ ve bir mu-plugins/ yardımcısı içeren bir wp-content ağacı, bir .gitignore ve bir README — ardından çalıştırılacak sonraki komutlar. İçindeki hiçbir şey yer tutucu değildir; proje olduğu gibi başlar. --template plugin veya --template theme, var olduğu anda etkinleşen bir eklenti veya blok teması iskeleti oluşturur.

5. Adım — çalıştırın

cd my-site
zinnector dev

İlk seferde Zinnector®, WordPress çalışma zamanını — 5.2'den 8.5'e kadar her PHP derlemesini taşıdığı için yaklaşık 570 MB — projenizin içine asla değil, kendi önbellek dizinine indirmeden önce bir kez onay ister. Y yanıtını verin veya soruyu atlamak için --yes parametresini geçin. Node 26 veya daha yenisinde, çalışma zamanının yerel modülü yalnızca Node 24 ve 25 için önceden derlenmiş ikili dosyalara sahip olduğundan, yalnızca çalışma zamanı için bir Node 24 de getirir (nodejs.org'un sağlama toplamlarına göre doğrulanmış yaklaşık 30 MB); bir derleyiciye veya Visual Studio'ya ihtiyacınız yoktur.

Başarı: projeyi, PHP sürümünü ve WordPress sürümünü adlandıran bir blok, ardından:

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

6. Adım — açın

Bir tarayıcıda http://127.0.0.1:9400 adresini ziyaret edin. Başarı: talep ettiğiniz PHP sürümü tarafından sunulan, My WordPress Website başlıklı yeni bir WordPress sitesi. http://127.0.0.1:9400/wp-admin adresi oturum açılmış şekilde yönetim panelini açar. wp-content/plugins/ dizinine bir eklenti veya wp-content/themes/ dizinine bir tema bırakın; sonraki yeniden yüklemede orada olacaktır — çalışma zamanı bu dizinleri doğrudan projenizden sunar.

Durdurmak için Ctrl-C tuşlarına basın. zinnector dev --once komutu çalışma zamanını başlatır, gerçekte neyin çalıştığını yazdırır (PHP sürümü, WordPress sürümü, yüklü uzantılar) ve durur — bir vaat yerine kanıt istediğinizde kullanışlıdır.

Sıradaki adımlar

• zinnector dev ile yerel geliştirme — iki çalışma zamanı, PHP ve WordPress sürümlerini seçme ve neyin nereden sunulduğu.
• Zinnector® ile Dağıtım — oturum açın, projeyi bir yuvaya bağlayın, ön denetim yapın, gönderin.
• Komut referansı — her komut, işaretçi ve örnek.
• Sorun Giderme — kullanıcıların gerçekten karşılaştığı hatalar ve her biri için çözüm.

Aynı belgelere npm üzerindeki paketin README dosyasından ve sorun bildirimleri ile çekme isteklerinin memnuniyetle karşılandığı GitHub üzerinden ulaşabilirsiniz.