COMMENT... administrer un joueb ?
Sommaire :
-> LES COMMANDES D'ADMINISTRATION
-> Publication d'informations
-> Edition et effacage d'informations et de commentaires
-> LE MENU ADMINISTRATEUR
-> Le Site
-> Les Rubriques
-> Les Groupes
-> Les Permissions
-> Les Utilisateurs
-> Les Textes
-> Les Images
-> Les Listes et les Blocs Libres
-> Les modèles de mise en page
-> Les Statistiques
-> LES MODELES DE MISE EN PAGE
-> Les objets
-> Les attributs
-> Les objets multiples
-> Les objets encastres
-> Les sous-attributs des textes
-> Les sous-attributs des dates
-> Les modificateurs de l'attribut "html"
-> Les modificateurs des attributs numeriques
-> Les conditions sur les objets
-> Les conditions sur les attributs
-> LES OBJETS
-> Objets globaux
-> archive
-> archive_entry
-> active_summaries
-> active_summary
-> active_summary_new_comments
-> categories
-> category
-> category_selected
-> category_not_selected
-> cmd_add_oneliner
-> cmd_administrator_menu
-> cmd_register
-> cmd_submit_news
-> cmd_view_submissions
-> form_login
-> form_logout
-> form_search
-> niutopia_summaries
-> niutopia_summary
-> niutopia_summary_new_comments
-> oneliners
-> oneliner
-> random_line
-> random_url
-> rss_summaries
-> rss_summary
-> talk_about_it
-> user
-> Sommaire
-> random_summary
-> summaries
-> summary
-> summary_poll
-> summary_no_text_follows
-> summary_text_follows
-> summary_new_comments
-> summary_new_day
-> Information
-> comments
-> comment
-> comment_new
-> comment_reply_to
-> news
-> news_poll_results
-> news_poll_result
-> news_first
-> news_last
-> news_next
-> news_previous
-> Formulaire
-> form
-> Message
-> message
-> Message d'erreur
-> error_message
-> Texte
-> text
L'administration, comme l'utilisation et la creation d'un joueb avec Niutopia se
deroule entierement sur le web.
Une fois cree, le joueb est immediatement pret a
l'emploi. Les commandes d'administration sont suffisantes pour
utiliser et administrer un joueb simple, aucune autre configuration du joueb
n'est necessaire.
Toutefois, si vous souhaitez pleinement profiter de toutes les
possibilites offertes par Niutopia, l'utilisation du menu administrateur
vous permettra de transformer votre joueb en VOTRE joueb.
Enfin, pour donner a votre joueb l'apparence que vous souhaitez,
les modèles de mise en page et les objets se reveleront etre
un outil simple et puissant (une connaissance de base du langage HTML est utile).
Si vous n'avez pas encore cree votre joueb, suivez le lien ci-dessous :
--> COMMENT... creer un joueb ?
LES COMMANDES D'ADMINISTRATION
Les commandes d'administration apparaissent sous forme de liens directement sur le joueb.
Elles sont seulement visibles par l'administrateur du joueb et les personnes a qui il
en a donne l'acces. A l'inverse du menu administrateur, les commandes n'agissent que sur
un seul element du joueb : une information particuliere ou un commentaire particulier par
exemple.
Edition et effacage d'informations et de commentaires
En dessous des informations et des commentaires figure un lien "Editer". Lorsque ce lien
est clique, un formulaire apparait avec les champs correspondants a l'information ou
au commentaire. La valeur de ces champs peut etre alors modifiee. Le bouton "Valider"
permet de valider les changements. La modification est instantanee.
Dans le formulaire figure egalement une case "Effacer". Lorsque cette case est selectionnee,
la validation du formulaire entraine l'effacage de l'information ou du commentaire.
Publication d'informations
Les informations ecrites par l'administrateur ou les utilisateurs du joueb ne sont pas
publiees directement. Une fois ecrites, elles existent seulement dans la rubrique des
informations proposees. Seul l'administrateur et les personnes a qui il en a donne l'acces
peuvent acceder a cette rubrique et a ces informations. Ils peuvent les editer, les
effacer et les commenter.
Lorsque l'administrateur desire rendre une information proposee accessible a tous sur son joueb,
il la publie. Elle passe alors de la rubrique des informations proposees vers la rubrique
des informations publiees.
Pour publier une information, il faut l'editer
(voir Edition et effacage d'informations et de commentaires)
et selectionner la case "Publier".
L'administrateur peut egalement selectionner la case "Publier" lors de l'ecriture
d'une information afin de la publier immediatement.
LE MENU ADMINISTRATEUR
L'acces au menu administrateur est reserve a l'administrateur du joueb et les personnes
a qui il en a donne l'acces. A l'inverse des commandes d'administration, le menu
administrateur permet de changer globalement le joueb. Par exemple, changer les couleurs
utilisees dans le modèle de mise en page changera l'aspect de toutes les pages du joueb.
Pour acceder au menu administrateur, cliquez sur "Menu Administrateur".
Le menu administrateur est compose des sous-menus suivants :
Le Site
Le sous-menu Site permet de changer :
- Le titre du site. Ce site est utilise notamment lorsque un joueb affiche les titres
des informations d'un autre joueb.
- La langue. Pour l'instant, seuls le francais et l'anglais sont disponibles. La langue
est utilisee pour afficher les differents formulaires. Notez que pour qu'un site soit
entierement dans une langue, les mots et phrases utilises dans le modèle de mise en page doivent egalement
etre dans cette langue.
- La premiere page. Ce champ permet d'indiquer si vous souhaitez avoir un sommaire des
informations publiees sur la premiere page (choix classique) ou plutot directement la derniere information
publiee (choix utilise pour des cas particuliers comme les webcomics).
- Le nom des utilisateurs anonymes.
- Le decalage horaire avec l'heure de Paris. Si vous souhaitez que les heures soient affichees
avec une autre heure que celle de Paris, indiquez le decalage souhaite. Pour vous aider, l'heure
courante de Paris est affichee.
Les utilisateurs peuvent choisir leur propre decalage. Cochez la case "Interdire l'utilisation du decalage horaire des utilisateurs"
pour que le decalage horaire de votre joueb soit toujours utilise, quelque soit l'utilisateur.
- L'affichage des "tetoucoms" des auteurs des commentaires.
- L'affichage des "liens croises". Si cette case est cochee, lorsque quelqu'un fait un lien
vers un de vos articles, la premiere fois qu'un visiteur cliquera sur ce lien, Niutopia ira
verifier le lien et capturer le contexte du lien pour le publier en tant que commentaire sur
votre joueb.
Les Rubriques
Chaque information appartient a une rubrique. Cette rubrique est choisie lors
de l'ecriture de l'information et peut etre changee par la suite. A chaque rubrique
correspond egalement un sommaire des informations. Une liste des rubrique avec des
liens vers les sommaires correspondants peut egalement etre affichee.
Le sous-menu Rubriques permet de creer, modifier et effacer vos propres rubriques.
2 rubriques existent par defaut et ne peuvent etre effacees :
- La rubrique _submissions est une meta-rubrique qui englobe toutes les informations
proposees (et qui n'ont ete ni publiees, ni effacees).
- La rubrique _news est une meta-rubrique qui englobe toutes les informations publiees.
Si vous avez choisi "Sommaire" comme premiere page de votre joueb
(voir le sous-menu Site), c'est le sommaire de cette rubrique
(le sommaire principal) qui apparait en premiere page de votre joueb.
Le sous-menu Rubrique liste toutes les rubriques de votre joueb.
Chaque rubrique comporte les champs suivants :
- Identifiant : l'identifiant de la rubrique. Il peut etre compose de lettres et
d'espaces et du caractere "_". Il apparait dans l'adresse du sommaire de la rubrique.
Par exemple, l'identifiant de la rubrique Science Fiction de TONIciné est "sf"
et l'adresse du sommaire est : http://joueb.com/tonicine/sf.shtml.
- Priorite : la priorite permet de changer l'ordre d'apparition des rubriques dans
la liste des rubriques. Les rubriques qui ont les priorites les plus proches de zero
sont listees en premier.
- Ordre : 'ordre des informations dans le sommaire de la rubrique.
"Plus recent" permet d'afficher les informations les plus recentes en premier,
et "Plus ancien" le contraire.
- Indexage : si cette case est selectionnee, les informations publiees qui appartiennent
a cette rubrique apparaissent dans le sommaire principal.
- Commentaires : si cette case est selectionnee, les utilisateurs peuvent ajouter
des commentaires aux informations publiees qui appartiennent a cette rubrique.
- En fil : si cette case est selectionnee, les commentaires des informations qui
appartiennent a cette rubrique sont listes en fil. Les reponses a un commentaire
apparaissent directement sous ce commentaire. Autrement, les commentaires sont listes
dans l'ordre chronologique.
- Titre : le titre de la rubrique. Utilise dans la liste des rubriques.
- Description : la description de la rubrique. Utilisee dans la liste des rubriques.
Pour creer une nouvelle rubrique, cliquez sur "Ajouter une rubrique" et remplissez
les champs decrits ci-dessus.
Une rubrique ne peut etre effacee, mais elle peut "fusionner" avec une autre rubrique.
Tous les messages de l'ancienne rubrique sont alors transferes vers la nouvelle rubrique.
Pour fusionner une rubrique, cochez la case "Fusionner avec" et selectionnez la nouvelle
rubrique.
Les Groupes
Niutopia permet a chaque administrateur de joueb de definir des groupes d'utilisateurs
auxquels peuvent etre attribuees differentes permissions.
Le sous-menu Groupes permet de creer, modifier et effacer les groupes.
3 groupes existent par defaut et ne peuvent etre effaces :
- Le groupe _anonymous contient les utilisateurs qui ne sont pas inscrits sur Niutopia
ou qui n'ont pas ouvert de session. Les informations proposees et commentaires des
utilisateurs de ce groupe ne sont pas signes.
- Le groupe _non_anonymous contient les utilisateurs qui se sont inscrits sur Niutopia
et qui ont ouvert une session.
- Le groupe _registered contient les utilisateurs qui se sont inscrits sur Niutopia, qui
ont ouvert une session et qui se sont specifiquement inscrits sur le joueb.
Le sous-menu Groupes liste tous les groupes de votre joueb.
Chaque groupe comporte les champs suivants :
- Identifiant : l'identifiant du groupe. Il peut etre compose de lettres et
d'espaces et du caractere "_".
- Priorite : la priorite permet de changer l'ordre d'apparition des groupes.
Les groupes qui ont les nombres les priorites les plus proches de zero
sont listees en premier.
- Titre : le titre du groupe.
- Description : la description du groupe.
Pour creer un nouveau groupe, cliquez sur "Ajouter un groupe" et remplissez
les champs decrits ci-dessus.
Les Permissions
Niutopia permet a chaque administrateur de joueb de definir des groupes d'utilisateurs
auxquels peuvent etre attribuees differentes permissions.
Le sous-menu Permissions permet de changer les permissions accordees aux groupes.
Les permissions definissent toutes les actions qu'un utilisateur peut ou ne pas faire.
Un tableau liste pour chaque action et pour chaque groupe si les utilisateurs du groupe
sont autorises a effecter l'action.
Note : pour des raisons de place, un numero est attribue a chaque groupe. La correspondance
entre numero et groupe est affichee avant le tableau.
Pour autoriser les utilisateurs d'un groupe a effectuer une action, selectionnez la
case correspondante.
ATTENTION : si vous donnez acces au menu administrateur ainsi qu'aux
sous-menus Permissions ou Utilisateurs a un groupe, les utilisateurs de ce groupe pourront
ou se changer de groupe ou donner plus de permissions a leurs groupes et ainsi acceder
a l'ensemble du site. Ne donnez acces au menu administrateur, meme en partie, qu'a des
personnes a qui vous accordez votre entiere confiance.
Les Utilisateurs
Niutopia permet a chaque administrateur de joueb de definir des groupes d'utilisateurs
auxquels peuvent etre attribuees differentes permissions.
Le sous-menu Utilisateurs permet de changer les utilisateurs de groupe ou de les
desinscrire du joueb. Vous pouvez egalement ajouter d'autres utilisateurs. Vous n'avez pas
besoin d'ajouter des utilisateurs si vous ne souhaitez pas leur donner de permissions
particulieres.
Les utilisateurs qui se sont inscrits ou que vous avez ajoute et le groupe auxquel ils appartiennent sont listes.
Pour changer un utilisateur de groupe, selectionnez l'identifiant du groupe souhaite.
Pour desinscrire un utilisateur du joueb, selectionnez la case "Effacer".
Les Textes
Les textes sont des pages statiques, qui font partie du joueb, mais qui sont a part
des pages dynamiques (sommaires et informations). Ils peuvent etre utilises pour ecrire
une Foire Aux Questions, une page de contacts, une charte d'utilisation etc. Par exemple,
le document que vous etes en train de lire est un texte.
Les textes sont des fichiers au format texte. L'emploi des balises HTML est possible.
Toutefois, les textes seront affiches directement avec l'apparence definiee dans le modèle de mise en page
du joueb.
Le sous-menu Textes liste les fichiers textes du jouebs. Pour chaque fichier, les champs
suivants sont listes :
- Le nom du fichier, associe a un lien vers le texte sur le joueb.
L'adresse du texte est l'adresse du joueb suivie de /texts/ et du nom de fichier, avec
l'extension .shtml.
- La taille du fichier texte.
- Une case "Effacer" qui permet d'effacer le texte si elle est selectionnee.
- Une lien "Editer" qui permet d'editer le texte.
Pour envoyer un nouveau fichier texte (ou une nouvelle version),
sauvez le avec l'extension .html. Dans le champ
"Envoyer une page de texte (.html)", entrez le chemin complet du fichier, ou cliquez sur
"Parcourir" et selectionnez le fichier. Cliquez ensuite sur "Valider".
Les Images
Le sous-menu Images permet d'envoyer des images sur votre joueb. Celle-ci peuvent etre
utilisees dans le modèle de mise en page ou eventuellement dans un texte, une information ou un commentaire.
Pour des raisons de place, merci de limiter le nombre et la taille des images que vous
utilisez. Si possible, placez ou laissez les images sur un autre site et faites un lien
direct vers l'autre site.
Des images utilisees frequemment dans les modèles de mise en page (coins arrondis, logos de rubriques
frequentes etc.) seront prochainement installees directement sur Niutopia afin d'utiliser
moins de place et d'afficher les jouebs plus rapidement.
Le sous-menu Images est similaire au sous-menu Textes. Il liste les images du jouebs.
Une case "Effacer" permet d'effacer une image.
Pour envoyer une nouvelle image (ou une nouvelle version),
sauvez la avec l'extension .gif, .jpg ou .png. Dans le champ
"Envoyer une image (.gif/.jpg/.png)", entrez le chemin complet du fichier, ou cliquez sur
"Parcourir" et selectionnez le fichier. Cliquez ensuite sur "Valider".
Les Listes et Blocs Libres
Vous pouvez utiliser 2 listes pour repertorier des lignes de texte ou des liens Internet.
Ces listes peuvent etre directement affichees en selectionnant les blocs configurables
correspondants dans un modèle de mise en page qui utilise des blocs configurables (voir sous-menu Mise en page).
Certains modèles de mise en page utilisent egalement ces listes pour en afficher un element au hasard.
Vous pouvez egalement utiliser 2 blocs configurables libres pour ajouter facilement
de l'HTML a votre joueb, sans editer le modèle de mise en page.
Vous pouvez par exemple y copier/coller le code HTML fourni par d'autres sites
pour avoir des statistiques, la meteo du jour ou d'autres fonctions similaires.
Ces blocs ne peuvent etre utilises qu'en les selectionnant ensuite dans un modèle de mise en page
qui utilise des blocs configurables (voir sous-menu Mise en page).
Enfin, les deux boites de texte a la fin du formulaire permettent d'afficher un texte
lors de la proposition d'un article ou l'ajout d'un commentaire.
La liste de textes libres : chaque ligne peut etre du texte, de l'HTML, un numero, un nom de fichier, du Javascript ou
autres. Mais elle ne doit pas comporter de retours a la ligne (sinon ce n'est plus une
ligne, mais plusieurs lignes). En HTML, utilisez le champ <BR> pour obtenir un passage
a la ligne.
Les applications possibles incluent l'affichage aleatoire de slogans, citations,
fortune cookies, bannieres etc., le changement de logo ou de couleur de fond etc.
La liste de liens : chaque ligne doit etre au format "http://adresse.com Description du lien".
Exemple :
http://joueb.com/niutopia/ Niutopia
http://zh9lkvff9ck.com Zh9lkvff9ck (webcomic)
Le sous-menu Liste permet d'ajouter, modifier ou enlever des lignes des listes et de
changer le code HTML des blocs configurables libres.
Le bouton "Valider" permet de valider les changements.
Les modèles de mise en page
Les modèles de mise en page permettent de configurer l'apparence des pages de votre joueb. Les modèles de mise en page sont
des fichiers au format HTML qui comportent des balises speciales specifiques a Niutopia.
Pour une description complete de ce format, lisez les chapitres sur
LES MODELES DE MISE EN PAGE et
LES OBJETS
Le sous-menu Mise en page est similaire est similaire aux sous-menus Textes et Images. Il liste
les modèles de mise en page du joueb. Pour chaque fichier, les champs suivants sont listes :
- Le nom du fichier.
- La taille du modèle de mise en page.
- Une case "Effacer" qui permet d'effacer le modèle de mise en page si elle est selectionnee.
- Un lien "Editer" qui permet d'editer le modèle de mise en page.
Pour envoyer un nouveau modèle de mise en page (ou une nouvelle version),
sauvez le avec l'extension .html. Dans le champ
"Envoyer un modèle de mise en page (.html)", entrez le chemin complet du fichier, ou cliquez sur
"Parcourir" et selectionnez le fichier. Cliquez ensuite sur "Valider".
ATTENTION : sauvegardez toujours une copie du modèle de mise en page avant de le modifier. Si vous faites
une erreur dans le modèle de mise en page, l'acces a votre joueb deviendra impossible jusqu'a ce que vous
reinstalliez un modèle de mise en page valide.
Les Statistiques
Ce sous-menu contient les statistiques d'acces a votre joueb. La provenance des visiteurs
est indiquee si elle est connue.
LES MODELES DE MISE EN PAGE
Les modèles de mise en page permettent de configurer l'apparence des pages de votre joueb. Les modèles de mise en page sont
des fichiers au format HTML qui comportent des balises speciales specifiques a Niutopia.
La connaissance, meme basique, de l'HTML est utile pour creer ou modifier les modèles de mise en page.
Chaque page d'un joueb a l'apparence definie dans le modèle de mise en page du joueb. Par exemple, si
votre modèle de mise en page comporte la balise HTML <body bgcolor=red>, le fond de toutes les pages
du joueb sera rouge. Lorsque vous deciderez que le rouge n'est pas un si bon choix que
ca pour une couleur de fond, il vous suffira de changer "red" en "white" pour que le fond
de toutes les pages de votre joueb devienne blanc. Il suffit donc de changer un seul
fichier pour definir l'apparence de votre joueb. Les administrateurs de jouebs qui
ont deja cree des sites web auparavant apprecieront !
Les objets
Au premier abord, un modèle de mise en page ressemble a s'y meprendre a une page HTML normale.
Lorsqu'on y regarde de plus pres, on remarque que l modèle comporte des balises
qui ne font pas partie des balises HTML. Ce sont les balises utilisees par Niutopia.
Parmi elles se trouve les balises <object ...> et </object>.
A l'interieur de ces balises <object ...> et </object> se trouve tout le
code HTML qui est dynamique, c'est-a-dire qui change d'une page du joueb a l'autre.
A l'exterieur de ces balises <object ...> et </object> se trouve tout le
code HTML qui est statique, c'est-a-dire qui ne change pas d'une page du joueb a l'autre.
Par exemple, le code HTML qui indique la couleur de fond du joueb est statique :
il ne change pas d'une page a l'autre (generalement). Au contraire, le texte d'une
information est dynamique : le texte des informations est different d'une information
a l'autre de votre joueb (ou votre joueb n'a pas beaucoup d'interet).
Lors de l'affichage de chaque page, Niutopia genere des objets qui correspondent aux
parties dynamiques de la page. Par exemple, une page de sommaire comporte un objet
"summary" ; une
page d'information comporte un objet "news". Le code HTML qui se trouve a l'interieur
de balises <object ...> et </object> n'est affiche que pour les pages qui
comportent l'objet en question. Autrement, il est ignore.
Syntaxe :
<object class=[nom de la classe]>
[code html]
</object>
Description :
Si la page affichee comporte un objet de la classe [nom de la classe], [code html] remplace
le bloc <object ...> ... </object>. Autrement, le bloc <object ...> ... </object> est ignore.
La liste complete des objets est dans le chapitre sur
LES OBJETS.
Les attributs
A chaque objet peuvent correspondre des attributs. Les attributs contiennent les
donnees dynamiques des objets. Par exemple, l'attribut "title" d'un objet "news" contient
le titre d'une information.
Syntaxe :
<object class=[nom de la classe]>
...
<attribute [nom de l'attribut]>
...
</object>
Description :
Si l'objet qui est en train d'etre affiche contient l'attribut [nom de l'attribut],
la valeur de l'attribut remplace la balise <attribute ...>.
Autrement, la balise <attribute ...> est ignoree.
La liste complete des objets et de leurs attributs est dans le chapitre
sur
LES OBJETS.
Les objets multiples
Plusieurs objets d'une meme classe peuvent apparaitre sur une meme page.
Par exemple, toutes les listes (de rubriques, de resumes etc.) sont representees
par plusieurs objets d'une meme classe.
Syntaxe :
<object class=[nom de la classe] count=[nombre]>
[code html]
</object>
Description :
Si la page affichee comporte des objets de la classe [nom de la classe],
[code html] remplace le bloc <object ...> ... </object> autant de fois
qu'il existe d'objets de la classe [nom_de_la_classe], et au maximum [nombre] fois.
Si [code html] contient des attributs, les valeurs de ces attributs
peuvent etre differentes pour chaque objet. Si [nombre] est le caractere "*",
il n'y a pas de limite sur le nombre d'objets affichables.
S'il existe plus d'objets de la classe [nom de la classe] que [nombre], un objet
de la classe [nom de la classe]_continued est cree.
Si la page affichee ne comporte pas d'objets de la classe [nom de la classe],
le bloc <object ...> ... </object> est ignore.
Les objets encastres
Certains objets contiennent d'autres objets. Par exemple, pour une liste,
la liste est tres souvent un objet d'une classe, et chaque element de la liste
un objet d'une autre classe. Les pages de sommaire comportent ainsi un objet
"summaries" et des objets "summary".
Syntaxe :
<object class=[nom de la classe 1]>
[code_html_1_a]
<object class=[nom de la classe 2] count=[nombre]>
[code_html_2]
</object>
[code_html_1_b]
</object>
Description :
Si l'objet de classe [nom de la classe 1] existe, [code_html_1_a] est affiche,
puis pour chaque objet de la classe [nom de la classe 2], [code_html_2] est affiche,
puis [code_html_1_b] est genere.
Les sous-attributs des dates
Les attributs dates comportent des sous-attributs qui correspondent aux elements qui composent une date : jour, mois, annee etc.
Note : les attributs dates sont ceux dont le nom finit par "_t".
Syntaxe :
<attribute [nom de l'attribut].ss> : secondes
<attribute [nom de l'attribut].mi> : minutes
<attribute [nom de l'attribut].hh> : heures
<attribute [nom de l'attribut].dd> : jour du mois
<attribute [nom de l'attribut].mm> : mois en chiffre
<attribute [nom de l'attribut].yy> : annee sur 2 chiffres
<attribute [nom de l'attribut].yyyy> : annee sur 4 chiffres
<attribute [nom de l'attribut].day> : jour de la semaine en lettres
<attribute [nom de l'attribut].month> : mois en lettres
Les sous-attributs des textes
Les attributs textuels comportent des sous-attributs qui permettent d'acceder a des versions
en minuscules, majuscules etc.
Syntaxe :
<attribute [nom de l'attribut].lc> : minuscules
<attribute [nom de l'attribut].uc> : majuscules
<attribute [nom de l'attribut].ucfirst> : 1ere lettre en majuscule et suivantes en minuscules
<attribute [nom de l'attribut].rss> : version "RSS" sans balises, avec certains caracteres echappes.
Les modificateurs de l'attribut "html"
L'attribut "html" contient le code HTML des formulaires.
Ces formulaires comportent des tables avec un champ par ligne : le nom du champ a gauche
et sa valeur a droite.
L'attribut "html" peut etre modifie pour changer la fonte utilisee pour les noms de champs.
Syntaxe :
<attribute html [parametre]=[valeur] ...>
Description :
Une balise <font ...> suivie des parametres specifies est ajoutee pour chaque nom
de champ dans la premiere colonne d'un formulaire.
Les modificateurs des attributs numeriques
Les modificateurs des attributs numeriques permettent de modifier la valeur d'un attribut par des
operations arithmetiques simples.
Syntaxe :
<attribute [attribut ou nombre]%[attribut ou nombre]> : reste de la division (modulo)
<attribute [attribut ou nombre]*[attribut ou nombre]> : multiplication
<attribute [attribut ou nombre]/[attribut ou nombre]> : division entiere
<attribute [attribut ou nombre]+[attribut ou nombre]> : addition
<attribute [attribut ou nombre]-[attribut ou nombre]> : soustraction
Il est possible de combiner ces operations (e.g. 2+3*4-4%2). Dans ce cas,
les operations sont d'abord effectuees dans cet ordre : %, *, /, + et -.
Il est egalement possible d'utiliser les sous-attributs.
Les conditions sur les objets
Des conditions sur ses attributs peuvent etre associees a un objet. Si les
conditions ne sont pas verifies, l'objet n'est pas affiche.
Syntaxe :
<object class=[nom de la classe] [nom de l'attribut]=[valeur] ...>
<object class=[nom de la classe] [nom de l'attribut]<[valeur] ...>
<object class=[nom de la classe] [nom de l'attribut]>[valeur] ...>
<object class=[nom de la classe] [nom de l'attribut]![valeur] ...>
Description :
Respectivement, l'objet n'est affiche que si l'attribut [nom_de_l_attribut] est
egal, inferieur, superieur ou different de [valeur].
Les conditions peuvent etres combinees entre elles.
Il est egalement possible d'utiliser les sous-attributs et/ou modificateurs des attributs.
Les conditions sur les attributs
Des conditions sur ses attributs peuvent etre utilisees a l'interieur d'un objet. Si les
conditions ne sont pas verifies, le texte correspondant n'est pas affiche.
Syntaxe :
<if_attribute [nom de l'attribut]=[valeur] ...>...</if_attribute>
Notes :
Les memes conditions que celles sur les objets sont possibles.
Les conditions peuvent etres combinees entre elles.
Il est egalement possible d'utiliser les sous-attributs et/ou modificateurs des attributs.
Un bloc if_attribute peut contenir d'autres blocs if_attribute ou d'autres blocs attributes, mais pas de blocs objects.
LES OBJETS
Ce chapitre contient la liste de tous les objets et la description de leurs attributs.
Objets globaux
Les objets globaux sont les objets qui sont disponibles sur tous les types de pages :
les sommaires, les informations et commentaires, les formulaires etc.
Les objets globaux sont listes ci-dessous :
- Objet archive
L'objet archive permet d'afficher la liste de tous les articles publies sur le joueb.
Il contient des objets active_entry.
Attributs :
Aucun.
- Objet archive_entry
Un objet archive_entry existe pour chaque article publie.
Attributs :
- author : auteur
- author_url : lien vers l'auteur
- category : titre de la rubrique
- category_id : identifiant de la rubrique
- news_url : lien vers l'information
- published_t : date de publication
- sub_category : sous-rubrique
- title : titre
- Objet active_summaries
L'objet active_summaries permet d'afficher le sommaire des informations qui ont
eu le plus de commentaires recemment.
Il contient des objets active_summary (au maximum 16).
Attributs :
Aucun.
- Objet active_summary
Un objet active_summary existe pour chaque information qui a eu beaucoup
de commentaires recemment.
Attributs :
- additional_text_1 : champ a usage libre
- additional_text_2 : champ a usage libre
- author : auteur
- author_url : lien vers l'auteur
- category : titre de la rubrique
- category_id : identifiant de la rubrique
- created_t : date de creation
- moderator : moderateur
- moderator_url : lien vers le moderateur
- news_url : lien vers l'information
- published_t : date de publication
- status : status (news pour les informations publiees, submission pour les informations
proposees)
- sub_category : sous-rubrique
- sub_title : sous-titre
- text : texte du premier paragraphe
- title : titre
- Objet active_summary_new_comments
L'objet active_summary_new_comments est une sous-classe de l'objet active_summary. Il existe
pour chaque objet active_summary dont l'information possede des commentaires non-lus par
l'utilisateur.
Note : cet objet n'est genere que si l'utilisateur a ouvert une session.
Attributs : aucun.
- Objet categories
L'objet categories correspond a la liste des rubriques d'un joueb.
Il contient des objets category.
Attributs :
- id : identifiant du joueb.
- Objet category
Un objet category existe pour chaque rubrique du joueb.
Note : les objets category ne sont pas generes si l'objet categories n'est
pas present dans le modèle de mise en page.
Attributs :
- id : identifiant de la rubrique
- title : titre de la rubrique
- description : description de la rubrique
- url : adresse web du sommaire de la rubrique
- selected : indique si la rubrique est selectionnee (true ou false)
- Objet category_selected
L'objet category_selected est une sous-classe de l'objet category. Il existe s'il s'agit de la rubrique selectionnee.
Note : les objets category_selected ne sont pas generes si l'objet categories n'est
pas present dans le modèle de mise en page.
Attributs :
- id : identifiant de la rubrique
- title : titre de la rubrique
- description : description de la rubrique
- url : adresse web du sommaire de la rubrique
- Objet category_not_selected
L'objet category_not_selected est une sous-classe de l'objet category. Il existe s'il ne s'agit pas de la rubrique selectionnee.
Note : les objets category_not_selected ne sont pas generes si l'objet categories n'est
pas present dans le modèle de mise en page.
Attributs :
- id : identifiant de la rubrique
- title : titre de la rubrique
- description : description de la rubrique
- url : adresse web du sommaire de la rubrique
- Objet cmd_add_oneliner
L'objet cmd_add_oneliner permet d'afficher un formulaire pour ajouter un oneliner.
Note : cet objet n'est genere que si l'utilisateur possede les permissions correspondantes
et si l'objet oneliners est present dans le modèle de mise en page.
Attributs :
- cmd : titre de la commande
- form : formulaire (sous forme de table)
- Objet cmd_administrator_menu
L'objet cmd_administrator_menu permet d'afficher un lien vers le menu administrateur.
Note : cet objet n'est genere que si l'utilisateur possede les permissions correspondantes.
Attributs :
- cmd : titre de la commande
- url : lien
- Objet cmd_register
L'objet cmd_register permet d'afficher un lien pour l'inscription de l'utilisateur
sur le joueb.
Note : cet objet n'est genere que si l'utilisateur n'est pas deja inscrit sur le joueb.
Attributs :
- cmd : titre de la commande
- url : lien
- Objet cmd_submit_news
L'objet cmd_submit_news permet d'afficher un lien vers le formulaire de
proposition d'article.
Note : cet objet n'est genere que si l'utilisateur possede les permissions correspondantes.
Attributs :
- cmd : titre de la commande
- url : lien
- Objet cmd_view_submissions
L'objet cmd_view_submissions permet d'afficher un lien vers le sommaire des
informations proposees.
Note : cet objet n'est genere que si l'utilisateur possede les permissions correspondantes.
Attributs :
- cmd : titre de la commande
- url : lien
- Objet form_login
L'objet form_login permet d'afficher un formulaire d'ouverture de session.
Note : cet objet n'est genere que si l'utilisateur n'a pas deja ouvert une session.
Attributs :
- html : formulaire d'ouverture de session
- forgotten_password_url : lien vers le formulaire de renvoi de mot de passe
- Objet form_logout
L'objet form_logout permet d'afficher un bouton de fermeture de session.
Note : cet objet n'est genere que si l'utilisateur a ouvert une session.
Attributs :
- html : bouton de fermeture de session
- Objet form_search
L'objet form_search permet d'afficher un formulaire de recherche d'information.
Attributs :
- html : formulaire
- Objet niutopia_summaries
L'objet niutopia_summaries permet d'afficher les titres et sommaires des
informations publiees recemment sur d'autres jouebs qui tournent sur Niutopia.
Il contient des objets niutopia_summary.
Note : les sommaires Niutopia sont remis a jour toutes les 5 minutes.
Chargez deux fois la page de sommaire de votre site pour initialiser les
sommaires Niutopia.
Attributs :
- sites : liste des identifiants des jouebs Niutopia, separes par des virgules,
sans espaces. (exemples: sites=niutopia ; sites=tonicine,zh9lkvff9ck,rozenn,sf)
Si l'attribut "site" n'est pas present, les titres de tous les jouebs de Niutopia seront
selectionnes.
- Objet niutopia_summary
Un objet niutopia_summary existe pour chaque information des sommaires Niutopia.
Note : les objets niutopia_summary ne sont pas generes si
l'objet niutopia_summaries n'est pas present dans le modèle de mise en page.
Attributs :
- site : identifiant du joueb dont provient l'information
- url : lien vers l'information
- title : titre
- author : auteur
- author_url : lien vers l'auteur
- created_t : date de creation
- published_t : date de publication
- nb_comments : nombre de commentaires
- last_comment_t : date du dernier commentaire
- text : texte du premier paragraphe
- Objet niutopia_summary_new_comments
L'objet niutopia_summary_new_comments est une sous-classe de l'objet niutopia_summary. Il existe
pour chaque objet niutopia_summary dont l'information possede des commentaires non-lus par
l'utilisateur.
Note : cet objet n'est genere que si l'utilisateur a ouvert une session.
Attributs : aucun.
- Objet oneliners
L'objet oneliners permet d'afficher des messages courts (oneliners) ecrits par
les utilisateur d'un joueb.
Il contient des objets oneliner.
Attributs : aucun.
- Objet oneliner
Un objet oneliner existe pour chaque message court ecrit par un utilisateur.
Note : les objets oneliner ne sont pas generes si
l'objet oneliners n'est pas present dans le modèle de mise en page.
Attributs :
- author : auteur
- author_url : lien vers l'auteur
- created_t : date de creation
- text : texte
- Objet random_line
L'objet random_line permet d'afficher des citations, fortune cookies, liens, images,
bannieres etc. aleatoires. Il permet de choisir au hasard une ligne dans la liste de textes libres definie
dans le sous-menu Listes/Blocs.
Attributs :
- line : texte de la ligne (toujours la meme si l'attribut et/ou l'objet sont utilises plusieurs fois dans le modèle de mise en page)
- different_line : texte de la ligne (differente si l'attribut et/ou l'objet sont utilises plusieurs fois dans le modèle de mise en page)
- Objet random_url
L'objet random_url permet d'afficher des liens, images aleatoires.
Il permet de choisir au hasard une ligne dans la liste de liens definie dans
le sous-menu Listes/Blocs.
Attributs :
- text : texte (toujours le meme si l'attribut et/ou l'objet sont utilises plusieurs fois dans le modèle de mise en page)
- url : url (toujours le meme si l'attribut et/ou l'objet sont utilises plusieurs fois dans le modèle de mise en page)
- Objet rss_summaries
L'objet rss_summaries permet d'afficher les titres et sommaires des
informations publiees recemment sur d'autres jouebs ou sites qui fournissent un fichier RSS.
Il contient des objets rss_summary.
Note : les sommaires RSS sont remis a jour toutes les 5 minutes.
Chargez deux fois la page de sommaire de votre site pour initialiser les
sommaires RSS.
Attributs :
- sites : liste des adresses des fichiers RSS, separes par des virgules,
sans espaces. (exemples: sites=http://nospoon.org/backend_rdf.xml ; sites=http://nospoon.org/backend_rdf.xml,http://afroginthevalley.weblog.com/xml/rss.xml)
- Objet rss_summary
Un objet rss_summary existe pour chaque information des sommaires RSS.
Note : les objets rss_summary ne sont pas generes si
l'objet rss_summaries n'est pas present dans le modèle de mise en page.
Attributs :
- site : identifiant du site dont provient l'information
- site_url : lien vers le site
- url : lien vers l'information
- title : titre
- text : description
- Objet talk_about_it
L'objet talk_about_it permet d'afficher un lien a faire glisser sur la barre de
liens d'Internet Explorer. Une fois le lien en place, pour qu'un utilisateur (ou
l'administrateur) propose une information au sujet de n'importe quelle page web, il lui
suffit de selectionner la partie du texte qui l'interesse et de cliquer sur le lien.
Une fenetre de proposition d'information s'ouvrira automatiquement, avec un texte
pre-rempli (completable et modifiable) comportant le titre et un lien vers la page web
et la citation selectionnee.
Note : cette fonction necessite une version recente d'Internet Explorer et l'objet
n'est genere que pour les utilisateurs d'Internet Explorer.
Attributs :
- link : le lien a faire glisser dans la barre de liens
- text : un texte descriptif a placer avant le lien
- Objet user
L'objet user permet d'afficher des informations sur l'utilisateur
qui visualise le site.
Attributs :
- user : utilisateur
- user_url : lien vers l'utilisateur
- group_id : identifiant du groupe de l'utilisateur
- group_title : titre du groupe de l'utilisateur
- group_description : description du groupe de l'utilisateur
Objets des sommaires
Les objets des sommaires ne sont pas generes sur les autres pages, meme s'ils
sont presents dans le modèle de mise en page.
Les objets des sommaires sont listes ci-dessous :
- Objet random_summary
L'objet random_summary contient le sommaire d'un article pris au hasard dans une rubrique,
dans la seconde moitie de l'index (entre le 9eme et le 16eme sommaire). Il permet de mettre en valeur
aleatoirement un article moins recent.
Attributs :
- additional_text_1 : champ a usage libre
- additional_text_2 : champ a usage libre
- author : auteur
- author_url : lien vers l'auteur
- category : titre de la rubrique
- category_id : identifiant de la rubrique
- created_t : date de creation
- moderator : moderateur
- moderator_url : lien vers le moderateur
- news_url : lien vers l'information
- published_t : date de publication
- status : status (news pour les informations publiees, submission pour les informations
proposees)
- sub_category : sous-rubrique
- sub_title : sous-titre
- text : texte du premier paragraphe
- title : titre
- Objet summaries
L'objet summaries permet d'afficher le sommaire des informations d'une
rubrique.
Il contient des objets summary (au maximum 16).
Attributs :
- category_id : identifiant de la rubrique
- category_title : titre de la rubrique
- category_description : description de la rubrique
- Objet summary
Un objet summary existe pour chaque information d'une rubrique.
Attributs :
- additional_text_1 : champ a usage libre
- additional_text_2 : champ a usage libre
- author : auteur
- author_url : lien vers l'auteur
- category : titre de la rubrique
- category_id : identifiant de la rubrique
- created_t : date de creation
- moderator : moderateur
- moderator_url : lien vers le moderateur
- news_url : lien vers l'information
- published_t : date de publication
- status : status (news pour les informations publiees, submission pour les informations
proposees)
- sub_category : sous-rubrique
- sub_title : sous-titre
- text : texte du premier paragraphe
- title : titre
- Objet summary_poll
L'objet summary_poll est une sous-classe de l'objet summary. Il existe
pour chaque objet summary dont l'information possede un sondage associe.
Attributs :
- duration : duree du sondage (en jours)
- end_t : fin du sondage
- form : formulaire qui permet de voter
- start_t : debut du sondage
- title : titre
- Objet summary_no_text_follows
L'objet summary_no_text_follows est une sous-classe de l'objet summary. Il existe
pour chaque objet summary lorsque le resume est le texte complet de l'article.
Attributs : aucun
- Objet summary_text_follows
L'objet summary_text_follows est une sous-classe de l'objet summary. Il existe
pour chaque objet summary lorsque le resume n'est pas le texte complet de l'article.
Attributs : aucun
- Objet summary_new_comments
L'objet summary_new_comments est une sous-classe de l'objet summary. Il existe
pour chaque objet summary dont l'information possede des commentaires non-lus par
l'utilisateur.
Note : cet objet n'est genere que si l'utilisateur a ouvert une session.
Attributs : aucun.
- Objet summary_new_day
L'objet summary_new_day est une sous-classe de l'objet summary. Il existe
pour chaque objet summary qui est le premier pour un jour donne du sommaire d'une
rubrique.
Attributs :
- day_t : jour
Objets des informations
Les objets des informations ne sont pas generes sur les autres pages, meme s'ils
sont presents dans le modèle de mise en page.
Les objets des informations sont listes ci-dessous :
- Objet comments
L'objet comments permet d'afficher les commentaires d'une information.
Il contient des objets comment.
Attributs : aucun.
- Objet comment
Un objet comment existe pour chaque commentaire d'une information.
Attributs :
- author : auteur
- author_url : lien vers l'auteur
- cmd : lien vers le formulaire d'edition (affiche seulement si
l'utilisateur possede les permissions correspondantes)
- created_t : date de creation
- display_face : indique si le tetoucom de l'auteur doit etre affiche (true ou false)
- position : degre de distance par rapport a l'information (0 pour un commentaire de
l'information, 1 pour un commentaire d'un commentaire etc.). Utile pour afficher les
commentaires en fil.
- reply_to_url : lien vers le formulaire d'ajout de commentaire
- text : texte
- title : titre
- Objet comment_new
L'objet comment_new est une sous-classe de l'objet comment. Il existe
pour chaque objet comment dont le commentaire n'a pas ete lu par
l'utilisateur.
Note : cet objet n'est genere que si l'utilisateur a ouvert une session.
Attributs : aucun.
- Objet comment_reply_to
L'objet comment_reply_to est une sous-classe de l'objet comment. Il existe
pour chaque objet comment si les commentaires de l'information n'ont pas ete
verrouilles. Il remplace l'attribut reply_to_url de l'objet comment.
Attributs :
- reply_to_url : lien vers le formulaire d'ajout de commentaire
- Objet news
L'objet news permet d'afficher une information.
Attributs :
- additional_text_1 : champ a usage libre
- additional_text_2 : champ a usage libre
- author : auteur
- author_url : lien vers l'auteur
- category : titre de la rubrique
- category_id : identifiant de la rubrique
- cmd : lien vers le formulaire d'edition (affiche seulement si
- created_t : date de creation
- moderator : moderateur
- moderator_url : lien vers le moderateur
- news_url : lien vers l'information
- poll : 'on' si un sondage est associe a l'information
- published_t : date de publication
- reply_to_url : lien vers le formulaire d'ajout de commentaire
- status : status (news pour les informations publiees, submission pour les informations
proposees)
- sub_category : sous-rubrique
- sub_title : sous-titre
- text : texte
- title : titre
- Objet news_poll_results
L'objet news_poll_results est une sous-classe de l'objet news. Il existe
pour chaque objet summary dont l'information possede un sondage associe.
Il contient des objets comment.
Attributs :
- duration : duree du sondage (en jours)
- end_t : fin du sondage
- start_t : debut du sondage
- title : titre
- total : nombre de votants
- Objet news_poll_result
L'objet news_poll_result existe pour chaque choix d'un sondage.
Attributs :
- choice : choix
- percent : pourcentage des votes
- votes : nombre de votes
- width : pourcentage ramene a 100 pour le choix le plus populaire (utile pour afficher
une barre d'histogramme)
- Objet news_first
L'objet news_first permet d'afficher un lien vers la premiere information publiee.
Note : cet objet n'est genere que si l'information vue n'est pas la premiere information
publiee.
Attributs :
- url : lien
- Objet news_last
L'objet news_last permet d'afficher un lien vers la derniere information publiee.
Note : cet objet n'est genere que si l'information vue n'est pas la derniere information
publiee.
Attributs :
- url : lien
- Objet news_next
L'objet news_next permet d'afficher un lien vers information publiee suivante.
Note : cet objet n'est genere que si l'information vue n'est pas la derniere information
publiee.
Attributs :
- url : lien
- Objet news_previous
L'objet news_first permet d'afficher un lien vers l'information publiee precedente.
Note : cet objet n'est genere que si l'information vue n'est pas la premiere information
publiee.
Attributs :
- url : lien
Objets des formulaires
Les objets des formulaires ne sont pas generes sur les autres pages, meme s'ils
sont presents dans le modèle de mise en page.
Les objets des formulaires sont listes ci-dessous :
- Objet form
L'objet form permet d'afficher un formulaire.
Attributs :
- html : formulaire
- textarea_toolbar : barre d'edition pour ajouter automatiquement les balises HTML
correspondantes aux couleurs etc. Disponible uniquement si l'utilisateur utilise
Internet Explorer.
- title : titre
Objets des messages
Les objets des messages ne sont pas generes sur les autres pages, meme s'ils
sont presents dans le modèle de mise en page.
Les objets des messages sont listes ci-dessous :
- Objet message
L'objet message permet d'afficher un message a l'utilisateur.
Attributs :
- html : message
- text : texte
Objets des message d'erreur
Les objets des message d'erreur ne sont pas generes sur les autres pages, meme s'ils
sont presents dans le modèle de mise en page.
Les objets des message d'erreur sont listes ci-dessous :
- Objet error_message
L'objet error_message permet d'afficher un message d'erreur.
Attributs :
- text : texte
Objets des textes
Les objets des textes ne sont pas generes sur les autres pages, meme s'ils
sont presents dans le modèle de mise en page (voir
sous-menu Textes).
Les objets des textes sont listes ci-dessous :
