Templates

Las plantillas sirven para personalizar los mensajes que aparecen en las incursiones y los anuncios. De esta forma, se pueden añadir algunos datos que por defecto no se muestran, como el PC máximo o los tipos de los Pokémon, o también se puede cambiar la disposición de los elementos existentes.

Existen dos plantillas completamente independientes: la plantilla de incursiones, que se cambia con /raidtemplate, y la de anuncios, que se cambia con /announcetemplate. Además, las incursiones pueden tener contenido después de la lista de apuntados, que se puede poner con /raidfootertemplate.

Al poner esos comandos sin argumentos, se muestra el código de la plantilla actual. Para cambiar una plantilla, se puede copiar y pegar ese código con las modificaciones deseadas. Por ejemplo:

/raidtemplate <b>{Pokemon}</b> Raid {{on <b>{weekday_day_month}</b> }}at {timewarn_icon_}<b>{raidtime}</b> in {gym_icon}{gym}<br>{{<em>Available from {opentime} to {endtime}</em><br>}}<em>Organized by </em>{organizer}{_edited_icon}{_refloated_icon}

Para volver a la plantilla por defecto, se debe poner un guión -, de la siguiente forma:

/raidtemplate -

Plantillas predefinidas

Además de la plantilla que viene por defecto, hay algunas plantillas predefinidas adicionales. Para utilizarlas, se debe especificar su nombre en lugar de poner la plantilla completa. Por ejemplo:

/raidtemplate maxcp
/announcetemplate maxcp

Las plantillas predefinidas disponibles son las siguientes:

Variables

En cualquier plantilla encontrarás texto entre corchetes {} que son variables que posteriormente se reemplazarán por los datos de las incursiones y los anuncios. Por ejemplo, {gym} se reemplaza por el nombre del gimnasio, con un enlace en caso de que se conozca la ubicación.

En esta lista se indican todas las variables disponibles. Algunas ya se utilizan en la plantilla por defecto o en alguna de las plantillas predefinidas, pero otras no. Por claridad, en la lista no aparecen los corchetes {}.

Formato con HTML

El mensaje se puede formatear con HTML sencillo, con las restricciones de Telegram habituales:

• Las etiquetas válidas son <i></i> (cursiva), <b></b> (negrita), <u></u> (subrayado), <s></s> (tachado), <code></code> (texto de ancho fijo) y <a href=""></a> (enlace).
• Si quieres que se vean los caracteres <, > y & se deben usar las entidades <, > y &.
• Se puede poner, por ejemplo, texto en negrita y subrayado al mismo tiempo, anidando las etiquetas correctamente. Es decir <u><b>bien</b></u> es correcto, pero <u><b>mal</u></b> no es correcto y no funcionará
• Los saltos de línea deben indicarse con <br>. Se pueden separar los elementos poniendo varios seguidos, por ejemplo <br><br>.

Recuerda que estás especificando código para la plantilla, y el formato que apliques se ignorará. Es decir, si quieres que algo se muestre en negrita, debes ponerlo <b>de esta manera</b>, pero no utilizar la opción de negrita integrada en Telegram.

Variantes de las variables

Para ayudar a construir mejores mensajes hay versiones de las variables con espacios al principio, con espacios al final, en mayúsculas… Estas son las variantes disponibles:

• {VARIABLE}: contiene {variable} en mayúsculas.
• {Variable}: contiene {variable} forzando la primera letra mayúscula.
• {_variable}: contiene {variable} con un espacio al principio.
• {variable_}: contiene {variable} con un espacio al final.
• {_variable_}: contiene {variable} con un espacio al principio y al final.

Variantes de las variables con enlaces

Las variables que ponen Enlace en la columna HTML contienen enlaces. Es decir, {pokemon_gameinfo} se mostrará como el nombre del Pokémon con un enlace a Gameinfo.

Este tipo de variables se pueden descomponer para mostrar de manera independiente solo el texto, añadiendo _text al final, o solo la URL, añadiendo _link al final.

Por ejemplo, la variable {pokemon_gameinfo_text} contendrá el texto con el nombre del Pokémon y {pokemon_gameinfo_link} contendrá la URL.

Bloques condicionales

Hay tres tipos de bloques condiciones, que son bloques encerrados entre llaves dobles {{ }} que pueden mostrarse o no en el mensaje dependiendo de unas determinadas condiciones sencillas.

El bloque condicional más simple se escribe simplemente así: {{texto}}. Se mostrará únicamente si todas las variables que se utilizan dentro están definidas. Tienes ejemplos de este tipo de bloque en la plantilla por defecto, donde solo se muestra una porción de texto si está definida la variable weekday_day_month y otro si están definidas opentime y endtime.

Otro tipo de bloque conditional permite mostrar texto sólo si una variable está definida, sin que se imprima la variable. La sintaxis [variable]{{texto}} permite imprimir todo el texto si existe la variable. Por ejemplo, para mostrar un texto solo en caso de que una incursión sea EX se puede utilizar este bloque condicional:

[expokemon_icon]{{¡Esta es una incursión EX!}}

Por último, se puede hacer justamente lo contrario con el tercer tipo de bloque condicional: mostrar un texto si la variable no está definida. La sintaxis para esto es [!variable]{{texto}}. Por ejemplo, para mostrar un texto solo en caso de que una incursión no tenga la ubicación del gimnasio correctamente definida:

[!gym_link]{{¡El gimnasio no se ha reconocido, avisa a un admin!}}

Variables para usar en los bloques condicionales

Pies de incursiones

Las incursiones pueden tener un texto al pie, que puede definirse con /raidfootertemplate de la misma manera que se definen las demás plantillas. En este caso, por defecto no hay ningún texto al pie por lo que /raidfootertemplate - elimina el texto al pie.