Main Menu

Đăng ký học joomla

Tin tức mới nhất

Thống kê truy cập

Truy cập trong ngày:	113
Truy cập hôm qua:	367
Tổng số truy cập:	630313

Đang online: 30 Khách

Cách tạo module drupal

Module mẫu hôm nay giới thiệu cách sử dụng hook_form_alter/codefilter_code và khóa [codefilter_code]#theme và #submit trong FormAPI.

Mục đích của module:
- (đương nhiên là làm module mẫu)
- Tạo thêm một field "Company" cho trang liên hệ (được cung cấp bởi module contact)

1. Cấu trúc tổ thức tập tin:

./sites/all/modules/MoreFieldContactPage ./sites/all/modules/MoreFieldContactPage/MoreFieldContactPage.info ./sites/all/modules/MoreFieldContactPage/MoreFieldContactPage.module

2. Định nghĩa tập tin MoreFieldContactPage.info:

Tập tin này sẽ định nghĩa:
- Tên trình bày của module: MoreFieldContactPage
- Nội dung mô tả: Add more fields to core contact page
- Module phụ thuộc: contact
- Phiên bản: 5.x-1.0-dev
- Nằm trong gói: ToiLa .net (giúp cho người điều hành dễ quản lý)

Nội dung cụ thể:

name = MoreFieldContactPage description = Add more fields to core contact page dependencies = contact version = 5.x-1.0-dev package = ToiLa .net

3. Sử dụng hook_form_alter():

Trước khi một HTML Form được tạo ra, Drupal sẽ đi tìm tất cả các hàm có dạng {tên_module}_form_alter/codefilter_code để thay nổi cấu trúc mảng định nghĩa form. Ở module này của chúng ta, chúng ta sẽ định nghĩa hàm (trong tập tin [codefilter_code]MoreFieldContactPage:

<?php
function MoreFieldContactPage_form_alter($form_id, &$form) {
 print('['.$form_id.']');
}
?>

Khi bất cứ một HTML Form nào tạo ra, hàm của

MoreFieldContactPage_form_alter/codefilter_code của chúng ta đều được gọi. Khi được gọi, hàm sẽ in ra màn hình mã số của form ([codefilter_code]$form_id

)tương ứng. Đi vào trang ?q=contact, chúng ta sẽ biết được mã số của form liên hệ sẽ là contact_mail_page. Dựa vào $form_id này, chúng ta tiếp tục cải tiến hàm

MoreFieldContactPage_form_alter/codefilter_code để khi, mỗi khi form liên hệ được tạo ra, chúng ta sẽ thêm vào một field (trường) có khóa là [codefilter_code]company

, có tiêu đề là Your compapy name, có phần mô tả là This field is generated using MoreFieldContactedPage module. và nội dung không được rỗng:

<?php
function MoreFieldContactPage_form_alter($form_id, &$form) {
 if ($form_id == 'contact_mail_page') {
 $form['company'] = array(
 '#type' => 'textfield',
 '#title' => 'Your company name',
 '#description' => 'This field is generated using MoreFieldContactedPage module.',
 '#required' => true
 );
 }
}
?>

3. Sử dụng khóa #theme của FormAPI:

Chúng ta có thể sử dụng khóa #theme của FormAPI để có thể thay đổi cách trình bày của HTML Form được xuất ra. Chúng ta sẽ tiếp tục cải tiến hàm MoreFieldContactPage_form_alter/codefilter_code, để trước khi form liên hệ được xuất ra, nó sẽ được hàm [codefilter_code]theme_ContactForm thay đổi cách trình bày ra giao diện người dùng:

<?php
function MoreFieldContactPage_form_alter($form_id, &$form) {
 if ($form_id == 'contact_mail_page') {
 $form['#theme'] = 'ContactForm';
 $form['company'] = array(
 '#type' => 'textfield',
 '#title' => 'Your company name',
 '#description' => 'This field is generated using MoreFieldContactedPage module.',
 '#required' => true
 );
 }
}
?>

Và đương nhiên, chúng ta sẽ phải định nghĩa hàm:

<?php
function theme_ContactForm($form) { $output = ''; $output .= drupal_render($form['contact_information']); $output .= drupal_render($form['company']); $output .= drupal_render($form); return $output;}
?>

Ý nghĩa của hàm:

- Dòng 2: chúng ta sử dụng biến [codefilter_code]$output để lưu giữ chuỗi HTML của Form liên hệ.

- Dòng 3: Bắt đầu form liên hệ sẽ là thông tin của form
- Dòng 4: Tiếp đến là field 'Your company'
- Dòng 5: Tiếp sau là các thành phần còn lại của form
- Dòng 6: Trả về chuỗi HTML của Form liên hệ.

4. Sử dụng khóa #submit của FormAPI:

Khi đã thêm (các) field cần thiết vào form liên hệ, chúng ta cần thêm phải thay đổi một chút cách xử lý khi form được đệ trình (người dùng nhấp vào nút Submit).
3.1. Khai báo hàm sẽ xử lý form
Nếu hàm xử lý form không được khai báo, mặc định, FormAPI sẽ hiểu hàm {form_id}_submit() sẽ là hàm xử lý khi form được đệ trình. Chúng ta một lần nữa cải tiến hàm [codefilter_code]MoreFieldContactPage_form_alter/codefilter_code, định nghĩa hàm xử lý form sẽ là [codefilter_code]MoreFieldContactPage_submit/codefilter_code:

<?php
function MoreFieldContactPage_form_alter($form_id, &$form) {
 if ($form_id == 'contact_mail_page') {
 $form['#theme'] = 'ContactForm';
 $form['company'] = array(
 '#type' => 'textfield',
 '#title' => 'Your company name',
 '#description' => 'This field is generated using MoreFieldContactedPage module.',
 '#required' => true
 );
 $form['#submit'] = array('MoreFieldContactPage_submit' => array());
 }
}
?>

Và hàm [codefilter_code]MoreFieldContactPage_submit/codefilter_code của chúng ta sẽ được định nghĩa đại khái như sau (chèn thêm tên công ty của người dùng vào nội dung chính của thông điệp):

<?php
function MoreFieldContactPage_submit ($form_id, $form_values) {
 $form_values['message'] = "Contact's company: ".$form['company']."\r\n\r\n"
 contact_mail_page_submit($form_id, $form_values);
}
?>

Comments

+1 #1 Hoàng Biên 2012-01-06 11:08

Bài viết rất hay, anh có thể viết một bài để sửa đổi hay tạo mới module đăng ký tài khoản được không ạ. thêm một bài về cách tạo theme và chuyển theme từ file html sang drupal thì tốt quá.
Xin cảm ơn rất nhiều!

Quote

Refresh comments list
RSS feed for comments to this post