mod/upgrade.txt

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