قاعدة المعرفة

مرجع أوامر Zinnector®

كل أمر من أوامر Zinnector® تمامًا كما يسرده zinnector --help — الوسائط والخيارات والإعدادات الافتراضية، ومثال قابل للتشغيل وما يطبعه — تم إنشاؤه من واجهة سطر الأوامر (CLI) نفسها حتى لا يختلف عن الإصدار المثبت لديكم.

كل أمر يفهمه Zinnector® 0.1.6 — 43 في المجموع، تماماً كما يدرجها zinnector --help — مع خياراته، ومثال قابل للتشغيل، وما ينبغي أن يظهر لك. تم إنشاء هذه الصفحة من واجهة سطر الأوامر نفسها، لذا لا يمكن أن تختلف عن الأداة التي قمت بتثبيتها؛ إذا كان هناك أمر مفقود هنا على جهازك، فقم بتشغيل npm install -g zinnector@latest.

قبل أن تبدأ

قم بتثبيته باستخدام npm install -g zinnector على Node 24 أو أحدث، ثم تحقق من التثبيت باستخدام zinnector --version و zinnector --help. يشرح دليل البدء أول خمس دقائق؛ وهذه الصفحة هي المرجع الذي تعود إليه.

يقبل كل أمر الخيارين -h, --help. توضع هذه الخيارات العامة قبل اسم الأمر:

الخيار	وظيفته
`-V, --version`	طباعة الإصدار
`--profile <name>`	استخدام ملف اعتماد مسمى

الأوامر

`zinnector new`

إنشاء هيكل لمشروع WordPress يمكنك تشغيله على الفور.

zinnector new [options] [name]

الوسيط	مطلوب	الوصف
`name`	لا	الدليل المراد إنشاء المشروع فيه، واسم المشروع — مطلوب ما لم يتم استخدام --here

الخيار	وظيفته	القيمة الافتراضية
`-t, --template <kind>`	واحد من: site، أو plugin، أو theme	`"site"`
`--php <version>`	إصدار PHP المستهدف للتطوير	`"8.3"`
`--wp <version>`	إصدار WordPress لبيئة التشغيل المحلية	`"latest"`
`--runtime <name>`	playground أو docker	`"playground"`
`--here`	الإنشاء داخل الدليل الحالي بدلاً من دليل جديد

مثال

zinnector new my-site

ما تراه — تم التقاطه — 0.1.2 على Linux

Created my-site  ·  site
──────────────────────────

  + .gitignore
  + README.md
  + wp-content/mu-plugins/000-zinnector-dev.php
  + wp-content/plugins/.gitkeep
  + wp-content/themes/.gitkeep
  + zinnector.json

  php        8.3
  wordpress  latest
  runtime    playground

→ run it:
    cd my-site
    zinnector dev

→ then, when you have a hosting slot:
    zinnector link     # point it at a site
    zinnector check    # pre-flight before you push
    zinnector push

`zinnector dev`

شغّل هذا المشروع محلياً — لا يلزم وجود Docker.

zinnector dev [options]

الخيار	ما يفعله	القيمة الافتراضية
`--php <version>`	إصدار PHP للتشغيل (5.2–8.5 على playground، 7.4–8.5 على docker)
`--wp <version>`	إصدار WordPress
`-p, --port <port>`	المنفذ للخدمة عليه
`--runtime <name>`	playground (افتراضي) أو docker
`--login`	تسجيل الدخول كمسؤول تلقائيًا	`true`
`--no-login`	عدم تسجيل الدخول تلقائيًا
`--once`	الإقلاع، الإبلاغ عما قيد التشغيل، ثم التوقف
`--yes`	تثبيت بيئة التشغيل المحلية دون سؤال
`--reset-runtime`	حذف بيئة التشغيل المثبتة وتثبيتها مرة أخرى
`-v, --verbose`	إظهار المخرجات الخاصة ببيئة التشغيل

مثال

cd my-site
zinnector dev

ما تراه — تم التقاطه — 0.1.2. يطلب التشغيل الأول لمرة واحدة تنزيل بيئة تشغيل WordPress (حوالي 570 ميغابايت)؛ مرّر --yes لتخطي السؤال

my-site  ·  WordPress Playground (WASM, no Docker)
───────────────────────────────────────────────────

  serving    a WordPress project
  from       /home/you/my-site
  php        8.3
  wordpress  latest

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

  Ctrl-C to stop

`zinnector login`

تسجيل الدخول — باستخدام حسابكم الخاص في المتصفح، أو عبر مفتاح API.

zinnector login [options]

الخيار	ما يفعله	القيمة الافتراضية
`--profile <name>`	التخزين ضمن ملف تعريف مسمى (افتراضي: default)
`--api <url>`	عنوان URL الأساسي لواجهة برمجة التطبيقات (API)	`"https://api.zinndigital.com"`
`--api-key`	الصق مفتاح API لكل مؤسسة بدلاً من تسجيل الدخول بنفسك
`--issuer <url>`	خدمة تسجيل الدخول	`"https://auth.zinndigital.com/realms/zinn"`
`--no-browser`	طباعة رابط تسجيل الدخول دون محاولة فتح متصفح

مثال

zinnector login

ما تراه — يُكتب المفتاح عند موجه الأوامر، وليس أبدًا في سطر الأوامر. في بيئة التكامل المستمر (CI)، مرره عبر الأنبوب: echo "$ZINN_API_KEY" | zinnector login --profile ci

Sign in to Zinn Digital®  ·  https://api.zinndigital.com
────────────────────────────────────────────────────

  API key: ••••••••••••••••••••••••••••

✔ signed in as you@example.com (Acme Ltd) — profile “default”
→ next: zinnector sites

`zinnector logout`

نسيان تسجيل الدخول المخزن.

zinnector logout [options]

الخيار	ما يقوم به	الافتراضي
`--profile <name>`	الملف الشخصي المطلوب نسيانه (الافتراضي: default)

مثال

zinnector logout

ما تراه

✔ signed out of profile “default”

`zinnector whoami`

إظهار الحساب الذي سجلت واجهة سطر الأوامر هذه الدخول به، وما يمكنها الوصول إليه.

zinnector whoami [options]

الخيار	ما يقوم به	الافتراضي
`--profile <name>`	استخدام ملف تعريف محدد بالاسم
`--scopes`	سرد الأذونات التي يحملها مفتاح API
`--json`	مخرجات قابلة للقراءة آليًا

مثال

zinnector whoami --scopes

ما تراه — تم التقاطه من تشغيل حقيقي للإصدار 0.1.5 على بيئة الإنتاج في 2026-09-14؛ تم استبدال النطاقات والمعرّفات والروابط أحادية الاستخدام


Signed in  ·  https://api.zinndigital.com
──────────────────────────────────────────
account        you@example.com
as             a person, signed in through the browser
organisations  8 — listed below
mode           live
credential     profile “default”

  · Example Org  owner · 01a00000-0000-7000-8000-000000000000
  · Example Org· 01a00001-0000-7000-8000-000000000001
  · Example Org· 01a00002-0000-7000-8000-000000000002
  · Example Org· 01a00003-0000-7000-8000-000000000003
  · Example Org· 01a00004-0000-7000-8000-000000000004
  · Example Org· 01a00005-0000-7000-8000-000000000005
  · Example Org· 01a00006-0000-7000-8000-000000000006
  · Example Org· 01a00007-0000-7000-8000-000000000007

  scopes belong to API keys — a signed-in person acts with their ROLE in each organisation (shown above).

`zinnector sites`

عرض المواقع التي يمكن لهذا المفتاح رؤيتها.

zinnector sites [options]

الخيار	الوظيفة	الافتراضي
`--json`	مخرجات قابلة للقراءة آليًا
`--status <status>`	المواقع بهذه الحالة فقط

مثال

zinnector sites


Sites  ·  12
─────────────
domain          status  php      target  id
example-2.com   active  php —    fleet   01a00000-0000-7000-8000-000000000000
example-3.com   active  php —    fleet   01a00001-0000-7000-8000-000000000001
example-4.com   active  php —    fleet   01a00002-0000-7000-8000-000000000002
example-5.com   active  php 8.5  fleet   01a00003-0000-7000-8000-000000000003
example-6.com   active  php —    fleet   01a00004-0000-7000-8000-000000000004
example.com     active  php 8.4  fleet   01a00005-0000-7000-8000-000000000005
example-7.com   active  php —    fleet   01a00006-0000-7000-8000-000000000006
example-8.com   active  php 8.5  fleet   01a00007-0000-7000-8000-000000000007
example-9.com   active  php 8.5  fleet   01a00008-0000-7000-8000-000000000008
example-10.com  active  php 8.5  fleet   01a00009-0000-7000-8000-000000000009
example-11.com  active  php 8.5  fleet   01a00010-0000-7000-8000-000000000010
example-12.com  active  php 8.5  fleet   01a00011-0000-7000-8000-000000000011

`zinnector status`

كل ما تعرفه المنصة عن موقع واحد.

zinnector status [options] [site]

الوسيطة	مطلوب	الوصف
`site`	لا	معرّف موقع، نطاق أساسي أو اسم — القيمة الافتراضية هي الموقع المرتبط في zinnector.json

الخيار	وظيفته	الافتراضي
`--json`	مخرجات قابلة للقراءة آلياً

مثال

zinnector status example.com


example.com  ·  01a00000-0000-7000-8000-000000000000
────────────────────────────────────────────────────────────────────────
status         active
product line   footprint_free
stack          wordpress
region         fsn1
deploy target  fleet
plan           PBN 10

● PHP
version        8.4
can switch to  8.5, 8.4, 8.3, 8.2, 8.1, 8.0, 7.4

● Quota
disk      188 MB used of 500.0 GB
files     6,313 of 2,000,000
database  1 MB

● Deploy
status         building
target         fleet
repository     —
commit         —
live url       —
last deployed  2026-09-14T01:29:26.991511Z

● WordPress
version     7.1
up to date  yes
multisite   no

`zinnector share`

امنح شخصًا واحدًا حق الوصول إلى موقع واحد — مطوّر، أو مصمّم، أو عميل.

zinnector share [options] <site> <email>

| الوسيط | مطلوب | ما هو |\n|---|---|---|\n| site | نعم | الموقع المراد مشاركته — معرّف أو نطاق أساسي أو اسم |\n| email | نعم | الشخص المراد منحه حق الوصول — يُرسل إليه بريد إلكتروني يحتوي على دعوة إذا لم يكن لديه حساب بعد |\n\n| الخيار | ما يفعله | القيمة الافتراضية |\n|---|---|---|\n| --role <role> | ما يُسمح لهم بفعله: viewer، editor، manager | |\n| --reason <text> | سبب حاجتهم إليه — يُحفظ مع الإذن لسجل التدقيق | |\n| --until <date> | متى ينتهي الوصول تلقائيًا (YYYY-MM-DD)؛ يُحذف ليبقى ساريًا حتى الإلغاء | |\n| --json | مخرجات قابلة للقراءة آليًا | |\n\nمثال

zinnector share example.com dev@agency.test --role editor --reason "rebuild the checkout"

ما تراه — الشكل الدقيق الذي يطبعه الأمر، من المصدر (أضاف W40-DEVTOOL هذه بعد التقاط هذا الملف آخر مرة)؛ ستختلف نطاقاتك ومعرفاتك وتواريخك

Shared example.com  ·  01a03f39-730a-7dc4-84b0-5d4f7582dd04
────────────────────────────────────────────────────────────

✔ invited dev@agency.test as editor
  They have no account yet, so an invitation has been emailed. Until they
  sign in and accept it they can see nothing; the moment they do, the site is theirs.

→ what they do next, on their own machine:
    npm i -g zinnector && zinnector login   # sign in as themselves
    zinnector clone example.com   # pull the files down

`zinnector collaborators`

من تم منحهم حق الوصول إلى موقع ما، وما إذا كانوا قد قبلوا ذلك.

zinnector collaborators [options] [site]

الوسيطة	مطلوب	الوصف
`site`	لا	معرّف موقع، نطاق أساسي أو اسم — القيمة الافتراضية هي الموقع المرتبط في zinnector.json

الخيار	وظيفته	الافتراضي
`--json`	مخرجات قابلة للقراءة آلياً

مثال

zinnector collaborators example.com

ما تراه — تم التقاطه من تشغيل حقيقي للإصدار 0.1.5 في بيئة الإنتاج بتاريخ 2026-09-14؛ تم استبدال النطاقات والمعرفات والروابط ذات الاستخدام الواحد. الشكل الدقيق الذي يطبعه الأمر، من المصدر (أضافت W40-DEVTOOL هذه بعد آخر التقاط لهذا الملف)؛ ستختلف النطاقات والمعرفات والتواريخ الخاصة بك


Access to example.com  ·  3
───────────────────────────────────────────────────────────
who              role    status   ends  why                                          grant
dev@agency.test  viewer  revoked  —     Example Org— revoked immediately after       01a00000-0000-7000-8000-000000000000
dev@agency.test  viewer  revoked  —     Example Org— revoked at the end of the walk  01a00001-0000-7000-8000-000000000001
dev@agency.test  editor  revoked  —     Example Org— revoked at the end of the walk  01a00002-0000-7000-8000-000000000002

`zinnector unshare`

إلغاء وصول شخص ما إلى موقع — عبر البريد الإلكتروني أو معرف المنح.

zinnector unshare [options] <site> <who>

الوسيطة	مطلوب	الوصف
`site`	نعم	الموقع المراد استرداد الوصول إليه — معرف (id)، أو نطاق أساسي، أو اسم
`who`	نعم	الشخص المراد إزالته — عنوان بريده الإلكتروني، أو معرف المنح (grant id) من zinnector collaborators

الخيار	وظيفته	الافتراضي
`--yes`	عدم السؤال

مثال

zinnector unshare example.com dev@agency.test --yes

✔ withdrew the invitation to dev@agency.test

`zinnector invitations`

الدعوات في انتظاركم، وقبول إحداها.

zinnector invitations [options] [command]

مثال

zinnector invitations

ما تراه — تم التقاطه من تشغيل حقيقي للإصدار 0.1.5 على بيئة الإنتاج بتاريخ 2026-09-14؛ تم استبدال النطاقات والمعرفات والروابط ذات الاستخدام الواحد. الشكل الدقيق الذي يطبعه الأمر، من المصدر (أضاف W40-DEVTOOL هذه بعد آخر التقاط لهذا الملف)؛ ستختلف النطاقات والمعرفات والتواريخ الخاصة بكم؛ بدون أمر فرعي يقوم بتشغيل list


Invitations  ·  0
──────────────────

● nothing waiting for you

`zinnector invitations list`

الدعوات الموجهة إلى الحساب الذي قمت بتسجيل الدخول به.

zinnector invitations list [options]

الخيار	ما يفعله	الافتراضي
`--json`	مخرجات قابلة للقراءة آلياً

مثال

zinnector invitations list


Invitations  ·  0
──────────────────

● nothing waiting for you

`zinnector invitations accept`

قبول دعوة — يصبح الموقع ملككم فور اكتمال هذه العملية.

zinnector invitations accept [options] <id>

الوسيط	مطلوب	الوصف
`id`	نعم	معرّف الدعوة من zinnector invitations — وتكفي بادئة فريدة منه

مثال

zinnector invitations accept 01a03f39-9c11-7b02-a7e0-2e4d0c5f1b77

✔ you now have access to example.com

`zinnector link`

وجّه هذا المشروع إلى فتحة استضافة (واربط مستودعه).

zinnector link [options] [site]

الوسيط	مطلوب	ما هو
`site`	لا	معرّف الموقع أو النطاق الأساسي أو الاسم — القيمة الافتراضية هي الموقع المرتبط في zinnector.json

الخيار	ما يفعله	القيمة الافتراضية
`--repo <owner/name>`	ربط هذا المستودع بالموقع على المنصة
`--provider <name>`	الحساب المتصل للنشر من خلاله: github_app أو github أو gitlab (افتراضي: الحساب الذي قامت مؤسستكم بربطه)
`--branch <name>`	الفرع الذي يتم النشر منه عند الدفع (push)
`--no-repo`	كتابة zinnector.json فقط؛ دون إجراء أي تغيير على المنصة

مثال

zinnector link example.com --repo acme/example-site --branch main

ما تراه

✔ this project deploys to example.com (01a03f39-730a-7dc4-84b0-5d4f7582dd04)
  written to zinnector.json — commit it so everyone deploys to the same slot
✔ the platform will deploy acme/example-site (main)
→ next: zinnector check

`zinnector pull`

اسحب ملفات الموقع المستضاف إلى هذا المشروع للتطوير المحلي — وأعد التشغيل لإعادة المزامنة.

zinnector pull [options] [site]

| الوسيط | مطلوب | ما هو |\n|---|---|---|\n| site | لا | معرّف موقع، أو نطاق رئيسي، أو اسم — القيمة الافتراضية هي الموقع المرتبط في zinnector.json |\n\n| الخيار | ما يفعله | القيمة الافتراضية |\n|---|---|---|\n| --via <seam> | auto (افتراضي)، أو git، أو backup | "auto" |\n| --fresh | أخذ نسخة احتياطية جديدة بدلاً من استخدام الأحدث (يستهلك خانة عند الطلب) | |\n| --max-age <hours> | قبول أحدث نسخة احتياطية إذا كانت أحدث من هذه المدة | "24" |\n| --full | جذر المستند بالكامل، مع تضمين نواة WordPress (الافتراضي: wp-content فقط) | |\n| --no-uploads | استبعاد wp-content/uploads (الوسائط) | |\n| --no-database | استبعاد قاعدة بيانات الموقع — أخذ الملفات فقط | |\n| --live-config | كتابة wp-config.php أيضاً — فهو يحتوي على بيانات اعتماد قاعدة البيانات المباشرة | |\n| --clean | تفريغ wp-content قبل الاستخراج، لمطابقة عمليات الحذف على الموقع | |\n| --dry-run | توضيح ما سيحدث والتوقف | |\n| --yes | عدم السؤال | |\n\nمثال

zinnector pull

ما تراه

Pull example.com  ·  01a03f39-730a-7dc4-84b0-5d4f7582dd04
─────────────────────────────────────────────────────────────

● via git — the site syncs to its own repository and this is a clone of it
✔ fast-forwarded 3 commits 4f1c2a9b → 9d2e7c14

● not synced, and why
  ✖ database                     the local playground has its own; the site's is not copied
  ✖ offloaded media              objects in storage are not in the site's files
  ✖ anything outside the repository  only wp-content syncs

→ next: zinnector dev

`zinnector clone`

أنشئ مشروعًا محليًا من موقع مستضاف: استنسخ مستودعه أو اسحب ملفاته.

zinnector clone [options] <site> [dir]

الوسيط	مطلوب	ما هو
`site`	نعم	الموقع المستضاف المراد نسخه — معرف (id)، أو نطاق أساسي، أو اسم
`dir`	لا	الدليل المراد إنشاؤه — يتم تعيينه افتراضيًا إلى النطاق الأساسي للموقع

الخيار	وظيفته	الافتراضي
`--via <seam>`	تلقائي (افتراضي)، أو git، أو نسخة احتياطية
`--fresh`	أخذ نسخة احتياطية جديدة بدلاً من استخدام أحدث نسخة
`--full`	جذر المستند بالكامل، بما في ذلك ملفات WordPress الأساسية
`--no-uploads`	استثناء wp-content/uploads (الوسائط)
`--no-database`	استثناء قاعدة بيانات الموقع — أخذ الملفات فقط
`--live-config`	كتابة wp-config.php أيضًا — يحتوي على بيانات اعتماد قاعدة البيانات المباشرة (LIVE)
`--yes`	عدم السؤال

مثال

zinnector clone client.example.com

ما تراه

Clone client.example.com  ·  client.example.com
──────────────────────────────────────────────────────

✔ wrote client.example.com/zinnector.json (php 8.3, wordpress 6.7.1)
● via backup — the site does not sync to a repository
✔ downloaded 214 MB and extracted wp-content

● not synced, and why
  ✖ database                     the local playground has its own; the site's is not copied
  ✖ offloaded media              objects in storage are not in the site's files
  ✖ wp-config.php                holds the live database credentials (--live-config to write it)
  ✖ WordPress core               the runtime supplies the version the slot runs (--full to take it)

→ next: zinnector dev

→ run it:
    cd client.example.com
    zinnector dev

`zinnector sync`

مزامنة ثنائية الاتجاه بين الملفات المباشرة للموقع ومستودعه.

zinnector sync [options] [command]

مثال

zinnector sync --help

ما تراه — بدون أي أمر فرعي، فإن zinnector sync <site> هو sync status

Usage: zinnector sync [options] [command]

two-way sync between a site's live files and its repository

  site → repository   zinnector sync run   commits the live files and pushes the branch
  repository → site   zinnector push       builds the branch and publishes it

`zinnector sync status`

حالة المزامنة ثنائية الاتجاه، وآخر عمليات تشغيل لها.

zinnector sync status [options] [site]

الوسيطة	مطلوب	الوصف
`site`	لا	معرّف موقع، نطاق أساسي أو اسم — القيمة الافتراضية هي الموقع المرتبط في zinnector.json

الخيار	وظيفته	الافتراضي
`--json`	مخرجات قابلة للقراءة آلياً

مثال

zinnector sync status example.com

ما تراه — تم التقاطه من تشغيل فعلي للإصدار 0.1.4 ضد موقع اختباري بتاريخ 2026-09-12؛ تم استبدال النطاق والمعرّفات بقيم تجريبية

Two-way sync — example.com
──────────────────────────

repository   acme/example-site (main)
available    yes
sync         on
state        synced
last sync    2026-09-12T22:51:41.539832Z
note         Started from acme/example-site@main.

run        files       commit         when
synced     2 changed   da85d73cef5f   2026-09-12T22:52:10.117301Z

`zinnector sync on`

تشغيل المزامنة ثنائية الاتجاه (لا يرسل أي شيء بمفرده).

zinnector sync on [options] [site]

الوسيط	مطلوب	الوصف
`site`	لا	معرّف الموقع، أو النطاق الأساسي، أو الاسم — القيمة الافتراضية هي الموقع المرتبط في zinnector.json

الخيار	وظيفته	القيمة الافتراضية
`--subdir <path>`	مزامنة هذا الدليل الفرعي للموقع فقط
`--json`	مخرجات قابلة للقراءة آليًا

مثال

zinnector sync on example.com

ما تراه — يتطلب مستودعًا متصلاً على حساب GitHub الخاص بك؛ ولا يدفع أي شيء تلقائيًا

✔ two-way sync is on

Two-way sync — example.com
…
→ next: zinnector sync run

`zinnector sync off`

إيقاف تشغيل المزامنة ثنائية الاتجاه.

zinnector sync off [options] [site]

الوسيط	مطلوب	الوصف
`site`	لا	معرّف الموقع، أو النطاق الأساسي، أو الاسم — القيمة الافتراضية هي الموقع المرتبط في zinnector.json

الخيار	وظيفته	القيمة الافتراضية
`--subdir <path>`	مزامنة هذا الدليل الفرعي للموقع فقط
`--json`	مخرجات قابلة للقراءة آليًا

مثال

zinnector sync off example.com

ما تراه

✔ two-way sync is off

`zinnector sync run`

ثبّتوا ملفات الموقع المباشرة في مستودعه الآن.

zinnector sync run [options] [site]

الوسيطة	مطلوب	الوصف
`site`	لا	معرّف موقع، نطاق أساسي أو اسم — القيمة الافتراضية هي الموقع المرتبط في zinnector.json

الخيار	وظيفته	الافتراضي
`--json`	مخرجات قابلة للقراءة آلياً

مثال

zinnector sync run example.com

ما تراه — مأخوذ من تشغيل حقيقي للإصدار 0.1.4 ضد موقع اختباري في 2026-09-12؛ تم استبدال النطاق والمعرفات بقيم تجريبية. التشغيل الذي تجاوزه المستودع يتم تعليقه (HELD) بدلاً من ذلك: لا يتم دفع أي شيء أو الكتابة فوقه، ويخرج الأمر برمز 1 ويحدد الخطوة التالية

✔ committed 2 changed files da85d73cef5f

Two-way sync — example.com
…
→ next: git pull in your clone

`zinnector sync resolve`

امسح المزامنة المعلقة عن طريق اختيار الجانب الفائز.

zinnector sync resolve [options] [site]

الوسيطة	مطلوب	ما هي
`site`	لا	معرّف موقع، أو نطاق أساسي أو اسم — القيمة الافتراضية هي الموقع المرتبط في zinnector.json

الخيار	ما يفعله	القيمة الافتراضية
`--keep <side>`	site (تثبيت الموقع في الأعلى) أو repository (تجاهل تغييرات الموقع غير المتزامنة)
`--yes`	عدم السؤال
`--json`	مخرجات قابلة للقراءة آلياً

مثال

zinnector sync resolve example.com --keep repository --yes

ما تراه — تم التقاطه من تشغيل حقيقي للإصدار 0.1.4 مقابل موقع اختباري بتاريخ 2026-09-12؛ تم استبدال النطاق والمعرّفات بقيم تجريبية. بدون --yes فإنه يطلب التأكيد أولاً، ويرفض تماماً عندما لا يكون هناك طرفية يمكن السؤال من خلالها

✔ kept the repository

Two-way sync — example.com
…
state        synced

`zinnector check`

مقارنة هذا المشروع مع المنفذ الذي توشكون على النشر إليه.

zinnector check [options] [site]

| الوسيط | مطلوب | ما هو |\n|---|---|---|\n| site | لا | معرّف موقع، أو نطاق أساسي أو اسم — القيمة الافتراضية هي الموقع المرتبط في zinnector.json |\n\n| الخيار | ما يفعله | القيمة الافتراضية |\n|---|---|---|\n| --probe | تمهيد بيئة التشغيل المحلية وقياس php الخاص بها، بدلاً من الوثوق بـ zinnector.json | |\n| --all | إظهار عمليات الفحص الناجحة أيضاً | |\n| --strict | الفشل أيضاً عند تعذر فحص شيء ما | |\n| --json | مخرجات قابلة للقراءة آلياً | |\n\nمثال

zinnector check

ما تراه — تم التقاطه من تشغيل حقيقي للإصدار 0.1.5 في بيئة الإنتاج بتاريخ 2026-09-14؛ تم استبدال النطاقات والمعرّفات والروابط أحادية الاستخدام — عثر التشغيل على عدم تطابق حقيقي (PHP 8.3 في المشروع مقابل 8.4 في الفتحة)، وهو الهدف الأساسي من الأمر

→ reading the slot
  size excludes: .git

Pre-flight — example.com  ·  01a00000-0000-7000-8000-000000000000
────────────────────────────────────────────────────────────────────────

  local  php 8.4  3 files, 0.0 MB
  slot   php 8.4  target fleet
  local php is the version DECLARED in zinnector.json — run with --probe to measure it

  ? unknown   local php extensions could not be enumerated
      try zinnector dev --once

  ? unknown   wordpress versions could not be compared
      No WordPress version found in the working copy.
      try zinnector status

  7 passed  ·  2 could not be checked

`zinnector push`

الفحص المسبق، ودفع التغييرات الخاصة بكم، والنشر.

zinnector push [options] [site]

الوسيط	مطلوب	الوصف
`site`	لا	معرّف موقع، أو نطاق أساسي، أو اسم — القيمة الافتراضية هي الموقع المرتبط في zinnector.json

الخيار	وظيفته	القيمة الافتراضية
`-f, --force`	النشر حتى في حالة وجود نتائج أثناء الفحص الأولي
`--skip-checks`	عدم إجراء الفحص الأولي على الإطلاق
`--probe`	قياس وقت التشغيل المحلي أثناء الفحص الأولي بدلاً من الاعتماد على zinnector.json
`--no-wait`	بدء النشر والخروج دون مراقبته
`--no-git`	عدم تنفيذ git push؛ نشر ما هو موجود بالفعل على المنصة
`--dry-run`	تنفيذ كل شيء باستثناء النشر

مثال

zinnector push

ما تراه

Deploy to example.com  ·  01a03f39-730a-7dc4-84b0-5d4f7582dd04
───────────────────────────────────────────────────────────────

✔ pre-flight: 8 passed  ·  0 to look at  ·  2 could not be checked
→ pushing main (4f1c2a9b add the contact form)
✔ pushed
● deploy 7c0e… started — watching
✔ deployed 4f1c2a9b in 48s

  status    success
  commit    4f1c2a9b
  url       https://example.com

`zinnector deploy`

إعادة نشر ما تحتفظ به المنصة بالفعل، دون إجراء دفع.

zinnector deploy [options] [site]

zinnector deploy example.com


Redeploy example.com  ·  01a00000-0000-7000-8000-000000000000
────────────────────────────────────────────────────────────────────────
→ starting the deploy
✔ deploy started

`zinnector deploys`

سجل عمليات نشر الموقع.

zinnector deploys [options] [site]

الوسيط	مطلوب	الوصف
`site`	لا	معرف الموقع أو النطاق الأساسي أو الاسم — القيمة الافتراضية هي الموقع المرتبط في zinnector.json

الخيار	وظيفته	القيمة الافتراضية
`--json`	مخرجات قابلة للقراءة آليًا
`-n, --limit <n>`	عدد العناصر المعروضة	`"10"`

مثال

zinnector deploys example.com


Deploys — example.com  ·  2
───────────────────────────────────────────────────────────
status  commit  branch  trigger  started                      message
live    —       —       manual   2026-09-14T09:06:39.685554Z  —
live    —       —       manual   2026-09-14T01:29:20.196957Z  —

`zinnector php`

عرض إصدار PHP الخاص بالموقع أو تبديله.

zinnector php [options] [version]

الوسيط	مطلوب	الوصف
`version`	لا	إصدار PHP الذي سيتم تحويل الموقع إليه، مثل 8.4 — احذفه لعرض الإصدار الحالي

الخيار	الوظيفة	الافتراضي
`-s, --site <site>`	معرّف الموقع أو النطاق
`--list`	عرض الإصدارات التي توفرها المنصة
`--json`	مخرجات قابلة للقراءة آلياً

مثال

zinnector php 8.3 --site example.com

ما تراه — تم التقاطه من تشغيل فعلي للإصدار 0.1.5 على بيئة الإنتاج في 2026-09-14؛ تم استبدال النطاقات والمعرّفات والروابط أحادية الاستخدام. في حال عدم تحديد إصدار، فإنه يعرض الإصدار الحالي؛ ويعرض الأمر --list ما تقدمه المنصة لخط إنتاج هذا الموقع


PHP — example.com
──────────────────────────────────────────────────────
version        8.4
can switch to  8.5, 8.4, 8.3, 8.2, 8.1, 8.0, 7.4

`zinnector quota`

استخدام القرص والملفات وقاعدة البيانات مقارنة بما تمنحه الخطة.

zinnector quota [options] [site]

الوسيطة	مطلوب	الوصف
`site`	لا	معرّف موقع، نطاق أساسي أو اسم — القيمة الافتراضية هي الموقع المرتبط في zinnector.json

الخيار	وظيفته	الافتراضي
`--json`	مخرجات قابلة للقراءة آلياً

مثال

zinnector quota example.com


Quota — example.com
────────────────────────────────────────────────────────
disk used      188 MB
disk limit     500.0 GB
disk granted   500 GB  (per_site)
files used     6,313
file limit     2,000,000
database       1 MB

  “limit” is what is enforced today; “granted” is what the plan says.

`zinnector db`

حجم قاعدة البيانات، وروابط لمرة واحدة للدخول إلى phpMyAdmin ومدير الملفات.

zinnector db [options] [site]

الوسيطة	مطلوب	الوصف
`site`	لا	معرّف موقع، نطاق أساسي أو اسم — القيمة الافتراضية هي الموقع المرتبط في zinnector.json

الخيار	وظيفته	الافتراضي
`--json`	مخرجات قابلة للقراءة آلياً

مثال

zinnector db example.com

ما تراه — تم التقاطه من تشغيل حقيقي للإصدار 0.1.5 على بيئة الإنتاج في 2026-09-14؛ تم استبدال النطاقات والمعرفات والروابط أحادية الاستخدام. روابط phpMyAdmin ومدير الملفات مخصصة للاستخدام لمرة واحدة وتنقضي صلاحيتها؛ لا تقم بلصقها في أي مكان


Database — example.com
───────────────────────────────────────────────────────────
size    1 MB
tables  14

  single-use links, valid for one visit:
  phpMyAdmin    https://pma.example.com/signon.php?t=<single-use>
  file manager  https://files.example.com/signon.php?t=<single-use>

`zinnector logs`

تتبّع سجلات الوصول والأخطاء الخاصة بالموقع في الوقت الفعلي.

zinnector logs [options] [site]

| وسيط | مطلوب | ما هو |\n|---|---|---|\n| site | لا | معرّف موقع، أو نطاق أساسي، أو اسم — القيمة الافتراضية هي الموقع المرتبط في zinnector.json |\n\n| خيار | ما يفعله | القيمة الافتراضية |\n|---|---|---|\n| --access | سجل الوصول فقط | |\n| --error | سجل الأخطاء فقط | |\n| --build | سجل الإنشاء لأحدث عملية نشر بدلاً من ذلك | |\n| --json | مخرجات قابلة للقراءة آلياً | |\n\nمثال

zinnector logs example.com --error

ما تراه — تم التقاطه من تشغيل حقيقي للإصدار 0.1.5 على بيئة الإنتاج بتاريخ 2026-09-14؛ مع استبدال النطاقات والمعرّفات والروابط أحادية الاستخدام. استخدم --access لسجل الوصول، و--build لسجل بناء آخر عملية نشر (الموقع الذي لم يتم بناؤه بواسطة موفر بناء يعرض خطوات النشر الخاصة به)؛ بدون أي علامة، يتم عرض كلا سجلي الموقع، والسجل الذي تعذرت قراءته يوضح ذلك بدلاً من أن يظهر فارغاً


Error log — example.com
────────────────────────────────────────────────────────────

2026-09-14 11:06:07.153643 [NOTICE] [1929978] [T0] [config:vhost:zcaffb6eec5abbdab03fb9b2d62a15:epsr:lsphp-zcaffb6eec5abbdab03fb9b2d62a15]'Process Limit' probably is too low, adjust the limit to: 640.
2026-09-14 11:06:37.873060 [INFO] [1929982] [T0] [lsphp-zcaffb6eec5abbdab03fb9b2d62a15] add child process pid: 1933036, procinfo: 0x5555561cfe30

`zinnector wp`

تشغيل أمر WP-CLI مسموح به في القائمة على أحد المواقع.

zinnector wp [options] [command...]

| الوسيط | مطلوب | ما هو |\n|---|---|---|\n| command... | لا | أمر WP-CLI ووسائطه، على سبيل المثال plugin list — يتم حذفه مع --commands |\n\n| الخيار | ما يفعله | الافتراضي |\n|---|---|---|\n| -s, --site <site> | معرف الموقع أو النطاق | |\n| --commands | سرد ما سيقوم النظام بتشغيله | |\n| --json | مخرجات قابلة للقراءة آلياً | |\n\nمثال

zinnector wp plugin list --site example.com

ما تراه — مأخوذ من تشغيل حقيقي للإصدار 0.1.5 على بيئة الإنتاج في 2026-09-14؛ تم استبدال النطاقات والمعرّفات وروابط الاستخدام لمرة واحدة. توفر المنصة القائمة المسموح بها — يعرضها الأمر zinnector wp --commands

name	status	update	version	update_version	auto_update
akismet	inactive	none	5.7.2		off
hello	inactive	none	1.7.2		off
imunify-security	active	none	4.1.0		off
litespeed-cache	active	none	7.9.1		off
redis-cache	active	none	2.8.0		off
zinn-cache	active	none	1.2.2		off
object-cache.php	dropin				off

`zinnector backup`

عرض النسخ الاحتياطية للموقع وإنشاؤها.

zinnector backup [options] [command]

مثال

zinnector backup list example.com

ما تراه — تم التقاطه من تشغيل حقيقي للإصدار 0.1.5 على بيئة الإنتاج في 2026-09-14؛ مع استبدال النطاقات والمعرّفات والروابط أحادية الاستخدام. يؤدي تشغيل الأمر backup بمفرده إلى طباعة أوامره الفرعية؛ راجع backup list وbackup now أدناه


Backups — example.com  ·  3
───────────────────────────────────────────────────────────
status  taken                        size    id
stored  2026-09-14T09:06:39.918280Z  4.7 MB  01a00000-0000-7000-8000-000000000000
stored  2026-09-14T01:29:20.403161Z  36 MB   01a00001-0000-7000-8000-000000000001
stored  2026-09-14T01:29:15.898099Z  36 MB   01a00002-0000-7000-8000-000000000002

daily backups   on
retention       30 days
off-site copy   yes
on-demand left  2 of 3

`zinnector backup list`

عرض النسخ الاحتياطية لموقع وما تمنحه خطته.

zinnector backup list [options] [site]

الوسيطة	مطلوب	الوصف
`site`	لا	معرّف موقع، نطاق أساسي أو اسم — القيمة الافتراضية هي الموقع المرتبط في zinnector.json

الخيار	وظيفته	الافتراضي
`--json`	مخرجات قابلة للقراءة آلياً

مثال

zinnector backup list example.com


Backups — example.com  ·  3
───────────────────────────────────────────────────────────
status  taken                        size    id
stored  2026-09-14T09:06:39.918280Z  4.7 MB  01a00000-0000-7000-8000-000000000000
stored  2026-09-14T01:29:20.403161Z  36 MB   01a00001-0000-7000-8000-000000000001
stored  2026-09-14T01:29:15.898099Z  36 MB   01a00002-0000-7000-8000-000000000002

daily backups   on
retention       30 days
off-site copy   yes
on-demand left  2 of 3

`zinnector backup now`

إنشاء نسخة احتياطية فورية عند الطلب.

zinnector backup now [options] [site]

الوسيط	مطلوب	الوصف
`site`	لا	معرف الموقع، أو النطاق الأساسي، أو الاسم — القيمة الافتراضية هي الموقع المرتبط في zinnector.json

مثال

zinnector backup now example.com

ما تراه

✔ backup started — zinnector backup list example.com shows it when it completes

`zinnector domains`

عرض النطاقات التي يمكن لهذا المفتاح رؤيتها.

zinnector domains [options]

الخيار	ما يفعله	الافتراضي
`--json`	مخرجات قابلة للقراءة آلياً

مثال

zinnector domains


Domains  ·  1
──────────────
domain       status     ownership  renewal        expires
example.com  connected  connected  no auto-renew  —

`zinnector dns`

قراءة سجلات DNS وتغييرها.

zinnector dns [options] [command]

مثال

zinnector dns list example.com

ما تراه — مأخوذ من تشغيل حقيقي للإصدار 0.1.5 على بيئة الإنتاج في 2026-09-14؛ تم استبدال النطاقات والمعرفات والروابط ذات الاستخدام الواحد. يؤدي تشغيل dns بمفرده إلى طباعة أوامره الفرعية؛ انظر dns list و dns add و dns rm أدناه


DNS — example.com  ·  1 records
────────────────────────────────────────
type  name          value               ttl
TXT   w4357-verify  zinn-w4357-updated  ttl 3600

`zinnector dns list`

عرض سجلات DNS الخاصة بنطاق معين.

zinnector dns list [options] <domain>

الوسيط	مطلوب	الوصف
`domain`	نعم	النطاق، بالاسم أو المعرف

الخيار	وظيفته	الافتراضي
`--type <type>`	السجلات من هذا النوع فقط
`--json`	مخرجات قابلة للقراءة آلياً

مثال

zinnector dns list example.com


DNS — example.com  ·  1 records
────────────────────────────────────────
type  name          value               ttl
TXT   w4357-verify  zinn-w4357-updated  ttl 3600

`zinnector dns add`

إنشاء سجل DNS.

zinnector dns add [options] <domain> <type> <name> <value>

الوسيطة	مطلوب	الوصف
`domain`	نعم	النطاق، بالاسم أو المعرف (id)
`type`	نعم	نوع السجل: A، AAAA، CNAME، MX، TXT، SRV، …
`name`	نعم	اسم السجل — @ للنطاق نفسه، أو تسمية النطاق الفرعي
`value`	نعم	ما يشير إليه السجل — عنوان، أو اسم مضيف أو نص

الخيار	وظيفته	القيمة الافتراضية
`--ttl <seconds>`	مدة البقاء (TTL)	`"3600"`
`--priority <n>`	الأولوية، لسجلات MX و SRV
`--proxied`	التوجيه عبر شبكة توصيل المحتوى (CDN)
`-y, --yes`	عدم السؤال

مثال

zinnector dns add example.com TXT _acme "token" --ttl 300

ما تراه — يتم عرض السجل وتأكيده قبل كتابته؛ مرّر --yes لتخطي السؤال

Add a DNS record to example.com
───────────────────────────────

  type   TXT
  name   _acme
  value  "token"
  ttl    300

  create it? [y/N] y
✔ created TXT _acme

`zinnector dns rm`

حذف سجل DNS.

zinnector dns rm [options] <domain> <recordId>

الوسيطة	مطلوب	الوصف
`domain`	نعم	النطاق، بالاسم أو المعرّف
`recordId`	نعم	معرّف السجل، كما يطبعه أمر zinnector dns list

الخيار	ما يفعله	القيمة الافتراضية
`-y, --yes`	عدم السؤال

مثال

zinnector dns rm example.com rec_7f3a

ما تراه

⚠ deleting A @ 203.0.113.10 from example.com
  delete it? [y/N] y
✔ deleted

`zinnector mail`

عرض خدمات البريد.

zinnector mail [options]

الخيار	ما يفعله	الافتراضي
`--json`	مخرجات قابلة للقراءة آلياً

مثال

zinnector mail


Mail services  ·  0
────────────────────

● no mail services

`zinnector bulk`

تشغيل عملية واحدة عبر مواقع متعددة (cache_purge، malware_scan، sitemap، block_ip).

zinnector bulk [options] <operation>

| الوسيط | مطلوب | ما هو |\n|---|---|---|\n| operation | نعم | ما سيتم تشغيله على كل موقع محدد: cache_purge أو malware_scan أو sitemap أو block_ip |\n\n| الخيار | ما يفعله | القيمة الافتراضية |\n|---|---|---|\n| --all | كل موقع يمكن لهذا المفتاح رؤيته | |\n| --site <site...> | مواقع محددة، حسب المعرّف (id) أو النطاق | |\n| --status <status> | كل موقع بهذه الحالة | |\n| -y, --yes | عدم السؤال | |\n| --json | مخرجات قابلة للقراءة آليًا | |\n\nمثال

zinnector bulk cache_purge --all

ما تراه — مأخوذ من تشغيل حقيقي للإصدار 0.1.5 على بيئة الإنتاج بتاريخ 2026-09-14؛ تم استبدال النطاقات والمعرّفات والروابط أحادية الاستخدام. استدعاء واحد للمنصة لكامل التحديد، وليس استدعاءً لكل موقع؛ يتم عرض التحديد وتأكيده أولاً


Bulk cache_purge  ·  1 sites
─────────────────────────────

·   example.com

→ running cache_purge
✔ cache_purge accepted for 1 sites

  The platform runs this asynchronously; results appear per site in the dashboard.

`zinnector ai`

اسأل مساعد Zinn Digital®، مع استخدام هذا المشروع كسياق.

zinnector ai [options] <question...>

| وسيط | مطلوب | ما هو |\n|---|---|---|\n| question... | نعم | ما تريد طرحه، بكلمات واضحة — وضع علامات اقتباس اختياري |\n\n| خيار | وظيفته | افتراضي |\n|---|---|---|\n| -s, --site <site> | السؤال عن موقع معين | |\n| --org <id> | المؤسسة المراد السؤال بصفتها، عندما ينتمي حسابك إلى أكثر من مؤسسة | |\n| --no-context | عدم إرسال أي شيء بخصوص المشروع المحلي | |\n| --json | مخرجات مقروءة آلياً | |\n\nمثال

zinnector ai "why is my deploy failing?"

ما تراه — تم التقاطه من تشغيل حقيقي للإصدار 0.1.5 على بيئة الإنتاج بتاريخ 2026-09-14؛ تم استبدال النطاقات والمعرّفات والروابط أحادية الاستخدام. يجيب المساعد بلغة الحساب — الإعدادات الإقليمية لهذا الحساب هي العربية، وبالتالي فإن الإجابة الملتقطة باللغة العربية لسؤال باللغة الإنجليزية

→ thinking

Zinn Digital® assistant
────────────────────────────

  هذا مشروع WordPress تم إنشاؤه بواسطة Zinnector® (مُهيّأ على PHP 8.4، أحدث
  إصدار WordPress، وبيئة تشغيل playground)؛ لتشغيله محلياً، انتقل إلى مجلده
  وشغّل الأمر: cd <اسم-المشروع> ثم zinnector dev، وسيقوم بتشغيل موقع WordPress
  حقيقي على جهازك دون الحاجة إلى Docker.

  sources:
    · https://zinndigital.com/kb/zinnector-getting-started
    · https://zinndigital.com/kb/zinnector-local-development

`zinnector mcp`

تشغيل جسر stdio إلى خادم MCP المستضاف — لـ Claude Desktop والعملاء المحليين الآخرين فقط.

zinnector mcp [options]

مثال

ZINN_MCP_TOKEN=zmcp_live_… zinnector mcp

ما تراه — تم تشغيله بواسطة عميل ذكاء اصطناعي مثل Claude Desktop، وليس يدويًا أبدًا — فهو يتحدث بروتوكول MCP عبر stdin وstdout. تم إثباته من Claude Code 2.1.270 مقابل الخادم المباشر في 2026-09-12

zinnector 0.1.4: MCP bridge to https://api.zinndigital.com/v1/mcp

متغيرات البيئة

المتغير	التأثير
`ZINNECTOR_TOKEN`	مفتاح API، يُستخدم بدلاً من ملف التعريف المخزن — هكذا تتم مصادقة CI
`ZINNECTOR_API`	عنوان URL الأساسي لـ API (الافتراضي `https://api.zinndigital.com`)
`ZINNECTOR_DEBUG=1`	طباعة تتبعات مكدس الذاكرة ومخرجات مثبت بيئة التشغيل الخاصة
`ZINNECTOR_CACHE_DIR`	مكان الاحتفاظ ببيئة تشغيل WordPress وأي Node مُدار (الافتراضي `~/.cache/zinnector`)
`ZINNECTOR_CONFIG_DIR`	مكان وجود ملف تعريف مفتاح API (الافتراضي `~/.config/zinnector`)
`NO_COLOR`	تعطيل الألوان

رموز الخروج

0 نجاح · 1 نتيجة أو رفض · 70 خطأ داخلي · 77 مصادقة أو إذن · 78 إصدار Node غير مدعوم.

جميع مستندات المطورين →

الأحدث من المدونة

ما كتبناه حول الاستضافة، وتحسين محركات البحث (SEO)، وإدارة المواقع على نطاق واسع.

تحسين محركات البحث وبناء الروابط من طبقة الاستضافة: رؤية المشغل لعام 2026

كيف تؤثر الاستضافة على الفهرسة وقيمة الروابط في عام 2026: الحفاظ على فهرسة الصفحات، وفحص النطاقات القديمة قبل البناء عليها، وبناء الروابط دون ترك أثر لمحركات البحث، ونظرة صادقة حول ما يمكن للبنية التحتية تقديمه لتهيئة محركات البحث (SEO) وما لا يمكنها فعله.

21 يوليو 2026

قراءة المنشور ←

جعل WordPress سريعًا وآمنًا: قائمة تحقق للأداء والمكونات الإضافية

قائمة تحقق عملية للحصول على WordPress سريع وآمن: التخزين المؤقت على مستوى الخادم، وذاكرة تخزين مؤقت للكائنات لكل موقع، ومجموعة المكونات الإضافية القليلة التي تستحق التشغيل، والحفاظ على حداثة الحزمة البرمجية، وصفحات WooCommerce التي يجب ألا تخزنها مؤقتًا أبدًا.

20 يوليو 2026

قراءة المنشور ←

كيف تختار استضافة ويب مدارة في عام 2026: دليل المشتري

ما الذي يميز فعلياً الاستضافة المدارة الجيدة عن خادم رخيص مع لوحة تحكم — عمليات النقل، والنسخ الاحتياطي، والعزل، والتخزين المؤقت الحقيقي، وقابلية التوسع الصادقة — وكيفية الحكم عليها قبل الالتزام.

19 يوليو 2026

قراءة المنشور ←

اقرأ المدونة ←

ما زلت عالقًا؟

الدعم مشمول في كل خطة، ومكتب الدعم مفتوح 24 ساعة في اليوم، ويمكنك مراسلتنا بأي لغة من لغاتنا البالغ عددها 58 لغة — وسنرد عليك بلغتك.

الاتصال بالدعم → جميع المقالات →