Other: Navigation buttons

Maintained by Davo Davo Smith
Add customisable navigation buttons (next/prev/etc.) to the bottom of each activity page (Moodle 1.9/2.0+)
346 sites
15 fans
Moodle 2.2, 2.3, 2.4, 2.5, 2.6, 2.7, 2.8, 2.9, 3.0, 3.1, 3.2, 3.3

Navigation buttons (for Moodle 1.9 / 2.0+)
This block adds customisable navigation buttons (first/previous/next/etc.) to the bottom of each activity/resource page in a course.

It is based on an idea from Penny Mondani: http://pennymondani.com
Thanks also to the US company that sponsored the development, who wish to remain anonymous.


  1. Download the file and unzip it somewhere convenient.
  2. On your server, in the 'blocks' folder, create a subfolder called 'navbuttons'
  3. Upload all the files inside the 'davosmith-moodle-navbuttons-???????' folder to this new 'navbuttons' folder on your server.
  4. Log in to your Moodle site as an administrator and click on the 'Notifications' option in the Admin settings block.
  5. You need to make a small change to one Moodle core file to make this work (the change is different between Moodle 1.9 & Moodle 2.0 - see the included README.txt for details).
  6. Add the block to a course (turn editing on, select 'Navigation Buttons' from the 'Blocks - Add' menu)
  7. Customise the button appearance by clicking on 'Edit the Navigation Button settings' in the newly created block.
  8. Check the message at the bottom of the screen (under the 'Save changes' button) - it should read "Navbuttons self-test: required core modifications have been completed successfully". If not, then go back to step 5 above and check carefully.

Note: The block is only visible to users who are able to edit courses modules. Deleting the block will remove the navigation buttons (they can also be disabled through the settings).

For a quick demo, there is a screencast available here:


Screenshot #0


Davo Smith (Lead maintainer)
Please login to view contributors details and/or to contact them

Comments RSS

Show comments
  • Davo
    Tue, 28 Feb 2017, 1:19 AM
    Hi Ishani,

    I've not re-checked recently, but I am not aware of any hook that would avoid the core change (otherwise I would have used it, instead of the core change).

    If you have a custom theme, you could make a change there, instead of in outputrenderers.php
  • Picture of Sarah Fahlesson
    Wed, 1 Mar 2017, 4:22 PM
    Is there a way to get the button to update when a requirement has been met? Currently we have modules that are not accessible until the student has passed a quiz on the previous module.

    The student enters a module. The next button does not point to the next module since they don't yet have access to it. Instead the next button skips the module. (We'd ideally like an option to just gray out the next button so that the student knows that they need to accomplish something before moving on).

    Once the student has passed the quiz in the scorm module, we would ideally like the button to update. Now the student has met the requirements for the next module, but the 'next' button still skips the next module since it was created when the module was not available.

    Are there any settings that fix this that I'm missing?
  • Davo
    Wed, 1 Mar 2017, 4:45 PM
    Sarah - there's certainly not any built-in functionality to do what you are asking. The option to disable the next button if the next activity is unavailable might be possible to implement (but it would need to be an option, as other sites might use availability settings to provide different students with different resources - so having the navigation stop just because the next activity is unavailable would be undesirable).

    For the other part, making the next button detect that the next activity was not available, the only way I can think of working that would be to have each of the buttons call a special re-routing script that would take the current activity and then work out the next activity to go to at the point where the button was clicked - but that would have the problem that I wouldn't ever be able to remove the next / previous buttons when I didn't think there was a next / previous activity to go to.

    Anyway, either of these will require extra development, something I'm can discuss if you have a budget for me to undertake during my day job, but which is unlikely to be done in my spare time.
  • Picture of Marcel Saraiva
    Thu, 9 Mar 2017, 2:44 AM
    Hi Davo,

    I have been trying to install the navigator plugin in moodle 3.1, but when I tried to install this, the activity_modules and activity_results is missing in disk. And the plugin don't installed.

    Check this error message:

    The plugin "block_activity_results" is mistakenly installed in "$CFG->dirroot/blocks/navbuttons", The correct location is "$CFG->dirroot/blocks/activity_results"

    Debug info:
    Error code: detectedmisplacedplugin

    Stack trace:
    line 812 of /lib/upgradelib.php: plugin_misplaced_exception thrown
    line 429 of /lib/upgradelib.php: call to upgrade_plugins_blocks()
    line 1641 of /lib/upgradelib.php: call to upgrade_plugins()
    line 677 of /admin/index.php: call to upgrade_noncore()

    Can you help me about this problem?

    Thank you!
  • Picture of Abdul Ghaffar
    Tue, 16 May 2017, 3:41 PM
    I am unable install/download latest version 2.2+ (Build: 2017051200) for moodle 3.2.3. .zip contains another zip, and that contain 1st zip. Please fix this issue.
  • Davo
    Tue, 16 May 2017, 3:43 PM
    Not sure what has happened - I've pulled the code in as usual from github. You can still download it yourself directly via the 'source control url' link. I'll try importing it again.
  • Picture of Daniel Miller
    Fri, 19 May 2017, 12:23 AM
    Hi, as I write the latest available version appears to be an empty zip file.
  • Davo
    Fri, 19 May 2017, 2:36 AM
    Hi Daniel - thanks for letting me know. I don't know what is going on, as I've been importing it from github as usual, so I don't know why it hasn't worked this time. I've re-uploaded it and double-checked that it has worked this time.
  • Picture of Daniel Miller
    Tue, 6 Jun 2017, 10:58 PM
    Hi Davo, I'm no expert on how the Moodle systems work but I notice that the folder in your archive is called davosmith-moodle-navbuttons-eb00d1e where I think it would be more normal for it to be called navbuttons. I hope this helps.
  • Davo
    Tue, 6 Jun 2017, 11:01 PM
    This is because the plugin has been categorised as 'other' instead of 'block' (due to the required small core change). The import process does not work properly due to this categorisation - there isn't anything I can do to fix this (other than to manually upload the zip file, instead of importing from github).
  • Picture of Thomas Weiland
    Tue, 25 Jul 2017, 9:22 PM
    Plugin works great and looks fine. But is it possible to enable it for using in the iOS-App in any way? The buttons are not visible there.
  • Davo
    Tue, 25 Jul 2017, 9:24 PM
    I don't know any way it could be made to work with the iOS app, without rewriting the app itself.
  • Picture of julie mcloughlin
    Tue, 22 Aug 2017, 1:16 PM
    Re: nav button plug in
    by Dani Palou - Monday, 21 August 2017, 7:18 PM

    the app only supports core features of Moodle. We created a remote addon feature to support 3rd party plugins. The plugin maintainers should be the ones to create this remote addon and include it in the plugin.
    However, please notice that the app doesn't support blocks. If the plugin you're mentioning is a block, it will be quite hard to make it work using a remote addon. We're still studying how can we support blocks in the app, so we won't support them in the short term.
    Kind regards,
    Show parent | Reply
    See this post in context

  • Picture of Derick Turner
    Thu, 31 Aug 2017, 7:31 PM
    The current 3.3 version of this plugin unzips to a directory called davosmith-moodle-navbuttons-c0aff46 and not, as I would imagine, navbuttons. I renamed the directory and it installed fine afterwards.
  • Davo
    Fri, 1 Sep 2017, 1:13 AM
    Derick, please scroll up slightly and read the answer I already gave to this on 6th June
1 2 3 4 5 6
Please login to post comments