Skip to content

[docs] Next/Previous activity navigation API - #1662

Merged
aanabit merged 1 commit into
moodle:mainfrom
sarjona:nextprevnav
Jul 29, 2026
Merged

[docs] Next/Previous activity navigation API#1662
aanabit merged 1 commit into
moodle:mainfrom
sarjona:nextprevnav

Conversation

@sarjona

@sarjona sarjona commented Jul 29, 2026

Copy link
Copy Markdown
Member

Document how the "Previous" and "Next" controls resolve their target, which activities are skipped (including modules without FEATURE_CAN_DISPLAY, MDL-88003), and how activity modules can override or suppress their navigation URL via cm_info::set_navigation_url().

Copilot AI review requested due to automatic review settings July 29, 2026 10:42
@netlify

netlify Bot commented Jul 29, 2026

Copy link
Copy Markdown

Deploy Preview for moodledevdocs ready!

Name Link
🔨 Latest commit 63ee730
🔍 Latest deploy log https://app.netlify.com/projects/moodledevdocs/deploys/6a69e11467e7fd00088969f5
😎 Deploy Preview https://deploy-preview-1662--moodledevdocs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR expands the Moodle developer documentation around linear navigation by documenting how the “Previous”/“Next” activity controls resolve destinations, what gets skipped, and how activity modules can override or suppress their navigation URL via \core_course\cm_info navigation URL APIs.

Changes:

  • Mention activity-module participation in linear navigation in the Moodle 5.3 developer update.
  • Add module-facing documentation for overriding/excluding the linear navigation URL via modname_cm_info_dynamic().
  • Add a dedicated “Next and previous activity navigation” section describing routing, skip rules, and override APIs.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File Description
docs/devupdate.md Adds a dev-update note about cm_info navigation URL APIs for linear navigation.
docs/apis/plugintypes/mod/visibility.md Documents how modules can override or null out the navigation URL (and links to the full rules).
docs/apis/plugintypes/format/linear_navigation.md Documents previous/next routing behavior, skip rules, and cm_info navigation URL override/reset APIs.

Comment thread docs/apis/plugintypes/mod/visibility.md Outdated
Comment thread docs/apis/plugintypes/format/linear_navigation.md
Document how the "Previous" and "Next" controls resolve their target,
which activities are skipped (including modules without
FEATURE_CAN_DISPLAY, MDL-88003), and how activity modules can override
or suppress their navigation URL via cm_info::set_navigation_url().
Comment thread docs/apis/plugintypes/mod/visibility.md Outdated
@sarjona
sarjona requested a review from aanabit July 29, 2026 11:22

@aanabit aanabit left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the changes, Sara.
The patch seems OK to me now and explains the important information devs should know about.

@aanabit
aanabit added this pull request to the merge queue Jul 29, 2026
Merged via the queue into moodle:main with commit da8915b Jul 29, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants