Note:

If you want to create a new page for developers, you should create it on the Moodle Developer Resource site.

Page structure and types: Difference between revisions

From MoodleDocs
Line 19: Line 19:
=== Main content area ===
=== Main content area ===


In addition to the actual content of the page, this area can contain [[Blocks|blocks]] in the left and right columns.  
In addition to the actual content of the page, this area can contain [[Blocks|blocks]] in the left and right columns.
 
The content of the page in the middle is controlled by the teacher.
* Teacher(s) can add and edit the actual content,
* The overall sequencing and organization of the content is controlled by the selected [[Course Format|Course Format]].


=== Footer ===
=== Footer ===

Revision as of 15:30, 8 August 2009

Moodle User Interface Guidelines > Page structure and types

Note: This page is a work-in-progress. Feedback and suggested improvements are welcome. Please join the discussion on moodle.org or use the page comments.

This is a guideline template for a Moodle Interface Guideline. Comments: developer forum thread


This page describes the structure of different types of Moodle pages, using the default theme 'standard' as an example. Much of what is described here can be changed in a custom theme (See also).

Basic page structure

Image 1: Basic page structure

Most Moodle pages are divided in four parts: Header, Navigation bar, Main content area and Footer.

Header

In addition to the main heading of the page, the header also has another area for content defined (right aligned in the above image). Depending on the page, the content of this area is either a navigation menu or the user login info.

Navigation bar

The navigation bar contains a breadcrumb menu. Additionally, it has an element (right aligned in the above image), the contents of which depend on the page and often on the permissions the user viewing the page has.

Main content area

In addition to the actual content of the page, this area can contain blocks in the left and right columns.

The content of the page in the middle is controlled by the teacher.

  • Teacher(s) can add and edit the actual content,
  • The overall sequencing and organization of the content is controlled by the selected Course Format.

Footer

The footer contains a link to the documentation wiki for the page in question, login info, and a link (with the appearance roughly of a button) to go higher up in the hierarchy of the Moodle site.

Page types

NOT FINAL TEXT, in progress.

TODO: Think about if a page type specific visual hierarchy could be devised?

TODO: This should correspond to Migrating_your_code_to_the_2.0_rendering_API#You_can_have_different_layout.php_files_for_different_page. Actually, the page types of a hig should describe the different page types that offer differing kinds of interaction. The relationship between a technical page type to the interaction page types is probably N to 1.

* Editing page
* Site configuration page
* Module configuration page (Update this xxx)
* Organizing page
* Teacher content page
* Application/module functionality page
* Course page
* Data listing page
* Student content page
* Content accumulating page (views to forums posts)
Hm, on some pages several of these many may apply?

Who controls what?

(TODO: Perhaps move this section to moodle site structure or on a page of its own?)

Teachers

As a metaphor from physical education world, a course is an independent playground for a teacher. This is where they communicate to students the essence of the course.

The means for teachers to do this in Moodle are:

  • in the center column of the content area (course index, containing mostly links to activity modules), and
  • in the side columnd (blocks and course-specific features such as the question bank, grades, and course-specific roles).

The goals teachers have doing this, i.e. what it means to communicate a course's essence:

  • Communicate what is expected of students
  • Communicate the overall contents of the course (curriculum)
  • The course itself: Give means/tools for students to learn (as described by social constructionism)

Students

Interact mainly with the activity modules placed in a course by a teacher.

See also