Plugin: EmbedRegistry: Improve on-page documentation - refs BT#15390

plugin/embedregistry/lang/english.php

@@ -6,12 +6,17 @@ $strings['plugin_comment'] = 'Add a course tool to get a registry of embed conte
 
 $strings['tool_enabled'] = 'Tool enabled';
 $strings['tool_title'] = 'Tool Title';
+$strings['tool_title_help'] = 'The title of the tool icon on the course homepage (usually the title of the service being shared).';
 $strings['external_url'] = 'External tool';
+$strings['external_url_help'] = 'The URL at which the external content is managed. Usually something like https://[provider.com]/my_account.';
 
-$strings['YouNeedCreateContent'] = 'First You need create the external content. Then you can add the Embeddable content to yours course.';
+$strings['YouNeedCreateContent'] = 'First You need create the external content. Then you can embed the content into your course.';
 $strings['CreateContent'] = 'Create external content';
 $strings['CreateEmbeddable'] = 'Add embeddable';
 $strings['EditEmbeddable'] = 'Edit embeddable';
 $strings['ContentNotFound'] = 'Content not found';
+$strings['EmbedTitleHelp'] = 'The title you wish to show for this embedded content in particular. If it requires a password to play, include it here to allow your users to unlock it.';
+$strings['EmbedDateRangeHelp'] = 'Within those dates, the active content will be shown directly in the top part of the page.';
 $strings['HtmlCode'] = 'HTML code';
+$strings['HtmlCodeHelp'] = 'The shared HTML code, as provided by the external service, when asking to share in Embed format.';
 $strings['LaunchContent'] = 'Launch content';

plugin/embedregistry/lang/french.php

@@ -0,0 +1,22 @@
+<?php
+/* For licensing terms, see /license.txt */
+
+$strings['plugin_title'] = 'Registre Embed';
+$strings['plugin_comment'] = 'Ajouter un outil à chaque cours pour y afficher une liste de contenus partagés via code Embed depuis un service en ligne, et enregistrez les visualisations de ces contenus par vos utilisateurs.';
+
+$strings['tool_enabled'] = 'Outil activé';
+$strings['tool_title'] = 'Titre de l\'outil';
+$strings['tool_title_help'] = 'Le titre de l\'icône qui apparaîtra sur la page principale du cours (il s\'agit généralement du nom du service externe qui est partagé).';
+$strings['external_url'] = 'URL service externe';
+$strings['external_url_help'] = 'L\'URL de la page de gestion du contenu extérieur sur le site du fournisseur de service correspondant. Habituellement quelque chose du genre https://[fournisseur.com]/my_account.';
+
+$strings['YouNeedCreateContent'] = 'Vous devez d\'abord créer le contenu externe. Ensuite vous pourrez ajouter ce contenu au format Embed dans votre cours.';
+$strings['CreateContent'] = 'Créer contenu externe';
+$strings['CreateEmbeddable'] = 'Créer';
+$strings['EditEmbeddable'] = 'Éditer';
+$strings['ContentNotFound'] = 'Impossible de vérifier le contenu';
+$strings['EmbedTitleHelp'] = 'Le titre que vous souhaitez montrer pour ce contenu incrusté. S\'il requiert un mot de passe, ajoutez-le ici pour que vos utilisateurs puissent le débloquer.';
+$strings['EmbedDateRangeHelp'] = 'Entre ces dates, le contenu actif sera mis en évidence dans la partie supérieure de cette page.';
+$strings['HtmlCode'] = 'Code HTML';
+$strings['HtmlCodeHelp'] = 'Le code HTML partagé, tel que fourni par le service externe au moment de le partager au format "Embed".';
+$strings['LaunchContent'] = 'Voir le contenu';

plugin/embedregistry/lang/spanish.php

@@ -6,12 +6,17 @@ $strings['plugin_comment'] = 'Agrega una herramienta de curso para llevar un reg
 
 $strings['tool_enabled'] = 'Herramienta habilitada';
 $strings['tool_title'] = 'Título de la herramienta';
+$strings['tool_title_help'] = 'El título del icono de la herramienta en la página principal del curso (usualmente el título del servicio siendo compartido).';
 $strings['external_url'] = 'URL externa';
+$strings['external_url_help'] = 'La URL en la cual se puede gestionar el contenido que va a ser embedido en esta herramienta. Usualmente algo como https://[proveedor.com]/my_account, por ejemplo.';
 
-$strings['YouNeedCreateContent'] = 'Primero necesita crear el contenido externo. Luego, puede agregar el contenido Embed a su curso.';
+$strings['YouNeedCreateContent'] = 'Necesita tener contenido externo para luego pegar su código embed aquí.';
 $strings['CreateContent'] = 'Crear contenido externo';
-$strings['CreateEmbeddable'] = 'Agregar Embed';
-$strings['EditEmbeddable'] = 'Editar Embed';
+$strings['CreateEmbeddable'] = 'Crear';
+$strings['EditEmbeddable'] = 'Editar';
 $strings['ContentNotFound'] = 'Contenido no encontrado';
+$strings['EmbedTitleHelp'] = 'El título que desea que tenga este contenido incrustado en particular. Si tiene contraseña, incluya la contraseña para que sus usuarios puedan abrirlo.';
+$strings['EmbedDateRangeHelp'] = 'Dentro de este rango de fechas, el contenido activo será resaltado en la parte superior de la página.';
 $strings['HtmlCode'] = 'Código HTML';
-$strings['LaunchContent'] = 'Lanzar contenido';
+$strings['HtmlCodeHelp'] = 'El código HTML compartido por la herramienta externa, al elegir compartir en formato Embed.';
+$strings['LaunchContent'] = 'Ingresar ahora';

plugin/embedregistry/start.php

@@ -41,9 +41,21 @@ switch ($action) {
         );
 
         $form = new FormValidator('frm_edit');
-        $form->addText('title', get_lang('Title'), true);
-        $form->addDateRangePicker('range', get_lang('DateRange'));
-        $form->addTextarea('html_code', $plugin->get_lang('HtmlCode'), ['rows' => 5], true);
+        $form->addText(
+            'title',
+            [get_lang('Title'), $plugin->get_lang('EmbedTitleHelp')],
+            true
+        );
+        $form->addDateRangePicker(
+            'range',
+            [get_lang('DateRange'), $plugin->get_lang('EmbedDateRangeHelp')]
+        );
+        $form->addTextarea(
+            'html_code',
+            [$plugin->get_lang('HtmlCode'), $plugin->get_lang('HtmlCodeHelp')],
+            ['rows' => 5],
+            true
+        );
         $form->addButtonUpdate(get_lang('Add'));
         $form->addHidden('action', 'add');