Plugins
What are the Wowtrack plugins?
The plugins are small snippets of HTML or PNG images that you can embed on web pages. The plugins then provide functionality and information from Wowtrack directly on your web sites or in your forum posts. In addition, the plugins can be used for exporting data from Wowtrack in the JSON format.
Are there any 3rd party offerings based on Wowtrack data?
The following table shows offerings created by 3rd parties that are based on Wowtrack data. Please understand that Wowtrack has no control over these offerings and is simply listing them here for your convenience. If you have created an offering you would like to be listed on this page, please let us know using the contact form.
| Offering | Description |
|---|---|
| WoWProg | Graphical guild progress |
What is the guild plugin?
The guild plugin provides information about a guild. Is is embedded on a web page like this:
| Argument | Description |
|---|---|
| region | The region, i.e. EU, US, etc. |
| realm | The realm name. You can find the properly encoded realm name by visiting the respective guild page. |
| guild | The guild name. You can find the properly encoded guild name by visiting the respective guild page. |
| theme | The dark or light theme, depending on your web site. |
| info | Whether to show the rank, the status, the progress, or a combined view of the guild. |
| format | Whether to render in html (default), or perform a json data export. Specify json if you want to process the raw data yourself. |
Note: For the progress info, the height of the iframe depends on the number of encounters in the current patch. Currently, a height of 150px is recommended.
Examples
Rank:
Status:
Progress:
Combined:
Data Export
You can export data from the Wowtrack guild plugin by requesting the json format. The data returned is structured as follows:
| Field | Description | Optional |
|---|---|---|
| region | The region of the guild, one of US, EU, TW, KR. | |
| realmName | The name of the realm of the guild. | |
| guildName | The name of of the guild. | |
| faction | The faction of the guild, ALLIANCE or HORDE. | Yes |
| patch | The patch data is reported on, e.g. 4.3. | |
| bracket | The raid size of the guild, 25 or 10. | Yes |
| worldRank | The world rank of the guild. | Yes |
| regionRank | The region rank of the guild. | Yes |
| realmRank | The realm rank of the guild. | Yes |
| guildCount | The total number of guilds ranked in the bracket of the guild. | Yes |
| normalCompleted | The number of normal difficulty encounters completed by the guild. | |
| heroicCompleted | The number of heroic difficulty encounters completed by the guild. | |
| normalCount | The total number of normal difficulty encounters in the patch. | |
| heroicCount | The total number of heroic difficulty encounters in the patch. | |
| statusPercentile | The top percentile of the guild in its bracket with regard to its progress status. | Yes |
| pointsPercentile | The top percentile of the guild in its bracket with regard to its number of points. | Yes |
| source | The URL of the guild on Wowtrack. | |
| encounters | An array of all encounters in the patch. | |
| encounter.raidName | The name of the raid where the encounter is located. | |
| encounter.encounterName | The name of the encounter (without heroic prefix.) | |
| encounter.heroic | Whether the encounter is a heroic difficulty encounter, true or false. | |
| encounter.completedOn | The date (calendar day in realm time) where the guild has completed the encounter. | Yes |
| encounter.bracket | The raid size on which the guild has completed the encounter, 25 or 10. | Yes |
| encounter.dualBracket | Whether the guild has completed the encounter on both raid sizes, true or false. | Yes |
What is the character plugin?
The character plugin provides information about a character. Is is embedded on a forum or on a web page like this:
| Argument | Description |
|---|---|
| number | The number of the character. You can find the character number by visiting the respective character page. |
| fields | A comma-separated list of up to three fields to show in the PNG rendering, chosen from status, points, challengemode, itemlevel, achievements, battlegrounds, arena2v2, arena3v3, arena5v5. |
| format | Whether to render in png (default), or perform a json data export. Specify json if you want to process the raw data yourself. |
Example
Data Export
You can export data from the Wowtrack character plugin by requesting the json format. The data returned is structured as follows:
| Field | Description | Optional |
|---|---|---|
| region | The region of the character, one of US, EU, TW, KR. | |
| realmName | The name of the realm of the character. | |
| characterName | The name of of the character. | |
| guildName | The name of the guild of the character. | Yes |
| faction | The faction of the character, ALLIANCE or HORDE. | Yes |
| patch | The patch data is reported for, e.g. 4.3. This is the most recent patch where the character has PvE or PvP activity. | |
| normalCompleted | The number of normal difficulty encounters completed by the character. | Yes |
| heroicCompleted | The number of heroic difficulty encounters completed by the character. | Yes |
| normalCount | The total number of normal difficulty encounters in the patch. | |
| heroicCount | The total number of heroic difficulty encounters in the patch. | |
| source | The URL of the character on Wowtrack. | |
| statistics | An array of statistics on the character in the patch. | |
| statistic.field | The field of the statistic, see the fields argument of the plugin above for a list of currently supported fields. | |
| statistic.value | The value of the character for the statistic. | |
| statistic.percentile | The top percentile of the character for the statistic, expressed with one digit of precision, e.g. 7.6. |