Apache OFBiz Themes 17.12

• 语言: 英语
• 格式: .pdf
• 来源: ofbizextra.org

摘要

文档详细介绍了Apache OFBiz的主题系统，包括主题的定义、结构、创建和扩展方法。主题是一种组件，用于定义渲染屏幕所需的所有元素。旧系统通过VisualTheme和VisualThemeResource在数据库中存储配置，但现在推荐使用Theme.xml文件进行定义。文档还提供了创建自定义主题的步骤，并强调了扩展common-theme以确保兼容性和功能完整性。

AI总结

### Apache OFBiz Themes 17.12 总结

#### 1. 主题定义
- **主题**是OFBiz组件，用于定义渲染屏幕所需的所有元素，使用HTML5、jQuery和CSS技术。
- 主题可定义属性、自定义Ftl宏和屏幕装饰器，用于准备最终用户界面。

#### 2. 主题结构
- **Theme.xml**文件定义了主题的渲染方式，包含以下内容：
- **主定义**：定义一个或多个`visualThemeId`，需在数据库中对应`VisualTheme`实体。

- **扩展**：通过``元素继承其他主题，推荐继承`common-theme`以确保兼容性。
- **通用属性**：屏幕引擎使用的渲染属性。
- **特定属性**：主题自定义属性，可在Ftl模板中初始化。
- **Ftl宏库**：定义屏幕模型（如Screen、Form、Tree、Menu）的宏库位置。
- **屏幕库**：定义OFBiz的屏幕定义文件，通常无需修改。

#### 3. 向后兼容性
- **旧版本主题**：旧版本通过`VisualTheme`和`VisualThemeResource`定义主题，所有逻辑仍在`common-theme`中保留。
- **BlueLight主题示例**：旧主题的属性已迁移到`common-theme`，并可通过新系统使用。

#### 4. 创建自定义主题
- **基本步骤**：
1. 创建`Theme.xml`文件，包含基本定义：

2. 添加数据文件`VisualTheme`，定义主题：

- **扩展`common-theme`**：通过继承`common-theme`，仅覆盖需要修改的部分。
- **屏幕库定义**：在`Theme.xml`中定义屏幕库位置，推荐使用`common-theme`的默认配置。

#### 5. 总结
- `common-theme`是基础主题，确保OFBiz的正常运行。
- 新主题推荐继承`common-theme`，仅修改需要调整的部分。
- 旧主题通过`common-theme`保持兼容性，属性已迁移到新系统。
- 创建主题需定义`Theme.xml`文件和相关数据文件，确保在OFBiz实例中正确显示。