دمج وتعديل وحدات CMS

متطلبات وهدف البرنامج التعليمي

لإكمال هذا البرنامج التعليمي، تحتاج إلى وصول مطور إلى نظام إدارة المحتوى bluetronix. ينبغي أن تكون قد تعرفت بالفعل على كيفية عمل مجلدات المطورين ولماذا يتم وسم الملفات الخاصة في مجلدات النظام باستخدام _own.

نستخدم وحدة الأخبار - المدونة الموجودة كمثال. ستقوم بتفعيل الوحدة، ودمج عرض القائمة الخاصة بها في صفحة CMS، ثم تعديل ملف الوحدة الخاص بك وإعداد التكوين. ستبقى الملفات الأصلية دون تغيير.

1. تفعيل وحدة المدونة

افتح في نظام إدارة المحتوى الوحدات واختر الأخبار - المدونة.

قم بتفعيل خيار تفعيل وحدة المدونة وأكد على استفسار الأمان باستخدام موافق.

بعد ذلك، سيكون لديك منشئ تكوين الوحدة متاحًا. على اليسار توجد الإعدادات الفنية، وعلى اليمين النصوص الخاصة بالوحدة حسب اللغة.

2. تضمين قائمة المدونات في صفحة CMS

افتح الصفحة /Blog/index.html واختر كود HTML. يتم دمج صفحة المدونة من خلال وسمة قصيرة من نظام إدارة المحتوى.

<!--bx_Mod/Blog/Modul-Blog-List-->

تشير العلامة إلى وحدة المدونة وعرض القائمة الخاصة بها. يستخدم نظام إدارة المحتوى (CMS) المخرجات الناتجة عن الوحدة في هذا الموضع عند التشغيل.

3. فتح ملفات الوحدة المركزية في إدارة الملفات

المنطق الفعلي لـ PHP و HTML للوحدات لا يوجد مباشرة في HTML الصفحة، بل في المجلد المركزي للنظام bx_Mod. افتح في مدير الملفات هذا المجلد أولاً، ثم المجلد الفرعي Blog.

في مجلد المدونة، ستجد على سبيل المثال Modul-Blog-List.php، Modul-Blog-ShowCase.php، config.php، ملفات وحدات إضافية والمجلد الفرعي languages.

4. عرض الملف القياسي لقائمة المدونات

اختر Modul-Blog-List.php وافتحها عبر تحرير.

يحتوي الملف الافتراضي على منطق البرمجة لعرض القائمة. في الشيفرة المعروضة، يتم تضمين تكوين الوحدة، وإذا كان موجودًا، فإن config_own.php الخاصة بالمشروع.

بهذا، يمكن لوحدة واحدة أن تستخدم نفس منطق البرمجة المركزي في صفحات مختلفة. بالنسبة للمشاريع التي تستخدم الوحدة الافتراضية، يمكن أن توفر التحديثات اللاحقة لنظام إدارة المحتوى (CMS) تغييرات على هذا الملف.

لا تقم بتحرير Modul-Blog-List.php الأصلية مباشرة. إنها تنتمي إلى النظام ويمكن أن يتم تجاوزها عند تحديث نظام إدارة المحتوى (CMS).

5. إنشاء عرض قائمة خاص باستخدام _own

لتغيير المخرجات بنفسك، انسخ الملف الافتراضي. النسخة الخاصة تحصل على العلامة المناسبة تمامًا _own:

Modul-Blog-List.php
        ↓ kopieren
Modul-Blog-List_own.php

افتح الملف الجديد Modul-Blog-List_own.php. في هذا الإصدار الخاص بالمشروع، يمكنك تغيير منطق PHP والمخرجات HTML دون لمس الملف الافتراضي.

في اختبارنا، نضيف إلى العنوان السلسلة المرئية NEW!!!!. تبقى بقية عرض القائمة دون تغيير.

احفظ ملف الوحدة الخاص بك وأعد تحميل صفحة المدونة. يستخدم نظام إدارة المحتوى النسخة المناسبة _own، بينما يبقى عنصر العنصر النائب في /Blog/index.html دون تغيير. يمكنك التعرف على الملف الخاص النشط من خلال العنوان المتغير NEW!!!! أحدث المقالات.

6. إعدادات الوحدة والتكوين الخاص

بالإضافة إلى مخرجات HTML، يمكنك أيضًا تغيير تكوين الوحدة. تظهر لقطة الشاشة في المكون، على سبيل المثال، لقيمة DS Repeats = 3 لـ Modul-Blog-ShowCase.

غير القيمة إلى 2 واحفظ الإعداد. بذلك يتم تحديد العدد المطلوب لهذه المنطقة من عرض Showcase. يتعلق الإعداد بـ Modul-Blog-ShowCase ولا يجب أن يُعتبر تلقائيًا كعدد جميع المقالات في عرض قائمة المدونة.

التكوين الخاص موجود في bx_Mod/Blog/config_own.php. اختر هذا الملف في مدير الملفات.

تقوم config_own.php المعروضة بتجاوز القيمة فقط عند تحميل منطقة الوحدة المعنية Modul-Blog-ShowCase:

if($ModulNameGB == "Modul-Blog-ShowCase") {
   $CF_DS_Repeats = 2;
}

تستمر القيم الافتراضية بالقدوم من config.php. لذلك، لا يجب على ملف التكوين الخاص تكرار جميع القيم الافتراضية، بل يمكن أن يحتوي فقط على التغييرات المطلوبة.

7. تحديد جدول البيانات وصفحات الوحدة

في التكوين الافتراضي bx_Mod/Blog/config.php، ستجد، من بين أشياء أخرى، جدول قاعدة البيانات المستخدم والمسارات إلى عرض التفاصيل والقائمة. في المثال المعروض، تكون القيم كالتالي:

$CF_DatabaseTable = "Blog";

$CF_DetailPage = "/Blog/Detail.html";
$CF_ListPage = "/Blog/index.html";

إذا كنت تقوم بتطوير نسخة خاصة لغاية أخرى بناءً على وحدة المدونة، يمكنك في تكوينك الخاص إدخال جدول قاعدة بيانات آخر. تحقق مما إذا كان الجدول الجديد يحتوي على الحقول التي تتوقعها файлу.

8. ملفات اللغة للوحدة

في bx_Mod/Blog/languages، توجد ملفات اللغة لوحدة المدونة. توجد لليغات الحالية ملفات PHP منفصلة، على سبيل المثال de.php، en.php و fr.php.

هنا يتم إدارة نصوص الوحدات المعتمدة على اللغة. استخدم تنسيق الملفات الخاص بمشروعك المدعوم من إصدار الوحدة الخاص بك لإجراء التغييرات، بدلاً من الكتابة على ملفات اللغة الأصلية مباشرة.

9. التمييز بين الوحدة القياسية وإصدارك الخاص

قاعدة _own تحمي تعديلاتك من الكتابة عليها بواسطة التحديثات العادية. في الوقت نفسه، أنت مسؤول عن صيانة هذا الإصدار الفردي. تحقق عند تحديث نظام إدارة المحتوى لاحقًا مما إذا كانت التغييرات الهامة في الملف القياسي ذات صلة أيضًا بملفك الخاص.

10. ملخص

تقوم بتمكين وحدة المدونة من خلال الوحدات → الأخبار - مدونة، وتدمج عرض القائمة عبر علامة CMS، وتدير المنطق البرمجي الفعلي مركزيًا تحت bx_Mod/Blog. لإجراء تغييرات خاصة، انسخ Modul-Blog-List.php إلى Modul-Blog-List_own.php. الإعدادات التي تختلف عن القياسية يمكنك حفظها عند الحاجة في config_own.php.

CMS-Seite /Blog/index.html
        ↓ Modul-Markierung
bx_Mod/Blog/Modul-Blog-List.php
        ↓ passende _own-Datei vorhanden?
Modul-Blog-List_own.php
        ↓ Konfiguration und Datenbank
HTML-Ausgabe innerhalb der CMS-Seite

بهذه الطريقة، يمكن توسيع وحدة موجودة بشكل مستهدف، دون تغيير ملفات النظام الأصلية.