weekly release 2.2dev
[moodle.git] / mod / upgrade.txt
CommitLineData
9c82ff2a 1This files describes API changes in /mod/* - activity modules,
2information provided here is intended especially for developers.
3
4=== 2.0 ===
5
44f2977c
PS
6WORK IN PROGRESS...
7
9c82ff2a 8required changes in code:
9* use new DML syntax everywhere
728ebac7 10 (http://docs.moodle.org/dev/DML_functions)
9c82ff2a 11* use new DDL syntax in db/upgrade.php
728ebac7 12 (http://docs.moodle.org/dev/DDL_functions)
9c82ff2a 13* replace defaults.php by settings.php and db/install.php
847400a7 14* replace STATEMENTS section in db/install.xml with PHP code db/install.php or db/log.php
9cb56578 15* move post installation code from lib.php into db/install.php
56f7ff74 16* move uninstallation code from lib.php to db/uninstall.php
8026a943
PS
17* new mandatory naming of intro and introformat table fields in module tables,
18 the presence of these fields is indicated in xxx_plugin_supports()
9c82ff2a 19* completely rewrite file handling
728ebac7 20 (http://docs.moodle.org/dev/File_API)
9c82ff2a 21* rewrite backup/restore
44f2977c 22 (not finished yet)
9cb56578
PS
23* rewrite trusttext support - new db table columns needed
24* migrate all module features from mod_edit.php form to lib.php/modulename_supports() function
398a160d 25* implement new gradebook support (legacy 1.8.x grading not supported anymore)
44f2977c
PS
26* migrate custom resource module subtypes into separate modules,
27 necessary only for custom plugins in mod/resource/
af34490a 28* use new $PAGE and $OUTPUT instead of old weblib functions
78946b9b
PS
29* theme changes: move plugin styles into mod/xxx/styles.css and use new css markers for images,
30 move all images into new mod/xxx/pix/ directory and use new outputlib api
31 move module icon to mod/xxx/pix/icon.gif
cbcc9852 32 old global $THEME is fully replaced by $OUTPUT
8026a943 33 create plugin renderers
728ebac7 34 (http://docs.moodle.org/dev/Theme_changes_in_2.0)
b7534190 35* migrate all javascript new coding style using YUI3+YUI2
728ebac7 36 (http://docs.moodle.org/dev/JavaScript_usage_guide)
2b0e098e
PS
37* remove '_utf8' from lang pack names, use new {a} syntax
38* replace helps with new 'xxx_hlp' strings
7070ca36 39* please note the $plugin->requires in version.php has to be bigger than 2010000000,
dae88219 40 otherwise the plugin is marked as outdated and upgrade is interrupted
9c82ff2a 41
42optional - no changes needed in older code:
dbf9e4ba 43* settingstree.php replaced by settings.php - just unset the $settings if you want to make custom part of settings admin tree
ff3ad2d9
PS
44* support for new mforms editor element and embedded files
45 (not finished yet)
9c82ff2a 46* portfolio support
728ebac7 47 (http://docs.moodle.org/dev/Portfolio_API)
9c82ff2a 48* course completion tracking support
8026a943
PS
49* new navigation features
50* new comments API
728ebac7 51 (http://docs.moodle.org/dev/Comments_2.0)
8026a943 52* new ratings API
728ebac7 53 (http://docs.moodle.org/dev/Ratings_2.0)
9c82ff2a 54
21aa9d48
PS
55
56=== 2.2 ===
57
58required changes in code:
59* fix missing parameter types in optional_param() and required_param()
0fde6cb8
EL
60* use new optional_param_array(), required_param_array() or clean_param_array() when dealing with array parameters
61* textlib->asort() replaced by specialized collatorlib::asort()
3e6e4d00 62* use new make_temp_directory() and make_cache_directory()