Address Bar

Revision as of 13:52, 12 August 2009 by Olli Savolainen (talk | contribs) (Guidelines)

Jump to: navigation, search

Moodle User Interface Guidelines > Address Bar

On the web, URLs are a part of the user interface and some users routinely use the address bar to navigate sites (for example, for getting higher in the hierarchy if they don't find an easier way in the site navigation).

In Moodle, The form of URLs is determined by a motivation to make work easy for developers, which is important in an open source community to make it easy to edit different parts of Moodle. Usually it is enough to just look at the URL to know which PHP file to edit.

As a consequence, the site hierarchy is not replected in the URL - the end user is not considered the primary user of URLs, unlike usually recommended.

Examples

  • Course front pages are at moodlesite/course/view.php?id=2
  • Regardless of the course an activity module instance, such as a forum belongs to, it's URL is moodlesite/mod/forum/view.php?id=13

Guidelines

  1. URLs should be as short as possible.
  2. No underscores in parameter names or files names
  3. Never use two words when one would do.

Activity modules

  • index.php - lists all instances for that module in a course
  • view.php - displays a particular instance
  • config.html - configure an instance of the module

Blocks

  • config.html - configure an instance of the block