Diferencia entre revisiones de «RecuerdaMe»

De MoodleDocs
RecuerdaMe
Tipo Block
Conjunto N/A
Descargas https://github.com/hwr-projektgruppe/RememberMe
Problemas https://github.com/hwr-projektgruppe/RememberMe/issues
Discusión N/A
Mantenedor(es) Proplug
(tidy up)
(tidy up)
Línea 10: Línea 10:
== Vista general==
== Vista general==


RememberMe is a block type plugin for Moodle v2.0 made by students of the Berlin School of Economics and Law.  
RecuerdaMe es un plugin de tipo [[Bloques|bloque]] para Moodle v2.0 hecho por estudantes de la Berlin School of Economics and Law.  
It periodically checks if a user has not logged in for a specified amount of time and if so, it sends a reminder email to this user.  
Periodicamente revisa si un usuario no ha ingresado al sitio por un período de tiempo especificado y si así fuera, le envía un Email recordatorio a este usuario.  
Both the time without log-in required to trigger the reminder, as well as the content of the email can be customised.
Tanto el tiempo-sin-haber-ingresado requerido para disparar el recordatorio, como el contenido del Email pueden ser personalizados .


== Instalación ==
== Instalación ==

Revisión del 15:38 28 jun 2016

Nota: Pendiente de Traducir. ¡Anímese a traducir esta página!.     ( y otras páginas pendientes)

Vista general

RecuerdaMe es un plugin de tipo bloque para Moodle v2.0 hecho por estudantes de la Berlin School of Economics and Law. Periodicamente revisa si un usuario no ha ingresado al sitio por un período de tiempo especificado y si así fuera, le envía un Email recordatorio a este usuario. Tanto el tiempo-sin-haber-ingresado requerido para disparar el recordatorio, como el contenido del Email pueden ser personalizados .

Instalación

The plugin directory must be moved into .../moodle/blocks/. There are several ways to achieve this.

You can install directly from the Moodle plugins directory. To do this, log into your Moodle as admin, go to Site administration > Plugins > Install plugins and click the button 'Install plugins from Moodle plugins directory'. Search for the plugin and click the install button.

You can also use the Install plugins page to upload and install the plugin after you have downloaded it from the Moodle plugins directory. Simply drag and drop the ZIP file containing the RememberMe directory into the given field, or use the 'Choose a file...' button.

Alternatively, you can do it manually. Download the ZIP from the Moodle plugins directory, unzip it and move or copy the uncompressed folder into .../moodle/blocks/. Then, log into your Moodle as admin and go to Settings > Site administration > Notifications. You should get a notification about a new plugin beeing installed.

For more in-depth step-by-step instructions about installing block plugins, see [1]

Uso

If this plugin is active and was installed correctly, you'll see a new block in your moodle course. Clicking on the logo will link you to this very page.

Configure the settings file ("settings.xml") to customise the amount of days that should pass before a message is sent and the contents of the message.
To do the first, you simply need to change the value for <login>.
The text in the message can be changed by editing the presets <text1> and <text2>.
By default, <text1> is a formal message while <text2> is more casual.

Detalles Técnicos

List of important parameters:
'$xml' → Shows the path to the data „settings.xml“
'text'→ contains the reminder text for the Email
'login' → contains the count of days for the variable 'days'
'$days' → exports the count of days, which is necessary to trigger the function
'lastaccess' → contains the Unix- Timestamp of the user's previous activities
'$seconds' → calculates, after what time span the function is triggered
'$date' → exports the present time in Unix-Timestamp-Format
'time' → present Unix-time in seconds

Both 'time' and 'lastaccess' are Unix-Timestamps, meaning that their values are the seconds that have passed between the beginning of the Unix-period (01.01.1790 - 00:00 o‘clock UTC) and the point in time these timestamps refer to. As a result, the plugin uses seconds as unit of measurement when calculating.

The plugin gets executed every 12 hours by a Cronjob. When this happens, the timestamp of each user's last login is compared with the difference between the current time and the time that is required to elapse before an email is triggered, to check if a user matches this requirement (in short, if $date - $seconds ≥ 'lastaccess'). If so, an email containing the message specified in the settings file is composed and sent. To do the latter, the plugin uses the PHPMailerAutoload class.

Example:
Let's assume today is the 1st of april, 2016 at 6:00am.
-> $date = 1459483200
The user in question has last logged in on the 30th of march, 2016 at 15:15pm.
-> lastaccess = 1459343700
The admin wants everyone who has not visited moodle for 5 days to receive a message.
-> $days = 1 -> $seconds = 86400

1459483200 - 86400 = 1459396800
1459396800 > 1459343700

The condition of $date - $seconds ≥ 'lastaccess' is met and a message will be sent.

It should be noted that the plugin overwrites the 'lastaccess' variable when sending an email, to prevent another one from beeing sent when the plugin is executed the next times.