嵌入和调整CMS模块

教程的前提和目标

本教程需要你有一个开发者访问到bluetronix CMS。你应该已经知道开发者文件夹是如何运作的，以及为什么在系统文件夹中自定义文件用_own标记。

我们将使用现有的新闻 - 博客模块作为示例。你将激活模块，将其列表视图嵌入到CMS页面中，然后有针对性地调整自定义模块文件和配置。原始文件保持不变。

1. 激活博客模块

在CMS中打开模块并选择新闻 - 博客。

激活激活博客模块选项，并用OK确认安全提示。

此后，模块配置器便可使用。左侧为技术设置，右侧为依赖于语言的模块文本。

在CMS页面中嵌入博客列表

打开页面/Blog/index.html并选择HTML代码。博客页面通过一个简短的CMS标记嵌入。

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

该标记引用博客模块及其列表视图。CMS在渲染时在此位置插入生成的模块输出。

打开文件管理器中的中央模块文件

模块的实际PHP和HTML逻辑并不直接位于页面HTML中，而是集中在系统文件夹bx_Mod中。首先在文件管理器中打开此文件夹，然后打开子文件夹博客。

在博客文件夹中，你可以找到例如模块-Blog-List.php、模块-Blog-ShowCase.php、config.php、其他模块文件和子文件夹languages。

查看博客列表的标准文件

选择 Modul-Blog-List.php 并通过 编辑 打开它。

标准文件包含列表视图的程序逻辑。在示例代码中，包括模块配置和项目特定的 config_own.php（如果存在）。

这样，一个模块的引入可以在不同页面使用相同的中央程序逻辑。对于使用标准模块的项目，以后 CMS 更新可能会提供对该文件的更改。

不要直接编辑原始的 Modul-Blog-List.php。它属于系统，可能会在 CMS 更新时被覆盖。

创建自己的列表视图使用 _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!!!! 最新文章 来识别活动的自有文件。

模块设置和自定义配置

除了 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。因此，自定义配置文件不必重复所有标准值，而只需包含所需的偏差。

设定数据库表和模块页面

在标准配置 bx_Mod/Blog/config.php 中，您可以找到所使用的数据库表以及详细和列表视图的路径。在示例中，值为：

$CF_DatabaseTable = "Blog";

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

如果您基于博客模块开发用于其他目的的自定义变体，可以在自己的配置中提供不同的数据库表。在此过程中，请检查新表是否包含模块文件所需的字段，以及列表和详细页面是否与新变体相匹配。

模块的语言文件

在 bx_Mod/Blog/languages 目录下可以找到博客模块的语言文件。对于现有语言，有单独的 PHP 文件，例如 de.php、en.php 和 fr.php。

在这里管理与语言相关的模块文本。对于项目特定的更改，请使用您模块版本支持的自定义文件格式，而不是直接覆盖原始语言文件。

区分标准模块和自定义版本

_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

这样可以在不改变原始系统文件的情况下，针对现有模块进行有针对性的扩展。