MDL-78542 mod_url: Add a help text for URL resource name field

Add a help text explaining that the URL resource's name field will be
used for the link text. Also add basic guidelines about naming links for
the benefit of screen reader users.

mod/url/lang/en/url.php

@@ -64,6 +64,12 @@ There are a number of display options for the URL, such as embedded or opening i
 Note that URLs can also be added to any other resource or activity type through the text editor.';
 $string['modulename_link'] = 'mod/url/view';
 $string['modulenameplural'] = 'URLs';
+$string['name'] = 'Name';
+$string['name_help'] = 'This will serve as the link text for the URL.
+
+Enter a meaningful text that concisely describes the URL\'s purpose.
+
+Avoid using the word "link". This will help screen reader users as screen readers announce links (e.g. "Moodle.org, link") so there\'s no need to include the word "link" in the name field.';
 $string['page-mod-url-x'] = 'Any URL module page';
 $string['parameterinfo'] = '&parameter=variable';
 $string['parametersheader'] = 'URL variables';

mod/url/mod_form.php

@@ -38,6 +38,7 @@ class mod_url_mod_form extends moodleform_mod {
         //-------------------------------------------------------
         $mform->addElement('header', 'general', get_string('general', 'form'));
         $mform->addElement('text', 'name', get_string('name'), array('size'=>'48'));
+        $mform->addHelpButton('name', 'name', 'url');
         if (!empty($CFG->formatstringstriptags)) {
             $mform->setType('name', PARAM_TEXT);
         } else {