שילוב והגדרת מודולי CMS

דרישות והמטרה של המדריך

כדי לבצע את המדריך הזה תזדקק ל גישה למפתחים ל-CMS bluetronix. עליך לדעת כבר כיצד מתפקדים תיקי המפתחים ולמה קבצים אישיים בתיקי המערכת מסומנים ב _own.

אנו משתמשים במודול חדשות - בלוג הקיים כדוגמה. אתה מפעיל את המודול, משלב את תצוגת הרשימה שלו בדף CMS ולאחר מכן מתאים קובץ מודול אישי ואותם קונפיגורציות. הקבצים המקוריים יישארו ללא שינוי.

1. הפעלת מודול הבלוג

פתח ב-CMS את מודולים ובחר את חדשות - בלוג.

הפעל את האפשרות להפעיל את מודול הבלוג ואשר את שאלת האבטחה עם אוקי.

לאחר מכן, קונפיגורטור המודול זמין לך. משמאל נמצאות ההגדרות הטכניות, מימין טקסטי המודול התלוי בשפה.

2. לשלב רשימת בלוגים בדף CMS

פתח את הדף /Blog/index.html ובחר קוד HTML. דף הבלוג משולב באמצעות תיוג CMS קצר.

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

התיוג מפנה למודול הבלוג ולתצוגת הרשימה שלו. ה-CMS משתמש בשעת רינדור בנקודה זו ביציאה שהמודול יצר.

3. לפתוח קבצי מודול מרכזיים במנהל הקבצים

הלוגיקה האמיתית של ה-PHP וה-HTML של המודולים אינה נמצאת ישירות ב-HTML של הדף, אלא במרכז בתיקיית המערכת bx_Mod. פתח במנהל הקבצים קודם את התיקיה הזו ולאחר מכן את התיקיה המשנית בלוג.

בתיקיית הבלוג תמצא לדוגמה את Modul-Blog-List.php, Modul-Blog-ShowCase.php, config.php, קבצי מודול נוספים ותיקיית languages.

4. לצפות בקובץ הסטנדרטי של רשימת הבלוגים

בחר את Modul-Blog-List.php ופתח אותה דרך עריכה.

הקובץ הסטנדרטי כולל את הלוגיקה של התוכנית עבור תצוגת הרשימה. בקוד המוצג משתלבים בין היתר הגדרת המודול ו, אם יש, config_own.php ספציפי לפרויקט.

כך ניתן להשתמש בהטמעה אחת של מודול בדפים שונים באותה הלוגיקה מרכזית של התוכנית. עבור פרויקטים המשתמשים במודול הסטנדרטי, עדכוני CMS עתידיים עשויים לספק שינויים בקובץ זה.

אל תערוך ישירות את Modul-Blog-List.php המקורית. היא שייכת למערכת ויכולה להת overwritten בעדכון CMS.

5. ליצור תצוגת רשימה אישית עם _own

כדי לשנות את הפלט בעצמך, העתק את הקובץ הסטנדרטי. העתקה שלך תקבל בדיוק את הסימון המתאים _own:

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

פתח את הקובץ החדש Modul-Blog-List_own.php. בגרסה ספציפית זו לפרויקט אתה יכול לשנות לוגיקת PHP ופלט HTML מבלי לגעת בקובץ הסטנדרטי.

במבחן שלנו אנו מוסיפים בכותרת את מחרוזת הטקסט הבולטת NEW!!!!. שאר תצוגת הרשימה נשמרת.

שמור את קובץ המודול שלך והטען מחדש את דף הבלוג. ה-CMS משתמש בגרסה המתאימה _own, בעוד שהמקום ב/Blog/index.html נשאר ללא שינוי. תזהה את הקובץ האישי הפעיל לפי הכותרת המיוחדת NEW!!!! מאמרים חדישים.

6. הגדרות מודול והגדרה אישית

מעבר לפלט HTML, אתה יכול גם לשנות את ההגדרות של המודול. צילום המסך מציג במקשר עבור Modul-Blog-ShowCase את הערך DS Repeats = 3.

שנה את הערך ל2 ושמור את ההגדרה. כך ייקבע מספר המופעים הרצוי לאזור הצג הזה. ההגדרה מתייחסת ל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 מגנה על ההתאמות שלך מפני כתב ברק על ידי עדכונים רגילים. במקביל, אתה אחראי על התחזוקה של הגרסה האישית הזו. בדוק בעדכוני CMS עתידיים אם שינויים חשובים בקובץ הסטנדרטי רלוונטיים גם לקובץ שלך.

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

כך ניתן להרחיב מודול קיים באופן ממוקד, מבלי לשנות את קובצי המערכת המקוריים.