بدء الاستخدام مع Zinnector®، واجهة سطر الأوامر للمطورين

إن Zinnector® هي أداة سطر أوامر مجانية ومرخصة بموجب MIT من Zinn Digital® لمطوري 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) متبوعاً بكل أمر مع سطر يوضح الغرض منه. يدعم كل أمر أيضاً خيار --help الخاص به — يعرض 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 ميغابايت تقريباً، لأنها تتضمن كافة إصدارات PHP من 5.2 إلى 8.5 — في مجلد ذاكرة التخزين المؤقت الخاص بها، وليس داخل مشروعك أبداً. أجب بـ Y، أو مرر --yes لتخطي السؤال. في إصدار Node 26 أو الأحدث، يتم أيضاً جلب إصدار Node 24 لبيئة التشغيل وحدها (حوالي 30 ميغابايت، تم التحقق منها عبر مجاميع التحقق الخاصة بـ 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 لوحة التحكم مسجلاً الدخول بالفعل. أضف إضافة في wp-content/plugins/ أو قالباً في wp-content/themes/ وسيظهر هناك عند إعادة التحميل التالية — حيث تقدم بيئة التشغيل تلك المجلدات مباشرة من مشروعك.

اضغط على Ctrl-C للإيقاف. يقوم الأمر zinnector dev --once ببدء تشغيل بيئة التشغيل، وطباعة ما يعمل بالفعل (إصدار PHP، إصدار WordPress، الإضافات المحملة) ثم يتوقف — وهو أمر مفيد عندما تريد دليلاً ملموساً بدلاً من مجرد افتراض.

وجهتك التالية

• التطوير المحلي باستخدام zinnector dev — بيئتا التشغيل، واختيار إصدارات PHP وWordPress، وما يتم تقديمه ومن أي مسار.
• النشر باستخدام Zinnector® — تسجيل الدخول، وربط المشروع بحصة استضافة، والفحص المسبق، والرفع.
• مرجع الأوامر — كل أمر وعلامة ومثال.
• استكشاف الأخطاء وإصلاحها — الأخطاء الفعلية التي يواجهها المستخدمون، والحل لكل منها.

تتوفر الوثائق نفسها في ملف README الخاص بالحزمة على npm وعلى GitHub، حيث نرحب بالإبلاغ عن المشكلات وطلبات السحب (pull requests).