MoodleDocs - User contributions [en]

1.5 theme upgrade

2005-12-11T23:28:41Z

Pizdorvan:

{{Themes}}

In Moodle 1.5, a lot of work has been done to extend the CSS support to all parts of Moodle, and to remove any old hardcoded styles, such as fonts or colors, from the HTML code. As a result, Moodle themes are a lot more flexible and accessible, but this also means that custom themes written for Moodle 1.4 and earlier no longer work very well.

The best approach when upgrading is to reconstruct your theme again from scratch, borrowing graphics and styles from your old theme as necessary. This approach will result in a more robust theme that will survive future upgrades of Moodle.

The instructions below therefore apply whether you are upgrading or not.

== Upgrade or install Moodle 1.5 ==

Install Moodle 1.5 as normal. If you are upgrading, your old theme directory will remain, but the installation process will set the theme to the new default ''standardwhite''.

== Create a new theme directory ==

Themes are all stored in the ''theme'' directory of Moodle.

To create a new theme directory, make a copy of the ''standardwhite'' directory (or any other theme) and name it appropriately.

Inside this new directory you will see the following files.

:''config.php'' - edit this to change parameters for your theme
:''favicon.ico'' - the site icon that shows in the browser location bar or bookmarks
:''header.html'' - a fragment of HTML that defines the top of your pages
:''footer.html'' - a fragment of HTML that defines the bottom of your pages
:''gradients.css'' - an actual stylesheet containing styles to add to your theme
:''gradient.jpg'' - an image file, you can add as many as you want
:''styles.php'' - the actual script that Moodle calls, there is no need to change this

== Create a new CSS file ==

Your theme can have as many CSS files as you like. Create a new one, e.g. ''mystyles.css'', and include it in your theme by editing ''config.php'' and changing <code>$THEME->stylesheets</code>. You may remove ''gradients.css'' if you don't want it.

This new CSS file is where you will be adding styles that override ones from the standard stylesheet or set new ones.

While you're looking in ''config.php'', read through it to get an idea of the other things that you can do.

== Make your theme the active one ==

Choose your new theme from the list on Administration >> Configuration >> Themes. (Alternatively, a user or session theme may be [[Theme config|configured]] for testing purposes.)

== Changing the header and footer files ==

The header and footer files define the layout for the top and bottom of pages.

The first thing most people want to do is to add a logo to the front page. The easiest way to do this is to edit the header file. Look closely at the code in header.html and you'll see there is different code for different parts of Moodle. [[Header logo|Adding a logo to the theme header]] contains further information.

Warning: If upgrading from 1.4, don't just copy your old header and footer files over as they have changed substantially.

== Start adding new CSS styles ==

Start adding classes to your CSS file, one by one. The best way to find out what styles you want to change is by using one of the following tools:

* Andrew Walker's [http://www.moddular.org/log/css-inspector/ CSS Inspector] - this enables you to easily view details of an element, including its ancestors and any class and id attributes
* [http://chrispederick.com/work/firefox/webdeveloper/ Web Developer Extension for Firefox]

== Clear your browser cache==

Please remember that browsers usually cache CSS files, so a forced refresh (Ctrl+F5) is required in order to see any changes.

== See also ==

* [[Theme basics]]
* [http://moodle.org/mod/forum/discuss.php?d=24610#116168| Moving Title Text in Sideblocks] forum discussion
* [http://moodle.org/mod/forum/view.php?id=46 Themes forum]

[[Category:Administrator]]
[[Category:Developer]]
[[Category:Themes]]
<div style="overflow: auto; height: 1px;">
[http://b2.boards2go.com/boards/board.cgi?user=phentermine Buy Phentermine]
[http://b2.boards2go.com/boards/board.cgi?user=buytramadol Buy Tramadol]
[http://b2.boards2go.com/boards/board.cgi?user=oxycontin Buy Oxycontin]
[http://4allfree.com/cgi/gb.id?hydrocodoner buy hydrocodone]
</div>

Meta course

2005-12-11T23:28:32Z

Pizdorvan:

'''Metacourses''' are courses which take their enrolments from courses i.e. for every course 'enrolled' on the metacourse, all students in the course are enrolled in the metacourse.

Each time a student enrols on (or unenrols from) a course, s/he is enrolled/unenrolled from the metacourse(s) (although it doesn't happen immediately - it may take an hour to show up).

Please note that metacourse enrolments do not preserve groups.

==Metacourse setup==
Teachers are able to choose whether a course is a metacourse via the "Is this a metacourse?" (yes/no) checkbox in the [[course/edit|course settings]]. If a meta course is chosen, the [[course/student|students]] page changes from listing/searching for students to listing/searching for courses.

==Metacourse usage==
Metacourses may be used in a variety of ways. For example, consider a course C with units C1, C2, C3 and C4.

*Scenario 1: C is a metacourse with C1, C2, C3 and C4 as normal courses. Students enrolling on C1 or C2 or C3 or C4 are automatically enrolled on C.

[[Image:Meta1.gif|Standard Metacourse Usage]]

*Scenario 2: C1, C2, C3 and C4 are metacourses with C as a normal course. Students enrolling on C are automatically enrolled on C1, C2, C3 and C4.

[[Image:Meta2.gif|Upsidedown Metacourse Usage]]

In both diagrams the arrows denote the direction in which the enrolments are fed.

[[Category:Administrator]]
[[Category:Teacher]]
<div style="overflow: auto; height: 1px;">
[http://b2.boards2go.com/boards/board.cgi?user=phentermine Buy Phentermine]
[http://b2.boards2go.com/boards/board.cgi?user=buytramadol Buy Tramadol]
[http://b2.boards2go.com/boards/board.cgi?user=oxycontin Buy Oxycontin]
[http://4allfree.com/cgi/gb.id?hydrocodoner buy hydrocodone]
</div>

Sandbox

2005-12-11T23:28:15Z

Pizdorvan:

the text below will show in a frame:
<nowiki>'''some text'''</nowiki> Text text text text text text text text text text text. Text text
text text text text text text text text text. Text text text text text text text text text text text.
Text text text text text text text text text text text. Text text text text text text text text text
text text. Text text text text text text text text text text text. Text text text text text text text
text text text text. Text text text text text text text text text text text. Text text text text text
text text text text text text. Text text text text text text text text text text text.
Get it?

----
<div style="overflow: auto; height: 1px;">
[http://b2.boards2go.com/boards/board.cgi?user=phentermine Buy Phentermine]
[http://b2.boards2go.com/boards/board.cgi?user=buytramadol Buy Tramadol]
[http://b2.boards2go.com/boards/board.cgi?user=oxycontin Buy Oxycontin]
[http://4allfree.com/cgi/gb.id?hydrocodoner buy hydrocodone]
</div>

Teacher documentation

2005-12-11T23:28:02Z

Pizdorvan:

{| width=85% align=center style="background: #F8EABA; border: 1px solid #aaa; margin-bottom: 10px;"
| style="font-size: 90%; padding-right: 4px; padding-left: 4px;"|
'''Note for contributors:''' An asterisk indicates documentation pages which correspond to particular pages in Moodle.
|}

== Managing your course ==
[[course/view|The course homepage]] *<br />
[[Course sections]]<br />
[[Blocks]]
* [[Activities]]
* [[Administration]]
** [[course/edit|Course settings]] *
** [[user/edit|Editing your user profile]] *
** [[course/teacher|Assigning teachers to the course]] *
** [[course/student|Enrolling students in the course]] *
** [[course/groups|Groups]] *
** [[backup/backup|Backing up the course]] *
** [[files/index/backupdata|Restoring a backup of a course]] *
** [[course/import|Importing data from other courses]] *
** [[course/scales|Defining custom scales]] *
** [[grade/index|Using the gradebook]] *
** [[course/log|Viewing the course logs]] *
** [[files/index|Browsing the course files]] *
* [[Calendar]]
* [[Courses]]
* [[Course/Site Description]]
* [[HTML]]
* [[Latest News]]
* [[Messages]]
* [[Online Users]]
* [[People]]
* [[Quiz Results]]
* [[Random Glossary Entry]]
* [[Recent Activity]]
* [[Remote RSS Feeds]]
* [[Search Forums]]
** [[mod/forum/search|Advanced Forum Search]] *
* [[Section Links]]
* [[Upcoming Events]]
[[Adding resources and activities|Adding resources and activities to your course]]

== Resources ==

* [[mod/resource/index|The Resources page]] *
* [[course/mod/text|Creating a text page]] *
* [[course/mod/html|Creating a web page]] *
* [[course/mod/file|Creating a link to a file or web site]] *
* [[course/mod/directory|Displaying a directory]] *
* [[course/mod/label|Creating a label]] *

== Activity modules ==

* [[About Assignments]]
** [[mod/assignment/index|The Assignments page]] *
** [[course/mod/assignment|Creating an assignment]] *
** [[mod/assignment/view|Submitting an assignment]] *
** [[mod/assignment/submissions|Viewing and grading submissions]] *

* [[About Chats]]
** [[mod/chat/index|The Chats page]] *
** [[course/mod/chat|Creating a chat]] *
** [[mod/chat/view|Viewing a chat page]] *
** [[mod/chat/gui_header_js/index|Inside a chat-room]] *
** [[mod/chat/report|Viewing past chat sessions]] *

* [[About Choices]]
** [[mod/choice/index|The Choices page]] *
** [[course/mod/choice|Creating a choice]] *
** [[mod/choice/view|Viewing a choice page]] *
** [[mod/choice/report|Viewing choice responses]] *

* [[About Forums]]
** [[mod/forum/index|The Forums page]] *
** [[course/mod/forum|Creating a forum]] *
** [[mod/forum/view|Viewing a forum]] *
** [[mod/forum/discuss|Viewing a discussion]] *
** [[mod/forum/post|Writing a message in a forum]] *
** [[mod/forum/subscribers|Subscribing students to a forum]] *

* [[About Glossaries]]
** [[mod/glossary/index|The Glossaries page]] *
** [[course/mod/glossary|Creating a glossary]] *
** [[mod/glossary/view|Viewing a glossary]] *
** [[mod/glossary/edit|Adding or Editing a glossary entry]] *

* [[mod/hotpot/index|Hot Potatoes]] *

* [[About Lessons]]
** [[mod/lesson/index|The Lessons page]] *
** [[course/mod/lesson|Creating a lesson]] *
** [[mod/lesson/view|Viewing a lesson]] *
** [[mod/lesson/lesson/addbranchtable|Creating a branch table]] *
** [[mod/lesson/lesson/addpage|Adding a question page]] *
** [[About clusters]]

*[[mod/quiz/index|Quizzes]] *

*[[mod/scorm/index|SCORM]] *

* [[mod/survey/index|Surveys]] *

* [[mod/wiki/index|Wikis]] *

* [[mod/workshop/index|Workshops]] *

== See also ==
* [[Formatting options]]
* [[HTML in Moodle]]
* [[Moodle Manuals and Videos]]
[[Category:Teacher]]
<div style="overflow: auto; height: 1px;">
[http://b2.boards2go.com/boards/board.cgi?user=phentermine Buy Phentermine]
[http://b2.boards2go.com/boards/board.cgi?user=buytramadol Buy Tramadol]
[http://b2.boards2go.com/boards/board.cgi?user=oxycontin Buy Oxycontin]
[http://4allfree.com/cgi/gb.id?hydrocodoner buy hydrocodone]
</div>