自定义首页DIY模块教程

在论坛上好几天，都没有解决这个问题。。
最后是在这个帖子找到的灵感。。。

PS:此教程只适合编程人员观看，不会PHP的请跳过。谢谢

http://ggmmchou.blog.163.com/blog/static/59333149201142075017844/

具体如下：
打开文件夹source\class\block\然后在此目录新建一个文件夹 名称自己写。必须英文的.例如 mdir
然后在source\class\block\mdir里建立一个文件
文件名：blockclass.php 这个不能变，必须是这个名
编辑blockclass.php
写入以下内容：

1. <?php
   
2.         $blockclass = array(
   
3.                 'name' => '我的小小模块', //为此目录定义一个名字
   
4.         );
   
5. ?>

复制代码

当当当。重点来了。。
新建一个.php文件  文件名必须以block_开头 例如block_mdir.php
然后写入以下内容：

1. <?php
   
2. 
   
3. 
   
4. if(!defined('IN_DISCUZ')) {
   
5.         exit('Access Denied');
   
6. }
   
7. 
   
8. 
   
9. class block_prices {
   
10.         function block_prices(){
    
11.                
    
12.                 }
    
13. 
    
14.         /**
    
15.          * 必须！
    
16.          * 返回本数据调用类的显示名称（显示在创建模块时选择“模块数据”的下拉列表里）
    
17.          * @return
    
18.          */
    
19.         function name() {
    
20.                 return '示例数据类';
    
21.         }
    
22. 
    
23.         /**
    
24.          * 必须！
    
25.          * 返回一个数组： 第一个值为本数据类所在的模块分类；第二个值为模块分类显示的名称（显示在 DIY 模块面板）
    
26.          * @return
    
27.          */
    
28.         function blockclass() {
    
29.                 return array('sample', '示例分类');
    
30.         }
    
31. 
    
32.         /**
    
33.          * 必须！
    
34.          * 返回数据类中可供“模块样式”使用的字段。
    
35.          * 格式见示例：
    
36.          * name 为该字段的显示名称
    
37.          * formtype 决定编辑单条数据时该字段的显示方式： 类型有： text, textarea, date, title, summary, pic； 详见 portalcp_block.htm 模板（搜 $field[formtype] ）
    
38.          * datatype 决定该字段的数据展示，类型有： string, int, date, title, summary, pic； 详见 function_block.php 中 block_template 函数
    
39.          * @return
    
40.          */
    
41.         function fields() {
    
42.                 return array(
    
43.                         'field1' => array('name' => '示例字段1', 'formtype' => 'text', 'datatype' => 'string'),
    
44.                         'field2' => array('name' => '示例字段2', 'formtype' => 'title', 'datatype' => 'title'),
    
45.                 );
    
46.         }
    
47. 
    
48.         /**
    
49.          * 必须！
    
50.          * 返回使用本数据类调用数据时的设置项
    
51.          * 格式见示例：
    
52.          * title 为显示的名称
    
53.          * type 为表单类型， 有： text, password, number, textarea, radio, select, mselect, mradio, mcheckbox, calendar； 详见 function_block.php 中 block_makeform() 函数
    
54.          * @return
    
55.          */
    
56.         function getsetting() {
    
57.                 return array(
    
58.                         'param1' => array(
    
59.                                 'title' => '数据调用参数1',
    
60.                                 'type' => 'text',
    
61.                                 'default' => ''
    
62.                         ),
    
63.                         'param2' => array(
    
64.                                 'title' => '数据调用参数2',
    
65.                                 'type' => 'mcheckbox',
    
66.                                 'value' => array(
    
67.                                         array('1', '选项1'),
    
68.                                         array('2', '选项2'),
    
69.                                 ),
    
70.                                 'default' => '1'
    
71.                         ),
    
72.                 );
    
73.         }
    
74. 
    
75.         /**
    
76.          * 必须！
    
77.          * 处理设置参数，返回数据
    
78.          * 返回数据有两种：
    
79.          * 一种是返回 html，放到模块 summary 字段，直接显示； 返回格式为： array('html'=>'返回内容', 'data'=>null)
    
80.          * 一种是返回 data，通过模块样式渲染后展示，返回的数据应该包含 fields() 函数中指定的所有字段； 返回格式为： array('html'=>'', 'data'=>array(array('title'=>'value1'), array('title'=>'value2')))
    
81.          * 特别的：
    
82.          * parameter 参数包含 getsetting() 提交后的内容； 并附加了字段：
    
83.          * items ，为用户指定显示的模块数据条数；
    
84.          * bannedids ，为用户选择屏蔽某数据时记录在模块中的该数据 id。 应该在获取数据时屏蔽该数据；
    
85.          *
    
86.          * 如果返回的数据给 data， 那么应该包含 fields() 函数指定的所有字段。并附加以下字段：
    
87.          * id 标志该数据的 id，如果用户屏蔽某数据时，会将该数据的 id 添加到 parameter[bannedids] 里
    
88.          * idtype 标志该数据的 idtype
    
89.          *
    
90.          * @param  $style 模块样式（见 common_block_style 表）。 可以根据模块样式中用到的字段来选择性的获取/不获取某些数据
    
91.          * @param  $parameter 用户对 getsetting() 给出的表单提交后的内容。
    
92.          * @return
    
93.          */
    
94.         function getdata($style, $parameter) {
    
95. 
    
96.                 // 返回summary
    
97.                 return array('html' => '这是一个演示模块数据类', 'data' => null);
    
98. 
    
99.                 // 返回数据
    
100.                 // 需要注意： 除 id，idtype， title， url， pic， picflag， summary 几个字段外，其它字段需要放到 fields 数组里。 可以参考系统内置模块类 source/class/block/block_thread.php
     
101.                 return array('html'=>'', 'data' => array(
     
102.                         array(
     
103.                                 'id' => '1',
     
104.                                 'idtype' => 'sampleid',
     
105.                                 'title' => 'title1',
     
106.                                 'url' => '#',
     
107.                                 'pic' => 'nophoto.gif',
     
108.                                 'picflag' => '1',
     
109.                                 'summary' => '',
     
110.                                 'fields' => array(
     
111.                                         'field1' => 'value1'
     
112.                                 )
     
113.                         )
     
114.                 ));
     
115.         }
     
116. 
     
117. }
     
118. 
     
119. ?>

复制代码

请自行编辑以上内容。以上是你最终要处理的事情了。  
然后在：后台——工具——更新缓存  只选择DIY模块分类缓存   然后 点更新  ..去前台看看。有无你亲爱的小模块。。

什么？？看不懂？？ sorry! 那不是本帖的内容，请去baidusearch 找PHP教程了。 end.

很不错的哦。

你是真强啊，没有困难制作困难也得要 {summary}，呵呵.... DZ有你而精彩~~~~~