תחילת העבודה עם Zinnector®, ממשק שורת הפקודה למפתחים

Zinnector® הוא כלי שורת הפקודה החינמי ברישיון MIT של Zinn Digital® עבור מפתחי WordPress. הוא יוצר שלד לאתר, מריץ WordPress אמיתי במחשב שלכם ללא שום התקנה מלבד Node — בלי Docker, בלי MAMP, ובלי PHP ב-PATH שלכם — לאחר מכן בודק את מה שבניתם מול משבצת האחסון שאליה אתם עומדים לפרוס ומבצע push. מדריך זה מוביל אתכם מכלום לאתר פעיל תוך כשתי דקות, ומסביר כיצד נראית הצלחה בכל שלב כדי שתדעו מתי משהו השתבש.

מה נדרש

• 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 — ולאחר מכן הפקודות הבאות להרצה. שום דבר בו אינו מציין מיקום (placeholder); הפרויקט עולה כפי שהוא. --template plugin או --template theme יוצרים שלד של תוסף או תבנית בלוקים שמופעלים ברגע שהם קיימים.

שלב 5 — הרצה

cd my-site
zinnector dev

בפעם הראשונה, Zinnector® שואל פעם אחת לפני הורדת סביבת הריצה של WordPress — כ-570 MB, כיוון שהיא כוללת כל build של PHP מ-5.2 עד 8.5 — אל תוך ספריית המטמון שלו, לעולם לא לתוך הפרויקט שלכם. השיבו Y, או העבירו --yes כדי לדלג על השאלה. ב-Node 26 ומעלה הוא מוריד בנוסף Node 24 עבור סביבת הריצה בלבד (כ-30 MB, מאומת מול סכומי הביקורת של nodejs.org), מכיוון שלמודול ה-native של סביבת הריצה יש קבצים בינאריים בנויים מראש רק עבור Node 24 ו-25; אינכם זקוקים למהדר (compiler) או ל-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® — כניסה לחשבון, קישור הפרויקט למשבצת, בדיקות מקדימות, push.
• מדריך הפקודות — כל פקודה, דגל ודוגמה.
• פתרון בעיות — השגיאות שאנשים נתקלים בהן בפועל, והפתרון לכל אחת מהן.

אותו תיעוד מופיע ב-README של החבילה ב-npm וב-GitHub, שם נשמח לקבל דיווח על תקלות ו-pull requests.