Changeset 1786
- Timestamp:
- 10/28/09 07:48:17 (14 years ago)
- Location:
- plugins/rateIt
- Files:
-
- 2 edited
Legend:
- Unmodified
- Added
- Removed
-
plugins/rateIt/README.txt
r1335 r1786 1 1 rateIt 0.5 (2009/07/09) plugin for Dotclear 2 2 2 3 Préambule: 3 Préambule 4 ========= 5 6 Cette extension pour Dotclear 2 permet d'ajouter un système complet 7 de notation pour les billets (et plus avec ses addons). 8 9 Cette documentation est en cours d'écriture... 10 11 12 I. Licence 4 13 ========== 5 6 Cette extension pour Dotclear 2 permet d'ajouter un système complet7 de notation pour les billets. (et plus avec ses addons).8 9 Cette documentation est en cours d'écriture...10 11 12 I. Licence:13 ===========14 14 15 15 This file is part of rateIt, a plugin for Dotclear 2. … … 38 38 39 39 40 II. Support :41 =========== =40 II. Support 41 =========== 42 42 43 43 http://dotclear.jcdenis.com/ … … 46 46 47 47 48 III. Installation: 48 III. Installation 49 ================= 50 51 Voir la procédure d'installation des plugins Dotclear 2. 52 Pour information, le plugin rateIt crée la table "rateit". 53 54 55 IV. Désintallation 49 56 ================== 50 57 51 Voir la procédure d'installation des plugins Dotclear 2. 52 Pour information, le plugin rateIt créé la table "rateit". 53 54 55 IV. Désintallation: 56 =================== 57 58 Une procédure est disponible à partir du gestionnaire d'extension 58 Une procédure est disponible à partir du gestionnaire d'extensions 59 59 ou depuis l'onglet "désinstallation" de l'extension "RateIt". 60 60 Si la désintallation est impossible par cette procédure, … … 62 62 63 63 64 V. Onglet "Administration" :65 ========================== =66 67 V.1 Extension :68 ------------- -64 V. Onglet "Administration" 65 ========================== 66 67 V.1 Extension 68 ------------- 69 69 70 70 "Activer l'extension" 71 71 Permet d'activer ou non l'extension sur un blog. 72 72 Avec une configuration d'origine, la désactivation de l'extension 73 masquera toutes les balise en rapport avec le plugin coté publi que.73 masquera toutes les balise en rapport avec le plugin coté public. 74 74 75 75 "Identifier l'utilisateur par" 76 M ethode de gestion des votes, soit par Ip, soit par cookie, soit les deux.76 Méthode de gestion des votes, soit par Ip, soit par cookie, soit les deux. 77 77 Chaque méthode a ses avantages et ses inconvénients. 78 78 79 V.2 Note: 79 V.2 Note 80 -------- 81 82 "Note sur" 83 Permet de modifier le quotient de la note de 2 à 20 (exemple de note 5/20). 84 85 "Nombre de décimales" 86 Permet d'arrondir le résultat affiché à x chiffres après la virgule (de 0 à 4). 87 88 "Message de remerciement" 89 Après un vote l'interface peut être modifiée en affichant un message au votant. 90 Si le message est vide, l'interface ne sera pas modifiée. 91 92 V.2 Image 80 93 --------- 81 94 82 "Note sur" 83 Permet de modifier le quotient de la note de 2 à 20. (exemple de note 5/20) 84 85 "Nombre de décimals" 86 Permet d'arrondir le résultat affiché à x chiffres après la virgule. (de 0 à 4) 87 88 "Message de remerciement" 89 Après un vote l'interface peut être modifié en affichant un message au votant. 90 Si le message est vide, l'interface ne sera pas modifié. 91 92 V.2 Image: 93 ---------- 94 95 Vous pouvez modifer l'apparence de l'interface de vote avec 96 un choix prédéfinie d'image ou en en ajoutant une nouvelle. 97 La nouvelle image doit obligatoirement être à format "png" 98 et avec trois parties égales en hauteur: 99 - Une partie haute représentant "un non vote", 95 Vous pouvez modifier l'apparence de l'interface de vote avec 96 un choix prédéfini d'image ou en en ajoutant une nouvelle. 97 La nouvelle image doit obligatoirement être au format "png" 98 et avec trois parties égales en hauteur : 99 - une partie haute représentant "un non vote", 100 100 - une partie centrale représentant un vote positif et 101 - une partie basse représentant le survol epar la souris.101 - une partie basse représentant le survol par la souris. 102 102 La largeur et la hauteur sont à votre convenance. 103 103 104 L'ordre de recherche de l'image est :105 1) dans le th eme utilisé par le blog, fichier: /img/rateit-stars.png106 2) dans le r epertoire public du blog, fichier: /rateit/rateit-stars.png107 3) dans le r epertoire de l'extention, fichier: /default-template/img/rateit-stars.png108 109 110 VI. Onglet "Désintallation" :111 =========================== =104 L'ordre de recherche de l'image est : 105 1) dans le thème utilisé par le blog, fichier : /img/rateit-stars.png 106 2) dans le répertoire public du blog, fichier : /rateit/rateit-stars.png 107 3) dans le répertoire de l'extension, fichier : /default-template/img/rateit-stars.png 108 109 110 VI. Onglet "Désintallation" 111 =========================== 112 112 113 113 ... 114 114 115 115 116 VII. Onglet "A propos" :117 ====================== =116 VII. Onglet "A propos" 117 ====================== 118 118 119 119 Donne des indications sur l'extension. 120 La version, Les droits, des liens vers le support...121 122 123 VIII. Onlget "Billets" :124 ===================== =125 126 127 VIII.1 Options :128 -------------- -129 130 "Inclure dans les pages des billets" :120 La version, les droits, des liens vers le support... 121 122 123 VIII. Onlget "Billets" 124 ===================== 125 126 127 VIII.1 Options 128 -------------- 129 130 "Inclure dans les pages des billets" 131 131 Utilisé pour le template post.html. 132 132 Permet d'inclure l'outil de vote directement à la fin d'un billet sans modifier les templates. 133 133 La balise {{tpl:SysBehavior behavior="publicEntryAfterContent"}} doit être présente 134 dans le thème utilisé pour que cet e option fonctionne.135 136 "Inclure sur la page d'accueil" :137 Utilisé pour le template home.html. Idem que ci-dessus.138 139 "Inclure sur la page des catégories" :134 dans le thème utilisé pour que cette option fonctionne. 135 136 "Inclure sur la page d'accueil" 137 Utilisé pour le template home.html. Idem que ci-dessus. 138 139 "Inclure sur la page des catégories" 140 140 Utilisé pour le template category.html. Idem que ci-dessus. 141 141 142 "Limiter à une catégorie" :143 Permet de limiter les votes àune seule catégorie.144 145 146 IX. Autres onlgets :147 ================== =142 "Limiter à une catégorie" 143 Permet de limiter les votes aux billets d'une seule catégorie. 144 145 146 IX. Autres onlgets 147 ================== 148 148 149 149 D'autres onglets peuvent être présents si d'autres plugins … … 152 152 153 153 154 X. Widgets :155 ========== =154 X. Widgets 155 ========== 156 156 157 157 2 widgets sont disponibles: 158 158 159 X.1 Evaluation :160 -------------- -161 162 Ce widget (de class "rateitwidget" 159 X.1 Evaluation 160 -------------- 161 162 Ce widget (de class "rateitwidget") permet d'afficher une interface de vote sur la page d'un billet. 163 163 164 164 "Autoriser le vote pour les billets" … … 168 168 "Titre pour les billets" 169 169 Permet de modifier le titre du widget pour le vote sur les billets. 170 Si ce champ sest vide alors la balise de titre ne sera pas présente.170 Si ce champ est vide alors la balise de titre ne sera pas présente. 171 171 172 172 "..." … … 176 176 177 177 "Afficher la note complète" 178 Ajoute l'affichage d'une balise de class "rateit-fullnote" contenant :179 - soit la note complète, exemple : 5/20,180 - soit la note en pourcentage, exemple : 25%181 - soit la balise n'est pas présente si "cacher" est s electionné.178 Ajoute l'affichage d'une balise de class "rateit-fullnote" contenant : 179 - soit la note complète, exemple : 5/20, 180 - soit la note en pourcentage, exemple : 25% 181 - soit la balise n'est pas présente si "cacher" est sélectionné. 182 182 183 183 "Afficher la note" 184 Affiche la note dans une list -item,184 Affiche la note dans une liste d'items, 185 185 186 186 "Afficher le nombre de votes" … … 190 190 Idem ci-dessus. 191 191 192 "Affi her la note la plus basse"192 "Afficher la note la plus basse" 193 193 Idem ci-dessus. 194 194 195 195 196 X.2 Top évaluation :197 ------------------ -196 X.2 Top évaluation 197 ------------------ 198 198 199 199 Ce widget (de class "rateitpostsrank") permet d'afficher un classement des votes. … … 205 205 "Type" 206 206 Par défaut seul le type "Billets" est présent. 207 D'autres type sont possibles ici si d'autres plugins utilisent la même interface.207 D'autres types sont possibles ici si d'autres plugins utilisent la même interface. 208 208 Un behavior "parseWidgetRateItRank" est disponible ici. 209 209 … … 212 212 213 213 "Trier par" 214 Il est possible de trier les résultats par nombre de vote ou par note.214 Il est possible de trier les résultats par nombre de votes ou par note. 215 215 216 216 "Trier" … … 218 218 219 219 "Texte" 220 Permet de mettre en forme le résultat avec comme options :220 Permet de mettre en forme le résultat avec comme options : 221 221 - %rank% : le rang (1, 2, 3...) 222 222 - %title% : le titre du billet, … … 224 224 - %quotient% : le quotient, 225 225 - %percent% : la note en pourcentage, 226 - %count% : le nombre de vote .226 - %count% : le nombre de votes. 227 227 228 228 "Uniquement sur la page d'accueil" … … 230 230 231 231 232 XI. Comment modifier l'apparence de l'extension ?233 ================================================ 234 235 XI.1 Emplacement des fichiers :236 ----------------------------- -232 XI. Comment modifier l'apparence de l'extension ? 233 ================================================= 234 235 XI.1 Emplacement des fichiers 236 ----------------------------- 237 237 238 238 ... 239 239 240 XI.2 les widgets:241 ---------------- -240 XI.2 Les widgets 241 ---------------- 242 242 243 243 a) Widget "Evaluation": 244 244 245 Voici la structure type de ce widget :245 Voici la structure type de ce widget : 246 246 247 247 <div class="rateitwidget"> … … 265 265 266 266 La structure de la balise "form" est modifiée par le javascript de notation. 267 La structure CSS en rapport avec ce javascript est directement généré dans267 La structure CSS en rapport avec ce javascript est directement générée dans 268 268 le code source de la page. 269 269 270 270 b) Widget "Top évaluation": 271 271 272 Voici la structure type de ce widget :272 Voici la structure type de ce widget : 273 273 274 274 <div class="rateitpostsrank"> … … 282 282 </div> 283 283 284 XI.3 Formulaires inclus dans la page :285 ------------------------------------ -284 XI.3 Formulaires inclus dans la page 285 ------------------------------------ 286 286 287 287 Son emplacement dépend du thème utilisé sur le blog. 288 288 Par défaut il se situe après le contenu d'un billet 289 et utilise le behavior {{tpl:SysBehavior behavior="publicEntryAfterContent"}} 289 et utilise le behavior {{tpl:SysBehavior behavior="publicEntryAfterContent"}}. 290 290 Son apparence dépend également du thème. 291 291 Par défaut il utilise le fichier "default-templates/tpl/rateit.html" de l'extension. 292 292 293 293 294 XII. Comment étendre cette extension à d'autres types de notation ?295 ================================================================== 294 XII. Comment étendre cette extension à d'autres types de notation ? 295 =================================================================== 296 296 297 297 ... … … 357 357 358 358 359 XIV. Public Urls, values, blocks :360 ================================= 359 XIV. Public Urls, values, blocks : 360 ================================== 361 361 362 362 XIV.1 Urls: … … 369 369 "rateitservice": 370 370 371 371 372 XIV.2 blocks: 372 373 ------------- … … 376 377 "rateItIf": 377 378 379 378 380 XIV.3 values: 379 381 ------------- … … 396 398 397 399 398 XV. Javascripts :399 =============== =400 XV. Javascripts 401 =============== 400 402 401 403 ... 402 404 403 405 404 XVI. Base de données :405 ==================== =406 407 XVI.1 Structure :408 --------------- -406 XVI. Base de données 407 ==================== 408 409 XVI.1 Structure 410 --------------- 409 411 410 412 CREATE TABLE `dc_rateit` ( … … 449 451 ===================== 450 452 451 Je tiens à rem iercier les personnes qui ont eu la patience de tester toutes les versions d'essais453 Je tiens à remercier les personnes qui ont eu la patience de tester toutes les versions d'essai 452 454 et de donner un coup de main. Je remercie également toute l'équipe de Dotclear. 453 455 -
plugins/rateIt/locales/fr/main.po
r1458 r1786 4 4 # Author: JC Denis, jcdenis@gdwd.com 5 5 # Translated with dcTranslater - 0.2.4 6 7 6 msgid "" 8 msgstr "Content-Type: text/plain; charset=UTF-8\n" 7 msgstr "" 8 "Content-Type: text/plain; charset=UTF-8\n" 9 "Project-Id-Version: \n" 10 "POT-Creation-Date: \n" 11 "PO-Revision-Date: \n" 12 "Last-Translator: Kozlika <kozlika@free.fr>\n" 13 "Language-Team: \n" 14 "MIME-Version: 1.0\n" 15 "Content-Transfer-Encoding: 8bit\n" 9 16 10 17 #: index.php:49 … … 18 25 #: _admin.php:83 19 26 msgid "Do you really want to delete all votes for these entries?" 20 msgstr "Êtes vous sûr de vouloir effacer les votes pour ces entrées?"27 msgstr "Êtes-vous sûr de vouloir effacer les votes pour ces entrées ?" 21 28 22 29 #: _widgets.php:30 … … 34 41 #: _widgets.php:41 35 42 msgid "Rate this tag" 36 msgstr "Évaluer ce ttag"43 msgstr "Évaluer ce tag" 37 44 38 45 #: _widgets.php:48 … … 218 225 #: inc/lib.rateit.index.php:228 219 226 msgid "Something went wrong while download file" 220 msgstr "Une erreur est survenue lors d etéléchargement de l'image"227 msgstr "Une erreur est survenue lors du téléchargement de l'image" 221 228 222 229 #: inc/lib.rateit.index.php:231 … … 242 249 #: inc/lib.rateit.index.php:258 243 250 msgid "Disable public javascript" 244 msgstr "Désactiver le javascript publi que"251 msgstr "Désactiver le javascript public" 245 252 246 253 #: inc/lib.rateit.index.php:259 247 254 msgid "Disable public css" 248 msgstr "Désactiver l eCSS publique"255 msgstr "Désactiver la CSS publique" 249 256 250 257 #: inc/lib.rateit.index.php:260 … … 294 301 #: inc/lib.rateit.index.php:285 295 302 msgid "hover" 296 msgstr "survol e"303 msgstr "survol" 297 304 298 305 #: inc/lib.rateit.index.php:285 … … 302 309 #: inc/lib.rateit.index.php:284 303 310 msgid "Rating image not exists on theme choose one to use:" 304 msgstr "L'image de vote n'existe pas dans le thème, en choisir une :"311 msgstr "L'image de vote n'existe pas dans le thème, en choisir une :" 305 312 306 313 #: inc/lib.rateit.index.php:311 … … 370 377 #: inc/lib.rateit.index.php:988 371 378 msgid "To use this option you must have behavior "publicEntryAfterContent" in your theme" 372 msgstr "Pour utiliser cette option vous devez avoir le behavior \"publicEntryAfterContent\"dans votre thème"379 msgstr "Pour utiliser cette option le behavior \"publicEntryAfterContent\" doit être présent dans votre thème" 373 380 374 381 #: inc/lib.rateit.index.php:527 … … 382 389 #: inc/lib.rateit.index.php:533 383 390 msgid "This is the list of all entries having rating" 384 msgstr "Ceci est la liste des billets a illantdes votes"391 msgstr "Ceci est la liste des billets ayant reçu des votes" 385 392 386 393 #: inc/lib.rateit.index.php:624 … … 402 409 #: inc/lib.rateit.index.php:666 403 410 msgid "This is a list of all the categories having rating" 404 msgstr "Ceci est la liste des toutes les catégories a illantdes votes"411 msgstr "Ceci est la liste des toutes les catégories ayant reçu des votes" 405 412 406 413 #: inc/lib.rateit.index.php:1196 … … 434 441 #: inc/lib.rateit.index.php:747 435 442 msgid "To use this option you must have behavior "publicCommentAfterContent" in your theme" 436 msgstr "Pour utiliser cette option vous devez avoir le behavior \"publicCommentAfterContent\"dans votre thème"443 msgstr "Pour utiliser cette option le behavior \"publicCommentAfterContent\" doit être présent dans votre thème" 437 444 438 445 #: inc/lib.rateit.index.php:771 … … 446 453 #: inc/lib.rateit.index.php:778 447 454 msgid "This is a list of all the comments having rating" 448 msgstr "Ceci est la liste de s toutes les commentaires aillantdes votes"455 msgstr "Ceci est la liste de tous les commentaires ayant reçu des votes" 449 456 450 457 #: inc/lib.rateit.index.php:855 … … 458 465 #: inc/lib.rateit.index.php:891 459 466 msgid "This is a list of all the tags having rating" 460 msgstr "Ceci est la liste des tags a illantsdes votes"467 msgstr "Ceci est la liste des tags ayant reçu des votes" 461 468 462 469 #: inc/lib.rateit.index.php:895 … … 498 505 #: inc/lib.rateit.index.php:1013 499 506 msgid "This is a list of all the galleries having rating" 500 msgstr "Ceci est la liste des galeries a illantsdes votes"507 msgstr "Ceci est la liste des galeries ayant reçu des votes" 501 508 502 509 #: inc/lib.rateit.index.php:1017 … … 514 521 #: inc/lib.rateit.index.php:1068 515 522 msgid "This is a list of all the galleries items having rating" 516 msgstr "Ceci est la liste des images a illantsdes votes"523 msgstr "Ceci est la liste des images ayant reçu des votes" 517 524 518 525 #: inc/lib.rateit.index.php:1072
Note: See TracChangeset
for help on using the changeset viewer.