Themes ::: theme_essential
Maintained by Gareth J BarnardGareth J Barnard
Essential is a clean and customizable theme. Essential is tested and tried by thousands of users, and ranks number one by site usage for all available third party themes.

Essential (Build: 2017040309)

Moodle 3.3
Released: Saturday, December 1, 2018, 1:50 AM
New in
- FIX: Block editing menu item hover.
- FIX: Update frontpage home block area information.
- FIX: LTI tool icon issue, see:
- FIX: coursetitleposition string typo.
- FIX: Position of quiz correction icons.
- FIX: Issue #865: Login box centred instructions.
- FIX: Issue #876: Context menu in header near top right empty and showing for non-logged in users and students.
- FIX: Issue #882: badgesmi setting missing in settings.php.
- NEW: H5P Custom CSS setting in 'Features' for the H5P module ( if installed.
- NEW: Added a tally to the 'Course search' on the dashboard. Thanks to "Linnaeus University" for funding this
- NEW: Added the ability for the administrator to disable the 'Search all course content' checkbox user preference.
Thanks to "Linnaeus University" for funding this enhancement.
- NEW: Added the ability to show / hide all of the items on the user menu bar 'log out'.
- NEW: Issue #867: Skip links for footer blocks sometimes appear over main course page content.
- NEW: Issue #883: embed-responsive bootstrap class not supported?
- NEW: Issue #884: Removed important font size declarations from responsive.less. Thanks to Mike Nodding for the patch.

New in
- NEW: Privacy API support. Analytics removed until such a time as their use with GDPR is clearer.
- NEW: Added 'Search all course content' checkbox user preference to search all course content or only the course
title when performing a 'Course search' on the dashboard. Thanks to "Linnaeus University" for funding this

New in
- Possible FIX: Issue #853: Possible solution for "Site logo needs textual description for accessibility".
- FIX: Issue #856: Undefined property: stdClass::$numsections.
- FIX: Issue #857: Display glitch with docked blocks.
- FIX: Issue #859: Gradebook icons not red or green.
- FIX: Issue #860: Rendering problem in quiz form.
- FIX: Issue #862: Missing folder icon in courses list since commit 77abc460.
- FIX: Alert close icon in alternative colour schemes.
- FIX: Improved course content search so that will work with $CFG->themedir.

New in
- FIX: Issue #836: Secure layout broken.
- FIX: Issue #844: While adding images with floating submit buttons.
- FIX: Issue #846: Group edit form layout.
- FIX: Block show / hide icons.

New in
- FIX: Side pre block text colour when 'linkadmincategories' is unticked.
- FIX: Above setting for 'coursetitleposition' does not work on 'incourse' / two column content pages.
- FIX: Issue #842: Would it be possible to change a private to a protected?
- FIX: Issue #843: Add an activity or resource popup display.
- NEW: Quiz 'Submit all and finish' text and background with hover settings.

New in
- NEW: Stable version.

New in
- FIX: No transparency between flat navigation list groups.
- FIX: Required field icon.
- NEW: Course title position feature setting.
- NEW: Side pre block background, text, link and link hover settings.

New in
- FIX: Issue #828: div id# completionprogressid has z-index.
- FIX: Issue #830: Course page hides blocks in Flat Navigation and editing off.
- FIX: Issue #831: User tour with backdrop alignment off - partial.
- FIX: Issue #833: Help icons open a new tab.
- FIX: Issue #835: Display fake blocks before Flat Navigation.
- FIX: Issue #838: Icons missing and/or out of alignment on certain pages.
- FIX: Position of completion icons and spacer when editing.
- FIX: Action menu overlapping navbar.
- FIX: Position of group icons, completion icons and spacer when editing.
- FIX: Reduce navbar icons jumping when old navbar position.
- FIX: Table hover icon colour.
- NEW: Issue #832: Use Core Notification and Messages menus.

New in
- FIX: Issue #824: Header area/slide show/bullet-menu "on top".
- FIX: Issue #825: Missing region_main_settings_menu() when using flat navigation.
- FIX: Issue #827: Flat navigation does not show if blocks were previously docked.
- FIX: Double section summary editing cog.
- NEW: Update to flat navigation to be more similar to Boost markup. Initially for the Grid format.

New in
- NEW: Initial 'Alpha' version for Moodle 3.3.
- NEW: Exclude CSS that has already been linted in the LESS and would cause errors as minified.
- NEW: Add flat navigation option and context header settings menu on the navbar.
- FIX: Issue #821: Marketing spots no longer responsive for mobiles.
- FIX: Implement MDL-57769 - Remove 'numsections' from topics and weeks, allow teachers to create and delete sections as they are needed.
- IFO: Using Essential Font-awesome LESS and font files for easy update.

New in
- FIX: Issue #817: Incorrect header closing tags in header title area.
- FIX: Issue #818: Fix Apple touch icon.
- FIX: Issue #819: Site summary in the header: element div not allowed as child of element h2 in this context.
- FIX: Font-awesome icon for the recycle bin.
- FIX: Font-awesome icon for the repositories.
- FIX: MyCourses default icon.
- FIX: Font-awesome users icon.
- FIX: Duplicate socialheading id and redundant profileheading id.
- NEW: Issue #622: Custom category icon images. Gratefully funded by Gemma Lesterhuis.

New in - First stable version.
- FIX: Issue #812: Add icon replacements for t/message and t/addcontact. Thanks to Jan Dageförde ( for this fix.
- FIX: Stray end tag in grading_navigation.mustache - MDL-58155.
- FIX: Navbar z-index for the Grid format in M3.2.
- FIX: Minimum height for the containing area when there is a logo. This is so that when a calculated height is less than the value then the container is not so small for the social icons etc.

New in - Beta version.
- UPD: Core and plugin pix.
- UPD: TravisCI.
- UPD: Unread messages language string.
- UPD: For jQuery 3 needed to escape all '#'s and '"'s in the JS - ref:
- UPD: RTL LESS / CSS and see what can be removed as there is now a 'autoflipping' tool built in to Moodle.
- UPD: Removed 'essential.css' from production minification so that PHP-RTLCSS comments are preserved and can be processed.
- UPD: Improved logo to be responsive with different percentage widths for desktops and mobiles.
- FIX: Social and app icon position in RTL.
- FIX: Edit action menu icon hover background colour.
- NEW: Issue #810: Switch role to.

New in
- FIX: Issue #794: Hidden grade items in user report not clear as such.
- FIX: Issue #804: 'Hide default page editing button' hides anything that could be in that place.
- FIX: Issue #805: Suspended user odd rows.
- FIX: Alternative colour table odd row colour.
- FIX: RTL header dotted separator appearing twice.
- FIX: User image table even row background.
- FIX: Forum table user image link height.
- FIX: Environment table help icon spacing.
- NEW: User image border radius settings.

New in
- FIX: Issue #799: Message avatar overlap.
- FIX: Issue #802: My courses scroll not working.
- FIX: Issue #803: Embedded pdf files not displaying in IE 11.
- NEW: Properties.

New in
- FIX: Issue #798: Slider title needs to support multi-lang filter.
- FIX: Course category multi-lang, ref:
- NEW: Issue #734: Unable to disable the new "page top" block region.

New in
- FIX: Alternative colour scheme primary button text colour.
- NEW: Update to FontAwesome 4.7.0.
- NEW: Add 'Category and course sub-menu' functionality - 'mycoursescatsubmenu' 'Header' setting under 'Courses menu'. Sponsored by Petra Aartsen, Ontwikkelversneller.

New in
- REFIX: Issue #780: Certain grades not appearing in gradebook.

New in
- FIX: Issue #780: Certain grades not appearing in gradebook.
- FIX: Issue #788: Apply MDL-48350.
- FIX: Issue #789: Editing button in header not working in "modedit" pages.
- FIX: Blocks on tablets when one region is empty.
- NEW: Issue #778: Add a button to the front page to add alert settings. Sponsored by Chipping Campden School.

New in
- FIX: Issue #777: Re: Scroll in the drop down menus #773 - Custom menu sub-menus no longer accessible.
- FIX: Bootstrap override LESS not working.

New in
- REFIX: Issue #747: Profile picture in user profile missing.
- FIX: Issue #751: 3 block regions displaying in Edit mode for a 2-column layout.
- FIX: Issue #771: "Skip to main content" link is hidden by main fixed navbar.
- FIX: Issue #773: Scroll in the drop down menus.
- FIX: Issue #774: Participants List missing alternate user names - Alternative settings.
- FIX: Issue #776: Block editing labels can move.
- FIX: Row block and course category flex issues.
- FIX: Disabled elements in tables.
- FIX: MDL-56198 - Improve grading info responsiveness.
- REFIX: Action menu items for blocks when narrow page width.
- NEW: Issue #770: Create 'top-block' region with optionality setting.
- NEW: Issue #775: Only show dotted lines on regions when Drag and Drop.
- FIX/NEW: Improve footer.js and by doing so fix issue with popup layout.

New in
- NEW: First stable release for Moodle 3.1.

New in
- FIX: Issue #737: Rubric pop-out on assignment grading page doesn't use full height.
- FIX: Issue #740: Rubric in assignment view styling.
- FIX: Issue #746: Category icon tiles sometimes don't line up.
- FIX: Issue #747: Profile picture in user profile missing.
- FIX: Issue #748: "Page Top" blocks area, in edit mode, display blocks one under the other, in RTL mode.
- FIX: Issue #749: Course item action edit menu has redundant padding, in RTL mode.
- FIX: Issue #753: Accessibility: missing aria-label attribute in "back-to-top" element. Thanks to Nadav Kavalerchik.
- FIX: Issue #754: Accessibility: missing aria-label attribute in "prev"/"next" elements. Thanks to Nadav Kavalerchik.
- FIX: Issue #755: Accessibility: missing aria-label attribute in "socialicon" elements. Thanks to Nadav Kavalerchik.
- FIX: Issue #757: Custom icon colour doesn't seem to apply correctly to icons in drop-downs.
- FIX: Issue #762: Course fullname repeated above and below breadcrumbs.
- FIX: Issue #763: Custom EOT files don't work.
- FIX: Issue #765: Link font family is wrong.
- FIX: Issue #768: Display right arrow in dropdown-submenu.
- FIX: Breadcrumb style two fixes.
- FIX: Row block empty space.
- FIX: Frontpage RTL.
- FIX: Temporary patch until MDL-55185 is rectified in core.
- FIX: Action menu items.
- NEW: Issue #738: Fixes #736 add extra urlcolor for stripes.
- NEW: Issue #766: Login page background image. Gratefully funded by Gemma Lesterhuis.
- NEW: Improvements to 'essential_edit_button' for child themes.

New in
- FIX: Issue #320: Group editing icons do not update on click to reflect new group status.
- FIX: Issue #722: Assignment grading page lacking styling.
- FIX: Issue #724: Main content does not expand.
- FIX: Issue #726: New "page top" block region is not properly margined in RTL mode.
- FIX: Issue #727: MyDashboard layout not flipping in RTL.
- FIX: Issue #729: New "page top" block region looks weird, when adding a new module.
- FIX: Issue #731: Assignment overview options.
- FIX: Remove MyDashboard layout to avoid duplicated code.
- NEW: Issue #713: Grading page has no navigation.

New in
- FIX: Issue #710: Wrong profile image used.
- FIX: Issue #711: Space when blocks are docked.
- FIX: Issue #712: My Courses overflow.
- FIX: Issue #714: Enrol users page needs tidying up.
- FIX: Issue #715: Grading status page 'Grade' button and file submission line.
- FIX: Issue #716: Information alert close difficult to see.
- FIX: Issue #717: Notifications hover.
- FIX: Issue #718: Affix top offset height when reload down page.
- FIX: Issue #720: Block titles when editing and a page background are difficult to see.
- FIX: Issue #721: Notification template close inconsistent with alerts on frontpage.
- FIX: Table tidy up.

New in
- FIX: Issue #697: Floating gradebook headers do not account for navbar height.
- FIX: Issue #698: Accessibility: role=main-content ("Role must be one of the valid ARIA roles").
- FIX: Issue #699: Assignment grading toolbar missing.
- FIX: Issue #700: Header height - M3.1.
- FIX: Issue #702: Header title - Fullname and summary option - language span tags.
- FIX: Issue #703: Group images are not well displayed.
- FIX: Issue #704: Vertical space between the header title and header subtitle is to small.
- FIX: Issue #707: Marketing setting header.
- FIX: Two column layout in RTL - M3.1.
- FIX: Theme selector images not responsive.
- FIX: Fixed height header when no logo for header background image now that the navbar calculates height in the old position.
- FIX: Theme selector table odd rows text colour - M3.1.
- FIX: Hover on dialog close button when using an alternative colour scheme.
- FIX: Notification templates location and tidy up.
- FIX: Missing forum icons.
- FIX: Revert to default grey SVG icons.
- FIX: Navbar and menus LTR / RTL icons - M3.1.
- NEW: Issue #606: Allowing blocks placed at the top of the content column. Gratefully funded by: Servei de Recursos Educatius , Universitat Rovira i Virgili.
- NEW: Display block region names when editing.

New in
- FIX: Issue #684: Navigation block: English tree item icons should be right aligned in RTL mode.
- FIX: Issue #685: Blocks should be right aligned under content in admin page layout, on RTL mode.
- FIX: Issue #687: Dropdown menus don't stay open.
- FIX: Issue #688: FA block icons are not right aligned using Firefox, in RTL mode.
- FIX: Issue #690: Google fonts not working in quiz with Javascript Security.
- FIX: Issue #691: Cyrillic support for truncated return to section names. Fixed by Evgeny Logunow.
- FIX: Issue #692: Page background and 'beside' carousel text clash.
- FIX: Issue #693: Pixelated user picture.
- FIX: Issue #694: Folder state in blocks and icons.
- FIX: Issue #695: Large logo, old navbar position and affix.
- FIX: Issue #696: Double height navbar blocks content.
- FIX: Mod assign styles very tricky to override so exluding and including own changed copy despite potential maintenance issues.
- FIX: Button font.
- FIX: Content first three column layout in RTL.

New in
- FIX: Issue #681: Breadcrumbs should be right aligned in RTL mode.
- FIX: Issue #682: Category icons in M3.1.

New in
- FIX: SVG version of 'Cogs' for 'Settings' cog.
- FIX: Plugins check table text colour.
- FIX: Noticeboard format user picture.
- NEW: Competancies icon.

New in
- FIX: Issue #674: M31 beta: Breadcrumbs should be right aligned and flipped in RTL mode.
- FIX: Issue #675: M31 beta: Left align "return to course" button, in RTL mode.
- FIX: Issue #676: M31 beta: Tree nodes in Navigation block have no right margin, in RTL mode.
- FIX: Issue #677: M31b: Tree nodes on Navigation block have redundant 21px right padding, in RTL mode.
- FIX: Issue #678: Gradebook sticky headers broken, in RTL mode.
- FIX: Issue #679: Guest user menu show missing support email error.
- FIX: Issue #686: Two enrolments in a course with latest courses.
- FIX: User menu setting header.
- NEW: My courses options. Thanks to "Linnaeus University" for funding this enhancement.

New in
- FIX: Carousel slides in correct direction for RTL.
- NEW: Theme table stripe text and background colour settings.
- NEW: FontAwesome 4.6.3.

New in
- FIX: Cautionary inclusion of coursecatlib.
- FIX: Hidden courses / resources on the breadcrumb. Ref:

New in
- FIX: Integer setting default and validation.
- FIX: Select setting default.
- FIX: Invisible parent categories with an image for a course that is in a visible category with no image.
- FIX: Ensure radio button default is set on first use.

New in
- FIX: MDL-52800 - RTL styling for in place editable tooltip.
- FIX: MDL-52815 - Groups and members dropdowns overlapping on mobile devices.
- FIX: MDL-53855 - Navbar should be in exactly one nav region, and that should be labelled.
- FIX: Issue #659: Links with anchors don't work with the "flexsections" course format. Thanks to Jay Knight for his input.
- FIX: Issue #662: Site pages indent.
- FIX: Issue #664: Broken Alt-text in blocks.
- FIX: Issue #668: Course page header missing enrolled user info.
- NEW: Tidy up administration block.
- NEW: Category and course 'course title' images. Thanks to Murdoch University, Perth, WA for supporting this enhancement.

New in
- FIX: Issue #642: Advanced Grading creating template form issue.
- FIX: Issue #649: Guest access confusing.
- FIX: Issue #653: Quiz question preview: does not uses the selected color scheme.
- FIX: Issue #654: Adding a quiz question menu does not use the selected colour scheme.
- FIX: Font serving instructions. See:
- FIX: Invalid CSS attribute value in carousel.less.
- FIX: Footer position when using docking and footer is not at the bottom.
- FIX: MDL-53489 - Quiz editing: if you put in a very long heading, the page layout breaks.
- FIX: Improve logo setting description.
- FIX: Missing '$setting->set_updatedcallback('theme_reset_all_caches');' on logo width setting.
- FIX/NEW: Issue #646: Implement MDL-53147 from M3.1 - 'Reading message screen broken when reading one message and have another unread'.
- NEW: Issue #647: Navigation bar in course: without course category links. Thanks to Christian Niemczik for supporting and funding the work on the Essential Theme.
- NEW: Issue #652: Header logo and background refinements.
- NEW: Have the 'This course' menu appear on other course related pages.
- NEW: Tidy up licenses.
- NEW: Tidy up Font Awesome CSS as WOFF2 support was only an issue in M2.8.
- NEW: Logo dimension validation.
- NEW: Update to FontAwesome 4.6.1.
- NEW: Add 'usesiteicon' setting to allow the site icon not to be shown if desired.
- NEW: Add radio button selection for breadcrumb style.
- NEW: Add image and direction capability to radio button selection for breadcrumb style.
- NEW: Add radio button image selection for 'oldnavbar' setting.
- NEW: Add radio button image selection for 'slidecaptionoptions' setting.

New in
- FIX: Issue #351: Footer doesn't stay at bottom.
- FIX: Issue #627: Request for an unknown renderer.
- FIX: Issue #628: Course content search dialog does not show up properly on RTL mode.
- FIX: Issue #629: Hidden resources have low contrast.
- FIX: Issue #633: Increase performance of administration settings pages. Thanks to 'Jan Dagefoerde' for the initial patch.
- FIX: Issue #634: Improve icon replacement performance.
- FIX: Issue #635: Course table of contents block navigation when static navbar.
- FIX: Issue #640: Edit profile style not set properly.
- FIX: Issue #641: Floating rows in the gradebook position after page scroll are wrong.
- FIX: Issue #642: Advanced Grading creating template form issue.
- FIX: Issue #643: Grading edit dropdown too small.
- FIX: Style guide settings tooltips and popups.
- FIX: MDL-52936 - Fix link hover bug on iOS.
- FIX: Apply 'aria-hidden="true"' to FontAwesome icons as much as possible. Still a few 'content' CSS attributes to consider.
- FIX: Add 'speak: none' to FontAwesome icons for accessibility.
- FIX: Footer doesn't stay at bottom code fix when no footer.
- FIX: Alternative colour border colours.
- FIX: Narrow page width and page header.
- FIX: Tidy the header.
- FIX: Admin submit button hover on alternative colour schemes.
- FIX: Dimmed icon colours.
- FIX: Hidden course summary box colours to be dimmed.
- NEW: Issue #632: View StyleGuide without logging on.
- NEW: Issue #645: Add setting to toggle display of hidden courses in Custom Menu. Thanks to Mathieu Pelletier for this code.
- NEW: Improve efficiency of colour switcher.
- NEW: Add logo width setting.
- NEW: Hide title area when showing social icons when collapsed.
- NEW: Bigger user picture when using the old navbar position and at the top.
- NEW: Refactor ColoursSwitcher into jQuery and optimise.

New in 3.0.1
- FIX: Issue #623: label is inline.
- FIX: Issue #625: .btn-link class needs settings.
- FIX: Coursebox tidy up.
- FIX: Primary button hover.
- FIX: Bootstrap button styling.
- FIX: TravisCI issues.
- FIX: Ensure that the editor gets the custom font-face declarations.
- FIX: Disabled and active button styling.
- FIX: MDL-52371 - Activity Chooser - alignment of strings that need line wrap.
- NEW: Style guide settings page.

New in
- FIX: Issue #614: Dashboard -> Site administration -> Appearance -> HTML settings overflow with fixed width set at normal.
- FIX: Issue #615: Block login on frontpage.
- FIX: Issue #616: TinyMCE font family setting overridden by theme.
- FIX: Issue #617: What is the 'message-index' layout?
- FIX: Issue #618: Gradebook links are displayed when reports cannot be viewed. Thanks to Tony Butler for the patch #619.
- FIX: Issue #620: 'alternativethemedefaultbuttonbackgroundhovercolourX' setting name too long for 'name' attribute in 'config_plugins' table.
- FIX: Issue #621: Cloze question input box width when taking quiz but not preview.
- FIX: Editor colours.
- FIX: Duplicate line in 'Return to section....'.
- FIX: Input focus colour.
- FIX: TravisCI Code Checker complaints.
- FIX: MDL-52249 - Nested navigation dropdowns don't work on small screens - M3.0 only.
- FIX: MDL-52342 - Hiding section adds gaps to the activity chooser.
- FIX: MDL-52879 - Unable to delete last (only) question in a quiz.
- FIX: Question text width on 1200px+ resolutions when editing a quiz.
- FIX: Changes for Grid format issue #24.
- NEW: Issue #613: Section names on 'Return to section X'. Grateful thanks to 'Mihai Bojonca, TCM International Institute, Inc.' for funding this enhancement.
- NEW: Inspector Scourer.
- NEW: 'Return to section....' feature setting.
- NEW: Features settings page to tidy things up a bit.

New in
- FIX: Issue #609: Block Editing button on Plugin overview pagechanges colour on hover.
- FIX: Filemanager link colour.

New in
- FIX: Issue #599: .gitattributes: missing *.gif binary line - thanks to Jordi Pujol-Ahulló.
- FIX: Issue #602:

Version information

Version build number
Version release name (Build: 2017040309)
Can be updated from (Build: 2017040308) (2017040308)
Stable version
MD5 Sum
Supported software
Moodle 3.3
  • Latest release for Moodle 3.3

Version control information

Version control system (VCS)
VCS repository URL
VCS branch
VCS tag

Default installation instructions for plugins of the type Themes

  1. Make sure you have all the required versions.
  2. Download and unpack the module.
  3. Place the folder (e.g. "ponies") in the "theme" subdirectory.
  4. Visit to finish the installation