MoodleDocs - User contributions [en]

User:Frank Ralf/Moodle XML1

2014-08-07T21:29:28Z

Nakohdo: amended URL for Quedoc's Moodle XML documentation

This is only for keeping notes on some of my findings regarding Moodle XML.

== Minimum Question XML ==

Other than stated at Quedoc's Moodle XML documentation ([http://www.qedoc.org/index.php?title=Moodle_XML_format#Minimum_requirements Minimum requirements]) the minimum working Moodle XML file seems to be the following (short answer question). It gets imported using the default import settings.

Missing fields are populated with the default values during import which can be seen by re-exporting the question(s).

<code xml>
<?xml version="1.0" encoding="UTF-8"?>
<quiz>
<question type="shortanswer">
<name>
<text>Minimum question</text>
</name>
<questiontext>
<text>What's the minimum XML required for import?</text>
</questiontext>
<answer fraction="100">
<text>This here!</text>
</answer>
</question>
</quiz>
</code>

[[Image:Moodle XML Minimum question.png]]

=== Re-export ===
This is how the question looks after exporting it again:

<code xml>
<?xml version="1.0" encoding="UTF-8"?>
<quiz>

<question type="shortanswer">
<name>
<text>Minimum question</text>
</name>
<questiontext format="moodle_auto_format">
<text>What's the minimum XML required for import?</text>
</questiontext>
<image></image>
<generalfeedback>
<text></text>
</generalfeedback>
<defaultgrade>1</defaultgrade>
<penalty>0.1</penalty>
<hidden>0</hidden>
<shuffleanswers>0</shuffleanswers>
<usecase>0</usecase>
<answer fraction="100">
<text>This here!</text>
<feedback>
<text></text>
</feedback>
</answer>
</question>
</quiz>
</code>

== OpenOffice & XML ==
Some useful resources for using XML filters in OpenOffice for converting XML files:

* [http://www.xml.com/pub/a/2005/01/26/hacking-ooo.html "Hacking Open Office "] by Peter Sefton

* [http://www.ibm.com/developerworks/edu/x-dw-x-xsltopenoff.html "Use XSLT to expand OpenOffice's editing capabilities - Create import and output filters to edit your XML as rich text"] by Jonathan Levin (site requires free registration for full access) - [https://www6.software.ibm.com/developerworks/education/x-xsltopenoff/resources.html Resources]

== Converting Moodle Glossary XML to Question XML ==
Moved to its own page: [[User:Frank Ralf/Converting Moodle glossary XML to question XML]]. --[[User:Frank Ralf|Frank Ralf]] 20:12, 24 November 2010 (UTC)

XML FAQ

2014-08-07T21:28:03Z

Nakohdo: amended URL for Quedoc's Moodle XML documentation

{{Main page}}(If you don't find the answer to your question here, just post the question. There might be someone out there to provide the answer.)

==XML in general==

===Where do I find general information about XML?===
* http://www.w3schools.com/xml/default.asp - A host of information and hands-on examples
*http://en.wikipedia.org/wiki/XML - A good starting point

==Moodle XML==

===Is there only one kind of Moodle XML?===

No, there are (at least) two different kinds of Moodle XML:
# one for importing/exporting ''glossaries''
# and one for ''questions'' (quizzes), the latter being the one usually referred to as "Moodle XML".

Then there is XML in the SCORM/IMS packages that Moodle can import and must be able to handle. These packages are educational content that has been marked up in a special way to be able to be used in compatible Learning Management Systems.

The ''course backup and restore'' process also generates an XML file (inside the zip file) that contains all the information about the course.

===Where do I find documentation about Moodle XML?===

* The official documentation: [[Moodle XML]]
* A more thorough documentation: [http://www.qedoc.org/index.php?title=Moodle_XML_format Moodle XML format] by Quedoc
: [http://www.qedoc.org/index.php?title=Problems_when_transferring_XML_format_into_Moodle Problems when transferring XML format into Moodle]

* [[User:Frank Ralf/Moodle XML1]] (work in progress)

==Tools==

===Are there tools for converting to and from Moodle XML?===
* [http://vletools.com Moodle XML Converter] - allows to create XML from text files. Also can converse Moodle XML into text file. Supports quiz and glossary.
* [http://moodle.org/mod/forum/discuss.php?d=91224#p489764 Glossary to XML Converter]
:A simple HTML file which converts TSV data to XML using JavaScript
* Microsoft Office macros: http://finemetronome.com/moodle/
* OpenOffice XML filters (TBA see [[User:Frank_Ralf/Moodle_XML1#OpenOffice_.26_XML|User:Frank_Ralf/Moodle XML1 > OpenOffice & XML]] for some pointers)

===How can I view and edit XML files?===
XML is just text so you can view and edit it with any text editor. However, this isn't very easy for anything more than a trivial file. There are a number of dedicated XML editors available for many platforms. If you only need to view the XML, most browsers are able to render XML files. Some even let you view the source text and do some basic editing.

== See also ==

; Moodle Docs
* [[Import and export FAQ]]

; Contributed modules and plugins
* [http://moodle.org/mod/forum/discuss.php?d=161367 DocBook Module to Parse DocBook XML]

; Books
* [http://www.sitepoint.com/books/xml1/ No Nonsense XML Web Development With PHP] by Thomas Myer

[[Category:FAQ]]

[[de:XML FAQ]]
[[es:XML FAQ]]

Moodle XML format

2014-08-07T21:26:44Z

Nakohdo: amended URL for Quedoc's Moodle XML documentation

{{Export questions}}
The XML Format is a Moodle-specific format for importing and exporting questions to be used with the [[Quiz module]]. The format has been developed within the Moodle Community but other software may support it to a greater or lesser degree.

==A word about validity (and CDATA)==

The XML parser assumes that the XML file is well formed and does not detect or report errors. If it is not you are very likely to get unexpected errors. If you are hand-coding the XML file it is strongly recommended that you pass it through some sort of XML verifier before importing into Moodle. A simple way to do this is to open the XML file using Firefox or Internet Explorer.

Note particularly that embedded HTML fragments should be within [http://en.wikipedia.org/wiki/CDATA CDATA sections]. CDATA example:

<code xml>
<questiontext format="html">
<text><![CDATA[
Now I can include any HTML that I 
wish. Without the CDATA, the HTML tags would break
the XML!!
]]>
</text>
</questiontext>
</code>

==Overall structure of XML file==

The file is enclosed by tags as follows. It is '''important''' to make sure the xml-line is really the first line of the file. A blank first line turns your otherwise compliant file into a source of frustration.

<code xml>
<?xml version="1.0" ?>
<quiz>
.
.
.
</quiz>
</code>

Within the <quiz> tags are any number of <question> tags. One of these <question> tags can be a dummy question with a ''category'' type to specify a category for the import/export.

<code xml>
<question type="category">
<category>
<text>$course$/XXXX</text>
</category>
</question>
</code>

Where XXXX is the new category name. If the category exists, the question(s) will be added to the existing course; otherwise a new category will be created. This only works if you have "Get category from file" checked.

Multiple categories can be specified in the same file. Just add another dummy 'category' question each time you would like to establish a new category and the questions that follow it will be placed there.

The file must be encoded in [[UTF8]]

Moodle XML import and export are balanced in functionality, so if you need to understand the format you can simply create some questions and export them to see what it looks like.

==Tags common to all question types==

A question is written as follows.

<code xml>
<question type="multichoice|truefalse|shortanswer|matching|cloze|essay|numerical|description">
<name>
<text>Name of question</text>
</name>
<questiontext format="html">
<text>What is the answer to this question?</text>
</questiontext>
.
.
.
</question>
</code>

"Format" selects the [[Formatting options]] for the question text. The options are '''html''' (the default), '''moodle_auto_format''', '''plain_text''' and '''markdown'''. The choice effects the way in which the text will be displayed.

Further tags, which usually include at least one <answer> tag, follow in the space marked with dots as child nodes to the <question> tag. The response-related tags are listed further down on this page. Various (optional?) tags are possible.

* tags (non-hierarchical keywords)
* penalty
* generalfeedback
* defaultgrade
* hidden

Even though question tags (non-hierarchical keyowords) are not fully supported in the question engine, they can be imported and exported via XML.

<code xml>
<question ...>
...
<tags>
<tag>
<text>keyword1</text>
</tag>
<tag>
<text>keyword2</text>
</tag>
...
</tags>
...
</question>
</code>

The <image> tag contains the url of any included image. Nested within the <image> tag may be an <image_base64> tag which contains the actual image data encoded in base64 [http://www.php.net/manual/en/function.base64-encode.php].

'''In the following question type examples the common parts of the question are not shown to improve clarity. It's a good idea to export some examples yourself to see a full example.'''

==Multiple choice==

MC questions have one <answer> tag for each choice. Each choice can carry feedback and score weighting (by using the fraction attribute). In addition, an MC question has the following tags:

* single ''(values: true/false)''
* shuffleanswers ''(values: 1/0)''
* correctfeedback
* partiallycorrectfeedback
* incorrectfeedback
* answernumbering (allowed values: 'none', 'abc', 'ABCD' or '123')

The <single> tag is used to distinguish single response (radio button) and multiple response (checkbox) variants.

<code xml>
<question type="multichoice">
<answer fraction="100">
<text>The correct answer</text>
<feedback><text>Correct!</text></feedback>
</answer>
<answer fraction="0">
<text>A distractor</text>
<feedback><text>Ooops!</text></feedback>
</answer>
<answer fraction="0">
<text>Another distractor</text>
<feedback><text>Ooops!</text></feedback>
</answer>
<shuffleanswers>1</shuffleanswers>
<single>true</single>
<answernumbering>abc</answernumbering>
</code>

== True/false ==

Two answer tags are given, one which is true, and one which is false. The fraction attribute of the answer tag identifies which option is correct (100) and which is false (0). Feedback is supported. The following example shows the format when true is the correct answer and false is wrong.

<code xml>
<question type="truefalse">
<answer fraction="100">
<text>true</text>
<feedback><text>Correct!</text></feedback>
</answer>
<answer fraction="0">
<text>false</text>
<feedback><text>Ooops!</text></feedback>
</answer>
</code>

== Short answer ==

The short answer question type supports alternative correct responses, each with its own weighting and feedback. The Moodle XML format uses one <answer> tag for each of the alternative correct answers.

The <usecase> tag toggles case-sensitivity with the values 1/0.

<code xml>
<question type="shortanswer">
<answer fraction="100">
<text>The correct answer</text>
<feedback><text>Correct!</text></feedback>
</answer>

<question type="shortanswer">
<answer fraction="100">
<text>The correct answer</text>
<feedback><text>Correct!</text></feedback>
</answer>
<answer fraction="100">
<text>An alternative answer</text>
<feedback><text>Correct!</text></feedback>
</answer>
</code>

== Numerical response ==

The following is a simplified version of the Moodle XML format for numerical responses.

<code xml>
<question type="numerical">
<answer fraction="100">
<text>23</text>
<feedback><text>Feedback</text></feedback>
</answer>
</code>

Moodle also supports a <tolerance> tag (how accurate must the number be?) and one or more <unit> tags. Unit tags have names and multipliers. E.g. if the main answer is in kilometres, an additional answer could be the equivalent in metres with a multiplier of 1000.

'''Note:''' prior to 1.7.2 the fraction was expressed as a value between 0 and 1 in a <fraction> element and the answer value was '''not''' enclosed in <text> tags. This format of the numerical question type is deprecated but will still be correctly imported if found (for now).

== Matching ==

Pair matching responses use the <shuffleanswers> tag to determine whether the order of the items should be randomized.
Each pair is contained inside a <subquestion> tag. The first item of each pair is contained with a <text> tag, while the second has an <answer> tag around it as well. Feedback and score weighting is not supported by Moodle for this response type.

<code xml>
<question type="matching">
<subquestion>
<text>This is the 1st item in the 1st pair.</text>
<answer>
<text>This is the 2nd item in the 1st pair.</text>
</answer>
</subquestion>
<subquestion>
<text>This is the 1st item in the 2nd pair.</text>
<answer>
<text>This is the 2nd item in the 2nd pair.</text>
</answer>
</subquestion>
<shuffleanswers>true</shuffleanswers>
</code>

== Essay ==

An example of the essay type question...

<code xml>
<question type="essay">
<answer fraction="0">
<text></text>
</answer>
</question>
</code>

There isn't an answer and there isn't a grade in this case.

'''Note:''' prior to 1.7.2 the fraction was expressed as a value between 0 and 1 in a <fraction> element and the answer value was '''not''' enclosed in <text> tags. This format of the essay question type is deprecated but will still be correctly imported if found (for now).

== Other question types ==

=== Cloze ===

It is supported, and depends on a special format for the <questiontext> tag.

=== Description response type===

This response type has no further tags other than those contained in the question header (such as <questiontext>).

=== Random matching ===

Moodle has a question type which consists of taking short answer questions in the same quiz and displaying them as a pair matching exercise. However Moodle is neither able to export nor import this question type.

==Text formats==

Moodle XML files should explicity specify the text format ('''html''', '''moodle_auto_format''', '''plain_text''' and '''markdown''' - these correspond to the constants , FORMAT_HTML, FORMAT_MOODLE, etc used in the Moodle code) for each piece of content. Note that, by default, the format should be specified on the parent of the <text> element. This is slightly odd, but a remnant of history.

If the format is not specified for the questiontext, then '''html''' is the default. If the format is not specified on any other part of the question, then the format of the questiontext is the default.

(This default changed around November 2011. Before that, the default was '''moodle_auto_format''' whenever the format was not specified.)

==Useful utilities==
*[http://vletools.com Online Moodle XML converter] Convert from existing text files glossaries and quizzes to Moodle XML format. Also can convert from Moodle XMl to text.
*[http://finemetronome.com/moodle/ Word Template for generating Moodle XML].

== See also ==
* [http://www.qedoc.org/index.php?title=Moodle_XML_format Quedoc's Moodle XML documentation]
* [[User:Frank Ralf/Moodle XML1]] (work in progress)
*[[Aiken format]]
*[[XML FAQ]]
*[[Import and export FAQ]]

[[ja:Moodle XMLフォーマット]]
[[de: Moodle XML-Format]]
[[fr:Format XML Moodle]]
[[es:Formato Moodle XML]]

Moodle XML format

2014-08-07T21:19:51Z

Nakohdo: /* See also */

{{Export questions}}
The XML Format is a Moodle-specific format for importing and exporting questions to be used with the [[Quiz module]]. The format has been developed within the Moodle Community but other software may support it to a greater or lesser degree.

==A word about validity (and CDATA)==

The XML parser assumes that the XML file is well formed and does not detect or report errors. If it is not you are very likely to get unexpected errors. If you are hand-coding the XML file it is strongly recommended that you pass it through some sort of XML verifier before importing into Moodle. A simple way to do this is to open the XML file using Firefox or Internet Explorer.

Note particularly that embedded HTML fragments should be within [http://en.wikipedia.org/wiki/CDATA CDATA sections]. CDATA example:

<code xml>
<questiontext format="html">
<text><![CDATA[
Now I can include any HTML that I 
wish. Without the CDATA, the HTML tags would break
the XML!!
]]>
</text>
</questiontext>
</code>

==Overall structure of XML file==

The file is enclosed by tags as follows. It is '''important''' to make sure the xml-line is really the first line of the file. A blank first line turns your otherwise compliant file into a source of frustration.

<code xml>
<?xml version="1.0" ?>
<quiz>
.
.
.
</quiz>
</code>

Within the <quiz> tags are any number of <question> tags. One of these <question> tags can be a dummy question with a ''category'' type to specify a category for the import/export.

<code xml>
<question type="category">
<category>
<text>$course$/XXXX</text>
</category>
</question>
</code>

Where XXXX is the new category name. If the category exists, the question(s) will be added to the existing course; otherwise a new category will be created. This only works if you have "Get category from file" checked.

Multiple categories can be specified in the same file. Just add another dummy 'category' question each time you would like to establish a new category and the questions that follow it will be placed there.

The file must be encoded in [[UTF8]]

Moodle XML import and export are balanced in functionality, so if you need to understand the format you can simply create some questions and export them to see what it looks like.

==Tags common to all question types==

A question is written as follows.

<code xml>
<question type="multichoice|truefalse|shortanswer|matching|cloze|essay|numerical|description">
<name>
<text>Name of question</text>
</name>
<questiontext format="html">
<text>What is the answer to this question?</text>
</questiontext>
.
.
.
</question>
</code>

"Format" selects the [[Formatting options]] for the question text. The options are '''html''' (the default), '''moodle_auto_format''', '''plain_text''' and '''markdown'''. The choice effects the way in which the text will be displayed.

Further tags, which usually include at least one <answer> tag, follow in the space marked with dots as child nodes to the <question> tag. The response-related tags are listed further down on this page. Various (optional?) tags are possible.

* tags (non-hierarchical keywords)
* penalty
* generalfeedback
* defaultgrade
* hidden

Even though question tags (non-hierarchical keyowords) are not fully supported in the question engine, they can be imported and exported via XML.

<code xml>
<question ...>
...
<tags>
<tag>
<text>keyword1</text>
</tag>
<tag>
<text>keyword2</text>
</tag>
...
</tags>
...
</question>
</code>

The <image> tag contains the url of any included image. Nested within the <image> tag may be an <image_base64> tag which contains the actual image data encoded in base64 [http://www.php.net/manual/en/function.base64-encode.php].

'''In the following question type examples the common parts of the question are not shown to improve clarity. It's a good idea to export some examples yourself to see a full example.'''

==Multiple choice==

MC questions have one <answer> tag for each choice. Each choice can carry feedback and score weighting (by using the fraction attribute). In addition, an MC question has the following tags:

* single ''(values: true/false)''
* shuffleanswers ''(values: 1/0)''
* correctfeedback
* partiallycorrectfeedback
* incorrectfeedback
* answernumbering (allowed values: 'none', 'abc', 'ABCD' or '123')

The <single> tag is used to distinguish single response (radio button) and multiple response (checkbox) variants.

<code xml>
<question type="multichoice">
<answer fraction="100">
<text>The correct answer</text>
<feedback><text>Correct!</text></feedback>
</answer>
<answer fraction="0">
<text>A distractor</text>
<feedback><text>Ooops!</text></feedback>
</answer>
<answer fraction="0">
<text>Another distractor</text>
<feedback><text>Ooops!</text></feedback>
</answer>
<shuffleanswers>1</shuffleanswers>
<single>true</single>
<answernumbering>abc</answernumbering>
</code>

== True/false ==

Two answer tags are given, one which is true, and one which is false. The fraction attribute of the answer tag identifies which option is correct (100) and which is false (0). Feedback is supported. The following example shows the format when true is the correct answer and false is wrong.

<code xml>
<question type="truefalse">
<answer fraction="100">
<text>true</text>
<feedback><text>Correct!</text></feedback>
</answer>
<answer fraction="0">
<text>false</text>
<feedback><text>Ooops!</text></feedback>
</answer>
</code>

== Short answer ==

The short answer question type supports alternative correct responses, each with its own weighting and feedback. The Moodle XML format uses one <answer> tag for each of the alternative correct answers.

The <usecase> tag toggles case-sensitivity with the values 1/0.

<code xml>
<question type="shortanswer">
<answer fraction="100">
<text>The correct answer</text>
<feedback><text>Correct!</text></feedback>
</answer>

<question type="shortanswer">
<answer fraction="100">
<text>The correct answer</text>
<feedback><text>Correct!</text></feedback>
</answer>
<answer fraction="100">
<text>An alternative answer</text>
<feedback><text>Correct!</text></feedback>
</answer>
</code>

== Numerical response ==

The following is a simplified version of the Moodle XML format for numerical responses.

<code xml>
<question type="numerical">
<answer fraction="100">
<text>23</text>
<feedback><text>Feedback</text></feedback>
</answer>
</code>

Moodle also supports a <tolerance> tag (how accurate must the number be?) and one or more <unit> tags. Unit tags have names and multipliers. E.g. if the main answer is in kilometres, an additional answer could be the equivalent in metres with a multiplier of 1000.

'''Note:''' prior to 1.7.2 the fraction was expressed as a value between 0 and 1 in a <fraction> element and the answer value was '''not''' enclosed in <text> tags. This format of the numerical question type is deprecated but will still be correctly imported if found (for now).

== Matching ==

Pair matching responses use the <shuffleanswers> tag to determine whether the order of the items should be randomized.
Each pair is contained inside a <subquestion> tag. The first item of each pair is contained with a <text> tag, while the second has an <answer> tag around it as well. Feedback and score weighting is not supported by Moodle for this response type.

<code xml>
<question type="matching">
<subquestion>
<text>This is the 1st item in the 1st pair.</text>
<answer>
<text>This is the 2nd item in the 1st pair.</text>
</answer>
</subquestion>
<subquestion>
<text>This is the 1st item in the 2nd pair.</text>
<answer>
<text>This is the 2nd item in the 2nd pair.</text>
</answer>
</subquestion>
<shuffleanswers>true</shuffleanswers>
</code>

== Essay ==

An example of the essay type question...

<code xml>
<question type="essay">
<answer fraction="0">
<text></text>
</answer>
</question>
</code>

There isn't an answer and there isn't a grade in this case.

'''Note:''' prior to 1.7.2 the fraction was expressed as a value between 0 and 1 in a <fraction> element and the answer value was '''not''' enclosed in <text> tags. This format of the essay question type is deprecated but will still be correctly imported if found (for now).

== Other question types ==

=== Cloze ===

It is supported, and depends on a special format for the <questiontext> tag.

=== Description response type===

This response type has no further tags other than those contained in the question header (such as <questiontext>).

=== Random matching ===

Moodle has a question type which consists of taking short answer questions in the same quiz and displaying them as a pair matching exercise. However Moodle is neither able to export nor import this question type.

==Text formats==

Moodle XML files should explicity specify the text format ('''html''', '''moodle_auto_format''', '''plain_text''' and '''markdown''' - these correspond to the constants , FORMAT_HTML, FORMAT_MOODLE, etc used in the Moodle code) for each piece of content. Note that, by default, the format should be specified on the parent of the <text> element. This is slightly odd, but a remnant of history.

If the format is not specified for the questiontext, then '''html''' is the default. If the format is not specified on any other part of the question, then the format of the questiontext is the default.

(This default changed around November 2011. Before that, the default was '''moodle_auto_format''' whenever the format was not specified.)

==Useful utilities==
*[http://vletools.com Online Moodle XML converter] Convert from existing text files glossaries and quizzes to Moodle XML format. Also can convert from Moodle XMl to text.
*[http://finemetronome.com/moodle/ Word Template for generating Moodle XML].

== See also ==
* [http://www.qedoc.org/en/index.php?title=Moodle_XML_format Quedoc's Moodle XML documentation]
* [[User:Frank Ralf/Moodle XML1]] (work in progress)
*[[Aiken format]]
*[[XML FAQ]]
*[[Import and export FAQ]]

[[ja:Moodle XMLフォーマット]]
[[de: Moodle XML-Format]]
[[fr:Format XML Moodle]]
[[es:Formato Moodle XML]]

XML FAQ

2013-10-15T14:56:07Z

Nakohdo: /* Is there only one kind of Moodle XML? */

{{Main page}}(If you don't find the answer to your question here, just post the question. There might be someone out there to provide the answer.)

==XML in general==

===Where do I find general information about XML?===
* http://www.w3schools.com/xml/default.asp - A host of information and hands-on examples
*http://en.wikipedia.org/wiki/XML - A good starting point

==Moodle XML==

===Is there only one kind of Moodle XML?===

No, there are (at least) two different kinds of Moodle XML:
# one for importing/exporting ''glossaries''
# and one for ''questions'' (quizzes), the latter being the one usually referred to as "Moodle XML".

Then there is XML in the SCORM/IMS packages that Moodle can import and must be able to handle. These packages are educational content that has been marked up in a special way to be able to be used in compatible Learning Management Systems.

The ''course backup and restore'' process also generates an XML file (inside the zip file) that contains all the information about the course.

===Where do I find documentation about Moodle XML?===

* The official documentation: [[Moodle XML]]
* A more thorough documentation: [http://www.qedoc.org/en/index.php?title=Moodle_XML_format Moodle XML format] by Quedoc
: [http://www.qedoc.org/en/index.php?title=Problems_when_transferring_XML_format_into_Moodle Problems when transferring XML format into Moodle]

* [[User:Frank Ralf/Moodle XML1]] (work in progress)

==Tools==

===Are there tools for converting to and from Moodle XML?===
* [http://vletools.com Moodle XML Converter] - allows to create XML from text files. Also can converse Moodle XML into text file. Supports quiz and glossary.
* [http://moodle.org/mod/forum/discuss.php?d=91224#p489764 Glossary to XML Converter]
:A simple HTML file which converts TSV data to XML using JavaScript
* Microsoft Office macros: http://finemetronome.com/moodle/
* OpenOffice XML filters (TBA see [[User:Frank_Ralf/Moodle_XML1#OpenOffice_.26_XML|User:Frank_Ralf/Moodle XML1 > OpenOffice & XML]] for some pointers)

===How can I view and edit XML files?===
XML is just text so you can view and edit it with any text editor. However, this isn't very easy for anything more than a trivial file. There are a number of dedicated XML editors available for many platforms. If you only need to view the XML, most browsers are able to render XML files. Some even let you view the source text and do some basic editing.

== See also ==

; Moodle Docs
* [[Import and export FAQ]]

; Contributed modules and plugins
* [http://moodle.org/mod/forum/discuss.php?d=161367 DocBook Module to Parse DocBook XML]

; Books
* [http://www.sitepoint.com/books/xml1/ No Nonsense XML Web Development With PHP] by Thomas Myer

[[Category:FAQ]]

[[de:XML FAQ]]

User:Frank Ralf/jQuery

2011-11-06T16:04:54Z

Nakohdo: /* Collapsible course list */

Some examples and proof of concept for using jQuery for enhancing Moodle usability.

You can try those code snippets without changing your Moodle installation by using the [[Firebug]] extension [http://firequery.binaryage.com/ FireQuery].

== Collapsible course list ==

<code javascript>
jQuery('.section h3').wrapInner('<a href="#" />') // make the heading clickable
.click( function(event) {
event.preventDefault();
jQuery(this).parent().find('ul.section').toggle(); // toggle the content of the section
})
jQuery('ul.section').hide(); // hide by default
</code>

User:Frank Ralf/jQuery

2011-11-06T16:02:38Z

Nakohdo:

Some examples and proof of concept for using jQuery for enhancing Moodle usability.

You can try those code snippets without changing your Moodle installation by using the [[Firebug]] extension [http://firequery.binaryage.com/ FireQuery].

== Collapsible course list ==

<code javascript>
jQuery('.section h3').wrapInner('<a href="#" />')
.click( function(event) {
event.preventDefault();
jQuery(this).parent().find('ul.section').toggle();
})
jQuery('ul.section').hide();
</code>

User:Frank Ralf/jQuery

2011-11-06T16:00:58Z

Nakohdo: /* Collapsible course list */

Some examples and proof of concept for using jQuery for enhancing Moodle usability.

== Collapsible course list ==

<code javascript>
jQuery('.section h3').wrapInner('<a href="#" />')
.click( function(event) {
event.preventDefault();
jQuery(this).parent().find('ul.section').toggle();
})
jQuery('ul.section').hide();
</code>

User:Frank Ralf/jQuery

2011-11-06T16:00:08Z

Nakohdo: /* Collapsible course list */

Some examples and proof of concept for using jQuery for enhancing Moodle usability.

== Collapsible course list ==

<syntaxhighlight lang="javascript">
jQuery('.section h3').wrapInner('<a href="#" />')
.click( function(event) {
event.preventDefault();
jQuery(this).parent().find('ul.section').toggle();
})
jQuery('ul.section').hide();
</syntaxhighlight>

User:Frank Ralf/jQuery

2011-11-06T15:59:40Z

Nakohdo: Created page with "Some examples and proof of concept for using jQuery for enhancing Moodle usability. == Collapsible course list == <syntaxhighlight lang="javascript"> jQuery('.section h3').wrap..."

User:Frank Ralf

2011-11-06T15:50:36Z

Nakohdo:

{{Note|
Due to the cloning of Moodle Docs there might be copies of these pages on [https://docs.moodle.org/19/en/User:Frank_Ralf Moodle 1.9 Docs] and [https://docs.moodle.org/dev/User:Frank_Ralf Moodle Dev Docs]. I intend to keep this pages here up to date.
--[[User:Frank Ralf|Frank Ralf]] 23:49, 6 November 2011 (WST)
}}

= What I am doing here =

I am exploring Moodle as an e-learning tool for teaching German as a foreign language to Japanese.

Here's [http://moodle.org/user/view.php?id=728638&course=5 my profile on moodle.org].

== Semantic HMTL ==
* [[User:Frank Ralf/Moodle HTML]]

== JavaScript ==
* http://moodle.org/mod/forum/discuss.php?d=106312
* http://tracker.moodle.org/browse/MDL-14542 (http://moodle.org/mod/forum/discuss.php?d=95743)

* I've started a little series on different aspects of JavaScript and Moodle:
*# [[User:Frank_Ralf/JavaScript1]]
*# [[User:Frank_Ralf/JavaScript2]]

* [http://moodle.org/mod/forum/discuss.php?d=151789 Why does Moodle 2.0 keep jumping about?] is suspected to be a JavaScript bug MDL-22372

=== Greasemonkey ===
I've started creating some little Greasemonkey user scripts:
* [http://moodle.org/mod/forum/discuss.php?d=138230 Enhancing Tracker Issue Links]
* TODO: coloring links to non-existing Moodle Doc pages red in the forums like on Moodle Docs: [[Non existing page]]

== Moodle forms ==
* [[User:Frank Ralf/Moodle forms1]]

== XML related stuff ==
* I am working on [[XML FAQ]] and [[Import and export FAQ]]
* At the moment I am trying to create a [http://en.wikipedia.org/wiki/XML_Schema_(W3C) XML Schma] for Moodle XML for validation purposes

* Also on my todo list:
** creating XSLT stylesheet for converting Moodle XML to and from different (human readable) formats
** creating macros for OpenOffice for offline quiz creation
* [http://books.evc-cit.info/odbook/ch09.html XML Filters in OOo]
* [http://www.ibm.com/developerworks/edu/x-dw-x-xsltopenoff.html Expand the editing capabilities of OpenOffice with XSLT]
* [http://moodle.org/mod/forum/discuss.php?d=123277 Importing into Moodle] on manual converting Excel to XML

I will start to collect some of my findings at [[/Moodle XML1]].

* Interesting discussion on [http://moodle.org/mod/forum/discuss.php?d=138895 Are there any standards for learning interaction data in XML?] - also I'm not quite sure where this is heading...

== Drupal integration ==
* I am also interested in integrating Moodle and '''Drupal''', the open source CMS
** My Drupal profile: http://drupal.org/user/216048
** Drupal in Education User Group: http://groups.drupal.org/drupal-education
** The ongoing discussion about Drupal and Moodle: http://groups.drupal.org/node/13600

* There's an interesting discussion in the Moodle Language Teaching course:
:'''''How can Moodle be more of a social networking site?'''''
:http://moodle.org/mod/forum/discuss.php?d=83963&mode=3
:I posted some more links regarding Drupal in education over there.

* I've started upgrading the [http://drupal.org/node/1058838 Moodle Integration] module for Drupal. --[[User:Frank Ralf|Frank Ralf]] 19:44, 29 August 2011 (WST)

== Learning Moodle programming ==
* I am taking part in the '''Introduction to Moodle Programming''' course (http://dev.moodle.org)

=== FirePHP Block ===
* I started work on a [http://moodle.org/mod/forum/discuss.php?d=119961 Moodle plugin for FirePHP].
* Now lives on https://github.com/nakohdo/moodle-block_firephp

=== Glossary List Block ===
Inspired by [http://moodle.org/mod/forum/discuss.php?d=20560 Using Keywords Glossary feature for language "correction"] by [[User:Joseph Rézeau|Joseph Rézeau]] I started dabbling in creating a block which shows all glossaries of the currently logged in user across all his/her courses. I use [[User:Frank Ralf/Glossary list]] for scribbling some ideas.

* [http://moodle.org/mod/forum/search.php?sourceid=Mozilla-search&id=5&search=This+module+cannot+be+added+to+this+course+yet!+ This module cannot be added to this course yet! (No file found at: ../mod/game/mod.html).]
* See tracker issue MDL-25155

=== Auto-link Hijacker ===
* A filter which hijacks glossary auto-links and redirects them to a URL of you choice.
* http://moodle.org/mod/data/view.php?d=13&rid=4906&filter=1
* https://github.com/nakohdo/moodle-filter_autolinkhijacker

=== NanoGong ===
* cloned & archived: https://docs.moodle.org/dev/User:Frank_Ralf/NanoGong
* current: [[/NanoGong]]

== Theming related stuff ==
* I am following the discussions on the [http://moodle.org/mod/forum/discuss.php?d=106312 Use of JavaScript in Moodle] and [http://moodle.org/mod/forum/discuss.php?d=108993 The Future of Moodle Templates?]

== Moodle Docs stuff ==
* [[/Subpage transclusion]] as a possible solution for avoiding duplicating documentation for different versions of Moodle, see ...
--[[User:Frank Ralf|Frank Ralf]] 07:39, 22 February 2011 (UTC)

== Miscellaneous ==

* I have created some pages in the Moodle documentation: [[Javascript FAQ]], [[CSS FAQ]], [[PHP FAQ]], [[Usability FAQ]], [[Database FAQ]], [[Development:Firebug]]

* I am watching the following issue in Moodle tracker:
:''Day names, month names and am/pm appear garbled in Chinese and Japanese on Windows servers''
:http://tracker.moodle.org/browse/MDL-14149

* [[/Experience_of_converting_a_module_to_Moodle_2|Experience of converting a module to Moodle 2]] by Sam Marshall --[[User:Frank Ralf|Frank Ralf]] 12:11, 23 June 2010 (UTC)

* [[/Moodle 2.1 sections proposal]] by Sam Marshall --[[User:Frank Ralf|Frank Ralf]] 18:05, 12 November 2010 (UTC)

== MoodleMoot 2011 in Elmshorn (Germany) ==

* [http://moodlemoot.moodle.de/mod/resource/view.php?id=1103 Call for Papers zur MoodleMoot 2011 in Elmshorn]
* https://docs.moodle.org/de/Benutzer:Frank_Ralf/MoodleMoot2011: my private notes, any feedback welcome

== Git ==
* I'm starting to get the hang of (g)it ... see [[/Git]] --[[User:Frank Ralf|Frank Ralf]] 03:49, 23 June 2011 (WST)
* [[/Git workflow]]

== Test, test, test ... ==
* [[Dev:Firefox]]

User:Frank Ralf

2011-11-06T15:49:25Z

Nakohdo:

{{Note|
Due to the cloning of Moodle Docs there might be copies of these pages on Moodle 1.9 Docs and Moodle Dev Docs. I intend to keep this pages here up to date.
--[[User:Frank Ralf|Frank Ralf]] 23:49, 6 November 2011 (WST)
}}

= What I am doing here =

I am exploring Moodle as an e-learning tool for teaching German as a foreign language to Japanese.

Here's [http://moodle.org/user/view.php?id=728638&course=5 my profile on moodle.org].

== Semantic HMTL ==
* [[User:Frank Ralf/Moodle HTML]]

== JavaScript ==
* http://moodle.org/mod/forum/discuss.php?d=106312
* http://tracker.moodle.org/browse/MDL-14542 (http://moodle.org/mod/forum/discuss.php?d=95743)

* I've started a little series on different aspects of JavaScript and Moodle:
*# [[User:Frank_Ralf/JavaScript1]]
*# [[User:Frank_Ralf/JavaScript2]]

* [http://moodle.org/mod/forum/discuss.php?d=151789 Why does Moodle 2.0 keep jumping about?] is suspected to be a JavaScript bug MDL-22372

=== Greasemonkey ===
I've started creating some little Greasemonkey user scripts:
* [http://moodle.org/mod/forum/discuss.php?d=138230 Enhancing Tracker Issue Links]
* TODO: coloring links to non-existing Moodle Doc pages red in the forums like on Moodle Docs: [[Non existing page]]

== Moodle forms ==
* [[User:Frank Ralf/Moodle forms1]]

== XML related stuff ==
* I am working on [[XML FAQ]] and [[Import and export FAQ]]
* At the moment I am trying to create a [http://en.wikipedia.org/wiki/XML_Schema_(W3C) XML Schma] for Moodle XML for validation purposes

* Also on my todo list:
** creating XSLT stylesheet for converting Moodle XML to and from different (human readable) formats
** creating macros for OpenOffice for offline quiz creation
* [http://books.evc-cit.info/odbook/ch09.html XML Filters in OOo]
* [http://www.ibm.com/developerworks/edu/x-dw-x-xsltopenoff.html Expand the editing capabilities of OpenOffice with XSLT]
* [http://moodle.org/mod/forum/discuss.php?d=123277 Importing into Moodle] on manual converting Excel to XML

I will start to collect some of my findings at [[/Moodle XML1]].

* Interesting discussion on [http://moodle.org/mod/forum/discuss.php?d=138895 Are there any standards for learning interaction data in XML?] - also I'm not quite sure where this is heading...

== Drupal integration ==
* I am also interested in integrating Moodle and '''Drupal''', the open source CMS
** My Drupal profile: http://drupal.org/user/216048
** Drupal in Education User Group: http://groups.drupal.org/drupal-education
** The ongoing discussion about Drupal and Moodle: http://groups.drupal.org/node/13600

* There's an interesting discussion in the Moodle Language Teaching course:
:'''''How can Moodle be more of a social networking site?'''''
:http://moodle.org/mod/forum/discuss.php?d=83963&mode=3
:I posted some more links regarding Drupal in education over there.

* I've started upgrading the [http://drupal.org/node/1058838 Moodle Integration] module for Drupal. --[[User:Frank Ralf|Frank Ralf]] 19:44, 29 August 2011 (WST)

== Learning Moodle programming ==
* I am taking part in the '''Introduction to Moodle Programming''' course (http://dev.moodle.org)

=== FirePHP Block ===
* I started work on a [http://moodle.org/mod/forum/discuss.php?d=119961 Moodle plugin for FirePHP].
* Now lives on https://github.com/nakohdo/moodle-block_firephp

=== Glossary List Block ===
Inspired by [http://moodle.org/mod/forum/discuss.php?d=20560 Using Keywords Glossary feature for language "correction"] by [[User:Joseph Rézeau|Joseph Rézeau]] I started dabbling in creating a block which shows all glossaries of the currently logged in user across all his/her courses. I use [[User:Frank Ralf/Glossary list]] for scribbling some ideas.

* [http://moodle.org/mod/forum/search.php?sourceid=Mozilla-search&id=5&search=This+module+cannot+be+added+to+this+course+yet!+ This module cannot be added to this course yet! (No file found at: ../mod/game/mod.html).]
* See tracker issue MDL-25155

=== Auto-link Hijacker ===
* A filter which hijacks glossary auto-links and redirects them to a URL of you choice.
* http://moodle.org/mod/data/view.php?d=13&rid=4906&filter=1
* https://github.com/nakohdo/moodle-filter_autolinkhijacker

=== NanoGong ===
* cloned & archived: https://docs.moodle.org/dev/User:Frank_Ralf/NanoGong
* current: [[/NanoGong]]

== Theming related stuff ==
* I am following the discussions on the [http://moodle.org/mod/forum/discuss.php?d=106312 Use of JavaScript in Moodle] and [http://moodle.org/mod/forum/discuss.php?d=108993 The Future of Moodle Templates?]

== Moodle Docs stuff ==
* [[/Subpage transclusion]] as a possible solution for avoiding duplicating documentation for different versions of Moodle, see ...
--[[User:Frank Ralf|Frank Ralf]] 07:39, 22 February 2011 (UTC)

== Miscellaneous ==

* I have created some pages in the Moodle documentation: [[Javascript FAQ]], [[CSS FAQ]], [[PHP FAQ]], [[Usability FAQ]], [[Database FAQ]], [[Development:Firebug]]

* I am watching the following issue in Moodle tracker:
:''Day names, month names and am/pm appear garbled in Chinese and Japanese on Windows servers''
:http://tracker.moodle.org/browse/MDL-14149

* [[/Experience_of_converting_a_module_to_Moodle_2|Experience of converting a module to Moodle 2]] by Sam Marshall --[[User:Frank Ralf|Frank Ralf]] 12:11, 23 June 2010 (UTC)

* [[/Moodle 2.1 sections proposal]] by Sam Marshall --[[User:Frank Ralf|Frank Ralf]] 18:05, 12 November 2010 (UTC)

== MoodleMoot 2011 in Elmshorn (Germany) ==

* [http://moodlemoot.moodle.de/mod/resource/view.php?id=1103 Call for Papers zur MoodleMoot 2011 in Elmshorn]
* https://docs.moodle.org/de/Benutzer:Frank_Ralf/MoodleMoot2011: my private notes, any feedback welcome

== Git ==
* I'm starting to get the hang of (g)it ... see [[/Git]] --[[User:Frank Ralf|Frank Ralf]] 03:49, 23 June 2011 (WST)
* [[/Git workflow]]

== Test, test, test ... ==
* [[Dev:Firefox]]

Git for Administrators

2011-11-03T17:53:40Z

Nakohdo: /* See also */

An alternative way to maintaining your Moodle server via [[CVS for Administrators|CVS]] is using Git. This page describes how to maintain a copy of Moodle on your production server which can easily be upgraded using Git. If you have customisations of Moodle core code, you are advised to follow the instructions in the [[Development:Quick Git start guide for Moodle development|Quick Git start guide for Moodle development]].

== Obtaining the code from Git ==

You can find the official Moodle git repository at git://git.moodle.org/moodle.git (with an official clone at git://github.com/moodle/moodle.git). To initialize your local checkout, use

git clone git://git.moodle.org/moodle.git (1)
cd moodle
git branch -a (2)
git branch --track local_21_STABLE origin/MOODLE_21_STABLE (3)
git checkout local_21_STABLE (4)

* The command (1) initializes the new local repository as a clone of the upstream moodle.git repository, known as the ''origin'' remote repository by default. It creates a new directory named ''moodle'', where it downloads all the files. This operation can take a while.
* The command (2) lists all available branches.
* Use the command (3) to create a new local branch called local_21_STABLE and set it to track the branch MOODLE_21_STABLE from the upstream repository.
* The command (4) actually switches to the newly created local branch. Note that the last two lines can be replaced with

git checkout -b --track local_21_STABLE origin/MOODLE_21_STABLE (3 + 4)

that creates a new local tracking branch and switches to it immediately.

The ''master'' local branch, automatically created by git-clone, can then be deleted with the command

git branch -d master

== Updating your installation ==

The Moodle development team performs integration and testing of fixed bugs every Monday and Tuesday. On Wednesday you can install all patches by updating your code. Check the [http://git.moodle.org/gw?p=moodle.git;a=summary shortlog] to see if the official repository has been already updated or not.

cd /path/to/your/moodle/checkout
git fetch (1)
git status (2)
git merge (3)

The command (1) downloads new updates from the remote repository without touching your local checkout. The command (2) displays the information about the eventual drift between you local version and the upstream one. The command (3) actually modifies your local files with the updates. The git-fetch + git-merge couple can be replaced with a single command

git pull (1 + 3)

== Installing a contributed extension from its Git repository ==

For example, let us say we want to install the [[Book module]] form its Git repository into our Moodle 2.0.

cd /path/to/your/moodle/checkout
cd mod (1)
git clone git://github.com/skodak/moodle-mod_book.git book (2)
cd book
git checkout -b MOODLE_20_STABLE origin/MOODLE_20_STABLE (3)
git branch -d master (4)

The command (1) changes the current directory into the ''mod'' folder of your local Moodle clone. The command (2) creates a new subdirectory ''book'' and makes a local clone of Petr Škoda's vanilla Book repository. The command (3) creates a new local branch that will track the remote branch with a Book version for Moodle 2.0. The command (4) deletes the ''master'' that was created automatically by git-clone in (2) as we do not want it in this production checkout.

Now it is wise to put the new directory mod/book/ to the list of ignored files of the main Moodle clone.

cd /path/to/your/moodle/checkout
echo /mod/book/ >> .git/info/exclude

To update your Moodle installation now, you must visit both Git repositories and pull changes from upstream.

cd /path/to/your/moodle/checkout
git pull
cd /path/to/your/moodle/checkout/mod/book
git pull

Writing a shell script with these lines in the root of Moodle installation is a very good idea. Otherwise it is easy to forget what Git repositories are there within the main Moodle repository.

== See also ==

; Moodle Docs
* [[Git FAQ]]
* [[CVS for Administrators]]
* [[Moodle versions]]
* For some screenshots see [[User:Frank_Ralf/Git]] (still work in progress)

; Moodle forum discussions
* [http://moodle.org/mod/forum/discuss.php?d=168094 GIT help needed]
* [http://moodle.org/mod/forum/discuss.php?d=165236 Best way to manage CONTRIB code with GIT]
* [http://moodle.org/mod/forum/discuss.php?d=167063 Handy Git tip for tracking 3rd-party modules and plugins]
* [http://moodle.org/mod/forum/discuss.php?d=167730 Moodle Git repositories]
* [http://moodle.org/mod/forum/discuss.php?d=183693 Git and CVS]

; External resources
* [http://www.kernel.org/pub/software/scm/git/docs/everyday.html Everyday GIT With 20 Commands Or So]
* [http://gitref.org/ Git Reference]
* [http://progit.org/book/ Pro Git book]

[[Category:Git]]
[[Category:Administrator]]

[[ja:管理者用Git]]

User:Frank Ralf

2011-08-29T11:44:10Z

Nakohdo: /* Drupal integration */

= What I am doing here =

I am exploring Moodle as an e-learning tool for teaching German as a foreign language to Japanese.

Here's [http://moodle.org/user/view.php?id=728638&course=5 my profile on moodle.org].

== Semantic HMTL ==
* [[User:Frank Ralf/Moodle HTML]]

== JavaScript ==
* http://moodle.org/mod/forum/discuss.php?d=106312
* http://tracker.moodle.org/browse/MDL-14542 (http://moodle.org/mod/forum/discuss.php?d=95743)

* I've started a little series on different aspects of JavaScript and Moodle:
*# [[User:Frank_Ralf/JavaScript1]]
*# [[User:Frank_Ralf/JavaScript2]]

* [http://moodle.org/mod/forum/discuss.php?d=151789 Why does Moodle 2.0 keep jumping about?] is suspected to be a JavaScript bug MDL-22372

=== Greasemonkey ===
I've started creating some little Greasemonkey user scripts:
* [http://moodle.org/mod/forum/discuss.php?d=138230 Enhancing Tracker Issue Links]
* TODO: coloring links to non-existing Moodle Doc pages red in the forums like on Moodle Docs: [[Non existing page]]

== Moodle forms ==
* [[User:Frank Ralf/Moodle forms1]]

== XML related stuff ==
* I am working on [[XML FAQ]] and [[Import and export FAQ]]
* At the moment I am trying to create a [http://en.wikipedia.org/wiki/XML_Schema_(W3C) XML Schma] for Moodle XML for validation purposes

* Also on my todo list:
** creating XSLT stylesheet for converting Moodle XML to and from different (human readable) formats
** creating macros for OpenOffice for offline quiz creation
* [http://books.evc-cit.info/odbook/ch09.html XML Filters in OOo]
* [http://www.ibm.com/developerworks/edu/x-dw-x-xsltopenoff.html Expand the editing capabilities of OpenOffice with XSLT]
* [http://moodle.org/mod/forum/discuss.php?d=123277 Importing into Moodle] on manual converting Excel to XML

I will start to collect some of my findings at [[/Moodle XML1]].

* Interesting discussion on [http://moodle.org/mod/forum/discuss.php?d=138895 Are there any standards for learning interaction data in XML?] - also I'm not quite sure where this is heading...

== Drupal integration ==
* I am also interested in integrating Moodle and '''Drupal''', the open source CMS
** My Drupal profile: http://drupal.org/user/216048
** Drupal in Education User Group: http://groups.drupal.org/drupal-education
** The ongoing discussion about Drupal and Moodle: http://groups.drupal.org/node/13600

* There's an interesting discussion in the Moodle Language Teaching course:
:'''''How can Moodle be more of a social networking site?'''''
:http://moodle.org/mod/forum/discuss.php?d=83963&mode=3
:I posted some more links regarding Drupal in education over there.

* I've started upgrading the [http://drupal.org/node/1058838 Moodle Integration] module for Drupal. --[[User:Frank Ralf|Frank Ralf]] 19:44, 29 August 2011 (WST)

== Learning Moodle programming ==
* I am taking part in the '''Introduction to Moodle Programming''' course (http://dev.moodle.org)

=== FirePHP Block ===
* I started work on a [http://moodle.org/mod/forum/discuss.php?d=119961 Moodle plugin for FirePHP].
* Now lives on https://github.com/nakohdo/moodle-block_firephp

=== Glossary List Block ===
Inspired by [http://moodle.org/mod/forum/discuss.php?d=20560 Using Keywords Glossary feature for language "correction"] by [[User:Joseph Rézeau|Joseph Rézeau]] I started dabbling in creating a block which shows all glossaries of the currently logged in user across all his/her courses. I use [[User:Frank Ralf/Glossary list]] for scribbling some ideas.

* [http://moodle.org/mod/forum/search.php?sourceid=Mozilla-search&id=5&search=This+module+cannot+be+added+to+this+course+yet!+ This module cannot be added to this course yet! (No file found at: ../mod/game/mod.html).]
* See tracker issue MDL-25155

=== Auto-link Hijacker ===
* A filter which hijacks glossary auto-links and redirects them to a URL of you choice.
* http://moodle.org/mod/data/view.php?d=13&rid=4906&filter=1
* https://github.com/nakohdo/moodle-filter_autolinkhijacker

=== NanoGong ===
* cloned & archived: https://docs.moodle.org/dev/User:Frank_Ralf/NanoGong
* current: [[/NanoGong]]

== Theming related stuff ==
* I am following the discussions on the [http://moodle.org/mod/forum/discuss.php?d=106312 Use of JavaScript in Moodle] and [http://moodle.org/mod/forum/discuss.php?d=108993 The Future of Moodle Templates?]

== Moodle Docs stuff ==
* [[/Subpage transclusion]] as a possible solution for avoiding duplicating documentation for different versions of Moodle, see ...
--[[User:Frank Ralf|Frank Ralf]] 07:39, 22 February 2011 (UTC)

== Miscellaneous ==

* I have created some pages in the Moodle documentation: [[Javascript FAQ]], [[CSS FAQ]], [[PHP FAQ]], [[Usability FAQ]], [[Database FAQ]], [[Development:Firebug]]

* I am watching the following issue in Moodle tracker:
:''Day names, month names and am/pm appear garbled in Chinese and Japanese on Windows servers''
:http://tracker.moodle.org/browse/MDL-14149

* [[/Experience_of_converting_a_module_to_Moodle_2|Experience of converting a module to Moodle 2]] by Sam Marshall --[[User:Frank Ralf|Frank Ralf]] 12:11, 23 June 2010 (UTC)

* [[/Moodle 2.1 sections proposal]] by Sam Marshall --[[User:Frank Ralf|Frank Ralf]] 18:05, 12 November 2010 (UTC)

== MoodleMoot 2011 in Elmshorn (Germany) ==

* [http://moodlemoot.moodle.de/mod/resource/view.php?id=1103 Call for Papers zur MoodleMoot 2011 in Elmshorn]
* https://docs.moodle.org/de/Benutzer:Frank_Ralf/MoodleMoot2011: my private notes, any feedback welcome

== Git ==
* I'm starting to get the hang of (g)it ... see [[/Git]] --[[User:Frank Ralf|Frank Ralf]] 03:49, 23 June 2011 (WST)
* [[/Git workflow]]

== Test, test, test ... ==
* [[Dev:Firefox]]

Git for Administrators

2011-08-22T17:50:47Z

Nakohdo: /* See also */

An alternative way to maintaining your Moodle server via [[CVS for Administrators|CVS]] is using Git. This page describes how to maintain a copy of Moodle on your production server which can easily be upgraded using Git. If you have customisations of Moodle core code, you are advised to follow the instructions in the [[Development:Quick Git start guide for Moodle development|Quick Git start guide for Moodle development]].

== Obtaining the code from Git ==

You can find the official Moodle git repository at git://git.moodle.org/moodle.git (with an official clone at git://github.com/moodle/moodle.git). To initialize your local checkout, use

git clone git://git.moodle.org/moodle.git (1)
cd moodle
git branch -a (2)
git branch --track local_19_STABLE origin/MOODLE_19_STABLE (3)
git checkout local_19_STABLE (4)

The command (1) initializes the new local repository as a clone of the upstream moodle.git repository. By default, this upstream repository will be known as 'origin' remote repository. The command (2) lists all available branches. Use the command (3) to create a new local branch called local_19_STABLE and set it to track the branch MOODLE_19_STABLE from the upstream repository. The command (4) actually switches to the newly created local branch. Note that the last two lines can be replaced with

git checkout -b local_19_STABLE origin/MOODLE_19_STABLE (3 + 4)

that creates a new local tracking branches and switches to it immediately.

== Updating your installation ==

The Moodle development team performs integration and testing of fixed bugs every Monday and Tuesday. On Wednesday you can install all patches by updating your code. Check the [http://git.moodle.org/gw?p=moodle.git;a=summary shortlog] to see if the official repository has been already updated or not.

cd /path/to/your/moodle/checkout
git fetch (1)
git status (2)
git merge (3)

The command (1) downloads new updates from the remote repository without touching your local checkout. The command (2) displays the information about the eventual drift between you local version and the upstream one. The command (3) actually modifies your local files with the updates. The git-fetch + git-merge couple can be replaced with a single command

git pull (1 + 3)

== Installing a contributed extension from its Git repository ==

For example, let us say we want to install the [[Book module]] form its Git repository into our Moodle 2.0.

cd /path/to/your/moodle/checkout
cd mod (1)
git clone git://github.com/skodak/moodle-mod_book.git book (2)
cd book
git checkout -b MOODLE_20_STABLE origin/MOODLE_20_STABLE (3)
git branch -d master (4)

The command (1) changes the current directory into the ''mod'' folder of your local Moodle clone. The command (2) creates a new subdirectory ''book'' and makes a local clone of Petr Škoda's vanilla Book repository. The command (3) creates a new local branch that will track the remote branch with a Book version for Moodle 2.0. The command (4) deletes the ''master'' that was created automatically by git-clone in (2) as we do not want it in this production checkout.

Now it is wise to put the new directory mod/book/ to the list of ignored files of the main Moodle clone.

cd /path/to/your/moodle/checkout
echo /mod/book/ >> .git/info/exclude

To update your Moodle installation now, you must visit both Git repositories and pull changes from upstream.

cd /path/to/your/moodle/checkout
git pull
cd /path/to/your/moodle/checkout/mod/book
git pull

Writing a shell script with these lines in the root of Moodle installation is a very good idea. Otherwise it is easy to forget what Git repositories are there within the main Moodle repository.

== See also ==

; Moodle Docs
* [[CVS for Administrators]]
* [[Moodle versions]]
* For some screenshots see [[User:Frank_Ralf/Git]] (still work in progress)

; Moodle forum discussions
* [http://moodle.org/mod/forum/discuss.php?d=168094 GIT help needed]
* [http://moodle.org/mod/forum/discuss.php?d=165236 Best way to manage CONTRIB code with GIT]
* [http://moodle.org/mod/forum/discuss.php?d=167063 Handy Git tip for tracking 3rd-party modules and plugins]
* [http://moodle.org/mod/forum/discuss.php?d=167730 Moodle Git repositories]
* [http://moodle.org/mod/forum/discuss.php?d=183693 Git and CVS]

; External resources
* [http://www.kernel.org/pub/software/scm/git/docs/everyday.html Everyday GIT With 20 Commands Or So]
* [http://gitref.org/ Git Reference]
* [http://progit.org/book/ Pro Git book]

[[Category:Git]]
[[Category:Administrator]]

User:Frank Ralf/NanoGong/1.9

2011-08-15T19:40:17Z

Nakohdo: /* POST message */

NanoGong for Moodle 1.9 also needs some updating.

== build_navigation() ==
Navigation needs to be updated to use build_navigation()

print_header() was sent a string as 3rd (-> NanoGongs -> NanoGong) parameter.
This is deprecated in favour of an array built by build_navigation(). Please upgrade your code.

* line 2539 of lib\weblib.php: call to debugging()
* line 61 of mod\nanogong\view.php: call to print_header()

* line 3759 of lib\weblib.php: call to debugging()
* line 37 of theme\standard\header.html: call to print_navigation()
* line 2765 of lib\weblib.php: call to include()
* line 61 of mod\nanogong\view.php: call to print_header()

See [[lib/weblib.php#function_build_navigation]]

=== Moodle 2.0 ===
* [[Navigation 2.0]]
* [[Navigation 2.0 implementation plan]]

== $cm ==
The field $cm->modname should be set if you call build_navigation with a $cm parameter.
If you get $cm using ''get_coursemodule_from_instance'' or '''get_coursemodule_from_id''',
this will be done automatically.

* line 3894 of lib\weblib.php: call to debugging()
* line 59 of mod\nanogong\view.php: call to build_navigation()

== "No sound has been submitted for the message." ==

=== Error message ===
No sound has been submitted for the message.

Stack trace:

* line 1664 of lib\deprecatedlib.php: call to debugging()
* line 88 of mod\nanogong\view.php: call to error()

=== That's how it should look like ===
[[File:NanoGong Test1.png]]
http://gong.ust.hk/moodle/mod/nanogong/view.php?id=32

=== POST message ===

; correct
POST /moodle/mod/nanogong/view.php?id=32&messageid=&action=new
title=testen&message=
&path=%2F2%2Fmoddata%2Fnanogong%2F4999%2F2011-08-16_030503.spx
&action=submit
http://gong.ust.hk/moodle/mod/nanogong/view.php?id=32

; wrong
POST /moodle19_git/moodle/mod/nanogong/view.php?id=61
title=Test3&message=&path=&action=submit
http://localhost/moodle19_git/moodle/mod/nanogong/view.php?id=61

=== Resources ===
Plugin page
* http://moodle.org/mod/data/view.php?d=13&rid=1209

See the following forum discussions:
* [http://moodle.org/mod/forum/discuss.php?d=92516 Release of NanoGong 2 with Full Moodle Integration]
* [http://moodle.org/mod/forum/discuss.php?d=135714 won't start recording]
* [http://moodle.org/mod/forum/discuss.php?d=136848 Nanogong bug?]

== Github repository ==
The current code is available at https://github.com/nakohdo/moodle-mod_nanogong

== See also: ==
* [http://gitorious.org/~doctorlard/moodle/doctorlards-moodle/commit/eac1256499273f638ee89dd14f2f1d0d5d65e433 Patch for adding NanoGong recording applet and HTMLArea button] by [http://moodle.org/user/profile.php?id=155540 Jonathan Harker]

[[Category:Moodle 1.9|NanoGong]]

User:Frank Ralf/NanoGong/1.9

2011-08-15T19:28:31Z

Nakohdo: /* Resources */

NanoGong for Moodle 1.9 also needs some updating.

== build_navigation() ==
Navigation needs to be updated to use build_navigation()

print_header() was sent a string as 3rd (-> NanoGongs -> NanoGong) parameter.
This is deprecated in favour of an array built by build_navigation(). Please upgrade your code.

* line 2539 of lib\weblib.php: call to debugging()
* line 61 of mod\nanogong\view.php: call to print_header()

* line 3759 of lib\weblib.php: call to debugging()
* line 37 of theme\standard\header.html: call to print_navigation()
* line 2765 of lib\weblib.php: call to include()
* line 61 of mod\nanogong\view.php: call to print_header()

See [[lib/weblib.php#function_build_navigation]]

=== Moodle 2.0 ===
* [[Navigation 2.0]]
* [[Navigation 2.0 implementation plan]]

== $cm ==
The field $cm->modname should be set if you call build_navigation with a $cm parameter.
If you get $cm using ''get_coursemodule_from_instance'' or '''get_coursemodule_from_id''',
this will be done automatically.

* line 3894 of lib\weblib.php: call to debugging()
* line 59 of mod\nanogong\view.php: call to build_navigation()

== "No sound has been submitted for the message." ==

=== Error message ===
No sound has been submitted for the message.

Stack trace:

* line 1664 of lib\deprecatedlib.php: call to debugging()
* line 88 of mod\nanogong\view.php: call to error()

=== That's how it should look like ===
[[File:NanoGong Test1.png]]
http://gong.ust.hk/moodle/mod/nanogong/view.php?id=32

=== POST message ===

; correct
POST /moodle/mod/nanogong/view.php?id=32&messageid=&action=new title=testen&message=&path=%2F2%2Fmoddata%2Fnanogong%2F4999%2F2011-08-16_030503.spx&action=submit
http://gong.ust.hk/moodle/mod/nanogong/view.php?id=32

; wrong
POST /moodle19_git/moodle/mod/nanogong/view.php?id=61 title=Test3&message=&path=&action=submit
http://localhost/moodle19_git/moodle/mod/nanogong/view.php?id=61

=== Resources ===
Plugin page
* http://moodle.org/mod/data/view.php?d=13&rid=1209

See the following forum discussions:
* [http://moodle.org/mod/forum/discuss.php?d=92516 Release of NanoGong 2 with Full Moodle Integration]
* [http://moodle.org/mod/forum/discuss.php?d=135714 won't start recording]
* [http://moodle.org/mod/forum/discuss.php?d=136848 Nanogong bug?]

== Github repository ==
The current code is available at https://github.com/nakohdo/moodle-mod_nanogong

== See also: ==
* [http://gitorious.org/~doctorlard/moodle/doctorlards-moodle/commit/eac1256499273f638ee89dd14f2f1d0d5d65e433 Patch for adding NanoGong recording applet and HTMLArea button] by [http://moodle.org/user/profile.php?id=155540 Jonathan Harker]

[[Category:Moodle 1.9|NanoGong]]

User:Frank Ralf/NanoGong/1.9

2011-08-15T18:02:18Z

Nakohdo: /* Resources */

NanoGong for Moodle 1.9 also needs some updating.

== build_navigation() ==
Navigation needs to be updated to use build_navigation()

print_header() was sent a string as 3rd (-> NanoGongs -> NanoGong) parameter.
This is deprecated in favour of an array built by build_navigation(). Please upgrade your code.

* line 2539 of lib\weblib.php: call to debugging()
* line 61 of mod\nanogong\view.php: call to print_header()

* line 3759 of lib\weblib.php: call to debugging()
* line 37 of theme\standard\header.html: call to print_navigation()
* line 2765 of lib\weblib.php: call to include()
* line 61 of mod\nanogong\view.php: call to print_header()

See [[lib/weblib.php#function_build_navigation]]

=== Moodle 2.0 ===
* [[Navigation 2.0]]
* [[Navigation 2.0 implementation plan]]

== $cm ==
The field $cm->modname should be set if you call build_navigation with a $cm parameter.
If you get $cm using ''get_coursemodule_from_instance'' or '''get_coursemodule_from_id''',
this will be done automatically.

* line 3894 of lib\weblib.php: call to debugging()
* line 59 of mod\nanogong\view.php: call to build_navigation()

== "No sound has been submitted for the message." ==

=== Error message ===
No sound has been submitted for the message.

Stack trace:

* line 1664 of lib\deprecatedlib.php: call to debugging()
* line 88 of mod\nanogong\view.php: call to error()

=== That's how it should look like ===
[[File:NanoGong Test1.png]]
http://gong.ust.hk/moodle/mod/nanogong/view.php?id=32

=== Resources ===
Plugin page
* http://moodle.org/mod/data/view.php?d=13&rid=1209

See the following forum discussions:
* [http://moodle.org/mod/forum/discuss.php?d=92516 Release of NanoGong 2 with Full Moodle Integration]
* [http://moodle.org/mod/forum/discuss.php?d=135714 won't start recording]
* [http://moodle.org/mod/forum/discuss.php?d=136848 Nanogong bug?]

== Github repository ==
The current code is available at https://github.com/nakohdo/moodle-mod_nanogong

== See also: ==
* [http://gitorious.org/~doctorlard/moodle/doctorlards-moodle/commit/eac1256499273f638ee89dd14f2f1d0d5d65e433 Patch for adding NanoGong recording applet and HTMLArea button] by [http://moodle.org/user/profile.php?id=155540 Jonathan Harker]

[[Category:Moodle 1.9|NanoGong]]

User:Frank Ralf/NanoGong/1.9

2011-08-15T17:42:37Z

Nakohdo: /* Error message */

NanoGong for Moodle 1.9 also needs some updating.

== build_navigation() ==
Navigation needs to be updated to use build_navigation()

print_header() was sent a string as 3rd (-> NanoGongs -> NanoGong) parameter.
This is deprecated in favour of an array built by build_navigation(). Please upgrade your code.

* line 2539 of lib\weblib.php: call to debugging()
* line 61 of mod\nanogong\view.php: call to print_header()

* line 3759 of lib\weblib.php: call to debugging()
* line 37 of theme\standard\header.html: call to print_navigation()
* line 2765 of lib\weblib.php: call to include()
* line 61 of mod\nanogong\view.php: call to print_header()

See [[lib/weblib.php#function_build_navigation]]

=== Moodle 2.0 ===
* [[Navigation 2.0]]
* [[Navigation 2.0 implementation plan]]

== $cm ==
The field $cm->modname should be set if you call build_navigation with a $cm parameter.
If you get $cm using ''get_coursemodule_from_instance'' or '''get_coursemodule_from_id''',
this will be done automatically.

* line 3894 of lib\weblib.php: call to debugging()
* line 59 of mod\nanogong\view.php: call to build_navigation()

== "No sound has been submitted for the message." ==

=== Error message ===
No sound has been submitted for the message.

Stack trace:

* line 1664 of lib\deprecatedlib.php: call to debugging()
* line 88 of mod\nanogong\view.php: call to error()

=== That's how it should look like ===
[[File:NanoGong Test1.png]]
http://gong.ust.hk/moodle/mod/nanogong/view.php?id=32

=== Resources ===
See the following forum discussions:
* [http://moodle.org/mod/forum/discuss.php?d=92516 Release of NanoGong 2 with Full Moodle Integration]
* [http://moodle.org/mod/forum/discuss.php?d=135714 won't start recording]

== Github repository ==
The current code is available at https://github.com/nakohdo/moodle-mod_nanogong

== See also: ==
* [http://gitorious.org/~doctorlard/moodle/doctorlards-moodle/commit/eac1256499273f638ee89dd14f2f1d0d5d65e433 Patch for adding NanoGong recording applet and HTMLArea button] by [http://moodle.org/user/profile.php?id=155540 Jonathan Harker]

[[Category:Moodle 1.9|NanoGong]]

User:Frank Ralf/NanoGong/1.9

2011-08-15T17:36:14Z

Nakohdo: /* "No sound has been submitted for the message." */

NanoGong for Moodle 1.9 also needs some updating.

== build_navigation() ==
Navigation needs to be updated to use build_navigation()

print_header() was sent a string as 3rd (-> NanoGongs -> NanoGong) parameter.
This is deprecated in favour of an array built by build_navigation(). Please upgrade your code.

* line 2539 of lib\weblib.php: call to debugging()
* line 61 of mod\nanogong\view.php: call to print_header()

* line 3759 of lib\weblib.php: call to debugging()
* line 37 of theme\standard\header.html: call to print_navigation()
* line 2765 of lib\weblib.php: call to include()
* line 61 of mod\nanogong\view.php: call to print_header()

See [[lib/weblib.php#function_build_navigation]]

=== Moodle 2.0 ===
* [[Navigation 2.0]]
* [[Navigation 2.0 implementation plan]]

== $cm ==
The field $cm->modname should be set if you call build_navigation with a $cm parameter.
If you get $cm using ''get_coursemodule_from_instance'' or '''get_coursemodule_from_id''',
this will be done automatically.

* line 3894 of lib\weblib.php: call to debugging()
* line 59 of mod\nanogong\view.php: call to build_navigation()

== "No sound has been submitted for the message." ==

=== Error message ===
No sound has been submitted for the message.
Stack trace:

* line 1664 of lib\deprecatedlib.php: call to debugging()
* line 88 of mod\nanogong\view.php: call to error()

=== That's how it should look like ===
[[File:NanoGong Test1.png]]
http://gong.ust.hk/moodle/mod/nanogong/view.php?id=32

=== Resources ===
See the following forum discussions:
* [http://moodle.org/mod/forum/discuss.php?d=92516 Release of NanoGong 2 with Full Moodle Integration]
* [http://moodle.org/mod/forum/discuss.php?d=135714 won't start recording]

== Github repository ==
The current code is available at https://github.com/nakohdo/moodle-mod_nanogong

== See also: ==
* [http://gitorious.org/~doctorlard/moodle/doctorlards-moodle/commit/eac1256499273f638ee89dd14f2f1d0d5d65e433 Patch for adding NanoGong recording applet and HTMLArea button] by [http://moodle.org/user/profile.php?id=155540 Jonathan Harker]

[[Category:Moodle 1.9|NanoGong]]

File:NanoGong Test1.png

2011-08-15T17:34:27Z

Nakohdo:

User:Frank Ralf/NanoGong/1.9

2011-08-15T17:32:30Z

Nakohdo: /* "No sound has been submitted for the message." */

User:Frank Ralf/NanoGong/1.9

2011-08-15T16:49:59Z

Nakohdo: moved back from the dev docs ;-)

User:Frank Ralf/Git

2011-08-15T12:05:28Z

Nakohdo: /* See also */

== Cloning Moodle to your local installation ==
* See [[Git for Administrators]], the following screenshots illustrate the steps described there.

[[File:Git cloning Moodle.png]]

=== Cloning to a new folder ===
[[File:Git cloning Moodle new folder.png]]

=== Moodle branches ===
[[File:Git remote Moodle branches.png]]

=== Checkout ===
[[File:Git checkout MOODLE 19 STABLE.png]]

== Deleting master branch ==
Don't know whether this is a good idea but I accidentally messed up my local Moodle 1.9 master branch by fetching Moodle 2.1 on top of it ...
* See the discussion in the Moodle General Developer Forum: [http://moodle.org/mod/forum/discuss.php?d=181720 Git: deleting local "master" branch]

=== Moodle 1.9 ===
[[File:Git delete master branch.png]]

That's the result:

[[File:Git only local branch left.png]]

=== Moodle 2.0 ===

[[File:Git delete local master branch 2.0.png]]

== Updating your Moodle installation ==

<code php>git fetch</code>

[[File:Git fetch.png| thumb | First try ...]]
[[File:Git branch fetch 2011-07-20.png| thumb |Second try ...]]

Following the [[User:Sam_Hemelryk/My_Moodle_Git_workflow| instructions by Sam Hemelryk]]:

=== Moodle 1.9 ===

==== fetch ====
[[File:Git fetch status 2011-07-20.png]]

==== merge ====
[[File:Git merge 2011-07-20.png]]

=== Moodle 2.0 ===

==== fetch ====
[[File:Git fetch Moodle 2.0.png]]

==== merge ====

git merge origin/MOODLE_20_STABLE

[[File:Git merge Moodle 2.0 2011-07-22.png]]

'''Note''': Updating these 500 files took only about 10 seconds!

== Maintaining your own contributed code ==

=== Copying the plug-in code to your Moodle installation ===
[[File:Git adding my custom plugin code.png]]

=== Making Git ignore your code ===
Put the folder names for your own code into the '''.git/info/exclude''' file in your Moodle clone, as the following excerpt from .gitignore describes. On Windows the .git folder is hidden by default so you will have to change your settings to show hidden files (Explorer > Tools > Folder settings ...).

# Example: if you deploy a contributed plugin mod/foobar into your site, put
# the following line into .git/info/exclude file in your Moodle clone:
# /mod/foobar/

That's how it looks:

# git ls-files --others --exclude-from=.git/info/exclude
# Lines that start with '#' are comments.
# For a project mostly in C, the following would be a good set of
# exclude patterns (uncomment them if you want to use them):
# *.[oa]
# *~
/blocks/firephp
/filter/autolinkhijacker

=== Setting up a remote repository on GitHub ===

See the instructions at:
* [[Dev:Git for developers]]
* [[Git repositories for contrib modules]]

=== Cloning the remote GitHub repository to your local Moodle installation ===

# Change to the parent folder for your plug-in
# Clone the repository: <code bash>git clone https://nakohdo@GitHub.com/nakohdo/moodle-filter_autolinkhijacker.git</code>
# Rename the folder to your plug-in's name
# Open Git Bash in that folder

=== Creating a local branch ===

# Open Git Bash in the plug-in folder
# Create new branch: <code bash>git branch MOODLE_19_STABLE</code>
# Change to the new branch: <code bash>git checkout MOODLE_19_STABLE</code>
#* Both steps in one: <code bash>git checkout -b MOODLE_19_STABLE</code>

=== Creating a remote branch ===

{{Note|
It might be better using "remote" first to create the remote branch.
And usually it's best if both branches have the same name.
--[[User:Frank Ralf|Frank Ralf]] 12:59, 18 July 2011 (WST)
}}

# Change to the correct local branch
# <code bash>git push origin -u MOODLE_19_STABLE</code>
#: Using different names for local and remote branch: <code bash>$ git push origin local_19_STABLE:MOODLE_19_STABLE </code>

[[File:Git creating remote branch.png | 600px]]

=== Deleting a remote branch ===
$ git push origin :testbranch
http://stackoverflow.com/questions/2003505/how-do-i-delete-a-git-branch-both-locally-and-in-github

== Git GUI (aka GitTk) ==

For launching the command line commands from a GUI. This will automatically be installed together with "Git for Windows" and is equally accessible from the explorer context menu.

[[File:Git Gui (moodle).png]]

=== Visualize branch history ===
[[File:Gitk moodle 2011-07-20.png]]

== See also ==
* [[User:Sam Hemelryk/My Moodle Git workflow]]

; Moodle forum discussions
* [http://moodle.org/mod/forum/discuss.php?d=168094 GIT help needed]
* [http://moodle.org/mod/forum/discuss.php?d=165236 Best way to manage CONTRIB code with GIT]
* [http://moodle.org/mod/forum/discuss.php?d=167063 Handy Git tip for tracking 3rd-party modules and plugins]
* [http://moodle.org/mod/forum/discuss.php?d=167730 Moodle Git repositories]

; External resources
* [http://www.kernel.org/pub/software/scm/git/docs/everyday.html Everyday GIT With 20 Commands Or So]
* [http://gitref.org/ Git Reference]
* [http://progit.org/book/ Pro Git book]

; Stackoverflow resources
* [http://stackoverflow.com/questions/1427785/how-to-set-desired-language-in-git-gui How to set desired language in git-gui?]
* [http://stackoverflow.com/questions/3841140/git-how-to-get-rid-of-the-annoying-crlf-message-on-msysgit-windows GIT: How to get rid of the annoying CRLF message on msysgit (windows)?]
* [http://stackoverflow.com/questions/6414515/how-to-do-rebase-interactive-in-a-windows-gui How to do rebase --interactive in a Windows GUI?]

[[Category:Git]]
[[Category:Developer]]

User:Frank Ralf

2011-08-15T11:42:52Z

Nakohdo: /* NanoGong */

= What I am doing here =

I am exploring Moodle as an e-learning tool for teaching German as a foreign language to Japanese.

Here's [http://moodle.org/user/view.php?id=728638&course=5 my profile on moodle.org].

== Semantic HMTL ==
* [[User:Frank Ralf/Moodle HTML]]

== JavaScript ==
* http://moodle.org/mod/forum/discuss.php?d=106312
* http://tracker.moodle.org/browse/MDL-14542 (http://moodle.org/mod/forum/discuss.php?d=95743)

* I've started a little series on different aspects of JavaScript and Moodle:
*# [[User:Frank_Ralf/JavaScript1]]
*# [[User:Frank_Ralf/JavaScript2]]

* [http://moodle.org/mod/forum/discuss.php?d=151789 Why does Moodle 2.0 keep jumping about?] is suspected to be a JavaScript bug MDL-22372

=== Greasemonkey ===
I've started creating some little Greasemonkey user scripts:
* [http://moodle.org/mod/forum/discuss.php?d=138230 Enhancing Tracker Issue Links]
* TODO: coloring links to non-existing Moodle Doc pages red in the forums like on Moodle Docs: [[Non existing page]]

== Moodle forms ==
* [[User:Frank Ralf/Moodle forms1]]

== XML related stuff ==
* I am working on [[XML FAQ]] and [[Import and export FAQ]]
* At the moment I am trying to create a [http://en.wikipedia.org/wiki/XML_Schema_(W3C) XML Schma] for Moodle XML for validation purposes

* Also on my todo list:
** creating XSLT stylesheet for converting Moodle XML to and from different (human readable) formats
** creating macros for OpenOffice for offline quiz creation
* [http://books.evc-cit.info/odbook/ch09.html XML Filters in OOo]
* [http://www.ibm.com/developerworks/edu/x-dw-x-xsltopenoff.html Expand the editing capabilities of OpenOffice with XSLT]
* [http://moodle.org/mod/forum/discuss.php?d=123277 Importing into Moodle] on manual converting Excel to XML

I will start to collect some of my findings at [[/Moodle XML1]].

* Interesting discussion on [http://moodle.org/mod/forum/discuss.php?d=138895 Are there any standards for learning interaction data in XML?] - also I'm not quite sure where this is heading...

== Drupal integration ==
* I am also interested in integrating Moodle and '''Drupal''', the open source CMS
** My Drupal profile: http://drupal.org/user/216048
** Drupal in Education User Group: http://groups.drupal.org/drupal-education
** The ongoing discussion about Drupal and Moodle: http://groups.drupal.org/node/13600

* There's an interesting discussion in the Moodle Language Teaching course:
:'''''How can Moodle be more of a social networking site?'''''
:http://moodle.org/mod/forum/discuss.php?d=83963&mode=3
:I posted some more links regarding Drupal in education over there.

== Learning Moodle programming ==
* I am taking part in the '''Introduction to Moodle Programming''' course (http://dev.moodle.org)

=== FirePHP Block ===
* I started work on a [http://moodle.org/mod/forum/discuss.php?d=119961 Moodle plugin for FirePHP].
* Now lives on https://github.com/nakohdo/moodle-block_firephp

=== Glossary List Block ===
Inspired by [http://moodle.org/mod/forum/discuss.php?d=20560 Using Keywords Glossary feature for language "correction"] by [[User:Joseph Rézeau|Joseph Rézeau]] I started dabbling in creating a block which shows all glossaries of the currently logged in user across all his/her courses. I use [[User:Frank Ralf/Glossary list]] for scribbling some ideas.

* [http://moodle.org/mod/forum/search.php?sourceid=Mozilla-search&id=5&search=This+module+cannot+be+added+to+this+course+yet!+ This module cannot be added to this course yet! (No file found at: ../mod/game/mod.html).]
* See tracker issue MDL-25155

=== Auto-link Hijacker ===
* A filter which hijacks glossary auto-links and redirects them to a URL of you choice.
* http://moodle.org/mod/data/view.php?d=13&rid=4906&filter=1
* https://github.com/nakohdo/moodle-filter_autolinkhijacker

=== NanoGong ===
* cloned & archived: https://docs.moodle.org/dev/User:Frank_Ralf/NanoGong
* current: [[/NanoGong]]

== Theming related stuff ==
* I am following the discussions on the [http://moodle.org/mod/forum/discuss.php?d=106312 Use of JavaScript in Moodle] and [http://moodle.org/mod/forum/discuss.php?d=108993 The Future of Moodle Templates?]

== Moodle Docs stuff ==
* [[/Subpage transclusion]] as a possible solution for avoiding duplicating documentation for different versions of Moodle, see ...
--[[User:Frank Ralf|Frank Ralf]] 07:39, 22 February 2011 (UTC)

== Miscellaneous ==

* I have created some pages in the Moodle documentation: [[Javascript FAQ]], [[CSS FAQ]], [[PHP FAQ]], [[Usability FAQ]], [[Database FAQ]], [[Development:Firebug]]

* I am watching the following issue in Moodle tracker:
:''Day names, month names and am/pm appear garbled in Chinese and Japanese on Windows servers''
:http://tracker.moodle.org/browse/MDL-14149

* [[/Experience_of_converting_a_module_to_Moodle_2|Experience of converting a module to Moodle 2]] by Sam Marshall --[[User:Frank Ralf|Frank Ralf]] 12:11, 23 June 2010 (UTC)

* [[/Moodle 2.1 sections proposal]] by Sam Marshall --[[User:Frank Ralf|Frank Ralf]] 18:05, 12 November 2010 (UTC)

== MoodleMoot 2011 in Elmshorn (Germany) ==

* [http://moodlemoot.moodle.de/mod/resource/view.php?id=1103 Call for Papers zur MoodleMoot 2011 in Elmshorn]
* https://docs.moodle.org/de/Benutzer:Frank_Ralf/MoodleMoot2011: my private notes, any feedback welcome

== Git ==
* I'm starting to get the hang of (g)it ... see [[/Git]] --[[User:Frank Ralf|Frank Ralf]] 03:49, 23 June 2011 (WST)
* [[/Git workflow]]

== Test, test, test ... ==
* [[Dev:Firefox]]

User:Frank Ralf/Git

2011-08-15T11:37:40Z

Nakohdo: /* See also */

== Cloning Moodle to your local installation ==
* See [[Git for Administrators]], the following screenshots illustrate the steps described there.

[[File:Git cloning Moodle.png]]

=== Cloning to a new folder ===
[[File:Git cloning Moodle new folder.png]]

=== Moodle branches ===
[[File:Git remote Moodle branches.png]]

=== Checkout ===
[[File:Git checkout MOODLE 19 STABLE.png]]

== Deleting master branch ==
Don't know whether this is a good idea but I accidentally messed up my local Moodle 1.9 master branch by fetching Moodle 2.1 on top of it ...
* See the discussion in the Moodle General Developer Forum: [http://moodle.org/mod/forum/discuss.php?d=181720 Git: deleting local "master" branch]

=== Moodle 1.9 ===
[[File:Git delete master branch.png]]

That's the result:

[[File:Git only local branch left.png]]

=== Moodle 2.0 ===

[[File:Git delete local master branch 2.0.png]]

== Updating your Moodle installation ==

<code php>git fetch</code>

[[File:Git fetch.png| thumb | First try ...]]
[[File:Git branch fetch 2011-07-20.png| thumb |Second try ...]]

Following the [[User:Sam_Hemelryk/My_Moodle_Git_workflow| instructions by Sam Hemelryk]]:

=== Moodle 1.9 ===

==== fetch ====
[[File:Git fetch status 2011-07-20.png]]

==== merge ====
[[File:Git merge 2011-07-20.png]]

=== Moodle 2.0 ===

==== fetch ====
[[File:Git fetch Moodle 2.0.png]]

==== merge ====

git merge origin/MOODLE_20_STABLE

[[File:Git merge Moodle 2.0 2011-07-22.png]]

'''Note''': Updating these 500 files took only about 10 seconds!

== Maintaining your own contributed code ==

=== Copying the plug-in code to your Moodle installation ===
[[File:Git adding my custom plugin code.png]]

=== Making Git ignore your code ===
Put the folder names for your own code into the '''.git/info/exclude''' file in your Moodle clone, as the following excerpt from .gitignore describes. On Windows the .git folder is hidden by default so you will have to change your settings to show hidden files (Explorer > Tools > Folder settings ...).

# Example: if you deploy a contributed plugin mod/foobar into your site, put
# the following line into .git/info/exclude file in your Moodle clone:
# /mod/foobar/

That's how it looks:

# git ls-files --others --exclude-from=.git/info/exclude
# Lines that start with '#' are comments.
# For a project mostly in C, the following would be a good set of
# exclude patterns (uncomment them if you want to use them):
# *.[oa]
# *~
/blocks/firephp
/filter/autolinkhijacker

=== Setting up a remote repository on GitHub ===

See the instructions at:
* [[Dev:Git for developers]]
* [[Git repositories for contrib modules]]

=== Cloning the remote GitHub repository to your local Moodle installation ===

# Change to the parent folder for your plug-in
# Clone the repository: <code bash>git clone https://nakohdo@GitHub.com/nakohdo/moodle-filter_autolinkhijacker.git</code>
# Rename the folder to your plug-in's name
# Open Git Bash in that folder

=== Creating a local branch ===

# Open Git Bash in the plug-in folder
# Create new branch: <code bash>git branch MOODLE_19_STABLE</code>
# Change to the new branch: <code bash>git checkout MOODLE_19_STABLE</code>
#* Both steps in one: <code bash>git checkout -b MOODLE_19_STABLE</code>

=== Creating a remote branch ===

{{Note|
It might be better using "remote" first to create the remote branch.
And usually it's best if both branches have the same name.
--[[User:Frank Ralf|Frank Ralf]] 12:59, 18 July 2011 (WST)
}}

# Change to the correct local branch
# <code bash>git push origin -u MOODLE_19_STABLE</code>
#: Using different names for local and remote branch: <code bash>$ git push origin local_19_STABLE:MOODLE_19_STABLE </code>

[[File:Git creating remote branch.png | 600px]]

=== Deleting a remote branch ===
$ git push origin :testbranch
http://stackoverflow.com/questions/2003505/how-do-i-delete-a-git-branch-both-locally-and-in-github

== Git GUI (aka GitTk) ==

For launching the command line commands from a GUI. This will automatically be installed together with "Git for Windows" and is equally accessible from the explorer context menu.

[[File:Git Gui (moodle).png]]

=== Visualize branch history ===
[[File:Gitk moodle 2011-07-20.png]]

== See also ==
; Moodle forum discussions
* [http://moodle.org/mod/forum/discuss.php?d=168094 GIT help needed]
* [http://moodle.org/mod/forum/discuss.php?d=165236 Best way to manage CONTRIB code with GIT]
* [http://moodle.org/mod/forum/discuss.php?d=167063 Handy Git tip for tracking 3rd-party modules and plugins]
* [http://moodle.org/mod/forum/discuss.php?d=167730 Moodle Git repositories]

; External resources
* [http://www.kernel.org/pub/software/scm/git/docs/everyday.html Everyday GIT With 20 Commands Or So]
* [http://gitref.org/ Git Reference]
* [http://progit.org/book/ Pro Git book]

; Stackoverflow resources
* [http://stackoverflow.com/questions/1427785/how-to-set-desired-language-in-git-gui How to set desired language in git-gui?]
* [http://stackoverflow.com/questions/3841140/git-how-to-get-rid-of-the-annoying-crlf-message-on-msysgit-windows GIT: How to get rid of the annoying CRLF message on msysgit (windows)?]
* [http://stackoverflow.com/questions/6414515/how-to-do-rebase-interactive-in-a-windows-gui How to do rebase --interactive in a Windows GUI?]

[[Category:Git]]
[[Category:Developer]]

User:Frank Ralf/Git

2011-08-15T11:37:24Z

Nakohdo: /* See also */

== Cloning Moodle to your local installation ==
* See [[Git for Administrators]], the following screenshots illustrate the steps described there.

[[File:Git cloning Moodle.png]]

=== Cloning to a new folder ===
[[File:Git cloning Moodle new folder.png]]

=== Moodle branches ===
[[File:Git remote Moodle branches.png]]

=== Checkout ===
[[File:Git checkout MOODLE 19 STABLE.png]]

== Deleting master branch ==
Don't know whether this is a good idea but I accidentally messed up my local Moodle 1.9 master branch by fetching Moodle 2.1 on top of it ...
* See the discussion in the Moodle General Developer Forum: [http://moodle.org/mod/forum/discuss.php?d=181720 Git: deleting local "master" branch]

=== Moodle 1.9 ===
[[File:Git delete master branch.png]]

That's the result:

[[File:Git only local branch left.png]]

=== Moodle 2.0 ===

[[File:Git delete local master branch 2.0.png]]

== Updating your Moodle installation ==

<code php>git fetch</code>

[[File:Git fetch.png| thumb | First try ...]]
[[File:Git branch fetch 2011-07-20.png| thumb |Second try ...]]

Following the [[User:Sam_Hemelryk/My_Moodle_Git_workflow| instructions by Sam Hemelryk]]:

=== Moodle 1.9 ===

==== fetch ====
[[File:Git fetch status 2011-07-20.png]]

==== merge ====
[[File:Git merge 2011-07-20.png]]

=== Moodle 2.0 ===

==== fetch ====
[[File:Git fetch Moodle 2.0.png]]

==== merge ====

git merge origin/MOODLE_20_STABLE

[[File:Git merge Moodle 2.0 2011-07-22.png]]

'''Note''': Updating these 500 files took only about 10 seconds!

== Maintaining your own contributed code ==

=== Copying the plug-in code to your Moodle installation ===
[[File:Git adding my custom plugin code.png]]

=== Making Git ignore your code ===
Put the folder names for your own code into the '''.git/info/exclude''' file in your Moodle clone, as the following excerpt from .gitignore describes. On Windows the .git folder is hidden by default so you will have to change your settings to show hidden files (Explorer > Tools > Folder settings ...).

# Example: if you deploy a contributed plugin mod/foobar into your site, put
# the following line into .git/info/exclude file in your Moodle clone:
# /mod/foobar/

That's how it looks:

# git ls-files --others --exclude-from=.git/info/exclude
# Lines that start with '#' are comments.
# For a project mostly in C, the following would be a good set of
# exclude patterns (uncomment them if you want to use them):
# *.[oa]
# *~
/blocks/firephp
/filter/autolinkhijacker

=== Setting up a remote repository on GitHub ===

See the instructions at:
* [[Dev:Git for developers]]
* [[Git repositories for contrib modules]]

=== Cloning the remote GitHub repository to your local Moodle installation ===

# Change to the parent folder for your plug-in
# Clone the repository: <code bash>git clone https://nakohdo@GitHub.com/nakohdo/moodle-filter_autolinkhijacker.git</code>
# Rename the folder to your plug-in's name
# Open Git Bash in that folder

=== Creating a local branch ===

# Open Git Bash in the plug-in folder
# Create new branch: <code bash>git branch MOODLE_19_STABLE</code>
# Change to the new branch: <code bash>git checkout MOODLE_19_STABLE</code>
#* Both steps in one: <code bash>git checkout -b MOODLE_19_STABLE</code>

=== Creating a remote branch ===

{{Note|
It might be better using "remote" first to create the remote branch.
And usually it's best if both branches have the same name.
--[[User:Frank Ralf|Frank Ralf]] 12:59, 18 July 2011 (WST)
}}

# Change to the correct local branch
# <code bash>git push origin -u MOODLE_19_STABLE</code>
#: Using different names for local and remote branch: <code bash>$ git push origin local_19_STABLE:MOODLE_19_STABLE </code>

[[File:Git creating remote branch.png | 600px]]

=== Deleting a remote branch ===
$ git push origin :testbranch
http://stackoverflow.com/questions/2003505/how-do-i-delete-a-git-branch-both-locally-and-in-github

== Git GUI (aka GitTk) ==

For launching the command line commands from a GUI. This will automatically be installed together with "Git for Windows" and is equally accessible from the explorer context menu.

[[File:Git Gui (moodle).png]]

=== Visualize branch history ===
[[File:Gitk moodle 2011-07-20.png]]

== See also ==
; Moodle forum discussions
* [http://moodle.org/mod/forum/discuss.php?d=168094 GIT help needed]
* [http://moodle.org/mod/forum/discuss.php?d=165236 Best way to manage CONTRIB code with GIT]
* [http://moodle.org/mod/forum/discuss.php?d=167063 Handy Git tip for tracking 3rd-party modules and plugins]
* [http://moodle.org/mod/forum/discuss.php?d=167730 Moodle Git repositories]

; External resources
* [http://www.kernel.org/pub/software/scm/git/docs/everyday.html Everyday GIT With 20 Commands Or So]
* [http://gitref.org/ Git Reference]
* [http://progit.org/book/ Pro Git book]

; Stackoverflow resources
* [http://stackoverflow.com/questions/1427785/how-to-set-desired-language-in-git-gui How to set desired language in git-gui?]
* [http://stackoverflow.com/questions/3841140/git-how-to-get-rid-of-the-annoying-crlf-message-on-msysgit-windows GIT: How to get rid of the annoying CRLF message on msysgit (windows)?]
* [http://stackoverflow.com/questions/6414515/how-to-do-rebase-interactive-in-a-windows-gui How to do rebase --interactive in a Windows GUI?]

[[Category:Git]]
[[Category:Development]]

User:Frank Ralf/NanoGong

2011-08-15T07:24:03Z

Nakohdo:

== Java settings ==
(Not sure if this is relevant, but better to keep in mind ...)
* see [[Question type plugin how to#Configuration settings for your question type]]

== Filter ==
General information on filters in Moodle 2.0 can be found at [[Filters 2.0]] and for developers at [[Filters 2.0]].

=== Language folder ===
Add language folder: '''\lang\en\''' and put '''filter_nanogong.php''' file with the following content there:

<code php>
$string['filtername'] = 'NanoGong';
</code>

[[File:Nanogong filter folder structure.png]]

=== Filter function ===

The filter function is wrapped inside a class:

<code php>
class filter_nanogong extends moodle_text_filter {
function filter($text, array $options = array()){
...
}
}
</code>

'''Note''': The callback function has to be '''outside''' this class definition!

=== Preventing caching ===

$CFG->currenttextiscacheable = false;

is deprecated, outcommented

=== File API ===

==== Proof of concept ====
* Instead of the old '''file.php''' the new File API uses '''pluginfile.php'''.
* I uploaded a test file (sentence.wav) as a resource to find out the internal URL Moodle uses for serving this file.
* I then added this full URL as attribute to the NanoGong tag:

<code php>
<nanogong
caption="Testing NanoGong..."
url="http://localhost/moodle-MOODLE_20_WEEKLY/pluginfile.php/130/mod_resource/content/1/sentence.wav"
/>
</code>

* As the URL is already in its full format I just commented out the following lines in '''filter.php'''.

<code php>
if ($url != "") {
if ($CFG->slasharguments)
$url; # = "{$CFG->wwwroot}/file.php$url";
else
$url; # = "{$CFG->wwwroot}/file.php?file=$url";
}
</code>

* This works as a proof of concept.

==== Getting closer ... ====

This modification does also work:

; NanoGong tag
<code php>
<nanogong
caption="Testing NanoGong..."
url="/130/mod_resource/content/1/sentence.wav"
/>
</code>

; filter.php
<code php>
if ($url != "") {
if ($CFG->slasharguments)
$url = "{$CFG->wwwroot}/pluginfile.php$url";
else
$url; # = "{$CFG->wwwroot}/file.php?file=$url";
}
</code>

==== Documentation ====
* see [[File API]] and [[Using the File API]]

* [[File_API#File_serving]]
* [[Using_the_file_API#Serving_files_to_users]]
* [[File_storage_conversion_Quiz_and_Questions#Serving_files]]

== See also ==

; Necessary updating for Moodle 1.9
* see [[User:Frank Ralf/NanoGong/1.9|subpage on Moodle 1.9]]

; Migrating to Moodle 2.0
* [[Migrating contrib code to 2.0]]
* [[Migrating to 2.0 checklist]]
* [[Migrating contrib code to 2.0/Experience of converting a module to Moodle 2]]

; Forums
* [http://moodle.org/mod/forum/discuss.php?d=170422 Release of NanoGong 4.1, an important update for Moodle users]
* [http://moodle.org/mod/forum/discuss.php?d=174922 NanoGong in Moodle 2.xxx]

; Moodle plugin database
* [http://moodle.org/mod/data/view.php?d=13&mode=list&perpage=50&search=&sort=44&order=ASC&advanced=0&filter=1&advanced=1&f_44=&f_45=nanogong all NanoGong plugins]

; NanoGong documentation
* http://gong.ust.hk/nanogong/moodle.html
* http://gong.ust.hk/nanogong/info_php.html
* [http://gong.ust.hk/moodle/course/view.php?id=2 Gong and NanoGong Demonstration]

[[Category:Moodle 2.0|NanoGong]]

User:Frank Ralf

2011-08-15T07:23:42Z

Nakohdo: /* NanoGong */

= What I am doing here =

I am exploring Moodle as an e-learning tool for teaching German as a foreign language to Japanese.

Here's [http://moodle.org/user/view.php?id=728638&course=5 my profile on moodle.org].

== Semantic HMTL ==
* [[User:Frank Ralf/Moodle HTML]]

== JavaScript ==
* http://moodle.org/mod/forum/discuss.php?d=106312
* http://tracker.moodle.org/browse/MDL-14542 (http://moodle.org/mod/forum/discuss.php?d=95743)

* I've started a little series on different aspects of JavaScript and Moodle:
*# [[User:Frank_Ralf/JavaScript1]]
*# [[User:Frank_Ralf/JavaScript2]]

* [http://moodle.org/mod/forum/discuss.php?d=151789 Why does Moodle 2.0 keep jumping about?] is suspected to be a JavaScript bug MDL-22372

=== Greasemonkey ===
I've started creating some little Greasemonkey user scripts:
* [http://moodle.org/mod/forum/discuss.php?d=138230 Enhancing Tracker Issue Links]
* TODO: coloring links to non-existing Moodle Doc pages red in the forums like on Moodle Docs: [[Non existing page]]

== Moodle forms ==
* [[User:Frank Ralf/Moodle forms1]]

== XML related stuff ==
* I am working on [[XML FAQ]] and [[Import and export FAQ]]
* At the moment I am trying to create a [http://en.wikipedia.org/wiki/XML_Schema_(W3C) XML Schma] for Moodle XML for validation purposes

* Also on my todo list:
** creating XSLT stylesheet for converting Moodle XML to and from different (human readable) formats
** creating macros for OpenOffice for offline quiz creation
* [http://books.evc-cit.info/odbook/ch09.html XML Filters in OOo]
* [http://www.ibm.com/developerworks/edu/x-dw-x-xsltopenoff.html Expand the editing capabilities of OpenOffice with XSLT]
* [http://moodle.org/mod/forum/discuss.php?d=123277 Importing into Moodle] on manual converting Excel to XML

I will start to collect some of my findings at [[/Moodle XML1]].

* Interesting discussion on [http://moodle.org/mod/forum/discuss.php?d=138895 Are there any standards for learning interaction data in XML?] - also I'm not quite sure where this is heading...

== Drupal integration ==
* I am also interested in integrating Moodle and '''Drupal''', the open source CMS
** My Drupal profile: http://drupal.org/user/216048
** Drupal in Education User Group: http://groups.drupal.org/drupal-education
** The ongoing discussion about Drupal and Moodle: http://groups.drupal.org/node/13600

* There's an interesting discussion in the Moodle Language Teaching course:
:'''''How can Moodle be more of a social networking site?'''''
:http://moodle.org/mod/forum/discuss.php?d=83963&mode=3
:I posted some more links regarding Drupal in education over there.

== Learning Moodle programming ==
* I am taking part in the '''Introduction to Moodle Programming''' course (http://dev.moodle.org)

=== FirePHP Block ===
* I started work on a [http://moodle.org/mod/forum/discuss.php?d=119961 Moodle plugin for FirePHP].
* Now lives on https://github.com/nakohdo/moodle-block_firephp

=== Glossary List Block ===
Inspired by [http://moodle.org/mod/forum/discuss.php?d=20560 Using Keywords Glossary feature for language "correction"] by [[User:Joseph Rézeau|Joseph Rézeau]] I started dabbling in creating a block which shows all glossaries of the currently logged in user across all his/her courses. I use [[User:Frank Ralf/Glossary list]] for scribbling some ideas.

* [http://moodle.org/mod/forum/search.php?sourceid=Mozilla-search&id=5&search=This+module+cannot+be+added+to+this+course+yet!+ This module cannot be added to this course yet! (No file found at: ../mod/game/mod.html).]
* See tracker issue MDL-25155

=== Auto-link Hijacker ===
* A filter which hijacks glossary auto-links and redirects them to a URL of you choice.
* http://moodle.org/mod/data/view.php?d=13&rid=4906&filter=1
* https://github.com/nakohdo/moodle-filter_autolinkhijacker

=== NanoGong ===
* archived: https://docs.moodle.org/dev/User:Frank_Ralf/NanoGong
* current: [[/NanoGong]]

== Theming related stuff ==
* I am following the discussions on the [http://moodle.org/mod/forum/discuss.php?d=106312 Use of JavaScript in Moodle] and [http://moodle.org/mod/forum/discuss.php?d=108993 The Future of Moodle Templates?]

== Moodle Docs stuff ==
* [[/Subpage transclusion]] as a possible solution for avoiding duplicating documentation for different versions of Moodle, see ...
--[[User:Frank Ralf|Frank Ralf]] 07:39, 22 February 2011 (UTC)

== Miscellaneous ==

* I have created some pages in the Moodle documentation: [[Javascript FAQ]], [[CSS FAQ]], [[PHP FAQ]], [[Usability FAQ]], [[Database FAQ]], [[Development:Firebug]]

* I am watching the following issue in Moodle tracker:
:''Day names, month names and am/pm appear garbled in Chinese and Japanese on Windows servers''
:http://tracker.moodle.org/browse/MDL-14149

* [[/Experience_of_converting_a_module_to_Moodle_2|Experience of converting a module to Moodle 2]] by Sam Marshall --[[User:Frank Ralf|Frank Ralf]] 12:11, 23 June 2010 (UTC)

* [[/Moodle 2.1 sections proposal]] by Sam Marshall --[[User:Frank Ralf|Frank Ralf]] 18:05, 12 November 2010 (UTC)

== MoodleMoot 2011 in Elmshorn (Germany) ==

* [http://moodlemoot.moodle.de/mod/resource/view.php?id=1103 Call for Papers zur MoodleMoot 2011 in Elmshorn]
* https://docs.moodle.org/de/Benutzer:Frank_Ralf/MoodleMoot2011: my private notes, any feedback welcome

== Git ==
* I'm starting to get the hang of (g)it ... see [[/Git]] --[[User:Frank Ralf|Frank Ralf]] 03:49, 23 June 2011 (WST)
* [[/Git workflow]]

== Test, test, test ... ==
* [[Dev:Firefox]]

User:Frank Ralf

2011-08-15T07:22:53Z

Nakohdo: /* Auto-link Hijacker */

= What I am doing here =

I am exploring Moodle as an e-learning tool for teaching German as a foreign language to Japanese.

Here's [http://moodle.org/user/view.php?id=728638&course=5 my profile on moodle.org].

== Semantic HMTL ==
* [[User:Frank Ralf/Moodle HTML]]

== JavaScript ==
* http://moodle.org/mod/forum/discuss.php?d=106312
* http://tracker.moodle.org/browse/MDL-14542 (http://moodle.org/mod/forum/discuss.php?d=95743)

* I've started a little series on different aspects of JavaScript and Moodle:
*# [[User:Frank_Ralf/JavaScript1]]
*# [[User:Frank_Ralf/JavaScript2]]

* [http://moodle.org/mod/forum/discuss.php?d=151789 Why does Moodle 2.0 keep jumping about?] is suspected to be a JavaScript bug MDL-22372

=== Greasemonkey ===
I've started creating some little Greasemonkey user scripts:
* [http://moodle.org/mod/forum/discuss.php?d=138230 Enhancing Tracker Issue Links]
* TODO: coloring links to non-existing Moodle Doc pages red in the forums like on Moodle Docs: [[Non existing page]]

== Moodle forms ==
* [[User:Frank Ralf/Moodle forms1]]

== XML related stuff ==
* I am working on [[XML FAQ]] and [[Import and export FAQ]]
* At the moment I am trying to create a [http://en.wikipedia.org/wiki/XML_Schema_(W3C) XML Schma] for Moodle XML for validation purposes

* Also on my todo list:
** creating XSLT stylesheet for converting Moodle XML to and from different (human readable) formats
** creating macros for OpenOffice for offline quiz creation
* [http://books.evc-cit.info/odbook/ch09.html XML Filters in OOo]
* [http://www.ibm.com/developerworks/edu/x-dw-x-xsltopenoff.html Expand the editing capabilities of OpenOffice with XSLT]
* [http://moodle.org/mod/forum/discuss.php?d=123277 Importing into Moodle] on manual converting Excel to XML

I will start to collect some of my findings at [[/Moodle XML1]].

* Interesting discussion on [http://moodle.org/mod/forum/discuss.php?d=138895 Are there any standards for learning interaction data in XML?] - also I'm not quite sure where this is heading...

== Drupal integration ==
* I am also interested in integrating Moodle and '''Drupal''', the open source CMS
** My Drupal profile: http://drupal.org/user/216048
** Drupal in Education User Group: http://groups.drupal.org/drupal-education
** The ongoing discussion about Drupal and Moodle: http://groups.drupal.org/node/13600

* There's an interesting discussion in the Moodle Language Teaching course:
:'''''How can Moodle be more of a social networking site?'''''
:http://moodle.org/mod/forum/discuss.php?d=83963&mode=3
:I posted some more links regarding Drupal in education over there.

== Learning Moodle programming ==
* I am taking part in the '''Introduction to Moodle Programming''' course (http://dev.moodle.org)

=== FirePHP Block ===
* I started work on a [http://moodle.org/mod/forum/discuss.php?d=119961 Moodle plugin for FirePHP].
* Now lives on https://github.com/nakohdo/moodle-block_firephp

=== Glossary List Block ===
Inspired by [http://moodle.org/mod/forum/discuss.php?d=20560 Using Keywords Glossary feature for language "correction"] by [[User:Joseph Rézeau|Joseph Rézeau]] I started dabbling in creating a block which shows all glossaries of the currently logged in user across all his/her courses. I use [[User:Frank Ralf/Glossary list]] for scribbling some ideas.

* [http://moodle.org/mod/forum/search.php?sourceid=Mozilla-search&id=5&search=This+module+cannot+be+added+to+this+course+yet!+ This module cannot be added to this course yet! (No file found at: ../mod/game/mod.html).]
* See tracker issue MDL-25155

=== Auto-link Hijacker ===
* A filter which hijacks glossary auto-links and redirects them to a URL of you choice.
* http://moodle.org/mod/data/view.php?d=13&rid=4906&filter=1
* https://github.com/nakohdo/moodle-filter_autolinkhijacker

=== NanoGong ===
* https://docs.moodle.org/dev/User:Frank_Ralf/NanoGong

== Theming related stuff ==
* I am following the discussions on the [http://moodle.org/mod/forum/discuss.php?d=106312 Use of JavaScript in Moodle] and [http://moodle.org/mod/forum/discuss.php?d=108993 The Future of Moodle Templates?]

== Moodle Docs stuff ==
* [[/Subpage transclusion]] as a possible solution for avoiding duplicating documentation for different versions of Moodle, see ...
--[[User:Frank Ralf|Frank Ralf]] 07:39, 22 February 2011 (UTC)

== Miscellaneous ==

* I have created some pages in the Moodle documentation: [[Javascript FAQ]], [[CSS FAQ]], [[PHP FAQ]], [[Usability FAQ]], [[Database FAQ]], [[Development:Firebug]]

* I am watching the following issue in Moodle tracker:
:''Day names, month names and am/pm appear garbled in Chinese and Japanese on Windows servers''
:http://tracker.moodle.org/browse/MDL-14149

* [[/Experience_of_converting_a_module_to_Moodle_2|Experience of converting a module to Moodle 2]] by Sam Marshall --[[User:Frank Ralf|Frank Ralf]] 12:11, 23 June 2010 (UTC)

* [[/Moodle 2.1 sections proposal]] by Sam Marshall --[[User:Frank Ralf|Frank Ralf]] 18:05, 12 November 2010 (UTC)

== MoodleMoot 2011 in Elmshorn (Germany) ==

* [http://moodlemoot.moodle.de/mod/resource/view.php?id=1103 Call for Papers zur MoodleMoot 2011 in Elmshorn]
* https://docs.moodle.org/de/Benutzer:Frank_Ralf/MoodleMoot2011: my private notes, any feedback welcome

== Git ==
* I'm starting to get the hang of (g)it ... see [[/Git]] --[[User:Frank Ralf|Frank Ralf]] 03:49, 23 June 2011 (WST)
* [[/Git workflow]]

== Test, test, test ... ==
* [[Dev:Firefox]]

User:Frank Ralf/NanoGong

2011-08-13T20:17:54Z

Nakohdo:

Template:Moved to dev docs

2011-08-13T20:17:20Z

Nakohdo: changed variable to FULLPAGENAME to respect namespace (e.g. User:)

This development related page is now located in the [[:dev:Main_Page|Dev docs]].

See the [[:dev:{{FULLPAGENAME}}|{{FULLPAGENAME}}]] page in the Dev docs.

<includeonly>[[Category:Moved_to_dev_docs]]</includeonly>
<noinclude>This template will categorize articles that include it into [[:Category:Moved_to_dev_docs]].</noinclude>

User:Frank Ralf/NanoGong

2011-08-13T20:15:22Z

Nakohdo:

{{Moved_to_dev_docs}}

{{Note|
The correct new page address is https://docs.moodle.org/dev/User:Frank_Ralf/NanoGong.
--[[User:Frank Ralf|Frank Ralf]] 04:15, 14 August 2011 (WST)
}}

User:Frank Ralf

2011-08-12T10:00:07Z

Nakohdo: /* Miscellaneous */

= What I am doing here =

I am exploring Moodle as an e-learning tool for teaching German as a foreign language to Japanese.

Here's [http://moodle.org/user/view.php?id=728638&course=5 my profile on moodle.org].

== Semantic HMTL ==
* [[User:Frank Ralf/Moodle HTML]]

== JavaScript ==
* http://moodle.org/mod/forum/discuss.php?d=106312
* http://tracker.moodle.org/browse/MDL-14542 (http://moodle.org/mod/forum/discuss.php?d=95743)

* I've started a little series on different aspects of JavaScript and Moodle:
*# [[User:Frank_Ralf/JavaScript1]]
*# [[User:Frank_Ralf/JavaScript2]]

* [http://moodle.org/mod/forum/discuss.php?d=151789 Why does Moodle 2.0 keep jumping about?] is suspected to be a JavaScript bug MDL-22372

=== Greasemonkey ===
I've started creating some little Greasemonkey user scripts:
* [http://moodle.org/mod/forum/discuss.php?d=138230 Enhancing Tracker Issue Links]
* TODO: coloring links to non-existing Moodle Doc pages red in the forums like on Moodle Docs: [[Non existing page]]

== Moodle forms ==
* [[User:Frank Ralf/Moodle forms1]]

== XML related stuff ==
* I am working on [[XML FAQ]] and [[Import and export FAQ]]
* At the moment I am trying to create a [http://en.wikipedia.org/wiki/XML_Schema_(W3C) XML Schma] for Moodle XML for validation purposes

* Also on my todo list:
** creating XSLT stylesheet for converting Moodle XML to and from different (human readable) formats
** creating macros for OpenOffice for offline quiz creation
* [http://books.evc-cit.info/odbook/ch09.html XML Filters in OOo]
* [http://www.ibm.com/developerworks/edu/x-dw-x-xsltopenoff.html Expand the editing capabilities of OpenOffice with XSLT]
* [http://moodle.org/mod/forum/discuss.php?d=123277 Importing into Moodle] on manual converting Excel to XML

I will start to collect some of my findings at [[/Moodle XML1]].

* Interesting discussion on [http://moodle.org/mod/forum/discuss.php?d=138895 Are there any standards for learning interaction data in XML?] - also I'm not quite sure where this is heading...

== Drupal integration ==
* I am also interested in integrating Moodle and '''Drupal''', the open source CMS
** My Drupal profile: http://drupal.org/user/216048
** Drupal in Education User Group: http://groups.drupal.org/drupal-education
** The ongoing discussion about Drupal and Moodle: http://groups.drupal.org/node/13600

* There's an interesting discussion in the Moodle Language Teaching course:
:'''''How can Moodle be more of a social networking site?'''''
:http://moodle.org/mod/forum/discuss.php?d=83963&mode=3
:I posted some more links regarding Drupal in education over there.

== Learning Moodle programming ==
* I am taking part in the '''Introduction to Moodle Programming''' course (http://dev.moodle.org)

=== FirePHP Block ===
* I started work on a [http://moodle.org/mod/forum/discuss.php?d=119961 Moodle plugin for FirePHP].
* Now lives on https://github.com/nakohdo/moodle-block_firephp

=== Glossary List Block ===
Inspired by [http://moodle.org/mod/forum/discuss.php?d=20560 Using Keywords Glossary feature for language "correction"] by [[User:Joseph Rézeau|Joseph Rézeau]] I started dabbling in creating a block which shows all glossaries of the currently logged in user across all his/her courses. I use [[User:Frank Ralf/Glossary list]] for scribbling some ideas.

* [http://moodle.org/mod/forum/search.php?sourceid=Mozilla-search&id=5&search=This+module+cannot+be+added+to+this+course+yet!+ This module cannot be added to this course yet! (No file found at: ../mod/game/mod.html).]
* See tracker issue MDL-25155

=== Auto-link Hijacker ===
* A filter which hijacks glossary auto-links and redirects them to a URL of you choice.
* http://moodle.org/mod/data/view.php?d=13&rid=4906&filter=1
* https://github.com/nakohdo/moodle-filter_autolinkhijacker

== Theming related stuff ==
* I am following the discussions on the [http://moodle.org/mod/forum/discuss.php?d=106312 Use of JavaScript in Moodle] and [http://moodle.org/mod/forum/discuss.php?d=108993 The Future of Moodle Templates?]

== Moodle Docs stuff ==
* [[/Subpage transclusion]] as a possible solution for avoiding duplicating documentation for different versions of Moodle, see ...
--[[User:Frank Ralf|Frank Ralf]] 07:39, 22 February 2011 (UTC)

== Miscellaneous ==

* I have created some pages in the Moodle documentation: [[Javascript FAQ]], [[CSS FAQ]], [[PHP FAQ]], [[Usability FAQ]], [[Database FAQ]], [[Development:Firebug]]

* I am watching the following issue in Moodle tracker:
:''Day names, month names and am/pm appear garbled in Chinese and Japanese on Windows servers''
:http://tracker.moodle.org/browse/MDL-14149

* [[/Experience_of_converting_a_module_to_Moodle_2|Experience of converting a module to Moodle 2]] by Sam Marshall --[[User:Frank Ralf|Frank Ralf]] 12:11, 23 June 2010 (UTC)

* [[/Moodle 2.1 sections proposal]] by Sam Marshall --[[User:Frank Ralf|Frank Ralf]] 18:05, 12 November 2010 (UTC)

== MoodleMoot 2011 in Elmshorn (Germany) ==

* [http://moodlemoot.moodle.de/mod/resource/view.php?id=1103 Call for Papers zur MoodleMoot 2011 in Elmshorn]
* https://docs.moodle.org/de/Benutzer:Frank_Ralf/MoodleMoot2011: my private notes, any feedback welcome

== Git ==
* I'm starting to get the hang of (g)it ... see [[/Git]] --[[User:Frank Ralf|Frank Ralf]] 03:49, 23 June 2011 (WST)
* [[/Git workflow]]

== Test, test, test ... ==
* [[Dev:Firefox]]

User:Frank Ralf/Subpage transclusion

2011-08-12T09:33:39Z

Nakohdo: /* MediaWiki documentation */

This is only for testing purposes.

== MediaWiki documentation ==

"One can cut and paste the text to be transcluded into a subpage, then use the name of the subpage in the transclusion template. This approach can only be used with subpages from User, Talk or Wikipedia pages; currently, subpages cannot be created from main article pages.

Example: you want to discuss the deletion and redirecting of Pussycat to Cat. First, create the subpage Talk:Pussycat/Let's delete Pussycat!, write your comment into it, then transclude it in Talk:Pussycat and Talk:Cat using the template {{Talk:Pussycat/Let's delete Pussycat!}}. Comments posted in either talk page will be shown in both."
http://www.mediawiki.org/wiki/Help:Transclusion#Subpages

== General information ==

Instead of just linking to a subpage like so:

<nowiki>[[/general information]]</nowiki>

you can use MediaWiki's [http://www.mediawiki.org/wiki/Help:Transclusion#Subpages transclusion mechanismen] to directly integrate the content of the subpage at any other place in the wiki.

The following template is used to pull the content from a subpage of this page:
<nowiki>{{/general information}}</nowiki>

{{Note|
Below the following line comes the external (transcluded) content.
}}

----

{{/general information}}

== Moodle 1.9 ==

{{Moodle 1.9}}

This is information only relevant for Moodle 1.9. This information is written directly on this page.

== Moodle 2.0 ==

{{Moodle 2.0}}

This is information only relevant for Moodle 2.0. This information is written directly on this page.

== See also: ==
* [[MoodleDocs:Transclusion]]

User:Frank Ralf/Subpage transclusion

2011-08-12T09:28:45Z

Nakohdo: /* General information */

This is only for testing purposes.

== MediaWiki documentation ==

One can cut and paste the text to be transcluded into a subpage, then use the name of the subpage in the transclusion template. This approach can only be used with subpages from User, Talk or Wikipedia pages; currently, subpages cannot be created from main article pages.

Example: you want to discuss the deletion and redirecting of Pussycat to Cat. First, create the subpage Talk:Pussycat/Let's delete Pussycat!, write your comment into it, then transclude it in Talk:Pussycat and Talk:Cat using the template {{Talk:Pussycat/Let's delete Pussycat!}}. Comments posted in either talk page will be shown in both.
http://www.mediawiki.org/wiki/Help:Transclusion#Subpages

== General information ==

Instead of just linking to a subpage like so:

<nowiki>[[/general information]]</nowiki>

you can use MediaWiki's [http://www.mediawiki.org/wiki/Help:Transclusion#Subpages transclusion mechanismen] to directly integrate the content of the subpage at any other place in the wiki.

The following template is used to pull the content from a subpage of this page:
<nowiki>{{/general information}}</nowiki>

{{Note|
Below the following line comes the external (transcluded) content.
}}

----

{{/general information}}

== Moodle 1.9 ==

{{Moodle 1.9}}

This is information only relevant for Moodle 1.9. This information is written directly on this page.

== Moodle 2.0 ==

{{Moodle 2.0}}

This is information only relevant for Moodle 2.0. This information is written directly on this page.

== See also: ==
* [[MoodleDocs:Transclusion]]

Themes

2011-07-25T07:06:55Z

Nakohdo:

{{Themes}}

{{Note|
This page describes what is mostly suitable for v1.9. Please feel free to update it to more recent information.
}}

A Moodle theme is a pre-designed user "view" (interface) that can be changed by the site administrator, teacher, or student. While robust, it does not affect how Moodle functions, just how it looks. Moodle comes with a standard set of themes and there is a [http://moodle.org/mod/data/view.php?id=6552 large free library] available to download.

==Moodle themes==

Themes may be [[Theme settings|selected]] at site level, course level and/or user level as long as the Moodle site has been configured to allow changes at these levels.

== Installing a theme ==

To install a theme:
# Unzip the .zip file to an empty local directory.
# Upload folder to your web server to the /moodle/theme/[Theme Name]. (Replace [Theme Name] with the name of the theme you have downloaded.) Ensure the new theme folder and its contents are readable by the webserver. Change Read and Write permissions (CHMOD) for the files and folder to 755 - Owner read/write/execute, Group read/execute, Everyone read/execute. Incorrect permissions may prevent display of the newly installed theme.
# Choose your new theme from within Moodle via ''Administration > Appearance > Themes > Theme selector'' (version 1.7+) or ''Administration > Configuration > Themes'' (older versions).

See [[Installing a new theme]] for more information.

==Themes in standard install==

Themes included in Moodle 1.9 are [[Chameleon theme|chameleon]], cornflower, [[Custom corners theme|custom corners]], formal white, metal, oceanblue, orangewhite, orangewhitepda, standard (default), standardblue, standardgreen, standardlogo, standardred, standardwhite, wood. See [[Standard themes]] for screen shots of each.

==See also==

* [http://www.youtube.com/watch?v=pPUB_ReBPeg Installing 3rd Party Modules and Themes in Moodle video]
* [[Themes FAQ]]
* [[:dev:Theme_development|Theme development]]
* [[Development: Themes 2.0]]

[[es:Temas]]
[[eu:Itxurak]]
[[de:Designs]]
[[fr:Thèmes]]
[[ja:テーマ]]
[[pt:Temas]]

User:Frank Ralf/Git

2011-07-22T17:23:52Z

Nakohdo: /* merge */

== Cloning Moodle to your local installation ==
* See [[Git for Administrators]], the following screenshots illustrate the steps described there.

[[File:Git cloning Moodle.png]]

=== Cloning to a new folder ===
[[File:Git cloning Moodle new folder.png]]

=== Moodle branches ===
[[File:Git remote Moodle branches.png]]

=== Checkout ===
[[File:Git checkout MOODLE 19 STABLE.png]]

== Deleting master branch ==
Don't know whether this is a good idea but I accidentally messed up my local Moodle 1.9 master branch by fetching Moodle 2.1 on top of it ...
* See the discussion in the Moodle General Developer Forum: [http://moodle.org/mod/forum/discuss.php?d=181720 Git: deleting local "master" branch]

=== Moodle 1.9 ===
[[File:Git delete master branch.png]]

That's the result:

[[File:Git only local branch left.png]]

=== Moodle 2.0 ===

[[File:Git delete local master branch 2.0.png]]

== Updating your Moodle installation ==

<code php>git fetch</code>

[[File:Git fetch.png| thumb | First try ...]]
[[File:Git branch fetch 2011-07-20.png| thumb |Second try ...]]

Following the [[User:Sam_Hemelryk/My_Moodle_Git_workflow| instructions by Sam Hemelryk]]:

=== Moodle 1.9 ===

==== fetch ====
[[File:Git fetch status 2011-07-20.png]]

==== merge ====
[[File:Git merge 2011-07-20.png]]

=== Moodle 2.0 ===

==== fetch ====
[[File:Git fetch Moodle 2.0.png]]

==== merge ====

git merge origin/MOODLE_20_STABLE

[[File:Git merge Moodle 2.0 2011-07-22.png]]

'''Note''': Updating these 500 files took only about 10 seconds!

== Maintaining your own contributed code ==

=== Copying the plug-in code to your Moodle installation ===
[[File:Git adding my custom plugin code.png]]

=== Making Git ignore your code ===
Put the folder names for your own code into the '''.git/info/exclude''' file in your Moodle clone, as the following excerpt from .gitignore describes. On Windows the .git folder is hidden by default so you will have to change your settings to show hidden files (Explorer > Tools > Folder settings ...).

# Example: if you deploy a contributed plugin mod/foobar into your site, put
# the following line into .git/info/exclude file in your Moodle clone:
# /mod/foobar/

That's how it looks:

# git ls-files --others --exclude-from=.git/info/exclude
# Lines that start with '#' are comments.
# For a project mostly in C, the following would be a good set of
# exclude patterns (uncomment them if you want to use them):
# *.[oa]
# *~
/blocks/firephp
/filter/autolinkhijacker

=== Setting up a remote repository on GitHub ===

See the instructions at:
* [[Dev:Git for developers]]
* [[Git repositories for contrib modules]]

=== Cloning the remote GitHub repository to your local Moodle installation ===

# Change to the parent folder for your plug-in
# Clone the repository: <code bash>git clone https://nakohdo@GitHub.com/nakohdo/moodle-filter_autolinkhijacker.git</code>
# Rename the folder to your plug-in's name
# Open Git Bash in that folder

=== Creating a local branch ===

# Open Git Bash in the plug-in folder
# Create new branch: <code bash>git branch MOODLE_19_STABLE</code>
# Change to the new branch: <code bash>git checkout MOODLE_19_STABLE</code>
#* Both steps in one: <code bash>git checkout -b MOODLE_19_STABLE</code>

=== Creating a remote branch ===

{{Note|
It might be better using "remote" first to create the remote branch.
And usually it's best if both branches have the same name.
--[[User:Frank Ralf|Frank Ralf]] 12:59, 18 July 2011 (WST)
}}

# Change to the correct local branch
# <code bash>git push origin -u MOODLE_19_STABLE</code>
#: Using different names for local and remote branch: <code bash>$ git push origin local_19_STABLE:MOODLE_19_STABLE </code>

[[File:Git creating remote branch.png | 600px]]

=== Deleting a remote branch ===
$ git push origin :testbranch
http://stackoverflow.com/questions/2003505/how-do-i-delete-a-git-branch-both-locally-and-in-github

== Git GUI (aka GitTk) ==

For launching the command line commands from a GUI. This will automatically be installed together with "Git for Windows" and is equally accessible from the explorer context menu.

[[File:Git Gui (moodle).png]]

=== Visualize branch history ===
[[File:Gitk moodle 2011-07-20.png]]

== See also ==
; Moodle forum discussions
* [http://moodle.org/mod/forum/discuss.php?d=168094 GIT help needed]
* [http://moodle.org/mod/forum/discuss.php?d=165236 Best way to manage CONTRIB code with GIT]
* [http://moodle.org/mod/forum/discuss.php?d=167063 Handy Git tip for tracking 3rd-party modules and plugins]
* [http://moodle.org/mod/forum/discuss.php?d=167730 Moodle Git repositories]

; External resources
* [http://www.kernel.org/pub/software/scm/git/docs/everyday.html Everyday GIT With 20 Commands Or So]
* [http://gitref.org/ Git Reference]
* [http://progit.org/book/ Pro Git book]

; Stackoverflow resources
* [http://stackoverflow.com/questions/1427785/how-to-set-desired-language-in-git-gui How to set desired language in git-gui?]
* [http://stackoverflow.com/questions/3841140/git-how-to-get-rid-of-the-annoying-crlf-message-on-msysgit-windows GIT: How to get rid of the annoying CRLF message on msysgit (windows)?]
* [http://stackoverflow.com/questions/6414515/how-to-do-rebase-interactive-in-a-windows-gui How to do rebase --interactive in a Windows GUI?]

[[Category:Git]]
[[Category:Developer]]

User:Frank Ralf/Git

2011-07-22T17:21:37Z

Nakohdo: /* Updating your Moodle installation */

== Cloning Moodle to your local installation ==
* See [[Git for Administrators]], the following screenshots illustrate the steps described there.

[[File:Git cloning Moodle.png]]

=== Cloning to a new folder ===
[[File:Git cloning Moodle new folder.png]]

=== Moodle branches ===
[[File:Git remote Moodle branches.png]]

=== Checkout ===
[[File:Git checkout MOODLE 19 STABLE.png]]

== Deleting master branch ==
Don't know whether this is a good idea but I accidentally messed up my local Moodle 1.9 master branch by fetching Moodle 2.1 on top of it ...
* See the discussion in the Moodle General Developer Forum: [http://moodle.org/mod/forum/discuss.php?d=181720 Git: deleting local "master" branch]

=== Moodle 1.9 ===
[[File:Git delete master branch.png]]

That's the result:

[[File:Git only local branch left.png]]

=== Moodle 2.0 ===

[[File:Git delete local master branch 2.0.png]]

== Updating your Moodle installation ==

<code php>git fetch</code>

[[File:Git fetch.png| thumb | First try ...]]
[[File:Git branch fetch 2011-07-20.png| thumb |Second try ...]]

Following the [[User:Sam_Hemelryk/My_Moodle_Git_workflow| instructions by Sam Hemelryk]]:

=== Moodle 1.9 ===

==== fetch ====
[[File:Git fetch status 2011-07-20.png]]

==== merge ====
[[File:Git merge 2011-07-20.png]]

=== Moodle 2.0 ===

==== fetch ====
[[File:Git fetch Moodle 2.0.png]]

==== merge ====

git merge origin/MOODLE_20_STABLE

[[File:Git merge Moodle 2.0 2011-07-22.png]]

== Maintaining your own contributed code ==

=== Copying the plug-in code to your Moodle installation ===
[[File:Git adding my custom plugin code.png]]

=== Making Git ignore your code ===
Put the folder names for your own code into the '''.git/info/exclude''' file in your Moodle clone, as the following excerpt from .gitignore describes. On Windows the .git folder is hidden by default so you will have to change your settings to show hidden files (Explorer > Tools > Folder settings ...).

# Example: if you deploy a contributed plugin mod/foobar into your site, put
# the following line into .git/info/exclude file in your Moodle clone:
# /mod/foobar/

That's how it looks:

# git ls-files --others --exclude-from=.git/info/exclude
# Lines that start with '#' are comments.
# For a project mostly in C, the following would be a good set of
# exclude patterns (uncomment them if you want to use them):
# *.[oa]
# *~
/blocks/firephp
/filter/autolinkhijacker

=== Setting up a remote repository on GitHub ===

See the instructions at:
* [[Dev:Git for developers]]
* [[Git repositories for contrib modules]]

=== Cloning the remote GitHub repository to your local Moodle installation ===

# Change to the parent folder for your plug-in
# Clone the repository: <code bash>git clone https://nakohdo@GitHub.com/nakohdo/moodle-filter_autolinkhijacker.git</code>
# Rename the folder to your plug-in's name
# Open Git Bash in that folder

=== Creating a local branch ===

# Open Git Bash in the plug-in folder
# Create new branch: <code bash>git branch MOODLE_19_STABLE</code>
# Change to the new branch: <code bash>git checkout MOODLE_19_STABLE</code>
#* Both steps in one: <code bash>git checkout -b MOODLE_19_STABLE</code>

=== Creating a remote branch ===

{{Note|
It might be better using "remote" first to create the remote branch.
And usually it's best if both branches have the same name.
--[[User:Frank Ralf|Frank Ralf]] 12:59, 18 July 2011 (WST)
}}

# Change to the correct local branch
# <code bash>git push origin -u MOODLE_19_STABLE</code>
#: Using different names for local and remote branch: <code bash>$ git push origin local_19_STABLE:MOODLE_19_STABLE </code>

[[File:Git creating remote branch.png | 600px]]

=== Deleting a remote branch ===
$ git push origin :testbranch
http://stackoverflow.com/questions/2003505/how-do-i-delete-a-git-branch-both-locally-and-in-github

== Git GUI (aka GitTk) ==

For launching the command line commands from a GUI. This will automatically be installed together with "Git for Windows" and is equally accessible from the explorer context menu.

[[File:Git Gui (moodle).png]]

=== Visualize branch history ===
[[File:Gitk moodle 2011-07-20.png]]

== See also ==
; Moodle forum discussions
* [http://moodle.org/mod/forum/discuss.php?d=168094 GIT help needed]
* [http://moodle.org/mod/forum/discuss.php?d=165236 Best way to manage CONTRIB code with GIT]
* [http://moodle.org/mod/forum/discuss.php?d=167063 Handy Git tip for tracking 3rd-party modules and plugins]
* [http://moodle.org/mod/forum/discuss.php?d=167730 Moodle Git repositories]

; External resources
* [http://www.kernel.org/pub/software/scm/git/docs/everyday.html Everyday GIT With 20 Commands Or So]
* [http://gitref.org/ Git Reference]
* [http://progit.org/book/ Pro Git book]

; Stackoverflow resources
* [http://stackoverflow.com/questions/1427785/how-to-set-desired-language-in-git-gui How to set desired language in git-gui?]
* [http://stackoverflow.com/questions/3841140/git-how-to-get-rid-of-the-annoying-crlf-message-on-msysgit-windows GIT: How to get rid of the annoying CRLF message on msysgit (windows)?]
* [http://stackoverflow.com/questions/6414515/how-to-do-rebase-interactive-in-a-windows-gui How to do rebase --interactive in a Windows GUI?]

[[Category:Git]]
[[Category:Developer]]

File:Git merge Moodle 2.0 2011-07-22.png

2011-07-22T17:19:53Z

Nakohdo:

User:Frank Ralf/Git

2011-07-22T17:17:16Z

Nakohdo: /* Updating your Moodle installation */

== Cloning Moodle to your local installation ==
* See [[Git for Administrators]], the following screenshots illustrate the steps described there.

[[File:Git cloning Moodle.png]]

=== Cloning to a new folder ===
[[File:Git cloning Moodle new folder.png]]

=== Moodle branches ===
[[File:Git remote Moodle branches.png]]

=== Checkout ===
[[File:Git checkout MOODLE 19 STABLE.png]]

== Deleting master branch ==
Don't know whether this is a good idea but I accidentally messed up my local Moodle 1.9 master branch by fetching Moodle 2.1 on top of it ...
* See the discussion in the Moodle General Developer Forum: [http://moodle.org/mod/forum/discuss.php?d=181720 Git: deleting local "master" branch]

=== Moodle 1.9 ===
[[File:Git delete master branch.png]]

That's the result:

[[File:Git only local branch left.png]]

=== Moodle 2.0 ===

[[File:Git delete local master branch 2.0.png]]

== Updating your Moodle installation ==

<code php>git fetch</code>

[[File:Git fetch.png| thumb | First try ...]]
[[File:Git branch fetch 2011-07-20.png| thumb |Second try ...]]

Following the [[User:Sam_Hemelryk/My_Moodle_Git_workflow| instructions by Sam Hemelryk]]:

=== fetch ===
[[File:Git fetch Moodle 2.0.png]]

[[File:Git fetch status 2011-07-20.png]]

=== merge ===
[[File:Git merge 2011-07-20.png]]

== Maintaining your own contributed code ==

=== Copying the plug-in code to your Moodle installation ===
[[File:Git adding my custom plugin code.png]]

=== Making Git ignore your code ===
Put the folder names for your own code into the '''.git/info/exclude''' file in your Moodle clone, as the following excerpt from .gitignore describes. On Windows the .git folder is hidden by default so you will have to change your settings to show hidden files (Explorer > Tools > Folder settings ...).

# Example: if you deploy a contributed plugin mod/foobar into your site, put
# the following line into .git/info/exclude file in your Moodle clone:
# /mod/foobar/

That's how it looks:

# git ls-files --others --exclude-from=.git/info/exclude
# Lines that start with '#' are comments.
# For a project mostly in C, the following would be a good set of
# exclude patterns (uncomment them if you want to use them):
# *.[oa]
# *~
/blocks/firephp
/filter/autolinkhijacker

=== Setting up a remote repository on GitHub ===

See the instructions at:
* [[Dev:Git for developers]]
* [[Git repositories for contrib modules]]

=== Cloning the remote GitHub repository to your local Moodle installation ===

# Change to the parent folder for your plug-in
# Clone the repository: <code bash>git clone https://nakohdo@GitHub.com/nakohdo/moodle-filter_autolinkhijacker.git</code>
# Rename the folder to your plug-in's name
# Open Git Bash in that folder

=== Creating a local branch ===

# Open Git Bash in the plug-in folder
# Create new branch: <code bash>git branch MOODLE_19_STABLE</code>
# Change to the new branch: <code bash>git checkout MOODLE_19_STABLE</code>
#* Both steps in one: <code bash>git checkout -b MOODLE_19_STABLE</code>

=== Creating a remote branch ===

{{Note|
It might be better using "remote" first to create the remote branch.
And usually it's best if both branches have the same name.
--[[User:Frank Ralf|Frank Ralf]] 12:59, 18 July 2011 (WST)
}}

# Change to the correct local branch
# <code bash>git push origin -u MOODLE_19_STABLE</code>
#: Using different names for local and remote branch: <code bash>$ git push origin local_19_STABLE:MOODLE_19_STABLE </code>

[[File:Git creating remote branch.png | 600px]]

=== Deleting a remote branch ===
$ git push origin :testbranch
http://stackoverflow.com/questions/2003505/how-do-i-delete-a-git-branch-both-locally-and-in-github

== Git GUI (aka GitTk) ==

For launching the command line commands from a GUI. This will automatically be installed together with "Git for Windows" and is equally accessible from the explorer context menu.

[[File:Git Gui (moodle).png]]

=== Visualize branch history ===
[[File:Gitk moodle 2011-07-20.png]]

== See also ==
; Moodle forum discussions
* [http://moodle.org/mod/forum/discuss.php?d=168094 GIT help needed]
* [http://moodle.org/mod/forum/discuss.php?d=165236 Best way to manage CONTRIB code with GIT]
* [http://moodle.org/mod/forum/discuss.php?d=167063 Handy Git tip for tracking 3rd-party modules and plugins]
* [http://moodle.org/mod/forum/discuss.php?d=167730 Moodle Git repositories]

; External resources
* [http://www.kernel.org/pub/software/scm/git/docs/everyday.html Everyday GIT With 20 Commands Or So]
* [http://gitref.org/ Git Reference]
* [http://progit.org/book/ Pro Git book]

; Stackoverflow resources
* [http://stackoverflow.com/questions/1427785/how-to-set-desired-language-in-git-gui How to set desired language in git-gui?]
* [http://stackoverflow.com/questions/3841140/git-how-to-get-rid-of-the-annoying-crlf-message-on-msysgit-windows GIT: How to get rid of the annoying CRLF message on msysgit (windows)?]
* [http://stackoverflow.com/questions/6414515/how-to-do-rebase-interactive-in-a-windows-gui How to do rebase --interactive in a Windows GUI?]

[[Category:Git]]
[[Category:Developer]]

File:Git fetch Moodle 2.0.png

2011-07-22T17:16:36Z

Nakohdo:

User:Frank Ralf/Git

2011-07-22T17:12:56Z

Nakohdo: /* Making Git ignore your code */

== Cloning Moodle to your local installation ==
* See [[Git for Administrators]], the following screenshots illustrate the steps described there.

[[File:Git cloning Moodle.png]]

=== Cloning to a new folder ===
[[File:Git cloning Moodle new folder.png]]

=== Moodle branches ===
[[File:Git remote Moodle branches.png]]

=== Checkout ===
[[File:Git checkout MOODLE 19 STABLE.png]]

== Deleting master branch ==
Don't know whether this is a good idea but I accidentally messed up my local Moodle 1.9 master branch by fetching Moodle 2.1 on top of it ...
* See the discussion in the Moodle General Developer Forum: [http://moodle.org/mod/forum/discuss.php?d=181720 Git: deleting local "master" branch]

=== Moodle 1.9 ===
[[File:Git delete master branch.png]]

That's the result:

[[File:Git only local branch left.png]]

=== Moodle 2.0 ===

[[File:Git delete local master branch 2.0.png]]

== Updating your Moodle installation ==

<code php>git fetch</code>

[[File:Git fetch.png| thumb | First try ...]]
[[File:Git branch fetch 2011-07-20.png| thumb |Second try ...]]

Following the [[User:Sam_Hemelryk/My_Moodle_Git_workflow| instructions by Sam Hemelryk]]:

=== fetch ===
[[File:Git fetch status 2011-07-20.png]]

=== merge ===
[[File:Git merge 2011-07-20.png]]

== Maintaining your own contributed code ==

=== Copying the plug-in code to your Moodle installation ===
[[File:Git adding my custom plugin code.png]]

=== Making Git ignore your code ===
Put the folder names for your own code into the '''.git/info/exclude''' file in your Moodle clone, as the following excerpt from .gitignore describes. On Windows the .git folder is hidden by default so you will have to change your settings to show hidden files (Explorer > Tools > Folder settings ...).

# Example: if you deploy a contributed plugin mod/foobar into your site, put
# the following line into .git/info/exclude file in your Moodle clone:
# /mod/foobar/

That's how it looks:

# git ls-files --others --exclude-from=.git/info/exclude
# Lines that start with '#' are comments.
# For a project mostly in C, the following would be a good set of
# exclude patterns (uncomment them if you want to use them):
# *.[oa]
# *~
/blocks/firephp
/filter/autolinkhijacker

=== Setting up a remote repository on GitHub ===

See the instructions at:
* [[Dev:Git for developers]]
* [[Git repositories for contrib modules]]

=== Cloning the remote GitHub repository to your local Moodle installation ===

# Change to the parent folder for your plug-in
# Clone the repository: <code bash>git clone https://nakohdo@GitHub.com/nakohdo/moodle-filter_autolinkhijacker.git</code>
# Rename the folder to your plug-in's name
# Open Git Bash in that folder

=== Creating a local branch ===

# Open Git Bash in the plug-in folder
# Create new branch: <code bash>git branch MOODLE_19_STABLE</code>
# Change to the new branch: <code bash>git checkout MOODLE_19_STABLE</code>
#* Both steps in one: <code bash>git checkout -b MOODLE_19_STABLE</code>

=== Creating a remote branch ===

{{Note|
It might be better using "remote" first to create the remote branch.
And usually it's best if both branches have the same name.
--[[User:Frank Ralf|Frank Ralf]] 12:59, 18 July 2011 (WST)
}}

# Change to the correct local branch
# <code bash>git push origin -u MOODLE_19_STABLE</code>
#: Using different names for local and remote branch: <code bash>$ git push origin local_19_STABLE:MOODLE_19_STABLE </code>

[[File:Git creating remote branch.png | 600px]]

=== Deleting a remote branch ===
$ git push origin :testbranch
http://stackoverflow.com/questions/2003505/how-do-i-delete-a-git-branch-both-locally-and-in-github

== Git GUI (aka GitTk) ==

For launching the command line commands from a GUI. This will automatically be installed together with "Git for Windows" and is equally accessible from the explorer context menu.

[[File:Git Gui (moodle).png]]

=== Visualize branch history ===
[[File:Gitk moodle 2011-07-20.png]]

== See also ==
; Moodle forum discussions
* [http://moodle.org/mod/forum/discuss.php?d=168094 GIT help needed]
* [http://moodle.org/mod/forum/discuss.php?d=165236 Best way to manage CONTRIB code with GIT]
* [http://moodle.org/mod/forum/discuss.php?d=167063 Handy Git tip for tracking 3rd-party modules and plugins]
* [http://moodle.org/mod/forum/discuss.php?d=167730 Moodle Git repositories]

; External resources
* [http://www.kernel.org/pub/software/scm/git/docs/everyday.html Everyday GIT With 20 Commands Or So]
* [http://gitref.org/ Git Reference]
* [http://progit.org/book/ Pro Git book]

; Stackoverflow resources
* [http://stackoverflow.com/questions/1427785/how-to-set-desired-language-in-git-gui How to set desired language in git-gui?]
* [http://stackoverflow.com/questions/3841140/git-how-to-get-rid-of-the-annoying-crlf-message-on-msysgit-windows GIT: How to get rid of the annoying CRLF message on msysgit (windows)?]
* [http://stackoverflow.com/questions/6414515/how-to-do-rebase-interactive-in-a-windows-gui How to do rebase --interactive in a Windows GUI?]

[[Category:Git]]
[[Category:Developer]]

User:Frank Ralf/Git

2011-07-22T15:34:00Z

Nakohdo: /* Deleting master branch */

== Cloning Moodle to your local installation ==
* See [[Git for Administrators]], the following screenshots illustrate the steps described there.

[[File:Git cloning Moodle.png]]

=== Cloning to a new folder ===
[[File:Git cloning Moodle new folder.png]]

=== Moodle branches ===
[[File:Git remote Moodle branches.png]]

=== Checkout ===
[[File:Git checkout MOODLE 19 STABLE.png]]

== Deleting master branch ==
Don't know whether this is a good idea but I accidentally messed up my local Moodle 1.9 master branch by fetching Moodle 2.1 on top of it ...
* See the discussion in the Moodle General Developer Forum: [http://moodle.org/mod/forum/discuss.php?d=181720 Git: deleting local "master" branch]

=== Moodle 1.9 ===
[[File:Git delete master branch.png]]

That's the result:

[[File:Git only local branch left.png]]

=== Moodle 2.0 ===

[[File:Git delete local master branch 2.0.png]]

== Updating your Moodle installation ==

<code php>git fetch</code>

[[File:Git fetch.png| thumb | First try ...]]
[[File:Git branch fetch 2011-07-20.png| thumb |Second try ...]]

Following the [[User:Sam_Hemelryk/My_Moodle_Git_workflow| instructions by Sam Hemelryk]]:

=== fetch ===
[[File:Git fetch status 2011-07-20.png]]

=== merge ===
[[File:Git merge 2011-07-20.png]]

== Maintaining your own contributed code ==

=== Copying the plug-in code to your Moodle installation ===
[[File:Git adding my custom plugin code.png]]

=== Making Git ignore your code ===
Put the folder names for your own code into the '''.git/info/exclude''' file in your Moodle clone, as the following excerpt from .gitignore describes:

# Example: if you deploy a contributed plugin mod/foobar into your site, put
# the following line into .git/info/exclude file in your Moodle clone:
# /mod/foobar/

That's how it looks:

# git ls-files --others --exclude-from=.git/info/exclude
# Lines that start with '#' are comments.
# For a project mostly in C, the following would be a good set of
# exclude patterns (uncomment them if you want to use them):
# *.[oa]
# *~
/blocks/firephp
/filter/autolinkhijacker

=== Setting up a remote repository on GitHub ===

See the instructions at:
* [[Dev:Git for developers]]
* [[Git repositories for contrib modules]]

=== Cloning the remote GitHub repository to your local Moodle installation ===

# Change to the parent folder for your plug-in
# Clone the repository: <code bash>git clone https://nakohdo@GitHub.com/nakohdo/moodle-filter_autolinkhijacker.git</code>
# Rename the folder to your plug-in's name
# Open Git Bash in that folder

=== Creating a local branch ===

# Open Git Bash in the plug-in folder
# Create new branch: <code bash>git branch MOODLE_19_STABLE</code>
# Change to the new branch: <code bash>git checkout MOODLE_19_STABLE</code>
#* Both steps in one: <code bash>git checkout -b MOODLE_19_STABLE</code>

=== Creating a remote branch ===

{{Note|
It might be better using "remote" first to create the remote branch.
And usually it's best if both branches have the same name.
--[[User:Frank Ralf|Frank Ralf]] 12:59, 18 July 2011 (WST)
}}

# Change to the correct local branch
# <code bash>git push origin -u MOODLE_19_STABLE</code>
#: Using different names for local and remote branch: <code bash>$ git push origin local_19_STABLE:MOODLE_19_STABLE </code>

[[File:Git creating remote branch.png | 600px]]

=== Deleting a remote branch ===
$ git push origin :testbranch
http://stackoverflow.com/questions/2003505/how-do-i-delete-a-git-branch-both-locally-and-in-github

== Git GUI (aka GitTk) ==

For launching the command line commands from a GUI. This will automatically be installed together with "Git for Windows" and is equally accessible from the explorer context menu.

[[File:Git Gui (moodle).png]]

=== Visualize branch history ===
[[File:Gitk moodle 2011-07-20.png]]

== See also ==
; Moodle forum discussions
* [http://moodle.org/mod/forum/discuss.php?d=168094 GIT help needed]
* [http://moodle.org/mod/forum/discuss.php?d=165236 Best way to manage CONTRIB code with GIT]
* [http://moodle.org/mod/forum/discuss.php?d=167063 Handy Git tip for tracking 3rd-party modules and plugins]
* [http://moodle.org/mod/forum/discuss.php?d=167730 Moodle Git repositories]

; External resources
* [http://www.kernel.org/pub/software/scm/git/docs/everyday.html Everyday GIT With 20 Commands Or So]
* [http://gitref.org/ Git Reference]
* [http://progit.org/book/ Pro Git book]

; Stackoverflow resources
* [http://stackoverflow.com/questions/1427785/how-to-set-desired-language-in-git-gui How to set desired language in git-gui?]
* [http://stackoverflow.com/questions/3841140/git-how-to-get-rid-of-the-annoying-crlf-message-on-msysgit-windows GIT: How to get rid of the annoying CRLF message on msysgit (windows)?]
* [http://stackoverflow.com/questions/6414515/how-to-do-rebase-interactive-in-a-windows-gui How to do rebase --interactive in a Windows GUI?]

[[Category:Git]]
[[Category:Developer]]

User:Frank Ralf/Git

2011-07-22T15:33:41Z

Nakohdo: /* Deleting master branch */

== Cloning Moodle to your local installation ==
* See [[Git for Administrators]], the following screenshots illustrate the steps described there.

[[File:Git cloning Moodle.png]]

=== Cloning to a new folder ===
[[File:Git cloning Moodle new folder.png]]

=== Moodle branches ===
[[File:Git remote Moodle branches.png]]

=== Checkout ===
[[File:Git checkout MOODLE 19 STABLE.png]]

== Deleting master branch ==
Don't know whether this is a good idea but I accidentally messed up my local Moodle 1.9 master branch by fetching Moodle 2.1 on top of it ...
: See the discussion in the Moodle General Developer Forum: [http://moodle.org/mod/forum/discuss.php?d=181720 Git: deleting local "master" branch]

=== Moodle 1.9 ===
[[File:Git delete master branch.png]]

That's the result:

[[File:Git only local branch left.png]]

=== Moodle 2.0 ===

[[File:Git delete local master branch 2.0.png]]

== Updating your Moodle installation ==

<code php>git fetch</code>

[[File:Git fetch.png| thumb | First try ...]]
[[File:Git branch fetch 2011-07-20.png| thumb |Second try ...]]

Following the [[User:Sam_Hemelryk/My_Moodle_Git_workflow| instructions by Sam Hemelryk]]:

=== fetch ===
[[File:Git fetch status 2011-07-20.png]]

=== merge ===
[[File:Git merge 2011-07-20.png]]

== Maintaining your own contributed code ==

=== Copying the plug-in code to your Moodle installation ===
[[File:Git adding my custom plugin code.png]]

=== Making Git ignore your code ===
Put the folder names for your own code into the '''.git/info/exclude''' file in your Moodle clone, as the following excerpt from .gitignore describes:

# Example: if you deploy a contributed plugin mod/foobar into your site, put
# the following line into .git/info/exclude file in your Moodle clone:
# /mod/foobar/

That's how it looks:

# git ls-files --others --exclude-from=.git/info/exclude
# Lines that start with '#' are comments.
# For a project mostly in C, the following would be a good set of
# exclude patterns (uncomment them if you want to use them):
# *.[oa]
# *~
/blocks/firephp
/filter/autolinkhijacker

=== Setting up a remote repository on GitHub ===

See the instructions at:
* [[Dev:Git for developers]]
* [[Git repositories for contrib modules]]

=== Cloning the remote GitHub repository to your local Moodle installation ===

# Change to the parent folder for your plug-in
# Clone the repository: <code bash>git clone https://nakohdo@GitHub.com/nakohdo/moodle-filter_autolinkhijacker.git</code>
# Rename the folder to your plug-in's name
# Open Git Bash in that folder

=== Creating a local branch ===

# Open Git Bash in the plug-in folder
# Create new branch: <code bash>git branch MOODLE_19_STABLE</code>
# Change to the new branch: <code bash>git checkout MOODLE_19_STABLE</code>
#* Both steps in one: <code bash>git checkout -b MOODLE_19_STABLE</code>

=== Creating a remote branch ===

{{Note|
It might be better using "remote" first to create the remote branch.
And usually it's best if both branches have the same name.
--[[User:Frank Ralf|Frank Ralf]] 12:59, 18 July 2011 (WST)
}}

# Change to the correct local branch
# <code bash>git push origin -u MOODLE_19_STABLE</code>
#: Using different names for local and remote branch: <code bash>$ git push origin local_19_STABLE:MOODLE_19_STABLE </code>

[[File:Git creating remote branch.png | 600px]]

=== Deleting a remote branch ===
$ git push origin :testbranch
http://stackoverflow.com/questions/2003505/how-do-i-delete-a-git-branch-both-locally-and-in-github

== Git GUI (aka GitTk) ==

For launching the command line commands from a GUI. This will automatically be installed together with "Git for Windows" and is equally accessible from the explorer context menu.

[[File:Git Gui (moodle).png]]

=== Visualize branch history ===
[[File:Gitk moodle 2011-07-20.png]]

== See also ==
; Moodle forum discussions
* [http://moodle.org/mod/forum/discuss.php?d=168094 GIT help needed]
* [http://moodle.org/mod/forum/discuss.php?d=165236 Best way to manage CONTRIB code with GIT]
* [http://moodle.org/mod/forum/discuss.php?d=167063 Handy Git tip for tracking 3rd-party modules and plugins]
* [http://moodle.org/mod/forum/discuss.php?d=167730 Moodle Git repositories]

; External resources
* [http://www.kernel.org/pub/software/scm/git/docs/everyday.html Everyday GIT With 20 Commands Or So]
* [http://gitref.org/ Git Reference]
* [http://progit.org/book/ Pro Git book]

; Stackoverflow resources
* [http://stackoverflow.com/questions/1427785/how-to-set-desired-language-in-git-gui How to set desired language in git-gui?]
* [http://stackoverflow.com/questions/3841140/git-how-to-get-rid-of-the-annoying-crlf-message-on-msysgit-windows GIT: How to get rid of the annoying CRLF message on msysgit (windows)?]
* [http://stackoverflow.com/questions/6414515/how-to-do-rebase-interactive-in-a-windows-gui How to do rebase --interactive in a Windows GUI?]

[[Category:Git]]
[[Category:Developer]]

User:Frank Ralf/Git

2011-07-22T15:32:28Z

Nakohdo: /* Deleting master branch */

== Cloning Moodle to your local installation ==
* See [[Git for Administrators]], the following screenshots illustrate the steps described there.

[[File:Git cloning Moodle.png]]

=== Cloning to a new folder ===
[[File:Git cloning Moodle new folder.png]]

=== Moodle branches ===
[[File:Git remote Moodle branches.png]]

=== Checkout ===
[[File:Git checkout MOODLE 19 STABLE.png]]

== Deleting master branch ==
Don't know whether this is a good idea but I accidentally messed up my local Moodle 1.9 master branch by fetching Moodle 2.1 on top of it ...
: See [http://moodle.org/mod/forum/discuss.php?d=181720

=== Moodle 1.9 ===
[[File:Git delete master branch.png]]

That's the result:

[[File:Git only local branch left.png]]

=== Moodle 2.0 ===

[[File:Git delete local master branch 2.0.png]]

== Updating your Moodle installation ==

<code php>git fetch</code>

[[File:Git fetch.png| thumb | First try ...]]
[[File:Git branch fetch 2011-07-20.png| thumb |Second try ...]]

Following the [[User:Sam_Hemelryk/My_Moodle_Git_workflow| instructions by Sam Hemelryk]]:

=== fetch ===
[[File:Git fetch status 2011-07-20.png]]

=== merge ===
[[File:Git merge 2011-07-20.png]]

== Maintaining your own contributed code ==

=== Copying the plug-in code to your Moodle installation ===
[[File:Git adding my custom plugin code.png]]

=== Making Git ignore your code ===
Put the folder names for your own code into the '''.git/info/exclude''' file in your Moodle clone, as the following excerpt from .gitignore describes:

# Example: if you deploy a contributed plugin mod/foobar into your site, put
# the following line into .git/info/exclude file in your Moodle clone:
# /mod/foobar/

That's how it looks:

# git ls-files --others --exclude-from=.git/info/exclude
# Lines that start with '#' are comments.
# For a project mostly in C, the following would be a good set of
# exclude patterns (uncomment them if you want to use them):
# *.[oa]
# *~
/blocks/firephp
/filter/autolinkhijacker

=== Setting up a remote repository on GitHub ===

See the instructions at:
* [[Dev:Git for developers]]
* [[Git repositories for contrib modules]]

=== Cloning the remote GitHub repository to your local Moodle installation ===

# Change to the parent folder for your plug-in
# Clone the repository: <code bash>git clone https://nakohdo@GitHub.com/nakohdo/moodle-filter_autolinkhijacker.git</code>
# Rename the folder to your plug-in's name
# Open Git Bash in that folder

=== Creating a local branch ===

# Open Git Bash in the plug-in folder
# Create new branch: <code bash>git branch MOODLE_19_STABLE</code>
# Change to the new branch: <code bash>git checkout MOODLE_19_STABLE</code>
#* Both steps in one: <code bash>git checkout -b MOODLE_19_STABLE</code>

=== Creating a remote branch ===

{{Note|
It might be better using "remote" first to create the remote branch.
And usually it's best if both branches have the same name.
--[[User:Frank Ralf|Frank Ralf]] 12:59, 18 July 2011 (WST)
}}

# Change to the correct local branch
# <code bash>git push origin -u MOODLE_19_STABLE</code>
#: Using different names for local and remote branch: <code bash>$ git push origin local_19_STABLE:MOODLE_19_STABLE </code>

[[File:Git creating remote branch.png | 600px]]

=== Deleting a remote branch ===
$ git push origin :testbranch
http://stackoverflow.com/questions/2003505/how-do-i-delete-a-git-branch-both-locally-and-in-github

== Git GUI (aka GitTk) ==

For launching the command line commands from a GUI. This will automatically be installed together with "Git for Windows" and is equally accessible from the explorer context menu.

[[File:Git Gui (moodle).png]]

=== Visualize branch history ===
[[File:Gitk moodle 2011-07-20.png]]

== See also ==
; Moodle forum discussions
* [http://moodle.org/mod/forum/discuss.php?d=168094 GIT help needed]
* [http://moodle.org/mod/forum/discuss.php?d=165236 Best way to manage CONTRIB code with GIT]
* [http://moodle.org/mod/forum/discuss.php?d=167063 Handy Git tip for tracking 3rd-party modules and plugins]
* [http://moodle.org/mod/forum/discuss.php?d=167730 Moodle Git repositories]

; External resources
* [http://www.kernel.org/pub/software/scm/git/docs/everyday.html Everyday GIT With 20 Commands Or So]
* [http://gitref.org/ Git Reference]
* [http://progit.org/book/ Pro Git book]

; Stackoverflow resources
* [http://stackoverflow.com/questions/1427785/how-to-set-desired-language-in-git-gui How to set desired language in git-gui?]
* [http://stackoverflow.com/questions/3841140/git-how-to-get-rid-of-the-annoying-crlf-message-on-msysgit-windows GIT: How to get rid of the annoying CRLF message on msysgit (windows)?]
* [http://stackoverflow.com/questions/6414515/how-to-do-rebase-interactive-in-a-windows-gui How to do rebase --interactive in a Windows GUI?]

[[Category:Git]]
[[Category:Developer]]

File:Git delete local master branch 2.0.png

2011-07-22T15:31:47Z

Nakohdo:

User:Frank Ralf/Git

2011-07-22T11:22:52Z

Nakohdo: /* Deleting master branch */

== Cloning Moodle to your local installation ==
* See [[Git for Administrators]], the following screenshots illustrate the steps described there.

[[File:Git cloning Moodle.png]]

=== Cloning to a new folder ===
[[File:Git cloning Moodle new folder.png]]

=== Moodle branches ===
[[File:Git remote Moodle branches.png]]

=== Checkout ===
[[File:Git checkout MOODLE 19 STABLE.png]]

== Deleting master branch ==
Don't know whether this is a good idea but I accidentally messed up my local Moodle 1.9 master branch by fetching Moodle 2.1 on top of it ...

[[File:Git delete master branch.png]]

That's the result:

[[File:Git only local branch left.png]]

== Updating your Moodle installation ==

<code php>git fetch</code>

[[File:Git fetch.png| thumb | First try ...]]
[[File:Git branch fetch 2011-07-20.png| thumb |Second try ...]]

Following the [[User:Sam_Hemelryk/My_Moodle_Git_workflow| instructions by Sam Hemelryk]]:

=== fetch ===
[[File:Git fetch status 2011-07-20.png]]

=== merge ===
[[File:Git merge 2011-07-20.png]]

== Maintaining your own contributed code ==

=== Copying the plug-in code to your Moodle installation ===
[[File:Git adding my custom plugin code.png]]

=== Making Git ignore your code ===
Put the folder names for your own code into the '''.git/info/exclude''' file in your Moodle clone, as the following excerpt from .gitignore describes:

# Example: if you deploy a contributed plugin mod/foobar into your site, put
# the following line into .git/info/exclude file in your Moodle clone:
# /mod/foobar/

That's how it looks:

# git ls-files --others --exclude-from=.git/info/exclude
# Lines that start with '#' are comments.
# For a project mostly in C, the following would be a good set of
# exclude patterns (uncomment them if you want to use them):
# *.[oa]
# *~
/blocks/firephp
/filter/autolinkhijacker

=== Setting up a remote repository on GitHub ===

See the instructions at:
* [[Dev:Git for developers]]
* [[Git repositories for contrib modules]]

=== Cloning the remote GitHub repository to your local Moodle installation ===

# Change to the parent folder for your plug-in
# Clone the repository: <code bash>git clone https://nakohdo@GitHub.com/nakohdo/moodle-filter_autolinkhijacker.git</code>
# Rename the folder to your plug-in's name
# Open Git Bash in that folder

=== Creating a local branch ===

# Open Git Bash in the plug-in folder
# Create new branch: <code bash>git branch MOODLE_19_STABLE</code>
# Change to the new branch: <code bash>git checkout MOODLE_19_STABLE</code>
#* Both steps in one: <code bash>git checkout -b MOODLE_19_STABLE</code>

=== Creating a remote branch ===

{{Note|
It might be better using "remote" first to create the remote branch.
And usually it's best if both branches have the same name.
--[[User:Frank Ralf|Frank Ralf]] 12:59, 18 July 2011 (WST)
}}

# Change to the correct local branch
# <code bash>git push origin -u MOODLE_19_STABLE</code>
#: Using different names for local and remote branch: <code bash>$ git push origin local_19_STABLE:MOODLE_19_STABLE </code>

[[File:Git creating remote branch.png | 600px]]

=== Deleting a remote branch ===
$ git push origin :testbranch
http://stackoverflow.com/questions/2003505/how-do-i-delete-a-git-branch-both-locally-and-in-github

== Git GUI (aka GitTk) ==

For launching the command line commands from a GUI. This will automatically be installed together with "Git for Windows" and is equally accessible from the explorer context menu.

[[File:Git Gui (moodle).png]]

=== Visualize branch history ===
[[File:Gitk moodle 2011-07-20.png]]

== See also ==
; Moodle forum discussions
* [http://moodle.org/mod/forum/discuss.php?d=168094 GIT help needed]
* [http://moodle.org/mod/forum/discuss.php?d=165236 Best way to manage CONTRIB code with GIT]
* [http://moodle.org/mod/forum/discuss.php?d=167063 Handy Git tip for tracking 3rd-party modules and plugins]
* [http://moodle.org/mod/forum/discuss.php?d=167730 Moodle Git repositories]

; External resources
* [http://www.kernel.org/pub/software/scm/git/docs/everyday.html Everyday GIT With 20 Commands Or So]
* [http://gitref.org/ Git Reference]
* [http://progit.org/book/ Pro Git book]

; Stackoverflow resources
* [http://stackoverflow.com/questions/1427785/how-to-set-desired-language-in-git-gui How to set desired language in git-gui?]
* [http://stackoverflow.com/questions/3841140/git-how-to-get-rid-of-the-annoying-crlf-message-on-msysgit-windows GIT: How to get rid of the annoying CRLF message on msysgit (windows)?]
* [http://stackoverflow.com/questions/6414515/how-to-do-rebase-interactive-in-a-windows-gui How to do rebase --interactive in a Windows GUI?]

[[Category:Git]]
[[Category:Developer]]

User:Frank Ralf

2011-07-22T06:51:27Z

Nakohdo: /* Git */

= What I am doing here =

I am exploring Moodle as an e-learning tool for teaching German as a foreign language to Japanese.

Here's [http://moodle.org/user/view.php?id=728638&course=5 my profile on moodle.org].

== Semantic HMTL ==
* [[User:Frank Ralf/Moodle HTML]]

== JavaScript ==
* http://moodle.org/mod/forum/discuss.php?d=106312
* http://tracker.moodle.org/browse/MDL-14542 (http://moodle.org/mod/forum/discuss.php?d=95743)

* I've started a little series on different aspects of JavaScript and Moodle:
*# [[User:Frank_Ralf/JavaScript1]]
*# [[User:Frank_Ralf/JavaScript2]]

* [http://moodle.org/mod/forum/discuss.php?d=151789 Why does Moodle 2.0 keep jumping about?] is suspected to be a JavaScript bug MDL-22372

=== Greasemonkey ===
I've started creating some little Greasemonkey user scripts:
* [http://moodle.org/mod/forum/discuss.php?d=138230 Enhancing Tracker Issue Links]
* TODO: coloring links to non-existing Moodle Doc pages red in the forums like on Moodle Docs: [[Non existing page]]

== Moodle forms ==
* [[User:Frank Ralf/Moodle forms1]]

== XML related stuff ==
* I am working on [[XML FAQ]] and [[Import and export FAQ]]
* At the moment I am trying to create a [http://en.wikipedia.org/wiki/XML_Schema_(W3C) XML Schma] for Moodle XML for validation purposes

* Also on my todo list:
** creating XSLT stylesheet for converting Moodle XML to and from different (human readable) formats
** creating macros for OpenOffice for offline quiz creation
* [http://books.evc-cit.info/odbook/ch09.html XML Filters in OOo]
* [http://www.ibm.com/developerworks/edu/x-dw-x-xsltopenoff.html Expand the editing capabilities of OpenOffice with XSLT]
* [http://moodle.org/mod/forum/discuss.php?d=123277 Importing into Moodle] on manual converting Excel to XML

I will start to collect some of my findings at [[/Moodle XML1]].

* Interesting discussion on [http://moodle.org/mod/forum/discuss.php?d=138895 Are there any standards for learning interaction data in XML?] - also I'm not quite sure where this is heading...

== Drupal integration ==
* I am also interested in integrating Moodle and '''Drupal''', the open source CMS
** My Drupal profile: http://drupal.org/user/216048
** Drupal in Education User Group: http://groups.drupal.org/drupal-education
** The ongoing discussion about Drupal and Moodle: http://groups.drupal.org/node/13600

* There's an interesting discussion in the Moodle Language Teaching course:
:'''''How can Moodle be more of a social networking site?'''''
:http://moodle.org/mod/forum/discuss.php?d=83963&mode=3
:I posted some more links regarding Drupal in education over there.

== Learning Moodle programming ==
* I am taking part in the '''Introduction to Moodle Programming''' course (http://dev.moodle.org)

=== FirePHP Block ===
* I started work on a [http://moodle.org/mod/forum/discuss.php?d=119961 Moodle plugin for FirePHP].
* Now lives on https://github.com/nakohdo/moodle-block_firephp

=== Glossary List Block ===
Inspired by [http://moodle.org/mod/forum/discuss.php?d=20560 Using Keywords Glossary feature for language "correction"] by [[User:Joseph Rézeau|Joseph Rézeau]] I started dabbling in creating a block which shows all glossaries of the currently logged in user across all his/her courses. I use [[User:Frank Ralf/Glossary list]] for scribbling some ideas.

* [http://moodle.org/mod/forum/search.php?sourceid=Mozilla-search&id=5&search=This+module+cannot+be+added+to+this+course+yet!+ This module cannot be added to this course yet! (No file found at: ../mod/game/mod.html).]
* See tracker issue MDL-25155

=== Auto-link Hijacker ===
* A filter which hijacks glossary auto-links and redirects them to a URL of you choice.
* http://moodle.org/mod/data/view.php?d=13&rid=4906&filter=1
* https://github.com/nakohdo/moodle-filter_autolinkhijacker

== Theming related stuff ==
* I am following the discussions on the [http://moodle.org/mod/forum/discuss.php?d=106312 Use of JavaScript in Moodle] and [http://moodle.org/mod/forum/discuss.php?d=108993 The Future of Moodle Templates?]

== Miscellaneous ==

* I have created some pages in the Moodle documentation: [[Javascript FAQ]], [[CSS FAQ]], [[PHP FAQ]], [[Usability FAQ]], [[Database FAQ]], [[Development:Firebug]]

* I am watching the following issue in Moodle tracker:
:''Day names, month names and am/pm appear garbled in Chinese and Japanese on Windows servers''
:http://tracker.moodle.org/browse/MDL-14149

* [[/Experience_of_converting_a_module_to_Moodle_2|Experience of converting a module to Moodle 2]] by Sam Marshall --[[User:Frank Ralf|Frank Ralf]] 12:11, 23 June 2010 (UTC)

* [[/Moodle 2.1 sections proposal]] by Sam Marshall --[[User:Frank Ralf|Frank Ralf]] 18:05, 12 November 2010 (UTC)

* [[/Subpage transclusion]] as a possible solution for avoiding duplicating documentation for different versions of Moodle, see ...
--[[User:Frank Ralf|Frank Ralf]] 07:39, 22 February 2011 (UTC)

== MoodleMoot 2011 in Elmshorn (Germany) ==

* [http://moodlemoot.moodle.de/mod/resource/view.php?id=1103 Call for Papers zur MoodleMoot 2011 in Elmshorn]
* https://docs.moodle.org/de/Benutzer:Frank_Ralf/MoodleMoot2011: my private notes, any feedback welcome

== Git ==
* I'm starting to get the hang of (g)it ... see [[/Git]] --[[User:Frank Ralf|Frank Ralf]] 03:49, 23 June 2011 (WST)
* [[/Git workflow]]

== Test, test, test ... ==
* [[Dev:Firefox]]

User:Frank Ralf/Git workflow

2011-07-21T15:41:17Z

Nakohdo: Created page with "== Standard workflow == # clone and track Moodle 1.9 STABLE # adding own contributed code # gitignore contributed code # creating local branch for next development step # testing..."

== Standard workflow ==
# clone and track Moodle 1.9 STABLE
# adding own contributed code
# gitignore contributed code
# creating local branch for next development step
# testing new code
# if ok > merge with stable branch
# push to GitHub

== See also: ==
* [[User:Sam Hemelryk/My Moodle Git workflow]]