「モジュール (開発者)」の版間の差分

2008年12月3日 (水) 14:54時点における最新版

活動モジュールは、'mod'ディレクトリ内にあります。それぞれのモジュールは、別々のサブディレクトリに分かれていて、次の必須要素を含みます (+ 各モジュール特有のスクリプト):

mod.html - 本モジュールのインスタンスを生成・更新するためのフォーム
version.php - メタ情報を定義し，アップグレード用コードを提供
icon.gif - モジュールを表す 16x16 のアイコン
db/ - （各データベース形式毎の）必要な全てのDBテーブルとデータを生成するSQLコード
index.php - コース内の全てのインスタンス一覧を表示するページ
view.php - 特定のインスタンスを表示するページ
lib.php - 本モジュールで定義されるあらゆる全ての関数はここに書く。例えばモジュール名が widget である場合，以下の関数が必須：

widget_install() - モジュールのインストール中に呼び出される
widget_add_instance() - widget の新しいインスタンスを追加するためのコード
widget_update_instance() - すでに存在するインスタンスを更新するためのコード
widget_delete_instance() - インスタンスを削除するためのコード
widget_user_outline() - 特定のインスタンスに対するユーザの貢献のサマリを返す
widget_user_complete() - 特定のインスタンスに対するユーザの貢献の詳細を表示する
必須ではないが，使用可能なその他の関数：
- widget_delete_course() - すべてのインスタンスが削除された後に残る残骸をすべてきれいに消すコード
- widget_process_options() - モジュール設定のフォームデータの前処理を行うコード
- widget_reset_course_form() と widget_delete_userdata() - コースのリセット機能を実装するのに用いられる
モジュール同士の衝突を避けるために，すべてのモジュール関数の名前には頭に widget_ を付け，モジュール内で定義されるすべての定数の名前には頭に WIDGET_ を付けなければならない。

config.html - (任意) 全インスタンスに共通の設定を指定・更新するためのフォーム
最後に，各モジュールにはそれぞれの言語ファイルが含まれている。

重要: 新たなモジュールを作るときは，そのモジュール名には番号や特殊な文字を含めないように！

また，あなたが作る活動モジュールが，グループやメタコースを適切にサポートするようにしてください。

@@ 1行目: / 1行目: @@
-作成中です - [[利用者:Mitsuhiro Yoshida|Mitsuhiro Yoshida]] 2006年12月7日 (木) 19:41 (CST)
+'''活動モジュール'''は、'mod'ディレクトリ内にあります。それぞれのモジュールは、別々のサブディレクトリに分かれていて、次の必須要素を含みます (+ 各モジュール特有のスクリプト):
-'''活動モジュール'''は、'mod'ディレクトリ内にあります。それぞれのモジュールは、別々のサブディレクトリに分かれていて、次の必須要素を含みます (+ それぞれのモジュール特有のスクリプト):
 * ''mod.html'' - 本モジュールのインスタンスを生成・更新するためのフォーム
@@ 20行目: / 18行目: @@
 :** widget_delete_course() - すべてのインスタンスが削除された後に残る残骸をすべてきれいに消すコード
 :** widget_process_options() - モジュール設定のフォームデータの前処理を行うコード
-:** [[Development:Implementing Reset course functionality in a module|widget_reset_course_form() と widget_delete_userdata()]] - [[コースのリセット]] 機能を実装するのに用いられる
+:** [[開発:コースのリセット機能をモジュールに実装する|widget_reset_course_form() と widget_delete_userdata()]] - [[コースのリセット]] 機能を実装するのに用いられる
 :* モジュール同士の衝突を避けるために，すべてのモジュール関数の名前には頭に widget_ を付け，モジュール内で定義されるすべての定数の名前には頭に WIDGET_ を付けなければならない。
-* ''config.html'' - (optional) a form to set up or update global settings of this module
+* ''config.html'' - (任意) 全インスタンスに共通の設定を指定・更新するためのフォーム
-* Lastly, each module will have some language files that contain strings for that module.
+* 最後に，各モジュールにはそれぞれの言語ファイルが含まれている。
-重要: When creating a new module, the new name of the module must not contain numbers or other special characters!
+重要: 新たなモジュールを作るときは，そのモジュール名には番号や特殊な文字を含めないように！
-You should also make sure that your activity module provides appropriate support for groups and metacourses.
+また，あなたが作る活動モジュールが，グループやメタコースを適切にサポートするようにしてください。
 ==関連情報==
@@ 39行目: / 37行目: @@
 [[Category:開発者]]
 [[Category:モジュール]]
+[[en:Development:Modules]]
+[[es:Módulos de actividades (desarrollador)]]

Documentation

「モジュール (開発者)」の版間の差分

2008年12月3日 (水) 14:54時点における最新版

関連情報