MDL-36837 theme: Help icons aligned on the left are well positioned
[moodle.git] / theme / upgrade.txt
1 This files describes API changes in /theme/* themes,
2 information provided here is intended especially for theme designer.
4 === 2.4 ===
6 required changes:
7 * output course and course content header/footer that may be returned by course format (see MDL-36048)
8 * span.completionprogress has been changed to a <div> and is not a float by default any more.
10 deprecation:
11 * i/roles: Use t/assignroles instead
12 * t/manual_item: Use i/manual_item instead
13 * t/unlock_gray: Use t/locked instead
14 * t/userblue: Previously used to unblock a user, use t/unblock.
15 * c/course: Use i/courseevent instead
16 * c/group: Use i/groupevent instead
17 * c/site: Use i/siteevent instead
18 * c/user: Use i/userevent instead
19 * t/clear: Use t/check instead
21 optional changes:
22 * new optional boolean parameter $withlinks for public function login_info() in lib/outputrenderers.php (MDL-31365)
23 * new layout option "nologinlinks" and new page layout "secure" e.g. for safebrowser and securewindow (MDL-31365)
24 * new class 'iconlarge' for 24x24 icons.
25 * new icons i/export and i/import (sized 16x16). Previously export and import actions used i/backup and i/restore.
26 * new icon i/assignroles (sized 16x16), to prevent the use of i/roles which is 12x12.
27 * new icon i/switchrole (sized 16x16), was previously using i/roles. Now is a copy of the new i/assignroles icon.
28 * new icons i/enrolusers and t/enrolusers, previsouly i/users was used.
29 * new icon t/cohorts (sized 12x12), to prevent the use of i/cohorts which is 16x16.
30 * new icons t/sort_asc, t/sort_desc to use for ordering in table headers.
31 * new class 'iconsort' for icons used for ordering in table headers.
32 * new icons t/locked and t/unlocked (12x12) which should be used when there is no action associated to the icon.
33 * new icons i/folder (16x16), monochrome equivalent to f/folder.
34 * new icons t/addcontact, t/removecontact and t/messages, previously t/addgreen, t/delete and t/log were used in messaging.
35 * new icons t/unblock and i/twoway.
36 * new icons i/courseevent, i/groupevent, i/siteevent and i/userevent (16x16) instead of c/* for calendar events.
37 * new icon t/markasread (12x12) to replace t/clear used in forums.
38 * new icon t/check (12x12) to replace t/clear which name does not reflect the icon meaning.
39 * new classes 'icon-pre' and 'icon-post' supposedly to be used when the icon is positioned before or after the text. This is not really used yet, but it's a start towards some standardisation of the icon selectors.
41 === 2.3 ===
43 optional changes:
44 * add new u/f3.png image when theme contains customised f1 and f2 default user images
46 === 2.2 ===
48 required changes:
49 * use new page content placeholder "echo $OUTPUT->main_content()" instead of "echo core_renderer::MAIN_CONTENT_TOKEN"
50   see git commit: 3b3f302855d7621405a8b93e49bd399d67a998d7
51 * upgrade report selectors: search for "-course-report-" and replace with "-report-"