MDL-36754 tests: Move moodle_url tests to own file
[moodle.git] / blocks / upgrade.txt
blob7ef8f0abd0c56597756b74afa99941fc5e0e1700
1 This files describes API changes in /blocks/* - activity modules,
2 information provided here is intended especially for developers.
4 === 3.4 ===
6 * The block_instances table now contains fields timecreated and timemodified. If third-party code
7   creates or updates these rows (without using the standard API), it should be modified to set
8   these fields as appropriate.
9 * Blocks can now be included in Moodle global search, with some limitations (at present, the search
10   works only for blocks located directly on course pages or site home page). See the HTML block for
11   an example.
12 * Block block_messages is no longer a part of core.
14 === 3.3 ===
16 * block_manager::get_required_by_theme_block_types() is no longer static.
17 * The plugin block_course_overview has been removed from core and is being replaced by block_myoverview.
18   During the upgrade process the block_course_overview block will be uninstalled and all its settings will be deleted.
19   If you wish to keep the block_course_overview block and its settings, download it from moodle.org and put it back in
20   the blocks/ directory BEFORE UPGRADING.
22 === 3.1 ===
24 * The collapsed class was removed from the navigation block to make it compatible with aria.
25 * New aria attributes were added on the navigation block [aria-expanded="false"].
26 * The tree JS handling were moved from YUI to AMD module (Jquery).
28 === 2.9 ===
30 * The obsolete method preferred_width() was removed (it was not doing anything)
31 * Deprecated block_base::config_save as is not called anywhere and should not be used.
32 * Added instance_copy() function to the block_base class. This function allows for block
33   specific data to be copied when a block is copied.
35 === 2.8 ===
37 * The instance_config_print() function was removed. It was deprecated in
38   Moodle 2.0, but without debugging notices. Since it was no longer a part
39   of the code path, debugging notices would not have been displayed.
40 * Deprecated functions were removed from the block_base class:
41 ** _print_block()
42 ** _print_shadow()
43 ** _title_html()
44 ** _add_edit_controls()
45 ** config_print()
47 === 2.6 ===
49 * Deprecated /admin/block.php was removed, make sure blocks are using settings.php instead.
51 === 2.4 ===
53 Created new capability 'blocks/xxx:myaddinstance' that determines whether a user can add
54 a specific block to their My Home page. This capability was only defined for blocks where
55 the applicable_formats function does not include "'my' => false" in the returned array,
56 allowing it be added to the My Home page.
58 === 2.3 ===
60 required changes in code:
61 * block_xxx_pluginfile() is now given the 7th parameter (hopefully the last one) that
62   contains additional options for the file serving. The array should be re-passed
63   to send_stored_file().
65 === 2.0 ===
67 required changes in code:
68 * use new DML syntax everywhere
69 * use new DDL syntax in db/upgrade.php
70 * replace defaults.php by settings.php and db/install.php
71 * replace STATEMENTS section in db/install.xml by db/install.php
72 * move post instalation code from install() method into db/install.php
73 * completely rewrite file handling
74 * rewrite backup/restore
75 * theme changes: move plugin styles into blocks/xxx/styles.css and use new css markers for images,
76                  move all images into new blocks/xxx/pix/ directory and use new outputlib api
77                  old global $THEME is fully replaced by $OUTPUT
78 * remove '_utf8' from language pack names, use new {$a} syntax in language packs
79 * use 'pluginname' lang pack identifier instead of 'blockname'
80 * move cron and version number into standard version.php
81 * removed support for old config_global.html, use settings.php