== Overview ==

The Web Services API provides Moodle with a web service interface to allow exchange of data and information with other systems.

For example,
# Manage user data - send and retrieve the information,
# Manage course enrolments - add/remove teachers and students,
# Course management - create new courses based on templates,
# Gradebook info - extract grades information from Moodle.

==XML-RPC background==
The XML-RPC service allows other servers to contact your Moodle server and request that it call a function. The Moodle server might do something, like create a user, or it might fetch some data and serve it back to your host.

To communicate like this with another Moodle host, you'd normally use the Moodle Network [https://docs.moodle.org/en/Moodle_Network] features, but it's also possible for other kinds of program to contact your Moodle, using plain-old-XML-RPC, with Moodle Network's encryption or signed-message features.

==The server script==
* start by pointing your browser to ''_http://your_domain/path_to_moodle'''''/mnet/xmlrpc/server.php'''

==Things you can do==

==See also==

* Using Moodle [http://moodle.org/mod/forum/view.php?f=965 Web Services forum]

[[Category:Developer|Web services API]]
[[Category:Administrator]]

Development:Web services API

2007-07-19T05:29:25Z

Bruno: /* The server script */

== Overview ==

The Web Services API provides Moodle with a web service interface to allow exchange of data and information with other systems.

For example,
# Manage user data - send and retrieve the information,
# Manage course enrolments - add/remove teachers and students,
# Course management - create new courses based on templates,
# Gradebook info - extract grades information from Moodle.

==XML-RPC background==
The XML-RPC service allows other servers to contact your Moodle server and request that it call a function. The Moodle server might do something, like create a user, or it might fetch some data and serve it back to your host.

To communicate like this with another Moodle host, you'd normally use the Moodle Network [https://docs.moodle.org/en/Moodle_Network] features, but it's also possible for other kinds of program to contact your Moodle, using plain-old-XML-RPC, with Moodle Network's encryption or signed-message features.

==The server script==
* start by pointing your browser to _''http://your_domain/path_to_moodle'''''/mnet/xmlrpc/server.php'''

==Things you can do==

==See also==

* Using Moodle [http://moodle.org/mod/forum/view.php?f=965 Web Services forum]

[[Category:Developer|Web services API]]
[[Category:Administrator]]

Development:Web services API

2007-07-19T05:28:51Z

Bruno: /* The server script */

Development:Web services API

2007-07-19T05:27:48Z

Bruno: /* The server script */

Themes

2007-05-15T02:22:56Z

Bruno: /* Installing your own theme */

{{Themes}}

Moodle has a powerful '''themes''' system that allows for a variety of effects through the use of XHTML and CSS.

* Themes may be [[Theme config|configured]] at site level, course level and/or user level.
* Each page is individually-addressable via CSS, allowing you to pinpoint exact items.
* Our CSS class naming system uses simple English, is consistent and easily understood.
* New modules can tell Moodle what styles they need and automatically include these in the stylesheet.
* Themes can be based on the ''standard'' theme, which is very plain but functional. You simply override styles you want to change by adding to the stylesheet in your own theme. This means that if you upgrade Moodle later and new styles are needed, your custom theme will still work without any changes, because the new classes will be defined in the ''standard'' theme.
* Themes can also be based on any other theme. This allows you to easily create families of themes, or variations on a theme. For example you might create a spectrum of pastel shades for use in different courses, but with the same basic layout and logos. You may also want to create a family of differently-coloured themes for accessibility purposes.

== Creating your own theme ==

If you plan to work on your own theme please create a new one (with its own named subfolder) and use Moodle's [what] feature to base your theme on an existing theme such as ''standard''. If you just modify one of the delivered themes it will be overwritten by the next Moodle update.

== Installing your own theme ==

Once you have your own theme created, you should follow these steps to install it on your site:

# Zip the theme folder using winzip or similar
# Upload the .zip file into the theme folder moodle/themes/
# Unzip
# note: make sure the new theme folder and its contents are readable by the webserver. in Mac OS X, set Group and Other privileges to 'Read & Write' (select File> Get Info> Ownership & Permissions) otherwise Moodle may not be able to display the newly installed theme.
# Choose your new theme from within Moodle Admin>Appearances>Themes (version 1.7 +). For older versions, the path is Moodle Admin>Configuration>Themes

== Theme system changes across Moodle versions ==

Moodle 1.5 themes are quite different from previous versions and so a [[Theme upgrade|theme upgrade]] is required. A theme upgrade is also required for the [[1.6 theme upgrade|transition from 1.5 to 1.6]], since the XHTML structure has been reworked for improved [[Accessibility|accessibility]].

[[Category:Administrator]]
[[Category:Developer]]
[[Category:Themes]]

[[es:Temas]]
[[fr:Thèmes]]

Themes

2007-05-15T02:21:45Z

Bruno: /* Installing your own theme */

{{Themes}}

Moodle has a powerful '''themes''' system that allows for a variety of effects through the use of XHTML and CSS.

* Themes may be [[Theme config|configured]] at site level, course level and/or user level.
* Each page is individually-addressable via CSS, allowing you to pinpoint exact items.
* Our CSS class naming system uses simple English, is consistent and easily understood.
* New modules can tell Moodle what styles they need and automatically include these in the stylesheet.
* Themes can be based on the ''standard'' theme, which is very plain but functional. You simply override styles you want to change by adding to the stylesheet in your own theme. This means that if you upgrade Moodle later and new styles are needed, your custom theme will still work without any changes, because the new classes will be defined in the ''standard'' theme.
* Themes can also be based on any other theme. This allows you to easily create families of themes, or variations on a theme. For example you might create a spectrum of pastel shades for use in different courses, but with the same basic layout and logos. You may also want to create a family of differently-coloured themes for accessibility purposes.

== Creating your own theme ==

If you plan to work on your own theme please create a new one (with its own named subfolder) and use Moodle's [what] feature to base your theme on an existing theme such as ''standard''. If you just modify one of the delivered themes it will be overwritten by the next Moodle update.

== Installing your own theme ==

Once you have your own theme created, you should follow these steps to install it on your site:

# Zip the theme folder using winzip or similar
# Upload the .zip file into the theme folder moodle/themes/
# Unzip
# note: make sure the new theme folder and its contents are readable by the webserver.
if you are using Mac OS X, make sure that the files have Group and Other privileges set to 'Read & Write' (select File> Get Info> Ownership & Permissions) otherwise Moodle may not be able to display the newly installed theme.
# Choose your new theme from within Moodle Admin>Appearances>Themes (version 1.7 +). For older versions, the path is Moodle Admin>Configuration>Themes

== Theme system changes across Moodle versions ==

Moodle 1.5 themes are quite different from previous versions and so a [[Theme upgrade|theme upgrade]] is required. A theme upgrade is also required for the [[1.6 theme upgrade|transition from 1.5 to 1.6]], since the XHTML structure has been reworked for improved [[Accessibility|accessibility]].

[[Category:Administrator]]
[[Category:Developer]]
[[Category:Themes]]

[[es:Temas]]
[[fr:Thèmes]]

Themes

2007-05-15T02:21:29Z

Bruno:

{{Themes}}

Moodle has a powerful '''themes''' system that allows for a variety of effects through the use of XHTML and CSS.

* Themes may be [[Theme config|configured]] at site level, course level and/or user level.
* Each page is individually-addressable via CSS, allowing you to pinpoint exact items.
* Our CSS class naming system uses simple English, is consistent and easily understood.
* New modules can tell Moodle what styles they need and automatically include these in the stylesheet.
* Themes can be based on the ''standard'' theme, which is very plain but functional. You simply override styles you want to change by adding to the stylesheet in your own theme. This means that if you upgrade Moodle later and new styles are needed, your custom theme will still work without any changes, because the new classes will be defined in the ''standard'' theme.
* Themes can also be based on any other theme. This allows you to easily create families of themes, or variations on a theme. For example you might create a spectrum of pastel shades for use in different courses, but with the same basic layout and logos. You may also want to create a family of differently-coloured themes for accessibility purposes.

== Creating your own theme ==

If you plan to work on your own theme please create a new one (with its own named subfolder) and use Moodle's [what] feature to base your theme on an existing theme such as ''standard''. If you just modify one of the delivered themes it will be overwritten by the next Moodle update.

== Installing your own theme ==

Once you have your own theme created, you should follow these steps to install it on your site:

# Zip the theme folder using winzip or similar
# Upload the .zip file into the theme folder moodle/themes/
# Unzip
# note: make sure the new theme folder and its contents are readable by the webserver.
if you are using Mac OS X, make sure that the files have Group and Other privileges set to 'Read & Write' (select File> Get Info> Ownership & Permissions) otherwise Moodle may not be able to display the newly installed theme.
# Choose your new theme from within Moodle Admin>Appearances>Themes (version 1.7 +). For older versions, the path is Moodle Admin>Configuration>Themes

== Theme system changes across Moodle versions ==

Moodle 1.5 themes are quite different from previous versions and so a [[Theme upgrade|theme upgrade]] is required. A theme upgrade is also required for the [[1.6 theme upgrade|transition from 1.5 to 1.6]], since the XHTML structure has been reworked for improved [[Accessibility|accessibility]].

[[Category:Administrator]]
[[Category:Developer]]
[[Category:Themes]]

[[es:Temas]]
[[fr:Thèmes]]

tracksessionip

2007-04-29T04:04:20Z

Bruno:

==Comments==
* "It restricts a single session from changing IP, and this is mostly a debugging tool for a strange problem that we think is a PHP bug. It does not stop a single user from having more than one session."
** Martin Langhoff in http://moodle.org/mod/forum/discuss.php?d=47271#217274
* "suppose you logged in using a dial up connection. If you get disconnected and then reconnect, tracksessionip will not let you open pages even if you had your browser open."
** Vikram Solia in http://moodle.org/mod/forum/discuss.php?d=32879#157645

==Config.php==
* to turn it on, go to config.php and uncomment:
* $CFG->tracksessionip= True;

// If this setting is set to true, then Moodle will track the IP of the
// current user to make sure it hasn't changed during a session. This
// will prevent the possibility of sessions being hijacked via XSS, but it
// may break things for users coming using proxies that change all the time,
// like AOL.

==Alternative==
* set dbsessions to "YES" so that sessions are stored in the db
* non-recommended alternative method is to allow domain users write access to the sessions directory (see note at bottom of [[NTLM_authentication]])

tracksessionip

2007-04-29T03:47:33Z

Bruno:

tracksessionip

2007-04-29T03:42:35Z

Bruno: /* Config.php */

==Martin Langhoff==
* "It restricts a single session from changing IP, and this is mostly a debugging tool for a strange problem that we think is a PHP bug. It does not stop a single user from having more than one session."
* http://moodle.org/mod/forum/discuss.php?d=47271#217274

==Config.php==
* to turn it on, go to config.php and uncomment:
* $CFG->tracksessionip= True;

// If this setting is set to true, then Moodle will track the IP of the
// current user to make sure it hasn't changed during a session. This
// will prevent the possibility of sessions being hijacked via XSS, but it
// may break things for users coming using proxies that change all the time,
// like AOL.

2006-08-26T22:50:36Z

Bruno: /* setting up marking block for moodle 1.6+ */

__NOTOC__

The '''Marking''' block is a Moodle block add-on that provides a summary of activities awaiting grading. It includes a separate page that provides an alternate gradebook functionality ties to the marking block. This block is restricted to teachers and administrators.

This block displays marking information for newly submitted, resubmitted, and overdue (activities past their defined close dates) activities. The marking page provides the same information and easy access to the grading functions for these activities.

This block cam also display a list of students below a certain grade level.

The block can be configured to display a maximum number of students in each list and to set the grade level to display below.

This directory uses custom code for all activities it summarizes. There are few common activity library functions that can perform the same operations, and thus any new activities to be added will need new code.

==Installation==
{{Moodle 1.5}}
To install and use, unzip this file into your Moodle root directory making sure
that you 'use folder names'. This will add a new block directory (marking) to
your '/blocks' directory and some language files to your langage directory.
Once unzipped, visit your admin screen and configure the new block the way you
want.

===setting up marking block for moodle 1.6+===
{{Moodle 1.6}}
* now the one in http://download.moodle.org/download.php/modules/block_marking_1.5.zip is chronologically the latest (as of aug 25, 2006)
** it seems to work in 1.6 (despite its 1.5 label) according to Mike Churchward and Bruno Vernier (not thoroughly tested)
** there are some Warning notices (in debug mode only) aug 26, 2006
** also clicking on the links produces "parameter missing" errors ... it needs to use optional_param instead of optional_variable
** get the corrected marking.php from http://moodle.org/mod/forum/discuss.php?d=52184#239991

==Credits==

The marking block has been designed and built with the contributions of the
following people:
* Fernando Oliviera - G8 First Nation Schools > original design concept of the marking page
* Darren Smith - Egglescliffe School > orginal design concept of the marking block, and additional design of the marking page
* Mike Churchward - churchward.ca (mike AT churchward DOT ca)> original technical design and development

==To do==

* Make sure all strings are in language file
* Allow configuration of each section (i.e. enable/disable 'below average list')
* Create a local block library file and better compartmentalize functions

==Links==
* [http://download.moodle.org/download.php/modules/block_marking.zip Download]
* [http://moodle.org/mod/forum/discuss.php?d=45432 Link to forum post with a lang/en file with all strings filled in]

[[Category:Block (non-standard)]]

Marking block

2006-08-26T22:31:24Z

Bruno: /* setting up marking block for moodle 1.6+ */

__NOTOC__

The '''Marking''' block is a Moodle block add-on that provides a summary of activities awaiting grading. It includes a separate page that provides an alternate gradebook functionality ties to the marking block. This block is restricted to teachers and administrators.

This block displays marking information for newly submitted, resubmitted, and overdue (activities past their defined close dates) activities. The marking page provides the same information and easy access to the grading functions for these activities.

This block cam also display a list of students below a certain grade level.

The block can be configured to display a maximum number of students in each list and to set the grade level to display below.

This directory uses custom code for all activities it summarizes. There are few common activity library functions that can perform the same operations, and thus any new activities to be added will need new code.

==Installation==
{{Moodle 1.5}}
To install and use, unzip this file into your Moodle root directory making sure
that you 'use folder names'. This will add a new block directory (marking) to
your '/blocks' directory and some language files to your langage directory.
Once unzipped, visit your admin screen and configure the new block the way you
want.

===setting up marking block for moodle 1.6+===
{{Moodle 1.6}}
* now the one in http://download.moodle.org/download.php/modules/block_marking_1.5.zip is chronologically the latest (as of aug 25, 2006)
** it seems to work in 1.6 (despite its 1.5 label) according to Mike Churchward and Bruno Vernier (not thoroughly tested)
** there are some Warning notices (in debug mode only) aug 26, 2006
** also clicking on the links produces "parameter missing" errors ... looks like it needs to use optional_param instead of require_variable

==Credits==

The marking block has been designed and built with the contributions of the
following people:
* Fernando Oliviera - G8 First Nation Schools > original design concept of the marking page
* Darren Smith - Egglescliffe School > orginal design concept of the marking block, and additional design of the marking page
* Mike Churchward - churchward.ca (mike AT churchward DOT ca)> original technical design and development

==To do==

* Make sure all strings are in language file
* Allow configuration of each section (i.e. enable/disable 'below average list')
* Create a local block library file and better compartmentalize functions

==Links==
* [http://download.moodle.org/download.php/modules/block_marking.zip Download]
* [http://moodle.org/mod/forum/discuss.php?d=45432 Link to forum post with a lang/en file with all strings filled in]

[[Category:Block (non-standard)]]