عن المشروع

# Total CMS نظام إدارة محتوى حديث يعتمد على الملفات المسطحة للغة PHP 8.2+ يقوم بتخزين كافة المحتويات كملفات JSON على القرص بدلاً من قاعدة البيانات. لا توجد قاعدة بيانات MySQL لإعدادها، ولا عمليات ترحيل (migrations) لتشغيلها، ولا نظام بيئي للمكونات الإضافية للحفاظ على ترقيعها — يعيش المحتوى على القرص، لذا فهو يخضع للتحكم في الإصدارات، والنسخ الاحتياطي، والنشر تمامًا مثل بقية التعليمات البرمجية الخاصة بك. ## الميزات الأساسية - **لا يتطلب قاعدة بيانات** — يتم تخزين كافة المحتويات كملفات JSON مسطحة على القرص. قم بالنشر ببساطة عن طريق نسخ الملفات بين البيئات. - **33 نوعًا مدمجًا من المجموعات** — مدونة، صورة، معرض صور، ملف، والمزيد، بالإضافة إلى دعم مخططات مخصصة (schemas) غير محدودة. - **قوالب Twig** — يحتوي على 89 فلترًا مخصصًا و49 دالة مضافة إلى Twig 3 القياسي لمنطق قوالب قوي. - **أداة بناء المواقع (Site Builder)** — أضف صفحة في واجهة الإدارة وستصبح نشطة على الفور. لا توجد خطوة بناء أو توليد مطلوبة. - **واجهة برمجة تطبيقات REST API** — عمليات CRUD كاملة للاستخدام بدون واجهة (headless)، مع مصادقة عبر مفتاح API أو OAuth 2.1. - **خادم MCP مدمج** — يعرض مجموعات موقعك والبحث لوكلاء الذكاء الاصطناعي (إصدار Pro). - **الأتمتة** — معالجات مجدولة، وwebhooks، ومعالجات يتم تشغيلها بواسطة الأحداث مع طابور وظائف (job queue). - **نظام الامتدادات** — دورة حياة تسجيل/تشغيل (register/boot) مع أذونات قائمة على القدرات. - **واجهة الإدارة** — أداة بناء نماذج تحتوي على أكثر من 20 نوعًا من الحقول، وإدارة الوسائط، ودعم تسجيل الدخول باستخدام مفتاح المرور (passkey). - **واجهة سطر الأوامر CLI (`tcms`)** — إدارة المجموعات، والمخططات، والكائنات، والاستيراد/التصدير، والمزامنة، وعمليات النشر من سطر الأوامر. - **معالجة الصور** — تغيير الحجم الفوري، وإضافة العلامات المائية، والتعامل مع ألوان OKLCH باستخدام GD أو ImageMagick. ## المتطلبات - PHP 8.2+ (إصدار 8.4 مدعوم) - Composer 2.0+ - Apache أو Nginx مع إعادة كتابة الروابط (URL rewriting) - امتدادات PHP: GD أو ImageMagick، وJSON، وFileinfo، وOpenSSL لا يلزم وجود خادم قاعدة بيانات. لا توجد حاجة لبيئة تشغيل Node.js في بيئة الإنتاج. ## التثبيت ```bash composer create-project totalcms/totalcms mysite cd mysite ``` قم بتوجيه المجلد الرئيسي (document root) لخادم الويب الخاص بك إلى `public/`، ثم افتح الموقع في المتصفح. سيتولى معالج الإعداد حساب المسؤول، ودليل البيانات، وتكوين الترخيص. يوفر برنامج التثبيت أيضًا تخطيط **المسار الفرعي (subpath)**، والذي يخدم Total CMS من `/tcms/` ويترك `public/` فارغًا لبناء الواجهة الأمامية الخاصة بك. ## مثال على القوالب ```twig {% for post in cms.collection.objects('blog') %} <article> <h2>{{ post.title }}</h2> {{ post.content|markdown }} </article> {% endfor %} ``` ## أوامر واجهة سطر الأوامر (CLI) ```bash vendor/bin/tcms collection:list vendor/bin/tcms jumpstart:export backup.json vendor/bin/tcms cache:clear vendor/bin/tcms deploy ``` ## دعم وكلاء الذكاء الاصطناعي تم تصميم Total CMS ليعمل بشكل جيد مع وكلاء البرمجة: - **[llms.txt](https://docs.totalcms.co/llms.txt)** و **[llms-full.txt](https://docs.totalcms.co/llms-full.txt)** — توثيق كامل في عملية جلب واحدة - **مهارة الوكيل (Agent skill)** — يتم تثبيتها في `.claude/skills/` تلقائيًا عند تشغيل `composer install`، وتغطي المجموعات، والمخططات، وواجهة سطر الأوامر (CLI)، وسير عمل أداة بناء المواقع (Site Builder) - **خادم MCP مدمج** — وجه الوكيل إلى موقع نشط للاستعلام عن مجموعاته ومخططاته مباشرة (إصدار Pro) ## التوثيق التوثيق الكامل متاح على [docs.totalcms.co](https://docs.totalcms.co). ## الدعم - [التوثيق](https://docs.totalcms.co) - [الدعم عبر البريد الإلكتروني](mailto:support@totalcms.co) ## الترخيص برنامج Total CMS هو برنامج تجاري. يلزم وجود ترخيص للاستخدام في بيئة الإنتاج. راجع [LICENSE.md](LICENSE.md) لمعرفة الشروط. تتوفر تجارب مجانية لمدة 45 يومًا — لا تتطلب بطاقة ائتمان. تفضل بزيارة [totalcms.co](https://totalcms.co) للحصول على التفاصيل.