ECMALL 挂件开发详细指南

需积分: 9 5 下载量 142 浏览量 更新于2024-09-15 1 收藏 20KB DOCX 举报
ECMALL 挂件开发指南 ECMALL 挂件开发指南是一份详细的开发指南,旨在指导开发者如何创建和开发 ECMALL 挂件。该指南涵盖了挂件的基本结构、配置文件、代码实现等方面的内容。 **挂件的基本结构** ECMALL 挂件存放在 `/external/widgets` 目录下,每个目录对应一个挂件。典型的挂件文件组成包括: * `widget.info.php`:挂件描述信息文件,包含挂件的基本信息,如名称、作者、版本号等。 * `main.widget.php`:挂件主程序文件,包含挂件的主要逻辑代码。 * `widget.html`:挂件显示界面文件,用于显示挂件的内容。 * `config.html`:挂件配置界面文件,用于配置挂件的参数(可选)。 **创建一个挂件** 创建一个名为 `hello_widget` 的挂件,需要创建一个同名的目录,并在该目录下创建四个文本文件:`widget.info.php`、`main.widget.php`、`widget.html` 和 `config.html`。其中,`widget.info.php` 文件用于存储挂件的基本信息,如名称、作者、版本号等。 **widget.info.php 文件** `widget.info.php` 文件用于存储挂件的基本信息,包括: * `name`:挂件的唯一标识,必须与挂件目录名保持一致。 * `display_name`:挂件的显示名称。 * `author`:挂件的作者。 * `website`:作者的网站。 * `version`:挂件的版本号。 * `desc`:挂件的描述。 * `configurable`:挂件是否可配置,值为 `true` 或 `false`。 **挂件的代码实现** 每个挂件的主体代码被放在 `main.widget.php` 文件中,需要继承自 `BaseWidget` 类。挂件类的命名规则是:“挂件的目录名得首字母大写”+“Widget”,如 `Hello_widgetWidget`。该类必须拥有 `$_name` 成员,并且该成员的值必须与 `widget.info.php` 文件中所设置的 `name` 值保持一致。 **挂件类的结构** 典型的挂件类结构包括: * `__construct` 方法:用于初始化挂件。 * `render` 方法:用于渲染挂件的内容。 * `getConfig` 方法:用于获取挂件的配置参数。 * `setConfig` 方法:用于设置挂件的配置参数。 ECMALL 挂件开发指南为开发者提供了一份详细的开发指南,涵盖了挂件的基本结构、配置文件、代码实现等方面的内容。