> For the complete documentation index, see [llms.txt](https://docs.discordtop.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.discordtop.net/documentation/integrations/azuriomcms-plugin-vote.md).

# AzuriomCMS - Plugin Vote

Cette page explique comment connecter un site Azuriom au système de vote DiscordTop afin de :

* vérifier automatiquement les votes,
* attribuer des récompenses in-game (argent, items, permissions…),
* utiliser `external_id` pour relier un joueur Minecraft au vote DiscordTop.

Cette intégration utilise uniquement l’interface native d’Azuriom → **aucun code supplémentaire n’est requis**.

***

## Ajouter DiscordTop dans Azuriom

Dans votre panel Azuriom :

```
Plugins → Vote → Sites
```

Cliquez sur **“Ajouter un site”**, puis remplissez les champs comme suit :

***

### 🔧 Paramètres recommandés

#### **Nom :**

```
DISCORDTOP
```

#### **URL du site :**

*(Remplacez `GUILD_ID` par l’ID de votre serveur DiscordTop)*

```
https://discordtop.net/guild/GUILD_ID/vote?external_id={player}
```

💡 **Important** :\
`{player}` sera automatiquement remplacé par le pseudonyme du joueur Minecraft.\
Ce champ permettra à DiscordTop de relier le vote au joueur → et à Azuriom d’attendre la validation API côté DTOP.

***

## Activer la vérification des votes

Activez l’option :

```
✔ Activer la vérification des votes
```

Puis entrez votre clé API DiscordTop :

```
Clé d’API : VOTRE_CLE_API_DISCORDTOP
```

Elle est disponible dans votre dashboard DiscordTop (section Développeur → API) - [Trouver ma clé API](/api-reference/concepts-cles/authentification.md).

***

## Configuration du délai entre les votes

Azuriom gère automatiquement l’intervalle minimal :

```
Délai fixe entre les votes : 60 minutes
```

Vous pouvez modifier la valeur au besoin, mais il est fortement recommandé de laisser à 60 minutes.

{% hint style="warning" %}
Attention, le délai minimal entre chaque vote est de 60 minutes côté DiscordTop !
{% endhint %}

***

## Activer le site

Terminez en activant la case :

```
✔ Activer le site
```

Puis sauvegardez.

***

## Attribution des récompenses

Une fois DiscordTop ajouté dans Azuriom, configurez les récompenses :

```
Plugins → Vote → Récompenses
```

Vous pouvez attribuer :

* 💰 de la monnaie (`money`),
* 🎁 des items,
* 🔧 des commandes personnalisées,
* 🎖 des permissions,
* :tada: n’importe quel script via les commandes console.

Exemple :

```
give {player} diamond 3
eco give {player} 250
lp user {player} permission set votant true
```

> 🔍 **Remarque** :\
> Azuriom exécutera les récompenses uniquement si DiscordTop renvoie **has\_voted = true** via l’API.\
> La sécurité est garantie côté DTOP → impossible de tricher en spoofant un vote.

***

## Comment DiscordTop valide le vote ?

Azuriom appelle :

```
GET https://api.discordtop.net/v7/check-vote?external_id={player}
```

DiscordTop répondra :

#### 👉 Cas 1 : Le joueur a voté

```json
{
  "status": 200,
  "has_voted": true
}
```

→ Azuriom applique la récompense (en fonction de leurs configurations).

***

#### 👉 Cas 2 : Le joueur n’a pas voté

```json
{
  "status": 404,
  "has_voted": false
}
```

→ On informe que c'est KO.

***

#### 👉 Cas 3 : Trop de demandes

```json
{
  "status": 429,
  "error": "Rate limit exceeded.",
  "retry_after": 60
}
```

→ Azuriom réessayera automatiquement plus tard.

***

## Configuration finale — Résultat attendu

Une fois terminé, votre page Azuriom ressemble à ceci :

🔹 Nom : **DISCORDTOP**\
🔹 URL : `https://discordtop.net/guild/{YOUR_DISCORD_GUILD_ID}/vote?external_id={player}`\
🔹 Vérification des votes : **activée**\
🔹 Clé d’API : **VOTRE\_CLE**\
🔹 Délai entre votes : **60 minutes**\
🔹 Site activé : **oui**

Et côté joueurs :\
Ils votent → DiscordTop vérifie → Azuriom applique les récompenses → tout est automatique 🎉

***

## FAQ

#### **➡ Le joueur doit-il être connecté à Discord ?**

Non. Le lien `external_id={player}` permet d’associer le vote via son pseudo.

#### **➡ Puis-je personnaliser les récompenses ?**

Oui, complètement. Azuriom exécute vos commandes comme sur un serveur classique.

#### **➡ Faut-il installer un plugin Minecraft spécial ?**

Non. Azuriom s’occupe de tout.

#### **➡ Faut-il installer un plugin Azuriom spécial ?**

Non. le seul plugin obligatoire est le [Plugin Vote](https://github.com/Azuriom/Plugin-Vote).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.discordtop.net/documentation/integrations/azuriomcms-plugin-vote.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.