Lecteur Markdown
POLLS_DOCUMENTATION_FR
Fonctionnalité : Polls #
Système de sondages d'opinion avec support multilingue, suivi des votes par adresse IP, affichage des résultats en barres de progression et archivage des sondages passés.
---
Installation et Configuration #
Par FTP : Déposer le répertoire `polls/` dans `/plugins/`.
Par package manager : Sélectionner `polls` dans la liste des plugins disponibles.
Chemins :
- Plugin principal : `/plugins/polls/polls.php`
- Configuration : `/plugins/polls/conf/polls.conf.inc.php`
- Locales : `/plugins/polls/locale/`
Paramètres de configuration (`polls.conf.inc.php`) :
| Variable | Valeur par défaut | Description |
|---|---|---|
| `$basedatadisplay` | `'yes'` | Affichage dans l'interface de gestion |
| `$basedisplevel` | `BASE_LEVEL_MODERATOR` | Niveau pour créer/gérer les sondages |
Tables SQL requises : `poll`, `poll_setup`, `poll_reference_i18n`
---
Utilisation #
Consultation publique #
- Sondage actif affiché avec ses options de réponse
- Vote une fois par adresse IP (vérification en BDD)
- Résultats en temps réel avec pourcentages et barres de progression
- Lien vers les sondages précédents
Administration (modérateur) #
- Créer un sondage avec traductions (i18n) pour chaque option
- Désigner le sondage actif
- Consulter et gérer les sondages archivés
Fonctions utilitaires exposées :
- `polls_getAvailableLanguages()` — langues disponibles
- `polls_getCurrentLanguage()` — langue courante
- `polls_getI18n(int $poll_id, string $lang)` — traduction d'un sondage
---
Hooks et Points d'entrée #
?obj=polls.php — Sondage actif
?obj=polls.php&vote=OPTION_ID — Voter (GET)
?obj=polls.php&results=1 — Résultats
?obj=polls.php&previous=1 — Sondages précédents
---
Dépendances #
- `Beamreactor\Database\SQL`
- `Beamreactor\Sanitizer\Parser`