Hướng dẫn viết module cho phiên bản NukeViet 3.0

Người đăng: vnoneit on Chủ Nhật, 3 tháng 4, 2011
1. Cấu trúc cơ bản khi bắt đầu viết module
Khác với những phiên bản trước đây của hệ thống nukeviet, trong phiên bản mới này việc đóng gói module được tối ưu, các file và folder của module đều được đưa vào trong 1 thư mục.
Một module example có cơ sở dữ liệu và có phần quản trị cho người dùng có cấu trúc căn bản như sau:
admin
—-.htaccess
—-main.php
modules
funcs
—-index.html
—-.htaccess
—-main.php
language
—-index.html
—-.htaccess
—-vi.php
—-vi_admin.php
js
—-.htaccess
—-javascript.js
action.php
admin.functions.php
functions.php
version.php
index.html
.htaccess
2. Cách viết một module đơn giản
Chú ý: Tên module mới chỉ gồm các chữ cái, số và dấu gạch ngang, bắt buộc phải bắt đầu bằng một chữ cái.
- Trong bài viết này chúng ta xây dựng một module đơn giản để xuất ra nội dung,:
Hello world!!!
- Các bước chuẩn bị:
Tạo các file và folder như sau:
$ modules/example/index.html
$ modules/example/funcs/main.php
$ modules/example/funcs/index.html
$ modules/example/admin.functions.php
$ modules/example/functions.php
$ modules/example/theme.php
$ modules/example/version.php
modules/example/functions.php
view source print?
1 <?php
2
3 if (!defined('NV_SYSTEM'))
4 die('Stop!!!');
5
6 define('NV_IS_MOD_EXAMPLE', true);
7 ?>
modules/example/version.php
view source print?
01 <?php
02
03 if ( ! defined( 'NV_ADMIN' ) or ! defined( 'NV_MAINFILE' )) die( 'Stop!!!' );
04
05 $module_version = array(
06 "name" => "Example", //
07 "modfuncs" => "main", // "is_sysmod" => 0, // "virtual" => 0, // "version" => "3.0.01", //
08 "date" => "2 Oct 2010 09:47:15 GMT", // "author" => "http://www.thegioimanguon.com", // "note" => ""
09 );
10
11 ?>
Các chú ý khi khai báo trong file version.php
- “modfuncs” => “main”, là danh sách các các function tương ứng với tên các file trong folder funcs của module.
- “virtual” => 0: Module không được ảo hóa
- “virtual”=>1: Module được ảo hóa. modules/example/funcs/main.php
view source print?
1 <?php
2
3 if ( ! defined( 'NV_IS_MOD_EXAMPLE' ) ) die( 'Stop!!!' );
4 $contents = "Hello world";
5 include ( NV_ROOTDIR . "/includes/header.php" );
6 echo nv_site_theme( $contents );
7 include ( NV_ROOTDIR . "/includes/footer.php" );
8 ?>
Sau khi thực hiện các bước như trên ta có được 1 module đơn giản, Để xem kết quả bạn đăng nhập vào khu vực quản trị với quyền admin, cài đặt và click hoạt module để có thể xem module qua link:
http://mydomain.com/index.php?lang=vi&nv=example
Nếu bạn muốn thêm 1 func mới cho module bạn tạo mới 1 file (new.php) trong thư mục:
modules/example/funcs/
Sau đó bạn cần đăng nhập và khu vực quản trị kích hoạt các function này.
3. Thêm link quản lý module vào menu quản trị
modules/example/admin/functions.php
view source print?
1 <?php
2
3 if (! defined('NV_ADMIN') or ! defined('NV_MAINFILE') or ! defined('NV_IS_MODADMIN')
4 )
5 die('Stop!!!');
6 $allow_func = array('main');
7 define( 'NV_IS_EXAMPLE_ADMIN', true );
8
9 ?>
modules/example/admin/main.php
view source print?
01 <?php
02
03 if ( ! defined( 'NV_IS_EXAMPLE_ADMIN' ) )
04 {
05 die( 'Stop!!!' );
06 }
07 $page_title = "main";
08 $contents = "test content";
09
10 include ( NV_ROOTDIR . "/includes/header.php" );
11 echo nv_admin_theme( $contents );
12 include ( NV_ROOTDIR . "/includes/footer.php" );
13 ?>
Để có thể quản trị module thì trong thư mục admin bắt buộc phải chứa file: main.php và trong thư mục
tương ứng với các file functions.php, version.php bắt buộc phải chứa file: admin.functions.php
Chú ý: Để các function có thể hoạt động được thì function phải được gán vào mảng $allow_func
Khi đó danh mục các file của module gồm:
$ modules/example/admin/index.html
$ modules/example/admin/functions.php
$ modules/example/admin/main.php
$ modules/example/index.html
$ modules/example/funcs/main.php
$ modules/example/funcs/index.html
$ modules/example/functions.php
$ modules/example/version.php
4. Thêm 1 submenu quản lý module trong admin
Thay đổi lại file modules/example/admin.functions.php
view source print?
01 <?php
02
03 if ( ! defined( 'NV_ADMIN' ) or ! defined( 'NV_MAINFILE' ) or ! defined( 'NV_IS_MODA DMIN' ) ) die( 'Stop!!!' );
04 $allow_func = array('main');
05 $submenu['add'] = "add";
06 $submenu['edit'] = "edit";
07 $allow_func = array('main', 'add', 'edit');
08
09 define( 'NV_IS_EXAMPLE_ADMIN', true );
10
11 ?>
5. Kết nối với file ngôn ngữ
Sửa lại nội dung file modules/example/admin.functions.php
view source print?
01 <?php
02
03 if ( ! defined( 'NV_ADMIN' ) or ! defined( 'NV_MAINFILE' ) or ! defined( 'NV_IS_MODA DMIN' ) ) die( 'Stop!!!' );
04 $allow_func = array('main');
05 $submenu['add'] = $lang_module['example_add'];
06 $submenu['edit'] = $lang_module['example_edit'];
07 $allow_func = array('main', 'add', 'edit');
08
09 define( 'NV_IS_EXAMPLE_ADMIN', true );
10
11 ?>
Quy tắc đặt tên file ngôn ngữ: Các file ngôn ngữ được đặt trong thư mục language của module, Nếu ngôn ngữ cho module sẽ đặt tên: vi.php, en.php, ngôn ngữ cho admin admin_vi.php, admin_en.php
Ta tạo file ngôn ngữ tiếng Việt cho module example:
modules/example/language/ admin_vi.php
view source print?
01 <?php
02
03 if (! defined('NV_ADMIN') or ! defined('NV_MAINFILE')){
04 die('Stop!!!');
05 }
06
07 $lang_translator['author'] ="http://www.thegioimanguon.com";
08 $lang_translator['createdate'] ="04/03/2010, 15:22";
09 $lang_translator['copyright'] ="";
10 $lang_translator['info'] ="";
11 $lang_translator['langtype'] ="lang_module";
12
13 $lang_module['example_add']= "Thêm";
14 $lang_module['example_edit']= "Sửa";
15
16 ?>
Khi đó danh mục các file của module gồm:
$ modules/example/admin/index.html
$ modules/example/admin/main.php
$ modules/example/index.html
$ modules/example/funcs/main.php
$ modules/example/funcs/index.html
$ modules/example/admin.functions.php
$ modules/example/functions.php
$ modules/example/theme.php
$ modules/example/version.php
$ modules/example/language/vi_admin.php
$ modules/example/language/en_admin.php
6. Kết nối với cơ sở dữ liệu
modules/example/action.php
view source print?
01 <?php
02
03 if ( ! defined( 'NV_IS_FILE_MODULES' ) ) die( 'Stop!!!' );
04
05 $sql_drop_module = array();
06
07 $sql_drop_module[] = "DROP TABLE IF EXISTS " . $db_config['prefix'] . "_" .$lang . "_" . $module_data . "`;";
08
09 $sql_create_module = $sql_drop_module;
10
11 $sql_create_module[] = "CREATE TABLE " . $db_config['prefix'] . "_" . $lang . "_" . $module_data . "` (
12 `id` mediumint(8) unsigned NOT NULL AUTO_INCREMENT,
13 `title` varchar(255) NOT NULL, PRIMARY KEY (`id`)
14 ) ENGINE=MyISAM DEFAULT CHARSET=utf8";
15 ?>
Sau khi tạo xong file action.php, bạn vào phần quản lý module để cài lại module example. Khi đó cơ
sở dữ liệu sẽ được tạo tự động.
Sửa lại file modules/example/admin/add.php
view source print?
01 <?php
02
03 if ( ! defined( 'NV_IS_EXAMPLE_ADMIN' ) )
04 {
05 die( 'Stop!!!' );
06 }
07 $page_title = $lang_module['example_add'];
08 $add = 0;
09 $error = "";
10
11 if ( $nv_Request->get_int( 'add', 'post' ) == 1 )
12 {
13 $title = filter_text_input( 'title', 'post', '', 1 );
14 if ( empty( $title ) )
15 {
16 $error = $lang_module['err_title'];
17 }
18 else
19 {
20
21 $query = "INSERT INTO `" . NV_PREFIXLANG . "_" . $module_data . "` (`id`, `title`) VALUES (NULL, " . $db->dbescape( $title ) . ")";
22 if ( $db->sql_query_insert_id( $query ) )
23 {
24 $db->sql_freeresult();
25 Header( "Location: " . NV_BASE_ADMINURL . "index.php?" . NV_NAME_VARIABL E . "=" . $module_name . "" );
26 die();
27
28 }
29 else
30 {
31
32 }
33 }
34 }
35
36 $error = $lang_module['errorsave'];
37
38 if ( $error != "" )
39 {
40 $contents .= "<div class=\"quote\" style=\"width:780px;\">\n";
41 $contents .= "<blockquote class=\"error\"><span>" . $error . "</span></blockquote>\n";
42 $contents .= "</div>\n";
43 $contents .= "<div class=\"clear\"></div>\n";
44 }
45 $contents .= "<form action=\"" . NV_BASE_ADMINURL . "index.php\" method=\"POST\">\n";
46 $contents .= "<table class=\"tab1\">\n";
47 $contents .= "  <tr>\n";
48 $contents .= "  <td width=\"30%\"><strong>" . $lang_module['title'] . "<strong></td>\n";
49 $contents .= "  <td>\n";
50 $contents .= "  <input type=\"text\" name=\"title\" size=\"100\">\n";
51 $contents .= "  </td>\n";
52 $contents .= "  </tr>\n";
53 $contents .= "</table>\n";
54 $contents .= "<table class=\"tab2\" align=\"center\">\n";
55 $contents .= "  <tr>\n";
56 $contents .= "  <td style=\"text-align:center;\">\n";
57 $contents .= "  <input type=\"submit\" value=\"" . $lang_module['save'] . "\"/>\n";
58 $contents .= "  <input name=\"add\" type=\"hidden\" value=\"1\" />\n";
59 $contents .= "  <input type=\"hidden\" name =\"" . NV_NAME_VARIABLE . "\"value=\"" . $module_name . "\" />";
60 $contents .= "  <input type=\"hidden\" name =\"" . NV_OP_VARIABLE . "\ "value=\"" . $op . "\" />";
61 $contents .= "  </td>\n";
62 $contents .= "  </tr>\n";
63 $contents .= "</table>\n";
64 $contents .= "</form>\n";
65
66 include ( NV_ROOTDIR . "/includes/header.php" );
67 echo nv_admin_theme( $contents );
68 include ( NV_ROOTDIR . "/includes/footer.php" );
69
70 ?>
Sửa lại file modules/example/language/vi_admin.php
view source print?
01 <?php
02
03 if (! defined('NV_ADMIN') or ! defined('NV_MAINFILE')){
04 die('Stop!!!');
05 }
06
07 $lang_translator['author'] ="http://www.thegioimanguon.com";
08 $lang_translator['createdate'] ="04/03/2010, 15:22";
09 $lang_translator['copyright'] ="";
10 $lang_translator['info'] ="";
11 $lang_translator['langtype'] ="lang_module";
12
13 $lang_module['list']= "Danh sách bài viết";
14 $lang_module['example_add']= "Thêm mới bài viết";
15 $lang_module['example_edit']= "Sửa bài viết";
16 $lang_module['example_del']= "Xóa bài viết";
17 $lang_module['id']= "ID";
18 $lang_module['title']= "Tiêu đề";
19 $lang_module['func']= "Chức năng";
20 $lang_module['save'] = "Lưu";
21 $lang_module['err_title'] = "Bạn phải nhập tên";
22 $lang_module['errorsave'] = "Vì một số lý do nào đó mà tên không được lưu vào cơ sở dữ liệu";
23
24 ?>
Sửa lại file modules/example/admin/main.php
view source print?
01 <?php
02
03 if ( ! defined( 'NV_IS_EXAMPLE_ADMIN' ) ) {
04 die( 'Stop!!!' );
05 }
06 $page_title = $lang_module['list'];
07
08 $contents = "";
09 $contents .= "<table class=\"tab1\">\n";
10 $contents .= "<thead>";
11 $contents .= "<tr style=\"text-align:center;\">\n";
12 $contents .= "<td>" . $lang_module['id'] . "</td>\n";
13 $contents .= "<td>" . $lang_module['title'] . "</td>\n";
14 $contents .= "<td>" . $lang_module['func'] . "</td>\n";
15 $contents .= "</tr>\n";
16 $a = 0;
17 $sql = "SELECT id, title FROM `" . NV_PREFIXLANG . "_" . $module_data . "`";
18 $resuilt = $db->sql_query( $sql );
19 while ( $row = $db->sql_fetchrow( $resuilt ) )
20 {
21 $class = ( $a % 2 == 0 ) ? "" : " class=\"second\"";
22 $contents .= "<tbody" . $class . ">";
23 $contents .= "<tr>\n";
24 $contents .= "<td style=\"text-align:center;\">" . $row['id'] . "</td>\n";
25 $contents .= "<td>" . $row['title'] . "</td>\n";
26 $contents .= "<td style=\"text-align:center;\">
27 <a href=\"index.php?" . NV_NAME_VARIABLE . "=" . $module_name . "&" . NV_OP_ VARIABLE . "=edit&amp;id=" . $row['id'] . "\">" . $lang_module['example_edit'] . "</ a> -
28 <a href=\"index.php?" . NV_NAME_VARIABLE . "=" . $module_name . "&" . NV_OP_VARIABLE . "=del&amp;id=" . $row['id'] . "\">" . $lang_module['example_del'] . "</a>
29 </td>\n";
30 $contents .= "</tr>\n";
31 $contents .= "</tbody>\n";
32 $a++;
33 }
34 $contents .= "</table>\n";
35 include ( NV_ROOTDIR . "/includes/header.php" );
36 echo nv_admin_theme( $contents );
37 include ( NV_ROOTDIR . "/includes/footer.php" );
38 ?>
Sửa lại file modules/example/funcs/main.php
view source print?
01 <?php
02
03 if ( ! defined( 'NV_IS_MOD_EXAMPLE' ) ) die( 'Stop!!!' );
04 $sql = "SELECT `id`, `title` FROM `" . NV_PREFIXLANG . "_" . $module_data . "`";
05 $result = $db->sql_query( $sql );
06 $contents = "<table>\n";
07 $a = 1;
08 while ( $row = $db->sql_fetchrow( $result ) )
09 {
10 $contents .= "<tr>\n";
11 $contents .= "<td>" . $a . "</td><td>" . $row['title'] . "</td></tr>\n";
12 $contents .= "</tr>\n";
13 $a ++;
14 }
15 $contents .= "</table>\n";
16 include ( NV_ROOTDIR . "/includes/header.php" );
17 echo nv_site_theme( $contents );
18 include ( NV_ROOTDIR . "/includes/footer.php" );
19 ?>
Danh mục các file:
$ modules/example/admin/index.html
$ modules/example/admin/main.php
$ modules/example/index.html
$ modules/example/funcs/main.php
$ modules/example/funcs/index.html
$ modules/example/admin.functions.php
$ modules/example/functions.php
$ modules/example/action.php
$ modules/example/language/vi_admin.php
$ modules/example/language/en_admin.php
7. Kết nối với template engine (Xtemplate)
Bắt đầu từ phiên bản nukeviet 3.0, hệ thống template được tách biệt hẳn ra với mã php. Hiện tại, hệ thống template của nukeviet đang sử dụng Xtemplate để xử lý cho việc tách biệt mã php và html. Để tìm hiểu thêm về cách viết Xtemplate, các bạn có thể đọc thêm tài liệu về tại địa chỉ: http://sourceforge.net/projects/xtpl/files/XTemplate%20PHP5/
Sơ đồ template admin control panel sử dụng Xtemplate
themes
—-admin_default
css
—-example.css
images
js
modules
—-example.php
tpl
—-example.tpl
Để sử dụng Xtemplate cho admin control panel của module Example ta tiến hành các bước như sau:
Sửa lại file modules/example/admin/main.php
view source print?
01 <?php
02
03 if ( ! defined( 'NV_IS_EXAMPLE_ADMIN' ) ) {
04 die( 'Stop!!!' );
05 }
06 $page_title = $lang_module['list'];
07 $sql = "SELECT id, title FROM `" . NV_PREFIXLANG . "_" . $module_data . "`";
08 $resuilt = $db->sql_query( $sql );
09 while ( $row = $db->sql_fetchrow( $resuilt ) )
10 {
11 $content[] = $row;
12 }
13 $contents = call_user_func("main", $content); include ( NV_ROOTDIR . "/includes/header.php" ); echo nv_admin_theme( $contents );
14 include ( NV_ROOTDIR . "/includes/footer.php" );
15 ?>
Sửa lại file modules/example/admin/add.php
view source print?
01 <?php
02
03 if ( ! defined( 'NV_IS_EXAMPLE_ADMIN' ) )
04 {
05 die( 'Stop!!!' );
06 }
07 $page_title = $lang_module['example_add'];
08 $add = 0;
09 $error = "";
10
11 if ( $nv_Request->get_int( 'add', 'post' ) == 1 )
12 {
13 $title = filter_text_input( 'title', 'post', '', 1 );
14 if ( empty( $title ) )
15 {
16
17 }
18 else
19 {
20
21 $error = $lang_module['err_title'];
22
23 $query = "INSERT INTO `" . NV_PREFIXLANG . "_" . $module_data . "` (`id`,`title`) VALUES (NULL, " . $db->dbescape( $title ) . ")";
24 if ( $db->sql_query_insert_id( $query ) )
25 {
26 $db->sql_freeresult();
27 Header( "Location: " . NV_BASE_ADMINURL . "index.php?" .
28 NV_NAME_VARIABLE . "=" . $module_name . "" );
29 die();
30
31 }
32 else
33 {
34
35 }
36 }
37 }
38
39 $error = $lang_module['errorsave'];
40 $contents = call_user_func("add", $error); include ( NV_ROOTDIR . "/includes/header.php" ); echo nv_admin_theme( $contents );
41 include ( NV_ROOTDIR . "/includes/footer.php" );
42
43 ?>
Sửa lại file modules/example/admin/edit.php
view source print?
01 <?php
02
03 if ( ! defined( 'NV_IS_EXAMPLE_ADMIN' ) )
04 {
05 die( 'Stop!!!' );
06 }
07
08 $error = "";
09 $page_title = $lang_module['example_edit'];
10
11 $id = $nv_Request->get_int( 'id', 'get,post', 0 );
12 if ( $id > 0 )
13 {
14 if ( $nv_Request->get_int( 'save', 'post' ) == 1 )
15 {
16 $title = filter_text_input( 'title', 'post', '', 1 );
17 if ( empty( $title ) )
18 {
19
20 }
21 else
22 {
23
24 $error = $lang_module['err_title'];
25
26 $query = "UPDATE `" . NV_PREFIXLANG . "_" . $module_data . "` SET `title` = " . $db->dbescape( $title ) . " WHERE `id` =" . $id . "";
27 $db->sql_query( $query );
28 $db->sql_freeresult();
29 Header( "Location: " . NV_BASE_ADMINURL . "index.php?" . NV_NAME_VARIABLE . "=" . $module_name . "" );
30 }
31
32 }
33 else
34 {
35
36 $sql = "SELECT title FROM `" . NV_PREFIXLANG . "_" . $module_data . "` WHERE `id` = '" . $id . "'";
37 $resuilt = $db->sql_query( $sql );
38 list( $title ) = $db->sql_fetchrow( $resuilt );
39 }
40 $contents = call_user_func("edit",$id, $title, $error);
41 }
42 include ( NV_ROOTDIR . "/includes/header.php" );
43 echo nv_admin_theme( $contents );
44 include ( NV_ROOTDIR . "/includes/footer.php" );
45
46 ?>
Thêm file themes/admin_default/modules/example.php. Lưu ý: Tên file trong thư mục module của
template admin phải trùng tên với tên module.
view source print?
01 <?php
02 function add($error)
03 {
04 global $global_config, $lang_module,$module_data, $db_config, $nv_Request,
05 $module_name, $op;
06 $xtpl = new XTemplate ( "example.tpl", NV_ROOTDIR . "/themes/" .
07 $global_config ['module_theme'] . "/modules" );
08 $xtpl->assign('LANG',$lang_module);
09 $xtpl->assign('NV_BASE_ADMINURL',NV_BASE_ADMINURL);
10 $xtpl->assign('NV_NAME_VARIABLE',NV_NAME_VARIABLE);
11 $xtpl->assign('MODULE_NAME', $module_name);
12 $xtpl->assign('OP', $op);
13 if(!empty($error))
14 {
15 $xtpl->assign('ERROR',$error);
16 $xtpl->parse('add.error');
17 }
18 $xtpl->assign('NV_OP_VARIABLE',NV_OP_VARIABLE);
19 $xtpl->parse('add');
20 return $xtpl->text('add');
21 }
22 function edit( $id, $title, $error)
23 {
24 global $global_config, $lang_module,$module_data, $db_config, $nv_Request,
25 $module_name, $op;
26 $xtpl = new XTemplate ( "example.tpl", NV_ROOTDIR . "/themes/" .
27 $global_config ['module_theme'] . "/modules" );
28 $xtpl->assign('LANG',$lang_module);
29 $xtpl->assign('NV_BASE_ADMINURL',NV_BASE_ADMINURL);
30 $xtpl->assign('NV_NAME_VARIABLE',NV_NAME_VARIABLE);
31 $xtpl->assign('MODULE_NAME', $module_name);
32 $xtpl->assign('TITLE', $title);
33 $xtpl->assign('ID', $id);
34 $xtpl->assign('OP', $op);
35 if(!empty($error))
36 {
37 $xtpl->assign('ERROR',$error);
38 $xtpl->parse('edit.error');
39 }
40 $xtpl->assign('NV_OP_VARIABLE',NV_OP_VARIABLE);
41 $xtpl->parse('edit');
42 return $xtpl->text('edit');
43 }
44 function main($content)
45 {
46 global $global_config, $lang_module,$module_data, $db_config, $nv_Request,
47 $module_name, $op;
48 $xtpl = new XTemplate ( "example.tpl", NV_ROOTDIR . "/themes/" .
49 $global_config ['module_theme'] . "/modules" );
50 $xtpl->assign('LANG',$lang_module);
51 if(!empty($content))
52 {
53 foreach($content as $i => $row)
54 {
55 $xtpl->assign('CLASS',($i % 2)   ? '' : ' class="second"');
56 $xtpl->assign('EDIT',"<a href=\"index.php?" . NV_NAME_VARIABLE . "=" .
57 $module_name . "&" . NV_OP_VARIABLE . "=edit&amp;id=" . $row['id'] . "\">" .
58 $lang_module['example_edit'] . "</a>");
59 $xtpl->assign('DEL',"<a href=\"index.php?" . NV_NAME_VARIABLE . "=" .
60 $module_name . "&" . NV_OP_VARIABLE . "=del&amp;id=" . $row['id'] . "\">" .
61 $lang_module['example_del'] . "</a>");
62 $xtpl->assign('CONTENT', $row);
63 $xtpl->parse('main.loop');
64 }
65 }
66 $xtpl->parse('main');
67 return $xtpl->text('main');
68 }
69 ?>
Thêm file themes/admin_default/modules/example.tpl
view source print?
01 <!-- BEGIN: add -->
02 <form action="{NV_BASE_ADMINURL}index.php" method="POST">
03 <table class="tab1">
04 <tr>
05 <td width="30%"><strong>{LANG.title}</strong></td>
06 <td><input name="title" type="text" size="100" /></td>
07 </tr>
08 </table>
09 <table class="tab2" align="center">
10 <tr>
11 <td style="text-align:center;">
12 <input type="submit" value="{LANG.save} "/>
13 <input name="add" type="hidden" value="1" />
14 <input type="hidden" name =" {NV_NAME_VARIABLE} "value="
15 {MODULE_NAME} " />
16 </tr>
17 </td>
18 <input type="hidden" name =" {NV_OP_VARIABLE} "value=" {OP} " />
19 </table>
20 </form>
21 <!-- BEGIN: error -->
22 <div class="quote" style="width:780px;">
23 <blockquote class="error"><span>{ERROR}</span></blockquote>
24 </div>
25 <div class="clear"></div>
26 <!-- END: error -->
27 <!-- END: add -->
28 <!-- BEGIN: edit -->
29 <form action="{NV_BASE_ADMINURL}index.php" method="POST">
30 <table class="tab1">
31 <tr>
32 <td width="30%"><strong>{LANG.title}</strong></td>
33 <td><input name="title" type="text" size="100" value="{TITLE}" /></td>
34 </tr>
35 </table>
36 <table class="tab2" align="center">
37 <tr>
38 <td style="text-align:center;">
39 <input type="submit" value="{LANG.save} "/>
40 <input name="add" type="hidden" value="1" />
41 <input type="hidden" name =" {NV_NAME_VARIABLE} "value="
42 {MODULE_NAME} " />
43 <input type="hidden" name ="id" value="{ID}" />
44 <input type="hidden" name =" {NV_OP_VARIABLE} "value=" {OP} " />
45 </tr>
46 </td>
47 </table>
48 </form>
49 <!-- BEGIN: error -->
50 <div class="quote" style="width:780px;">
51 <blockquote class="error"><span>{ERROR}</span></blockquote>
52 </div>
53 <div class="clear"></div>
54 <!-- END: error -->
55 <!-- END: edit -->
56 <!-- BEGIN: main -->
57 <table class="tab1">
58 <thead>
59 <tr style="text-align:center;">
60 <td>{LANG.id}</td>
61 <td>{LANG.title}</td>
62 <td>{LANG.func}</td>
63 </tr>
64 <!-- BEGIN: loop -->
65 <tbody{CLASS}>
66 <tr>
67 <td style="text-align:center;">{CONTENT.id}</td>
68 <td>{CONTENT.title}</td>
69 <td style="text-align:center;">
70 {EDIT} - {DEL}
71 </td>
72 </td>
73 </tbody>
74 <!-- END: loop -->
75 </table>
76 <!-- END: main -->
Danh sách các file:
$ modules/example/admin/index.html
$ modules/example/admin/main.php
$ modules/example/index.html
$ modules/example/funcs/main.php
$ modules/example/funcs/index.html
$ modules/example/admin.functions.php
$ modules/example/functions.php
$ modules/example/action.php
$ modules/example/language/vi_admin.php
$ modules/example/language/en_admin.php
$ themes/admin_default/modules/example.php
$ themes/admin_default/modules/example.tpl
Sơ đồ cấu trúc template sử dụng Xtemplate
themes
—-default
css
—-example.css
images
js
modules
—-example.php
tpl
—-example.tpl
Sửa lại file modules/example/funcs/main.php
view source print?
01 <?php
02
03 if ( ! defined( 'NV_IS_MOD_EXAMPLE' ) ) die( 'Stop!!!' );
04 $sql = "SELECT `id`, `title` FROM `" . NV_PREFIXLANG . "_" . $module_data . "`";
05 $resuilt = $db->sql_query( $sql );
06 while ( $row = $db->sql_fetchrow( $resuilt ) )
07 {
08 $content[] = $row;
09 }
10 $contents = call_user_func( "main_theme", $content );
11 include ( NV_ROOTDIR . "/includes/header.php" );
12 echo nv_site_theme( $contents );
13 include ( NV_ROOTDIR . "/includes/footer.php" );
14 ?>
Thêm mới file modules/example/theme.php với nội dung như sau:
Chú ý:Tên của file trong thư mục modules của template phải trùng với tên của module.
view source print?
01 <?php
02
03 function main_theme($content)
04 {
05 global $module_file, $global_config;
06 $xtpl = new XTemplate("example.xtpl", NV_ROOTDIR . "/themes/" . $module_info['template'] . "/modules/" . $module_file );
07 $a = 1;
08 foreach($content as $content_i)
09 {
10 $xtpl->assign('CONTENT',$content_i);
11 $xtpl->assign('STT',$a);
12 $xtpl->parse('main.loop');
13 $a++;
14 }
15 $xtpl->parse('main');
16 return $xtpl->text('main');
17 }
18
19 ?>
Thêm mới file themes/default/modules/example/example.xtpl
view source print?
01 <!-- BEGIN: main -->
02 <table>
03 <!-- BEGIN: loop -->
04 <tr>
05 <td>{STT}</td>
06 <td>{CONTENT.title}</td>
07 </tr>
08 <!-- END: loop -->
09 </table>
10 <!-- END: main -->
Nếu bạn cần tạo ngôn ngữ cho ngoài site bạn có thể tạo thêm các file: vi.php, en.php trong thư
mục language của module
Khi đó danh mục các file của module gồm:
$ modules/example/admin/index.html
$ modules/example/admin/main.php
$ modules/example/index.html
$ modules/example/funcs/main.php
$ modules/example/funcs/index.html
$ modules/example/admin.functions.php
$ modules/example/functions.php
$ modules/example/theme.php
$ modules/example/action.php
$ modules/example/version.php
$ modules/example/language/vi.php
$ modules/example/language/vi_admin.php
$ modules/example/language/en.php
$ modules/example/language/en_admin.php
$ themes/default/modules/example.php
$ themes/default/modules/example/example.xtpl
$ themes/admin_default/modules/example.php
$ themes/admin_default/modules/example.tpl
Các chú ý khi lập trình
1) Encoding
Encoding mặc định tất cả các file là: ansi, các file lang như tiếng việt, pháp, nga .. Encoding cần chuyển sang utf-8
2) Trigger_error
thay vì dùng die(“…”) báo lỗi và dừng chương trình; cần dùng dùng trigger_error(“…”, 256);
để ghi lại lỗi đó và thông báo lỗi.
3) Chế độ thông báo lỗi
Để thay đổi chế độ thông báo lỗi của php cần sửa file includes /constants.php
view source print?
1 //define( "NV_DISPLAY_ERRORS_LIST", E_ALL | E_STRICT ); //Danh sach cac loi se hien thi
2 define( "NV_DISPLAY_ERRORS_LIST", E_ALL );
3 //define( "NV_DISPLAY_ERRORS_LIST", 0); //tat thong bao loi
4 define( "NV_LOG_ERRORS_LIST", E_ALL | E_STRICT ); //Danh sach cac loi se ghi l og
5 define( "NV_SEND_ERRORS_LIST", E_USER_ERROR ); //Danh sach cac loi se gui den email
VD: để tắt thông báo lỗi ta cần sửa đoạn trên thành
view source print?
1 //define( "NV_DISPLAY_ERRORS_LIST", E_ALL | E_STRICT ); //Danh sach cac loi se hien thi
2 //define( "NV_DISPLAY_ERRORS_LIST", E_ALL );
3 define( "NV_DISPLAY_ERRORS_LIST", 0); //tat thong bao loi
4 define( "NV_LOG_ERRORS_LIST", E_ALL | E_STRICT ); //Danh sach cac loi se ghi log
5 define( "NV_SEND_ERRORS_LIST", E_USER_ERROR ); //Danh sach cac loi se gui den email
Nhung cai trang nao ko cho phep truy cap truc tiep neu khong co referer can phai co dong nay
view source print?
1 if ( ! defined( 'NV_IS_AJAX' ) ) die( 'Wrong URL' );
4) Lấy giá trị của biến khi submit form
class request còn có thể lấy theo các phương thức: get_bool, get_string, get_int, get_float, get_array, Trong phương thức get_string nếu lấy qua phương thức get, giá trị của biến đã được lọc mã html
Lấy biến dụng số nguyên
view source print?
01 <?php
02
03 $id = $nv_Request->get_int( 'id', 'post' );
04 // Lấy giá trị của 'id' qua phương thức post, nếu không có giá trị bằng 0
05
06 $default = 10;
07 $id = $nv_Request->get_int( 'id', 'get', $default);
08 // Lấy giá trị của 'id' qua phương thức get, nếu không có giá trị bằng 10
09
10 $default = 10;
11 $id = $nv_Request->get_int( 'id', 'post,get', $default);
12 // Lấy giá trị của 'id' qua phương thức post, hoặc get ưu tiên lấy post trước,nếu không có giá trị bằng 10
13
14 ?>
Lấy biến dụng số thực
view source print?
01 <?php
02
03 $id = $nv_Request->get_float( 'id', 'post' );
04 // Lấy giá trị của input_name qua phương thức post, nếu không có giá trị bằng 0
05
06 $default = 10.5;
07 $id = $nv_Request->get_float( 'id', 'get', $default);
08 // Lấy giá trị của input_name qua phương thức get, nếu không có giá trị bằng 10.5
09
10 $default = 10.5;
11 $id = $nv_Request->get_float( 'id', 'post,get', $default);
12 // Lấy giá trị của input_name qua phương thức post, hoặc get ưu tiên lấy posttrước, nếu không có giá trị bằng 10.5
13
14 ?>
Sử dụng hàm: filter_text_input
view source print?
01 <?php
02
03 $value = filter_text_input( 'input_name', 'post', '' );
04 // Lấy giá trị của input_name qua phương thức post, nếu không có giá trị bằng rỗng
05
06 $value = filter_text_input( 'input_name', 'post,get', "", 1);
07 // Lấy giá trị của input_name qua phương thức post hoặc get, nếu không có giá trị bằng rỗng
08 // Giá trị của biến sẽ được gọi qua hàm nv_htmlspecialchars để thay thế các mã html đặc biệt
09
10 $value = filter_text_input( 'input_name', 'post,get', "", 1, 255);
11 // Lấy giá trị của input_name qua phương thức post hoặc get, nếu không có giá trị bằng rỗng
12 // Giá trị của biến sẽ được gọi qua hàm nv_htmlspecialchars để thay thế các mã html đặc biệt
13 // Giá trị của biến lấy 255 ký tự đầu tiên, nếu giá trị nhiều hơn 255 ký tự th ì các ký tự sau 255 sẽ bị cắt đi
14
15 $default = "default";
16 $preg_replace = array( 'pattern' => "/[^a-zA-Z0-9]/", 'replacement' => "_");
17 $value = filter_text_input( 'input_name', 'request', $default, 0, 100, $preg_replace );
18
19 // Lấy giá trị của input_name qua phương thức request, nếu không có giá trị bằng default
20 // Giá trị của biến lấy 100 ký tự đầu tiên, nếu giá trị nhiều hơn 100 ký tự th ì các ký tự sau 100 sẽ bị cắt đi
21 // Giá trị của biến sẽ thay thế các kỹ tự khác a-zA-Z0-9 bằng ký tự gạch dưới
22
23 ?>
Sử dụng hàm: filter_text_textarea
khi 1 form có textarea, chỉ dùng phương thức post, chứ không dùng phương thức get, nếu không sẽ bị mất dữ liệu
sử dụng filter_text_textarea cho các editor
view source print?
01 <?php
02
03 $content = filter_text_textarea( 'content', '', NV_ALLOWED_HTML_TAGS );
04 // dung de lay data tu textarea.
05 //Chì chỉ các tags được liệt kê trong NV_ALLOWED_HTML_TAGS mới được sử dụng, các mã khác sẽ bị lọc bỏ
06 $content = nv_editor_nl2br( $content );// dung de save vào CSDL
07
08 $content = nv_editor_br2nl( $row['content'] ); // dung de lay data tu CSDL
09 $content = nv_htmlspecialchars( $content ); // dung de dua vao editor
10
11 $content = filter_text_textarea( 'content', ''); //sẽ không lọc các tags html
12
13 ?>
sử dụng filter_text_textarea cho các textarea không sử dụng editor

01 <?php
02
03 $content = filter_text_textarea( 'content', '', NV_ALLOWED_HTML_TAGS );
04 // dung de lay data tu textarea.
05 //Chì chỉ các tags được liệt kê trong NV_ALLOWED_HTML_TAGS mới được sử dụng, các mã khác sẽ bị lọc bỏ
06
07 $content = nv_nl2br( $content, '<br />' );// dung de save vao csdl
08
09 $content = nv_br2nl( $row['content'] ); // dung de lay data tu CSDL
10 $content = nv_htmlspecialchars( $content ); // dung de dua vao textarea
11
12 $content = filter_text_textarea( 'content', ''); //sẽ không lọc các tags html
13
14 ?>
Share | Share in Google Buzz

0 nhận xét:

Đăng nhận xét