狠狠撸

Cách t?o m?t module ??n gi?n trên phpfox
? bài vi?t này, t?i s? trình bày m?t cách chi ti?t các b??c x?y d?ng m?t module ??n gi?n trên c?ng c?
phpfox. Chúng ta s? ti?p c?n b?ng cách th?c hi?n m?t ví d? c? th?, các b?n có th? áp d?ng nh?ng chi ti?t
trong ví d? này ?? áp d?ng cho nh?ng project c?a các b?n.
?? bài: Vi?t m?t module trên phpfox t?o m?t user và insert th?ng tin user ?ó vào c? s? d? li?u, ??ng th?i
hi?n th? th?ng tin user v?a t?o trên m?t menu ? AdminCP.

Cách th?c hi?n:
Phiên b?n s? d?ng: phpfox 3.5.1
B?n có th? download phpfox t?i ??y.
H??ng d?n cài ??t phpfox b?n có th? tham kh?o ? ??y.

Create a new product
??u tiên b?n s? t?o m?t product m?i (n?i ch?a module c?a b?n). Tuy nhiên, ??y ch? là b??c tùy ch?n vì
b?n có th? ??t module c?a mình vào m?t product b?t kì có s?n trên phpfox. M?c dù v?y, vi?c s? d?ng m?t
product riêng c?a b?n th?n s? giúp b?n có th? tùy bi?n d? dàng nh?ng ch?c n?ng trong nó. Các b??c ??
t?o m?t product m?i nh? sau:
??ng nh?p v?i tài kho?n AdminCP và truy nh?p ???ng d?n sau:
Extensions >> Product >> Create New Product
?i?n ??y ?? các th?ng tin vào form và click nút submit:

D??i ??y t?i s? gi?i thích chi ti?t th?ng tin c?a t?ng tr??ng:

?
?
?
?
?
?
?

Product ID: giá tr? ID duy nh?t c?a product. Nó có th? là kí t? s?, ch? cái và d?u g?ch d??i (_), và
lu?n ? d?ng ch? cái th??ng. ? ??y t?i s? ch?n là create_user.
Title: tiêu ?? c?a product, th? mà s? hi?n th? trong danh sách các product. ? ??y t?i s? ch?n là
Create new user.
Description: m? t? ng?n v? product. ? ??y t?i s? ch?n là Create a new user manually.
Version: phiên b?n hi?n t?i c?a product. Do t?i m?i t?o product này nên t?i s? ch?n là 1.0.
Product URL: URL c?a website c?a b?n, ? ??y t?i s? d?ng localhost nên s? ?i?n là: localhost.
Version Check URL: URL ?? phpfox ki?m tra phiên b?n release c?a product. ? ??y t?i ?i?n là
localhost/version.php.
Active: thi?t l?p tr?ng thái c?a product là active ho?c inactive. Ch?n Yes.

Create new module in AdminCP
??ng nh?p vào AdminCP và vào theo ???ng d?n:
Extension >> Module >> Create New Module
Ti?p theo chúng ta s? ?i?n ??y ?? vào form d??i ??y và click nút submit:

Chi ti?t th?ng tin c?a t?ng tr??ng:
?
?
?
?

Product: tên c?a product ch?a module c?a b?n. ? ??y t?i s? chon là Create new user.
Module ID: id c?a module. ? ??y t?i ch?n là createuser.
Add to Menu: ch?n Yes ?? module c?a b?n xu?t hi?n trong Module menu.
Sub Menu: Khi b?n ch?n Yes ? ph?n Add to Menu, b?n s? b?t bu?c ph?i ?i?n th?ng tin ? m?c Sub
Menu này. ? ??y chúng ta s? ??nh ngh?a tên c?a các sub menu và URL t??ng ?ng. T?i s? t?o 2 sub
menu: Show info ?? hi?n th? th?ng tin ng??i dùng, v?i link createuser ???c hi?u là ???ng d?n
http://localhost/phpFox-3.5.1/upload/index.php?do=/admincp/createuser/; Add new t?o form
?? ?i?n th?ng tin ng??i dùng và insert th?ng tin ?ó vào c? s? d? li?u, v?i link createuser.add ??i

?

di?n
cho
???ng
d?n
http://localhost/phpFox3.5.1/upload/index.php?do=/admincp/createuser/add/.
Info: M? t? ng?n v? module. ? ??y t?i ch?n là Admin can create a new user manually!.

Build file structure
D?n ??n folder /module/ trên server c?a b?n n?i ch?a file cài ??t c?a phpfox. T?o m?t folder m?i v?i tên
c?a module mà b?n v?a t?o, c?a t?i là createuser. Bên trong folder m?i b?n s? t?o theo c?u trúc sau:
/include/
/include/component/
/include/component/ajax/
/include/component/block/
/include/component/controller/
/include/component/controller/admincp
/include/plugin/
/include/service/
/static/
/static/css/default/default/
/static/image/
/static/jscript/
/template/
/template/default/
/template/default/block/
/template/default/controller/
/template/default/controller/admincp
Chú ? r?ng ??y là c?u trúc file d?ng ??y ?? c?a m?t module, vì v?y tùy vào m?c ?ích c?a b?n mà b?n có
th? ch? c?n t?o m?t s? th? m?c c?n thi?t.

Create a controller
Controller là nh?ng file php ?i?u khi?n t?t c? các page c?a phpfox. ??u tiên h?y t?o m?t php class file cho
controller c?a chúng ta:
/module/createuser/include/component/controller/admincp/index.class.ph
p
N?i dung c?a file index.class.php nh? sau:
index.class.php
<?php
class Createuser_Component_Controller_Admincp_Index extends Phpfox_Component
{
public function process() {
}
}

?>

Ti?p theo chúng ta s? t?o m?t file HTML cho controller v?a t?o c?a chúng ta:
modulecreateusertemplatedefaultcontrolleradmincpindex.html.php
Trong file index.html.php, b?n có th? thêm dòng sau ?? ki?m tra tính k?t n?i gi?a file controller và html
mà b?n v?a t?o.
index.html.php
Helloworld!
Truy nh?p vào ???ng d?n sau:
http://localhost/phpFox-3.5.1/upload/index.php?do=/admincp/createuser/
Ho?c truy nh?p vào AdminCP và ?i theo ???ng d?n:
Module >> Createuser >> Show info
??y là k?t qu? thu ???c:

Gi?i thích chi ti?t:
Tên l?p trong file index.class.php là:
Createuser_Component_Controller_Admincp_Index
N?u thay d?u g?ch d??i (_) b?ng d?u g?ch trái (/) thì nó s? nh?c b?n t?i ???ng d?n ??n file index.class.php
c?a chúng ta:
/module/createuser/include/component/controller/admincp/index.class.ph
p
L?p này s? k? th?a t? l?p Phpfox_Component, l? do là nó n?m trong th? m?c Component.
?? th?c thi ???c controller này, ta c?n cung c?p ph??ng th?c public process().
Cái tên index ? ??y là b?t bu?c khi b?n mu?n d?n ??n module g?c ? ???ng link:
http://localhost/phpFox-3.5.1/upload/index.php?do=/admincp/createuser/

Ti?p theo chúng ta s? t?o file add.class.php, ??y s? là controller c?a ???ng d?n:
http://localhost/phpFox-3.5.1/upload/index.php?do=/admincp/createuser/add/
Và t?t nhiên b?n v?n s? ph?i t?o m?t file html t??ng ?ng (add.html.php) ? th? m?c
modulecreateusertemplatedefaultcontrolleradmincp ?? hi?n th? th?ng tin c?n thi?t.
Ta s? x?y d?ng form trong add.html.php ?? nh?p th?ng tin user c?n t?o. ??y là d?ng form mà t?i ?? t?o.

Và d??i ??y là ?o?n code t??ng ?ng:
add.html.php
<html>
<body>
<form action="{url link='admincp.createuser.index'}"
method="post" id="add_new_user">
<div class="user_create">
<div class="table_header">
User Infomation
</div>
<div class="table">
<div class="table_left">
{required}Full name:
</div>
<div class="table_right">
<input type="text" name="full_name"
size="40" value="yourname" />
</div>
</div>
<div class="table">
{required}Email:
</div>
<input type="text" name="email"
size="40" value="someone@example.com" required />
</div>
</div>

<div class="table">
{required}Password:
</div>
<input type="password" name="password"
size="40" value="" required/>
</div>
</div>
<div class="table">
{required}Birthday:
</div>
<select name="month">
<option value="">Month: </option>
{foreach from=$months item=month}
<option
value={$i++}>{$month}</option>
{/foreach}
</select>
/
<select name="day">
<option value="">Day: </option>
{foreach from=$days item=day}
<option
value={$day}>{$day}</option>
{/foreach}
</select>
/
<select name="year">
<option value="">Year: </option>
{foreach from=$years item=year}
<option
value={$year}>{$year}</option>
{/foreach}
</select>
</div>
</div>
<div class="table">
{required}I am:
</div>
<select name="gender">
<option value="">Select: </option>
<option value="1">Male</option>
<option value="2">Female</option>
</select>
</div>
</div>
<div class="table_clear">
<input type="submit" value="{phrase
var='core.submit'}" class="button" name="submit" />

</div>
</div>
</form>
</body>
</html>

Gi?i thích code:
Action ? form là:
action="{url link='admincp.createuser.index'}"
Link 'admincp.createuser.index’ có d?ng ‘[admincp.]module_name.file_name_prefix’, ph?n admincp. có
th? có ho?c kh?ng tùy thu?c vào vi?c module th?c hi?n trên admincp hay trên site th?ng th??ng. ? ngh?a
là form này sau khi click submit s? th?c hi?n ?o?n code trong file index.class.php và index.html.php.
Các th? div ? ??y t?i có s? d?ng các class ???c ??nh ngh?a s?n trong phpfox ?? ??ng nh?t v?i nh?ng form
c?a các module khác. Th?ng tin v? các class này b?n có th? xem trong các file html n?m trong các module
có s?n c?a phpfox.
T? {required} thay th? cho d?u * màu ??.
Ti?p theo là m?t vòng l?p khá ??c bi?t:
{foreach from=$months item=month}...{/foreach}
Vòng l?p này có ngh?a là duy?t t?t c? các ph?n t? trong m?ng $months, m?i ph?n t? s? ???c ??i di?n b?i
bi?n $month. Trong PHP, vòng l?p này s? ???c vi?t l?i nh? sau:
foreach($months as $month){}
C?u h?i là m?ng $months này ???c l?y t? ??u ra? Th?c ra m?ng $month ???c gán trong file
add.class.php. N?i dung file add.class.php nh? sau:
add.class.php
<?php
class Createuser_Component_Controller_Admincp_Add extends Phpfox_Component{
$month = array('January', 'February', 'March', 'April', 'May',
'June', 'July', 'August', 'September', 'October', 'November', 'December');
$day = array();
$year = array();
for ($i = 1; $i < 32; $i++) {
$day[] = $i;
}
for ($j = 1900; $j < 2015; $j++) {
$year[] = $j;
}
$this->template()->assign(array(
'months' => $month,
'days' => $day,
'years' => $year
));
}

}
?>

B?i vì ?o?n m? c?a chúng ta s? d?ng m? hình MVC, t?c là logic PHP trong file class tách bi?t v?i logic thi?t
k? trong file html, vì v?y các th?ng tin trong file class s? ???c gán vào các bi?n ?? s? d?ng trong file html.
Phpfox cung c?p ph??ng th?c assign() có trong l?p Phpfox_Template ?? th?c hi?n phép gán này.

Hi?n th? th?ng tin ng??i dùng trên menu Show info
Menu
Show
info
có
url
d?n
??n
module
g?c
http://localhost/phpFox3.5.1/upload/index.php?do=/admincp/createuser/. Do ?ó ta s? x?y d?ng giao di?n cho menu này qua file
index.html.php và ?i?u khi?n b?ng controller index.class.php.
N?i dung file index.html.php:
index.html.php
<html>
<div class="table_header">
Show user info
</div>
<div class="table">
Name:
</div>
{$fulname}
</div>
</div>
<div class="table">
Email:
</div>
{$email}
</div>
</div>
<div class="table">
Birthday:
</div>
{$birthday}
</div>
</div>
<div class="table">
Gender:
</div>
{$gender}
</div>

</div>
</html>

Các bi?n c?n l?y ? ??y là $fulname, $email, $birthday, $gender. Nh?ng bi?n này s? ???c l?y b?ng m?ng
$_POST th?ng qua form ???c x?y d?ng ? file add.html.php.
N?i dung c?a file index.class.php:
index.class.php
<?php
class Createuser_Component_Controller_Admincp_Index extends Phpfox_Component
{
$this->template()->assign(array(
'fulname' => $_POST['full_name'],
'email' => $_POST['email'],
'password' => md5($_POST['password']),
'birthday' => $month . $_POST['day'] .
$_POST['year'],
'gender' => $_POST['gender']
));
}
}
?>

??n ??y ta s? test th? vi?c hi?n th? th?ng tin ng??i dùng. Truy nh?p theo ???ng d?n
http://localhost/phpFox-3.5.1/upload/index.php?do=/admincp/createuser/add/ ho?c ??ng nh?p vào
AdminCP, truy nh?p vào ???ng d?n Module ? Createuser ? Add new, nh?p ??y ?? th?ng tin vào form
sau:

Click Submit và h? th?ng s? t? ??ng ?i?u h??ng ??n link http://localhost/phpFox3.5.1/upload/index.php?do=/admincp/createuser/index/:

Insert th?ng tin ng??i dùng vào c? s? d? li?u
?? truy nh?p và th?c hi?n các ph??ng th?c lên c? s? d? li?u, t?i s? t?o m?t service extends t?
Phpfox_Service. File service này n?m trên ???ng d?n:
modulecreateuserincludeservicecreateuser.class.php
Phpfox quy ??nh m?i module ch? có m?t service duy nh?t ?? thao tác v?i c? s? d? li?u và ch? có tên d?ng
module_name.class.php. N?i dung c?a file createuser.class.php:
createuser.class.php
<?php
class Createuser_Service_Createuser extends Phpfox_Service {
public function insert_user() {
$month = $_POST['month'];
switch ($month) {
case 'January': $month = '01';
break;
case 'February': $month = '02';
break;
case 'March': $month = '03';
break;
case 'April': $month = '04';
break;
case 'May': $month = '05';
break;
case 'June': $month = '06';
break;
case 'July': $month = '07';
break;
case 'August': $month = '08';
break;
case 'September': $month = '09';
break;
case 'October': $month = 10;
break;
case 'November': $month = 11;
break;
case 'December': $month = 12;
break;
}
$insert = Phpfox::getLib('database')->insert('phpfox_user',
array(

'user_group_id' => '2',
'full_name' => $_POST['full_name'],
'email' => $_POST['email'],
'password' => md5($_POST['password']),
'birthday' => $month . $_POST['day'] .
$_POST['year'],
'gender' => $_POST['gender']
));
return $insert;
}
}
?>

Tên l?p v?n tu?n th? theo ??nh d?ng ???c ??nh ngh?a ? trên.
Do giá tr? $month ban ??u ? d?ng ch? mà kh?ng ph?i d?ng s?, trong khi d?ng hi?n th? birthday trong c?
s? d? li?u là mmddyyyy, nên ta s? chuy?n giá tr? $month t? d?ng ch? sang d?ng s? cho phù h?p.
Có 2 cách ?? th?c hi?n insert vào c? s? d? li?u:
$this→database()→insert(‘table_name’, array(‘collumn_name_1’ =>‘value_1’,
‘collumn_name_2’ => ‘value_2’, …));
Phpfox::getLib('database')->insert(‘table_name’, array(‘collumn_name_1’ =>‘value_1’,

‘collumn_name_2’ => ‘value_2’, …));
? ?ó column_name_i là tên c?t th? i, còn value_i là giá tr? c?a c?t t??ng ?ng.
Ti?p theo chúng ta s? th?c thi service này. Yêu c?u là click nút Submit thì service này c?ng ???c th?c thi,
nên ta s? th?c hi?n vi?c th?c thi này trong ph??ng th?c process c?a file index.class.php. Chúng ta s? thêm
?o?n code sau trong file index.class.php.
Phpfox::getService('createuser')->insert_user();
Ph??ng th?c getService nh?n tham s? là tên module và g?i ??n ph??ng th?c insert_user() ?? th?c hi?n
vi?c insert th?ng tin ng??i dùng vào c? s? d? li?u.

Test
Chúng ta s? th?c hi?n test v?i ng??i dùng John Adam ? trên. ??y là ?nh c? s? d? li?u tr??c khi click nút
Submit.

Sau khi click nút Submit.

Chú ?: Do ? ??y t?i th?c hi?n trên localhost nên các ???ng d?n ??u b?t ??u b?ng localhost, n?u b?n t?o
module trên server c?a b?n, h?y thay localhost b?ng tên site c?a b?n trong các ???ng d?n mà t?i ??a ra.

狠狠撸

Create easymoduleinphpfox

Recommended

More Related Content

What's hot (20)

Viewers also liked (9)

Similar to Create easymoduleinphpfox (20)

Recently uploaded (18)

Create easymoduleinphpfox