ماژول‌های CMS را بارگذاری و تنظیم کنید.

پیش‌نیازها و هدف آموزش

برای این آموزش به یک دسترسی توسعه‌دهنده به CMS بلوترونیکس نیاز دارید. باید قبلاً بدانید که پوشه‌های توسعه‌دهنده چگونه کار می‌کنند و چرا فایل‌های سفارشی در پوشه‌های سیستم با _own علامت‌گذاری می‌شوند.

ما از ماژول موجود اخبار - بلاگ به عنوان مثال استفاده می‌کنیم. شما ماژول را فعال می‌کنید، نمای فهرست آن را در یک صفحه CMS بارگذاری کرده و سپس یک فایل ماژول سفارشی و پیکربندی آن را تنظیم می‌کنید. فایل‌های اصلی بدون تغییر باقی می‌مانند.

1. فعال‌سازی ماژول بلاگ

در CMS ماژول‌ها را باز کرده و اخبار - بلاگ را انتخاب کنید.

گزینه فعال‌سازی ماژول بلاگ را فعال کرده و تأیید امنیتی را با تأیید کنید.

سپس پیکربند ماژول در دسترس شما قرار می‌گیرد. تنظیمات فنی در سمت چپ و متون وابسته به زبان ماژول در سمت راست قرار دارند.

2. اضافه کردن لیست بلاگ در یک صفحه CMS

صفحه /Blog/index.html را باز کرده و کد HTML را انتخاب کنید. صفحه بلاگ از طریق یک علامت‌گذاری کوتاه CMS بارگذاری می‌شود.

<!--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 überschrieben شود.

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!!!! NEUESTE ARTIKEL شناسایی کنی.

6. تنظیمات ماژول و پیکربندی شخصی

علاوه بر خروجی HTML، می‌توانی پیکربندی ماژول را نیز تغییر دهی. اسکرین‌شات در تنظیم‌کننده به‌عنوان مثال برای Modul-Blog-ShowCase مقدار DS Repeats = 3 را نشان می‌دهد.

مقدار را به 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 تغییرات تو را از بازنویسی با به‌روزرسانی‌های معمولی محافظت می‌کند. هم‌زمان، تو مسئول نگهداری این نسخه فردی هستی. در به‌روزرسانی‌های آینده 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

به این ترتیب می‌توانید یک ماژول موجود را به‌طور هدفمند گسترش دهید، بدون اینکه فایل‌های سیستم اصلی را تغییر دهید.