Course formats: Buttons

Maintained by Picture of Rodrigo Brandão Rodrigo Brandão
Buttons is a course format that creates a menu with buttons to access the sections, one by one. Please favourite ♥!
2392 sites
109 fans
Moodle 2.8, 2.9, 3.0, 3.1, 3.2, 3.3, 3.4, 3.5


Buttons is a course format that creates a menu with buttons to access the sections, one by one.

. . . developed with love


* Create groups of sections, to separate topics in modules or periods;
* Create names to the groups to identify them. (Example: First Semester, Topics about a specific theme);
* Change the colors of the buttons (when active, inactive, on over and hidden), to fit it your Moodle theme;
* Define the list-style between numbers, alphabet or roman numeral;
* Define the button's shape between squares or circles.


* For recent Moodle versions, you can install this plugin automatically from the Moodle plugins database.

Manual installation

1. You can manually download the zip file from the Moodle Plugins Database.
2. After downloading the zip file, expand it and put it's contents in your .../moodle/course/format/ directory.
3. The folder name must be 'buttons'.
4. Go to 'Admin ► Site administration ► Notifications' page.
5. Follow the instructions inside the page to finish the installation.


1. When creating a new course, select 'Buttons format' in the 'Course format' dropdown menu.
2. To select the format, simply choose it from the list of course formats in the course settings.
3. Choose the number of sections, or leave the default of 10 sections.
4. Choose where you want the first (zero) section (which has the default 'Announcements' forum) positioned: Either 'Above the list buttons' or 'Below the visible section'.
5. Select the sequential rule. You can uses the count original of the topics, or chose to reset the count to each new grouping.
6. Select the list-style in numbers, alphabet or roman numeral.
7. Write the titles for all the groupings you will use and the number of sections that each one will have. If a group has only one section, the icon will be (...).
8. Write the hexadecimal color for the current section button and the visible section button, or leave it empty to use the default value.


Click here to open the full documentation


Screenshot #0
Screenshot #1
Screenshot #2
Screenshot #3
Screenshot #4
Screenshot #5
Screenshot #6
Screenshot #7
Screenshot #8
Screenshot #9


Picture of Rodrigo Brandão
Rodrigo Brandão (Lead maintainer)
Please login to view contributors details and/or to contact them

Comments RSS

Show comments
  • Picture of Elton LaClare
    Fri, 6 Oct 2017, 3:09 PM
    I really like this course format! It's a shame it doesn't work on the Moodle Mobile app. At the moment, the app development team is considering adding support for course formats. If you'd like to see Buttons and other course formats in the app, consider voting for this issue in the tracker MOBILE-1551.
  • Picture of Dan Jeffries
    Tue, 12 Dec 2017, 12:20 AM
    Loving this Course Format but we are having issues with displaying embedded content on each Button (it doesn't show). We use H5P a lot and we either have to resize the page or refresh the page to view.

    Have added Bug to GitHub. Any advice appreciated!

  • Picture of Adriane Cônsolo
    Tue, 12 Dec 2017, 2:53 AM
    Hi Rodrigo,
    I always use this plugin and like it so much. But I had to update Moodle to 3.4 version and the new menu (boost) does not work with the button.
  • Picture of marisol castro
    Tue, 19 Dec 2017, 1:54 AM
    Hello Rodrigo!

    I also just installed your plugin and am getting the following error. We are running Moodle 3.3 on IIS8 with PHP5.6.

    pix_url is deprecated. Use image_url for images and pix_icon for icons.•line 267 of \lib\outputrenderers.php: call to debugging()
    •line 283 of \course\format\buttons\renderer.php: call to renderer_base->pix_url()
    •line 343 of \course\format\buttons\renderer.php: call to format_buttons_renderer->section_header()
    •line 48 of \course\format\buttons\format.php: call to format_buttons_renderer->print_multiple_section_page()
    •line 280 of \course\view.php: call to require()
  • Picture of Adriane Cônsolo
    Sat, 13 Jan 2018, 12:08 AM
    Hello Rodrigo,
    When I activated the plugin and edit the topics at course home page one error is occorring, a pop-up is showed with the error: inplaceeditableerror
    Is someone had the same problem?
  • Picture of Dan Jeffries
    Thu, 18 Jan 2018, 11:12 PM
    Hi Rodrigo

    I added my issue to Github re embedded content - was just wondering if there's any progress or potential to fix this, as it's really inhibiting us using this great course format.

    Hope you can help!
  • Picture of Javier Flaqué
    Wed, 7 Feb 2018, 4:56 PM
    Olá Rodrigo.

    Fantastic format!!

    How can I put more than two colors on the buttons? How in this image

    Muito Obrigado!
  • Picture of Matthias Giger
    Thu, 22 Feb 2018, 11:10 PM
    Build: 2018022100 throws an error when you try to edit a course with the Buttons format under Moodle 3.1.10 (Build: 20180115) and the Clean theme. Before the update everything worked fine. With Moodle 3.4 (Build: 20171113) it works fine.
  • Picture of Rodrigo Brandão
    Fri, 23 Feb 2018, 12:36 AM
    Build: 2018022200 released!
    - Fixes issue that occurred in Moodles version 3.2.x, 3.1.x and 3.0.x
  • Wazza
    Wed, 11 Apr 2018, 4:10 PM
    If a section is hidden, the button turns grey. I can not click it to go to that hidden section (even as admin). Is this correct behavior? And how do i get to the hidden section without tuning editing on every time?
  • Picture of Patrick de Nobrega
    Tue, 24 Apr 2018, 8:52 PM
    Hi Rodrigo,

    Great plugin!

    I would like to know if it is possible to do the following customizations to your plugin:

    1) Can we adjust the positioning of the buttons panel?
    2) Can we add text/names/course sections into the button instead of numbers?
    3) Is it possible to change the layout and alignment of buttons?

    thanks so much.
  • Picture of Lionel POUJET
    Wed, 6 Jun 2018, 6:12 PM
    Great ! Thanks a lot !
  • Picture of Andreas Panagiotopoulos
    Mon, 2 Jul 2018, 4:43 PM
    Is there any README file where the changes of the versions are described?

    Thank you!
  • Ricardo Caiado
    Tue, 27 Nov 2018, 2:50 AM
    Please, can you add moodle auto-updater to this plugin? We update moodle every
    week and have to find the plugin when the others all do it automatically. It
    would save so much time, thank you.
  • Picture of Iroshini Ratnapala
    Tue, 4 Dec 2018, 11:56 AM
    I really like this course format. Is there any options to change the number of groups? maximum of six is available
1 2 3

Commenting temporarily disabled