التثبيت

يُثبَّت TubePress كأي تطبيق PHP كلاسيكي: ارفع الملفات، ووجّه متصفحًا نحو نطاقك، ثم اتّبع معالج إعداد قصير عبر الويب. لا سطر أوامر، ولا خطوة بناء.

خصّص نحو خمس دقائق. قبل البدء، تحقّق من أن خادمك يستوفي المتطلبات وأن تفاصيل قاعدة البيانات في متناولك.

تنزيل TubePress

احصل على أحدث إصدار من صفحة التنزيل. يتضمن ملف ZIP واحدًا صغيرًا يحتوي على شيفرة PHP كاملة وقابلة للتعديل — لا مفتاح ترخيص ولا ionCube.

رفع الملفات إلى خادمك

استخرج ملف ZIP وارفع محتوياته إلى خادمك عبر FTP/SFTP أو مدير ملفات مضيفك. القاعدة الوحيدة المهمة: يجب أن يشير جذر الويب إلى مجلد public/، لا إلى جذر المشروع. كل شيء آخر — config/، src/، storage/، themes/، plugins/ — يقع مستوى واحدًا فوق جذر المستند ولا يُقدَّم مباشرةً أبدًا.

تشغيل معالج التثبيت عبر الويب

زُر نطاقك في متصفح. نظرًا لعدم وجود علامة config/installed.php بعد، يحوّلك TubePress مباشرةً إلى معالج الإعداد. ويتألف من ست خطوات:

1. مرحبًا. شاشة تمهيدية قصيرة — انقر للمتابعة والبدء.
2. فحص النظام. يتحقق من إصدار PHP والإضافات والمجلدات القابلة للكتابة. عند اجتياز جميع الفحوصات المطلوبة يتقدم تلقائيًا؛ وإن فشل شيء ما، يتوسع كل بند ليُظهر طريقة إصلاحه.
3. قاعدة البيانات. أدخل مضيف قاعدة البيانات واسمها والمستخدم وكلمة المرور. يتصل TubePress ويُنشئ قاعدة البيانات إن استطاع (أو يستخدم واحدة موجودة في الاستضافة المشتركة)، ويُنفّذ جميع هجرات SQL، ثم يكتب config/database.php. يقبل حقل المضيف أيضًا host:port أو مسار socket.
4. المسؤول. أنشئ حساب المسؤول — اسم مستخدم (3–50 حرفًا)، وبريد إلكتروني صالح، وكلمة مرور مكوّنة من 8 أحرف على الأقل.
5. الإعدادات. سمِّ موقعك (الوصف اختياري). يُكتشف عنوان URL الخاص بالموقع تلقائيًا ويُعيَّن 24 فيديو لكل صفحة كإعداد افتراضي — كلاهما قابل للتعديل لاحقًا.
6. اكتمال. يُنشئ TubePress الصفحات الافتراضية والإعدادات وإعدادات SEO الافتراضية، ويكتب علامة التثبيت، ثم يُعطيك الرابط إلى لوحة الإدارة الجديدة.

أذونات الملفات

يجب أن يمتلك مستخدم خادم الويب (غالبًا www-data) ثلاثة مواقع ويتمكن من الكتابة إليها: config/ (لحفظ إعداداتك)، وstorage/ (السجلات والملفات المؤقتة والنسخ الاحتياطية)، وpublic/uploads/ (وسائطك). يُشير فحص النظام إلى أي منها غير قابل للكتابة.

# Give the web-server user ownership
chown -R www-data:www-data config storage public/uploads

# Directories 755, files 644
find config storage public/uploads -type d -exec chmod 755 {} \;
find config storage public/uploads -type f -exec chmod 644 {} \;

فقط هذه المسارات الثلاثة تحتاج إلى أن يتمكن الخادم من الكتابة إليها؛ ويمكن أن تبقى بقية الشجرة للقراءة فقط.

Apache مقابل Nginx

كلاهما مدعومان بالكامل ويُكتشفان تلقائيًا أثناء التثبيت.

• Apache — عيّن AllowOverride All لكي تتمكن ملفات .htaccess المرفقة من التعامل مع عناوين URL النظيفة وحجب الوصول إلى المجلدات الحساسة. عند الاكتمال، يُنشئ TubePress روابط رمزية public/themes وpublic/templates لتحليل أصول الثيم.
• Nginx — أضف قاعدة try_files … /index.php?$query_string القياسية، وأنشئ اسمًا مستعارًا لـ/themes/ و/templates/ يشير إلى مجلدات المشروع، وطبّق deny على مسارات config/ وsrc/ وstorage/. توجد مقتطفات كاملة في المتطلبات.

التطوير المحلي (localhost)

يعمل TubePress على تثبيت localhost بـ HTTP العادي دون أي إعداد خاص — يعمل المثبّت والجلسات وتسجيل الدخول بدون HTTPS. إليك خياران سهلان:

• خادم ويب محلي (الأقرب إلى بيئة الإنتاج) — وجّه Apache أو Nginx نحو مجلد public/، تمامًا كما هو موضح أعلاه.
• الخادم المدمج في PHP (بدون إعداد) — من جذر المشروع، شغّل الأمر أدناه، ثم افتح http://localhost:8000.

php -S localhost:8000 -t public public/router.php

يمنحك router.php المرفق عناوين URL نظيفة، ويقدّم المتحكم الأمامي أصول الثيم والإدارة مباشرةً — فيعمل التنسيق فور التثبيت حتى بدون إعداد اسمَي الأصول المستعارَين.

بعد التثبيت

سجّل الدخول عند /admin بالحساب الذي أنشأتَه للتو وابدأ في إعداد موقعك. يرشدك دليل الخطوات الأولى عبر هوية الموقع والعلامة التجارية وأول مقاطع الفيديو وقائمة التحقق قبل الإطلاق. من المفيد أيضًا تقوية تسجيل دخول المسؤول مبكرًا — راجع الأمان.

الخطوات التالية