Add setting to add a button to return to course (#655)

Author: gbarat87

lang/en/customcert.php

@@ -203,6 +203,9 @@
 $string['refpoint_help'] = 'The reference point is the location of an element from which its x and y coordinates are determined. It is indicated by the \'+\' that appears in the centre or corners of the element.';
 $string['replacetemplate'] = 'Replace';
 $string['requiredtimenotmet'] = 'You must spend at least a minimum of {$a->requiredtime} minutes in the course before you can access this certificate.';
+$string['returncourse'] = 'Return to course button';
+$string['returncourse_desc'] = 'Display a "return to course" button';
+$string['returncourselabel'] = 'Return to course menu';
 $string['rightmargin'] = 'Right margin';
 $string['rightmargin_help'] = 'This is the right margin of the certificate PDF in mm.';
 $string['save'] = 'Save';

settings.php

@@ -78,6 +78,11 @@
     get_string('certificateexecutionperiod', 'customcert'),
     get_string('certificateexecutionperiod_desc', 'customcert'), 365 * DAYSECS));
 
+$settings->add(new admin_setting_configcheckbox('customcert/returncourse',
+    get_string('returncourse', 'customcert'),
+    get_string('returncourse_desc', 'customcert'),
+    0));
+
 $settings->add(new admin_setting_heading('defaults',
     get_string('modeditdefaults', 'admin'), get_string('condifmodeditdefaults', 'admin')));
 

view.php

@@ -157,12 +157,19 @@
 
     // Create the button to download the customcert.
     $downloadbutton = '';
+    $renderbuttoncourse = '';
+    $displayreturnbutton = get_config('customcert', 'returncourse');
     if ($canreceive) {
         $linkname = get_string('getcustomcert', 'customcert');
         $link = new moodle_url('/mod/customcert/view.php', ['id' => $cm->id, 'downloadown' => true]);
         $downloadbutton = new single_button($link, $linkname, 'get', single_button::BUTTON_PRIMARY);
         $downloadbutton->class .= ' m-b-1';  // Seems a bit hackish, ahem.
         $downloadbutton = $OUTPUT->render($downloadbutton);
+        if ($displayreturnbutton) {
+            $url = new moodle_url('/course/view.php', ['id' => $course->id]);
+            $buttonreturntocourse = new single_button($url, get_string('returncourselabel', 'customcert'), 'get', true);
+            $renderbuttoncourse = $OUTPUT->render($buttonreturntocourse);
+        }
     }
 
     $numissues = \mod_customcert\certificate::get_number_of_issues($customcert->id, $cm, $groupmode);
@@ -187,6 +194,9 @@
     echo $issuehtml;
     echo $downloadbutton;
     echo $downloadallbutton;
+    if ($displayreturnbutton) {
+        echo $renderbuttoncourse;
+    }
     if (isset($reporttable)) {
         echo $OUTPUT->heading(get_string('listofissues', 'customcert', $numissues), 3);
         groups_print_activity_menu($cm, $pageurl);