Tribune > Aide
Aide
Sommaire
Shoop est un moteur de tribune avec un refresh périodique et automatique via Ajax.
Interfaces
Il y a plusieurs formats d'interfaces accessibles pour accéder à la tribune :
- Web standard, celle par défaut lorsque vous cliquez sur le lien du menu principal.
- Simplifiée pour les clients légers (tel que les vieux téléphones mobiles). Cette version comporte une mise en page très simplifiée et n'utilise pas javascript. Ses fonctionnalités par rapport à l'interface web sont donc très limités.
- Pour Mobile. C'est en fait l'interface web complète, avec des options activés par défaut pour n'afficher que la tribune.
- Pour terminaux. C'est une version en
plain/textlisible nottement en terminal. L'url accèpte deux arguments GET :widthpour le nombre maximum de caractères sur une ligne;limitpour le nombre maximum de messages à afficher. - L'interface pour les Coincoins (clients graphiques dédiés aux tribunes). Voir Paramètres de configuration pour les coincoins
Captcha
La tribune nécessite que les utilisateurs anonymes se conforme à un contrôle de type Captcha pour pouvoir poster un message, ceci afin de contrer l'invasion des robots de Spam.

L'utilisateur verra alors un encart voyant juste au dessus du champs de message, il y remplira le texte qu'il parvient à lire sur l'image juste à côté. Une fois rempli correctement cet encart n'apparaîtra plus tant que le navigateur de l'utilisateur ne perdra pas sa session (qui dépend d'un cookie).
Les utilisateurs anonymes de clients alternatifs à l'interface web devront donc aussi se soumettre à ce contrôle au moins une fois et spécifier leur cookie de session à leur client pour qu'il utilise toujours la session ayant passé le contrôle.
Les utilisateurs authentifiés n'auront jamais à se soumettre à ce contrôle.
Syntaxe
-
Brut
Je <tt>suis brut</tt> avec le monde entier.
Rendu : Je suis brut avec le monde entier.
-
Code
Je <code>code</code> le monde entier
Rendu : Je
codele monde entier -
Moment
<m>Je hais le monde entier</m>
Rendu : ====> Moment Je hais le monde entier <====
-
Italique
Je met <i>en italique</i> le monde entier.
Rendu : Je met en italique le monde entier.
-
Souligné
Je <u>souligne</u> le monde entier.
Rendu : Je souligne le monde entier.
-
Barré
Je <s>suis complètement barré</s> avec le monde entier.
Rendu : Je
suis complètement barréavec le monde entier. -
Gras
Je met <b>en gras</b> le monde entier.
Rendu : Je met en gras le monde entier.
Smileys
Les smileys sont reconnus et fonctionnent sur le modèle standard :
[:NOM_DU_SMILEY]
Horloges
Les horloges sont reconnues et fonctionnent presque sur le modèle standard avec un supplément. En fait il existe deux formats d'horloges possibles. Un standard et un dit complet parce qu'il comporte en plus une date.
Ci dessous la liste complète des formats possibles :
-
HH:TT -
HH:TT:SS
Légende :
- YYYY : Année
- MM : Mois
- DD : Jour
- HH : Heure
- TT : Minutes
- SS : Secondes
Wikibar
La wikibar, ou barre de raccourcis, est disponible pour ceux utilisant un navigateur avec Javascript d'activé. Elle présente plusieurs boutons qui correspondent aux possibilités de mise en forme de la syntaxe wiki.

Chaque bouton de raccourcis possède un raccourci clavier, qui est accessible grâce à la combinaison SHIFT+ALT+RACCOURCI où RACCOURCI est la lettre du raccourci suivant cette liste :
- Brut :
t - Code :
c - Moment :
m - Italique :
i - Souligné :
s - Barré :
u - Gras :
b
(Il est possible que la combinaison SHIFT+ALT+... pour obtenir un raccourci diffère quelque peu selon votre navigateur ou système d'exploitation.)
Urls
Les url sont automatiquement reconnus et transformés en liens cliquables.
Toute les urls reconnues sont enregistrés et disponibles dans la listes des archives d'url jusqu'à plus d'un mois après leur postage.
Interface Web
Chaque message peut possèder quelques signes distinctifs :
- Pour les utilisateurs authentifiés, l'horloge de référence peut être encadrée de manière à indiquer que c'est un de vos posts
- L'icône
indique qu'un message fait appel à vous (par votre nom d'utilisateur) ou fait un appel à tout le monde. - L'icône
indique qu'un message répond ou évoque l'un de vos message en référencant son horloge, qui sera affichée en gras dans le post référant.
Vous pouvez modifier vos préférences sur l'interface Web via une fenêtre modale disponible en cliquant sur l'icône
à côté de la Wikibar.

L'option Délai de rafraîchissement est à indiquer en Millisecondes, il ne peut être inférieur à 1000. Il est recommandé de ne pas l'abaisser à moins de 5000. Une valeure incorrecte sera ignorée.
Le bouton Abandonner ferme la fenêtre sans changer les options, le bouton Accepter valide vos changements qui seront alors utilisés.
Notez l'option Sauvegarder les modifications qui n'est utilisable que par les utilisateurs authentifiés.
Ceux ci pourront donc sauver leur préférences dans leur profil, elles seront ensuite utilisées à chaque chargement de la page.
Paramètres de configuration pour les coincoins
- Url du backend :
http://dax.sveetch.net/tribune/remote.xml - Url pour poster :
http://dax.sveetch.net/tribune/post.xml - Variable pour poster :
content=%s - Type de slip
- Pour PyCoinCoin : Tags encoded
- Pour WmCoinCoin (backend flavour) : message tags are "htmlentitised"
- Taille maximale du post : 500 caractères
Le backend est limité à "42 x 2" posts. Il ya en outre un paramètre GET possible pour envoyer le dernier identifiant récupéré par le client, afin de ne pas renvoyer le backend complet à chaque refresh. Ce paramètre se nomme last.
Le nom du cookie à récupérer après vous être authentifié sur le site est shoop_sessionid.
Les clients qui l'implémentent, peuvent utiliser le header HTTP X-Post-Id pour récupérer l'identifiant d'un post dès qu'il a été créé.
Commandes
Il y a deux types de commandes, celles réservés aux administrateurs (qui ont accès à l'interface d'admin) et celles des utilisateurs (disponible aussi aux anonymes).
Les commandes, lorsqu'elles sont correctement tappées et réussies, ne sont pas affichés sur la tribune.
Admin
Commandes réservés aux utilisateurs authentifiés ayant les droits is_staff. Les commandes admin démarrent toujours par /admin puis un espace et le nom de la commande.
- Lancer un flood :
/admin flood. Le texte de remplissage est tiré d'une liste python, qu'on surnomme 'chanson', il n'y a pour l'instant qu'une chanson appelée default, à terme il devrait y'en avoir quelques autres. Pour flooder avec une chanson spécifique, il suffit de rajouter son nom clé tel que/admin flood default.
Action
Commandes ouvertes à tous. Les commandes d'actions démarrent toujours par /action puis un espace et le nom de la commande.
- Changer son ua sur la tribune :
/action ua mon_login
Bunker
Commande réservé aux utilisateurs authentifiés.
Le bunker est un mode de lecture protégée des messages. Il permet de créer vos propres règles de filtrages des messages des utilisateurs authentifiés ou anonymes. Lorsqu'il est activé, par défaut il affiche uniquement les messages des utilisateurs. Il vous est possible ensuite de filtrer les utilisateurs authentifiés par règles à l'unité d'acceptation ou de refus. De même vous pouvez accepter tout les messages anonymes et utiliser des règles à l'unité d'acceptation/refus basés sur le User-Agent des messages anonymes.
Activation et désactivation
Par défaut le bunker est désactivé.
/bunker on: Active le bunker/bunker off: Désactive le bunker
L'activation et la désactivation ne changent pas la configuration du bunker, il reste intact.
Notez que par défaut, un bunker neuf contient une seule règle qui est une règle d'acceptation all pour afficher tout les messages des utilisateurs authentifiés, mais rien pour les messages anonymes.
Règles d'acceptation des messages
Elle est assimilé à une whitelist qui liste toute les entités autorisés. Par défaut cette whitelist accept tout les utilisateurs authentifiés, mais il est possible de faire des séléctions à l'unité, dans ce cas l'option "all" est alors écrasée.
/bunker accept user1,user2
Indique au bunker d'accepter les messages des utilisateurs user1 et user2. Il est possible de séléctionner de 1 à 5 utilisateurs par commande, au dela ils ne seront pas pris en compte. La séléction se fait sur le nom d'utilisateur, s'il y'en a plusieurs ils doivent être séparés par une virgule sans espaces.
Les règles sont cumulatifs, si vous aviez déja séléctionné d'autres utilisateurs auparavant, ils resteront en place.
/bunker accept all
Indique d'accepter les messages de tout les utilisateurs. C'est l'option par défaut du bunker s'il ne possède pas de séléctions. L'utilisation de cette option entraine la perte de tout vos séléctions à l'unité.
/bunker accept del user1
Permet de supprimer la règle d'acceptation de l'utilisateur user1.
Pour accepter des messages d'utilisateurs anonymes, vous pouvez utiliser la commande anonaccept qui indique un User-Agent à accepter. Cette commande fonctionne exactement pareil que accept si ce n'est qu'elle n'accepte qu'un User-Agent par commande.
/bunker anonaccept Mozilla1.0.1
/bunker anonaccept del Mozilla1.0.1
Règles de refus des messages
Elle est assimilée à une blacklist qui liste toute les entités à refuser. Par défaut cette blacklist est vide.
/bunker refuse user1,user2
Indique au bunker de refuser les messages des utilisateurs user1 et user2. Il est possible de séléctionner de 1 à 5 utilisateurs par commande, au dela ils ne seront pas pris en compte. La séléction se fait sur le nom d'utilisateur, s'il y'en a plusieurs ils doivent être séparés par une virgule sans espaces.
Les séléctions sont cumulatifs, si vous aviez déja séléctionné d'autres utilisateurs auparavant, ils resteront en place.
/bunker refuse del user1
Permet de supprimer la règle de refus de l'utilisateur user1.
Pour refuser des messages d'utilisateurs anonymes, vous pouvez utiliser la commande anonrefuse qui indique un User-Agent à refuser. Cette commande fonctionne exactement pareil que refuse si ce n'est qu'elle n'accepte qu'un User-Agent par commande.
/bunker anonrefuse Mozilla1.0.1
/bunker anonrefuse del Mozilla1.0.1
Sauvegarde et chargement de la configuration
/bunker save
L'option "save" permet de sauvegarder dans votre compte la configuration actuelle de votre bunker pour pouvoir la recharger plus tard. La configuration sauvegardée comprends les règles d'acceptation et de refus ainsi que l'état de son activation.
Si vous avez refait des règles depuis un bunker neuf sans charger auparavant vos règles déja enregistrés, ces dernières seront écrasés par la prochaine sauvegarde.
Tout comme la sauvegarde, le chargement de cette configuration est manuel, il se fait avec la commande suivante :
/bunker load
Charger une configuration écrase complètement la configuration de votre session actuelle.
Nettoyage
/bunker clean
L'option "clean" permet de nettoyer définitivement la configuration de votre bunker, il retournera alors dans l'état par défaut tel qu'il était livré à sa première création.
Notez que ce nettoyage s'applique sur le bunker en mémoire de votre navigateur (via ses cookies), pour le sauvegarder définitivement il vous faudra ensuite utiliser la commande save.
Options anti-rechargement
À chaque action réussie du bunker que vous effectuez, l'interface est automatiquement rechargée. Si vous effectuez plusieurs actions à la fois cela peut être gênant, il est possible d'empêcher ce rechargement. Pour cela il vous suffit de finir votre ligne avec un espace suivi du caractère : !
Par exemple :
/bunker refuse user1,user2 !
/bunker on !