编辑“ImpressPages/插件开发”

{{ImpressPages top}}

本条目主要通过一个例子来介绍怎样来创建一个简单的插件，在[[ImpressPages]]中也称为模块（Module）。我们创建一个'''Hello World'''插件，该插件都属于插件组（模块组）examples中，下面是具体创建步骤：

*'''第一步，创建相关文件夹'''
首先，我们需要在'''ip_plugins'''目录中创建一个'''examples'''和'''hello_world'''文件夹，然后整个文件夹的结构如下：
**...
**ip_libs
**ip_plugins 
***examples 
****hello_world
**ip_themes
**...

*'''第二步，创建管理类'''
在'''hello_world'''文件夹中创建'''manager.php'''文件，我们在后台管理面板中打开插件标签页面时将会执行该文件。

将下面的代码复制到'''manager.php'''文件中：
<pre>
<?php   

namespace Modules\examples\hello_world; //"examples" 和"hello_world" 必须与你创建的文件夹名完全一致.   

if (!defined('BACKEND')) exit; //该文件只能在登录后台后被访问执行
class Manager{ //不要修改该行.     

   function manage() { //在后台管理面板中，每一次打开插件标签页面（plugin），都会执行该函数。该函数会返回一个插件管理页面。  
     return 'Hello World';   
  } 
} 
?> 
</pre>

*'''第三步，为插件安装做准备'''
在'''hello_world'''文件夹中创建'''install'''子文件夹，然后将'''plugin.ini'''文件放置该文件夹中，其中'''plugin.ini'''中的内容如下，中文注释不用复制：

<pre>
version:1.00  //版本号
module_title:Hello World //模块（插件）名称
module_key:hello_world //模块关键字
module_group_title:Examples //所属的模块组
module_group_key:examples //模块组关键字
module_managed:1 //模块管理
</pre>

'''module_key'''和''' module_group_key'''必须与第一步中我们创建的文件夹的名称完全一致。

'''module_managed'''配置值主要是告诉系统该模块具有一个管理区域（如果值设置为 1 的话）。设置为0表示在不需要在管理界面中显示该模块的管理标签。

如果你创建的插件还需要其他插件的支持，那么在'''plugin.ini'''的文件底部加上下行代码：
 required_module:plugin_group/plugin/1.00 

*'''第四步，安装'''
登录到ImpressPages [[CMS]]的后台管理界面，来到'''Developer->Modules(开发人员->模块）'''标签页面，然后点击'''install（安装）'''。

然后刷新浏览器，你将会看到新的标签'''Examples'''，点击，然后再点击'''Hello World'''，你将会看到页面中显示文本：Hello World,如下图所示：

[[image:ipmodule.jpg|ImpressPages插件开发|link=ImpressPages/插件开发]]



'''该例子中创建的插件下载：'''

[http://www.impresspages.org/file/ip_plugin_examples_hello_world_1_00.zip ip_plugin_examples_hello_world_1_00.zip] 

==参考来源==
*http://www.impresspages.org/docs/working-with-plugins/hello-world-plugin-example/ 
{{ImpressPages}}

[[category:ImpressPages]]