++Tài liệu này mô tả về một số thiết kế của Moodle và làm thế nào bạn có thể bạn có thể đóng góp.
+It's a bit thin at the moment - better documentation will come eventually!
+Các phần trong tài liệu này:
+ +
+
++Từ một hệ thống phối cảnh của nhà quản trị, Moodle được thiết kế theo các tiêu chuẩn sau:
++
+- Moodle nên chạy trên các nền phổ dụng nhất
+
+
+ Nền ứng dụng web mà chạy trên trên hầu hết các nền là PHP được biên dịch cùng với + MySQL, và đây là môi trường mà Moodle được phát triển trong + (trên Linux, Windows, và Mac OS X). Moodle cũng sử dụng thư viện ADOdb để chiết ra cơ sở dữ liệu, + điều đó có nghĩa là Moodle có thể sử dụng nhiều hơn mười loại cơ + sở dữ liệu khác nhau (không may mắn là, nó có thể + chưa cài đặt các bảng trong tất cả các cơ sở dữ liệu này - + chi tiết hơn ở lần sau).
+
+ +- Moodle nên dễ cài đặt, học tập và thay đổi
+
+
+ Phiên bản đầu tiên của Moodle (1999)được xây dựng sử dụng Zope + - một ứng dụng web hướng đối tượng cao cấp. Không may mắn tôi nhận thấy rằng + mặc dù công nghệ that although the technology was pretty cool, it had a very steep learning + curve and was not very flexible in terms of system administration. Ngôn ngữ kịch bản PHP + , nói cách khác, rất dễ để viết get into (đặc biệt + khi bạn làm bất kỳ chương trình nào sử dụng bất kỳ ngôn ngữ kịch bản nào khác). Đầu tiên + tôi tạo một mô tả để ngăn việc thiết kế lại một lớp, để duy trì nó đơn giản dễ hiểu đối + những người chưa có kinh nghiệm. Mã sử dụng lại được lưu trữ bởi các + thư viện của các hàm được đặt tên rõ ràng và cách bố trí phù hợp của các file kịch bản. + PHP cũng dễ cài đặt (các nhị phân thì có sẵn đối vơí mọi nền) + và được có sẵn rộng rãi để chỉ ra rằng tất cả các dịch vụ web hosting cung cấp nó như một chuẩn. +
+
+ +- Nó nên dễ nâng cấp từ một phiên bản để trở thành phiên bản tiếp theo
+
+
+ Moodle knows what version it is (ví dụ như các phiên bản của tất cả các môđun plug-in ) + và một kỹ xảo được xây dựng với mục đích để Moodle có thể tự nâng cấp một cách dễ dàng thành phiên bản mới + (ví dụ nó có thể đổi tên các bảng cơ sở dữ liệu hoặc thêm các trường mới + ). Nếu sử dụng CVS trong Unix đối với ví dụ này, một cách có thể làm một "cập nhật cvs + " và sau đó thăm trang chủ để hoàn thành việc nâng cấp.
+
+ +- Nó nên môđun hóa để cho phép phát triển
+
+
+ Moodle có một số đặc trưng đó là các môđun, bao gồm themes, các hoạt động, các ngôn ngữ giao diện + , giản đồ cơ sở dữ liệu và định dạng các cua học. Điều này cho phép bất kỳ ai thêm các đặc trưng vào + phần mã chính hoặc ngay cả khi sắp xếp chúng một cách độc lập. + Chi tiết hơn xem ở các phần sau.
+
+ +- Nó nên có khả năng được sử dụng chung với các hệ thống khác
+
+
+ Một trong những điều mà Moodle có thể là là duy trì tất cả các file đối với một cua học trong một thư + mục thông thường trên server. Điều này sẽ cho phép một nhà quản trị hệ thống cung cấp + các form liền mạch các truy cập mức file đối với mỗi giáo viên,ví dụ + Appletalk, SMB, NFS, FTP, WebDAV vân vân. Các môđun chứng thực cho phép + Moodle sử dụng LDAP, IMAP, POP3, NNTP và các cơ sở dữ liệu khác như các nguồn tài nguyên + đối với thông tin người dùng. Mặt khác, chưa có công việc phải làm. Các tính năng được lên kế hoạch + cho Moodle trong các phiên bản trong tương lai bao gồm: nhập và xuất dữ liệu của Moodle sử dụng + các định dạng dựa trên XML (bao gồm IMS và SCORM); và tăng thêm sử dụng các kiểu dáng đối với các định dạng giao + diện (vì thế nó có thể được tích hợp bên ngoài vào trong các web site khác ).
+
++Như được đề cập ở trên đây, Moodle có một số đặc trưng mà nó là that are modular. Ngay cả khi + bạn không là một lập trình viên có một số thứ mà bạn có thể thay đổi hoặc trợ giúp với.
+Các hoạt động học tập
+++Đây là những môđun quan trọng nhất và được đặt ở trong thư mục 'mod'. + Có một số môđun mặc định: assignment, choice, forum, journal, quiz, + resource, và survey. Mỗi môđun là một thư mục con riêng biệt chứa + các phần tử có tính bắt buộc sau (plus extra scripts unique to each module):
++
+- mod.html: một form để thiết lập hoặc cập nhật một ví dụ về môđun này
+- version.php: định nghĩa một số thông tin biến đổi và cung cấp nâng cấp mã
+- icon.gif: một biểu tượng 16x16 đối với môđun
+- db/: Kết xuất SQL về tất cả các bảng db được yêu cầu và dữ liệu (đối với mỗi kiểu cơ sở dữ liệu + )
+- index.php: một trang liệt kê tất cả các ví dụ trong một cua học
+- view.php: một trang để quan sát một ví dụ cụ thể
+- lib.php: tất cả các hàm được định nghĩa bởi môđun nên được đặt ở đây. + Nếu tên môđun nếu gọi widget, thì các hàm được yêu cầu bao gồm: +
++
+- widget_add_instance() - mã để thêm một ví dụ mới về widget
+- widget_update_instance() - mã để cập nhật một trường hợp đã tồn tại
+- widget_delete_instance() - mẫ để xóa một trường hợp
+- widget_user_outline() - đưa ra một trường hợp, trả về tóm tắt đóng góp của một người +
+- widget_user_complete() - đưa ra một trường hợp, hiển thị chi tiết về đóng góp của người dùng +
+
+ +- Ngăn chặn khả năng xung đột, bất kỳ hàm môđun nào nên được đặt tên bắt đầu với + widget_ và bất kỳ hằng bạn định nghĩa nên bắt đầu với WIDGET_
+- Cuối cùng, mỗi môđun sẽ có một số file ngôn ngữ mà nó chứa các chuỗi đặc trưng cho môđun đó + . Xem dưới đây.
+Cách tốt nhất để bắt đầu một môđun hoạt động học tập mới là sử dụng cái mẫu trong mod/newmodule_template.zip. + giải nén nó và làm theo các bước bên trong phần README.
+Bạn cũng có thể muốn gửi lên đầu tiên trong Diễn đàn các môđun hoạt động trên Moodle.
++
Themes
+++Themes (or skins) định nghĩa giao diện của site. Một số theme đơn giản + được cung cấp trong phân phối chính, nhưng bạn có thể muốn tạo ra cho riêng mình một + theme với màu sắc, logo, kiểu dáng và giản đồ của riêng mình.
+Mỗi theme trong một thư mục con của thư mục "theme", và chứa tối thiểu + các file sau:
++
+- config.php: định nghĩa màu sắc của theme được sử dụng trong suốt site +
+- styles.php: chứa các định nghĩa CSS cho các phần tử + HTML chuẩn như đối với nhiều phần tử của Moodle.
+- header.html: Bao gồm ở đỉnh của mỗi trang. Đây là những gì bạn cần + để soạn thảo thêm một logo ở đỉnh của các trang, ví dụ.
+- footer.html: Bao gồm ở đáy của mỗi trang.
+Tạo themes cho riêng bạn đối với các phiên bản hiện tại của Moodle:
++
+- Copy folder theme đã tồn tại sang một cái khác với một tên mới. Tôi gợi ý bắt đầu + với một trong những cái theme chuẩn.
+- Soạn thảo file config.php và chèn các màu sắc của riêng bạn vào.
+- Soạn thảo file styles.php và thay đổi kiểu dáng CSS của bạn.
+- Soạn thảo file header.html và footer.html thêm các logo mới, hoặc thay đổi cách bố trí. +
+Chú ý rằng tất cả các bươc này là tùy chọn - bạn có thể tạo một cái trông khác hoàn toàn + để site của bạn trở nên đơn giản bởi việc soạn thảo màu sắc trong file config.php
+Chú ý rằng các nâng cấp của Moodle cũng có thể làm gián đoạn các themes, vì thế + kiểm tra các ghi chú phiên bản một cách cẩn thận nếu bạn đang sử dụng một theme tùy chọn.
+Cụ thể, Moodle 2.0 sẽ có một hệ thống hiển thị mới hoàn toàn, có thể dựa trên + XSL sự biến đổi của đầu ra XML từ Moodle. Hầu như các theme cho điều này sẽ là một định dạng khác hoàn toàn + ,nhưng lợi ích sẽ là là cao hơn rất nhiều (bao gồm di chuyển các phần tử xung quanh trang ).
+Thảo luận nhiều hơn về điều này trong Các diễn đàn về theme + trên Moodle.Nếu bạn tạo một theme đẹp mà bạn nghĩ những người khác có thể muốn sử dụng + , vui lòng gửi file zip của bạn lên diễn đàn về theme!
+
+ +Các ngôn ngữ
+++Moodle được thiết kế cho toàn cầu. Mỗi 'string' hoặc 'page' + văn bản mà được hiển thị như một phần giao diện được vẽ từ một tập các file ngôn ngữ + . Mỗi ngôn ngữ là một thư mục con của thư mục 'lang'. + Cấu trúc của thư mục lang là như sau:
+lang/en - thư mục chứa tất cả các file đối với mỗi ngôn ngữ + (ví dụ English)
++
+- moodle.php - các chuỗi dành cho giao diện chính
+- assignment.php - các chuỗi dành cho môđun bài tập lớn
+- choice.php - các chuỗi dành cho môđun lựa chọn
+- forum.php - các chuỗi dành cho môđun diễn đàn
+- journal.php - các chuỗi dành cho môđung nhật ký
+- quiz.php - các chuỗi dành cho môđun bài thi
+- resource.php - các chuỗi dành cho môđun tài nguyên
+- survey.php - các chuỗi dành cho môđun khảo sát
+- .... và nhiều môđun khác nữa nếu có thể.
+
+
+ Một chuỗi được gọi từ những file này sử dụng hàm get_string() + hoặc print_string() . Mỗi chuỗi hỗ trợ hành động thay thế các biến, + hỗ trợ thứ tự biến trong các ngôn ngữ khác nhau.
+
+ ví dụ $strdueby = get_string("assignmentdueby", "assignment", + userdate($date));
+
+ Nếu một chuỗi không tồn tại tỏng ngôn ngữ riêng biệt, thì một chuỗi bằng tiếng anh tương ứng sẽ được tự động thay thế + .lang/en/help - chứa các trang trợ giúp( trợ giúp phù hợp với từng ngữ cảnh )
+++Các trang trợ giúp chính thường ở đây, đôi khi các trang trợ giúp chỉ ra mỗi môđun + được định vị trong các thư mục con với tên của môđun đó.
+Bạn có thể chèn motọ nút trợ giúp vào trong một trang với hàm trợ giúp.
+ví dụ helpbutton("text", "Nhấn chuột vào đây để được trợ giúp về văn bản ");
+và chi tiết về các môđun
+helpbutton("forumtypes", "các kiểu diễn đàn", "forum");
+Chú ý rằng bạn có thể soạn thảo các ngôn ngữ trực tuyến, sử dụng công cụ quản trị web + bởi "Kiểm tra ngôn ngữ này". Điều này làm cho nó không chỉ dễ tạo các ngôn ngữ mới mà còn tinh lọc + những cái đã tồn tại. Nếu bạn đang bắt đầu một ngôn ngữ mới, vui lòng liên lạc với tôi + , Martin + Dougiamas.
+Bạn cũng có thể muốn gửi lên Diễn đàn các ngôn ngữ + sử dụng Moodle.
+Nếu bạn đang duy trì một ngôn ngữ dựa trên một bản đã tồn tại, tôi có thể đưa cho bạn điền vào CVS + truy cập mã nguồn của Moodle vì thế bạn có thể duy trì trực tiếp các file.
+Giản đồ cơ sở dữ liệu
+++Đưa ra một cơ sở dữ liệu làm việc với các bảng được định nghĩa, + SQL sử dụng trong Moodle sẽ làm việc tốt với sự đa dạng của các kiểu cơ sở dữ liệu khác nhau.
+Một vấn đề tồn tại vơí tạo tự động các bảng mới + trong một cơ sở dữ liệu, nó là những gì moodle cố gắng làm để chông lại các cài đặt ban đầu. + Bởi vì mọi cơ sở dữ liệu thì rất khác nhau, chưa tồn tại bất kỳ cách nào để làm điều này theo + một cách không phụ thuộc nền. Để hỗ trợ điều này tự động trong mỗi cơ sở dữ liệu + , các giản đồ có thể được tạo mà danh sách yêu cầu SQL tạo các bảng trong Moodle trong một cơ sở dữ liệu đặc biệt + . Có nhiều file trong lib/db + và bên trong thư mục con db của mỗi môđun.
+Hiện tại, chỉ có MySQL và PostgreSQL là hỗ trợ hoàn toàn theo cách này.
+Moodle 1.2 sẽ sử dụng một phương pháp mới của giản đồ XML không phụ thuộc cơ sở dữ liệu + mà sẽ làm tất cả những điều không cần thiết .
++
Các định dạng cua học
+++Moodle hiện tại hỗ trợ 3 định dạng cua học khác nhau: theo tuần, theo chủ đề + và các vấn đề xã hội.
+Những cái này là một bộ phận nhỏ được kết nối tới phần còn lại của mã ( và kể từ đây, + "pluggable" kém đi;)nhưng nó quá dễ để thêm vào nhiều cái mới.
+Nếu bạn có bất kỳ ý kiến nào về các định dạng khác mà bạn muốn thì bạn có thể liên lạc với tôi để tôi + sẽ làm nó một cách tuyệt đối nhất để có sẵn ở các phiên bản trong tương lai.
++
Tài liệu và các bài báo
+++Nếu bạn cảm thấy muốn viết một tài liệu hướng dẫn, một bài báo, hoặc bất kỳ cái gì khác + về Moodle, vui lòng làm thực hiện như sau!
+Đặt nó trên web và đảm bảo rằng bạn chứa các đường link tới http://moodle.org/
++
Tham gia vào hoạt động kiểm tra lỗi
+++Cuối cùng, tôi muốn mời bạn đăng ký vào " hoạt động kiểm tra lỗi " + ở http://moodle.org/bugs + vì thế bạn có thể sửa bất kỳ lỗi nào mà bạn tìm thấy và có thể tham gia thảo luận và cố định chúng + .
+"Các lỗi" không chỉ bao gồm các lỗi phần mềm với các phiên bản hiện hành. + của Moodle, mà còn các ý kiến mới, các yêu cầu đặc trưng và nhận xét kiến trúc các đặc trưng đã tồn tại + Điều tuyệt vời nhất của mã nguồn mở là bất kỳ ai cũng có thể tham gia theo nhiều kiểu khác nhau và trợ giúp tạo một + sản phẩm tốt hơn cho tất cả chúng ta thưởng thức. + Trong dự án này, rất ủng hộ mọi người tham gia vào!
+
+
++++++Xin chân thành cám ơn vì đã sử dụng Moodle!
+
+
+ Martin Dougiamas, nhà phát triển chính +
+
++ ++
Phiên bản: $Id$
+