Templates

Templates are used to customize the messages that appear in raids and announcements. In this way, you can add some data that is not shown by default, such as the maximum CP or the types of the Pokémon, or you can also change the arrangement of the existing elements.

There are two completely independent templates: the raid template, which is changed with /raidtemplate, and the announcement template, which is changed with /announcetemplate. Also, raids can have content after the target list, which can be set with /raidfootertemplate.

By putting those commands without arguments, the current template code is displayed. To change a template, you can copy and paste that code with the desired modifications. For example:

/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}

To return to the default template, you must put a dash -, as follows:

/raidtemplate -

⚠️ Is everything very confusing? Start by putting the command /raidtemplate and look at the current raid template. Copy, paste it and make a little modification. Little by little, try new stuff.

Predefined templates

In addition to the default template, there are some additional predefined templates. To use them, you must specify their name instead of putting the complete template. For example:

/raidtemplate maxcp
/announcetemplate maxcp

The available predefined templates are:

Variables

In any template you will find text between brackets {} that are variables that will later be replaced by the data of the raids and announcements. For example, {gym} is replaced by the name of the gym, with a link if the location is known.

This list indicates all the available variables. Some are already used in the default template or in one of the predefined templates, but others are not. For clarity, the brackets {} do not appear in the list.

Format with HTML

Templates can be formatted with plain HTML, with the usual Telegram restrictions:

• Valid tags are <i></i> (italics),<b></b> (bold), <u></u> (underlined),<s></s> (crossed out), <code></code> (fixed-width text) and <a href=""></a>(link).
• If you want the characters <, > and & to be seen, the entities <, > and & must be used.
• You can put, for example, bold and underlined text at the same time, nesting the labels correctly. <u><b>Good</b></u> is correct, but <u><b>Bad</u></b> is wrong and will not work
• Line breaks should be indicated with <br>. You can separate the elements by putting several in a row, for example <br><br>.

Remember that you are specifying code for the template, and the format that you apply directly will be ignored. That is, if you want something to be shown in bold, you must put it <b>this way</b>, but not use the bold option integrated in Telegram.

Variants of variables

To help build better messages there are versions of the variables with spaces at the beginning, with spaces at the end, in capital letters… These are the available variants:

• {VARIABLE}: contains {variable} in uppercase.
• {Variable}: contains {variable} forcing the first capital letter.
• {_variable}: Contains {variable} with a leading space.
• {variable_}: contains {variable} with a space at the end.
• {_variable_}: contains {variable} with a space at the beginning and at the end.

Variants of variables with links

Variables that put Link in the HTML column contain links. That is, {pokemon_gameinfo} will be displayed as the name of the Pokémon with a link to Gameinfo.

This type of variable can be decomposed to independently display only the text, adding _text at the end, or just the URL, adding _link at the end.

For example, the variable {pokemon_gameinfo_text} will contain the text with the name of the Pokémon and {pokemon_gameinfo_link} will contain the URL.

Conditional blocks

There are three types of conditional blocks, which are blocks enclosed in double braces {{ }} that can be shown or hidden depending on simple conditions.

The simplest conditional block is written like this: {{text}}. It will only be displayed if all the variables used within are defined. You have examples of this type of block in the default template, where only a portion of text is shown if the variable weekday_day_month is defined and another if opentime and endtime are defined.

Another type of conditional block allows text to be displayed only if a variable is defined, without the variable being printed. The [variable]{{text}} syntax allows you to print all the text if the variable exists. For example, to display a text only if a raid is EX, you can use this conditional block:

[expokemon_icon]  

Finally, you can do just the opposite with the third type of conditional block: show a text if the variable is not defined. The syntax for this is [variable]{{text}}. For example, to display a text only in case a raid does not have the gym location correctly defined:

[!gym_link] 

Variables to use in conditional blocks

All the variables described in the table above can be used as conditions. In case they have a defined value, the condition will be true. In case they do not have a defined value, the condition will be false.

In addition, there are some variables specially indicated to use as conditions, which do not print anything even if they are true: