upgrade.txt 2.86 KB
Newer Older
1
2
3
4
5
This files describes API changes in /mod/* - activity modules,
information provided here is intended especially for developers.

=== 2.0 ===

Petr Skoda's avatar
Petr Skoda committed
6
7
WORK IN PROGRESS...

8
9
required changes in code:
* use new DML syntax everywhere
10
  (http://docs.moodle.org/dev/DML_functions)
11
* use new DDL syntax in db/upgrade.php
12
  (http://docs.moodle.org/dev/DDL_functions)
13
* replace defaults.php by settings.php and db/install.php
Petr Skoda's avatar
Petr Skoda committed
14
* replace STATEMENTS section in db/install.xml with PHP code db/install.php or db/log.php
Petr Skoda's avatar
Petr Skoda committed
15
* move post installation code from lib.php into db/install.php
16
* move uninstallation code from lib.php to db/uninstall.php
Petr Skoda's avatar
Petr Skoda committed
17
18
* new mandatory naming of intro and introformat table fields in module tables,
  the presence of these fields is indicated in xxx_plugin_supports()
19
* completely rewrite file handling
20
  (http://docs.moodle.org/dev/File_API)
21
* rewrite backup/restore
Petr Skoda's avatar
Petr Skoda committed
22
  (not finished yet)
Petr Skoda's avatar
Petr Skoda committed
23
24
* rewrite trusttext support - new db table columns needed
* migrate all module features from mod_edit.php form to lib.php/modulename_supports() function
25
* implement new gradebook support (legacy 1.8.x grading not supported anymore)
Petr Skoda's avatar
Petr Skoda committed
26
27
* migrate custom resource module subtypes into separate modules,
  necessary only for custom plugins in mod/resource/
28
* use new $PAGE and $OUTPUT instead of old weblib functions
29
30
31
* theme changes: move plugin styles into mod/xxx/styles.css and use new css markers for images,
                 move all images into new mod/xxx/pix/ directory and use new outputlib api
                 move module icon to mod/xxx/pix/icon.gif
32
                 old global $THEME is fully replaced by $OUTPUT
Petr Skoda's avatar
Petr Skoda committed
33
                 create plugin renderers
34
  (http://docs.moodle.org/dev/Theme_changes_in_2.0)
Petr Skoda's avatar
Petr Skoda committed
35
* migrate all javascript new coding style using YUI3+YUI2
36
  (http://docs.moodle.org/dev/JavaScript_usage_guide)
Petr Skoda's avatar
Petr Skoda committed
37
38
* remove '_utf8' from lang pack names, use new {a} syntax
* replace helps with new 'xxx_hlp' strings
Petr Skoda's avatar
Petr Skoda committed
39
* please note the $plugin->requires in version.php has to be bigger than 2010000000,
Petr Skoda's avatar
Petr Skoda committed
40
  otherwise the plugin is marked as outdated and upgrade is interrupted
41
42

optional - no changes needed in older code:
43
* settingstree.php replaced by settings.php - just unset the $settings if you want to make custom part of settings admin tree
Petr Skoda's avatar
Petr Skoda committed
44
45
* support for new mforms editor element and embedded files
  (not finished yet)
46
* portfolio support
47
  (http://docs.moodle.org/dev/Portfolio_API)
48
* course completion tracking support
Petr Skoda's avatar
Petr Skoda committed
49
50
* new navigation features
* new comments API
51
  (http://docs.moodle.org/dev/Comments_2.0)
Petr Skoda's avatar
Petr Skoda committed
52
* new ratings API
53
  (http://docs.moodle.org/dev/Ratings_2.0)
54

55
56
57
58
59

=== 2.2 ===

required changes in code:
* fix missing parameter types in optional_param() and required_param()
60
61
* use new optional_param_array(), required_param_array() or clean_param_array() when dealing with array parameters
* textlib->asort() replaced by specialized collatorlib::asort()
62
* use new make_temp_directory() and make_cache_directory()