MDL-14431
authorthepurpleblob <thepurpleblob>
Wed, 9 Jul 2008 13:07:29 +0000 (13:07 +0000)
committerthepurpleblob <thepurpleblob>
Wed, 9 Jul 2008 13:07:29 +0000 (13:07 +0000)
Changing import/export help to be properly pluggable.

lang/en_utf8/help/quiz/export.html
lang/en_utf8/help/quiz/formatqti2.html [new file with mode: 0644]
lang/en_utf8/help/quiz/formatxhtml.html [new file with mode: 0644]
question/export_form.php
question/import_form.php

index cb5c429..d3e6b75 100644 (file)
    You are advised to check exported data before using
    it in a production environment.</p>
 
-<p>The format(s) currently supported are:</p>
-
-<h2>GIFT format</h2>
-
-<p>GIFT is the most comprehensive import/export format available for exporting 
-   Moodle quiz questions to a text file.  It was designed to be an easy 
-   method for teachers writing questions as a text file. It supports Multiple-Choice, 
-   True-False, Short Answer, Matching and Numerical questions, as well as insertion 
-   of a _____ for the "missing word" format.  Note that Cloze questions are not
-   currently supported. Various question-types can be 
-   mixed in a single text file, and the format also supports line comments, question names, 
-   feedback and percentage-weight grades.  Below are some examples:</p>
-<pre>
-Who's buried in Grant's tomb?{~Grant ~Jefferson =no one}
-
-Grant is {~buried =entombed ~living} in Grant's tomb.
-
-Grant is buried in Grant's tomb.{FALSE}
-
-Who's buried in Grant's tomb?{=no one =nobody}
-
-When was Ulysses S. Grant born?{#1822}
-</pre>
-
-<p class="moreinfo"><a href="help.php?file=formatgift.html&amp;module=quiz">More info about the "GIFT" format</a></p>
-
-
-<h2>Moodle XML format</h2>
-
-<p>This Moodle specific format exports quiz questions in a simple XML format. They
-can then be imported into another quiz category or used in some other process such as
-an XSLT transformation. The XML format will export images attached to questions (encoded
-base64).</p>
-
-
-<h2>IMS QTI 2.0</h2>
-
-<p>Exports in the standard IMS QTI (version 2.0) format. Note that this generates a group of files within
-  a single 'zip' file.</p>
-<p class="moreinfo"><a href="http://www.imsglobal.org/question/" target="_qti">More information on the IMS QTI site</a>
- (external site in new window)</p>
-
-
-<h2>XHTML</h2>
-
-<p>Exports the category as a single page of 'strict' XHTML. Each question is clearly placed in its own
-&lt;div&gt; tag. If you want to use this page as-is, you will need to at least edit the &lt;form&gt; tag at the
-start of the &lt;body&gt; section to provide a suitable action (eg, a 'mailto').</p>
+<p>A number of file formats are supported. See in the individual help files
+and the <a href="http://docs.moodle.org/en/question/import">Moodle Docs</a>
+for details.</p>
 
 
 <p>Import and Export formats are a pluggable resource. Other optional formats may be available in the
diff --git a/lang/en_utf8/help/quiz/formatqti2.html b/lang/en_utf8/help/quiz/formatqti2.html
new file mode 100644 (file)
index 0000000..fa23647
--- /dev/null
@@ -0,0 +1,6 @@
+<h1>IMS QTI 2.0</h1>
+
+<p>Exports in the standard IMS QTI (version 2.0) format. Note that this generates a group of files within
+  a single 'zip' file.</p>
+<p class="moreinfo"><a href="http://www.imsglobal.org/question/" target="_qti">More information on the IMS QTI site</a>
+ (external site in new window)</p>
diff --git a/lang/en_utf8/help/quiz/formatxhtml.html b/lang/en_utf8/help/quiz/formatxhtml.html
new file mode 100644 (file)
index 0000000..1b1ecd9
--- /dev/null
@@ -0,0 +1,6 @@
+<h1>XHTML</h1>
+
+<p>Exports the category as a single page of 'strict' XHTML. Each question is clearly placed in its own
+&lt;div&gt; tag. If you want to use this page as-is, you will need to at least edit the &lt;form&gt; tag at the
+start of the &lt;body&gt; section to provide a suitable action (eg, a 'mailto').</p>
+
index 785906a..11d8513 100644 (file)
@@ -15,10 +15,11 @@ class question_export_form extends moodleform {
         $fileformatnames = get_import_export_formats('export');
         $radioarray = array();
         foreach ($fileformatnames as $id => $fileformatname) {
-            $radioarray[] = &MoodleQuickForm::createElement('radio','format','',$fileformatname,$id);
+            $radioelement = &MoodleQuickForm::createElement('radio','format','',$fileformatname,$id);
+            $radioelement->setHelpButton(array("format{$id}",$fileformatname,'quiz'));
+            $radioarray[] = $radioelement;
         }
         $mform->addGroup($radioarray,'format','',array('<br />'),false);
-        $mform->setHelpButton('format', array('export', get_string('exportquestions', 'quiz'), 'quiz'));
         $mform->addRule('format',null,'required',null,'client'); 
 
 //--------------------------------------------------------------------------------
@@ -46,6 +47,10 @@ class question_export_form extends moodleform {
         $mform->setDefault('exportfilename', $defaultfilename);
         $mform->setType('exportfilename', PARAM_CLEANFILE);
 
+        // set a template for the format select elements   
+        $renderer =& $mform->defaultRenderer();
+        $template = "{help} {element}\n";
+        $renderer->setGroupElementTemplate($template, 'format');
 
 //--------------------------------------------------------------------------------
         $this->add_action_buttons(false, get_string('exportquestions', 'quiz'));
index 9ba63c3..f417970 100644 (file)
@@ -16,12 +16,12 @@ class question_import_form extends moodleform {
         $fileformatnames = get_import_export_formats('import');
         $radioarray = array();
         foreach ($fileformatnames as $id => $fileformatname) {
-            $radioarray[] = &MoodleQuickForm::createElement('radio','format','',$fileformatname,$id );
+            $radioelement = &MoodleQuickForm::createElement('radio','format','',$fileformatname,$id );
+            $radioelement->setHelpButton(array("format{$id}",$fileformatname,'quiz'));
+            $radioarray[] = $radioelement;
         }
-        $mform->addGroup($radioarray,'format', '', array('<br />'), false);
+        $mform->addGroup($radioarray,'format', '', array('<br />'), false);     
         $mform->addRule('format', null, 'required', null, 'client' );
-        $mform->setHelpButton('format', array('import', get_string('importquestions', 'quiz'), 'quiz'));
-
 //--------------------------------------------------------------------------------
         $mform->addElement('header','general', get_string('general', 'form'));
 
@@ -68,6 +68,11 @@ class question_import_form extends moodleform {
 //--------------------------------------------------------------------------------
         $mform->addElement('static', 'dummy', '');
         $mform->closeHeaderBefore('dummy');
+     
+        // set a template for the format select elements   
+        $renderer =& $mform->defaultRenderer();
+        $template = "{help} {element}\n";
+        $renderer->setGroupElementTemplate($template, 'format');
     }
     function get_importfile_name(){
         if ($this->is_submitted() and $this->is_validated()) {