إعداد Studio لمطوّري الويب

احصل على حزمة Studio

سجّل الدخول إلى Maxisnap بالحساب الذي لديه Studio، ثم:

• على Windows: في Maxisnap، افتح الإعدادات ← الحساب ← معالج إعداد Maxisnap Studio، وانقر على «ابدأ الآن»، ثم «تنزيل لوحة المعلومات». يحفظ Maxisnap ملف ZIP الخاص بـ Studio في مجلد التنزيلات لديك ويفتح ذلك المجلد.
• على Mac: في Maxisnap، افتح «Settings»‏ ← «Welcome & Help»‏ ← «Studio Setup Guide»، وانقر على «Get Started» ثم «Download Dashboard». يحفظ Maxisnap ملف ZIP الخاص بـ Studio في مجلد التنزيلات لديك.

فك ضغط ملف ZIP. على Windows، انقر عليه بزر الماوس الأيمن واختر «استخراج الكل». وعلى Mac، انقر عليه نقرًا مزدوجًا.

Maxisnap-Studio-v<version>/
  Maxisnap Studio - Start Here.html   guided setup (branding + every route)
  snaps/                              PHP edition: upload this folder to a web host
  cloudflare/                         Cloudflare Workers edition (Worker + R2 + D1)
    deploy/cli.mjs                    deploys it through the Cloudflare API (Node 20+)
  docs/Developer guide.html           architecture, upload API, security, updates
  docs/Cloudflare setup - technical brief.html
  AGENTS.md                           instructions for AI coding assistants

يغطي «Developer guide» الكامل البنية، وواجهة API للرفع، والمفاتيح والأدوار، ونموذج الأمان، واستكشاف الأخطاء وإصلاحها. وهو الملف docs/Developer guide.html في الحزمة.

إصدار PHP: الرفع وإكمال الإعداد

1. ارفع مجلد snaps إلى المجلد الجذر لموقعك (web root)، بما في ذلك ملفات ‎.htaccess المخفية فيه، بحيث تكون النتيجة public_html/snaps/index.php. وينطبق الأمر نفسه على ملف snaps.zip المخصص بعلامتك التجارية من صفحة Start Here؛ فك ضغطه في مكانه ولا تضع snaps داخل snaps (snaps/snaps).
2. افتح https://yourcompany.com/snaps/ ‎مرة واحدة. تفحص صفحة الإعداد PHP وأذونات المجلد، وتقترح مفتاح مسؤول من 40 حرفًا؛ ويجب أن يحتوي المفتاح على 16 حرفًا على الأقل. انسخه، ثم انقر على «Create my dashboard».
3. على nginx، أعد إنشاء قواعد التوجيه والمنع الواردة في snaps/.htaccess. وأبقِ uploads وdata وbranding خاصة.

تكتب صفحة الإعداد الملف your-settings.php، الذي يُحتفظ به عند التحديثات:

'dashboard_key' => '…',          // the Admin key; the setup page writes it
'base_url'      => 'https://yourcompany.com/snaps',  // the address setup was opened at; fix it here if share links come out wrong
'max_upload_mb' => 500,          // your host's PHP limits still apply

إصدار Cloudflare: النشر من الطرفية

تقرأ أداة سطر الأوامر (CLI) المضمّنة الحساب أولًا، ثم تعرض خطة بما ستنشئه وما لن تمسّه، وترفض الأسماء المستخدمة بالفعل. وإذا توقف النشر في منتصف العملية، فإن تشغيل الأمر نفسه مرة أخرى يتابع دون إنشاء أي شيء مرتين.

cd cloudflare
# Option 1: the bundled CLI (Node 20+; plan first, then --yes). PowerShell:
$env:CLOUDFLARE_API_TOKEN = "<token: Account Settings Read; Workers Scripts, R2 and D1 Edit;
                              for --zone/--hostname also Zone Read, DNS Read, Workers Routes Read>"
node deploy/cli.mjs whoami
node deploy/cli.mjs plan --account <account id> --name snaps
#   no workers.dev name on the account yet? The plan asks you to "Choose your free
#   workers.dev name": add --subdomain <your-company> to both commands (account-wide).
#   A subdomain of your domain as well: add --zone <zone id> --hostname snaps.example.com
node deploy/cli.mjs deploy --account <account id> --name snaps --yes
#   prints the Studio address and the Admin key once, and writes deployment.json here

# Option 2: plain Wrangler (create the bucket and database, set their ids in wrangler.jsonc)
npm install
npx wrangler r2 bucket create maxisnap-studio-media
npx wrangler d1 create maxisnap-studio
npx wrangler secret put ADMIN_KEY
npm run sync
npx wrangler deploy

يطبع النشر عنوان Studio ومفتاح المسؤول مرة واحدة، ويكتب الملف deployment.json في المجلد الذي يعمل منه. احتفظ بهذا الملف: يستخدمه الأمران update وremove.

تحقق من أنه يعمل

curl.exe -s -H "X-Dashboard-Key: <Admin key>" https://<studio address>/api/health.php
# {"ok":true,"app":"Maxisnap Studio","version":"…"}   the Cloudflare edition adds "edition":"cloudflare"

بعد ذلك افتح عنوان Studio في متصفح وسجّل الدخول بمفتاح المسؤول. الرمز 401 يعني مفتاحًا خاطئًا؛ والرمز 404 يعني عنوانًا أو مجلدًا خاطئًا.

اربط Maxisnap

• Maxisnap لنظام Windows: افتح الإعدادات ← الحساب ← معالج إعداد Maxisnap Studio، وانقر على «ابدأ الآن»، ثم على «التالي» حتى الخطوة 4، «ربط Maxisnap». الصق عنوان Studio الخاص بك ومفتاحه، وانقر على «اختبار الاتصال»، ثم «التالي»، ثم «إنهاء وحفظ» في الصفحة الأخيرة. يمكنك استخدام مفتاح المسؤول الذي ظهر لك أثناء الإعداد، أو رمز رفع من «People & access» في لوحة التحكم.
• Maxisnap لنظام Mac: افتح «Settings»‏ ← «Welcome & Help»‏ ← «Studio Setup Guide» واختر «I already have a dashboard». الصق عنوان Studio الخاص بك ومفتاحه، وانقر على «Test Connection»، ثم «Next»، ثم «Finish & Save».

تعرّف على واجهة API للرفع

• ترفع تطبيقات Maxisnap الملفات إلى api/upload.php مع ترويسة X-Dashboard-Key. وتُقبل الصور (PNG وJPG وGIF وWebP) ومقاطع الفيديو (MP4 وWebM وMOV).
• يرسل Maxisnap لنظام Windows وMaxisnap لنظام Mac كل عملية رفع إلى Studio على Cloudflare في طلب واحد، ويقبل Studio ما يصل إلى 25 MB لكل ملف.
• يتضمن إصدار Cloudflare أيضًا واجهة API للرفع على أجزاء للملفات الأكبر، وهي موصوفة في «Developer guide»: api/upload/start وpart وcomplete.
• تستخدم صفحات المشاركة وملفات الوسائط الخاصة بها هذه المسارات؛ وكل مسار آخر داخلي: /<slug> /<slug>.<ext>

حدّثه أو أزله لاحقًا

PHP: استبدل الملفات المدرجة في snaps/How to update.txt فقط، ثم امسح ذاكرتي التخزين المؤقت للاستضافة ولشبكة CDN. وتبقى اللقطات وأعضاء الفريق والعلامة التجارية والإعدادات كما هي.

Cloudflare: شغّل هذه الأوامر من مجلد cloudflare في الحزمة الأحدث، مع نسخ ملف deployment.json القديم إليه.

# Update: from a newer package's cloudflare folder, with the old deployment.json copied in
node deploy/cli.mjs update --record deployment.json --yes
# New Admin key (shown once):
node deploy/cli.mjs update --record deployment.json --yes --new-admin-key
# Remove the custom domain and the Worker; the bucket and database (the captures) stay
node deploy/cli.mjs remove --record deployment.json --yes
# Also delete every capture: cannot be undone
node deploy/cli.mjs remove --record deployment.json --yes --delete-data

اقرأ الموجز التقني لـ Cloudflare: كل مورد وإذن واستدعاء API.