Lección 15: Enviando un resumen diario de actividad
Podemos integrar Gato GraphQL con WP-Cron, para automatizar la ejecución de consultas GraphQL que realizan tareas administrativas, con algún intervalo de tiempo. (Se requiere la extensión Automatización.)
En esta lección del tutorial, configuramos WP-Cron para que, cada 24 hs, ejecute una consulta GraphQL que recupere el número de nuevos comentarios añadidos al sitio, y envíe estas estadísticas a la cuenta de email deseada.
Consulta GraphQL con estadísticas diarias de nuevos comentarios
Esta consulta GraphQL envía un email indicando el número de nuevos comentarios añadidos al sitio para varios periodos de tiempo:
- En las últimas 24 hs
- En el último 1 año
- Desde el comienzo del mes
- Desde el comienzo del año
Creamos una Persisted Query con el slug "daily-stats-by-email-number-of-comments" y el contenido:
query CountComments {
DATE_ISO8601: _env(name: DATE_ISO8601) @remove
timeToday: _time
dateToday: _date(format: $__DATE_ISO8601, timestamp: $__timeToday)
timeYesterday: _intSubtract(subtract: 86400, from: $__timeToday)
dateYesterday: _date(format: $__DATE_ISO8601, timestamp: $__timeYesterday)
time1YearAgo: _intSubtract(subtract: 31536000, from: $__timeToday)
date1YearAgo: _date(format: $__DATE_ISO8601, timestamp: $__time1YearAgo)
timeBegOfThisMonth: _makeTime(hour: 0, minute: 0, second: 0, day: 1)
dateBegOfThisMonth: _date(format: $__DATE_ISO8601, timestamp: $__timeBegOfThisMonth)
timeBegOfThisYear: _makeTime(hour: 0, minute: 0, second: 0, month: 1, day: 1)
dateBegOfThisYear: _date(format: $__DATE_ISO8601, timestamp: $__timeBegOfThisYear)
commentsAddedInLast24Hs: commentCount(filter: { dateQuery: { after: $__dateYesterday } } )
@export(as: "commentsAddedInLast24Hs")
commentsAddedInLast1Year: commentCount(filter: { dateQuery: { after: $__date1YearAgo } } )
@export(as: "commentsAddedInLast1Year")
commentsAddedSinceBegOfThisMonth: commentCount(filter: { dateQuery: { after: $__dateBegOfThisMonth } } )
@export(as: "commentsAddedSinceBegOfThisMonth")
commentsAddedSinceBegOfThisYear: commentCount(filter: { dateQuery: { after: $__dateBegOfThisYear } } )
@export(as: "commentsAddedSinceBegOfThisYear")
}
query CreateEmailMessage @depends(on: "CountComments") {
emailMessageTemplate: _strConvertMarkdownToHTML(
text: """
This is the number of comments added to the site:
| Period | # Comments added |
| --- | --- |
| **In the last 24 hs**: | {$commentsAddedInLast24Hs} |
| **In the last 365 days**: | {$commentsAddedInLast1Year} |
| **Since begginning of this month**: | {$commentsAddedSinceBegOfThisMonth} |
| **Since begginning of this year**: | {$commentsAddedSinceBegOfThisYear} |
"""
)
emailMessage: _strReplaceMultiple(
search: [
"{$commentsAddedInLast24Hs}",
"{$commentsAddedInLast1Year}",
"{$commentsAddedSinceBegOfThisMonth}",
"{$commentsAddedSinceBegOfThisYear}"
],
replaceWith: [
$commentsAddedInLast24Hs,
$commentsAddedInLast1Year,
$commentsAddedSinceBegOfThisMonth,
$commentsAddedSinceBegOfThisYear
],
in: $__emailMessageTemplate
)
@export(as: "emailMessage")
}
mutation SendDailyStatsByEmailNumberOfComments(
$to: [String!]!
)
@depends(on: "CreateEmailMessage")
{
_sendEmail(
input: {
to: $to
subject: "Daily stats: Number of new comments"
messageAs: {
html: $emailMessage
}
}
) {
status
}
}Programando la ejecución de la consulta GraphQL mediante WP-Cron
Debemos programar el evento de WP-Cron para que ejecute el hook de Gato GraphQL gatographql__execute_persisted_query, pasándole el email al que enviar el correo como argumento, y la recurrencia (diaria).
Hacemos esto bien mediante PHP:
wp_schedule_event(
time(),
'daily',
'gatographql__execute_persisted_query',
[
'daily-stats-by-email-number-of-comments',
[
'to' => ['admin@mysite.com']
],
'SendDailyStatsByEmailNumberOfComments',
1 // This is the admin user's ID
]
);O mediante el plugin WP-Crontrol:
- Event type: Standard cron event
- Hook name:
gatographql__execute_persisted_query - Arguments:
["daily-stats-by-email-number-of-comments",{"to":["admin@mysite.com"]},"SendDailyStatsByEmailNumberOfComments",1] - Recurrence: Once Daily
El 4º argumento pasado al evento de WP-Cron es el ID (como int) o username (como string) del usuario que debe estar logueado al ejecutar la consulta GraphQL.
(En este caso, el valor 1 es el ID del usuario admin, y se podría haber proporcionado el username "admin" también.)
Pasar este argumento típicamente se necesita al ejecutar mutaciones, ya que la mayoría de ellas requieren que un usuario (con las capacidades adecuadas) esté logueado.