theme/upgrade.txt

   1 This files describes API changes in /theme/* themes,
   2 information provided here is intended especially for theme designer.
   3
   4 === 2.6 ===
   5 * re-wrote the table for the course completion status block to use html_table - added some CSS classes to the table in the process.
   6   MDL-35608 - Blocks - Updating the Completion Status block to use HTML Writer
   7
   8
   9 === 2.5 ===
  10
  11 required changes:
  12 * Functions core_course_renderer::course_category_tree() and course_category_tree_category()
  13   are deprecated
  14 * Significant changes in rendering of courses and categories listings, lots of CSS classes changed,
  15   several functions such as print_courses(), print_whole_category_list(), print_category_info()
  16   are moved to course renderer.
  17   See http://docs.moodle.org/dev/Courses_lists_upgrade_to_2.5
  18
  19 DOM changes:
  20 * changed the h1 title in the help popup to a h2.
  21 * new setting $THEME->yuicssmodules = array('cssreset', 'cssfonts', 'cssgrids', 'cssbase'); which
  22   allows themes to use different CSS reset normalisers such as cssnormalize YUI module
  23 * Re-wrote the user profile views to definition lists.
  24 * Cancel buttons have the class btn-cancel.
  25
  26 Renderer changes:
  27 * Mymobile theme changed to support more verbose move-block-here descriptions.
  28
  29 === 2.4 ===
  30
  31 required changes:
  32 * output course and course content header/footer that may be returned by course format (see MDL-36048)
  33 * span.completionprogress has been changed to a <div> and is not a float by default any more.
  34
  35 deprecation:
  36 * i/roles: Use t/assignroles instead
  37 * t/manual_item: Use i/manual_item instead
  38 * t/unlock_gray: Use t/locked instead
  39 * t/userblue: Previously used to unblock a user, use t/unblock.
  40 * c/course: Use i/courseevent instead
  41 * c/group: Use i/groupevent instead
  42 * c/site: Use i/siteevent instead
  43 * c/user: Use i/userevent instead
  44 * t/clear: Use t/check instead
  45 * i/cross_red_big: Use i/invalid or i/grade_incorrect
  46 * i/tick_green_big: Use i/valid or i/grade_correct
  47 * i/tick_amber_big: Use i/caution or i/grade_partiallycorrect
  48 * No more small versions of i/cross_red_small, i/tick_green_small and i/tick_amber_small, use their big equivalent.
  49 * t/addgreen: Use t/add instead.
  50 * i/approve: Use t/approve instead
  51
  52 optional changes:
  53 * new optional boolean parameter $withlinks for public function login_info() in lib/outputrenderers.php (MDL-31365)
  54 * new layout option "nologinlinks" and new page layout "secure" e.g. for safebrowser and securewindow (MDL-31365)
  55 * new class 'iconlarge' for 24x24 icons.
  56 * new icons i/export and i/import (sized 16x16). Previously export and import actions used i/backup and i/restore.
  57 * new icon i/assignroles (sized 16x16), to prevent the use of i/roles which is 12x12.
  58 * new icon i/switchrole (sized 16x16), was previously using i/roles. Now is a copy of the new i/assignroles icon.
  59 * new icons i/enrolusers and t/enrolusers, previsouly i/users was used.
  60 * new icon t/cohorts (sized 12x12), to prevent the use of i/cohorts which is 16x16.
  61 * new icons t/sort_asc, t/sort_desc to use for ordering in table headers.
  62 * new class 'iconsort' for icons used for ordering in table headers.
  63 * new icons t/locked and t/unlocked (12x12) which should be used when there is no action associated to the icon.
  64 * new icons i/folder (16x16), monochrome equivalent to f/folder.
  65 * new icons t/addcontact, t/removecontact and t/messages, previously t/addgreen, t/delete and t/log were used in messaging.
  66 * new icons t/unblock and i/twoway.
  67 * new icons i/courseevent, i/groupevent, i/siteevent and i/userevent (16x16) instead of c/* for calendar events.
  68 * new icon t/markasread (12x12) to replace t/clear used in forums.
  69 * new icon t/check (12x12) to replace t/clear which name does not reflect the icon meaning.
  70 * 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.
  71 * new icons i/valid, i/caution and i/invalid for generic statuses.
  72 * new icons i/grade_correct, i/grade_partiallycorrect and i/grade_incorrect for grades.
  73 * new icon t/approve (12x12).
  74 * new icon t/contextmenu (12x12) for a monochrome version of i/menu.
  75
  76 === 2.3 ===
  77
  78 optional changes:
  79 * add new u/f3.png image when theme contains customised f1 and f2 default user images
  80
  81 === 2.2 ===
  82
  83 required changes:
  84 * use new page content placeholder "echo $OUTPUT->main_content()" instead of "echo core_renderer::MAIN_CONTENT_TOKEN"
  85   see git commit: 3b3f302855d7621405a8b93e49bd399d67a998d7
  86 * upgrade report selectors: search for "-course-report-" and replace with "-report-"