Cách làm một Module đơn giản cho Joomla! 1.0.x

Mặc nhiên sau khi cài đặt Joomla! chỉ có một số Mod cơ bản cần thiết cho Web Site hoạt động, muốn mở rộng thêm chức năng cho Web Site thông thường cần phải cài đặt thêm các phần mở rộng (Extensions) khác. Tuy nhiên đôi lúc cũng cần phải tự tạo cho riêng Web Site của mình một vài Mod để mở rộng thêm chức năng riêng cho Web Site.

Thông thường một Mod sẽ gồm có 2 file chính là .php (chương trình) và file .xml (thông số), ngoài ra có thể có thể có thêm thư mục ảnh, Java Script... hỗ trợ thêm cho Module.

Bài viết này sẽ hướng dẫn cách tạo một Module đơn giản, đó là Module Vdict có chức năng dịch từ điển Việt - Anh - Pháp lấy dữ liệu từ điển của vdict.com. Mod này gồm có 2 file là vdict.php và vdict.xml.

vdict.xml: Khai báo các thông số và cài đặt cho Module, các thông số này sẽ được hiển thị trong phần Quản lý Module (Site Module: Edit)

1. Chuẩn định dạng cho file xml

2. Thẻ khai báo cài đặt Module

Phần thông tin về Module: Tên của Module (3), tác giả (4), ngày thực hiện (5), bản quyền (6), loại giấy phép sử dụng (7), địa chỉ thư điện tử của tác giả (8), trang Web của tác giả (9), Version (phiên bản) của Module (10), giới thiệu về Module (11)

12. Thẻ bắt đầu khai báo các file có trong Module để cài đặt

13. Khai báo file vdict.php (không cần khai báo file vdict.xml)

14. Thẻ kết thúc khai báo các file có trong Module để cài đặt

15. Thẻ bắt đầu khai báo các thông số có trong Module: Name (khai báo tên thông số), Type (kiểu thông số), Default (giá trị mặc nhiên), Label (tên hiển thị của thông số)

16. Thông số Module Class Suffix.

17. Tạo khoảng trống ngăn cách giữa các thông số (chỉ có tác dụng trình bày, có thể không có)

18. Thẻ bắt đầu thông số Cache cho Module với 2 lựa chọn: No (19) và Yes (20)

21. Thẻ kết thúc thông số Cache.

22. Tạo khoảng trống ngăn cách giữa các thông số (chỉ có tác dụng trình bày, có thể không có)

23. Thông số chiều rộng của hộp nhập từ (width), mặc nhiên là 20

24. Thông số đặt dòng chữ trước hộp nhập từ (pre_text), mặc nhiên là "Tra từ điển: "

25. Thông số đặt dòng chữ trong hộp nhập từ (text), mặc nhiên là "nhập từ cần tra... "

26. Tạo khoảng trống ngăn cách giữa các thông số (chỉ có tác dụng trình bày, có thể không có)

27. Thông số đặt dòng chữ trong nút lệnh (button_text), mặc nhiên là "Tra"

28. Thẻ kết thúc khai báo các thông số

29. Thẻ kết thúc cài đặt Module.

vdict.php: Tập lệnh xử lý, kết hợp với các thông số trong vdict.xml để tạo ra Module

1. Mở đầu lệnh php

2. Dòng chú thích (có thể tùy ý, có hoặc không)

3. Lệnh ngăn không cho truy cập trực tiếp vào file php này

4. Biến lấy giá trị của thông số button_text, mặc định là "Tra"

5. Biến lấy giá trị của thông số width, mặc định là "20"

6. Biến lấy giá trị của thông số text, mặc định là "Nhập từ cần tra..."

7. Biến lấy giá trị của thông số pre_text, mặc định là "Tra từ điển: "

8. Khởi tạo biến xuất dữ liệu với các thông tin được kết hợp từ các biến (thông số) trên.

9. Kết thúc lệnh php

10. Tạo bảng kiểu để đặt Module này bên trong, width:100% (kích thước giới hạn của Module, tùy thuộc vào vị trí), padding:5px (tạo khoảng cách giữa Module và vị trí, có thể không cần hoặc thay đổi tùy ý)

11. Tạo phần (Form) nhập dữ liệu, có thể thay thế các mã tạo khoảng cách   bằng 
 để tạo xuống dòng cho các mục nhập dữ liệu.

12. Tạo phần (Scroll Menu) chọn kiểu dịch với các kiểu từ 13 -> 20, trong đó kiểu 14 là mặc định.

21. Kết thúc phần chọn kiểu dịch.

22. Phần tạo nút nhấn.

23. Kết thúc phần (Form) nhập dữ liệu.

24. 25. Phần hiển thị thêm trên Module (có thể không cần).

26. Kết thúc bảng kiểu để đặt Module.

Trên đây là hướng dẫn cơ bản cách tạo một Module đơn giản cho Joomla! 1.0.x, nếu làm đúng các bước như trên sẽ tạo được Vdict Module, đây là Module tự điển trực tuyến Việt - Anh - Pháp hỗ trợ 8 kiểu dịch. Module này dohttp://www.buaxua.vn thực hiện với mã nguồn từ điển từ vdict.com.

Tải File (Download): 

• 
  
  Vdict Module 1.0 (Joomla! 1.0.x)
• 
  
  Vdict Module 1.5 (Joomla! 1.5.x)