From 34da44f9fb22e5bd8f5a94bd327c2b80e2695d14 Mon Sep 17 00:00:00 2001
From: fermin831 <fermin.hernandez@artica.es>
Date: Thu, 23 Nov 2017 17:00:59 +0100
Subject: [PATCH] Added cron help

---
 .../agentes/module_manager_editor_common.php  |  9 ++--
 pandora_console/include/help/en/help_cron.php | 45 ++++++++++++++++++
 pandora_console/include/help/es/help_cron.php | 46 +++++++++++++++++++
 pandora_console/include/help/ja/help_cron.php | 46 +++++++++++++++++++
 4 files changed, 140 insertions(+), 6 deletions(-)
 create mode 100644 pandora_console/include/help/en/help_cron.php
 create mode 100644 pandora_console/include/help/es/help_cron.php
 create mode 100644 pandora_console/include/help/ja/help_cron.php

diff --git a/pandora_console/godmode/agentes/module_manager_editor_common.php b/pandora_console/godmode/agentes/module_manager_editor_common.php
index 9b9b96ffaf..473e36dfdc 100644
--- a/pandora_console/godmode/agentes/module_manager_editor_common.php
+++ b/pandora_console/godmode/agentes/module_manager_editor_common.php
@@ -590,8 +590,7 @@ $table_advanced->colspan[10][1] = 6;
 if (isset($id_agente) && $moduletype == MODULE_DATA) {
 	$has_remote_conf = enterprise_hook('config_agents_has_remote_configuration',array($agent["id_agente"]));
 	if ($has_remote_conf) {
-		$table_advanced->data[11][0] = __('Cron from') .
-			ui_print_help_tip (__('If cron is set the module interval is ignored and the module runs on the specified date and time'), true);
+		$table_advanced->data[11][0] = __('Cron from') . ui_print_help_icon ('cron', true);
 		$table_advanced->data[11][1] = html_print_extended_select_for_cron ($hour_from, $minute_from, $mday_from, $month_from, $wday_from, true, $disabledBecauseInPolicy);
 		$table_advanced->colspan[11][1] = 6;
 
@@ -600,8 +599,7 @@ if (isset($id_agente) && $moduletype == MODULE_DATA) {
 		$table_advanced->colspan[12][1] = 6;
 	}
 	else {
-		$table_advanced->data[11][0] = __('Cron from') .
-			ui_print_help_tip (__('If cron is set the module interval is ignored and the module runs on the specified date and time'), true);
+		$table_advanced->data[11][0] = __('Cron from') . ui_print_help_icon ('cron', true);
 		$table_advanced->data[11][1] = html_print_extended_select_for_cron ($hour_from, $minute_from, $mday_from, $month_from, $wday_from, true, true);
 		$table_advanced->colspan[11][1] = 6;
 
@@ -611,8 +609,7 @@ if (isset($id_agente) && $moduletype == MODULE_DATA) {
 	}
 }
 else {
-	$table_advanced->data[11][0] = __('Cron from') .
-		ui_print_help_tip (__('If cron is set the module interval is ignored and the module runs on the specified date and time'), true);
+	$table_advanced->data[11][0] = __('Cron from') . ui_print_help_icon ('cron', true);
 	$table_advanced->data[11][1] = html_print_extended_select_for_cron ($hour_from, $minute_from, $mday_from, $month_from, $wday_from, true, $disabledBecauseInPolicy);
 	$table_advanced->colspan[11][1] = 6;
 
diff --git a/pandora_console/include/help/en/help_cron.php b/pandora_console/include/help/en/help_cron.php
new file mode 100644
index 0000000000..a1e235d06e
--- /dev/null
+++ b/pandora_console/include/help/en/help_cron.php
@@ -0,0 +1,45 @@
+<?php
+/**
+ * @package Include/help/en
+ */
+?>
+<h1>Cron for server modules</h1>
+
+Using the configuration parameter sets <b>Cron from</b> and <b>Cron to</b> makes
+it possible for a module to run only for certain periods of time. 
+The way in which it is configured is similar to the syntax of 
+<a style="font-size:14px;" href="https://en.wikipedia.org/wiki/Cron">cron</a>. 
+Just as they appear in the Pandora console, each one of the parameters  
+has three options.
+
+<h4>Cron from: any</h4>
+
+The module will not have restrictions in that parameter. Whatever the value is 
+will be executed, and it is equivalent to the asterisk (*) in the cron nomenclature. In this 
+case <b>Cron to</b> is ignored.
+
+<h4>Cron from: different from any. Cron to: any</h4>
+
+The module will run only during the time in which the date matches that  
+parameter. It is equivalent to writingjust one number in cron nomenclature.
+
+<h4>Cron from: different from any. Cron to: different from any</h4>
+
+The module will run only during the time specified between <b>Cron from</b> and <b>Cron to</b>. 
+It is equivalent to writing  number dash number (n-n) in cron nomenclature.
+
+<h2>Agent interval</h2>
+
+As long as cron conditions are met, the agent will run following 
+its execution interval.
+
+<h2>Examples</h2>
+
+<ul>
+	<li><i>* * * * *</i>: No cron configured.</li>
+	<li><i>15 20 * * *</i>: It will run every day at 20:15.</li>
+	<li><i>* 20 * * *</i>: It will run every day during the hour 20, that is, from 20:00 to 20:59.</li>
+	<li><i>* 8-19 * * *</i>: It will run everyday from 8:00 to 19:59.</li>
+	<li><i>15-45 * 1-16 * *</i>: It will run every first 16 days of the month every hour, from quarter past to quarter to.</li>
+	<li><i>* * * 5 *</i>: It will run only in May.</li>
+<ul>
diff --git a/pandora_console/include/help/es/help_cron.php b/pandora_console/include/help/es/help_cron.php
new file mode 100644
index 0000000000..2902c81928
--- /dev/null
+++ b/pandora_console/include/help/es/help_cron.php
@@ -0,0 +1,46 @@
+<?php
+/**
+ * @package Include/help/es
+ */
+?>
+<h1>Cron para módulos de servidor</h1>
+
+Mediante los grupos de parámetros de configuración <b>Cron desde</b> y <b>Cron hasta</b> se
+puede hacer que un módulo solo se ejecute durante ciertos periodos de tiempo. El 
+modo en el que se configura es parecido a la sintaxis de 
+<a style="font-size:14px;" href="https://es.wikipedia.org/wiki/Cron_(Unix)">cron</a>. 
+Tal y como aparecen en la consola de Pandora, cada uno de los parámetros 
+tiene tres opciones.
+
+<h4>Cron desde: cualquiera</h4>
+
+El módulo no tendrá restricciones en ese parámetro. Se ejecutará cualquiera que 
+que sea el valor y equivale al asterisco (*) en la nomenclatura de cron. En este 
+caso se ignora <b>Cron desde</b>.
+
+<h4>Cron desde: distinto de cualquiera. Cron hasta: cualquiera</h4>
+
+El módulo se ejecutará solamente el tiempo en el que la fecha coincida con ese 
+parámetro. Equivale a escribir solamente un número en la nomenclatura de cron.
+
+<h4>Cron desde: distinto de cualquiera. Cron hasta: distinto de cualquiera</h4>
+
+El módulo se ejecutará entre el tiempo indicado en el <b>Cron desde</b> y el <b>Cron hasta</b>. 
+Equivale a escribir el número guión número (n-n) en la nomenclatura de cron.
+
+<h2>Intervalo del agente</h2>
+
+Mientras que se cumplan las condiciones de cron, el agente se ejecutará siguiendo 
+su intervalo de ejecución.
+
+<h2>Ejemplos</h2>
+
+<ul>
+	<li><i>* * * * *</i>: No hay cron configurado.</li>
+	<li><i>15 20 * * *</i>: Se ejecutará todos los días a las 20:15.</li>
+	<li><i>* 20 * * *</i>: Se ejecutará todos los días durante las 20 horas, es decir, entre las 20:00 y las 20:59.</li>
+	<li><i>* 8-19 * * *</i>: Se ejecutará todos los días entre las 8:00 y las 19:59.</li>
+	<li><i>15-45 * 1-16 * *</i>: Se ejecutará todos los primeros 16 días del mes a todas horas entre y cuarto y menos cuarto.</li>
+	<li><i>* * * 5 *</i>: Se ejecutará solamente en mayo.</li>
+<ul>
+
diff --git a/pandora_console/include/help/ja/help_cron.php b/pandora_console/include/help/ja/help_cron.php
new file mode 100644
index 0000000000..6608ae60cf
--- /dev/null
+++ b/pandora_console/include/help/ja/help_cron.php
@@ -0,0 +1,46 @@
+<?php
+/**
+ * @package Include/help/ja
+ */
+?>
+<h1>Cron for server modules</h1>
+
+Using the configuration parameter sets <b>Cron from</b> and <b>Cron to</b> makes
+it possible for a module to run only for certain periods of time. 
+The way in which it is configured is similar to the syntax of 
+<a style="font-size:14px;" href="https://en.wikipedia.org/wiki/Cron">cron</a>. 
+Just as they appear in the Pandora console, each one of the parameters  
+has three options.
+
+<h4>Cron from: any</h4>
+
+The module will not have restrictions in that parameter. Whatever the value is 
+will be executed, and it is equivalent to the asterisk (*) in the cron nomenclature. In this 
+case <b>Cron to</b> is ignored.
+
+<h4>Cron from: different from any. Cron to: any</h4>
+
+The module will run only during the time in which the date matches that  
+parameter. It is equivalent to writingjust one number in cron nomenclature.
+
+<h4>Cron from: different from any. Cron to: different from any</h4>
+
+The module will run only during the time specified between <b>Cron from</b> and <b>Cron to</b>. 
+It is equivalent to writing  number dash number (n-n) in cron nomenclature.
+
+<h2>Agent interval</h2>
+
+As long as cron conditions are met, the agent will run following 
+its execution interval.
+
+<h2>Examples</h2>
+
+<ul>
+	<li><i>* * * * *</i>: No cron configured.</li>
+	<li><i>15 20 * * *</i>: It will run every day at 20:15.</li>
+	<li><i>* 20 * * *</i>: It will run every day during the hour 20, that is, from 20:00 to 20:59.</li>
+	<li><i>* 8-19 * * *</i>: It will run everyday from 8:00 to 19:59.</li>
+	<li><i>15-45 * 1-16 * *</i>: It will run every first 16 days of the month every hour, from quarter past to quarter to.</li>
+	<li><i>* * * 5 *</i>: It will run only in May.</li>
+<ul>
+