MoodleDocs - User contributions [en]

Theme directory

2007-06-27T13:42:03Z

Stuartmanderson: /* Changing Theme Storage Location */

{{Themes}}
In the standard Moodle distribution, all themes are placed in the theme/ directory.

From version 1.7, moodle will support changing the location which themes are stored in and used with the theme selector.

== Changing Theme Storage Location ==
{{Moodle 1.7}}
Starting from Moodle 1.7, the storage location of themes may be altered, using the variables ''$CFG->themewww'' and ''$CFG->themedir''. Themes from placed in the directory specified by these variables will then be available for selection using the theme selector.

For example, should you wish to place themes in a subdirectory called 'my_moodle_themes', your config.php might look like this:
<pre>
$CFG->wwwroot = 'http://my.moodle.site.edu';
$CFG->dirroot = '/var/www/my.moodle.site.edu/public_html';
$CFG->themewww = $CFG->wwwroot . '/my_moodle_themes';
$CFG->themedir = $CFG->dirroot . '/my_moodle_themes';
</pre>

== Theme directory for Developers ==

Developers should follow the [[Development:Theme directory guide]]

== See Also ==

*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=20152 Feature request: Themes path in a VAR]
*Moodle Tracker [http://tracker.moodle.org/browse/MDL-6784 MDL-6784]

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

[[fr:Dossier de thèmes]]

Development:NWiki roadmap

2007-06-07T15:46:14Z

Stuartmanderson: /* Miscelaneous */

This page is to talk about the (likely) entrance of NWiki into 1.9 core.

= NWiki roadmap=
Rigth Now DFwikiteam is focussed in the following issues:
== XHTML Strict ==
*NWiki complies with XHTML transitional. April 2007
*NWiki complies with '''XHTML Strict''' mid May '07
** this affects main engine
** blocks not finished yet (some javascript to look up to)

==Logs and stats==
We need to ckeck out stats and logs with nwiki.
* Done! June 2007

== Code Tunning : new wiki api==
There's a big issue in the code, the $WS variable that acts like a big set of global variables.
*We are getting $WS smaller day by day
*We are witting a new internal API to create an internal layer of services for developers.

'''Done!!!''' Two main layers for developers have been written and working inside of the Nwiki distributions since May 2007.
[http://morfeo.upc.es/crom/file.php/4/wikiAPIdoc/index.htmlThe PHPDoc documentation is available here].

=== PHPUnit testing===
* a set of PHPUnit tests have been developed to ensure the quality of the thing.
* test case descriptions have been written to help developers and maintainers
[http://morfeo.upc.es/crom/mod/wiki/view.php?id=22&page=Wiki+Unit+Tests+Documentation&gid=0&uid=0 NWiki PHPUnit documentation]

== shall we trim nwiki ?==
NWiki is Huge ! As many have said we implement a lot of features that maybe are not necessary for everybody.
We could have a reduced set of nwiki into the oficial distribution and a 3rd party and a extended version as 3rd part plug in.
Things that could be taken outside:
===Maybe we keep them===
* wiki course format
* discussion pages ?
* grading in wikis ?
* ranking and votes?

===Most likely===
* integration with tiddlywiki ? [[Tiddlywiki integration]]

=== New upcoming toys ===
In June 2007 will come new features that need to be sorted in or out of the basic distribution
* [[Wikibook]] [http://moodle.org/mod/forum/discuss.php?d=72909 wikibook in the forum]
* PDF Generation
* Timeline-like wiki history browser
* Import / export from openoffice writer and (eventually) msword

== Migration issues ==
So far the data migration works fine. No bugs reported without attending.
== rethink wiki permisions and roles ==
* a user can discuss the page while he cannot edit the page
* the teacher cat FIX a markup for a wiki in the wiki options form.

==More?==
Let's rememeber to complete the PDF export thing (HTML Editor wiki pages are not exported)
Expected mid june

==Even More features Implemented==

=== Wiki Templates ===

* Add templates so that some content can be made available to all groups when they start using a wiki
Implemented, in release June 2007
=== mailto ===
* a mailto link for dfwiki
has already ben developed must be included in next release [http://moodle.org/mod/forum/discuss.php?d=38991 mailto dfwiki forum thread]

==And finally==
Dynamical online import from mediawiki utilty... :-D

= Old DFwiki requests =
Use this page for requests of bugfixes and new features on the [http://morfeo.upc.es/crom/course/view.php?id=4 NWiki]
The [http://morfeo.upc.es/crom/course/view.php?id=4 DFwikiteam] will keep a sharp eye on the list.

== Miscellaneous ==
*We need to implement some [[Special pages]] like mediawiki's [[Recent changes]].
*Section edit.
*borrow some interface ideas from OUWiki

== block wikipage ==

Would be useful to have a block with the content of a wikipage.

If you select 'social' course format you have the option of inserting a social activities block... I don't get that option for the DFWiki, but I think I should so I can add other Moodle activities...

otherwise, when I go to admin/site I can choose to display a topic section where I can put activities and this may be an alternative solution.

Note: In theme [http://moodle.org/mod/forum/discuss.php?d=42325 Including wiki page in other Moodle resources] was announced filter, which can include wiki-page into any filterable place. In summ with existing html block it sounds like solution for this suggestion! --[[User:Ne Nashev|Ne Nashev]] 07:52, 26 March 2006 (WST)

== Including wiki page in other Moodle resources ==
I suggest add to standard filters (like Autoformat, Markdown) tag which allow include content (not a link) of wiki page (without editing). This will allow to use wiki as general place for storage texts and use them in resources, lessons and so on.

Note: In theme [http://moodle.org/mod/forum/discuss.php?d=42325 Including wiki page in other Moodle resources] was announced this filter

-----
The words "Change to one of the following editors" tells the new user to change to an editor other than the default editor. As this works now, the choice cannot be changed once selected.

In order to avoid this confusion, the teacher should be able to make the default editor the only choice.

In the meantime, the option "Change to one of the following editors" could be moved down below the buttons: save, preview, cancel.

That way new users will be more likely to use the default editor and not lock themselves into one of the other options.
[http://moodle.org/mod/forum/discuss.php?d=39191 forum tread]
-----

== Moodle wide metawiki==

We need a metawiki index to easily link between wikis.
The idea is to have admin tool to manage the wiki-names to be able to
refer easily from one wiki to another like this:

<nowiki> [wiki-name:wikipagename|label to link]</nowiki>

== Special wiki pages ==

=== Wiki reference. ===
To implement biblio references... a link like
<nowiki>[ref:refname]</nowiki> Will lead us to a editing page with a form (maybe a [[database module]] form) to enter the biblio reference ( title, author, isbn, link , pages ... and so on )...
Once we got that any page with a reference to a biblio ref will get printed at its bottom the complete reference and a link to it.

This feature proposal comes within the [[wikibook]] line of work

== weird course interaction stuff ==
If you select 'social' course format you have the option of inserting a social activities block... I don't get that option if I select DFWiki, but I think I should so I can add other Moodle activities... (using Moodle 1.6)

Otherwise, when I go to admin/site I can choose to display 1 topic section where I can put activities and this may be an alternative solution.

Also if I modify a course that had a different format, such as topics ,to be DFWiki the course crashes and you cannot get back to original course format because of the error it throws up.

*[[wiki]]
*[[Dfwiki]]
*[http://morfeo.upc.es/crom/course/view.php?id=4 DFWikilabs]
*[[Development:Wiki requirements]]

Filters

2006-07-28T12:09:49Z

Stuartmanderson: /* Algebra */

'''Filters''' allow for the for the automatic transformation of entered text into different, often more complex forms. For example the titles of [[Resources]] can automatically become hyperlinks that take you to the relevant resource, URLs pointing to [[mp3]] files can become [[Flash]] controls embedded in the webpage that let you pause and rewind the audio. The possibilities are endless and there are a number of standard filters included with Moodle and many more specialized filters contributed by the community.

Filters may be added or removed simply by using a file manager to add or remove them to the /filters directory. Moodle detects those that are present and makes them available to use.

==Filters administration screen==

The filters administration screen enables individual filters to be shown (enabled) or hidden (disabled). Only enabled filters will be applied to displayed text. The order in which filters are applied to displayed text can be significant - you can change the order in which enabled filters are applied using the up and down buttons. The enabled filters are applied from the top of the list down. Some filters have their own settings screen, see the documentation for the individual filter for information.

===Cache Controls===

====Text cache lifetime====

To reduce load on the server and to speed display of pages, Moodle can store previously processed pages (that have not changed) for a period of time. This setting controls the time for which processed pages are stored. A longer setting may improve performance but has the effect that changes to pages may not become visible for a time. You can switch caching off completely here.

====Filter uploaded files====

This setting enables uploaded files (HTML and text only) to be processed by the filters system. You can choose to have none, only HTML or all files filtered.

{{Moodle 1.6}}

====Filter match once per page====

This setting effects the glossary, activity and resource linking filters. If set to yes, only the first match on the complete page will be converted to a link. All others will be ignored.

====Filter match once per text====

This setting effects the glossary, activity and resource linking filters. If set to yes, only the first match in a discrete block of text will be converted to a link. All others in that text block will be ignored.

====Filter all strings====

When set to yes, all Moodle text will be filtered. This is probably only necessary when using the multi-language filter.

=== Config.php settings ===

For Moodle 1.6 see the Cache Settings above. The following two settings affect the glossary, activity and resource linking filters:

To convert only the first matching title on a page, insert or uncomment the following line in config.php

$CFG->filtermatchoneperpage = true;

To convert only the first matching title in a discrete block of text, insert or uncomment the following line in config.php

$CFG->filtermatchonepertext = true;

==Algebra==

This filter will convert algebra code into GIF images. It requires the tex filter to be installed ([[#TeX notation|see below]]). Note also that your system must also include the following Perl module: HTML::Entities.pm

==Glossary auto-linking==

As the name suggests, this filter enables automatic linking of [[mod/glossary/index|glossary]] entries. In addition to this filter, individual glossary entries should have the "This entry should be automatically linked" box checked.

==Multimedia plugins==

See [[Multimedia plugins]]

==Multi-language content==

This filter enables resources to be created in multiple languages. It looks for <lang> tags which indicate that a text contains multiple languages. Then it selects and outputs the best language for the current user. The language of the resource will change when the user changes their selected Moodle language.

To use this feature first create your contents in multiple languages (in the same resource). Then enclose each language block in the following tags:

<nowiki>your_content_here
your_content_in_other_language_here
</nowiki>

==TeX notation==

See [[TeX filter]]

==Tidy==

The tidy filter checks whether HTML code is XHTML compliant, tidying where necessary. To make this filter work you need to have PHP compiled. The discussion [http://moodle.org/mod/forum/discuss.php?d=28418 Tidy Filter for Moodle 1.5] contains more details.

==Word censorship==

See [[Word censorship]]

==Non-standard filters==

* [[Jmol filter|Jmol]] - for interactive 3D viewing of molecular structures
* [[Code Syntax Highlighting]] - for more readable excerpts of programming languages including [[PHP]], [[HTML]], [[CSS]], and XML amongst many others

[[Category:Administrator]]
[[Category:Filter]]

[[es:Filtros (Administrador)]]

Filters

2006-07-28T12:08:58Z

Stuartmanderson: /* Algebra */

'''Filters''' allow for the for the automatic transformation of entered text into different, often more complex forms. For example the titles of [[Resources]] can automatically become hyperlinks that take you to the relevant resource, URLs pointing to [[mp3]] files can become [[Flash]] controls embedded in the webpage that let you pause and rewind the audio. The possibilities are endless and there are a number of standard filters included with Moodle and many more specialized filters contributed by the community.

Filters may be added or removed simply by using a file manager to add or remove them to the /filters directory. Moodle detects those that are present and makes them available to use.

==Filters administration screen==

The filters administration screen enables individual filters to be shown (enabled) or hidden (disabled). Only enabled filters will be applied to displayed text. The order in which filters are applied to displayed text can be significant - you can change the order in which enabled filters are applied using the up and down buttons. The enabled filters are applied from the top of the list down. Some filters have their own settings screen, see the documentation for the individual filter for information.

===Cache Controls===

====Text cache lifetime====

To reduce load on the server and to speed display of pages, Moodle can store previously processed pages (that have not changed) for a period of time. This setting controls the time for which processed pages are stored. A longer setting may improve performance but has the effect that changes to pages may not become visible for a time. You can switch caching off completely here.

====Filter uploaded files====

This setting enables uploaded files (HTML and text only) to be processed by the filters system. You can choose to have none, only HTML or all files filtered.

{{Moodle 1.6}}

====Filter match once per page====

This setting effects the glossary, activity and resource linking filters. If set to yes, only the first match on the complete page will be converted to a link. All others will be ignored.

====Filter match once per text====

This setting effects the glossary, activity and resource linking filters. If set to yes, only the first match in a discrete block of text will be converted to a link. All others in that text block will be ignored.

====Filter all strings====

When set to yes, all Moodle text will be filtered. This is probably only necessary when using the multi-language filter.

=== Config.php settings ===

For Moodle 1.6 see the Cache Settings above. The following two settings affect the glossary, activity and resource linking filters:

To convert only the first matching title on a page, insert or uncomment the following line in config.php

$CFG->filtermatchoneperpage = true;

To convert only the first matching title in a discrete block of text, insert or uncomment the following line in config.php

$CFG->filtermatchonepertext = true;

==Algebra==

This filter will convert algebra code into GIF images. It requires the tex filter to be installed ([[#TeX notation|see below]]). Note also that you system must also include the following Perl module HTML::Entities.pm

==Glossary auto-linking==

As the name suggests, this filter enables automatic linking of [[mod/glossary/index|glossary]] entries. In addition to this filter, individual glossary entries should have the "This entry should be automatically linked" box checked.

==Multimedia plugins==

See [[Multimedia plugins]]

==Multi-language content==

This filter enables resources to be created in multiple languages. It looks for <lang> tags which indicate that a text contains multiple languages. Then it selects and outputs the best language for the current user. The language of the resource will change when the user changes their selected Moodle language.

To use this feature first create your contents in multiple languages (in the same resource). Then enclose each language block in the following tags:

<nowiki>your_content_here
your_content_in_other_language_here
</nowiki>

==TeX notation==

See [[TeX filter]]

==Tidy==

The tidy filter checks whether HTML code is XHTML compliant, tidying where necessary. To make this filter work you need to have PHP compiled. The discussion [http://moodle.org/mod/forum/discuss.php?d=28418 Tidy Filter for Moodle 1.5] contains more details.

==Word censorship==

See [[Word censorship]]

==Non-standard filters==

* [[Jmol filter|Jmol]] - for interactive 3D viewing of molecular structures
* [[Code Syntax Highlighting]] - for more readable excerpts of programming languages including [[PHP]], [[HTML]], [[CSS]], and XML amongst many others

[[Category:Administrator]]
[[Category:Filter]]

[[es:Filtros (Administrador)]]