||||\n-|-|-|\n:discourse2: | Résumé | Le plugin Discourse Surveys vous permet de créer des sondages directement dans vos publications de forum Discourse en utilisant une syntaxe Markdown simple.\n:hammer_and_wrench: | Lien du dépôt | \u003chttps://github.com/discourse/discourse-surveys\u003e\n:open_book: | Guide d’installation | Comment installer des plugins dans Discourse\n\nLe plugin Discourse Surveys vous permet de créer des sondages directement dans vos publications de forum Discourse en utilisant une syntaxe Markdown simple. Le plugin prend actuellement en charge une variété de types de questions tels que les boutons radio, les cases à cocher, les menus déroulants, les entrées numériques, les zones de texte, les évaluations par étoiles et les évaluations pouce levé/pouce baissé.\n\n## Fonctionnalités\n\n- 7 Types de champs différents : Boutons radio, cases à cocher, menus déroulants, zones de texte, sélection de nombres, évaluations par étoiles et pouces levés/baissés\n\n- Champs obligatoires/facultatifs : Marquez les champs comme obligatoires pour garantir leur remplissage\n\n- Prise en charge des Emojis : Utilisez des emojis dans vos options de sondage\n\n- Prise en charge HTML : Formatage de texte enrichi dans les questions et les options\n\n- Authentification utilisateur : Invites de connexion automatiques pour les utilisateurs anonymes\n\n- Suivi des réponses : Empêche les soumissions en double par le même utilisateur\n\n- Sensible aux permissions : Respecte les permissions de sujet et de catégorie\n\n- Responsive Mobile : Fonctionne parfaitement sur tous les appareils\n\n## Utilisation\n\n### Structure de sondage de base\n\nTous les sondages doivent être encapsulés dans des balises [survey] :\n\nmarkdown\n\n[survey name=\"mon-sondage\" title=\"Sondage de feedback client\"]\n\n\u003c!-- Les champs du sondage vont ici --\u003e\n\n[/survey]\n\n\n\n### Attributs du sondage\n\n- name : Identifiant unique pour le sondage (par défaut : "survey")\n\n- title : Titre facultatif affiché en haut du sondage\n\n- public : Définir la visibilité (fonctionnalité future)\n\n- status : État du sondage (fonctionnalité future)\n\n### Types de champs\n\n#### 1. Boutons Radio (Choix unique)\n\nmarkdown\n\n[radio question=\"Quelle est votre couleur préférée ?\"]\n\n- Rouge\n\n- Bleu\n\n- Vert\n\n- Jaune\n\n[/radio]\n\n\n\n#### 2. Cases à cocher (Choix multiples)\n\nmarkdown\n\n[checkbox question=\"Quelles fonctionnalités utilisez-vous ? (Sélectionnez tout ce qui s'applique)\"]\n\n- Notifications par e-mail\n\n- Application mobile\n\n- Notifications de bureau\n\n- Accès API\n\n[/checkbox]\n\n\n\n#### 3. Sélection par menu déroulant\n\nmarkdown\n\n[dropdown question=\"Quelle est votre tranche d'âge ?\"]\n\n- Moins de 18 ans\n\n- 18-24\n\n- 25-34\n\n- 35-44\n\n- 45-54\n\n- 55+\n\n[/dropdown]\n\n\n\n#### 4. Zone de texte (Texte long)\n\nmarkdown\n\n[textarea question=\"Veuillez fournir des commentaires détaillés :\" required=\"false\"]\n\n[/textarea]\n\n\n\n#### 5. Sélection numérique\n\nmarkdown\n\n[number question=\"Évaluez cette fonctionnalité de 1 à 10 :\" min=\"1\" max=\"10\"]\n\n[/number]\n\n\n\n#### 6. Évaluation par étoiles\n\nmarkdown\n\n[star question=\"Comment évalueriez-vous votre expérience globale ?\"]\n\n[/star]\n\n\n\n#### 7. Pouce levé/baissé\n\nmarkdown\n\n[thumbs question=\"Recommanderiez-vous ceci à d'autres ?\"]\n\n[/thumbs]\n\n\n\n### Attributs de champ\n\nTous les types de champs prennent en charge ces attributs :\n\n- question : Le texte de la question (obligatoire)\n\n- required : Si le champ doit être rempli (true/false, par défaut à true)\n\n- min : Valeur minimale pour les champs numériques\n\n- max : Valeur maximale pour les champs numériques\n\n### Exemple complet\n\n### Markdown de sondage de base\n\nVoici un exemple de base de Markdown de sondage incluant tous les champs disponibles :\n\n\n[survey name=\"sondage-genial-pouces\" title=\"Sondage Génial\"]\n\n[radio question=\"Choisissez une seule option :\"]\n- chat\n- chien\n[/radio]\n\n[checkbox question=\"Choisissez plusieurs options :\"]\n- rouge\n- bleu\n- vert\n[/checkbox]\n\n[dropdown question=\"Sexe :\"]\n- Masculin\n- Féminin\n[/dropdown]\n\n[number question=\"Évaluez ce sondage de 1 à 10 :\"]\n[/number]\n\n[textarea question=\"Quels sont vos commentaires sur xyz ?\" required=\"false\"]\n[/textarea]\n\n[star question=\"Comment évalueriez-vous l'expérience globale ?\"]\n[/star]\n\n[thumbs question=\"Êtes-vous satisfait de nos services ?\"]\n[/thumbs]\n\n[/survey]\n\n\n### Rendu du sondage\n\nCi-dessous se trouve un exemple de la façon dont le Markdown ci-dessus est rendu dans Discourse :\n\n
markdown\n\n[radio question=\"Choisissez votre animal préféré :\"]\n\n- 🐈 Chat\n\n- 🐶 Chien\n\n- 🐦 Oiseau\n\n- 🐠 Poisson\n\n[/radio]\n\n\n\n### Formatage HTML dans les questions\n\nmarkdown\n\n[radio question=\"Quel \u003cstrong\u003elangage de programmation\u003c/strong\u003e préférez-vous ?\"]\n\n- JavaScript\n\n- Python\n\n- Ruby\n\n- Go\n\n[/radio]\n\n\n\n### Champs obligatoires et facultatifs mélangés\n\nmarkdown\n\n[survey name=\"sondage-mixte\"]\n\n[radio question=\"Quel est votre rôle ?\" required=\"true\"]\n\n- Développeur\n\n- Designer\n\n- Manager\n\n- Autre\n\n[/radio]\n\n[textarea question=\"Des réflexions supplémentaires ?\" required=\"false\"]\n\n[/textarea]\n\n[/survey]\n\n\n\n## Résultats du sondage\n\nActuellement, ce plugin n’a pas d’interface utilisateur backend pour visualiser les résultats du sondage directement. Au lieu de cela, vous pouvez vous fier aux requêtes Data Explorer pour récupérer et analyser les réponses au sondage. Voici un exemple de requête :\n\nsql\n-- [params]\n-- text :survey_name = survey\n\nSELECT s.id, s.name, s.post_id, sf.question, COALESCE(sr.value, sfo.html) AS value, sr.user_id, sr.created_at as responded_at\nFROM surveys s\nJOIN survey_fields sf ON sf.survey_id = s.id\nJOIN survey_responses sr ON sr.survey_field_id = sf.id\nLEFT JOIN survey_field_options sfo ON sfo.id = sr.survey_field_option_id\nWHERE s.name = :survey_name\nORDER BY s.id DESC\n\n\n## Permissions et sécurité\n\n- Connexion requise : Les utilisateurs anonymes doivent se connecter avant de soumettre des réponses\n\n- Une réponse par utilisateur : Chaque utilisateur ne peut soumettre qu’une seule réponse par sondage\n\n- Permissions de sujet : Les utilisateurs doivent avoir un accès en lecture au sujet pour voir les sondages\n\n- Permissions de publication : Les utilisateurs doivent avoir des permissions de publication dans le sujet pour soumettre des réponses\n\n- Sujets archivés : Les sondages dans les sujets archivés ne peuvent pas accepter de nouvelles réponses\n\n- Publications supprimées : Les sondages dans les publications supprimées ne sont plus accessibles\n\n## Limitations\n\n- Un seul sondage est autorisé par publication\n\n- La structure du sondage ne peut pas être modifiée après avoir reçu des réponses\n\n- Toutes les questions des champs de sondage doivent être uniques au sein d’un même sondage\n\n- Les questions des champs de sondage ne peuvent pas être vides\n\n## Détails techniques\n\n### Schéma de la base de données\n\nLe plugin crée quatre tables de base de données principales :\n\n- surveys : Enregistrements principaux des sondages\n\n- survey_fields : Champs individuels dans les sondages\n\n- survey_field_options : Options pour les champs basés sur le choix\n\n- survey_responses : Réponses des utilisateurs aux champs de sondage\n\n### Stylisme\n\nLe plugin inclut un CSS adaptatif qui s’adapte à votre thème. Un style personnalisé peut être ajouté en ciblant ces classes CSS :\n\n- .survey - Conteneur principal du sondage\n\n- .survey-field - Enveloppe de champ individuelle\n\n- .field-[type] - Conteneurs de types de champs spécifiques\n\n- .submit-response - Bouton de soumission"
