yacs pour les nuls

YACS pour les nuls

Introduction ................................................................................................................................ 5 Installer et configurer YACS...................................................................................................... 6

Installation locale sur Windows ............................................................................................. 6 Installation d'EasyPHP ....................................................................................................... 6

Ajout d'extensions PHP.................................................................................................. 6 Configuration de PHP .................................................................................................... 7

Création de la base de donnée ............................................................................................ 7 Installation de YACS ......................................................................................................... 8 Configuration initiale de YACS......................................................................................... 9

Créer des pages......................................................................................................................... 14 Créer une section.................................................................................................................. 14 Créer un article ..................................................................................................................... 17 Modifier les options avancées d'un article ........................................................................... 19

Onglet Information ........................................................................................................... 19 Etiquettes...................................................................................................................... 20 Images .......................................................................................................................... 20

Ajouter une image à la page..................................................................................... 20 Options avancées des images ............................................................................... 22 La galerie d'image ................................................................................................ 23

Vignette de l'article................................................................................................... 24 Icône de l'article ....................................................................................................... 24

Emplacements .............................................................................................................. 25 Ajouter un nouvel emplacement .............................................................................. 25 Visualisation des emplacements............................................................................... 26 Déterminer les coordonnées géographiques d'un lieu .............................................. 27

Tables ........................................................................................................................... 29 Contenu additionnel ..................................................................................................... 29

Rendu ....................................................................................................................... 29 anonymous_edit ................................................................................................... 29 members_edit ....................................................................................................... 30 no_files ................................................................................................................. 30 files_by_title......................................................................................................... 30 no_links ................................................................................................................ 30 links_by_title ........................................................................................................ 30 no_comments ....................................................................................................... 30 view_as_chat ........................................................................................................ 30 view_as_tabs ........................................................................................................ 32 view_as_foo_bar .................................................................................................. 33 skin_foo_bar......................................................................................................... 33 variant_foo_bar .................................................................................................... 34

Bas de page............................................................................................................... 35 Extra ......................................................................................................................... 35

Onglet Contenu ................................................................................................................ 36 Section.......................................................................................................................... 36 Source........................................................................................................................... 37 Surnom ou diminutif .................................................................................................... 37

Pièces jointes ................................................................................................................ 38 Contribution à la page d'accueil ................................................................................... 38

Onglet Options ................................................................................................................. 39 Editeurs......................................................................................................................... 39 Visibilité ....................................................................................................................... 39 Verrouillé ..................................................................................................................... 40 Rang ............................................................................................................................. 40 Date de publication....................................................................................................... 40 Date d'expiration .......................................................................................................... 40 Plus d'option ................................................................................................................. 40

Langage .................................................................................................................... 40 Meta-information ..................................................................................................... 41 Adresse web de la vignette....................................................................................... 41 Adresse web de l'icône ............................................................................................. 42 Changer d'overlay..................................................................................................... 43

Options d'enregistrement d'un article ............................................................................... 43 Modifier les options avancées d'une section ........................................................................ 43

Onglet Information ........................................................................................................... 43 Images .......................................................................................................................... 44 Contenu additionnel ..................................................................................................... 44

Sections .................................................................................................................... 44 Decorated ............................................................................................................. 45 Map....................................................................................................................... 45 Freemind............................................................................................................... 46 Jive ....................................................................................................................... 46 Yabb ..................................................................................................................... 47 Inline..................................................................................................................... 47 Folded................................................................................................................... 48 Compact ............................................................................................................... 48 Titles..................................................................................................................... 48

Pages......................................................................................................................... 49 Decorated ............................................................................................................. 49 Digg...................................................................................................................... 50 Slashdot ................................................................................................................ 50 Map....................................................................................................................... 50 Table..................................................................................................................... 51 Daily ..................................................................................................................... 51 Boxesandarrows ................................................................................................... 52 Jive ....................................................................................................................... 52 Yabb ..................................................................................................................... 52 Alistapart .............................................................................................................. 53 Wiki ...................................................................................................................... 53 Manual.................................................................................................................. 53 Compact ............................................................................................................... 53

Rendu ....................................................................................................................... 53 articles_by_publication ........................................................................................ 53 articles_by_rating ................................................................................................. 53 articles_by_title .................................................................................................... 54 articles_by_reverse_title....................................................................................... 54 articles_by_reverse_rank...................................................................................... 54

no_new_articles.................................................................................................... 54 with_files.............................................................................................................. 54 files_by_title......................................................................................................... 54 with_links ............................................................................................................. 54 links_by_title ........................................................................................................ 54 with_creator_profile ............................................................................................. 55 with_comments .................................................................................................... 55 with_slideshow..................................................................................................... 56 view_as_tabs ........................................................................................................ 57 view_as_foo_bar .................................................................................................. 57 skin_foo_bar......................................................................................................... 57 variant_foo_bar .................................................................................................... 58 no_contextual_menu ............................................................................................ 58

Bas de page............................................................................................................... 59 Extra ......................................................................................................................... 59 Nouvelles.................................................................................................................. 60

Onglet Contenu ................................................................................................................ 62 Section parente ............................................................................................................. 62 Surnom ......................................................................................................................... 62 Comportements ............................................................................................................ 63

agree_on_file_access................................................................................................ 63 move_on_article_access........................................................................................... 64

Sous-sections................................................................................................................ 64 Pages............................................................................................................................. 65

Options ..................................................................................................................... 65 anonymous_edit ................................................................................................... 65 members_edit ....................................................................................................... 65 Auto_publish ........................................................................................................ 65 view_as_chat ........................................................................................................ 65 view_as_tabs ........................................................................................................ 65 view_as_foo_bar .................................................................................................. 66 Without_rating ..................................................................................................... 66 Rate_as_digg ........................................................................................................ 66 With_export_tools................................................................................................ 66 with_prefix_profile............................................................................................... 67 with_suffix_profile............................................................................................... 67 with_extra_profile ................................................................................................ 67 no_comments ....................................................................................................... 67 no_links ................................................................................................................ 68 no_files ................................................................................................................. 68 no_neighbours ...................................................................................................... 68 with_deletions ...................................................................................................... 68

Overlay ..................................................................................................................... 68 Pages modèles .......................................................................................................... 68 Préfixe ...................................................................................................................... 68 Suffixe ...................................................................................................................... 68

Contribution à la mise en page de "La section supérieure".......................................... 69 Contribution à la page d'accueil ................................................................................... 71

Onglet Options ................................................................................................................. 73 Editeurs......................................................................................................................... 73

Lecteurs ........................................................................................................................ 74 Visibilité ....................................................................................................................... 75 Verrouillé ..................................................................................................................... 76 Date d'activation........................................................................................................... 76 Date d'expiration .......................................................................................................... 76 Plus d'options ............................................................................................................... 76

Famille...................................................................................................................... 76 Titre compact............................................................................................................ 77 Langage .................................................................................................................... 77 Meta-information ..................................................................................................... 78 Adresse web de la vignette....................................................................................... 78 Adresse web de l'icône ............................................................................................. 79 Adresse web de la puce ............................................................................................ 79 Changer d'overlay..................................................................................................... 80

Modifier la page d'accueil ........................................................................................................ 81 Onglet Panneau principal ..................................................................................................... 81

Article de couverture........................................................................................................ 81 Sections ............................................................................................................................ 82 Flash ................................................................................................................................. 85 Boîtes gadget .................................................................................................................... 85 Pages................................................................................................................................. 87 Options ............................................................................................................................. 90

Onglet Panneau de côté ........................................................................................................ 91 A la une ............................................................................................................................ 91 Nouvelles.......................................................................................................................... 91 Extra ................................................................................................................................. 93

Page de couverture ............................................................................................................... 93 Organisation d'une page YACS................................................................................................ 95

La bannière........................................................................................................................... 95 Les onglets de menu............................................................................................................. 96 Le panneau de navigation..................................................................................................... 96

Paramétrage du panneau de navigation............................................................................ 97 Les composants du panneau de navigation ...................................................................... 98

La boîte menu............................................................................................................... 98 La boîte user ................................................................................................................. 98 Le panneau extra (du panneau de navigation).............................................................. 98 Les boîtes de navigation............................................................................................... 99

Le panneau extra .................................................................................................................. 99 Paramétrage du panneau extra........................................................................................ 100 Les composants du panneau extra.................................................................................. 101

profile ......................................................................................................................... 101 tools ............................................................................................................................ 101 news............................................................................................................................ 101 overlay........................................................................................................................ 102 boxes........................................................................................................................... 102 Share........................................................................................................................... 102 channels...................................................................................................................... 102 Twins.......................................................................................................................... 102 neighbours .................................................................................................................. 103 contextual ................................................................................................................... 103

categories.................................................................................................................... 103 bookmarklets .............................................................................................................. 103 servers......................................................................................................................... 103 download .................................................................................................................... 104 referrals....................................................................................................................... 104 Visited ........................................................................................................................ 104

Divers ..................................................................................................................................... 104 Overlay ............................................................................................................................... 104 Etiquettes............................................................................................................................ 104 Référencer cette page ......................................................................................................... 106

Introduction Ce manuel s'adresse aux débutants désireux de découvrir en détail les possibilités de YACS et d'apprendre à l'utiliser. Rédigé par un nul, pour les nuls, mais pour qu'ils ne le restent pas longtemps, il puise ses informations dans la documentation et les forum de la communauté YACS en tentant d'en faire une synthèse accessible à tous.

Installer et configurer YACS

Installation locale sur Windows Pour apprendre à utiliser YACS, rien de tel que de l'installer en test sur son ordinateur. Voici la procédure pour une installation sur un PC muni de Windows.

Installation d'EasyPHP YACS s'appuie sur une infrastructure à base de briques connues et répandues (PHP, MySQL et Apache) qu'il convient de commencer par installer. Pour cela, télécharger le package fourni par EasyPHP. Exécuter le fichier EasyPHP-5.3.0-setup.exe pour lancer l'installation et accepter toutes les propositions par défaut. Pour la version 8.11 de Yacs, installer la version 1.8 de EasyPHP. Démarrer EasyPHP. Une icône en forme de E dans la barre des tâches signale l'exécution de EasyPHP et permet

d'accéder aux contrôles :

Ajout d'extensions PHP La librairie graphique gd2 (qui permet la gestion des images) n'est pas activée par défaut sur EasyPhp 1.8. Il faut l'activer à l'aide d'un "clic droit" sur l'icône EasyPHP : Puis sélectionner l'extension php_gd2 :

Ce n'est pas obligatoire mais l'on peut procéder de même pour activer les extensions php_ming (qui permet d'avoir la liste des articles récents en flash dynamique sur la page d'accueil) et php_zip (extraction d'archive). On peut également activer php_ldap si l'on dispose d'un répertoire d'usagers de type LDAP.

Configuration de PHP Ce n'est pas obligatoire mais l'on peut optimiser la configuration PHP à l'aide d'un "clic droit" sur l'icône EasyPHP: Dans le fichier php.ini qui s'est affiché, il est conseillé d'augmenter la taille maximale des téléchargements en la passant de 2 Mo à 8 Mo par exemple. Cela sera plus confortable pour les mises à jour et, de façon générale, pour l'usage quotidien du serveur. Chercher la chaîne de caractères upload_max_filesize et changez le 2M en 8M, ou plus si vous le souhaitez :

; Maximum allowed size for uploaded files. upload_max_filesize = 8M

Comme les fichiers binaires sont souvent encodés (ce qui se traduit par une inflation d'octets), en profiter pour changer également le paramètre post_max_size afin qu'ilo soit le double du upload_max_size :

; Maximum size of POST data that PHP will accept. post_max_size = 16M

Les développeurs YACS disposent d'un script incluant tous les autres afin de pouvoir repérer

les erreurs de syntaxe. Cette fonction puissante requérant pas mal de mémoire additionnelle, il est nécessaire de changer le paramètre memory_limit de 8 Mo à 32 Mo : memory_limit = 32M ; Maximum amount of memory a script may consume Sauvegarder le fichier php.ini puis redémarrer EasyPHP afin de prendre en compte les nouveaux paramètres :

Création de la base de donnée Lancer PhpMyAdmin à l'aide d'un clic avec le bouton droit de la souris sur l'icône d'EasyPHP : Ou, selon la version de EasyPHP, en allant à l'adresse http://localhost/home/mysql/

Créer une nouvelle base de données ayant pour nom yacs (par exemple), puis cliquer sur le bouton Créer :

S'assurer que l'opération s'est bien déroulée :

Installation de YACS Télécharger la dernière version stable à cette adresse : http://www.yacs.fr/section-342-fichiers-source. A savoir :

• Le contenu du fichier readme.txt inclus dans l'archive YACS permet d'obtenir des informations complémentaires.

• Les distributions officielles de YACS sont multilingues. YACS s'adapte automatiquement lorsqu'il reconnaît un navigateur anglais ou français. Il n'y a rien à ajouter pour installer un serveur web en français.

L'archive YACS contient un dossier yacs. Extraire le contenu de ce dossier dans le répertoire "www" de l'installation EasyPHP (dans C:\Program Files\EasyPHP5.3.0\www dans le cas d'une installation par défaut) afin d'obtenir une arborescence de ce type :

Configuration initiale de YACS S'assurer que EasyPHP est bien démarré (l'icône E dans la barre des taches…) puis, à l'aide d'un navigateur, aller à l'adresse http://localhost/ Aller à la page d'installation de YACS :

S'assurer que le résultat des vérifications est OK : Puis commencer l'installation :

Vérifier que le nom de la base de données correspond à celle créée précédemment puis cliquer sur Envoyer : Une série d'onglets (Système, Communication, etc.) permet de définir de nombreux paramètres du site. A moins de savoir à quoi ils correspondent, conserver les valeurs renseignées par défaut. Rechercher ensuite les extensions :

Puis, créer les tables de la base de données :

Patience, cette opération peut durer plusieurs minutes. Lancer ensuite l'initialisation de la base de données :

Choisir le nom du compte qui aura les droits d'administrer ce site et indiquer le mot de passe associé :

Configurer ensuite la fabrication des pages : L'installateur de YACS ne se contente pas d'installer les programmes permettant au CMS de fonctionner. Le squelette d'un site prêt à fonctionner est également mis en place. Pour le personnaliser, configurer les méta-informations :

Les paramètres définis via les autres onglets peuvent être laissés avec leur valeur par défaut. Ils pourront être modifiés ultérieurement en allant sur la page http://localhost/skins/configure.php :

Valider la configuration :

Et enfin, mettre le serveur en route :

Le site est maintenant opérationnel et l'on retrouve certains des éléments définis précédemment :

Constater au passage que le nom du compte actuellement connecté (toto) correspondant au surnom de l'administrateur défini quelques pages auparavant.

La page de l'assistant d'installation sur laquelle on se trouve propose plusieurs possibilités pour poursuivre la mise en place de ce nouveau site :

1- Modifier l'apparence du site en changeant son style 2- Ajouter différents types de contenu (article, livre, blog, wiki,…) à l'aide d'un assistant 3- Accéder au paramétrage et à l'administration du site via le panneau de contrôle 4- Aller à la page d'accueil de ce nouveau site 5- Aller à la page regroupant les informations de l'utilisateur toto avec lequel on est

actuellement connecté 6- Créer une nouvelle page de contenu 7- Accéder à l'aide 8- Aller sur le site de la communauté YACS… Dont l'adresse web a changé depuis (

http://www.yacs.fr/ ).

Créer des pages Dans YACS, on distingue 2 sortes de pages :

• Les articles, véritables pages de contenu (texte agrémenté d'images, de fichiers attachés, de vidéo, etc.).

• les sections, servant à regrouper et à classer les articles. En plus de contenir des articles, les sections peuvent contenir d'autre sections (on parle alors de sous-sections), formant alors une arborescence hiérarchique de sections. Par contre, un article ne peut contenir ni article ni section. De manière imagée, on peut comparer un site YACS à un arbre dont la racine est la page d'accueil, les sections sont les branches et les articles constituent les feuilles.

Créer une section Pour pouvoir y ranger les articles, créer tout d'abord les sections. Pour cela, il faut être connecté avec un compte disposant des droits nécessaires (le compte toto dans notre exemple). Se rendre sur la page d'accueil et utiliser le lien proposant de l'assistance pour créer du contenu :

Page d'accueil

Section 1 Section 2

Section 4

Section 6

Section 5 Article A Article B

Article C

Article D

ArticleE

Article F

Section 7

Si la page d'accueil a été modifiée et ne dispose plus de ce lien, on peut également se rendre à l'adresse http://localhost/help/populate.php ou passer par le panneau de contrôle :

Choisir d'ajouter une section :

Puis passer à l'étape suivante en cliquant sur : . A l'aide de la liste déroulante Point d'ancrage, indiquer dans quelle section existante cette section doit être créée. Choisir Niveau de base pour créer la section directement à la racine constituée par la page d'accueil. Noter qu'un certains nombre de sections dites "spéciales" sont déjà présentent dans la liste (Pages, Pages globales, Boîtes de navigation, etc). Elles ont été créées automatiquement lors de l'installation de YACS et sont, pour la plupart, non accessibles aux visiteurs. Nous verrons plus tard à quoi elles servent et comment les utiliser. Définir le titre de la section, un court texte d'introduction et, éventuellement, une description plus fournie :

Des sous-section spéciales (Nouvelles, Boîtes gadget et Boîtes extra) peuvent être créées en même que cette nouvelle section. Pour simplifier cet exercice, les demandes d'ajout de ces sections sont décochées. Nous verrons ultérieurement à quoi elles servent et comment les utiliser.

Poursuivre à l'étape suivante : pour terminer l'opération de création de la section. Un lien permet d'afficher la page de la section créée tandis qu'un autre propose de recommencer pour créer une autre section, de la même manière :

Choisir d'accéder à la nouvelle section pour admirer le résultat :

Le titre de la section (1), son texte d'introduction (2) et la description complète (3) sont affichés. Comme il s'agit d'une section rattachée directement au Niveau de base, un onglet est automatiquement ajouté dans le Menu à onglets. Nous verrons plus loin le large éventail des possibilités offertes par les pages de section.

Créer un article Pour créer une page de type article dans une section, utiliser le lien Ajouter une page qui s'affiche à la suite de la description de la section :

Définir le titre de l'article, un court texte d'introduction et la description qui correspond au corps de l'article. Cette dernière profite d'un éditeur wysiwyg (what you see is what you get) qui permet de formater le texte (caractères en gras, italique, souligné,…) et d'insérer des éléments comme les émoticones par exemple, mais également de visualiser le corps de l'article "un peu près" comme il apparaîtra sur la page finale.

Le bouton permet d'enregistrer le travail et de créer la nouvelle page. Avant de visualiser la nouvelle page, un message rappelle que la page nouvelle créée n'est pas publiée, c'est-à-dire qu'elle n'est pas visible pour les visiteurs mais seulement pour les membres connectés disposant des droits nécessaires. Un lien permet de publier la page dans la foulée afin de la rendre immédiatement accessible à tous. Un autre lien permet de visualiser la page créée.

Enfin, d'autres liens proposent de compléter la page en ajoutant une image, un fichier ou un lien ou de créer une autre nouvelle page de type article.

Visualiser le nouvel article et remarquer sa composition en plusieurs zones : 1- L'article lui-même avec son titre suivi de son introduction puis de sa description 2- Une zone de commentaire (vide pour l'instant) avec un lien invitant à ajouter un

nouveau commentaire 3- Une zone d'information permettant de voter pour cette page et rappelant qui a créé

l'article (les éditeurs), qui l'a modifié en dernier (posté par) et quand, le nombre de visite (lorsqu'il y en a eu), un éventuel panneau avertissant que cet article reste à publier (et donc qu'il n'est pas visible pour l'instant) et le code à utiliser pour faire référence à cet article (dans d'autres articles, par exemple). Cette zone n'est pas visible des visiteurs non connectés et son contenu peut varier en fonction des droits du membre connecté.

4- Des liens permettant différentes actions sur cette page dont la modification, la publication et la suppression. Ces liens s'affichent uniquement pour les membres connectés ayant le droits d'effectuer ces actions.

Modifier les options avancées d'un article Cliquer sur le lien Modifier cette page qui apparaît en bas d'un article que l'on a le droit de modifier (un article que l'on a créé, par exemple).

Onglet Information On retrouve les zones des titre, introduction et description vus précédemment, avec la possibilité de les modifier. En descendant plus bas dans la page, on trouve d'autres possibilités offertes pour adapter l'article à ses besoins.

Etiquettes

Permet de saisir une liste de mots-clés, séparés par des virgules et qui permettra de regrouper facilement les pages ayant les mêmes mots-clés. Voir le chapitre sur les étiquettes pour plus d'informations.

Images 3 possibilités sont proposées :

1- Ajouter une image à l'article. 2- Définir la vignette de l'article 3- Définir l'icône de l'article

Ajouter une image à la page

Pour ajouter une image dans la page de l'article, cliquer sur : Indiquer ensuite l'emplacement et le nom du fichier en cliquant sur le bouton Parcourir. On peut ensuite, si on le souhaite, lui attribuer un titre et une description et préciser la source de l'image (l'auteur, le copyright, le site web d'origine, etc.).

Les informations associées à l'image sont visibles sur la page qui est automatiquement créée avec chaque image ajoutée. Noter que cette page n'est pas accessible à partir de l'article (sauf pour les membres connectés habilités à modifier la page de l'article et les images associées).

Options avancées des images

D'autres options avancées peuvent être définies en cliquant sur On peut préciser une adresse web vers laquelle sera envoyé le visiteur lorsqu'il cliquera sur cette image, lorsque celle-ci est insérée dans le corps d'un article.

Lors du chargement de l'image sur le serveur YACS, on peut autoriser ou interdire le redimensionnement automatique de l'image (sa réduction à la taille maxi définie, si l'image dépasse cette taille) :

Par défaut, YACS redimensionne les images selon le paramétrage défini dans Panneau de contrôle > Configuration > Fabrication des pages > Images (ou http://localhost/skins/configure.php). En décochant cette case, le traitement ne sera pas effectué. Enfin, on peut choisir de :

• ne réduire en vignette l'image que si son fichier est supérieur à un certain poids en Ko (cette valeur est définie dans Panneau de contrôle > Configuration > Fabrication des pages > Images)

• systématiquement réduire cette image en vignette (même si son poids est déjà petit). De cette façon, si l'image est moins lourde que le seuil défini (20 Ko), elle ne rompt pas la mise en page de la galerie en s'affichant en grand au milieu des autres vignettes…

• ne jamais réduire l'image en vignette (on force son affichage systématique à sa taille normale).

La galerie d'image Les images ajoutées apparaissent sous forme de vignette, en bas de l'article, formant une galerie d'image.

En cliquant dessus, on visualise l'image à sa taille réelle, surmontée de son titre, s'il a été renseigné (noter que les images de petites tailles, qui n'ont pas eu besoin d'être réduites pour être affichées dans cette galerie, ne sont pas cliquables car elles ne peuvent être montrées à une taille plus grande). Sous l'image, 3 boutons permettent :

• de passer à l'image précédente • de fermer la fenêtre de visualisation

des images • de passer à l'image suivante.

Vignette de l'article La vignette de l'article est l'image (de taille réduite) qui est associée au titre et à l'introduction de l'article lorsque celui-ci apparaît dans une liste :

Pour définir la vignette de l'article, cliquer sur : Puis charger une image comme vu précédemment. Si l'image devant servir de vignette a déjà été chargée dans cette page, il est alors plus facile d'utiliser le lien proposant de la transformer en vignette de page, à côté de l'image choisie :

Icône de l'article L'icône de l'article est l'image (en taille réelle) qui est automatiquement affiché en haut de l'article :

Pour définir l'icône de l'article, cliquer sur puis charger l'image comme vu précédemment. Si l'image devant servir d'icône a déjà été chargée dans cette page, on peut également utiliser le lien proposant de la transformer en icône de page, à côté de l'image choisie.

L'icône de l'article ne peut être affiché sous forme de vignette réduite. Il est donc nécessaire de dimensionner l'image à la taille voulue avant de la charger sur le serveur YACS.

Emplacements YACS offre la possibilité d'associer des localisations géographiques à la page de l'article.

Ajouter un nouvel emplacement Pour définir un nouvel emplacement, cliquer sur Ajouter un emplacement :

Indiquer l'adresse, les coordonnées géographiques, le pays et un texte décrivant l'endroit.

Visualisation des emplacements Les informations saisies lors de la création de l'emplacement s'affichent sur la page qui est automatiquement créée pour chaque emplacement. Un planisphère permet de localiser visuellement l'endroit (le petit point rouge).

Du côté de l'article, seul le planisphère avec son point rouge est ajouté en bas de l'article. S'il y a plusieurs emplacements définis, plusieurs planisphères sont affichés les uns en dessous des autres. L'affichage de ces localisations dans l'article est déclenché par l'ajout automatique, dans la description de l'article, d'un code [location=x] où x est le numéro unique identifiant chaque emplacement défini. On peut ainsi aisément les supprimer ou modifier leur ordre si besoin.

Déterminer les coordonnées géographiques d'un lieu Sur la droite de la page qui permet de définir les coordonnées géographiques, figure un menu d'aide proposant des liens vers 2 sites de géo-localisation (en anglais).

Le premier est très simple à utiliser mais permet seulement d'obtenir les coordonnées correspondant à une adresse connue :

Le second site nécessite de saisir un code pour s'assurer que c'est bien un humain qui l'utilise mais permet ensuite de déplacer le curseur sur la carte pour cibler précisément un lieu qui n'aurait pas d'adresse :

Attention à la manière de saisir ensuite les coordonnées dans YACS : rentrer d'abord la latitude (nombre décimal avec un point à la place de la virgule, positif ou négatif), suivi d'une virgule, suivi de la longitude (nombre décimal avec un point à la place de la virgule, positif ou négatif). Exemple : 47.98481,-71.42124

Tables YACS permet d'ajouter facilement des tables (= des tableaux) listant des informations contenues dans la base de données et obtenues à l'aide d'une requête SQL.

Commencer par ajouter une nouvelle table : Indiquer le titre de la table et la requête SQL :

Contenu additionnel Cette rubrique permet de configurer l'article et d'ajouter du contenu additionnel en bas de page et dans la "boîte extra" située sur le côté de la page.

Rendu Permet de modifier le comportement de l'article en spécifiant les mots-clés associés aux comportements désirés. La liste des mots-clés disponibles est indiquée en dessous. Il suffit de cliquer sur le mot-clé désiré pour qu'il s'ajoute dans la liste (séparés les uns des autres par un espace).

Quelques explications sur les différents mots-clés :

anonymous_edit Autorise les visiteurs non connectés (les "surfeurs anonymes") à modifier le contenu de l'article via la boîte Outils qui s'affichera également pour eux (sur le côté de la page).

Leurs droits sont, malgré tout, limités. Ils ne peuvent pas :

• voir et modifier le paramétrage du rendu dans le contenu additionnel • ajouter des tables (tableaux)

members_edit Autorise les visiteurs connectés (les "membres") à modifier le contenu de l'article via la boîte Outils qui s'affichera également pour eux (sur le côté de la page). Ils peuvent voir et modifier le paramétrage du rendu dans le contenu additionnel mais pas ajouter des tables (tableaux). Noter que si ce mot-clé n'est pas indiqué mais que anonymous_edit l'est alors les membres connectés auront quand même le droit de modifier le contenu.

no_files Empêche l'ajout de fichiers dans l'article. Le lien Ajouter un fichier disparaît de la boite Outils.

files_by_title Par défaut, les fichiers ajoutés à un article sont listés, classés par date d'ajout. Ce mot-clé permet de modifier l'ordre de tri et de les avoir listés par titre.

no_links Empêche l'ajout de liens dans l'article. Le lien Ajouter un lien disparaît de la boite Outils.

links_by_title Par défaut, les liens ajoutés à un article sont listés, classés par date d'ajout. Ce mot-clé permet de modifier l'ordre de tri et de les avoir listés par titre.

no_comments Empêche l'ajout de commentaires. La zone de commentaire disparaît

view_as_chat Ajoute dans l'article la fonction de clavardage (discussion interactive en temps réel entre plusieurs personnes). Le clavardage (contraction des mots clavier et bavardage) est similaire aux commentaires laissés en bas de page, l'interactivité en temps réel en plus. Pour cette raison, lorsque le clavardage est activé, la zone de commentaire n'est plus affichée. S'il y avait déjà des commentaires existants, ils se retrouvent intégrés dans le clavardage. A l'inverse, l'arrêt de la fonction de clavardage (en supprimant le mot-clé view_as_chat) déclenche le réaffichage de la zone de commentaire avec tous les messages échangés lors du clavardage.

Pour participer au clavardage, une zone de saisie apparaît en bas de l'article. Elle permet de saisir un message à poster uniquement aux membres connectés :

En dessous de cette zone, un bouton Enregistrer permet d'envoyer le message. Noter que l'utilisation de la toucher Entrée envoie également le message, sauf si la case La touche Entrée envoie le texte est décochée (ce qui est nécessaire si l'on veut pouvoir utiliser la touche Entrée pour sauter une ligne dans le texte).

D'autres liens permettent :

• d'accéder à la liste des codes à utiliser pour insérer un émoticone • d'ajouter une fichier joint au message • d'ouvrir une page listant l'ensemble des contributions à la discussion • d'agrandir le panneau d'affichage de la discussion pour pouvoir y afficher plus de

lignes Le panneau d'affichage de la discussion, situé dans l'article, liste les différents messages postés, par ordre d'arrivée, en identifiant chaque membre :

Toutes les personnes qui visualisent cette page (membre connectés et visiteurs anonymes) peuvent suivre la discussion en temps réel. Les nouveaux messages postés apparaissent sans qu'il soit nécessaire de revenir sur la page ou de la rafraîchir. Un lien à la fin de chaque message permet de revenir dessus :

On peut alors choisir : • de réagir au message (répondre) en envoyant un nouveau message commençant par le

nom de l'auteur du message auquel on réagit. • de citer le message en envoyant un nouveau message commençant par la citation du

message auquel on fait référence. • de modifier le message en lui apportant une mise en forme plus travaillée (caractères

en gras, italique, émoticones, …) • de supprimer le message

view_as_tabs Permet de scinder le contenu de la page en plusieurs pages accessibles via des onglets. L'onglet Information reprend l'essentiel de l'article :

L'onglet Discussion affiche la zone de commentaire :

L'onglet Personnes fourni un lien vers la fiche profil de l'auteur de l'article ainsi que des liens vers d'autres pages qu'il a créé.

Noter que l'affichage par onglet et le clavardage en temps réels sont incompatibles. Si les 2 mots-clés sont sélectionnés, seul le premier des 2 sera effectivement pris en compte.

view_as_foo_bar Exemple permettant d'orienter le processus de construction de l'article dans la page vers le fichier view_as_foo_bar.php à créer et stocker dans le dossier /articles/ (foo_bar peut être remplacé par le nom de son choix).

skin_foo_bar Exemple permettant de modifier le thème graphique de la page complète en orientant le processus de design de la page vers le fichier layout_home_articles_as_foo_bar.php à créer et stocker dans le dossier /skins/ (foo_bar peut être remplacé par le nom de son choix). Par exemple, en indiquant le mot-clé skin_boxesandarrows (nom d'un skin existant), on obtient un design complètement différent de l'article et de son environnement :

Noter le changement de look des onglets, la position en haut de la page des liens d'action sur l'article, la taille inférieure des polices utilisées, la position à droite du panneau de navigation, …

variant_foo_bar Exemple permettant de modifier le template de la page en orientant le processus de construction de la page vers le fichier template_foo_bar.php à créer et stocker dans le dossier /skins/nom du skin utilisé/ (foo_bar peut être remplacé par le nom de son choix). Les thèmes fournis avec Yacs comprennent nativement les variantes suivantes :

• mobile (pour afficher la page sur un écran de petite résolution) • print (pour imprimer la page) • s5 (diapo de présentation S5) • slideshow (pour faire défiler sous forme de diaporama)

En indiquant le mot-clé variant_print, la page de l'article s'affiche alors avec une mise en page prête à être imprimée (sans menu, panneaux latéraux ni bannière intempestive) :

Bas de page Permet de saisir le contenu que l'on souhaite voir s'afficher en bas de la page article :

Ce contenu se retrouve inséré entre la zone des commentaires et la liste des étiquettes :

Extra Permet d'insérer du contenu destiné à être affiché dans le panneau latéral "extra". Ce contenu peut utiliser des balises HTML pour être mis en forme. Il doit être préfixé par la balise [box.extra=Titre] où Titre est le titre que l'on souhaite voir apparaître sur la boite extra. Enfin, terminer le contenu en fermant la balise [/box].

Le résultat est affiché sur le panneau latéral extra :

Onglet Contenu

Section Permet de modifier la section dans laquelle est rattaché l'article. Choisir le titre d'une autre section dans la liste déroulante revient à déplacer l'article dans cette section.

Source Permet de spécifier la source de l'article (personne, site web, titre de document,…).

La source est indiquée dans le cartouche fournissant les informations sur la page. Sa présentation dépend du type de source renseigné parmi les 3 choix suivants :

• un lien web (par exemple : http://www.yacs.fr) : • une référence interne vers une page, un membre,… (par exemple, [user=bob]) :

• un texte libre :

Surnom ou diminutif Permet de définir un surnom à la page qui pourra être utilisé pour y accéder plus directement.

Pour retrouver une page par son surnom, on peut aller à cette adresse : http://localhost/go.php

On peut également utiliser l'adresse mentionnée dans le cartouche fournissant les informations sur la page :

Pièces jointes On peut définir un texte "Préfixe" et un autre "Suffixe" qui seront automatiquement insérés sur certaines pages associées à l'article en cours.

Par exemple, la page permettant de gérer les éditeurs de l'article affiche les "Préfixe" et "Suffixe" :

Contribution à la page d'accueil Le site YACS peut être configuré pour annoncer automatiquement en page d'accueil la création d'un nouvel article. Mais on peut décider de rendre invisible l'article en cours sur la page d'accueil :

Onglet Options

Editeurs Liste les membres ayant le rôle d'éditeur pour cet article (et les droits associés). Pour ajouter un éditeur, cliquer sur Editeurs.

Pour ajouter un éditeur, saisir le début de son surnom, jusqu'à ce qu'il apparaisse dans le champ en dessous. Cliquer alors sur le surnom dans le champ pour l'ajouter à la liste des éditeurs. Pour retirer un éditeur, cliquer sur le lien retirer figurant à côté de son surnom.

La liste des éditeurs apparaît dans le cartouche fournissant les informations sur la page :

Visibilité Permet d'indiquer qui a le droit d'accéder en lecture au contenu de la page article :

• tout le monde • uniquement les visiteurs connectés (les membres) • uniquement les éditeurs de l'article et les associés du site (utilisateurs ayant les pleins

pouvoir sur le site)

Verrouillé Permet d'indiquer qui a le droit d'ajouter des commentaires dans page article :

• tout le monde • uniquement les éditeurs de l'article et les associés du site (utilisateurs ayant les pleins

pouvoir sur le site)

Les visiteurs non connectés qui veulent ajouter un commentaire sont routés, au préalable, vers une page leur demandant soit de se connecter avec leur compte, soit de s'enregistrer, afin de pouvoir contribuer aux commentaires.

Rang La valeur du rang permet de modifier l'ordre d'apparition des pages lorsqu'elles sont listées par rang croissant.

Par défaut, chaque page se voit attribuer un rang de valeur 10000. Lorsque 2 pages ont la même valeur de rang, c'est celle dont la date de modification est la plus récente qui se retrouve classée en premier.

Date de publication Juste pour information, la date et l'heure de première publication de la page.

La publication de la page correspond à l'acte permettant à cette dernière de devenir visible et consultable par tous.

Date d'expiration Juste pour information, la date et l'heure de la fin de publication de la page après laquelle, cette dernière ne sera plus visible par tous (mais uniquement aux membres connectés autorisés comme ses éditeurs par exemple).

Par défaut, les pages n'expirent jamais.

Plus d'option

Langage Permet de préciser la langue dans laquelle est rédigé l'article.

Cette information est reprise dans le code de la page HTML générée afin de pouvoir être exploitée par les moteurs de recherche :

Meta-information Permet de définir des lignes additionnelles à insérer entre les balises <head> de la page HTML générée.

Résultat dans le code de la page :

Adresse web de la vignette Adresse url de l'image servant de vignette à la page.

Le lien Ajouter une image permet de charger une image qui servira de vignette.

La vignette de l'article est l'image (de taille réduite) qui est associée au titre et à l'introduction de l'article lorsque celui-ci apparaît dans une liste :

Noter que la vignette de la page peut également être définie via la gestion des images accessible sur le premier onglet Information :

Adresse web de l'icône Adresse url de l'image servant d'icône à la page.

Le lien Ajouter une image permet de charger une image qui servira d'icône. L'icône de l'article est l'image (en taille réelle) qui est automatiquement affiché en haut de l'article :

Noter que l'icône de la page peut également être définie via la gestion des images, accessible sur le premier onglet Information puis Images :

Changer d'overlay Permet de modifier l'overlay utilisé pour construire l'article en le choisissant par la liste des overlay disponibles.

Pour plus d'information, voir le chapitre sur les overlays plus loin.

Options d'enregistrement d'un article Lorsque l'on valide la modification d'un article (à l'aide du bouton Enregistrer), que ce soit son contenu ou ses paramètres de configuration, on peut décider :

• de ne pas changer la date de modification de l'article (ce qui évite de le faire apparaître en tête de liste des articles récents)

• de vérifier (ou pas) que le contenu soit du XHTML valide

Modifier les options avancées d'une section Pour modifier une page de type section, cliquer sur le lien Modifier cette page qui apparaît en bas d'une section que l'on a le droit de modifier (une section que l'on a créé, par exemple).

Onglet Information On retrouve les zones des titre, introduction et description déjà vus précédemment, avec la possibilité de les modifier. En descendant plus bas dans la page, on trouve d'autres possibilités offertes pour adapter la section à ses besoins.

Images Permet d'ajouter des images, une vignette de section ou une icône de section, de la même manière que pour les articles

Contenu additionnel

Sections Permet de définir comment seront présentées, sur la page de la section concernée, les sous-sections qu'elle contient.

[1] : le nombre maximum de sous-sections à afficher. De [2] à [10] : un style pré-défini de mise en page de liste. [11] : un style personnalisé de mise en page de liste. [12] : permet de ne pas lister les sous-sections sur la page de cette section.

Decorated Liste "décorée" des sous-sections, répartie sur 2 colonnes, avec la liste des articles qu'elles contiennent :

Map Liste répartie sur 2 colonnes, comme Yahoo!, et proche de la présentation "decorated" :

Freemind Présentation sous forme de graphique arborescent cliquable :

Jive Présentation de type "forum de discussion" avec des listes de 5 fils de discussion regroupés par rubrique. On trouve, sous forme de tableau :

• les sous-sections (les rubriques du forum) • les articles (les fils de discussion) présents dans les sous-sections • les auteurs des articles (ceux qui lancent une nouvelle discussion) • le nombre de commentaires (les échanges de la discussion) • la dernière date de modification (dernière intervention sur le fil de discussion)

Des liens Ajouter une page permettent d'ajouter directement une page (un nouveau fil de discussion) dans la sous-section (la rubrique de discussion).

A noter que cette présentation est différente pour les visiteurs non connectés et les membres connectés n'ayant pas les droits suffisants sur cette section :

Yabb Présentation plus condensée de type forum de discussion listant les sous-sections (les rubriques du forum) et leur dernier article :

Inline Présentation sous forme de liste verticale des sous-sections et des articles qu'elles contiennent.

Folded Presentation sous forme de listes dépliables :

Compact Présentation compacte ne listant que les titres des sous-sections :

Titles Présentation sous forme de galerie des vignettes des sous-sections, accompagnées de leur titre.

Pages Permet de définir comment seront présentés, sur la page de la section concernée, les articles qu'elle contient.

De [1] à [13] : un style pré-défini de mise en page de liste. [14] : un style personnalisé de mise en page de liste. [15] : permet de ne pas lister les articles de la section.

Decorated Présentation des articles les plus récents sous forme de liste des vignettes + titres + introductions.

Digg Presentation mettant en avant les votes obtenus par chaque article. Des liens permettent de voter ou commenter la page sans même devoir l'afficher au préalable.

Un lien permet également de référencer la page ailleurs sur le site, ou sur d'autres sites, en fournissant le code à insérer. Pour plus d'infos, voir le chapitre Référencer cette page.

Slashdot Liste des articles les plus récents avec des liens pour commenter ou référencer l'article et une indication sur les votes obtenus.

Map Affichage simple, sur 2 colonnes comme yahoo!

Table Présentation sous forme de tableau des articles les plus récents.

Daily Dans cette présentation de type blog, le contenu des articles listés est intégralement affiché sur la page de la section. Des liens permettent :

• d'accéder à la page de l'article (Permalink), • d'aller voir les commentaires • d'ajouter un nouveau commentaire • de référencer la page

Boxesandarrows Autre présentation des articles récents.

Jive Affiche le contenu de chaque article dans un tableau.

Yabb Présentation adaptée aux listes de discussion où chaque article, avec ses commentaires, constitue un fil de discussion.

Alistapart Le dernier article (le plus récent) est directement et intégralement affiché. Un lien vers l'article précédent (l'avant dernier) est ajouté.

Wiki Equivalent à la présentation Decorated.

Manual Liste compact des titres des titres des articles avec une indication sur les votes obtenus.

Compact Une liste ultra-compacte des titres des articles.

Rendu Permet de modifier le comportement de la section en spécifiant les mots-clés associés aux comportements désirés. La liste des mots-clés disponibles est indiquée en dessous. Il suffit de cliquer sur le mot-clé désiré pour qu'il s'ajoute dans la liste (séparés les uns des autres par un espace).

articles_by_publication Permet de trier les articles listés par date de publication croissante.

articles_by_rating Permet de trier les articles listés par nombre de votes croissant.

articles_by_title Permet de trier les articles listés par ordre alphabétique de leur titre.

articles_by_reverse_title Permet de trier les articles listés par ordre alphabétique inverse de leur titre.

articles_by_reverse_rank Permet de trier les articles listés dans l'ordre décroissant de leur rang (valeur servant à classer chaque article).

no_new_articles Permet de ne pas lister les pages récentes des sous-sections. Lorsque ce mot-clé n'est pas utilisé, les articles récents des sous-sections sont listés dans une rubrique Quoi de neuf ?:

with_files Affiche un lien permettant d'ajouter des fichiers sans devoir passer par le lien permettant de modifier la page. De cette manière, tous les membres connectés peuvent joindre un fichier à la section, même s'ils n'y ont pas accès en modification.

files_by_title Permet de trier la liste des fichiers joints par ordre alphabétique de leur titre (et non par date).

with_links Affiche un lien permettant d'ajouter des liens vers un site web sans devoir passer par le lien permettant de modifier la page. De cette manière, tous les membres connectés peuvent ajouter un lien vers un site, même s'ils n'ont pas accès à la section en modification.

links_by_title Permet de trier la liste des liens par ordre alphabétique de leur titre (et non par date).

with_creator_profile Affiche le profil du créateur de la section dans le panneau extra sur le côté de la page.

Attention, pour voir apparaître le profil de l'auteur, il faut ajouter le mot-clé with_extra_profile dans les options des Pages de l'onglet Contenu:

A noter que ce mot-clé a été renommé par with_owner_profile à partir de la version 9.11.

with_comments Par défaut, Yacs n'autorise les commentaires que sur les pages article. Ce mot-clé ajoute une zone de commentaire permettant de commenter et discuter directement sur la page de section. Un bug dans la version 8.11 empêche la zone de commentaire de s'afficher (avec le lien

) tant qu'aucun commentaire n'a été ajouté. Pour contourner ce bug, il faut qu'un membre, ayant le droit de modifier la section, utilise le menu Outils pour ajouter un premier commentaire et permettre ainsi à la zone commentaire d'apparaître pour tous. A noter que dans la version 9.5, ce bug est corrigé.

Noter également que les commentaires des sections diffèrent des commentaires des pages. Par exemple, ils ne sont pas listés sur la page d'accueil.

with_slideshow Ajoute un lien qui permet d'afficher la section et ses articles comme un diaporama (slideshow) de présentation S5.

Le diaporama permet de balayer chaque page (la section puis ses articles) avec une présentation du genre "diapo plein écran", dotée d'un menu déroulant pour accéder à chaque diapo.

En cliquant sur la diapo, on passe à la suivante, comme avec une présentation Powerpoint.

view_as_tabs Permet de scinder le contenu de la section en différentes "pages" accessibles via des onglets.

view_as_foo_bar Exemple permettant d'orienter le processus de construction de la section dans la page vers le fichier view_as_foo_bar.php à créer et stocker dans le dossier /sections/ (foo_bar peut être remplacé par le nom de son choix).

skin_foo_bar Exemple permettant de modifier le thème graphique de la page complète en orientant le processus de design de la page vers le fichier layout_home_articles_as_foo_bar.php à créer et stocker dans le dossier /skins/ (foo_bar peut être remplacé par le nom de son choix). Par exemple, en indiquant le mot-clé skin_boxesandarrows (nom d'un skin existant), on obtient un design complètement différent de la section et de son environnement :

Noter le changement de look des onglets, la position en haut de la page des liens d'action sur la section, la taille inférieure des polices utilisées, la position à droite du panneau de navigation, …

variant_foo_bar Exemple permettant de modifier le template de la page en orientant le processus de construction de la page vers le fichier template_foo_bar.php à créer et stocker dans le dossier /skins/nom du skin utilisé/ (foo_bar peut être remplacé par le nom de son choix). Les thèmes fournis avec Yacs comprennent nativement les variantes suivantes :

• mobile (pour afficher la page sur un écran de petite résolution) • print (pour imprimer la page) • s5 (diapo de présentation S5) • slideshow (pour faire défiler sous forme de diaporama)

En indiquant le mot-clé variant_print, la page de la section s'affiche alors avec une mise en page prête à être imprimée (sans menu, panneaux latéraux ni bannière intempestive) :

no_contextual_menu Lorsque ce mot-clé est utilisé, la boîte listant les sections avoisinantes (sections sœurs et sous-sections) n'est plus affichée dans le panneau latéral extra.

Bas de page Comme pour les articles, permet d'ajouter un contenu en bas de la page :

Voila le résultat :

Extra Permet d'insérer du contenu destiné à être affiché dans le panneau latéral "extra". Ce contenu peut utiliser des balises HTML pour être mis en forme. Il doit être préfixé par la balise [box.extra=Titre] où Titre est le titre que l'on souhaite voir apparaître sur la boite extra. Enfin, terminer le contenu en fermant la balise [/box].

Le résultat est affiché sur le panneau latéral extra :

Nouvelles Permet de configurer la liste des articles récents des sous-sections qui est située dans le panneau extra sur le côté de la section.

1- Liste fixe, limitée à la quantité d'article précisée. 2- Liste animée (défilement vertical, comme sur un téléprompteur), limitée à la quantité

d'article précisée en [1]. 3- Affichage des liens vers les articles, un à la fois, les uns après les autres (comme un

slide show automatique), limitée à la quantité d'article précisée en [1]. 4- Les articles des sous-sections ne sont pas remontés dans le panneau extra de la section.

Attention. Pour que les articles des sous-sections remontent en tant que nouvelles, il faut que les sous-sections concernées soient configurées en conséquent (que leur contribution à la section supérieure soit affichée dans la zone réservée aux nouvelles) :

Onglet Contenu

Section parente Permet de modifier la section "supérieure" dans laquelle est rattaché la section. Choisir le titre d'une autre section dans la liste déroulante revient à déplacer la section dedans. Choisir Niveau de base pour rattacher la section directement sous la page d'accueil.

Surnom Permet de donner un surnom à la page qui pourra être utilisé pour y accéder plus directement.

Pour retrouver une page par son surnom, on peut aller à cette adresse : http://localhost/go.php

On peut également utiliser l'adresse mentionnée dans le cartouche fournissant les informations sur la page :

Comportements Permet d'activer des comportements particuliers en indiquant le nom des comportements désirés (un par ligne) suivis de leur(s) paramètre(s).

agree_on_file_access Permet de demander l'accord du "surfeur" avant de télécharger un fichier, en lui affichant le contenu d'un texte pré-établi :

Le nom du fichier texte indiqué en paramètre de agree_on_file_access, et qui contient le texte à afficher au surfeur, correspond à un fichier stocké dans le dossier /behaviors/agreements/ :

Lorsqu'un surfeur clique sur un lien permettant de télécharger un fichier inclus dans cette section, dans l'un des ses articles où dans les sections at articles inférieurs, le texte s'affiche et il doit donner son accord en cliquant sur Oui en bas de la page :

Dans le cas contraire, le surfeur obtient un refus de téléchargement du fichier demandé :

move_on_article_access Permet de faciliter le déplacement des articles d'une section vers une autre section. La section de destination doit être précisée en paramètre (indiquer son n° id ou son surnom derrière le mot-clé move_on_article_access avec un espace de séparation) :

Pour les membres connectés disposant des droits nécessaires, un bouton apparaît à la fin des articles de la section afin de pouvoir les déplacer vers la section indiquée en paramètre :

Sous-sections Permet de définir un overlay à appliquer aux sous-sections de cette section. Les overlays permettent d'adapter la structure des pages pour accueillir des contenus particuliers (fiche de contact, recette de cuisine, pétition, sondage,…). Plus d'infos dans le chapitre Overlay.

Pages Les paramètres définis dans cette rubrique s'appliquent aux articles de la section concernée.

Options Permet de modifier le comportement de l'article en spécifiant les mots-clés associés aux comportements désirés, séparés par un espace.

anonymous_edit Autorise les visiteurs non connectés (les "surfeurs anonymes") à modifier le contenu des articles. Pour plus d'infos, voir la rubrique équivalente dans le chapitre Modifier les options avancées d'un article.

members_edit Autorise les visiteurs connectés (les "membres") à modifier le contenu de l'article. Pour plus d'infos, voir la rubrique équivalente dans le chapitre Modifier les options avancées d'un article.

Auto_publish Avec ce mot-clé, aussitôt enregistrés, les articles sont publiés (visibles de tous) sans nécessiter de publication par un membre autorisé.

view_as_chat Ajoute dans l'article la fonction de clavardage (discussion interactive en temps réel entre plusieurs personnes). Pour plus d'infos, voir le chapitre sur le clavardage.

view_as_tabs Permet de scinder le contenu de la page en plusieurs pages accessibles via des onglets. Pour plus d'infos, voir la rubrique équivalente dans le chapitre Modifier les options avancées d'un article.

view_as_foo_bar Exemple permettant d'orienter le processus de construction de l'article dans la page vers le fichier view_as_foo_bar.php à créer et stocker dans le dossier /articles/ (foo_bar peut être remplacé par le nom de son choix).

Without_rating Supprime la notation des articles.

Rate_as_digg Incitation au vote via l'affichage d'un panonceau en tête d'article :

Au lieu du lien en bas d'article :

With_export_tools Dans la boîte Partage du panneau extra, ajouter des liens permettant de convertir la page en :

• PDF • Microsoft Word • Palm

with_prefix_profile Ajoute le profil de l'auteur en haut de la page, entre le titre et l'introduction : Pour visualiser les changements dans les pages concernées, il est conseillé de purger le contenu sauvegardé en cache (http://localhost/control/purge.php).

with_suffix_profile Ajoute le profil de l'auteur en bas de la page, entre le corps principal de l'article et la zone des commentaires :

Pour visualiser les changements dans les pages concernées, il est conseillé de purger le contenu sauvegardé en cache (http://localhost/control/purge.php).

with_extra_profile Ajoute le profil de l'auteur sur le côté de la page, dans le panneau extra :

Pour visualiser les changements dans les pages concernées, il est conseillé de purger le contenu sauvegardé en cache (http://localhost/control/purge.php).

no_comments Empêche l'ajout de commentaires. La zone de commentaire disparaît

no_links Empêche l'ajout de liens dans l'article. Le lien Ajouter un lien disparaît de la boite Outils.

no_files Empêche l'ajout de fichiers dans l'article. Le lien Ajouter un fichier disparaît de la boite Outils.

no_neighbours Par défaut, une boîte intitulée Navigation propose des liens vers l'article précédent ou suivant, dans le panneau extra, sur le côté de la page :

Le mot-clé no_neighbours supprime l'affichage de cette boîte.

with_deletions Autorise les éditeurs des articles de la section à supprimer leurs articles.

Overlay Défini l'overlay qui sera appliqué aux articles de la section (voir le chapitre sur les overlay).

Pages modèles Permet de créer les nouvelles pages article de la section en dupliquant la page désignée qui sert alors de modèle. Indiquer un numéro id ou un surnom d'article :

Préfixe Défini le texte "préfixe" qui sera utilisé dans les articles de la section. Pour plus d'infos, voir la rubrique équivalente dans le chapitre Modifier les options avancées d'un article.

Suffixe Défini le texte "suffixe" qui sera utilisé dans les articles de la section. Pour plus d'infos, voir la rubrique équivalente dans le chapitre Modifier les options avancées d'un article.

Contribution à la mise en page de "La section supérieure" Permet d'indiquer si cette section doit être citée parmi celles listées en zone principale de la section supérieure. L'ordre d'apparition (rang) permet de modifier sa position de la liste.

L'autre option possible consiste à décider que cette section n'apparaîtra que dans les sections spéciales visibles des membres connectés disposant des droits nécessaires.

Lorsque la section est citées sur la page de sa section supérieure, on précise à quel endroit de la section supérieure elle doit apparaître.

Dans le zone principale :

Dans la zone réservée aux nouvelles (dans ce cas, ce sont les articles de la sections qui sont affichés) :

Listée dans la zone principale, dans une boîte gadget :

Comme l'affichage précédent mais, cette fois, dans des boîtes gagdet distinctes (et seulement les articles de la section) :

Listée sur le côté de la page, dans une boîte extra :

Affichée dans des boîtes extra distinctes :

Enfin, on peut choisir de ne pas afficher la section et ses articles dans

Contribution à la page d'accueil Permet d'indiquer comment cette section est affichée sur la page d'accueil (par défaut, elle ne contribue pas à la page d'accueil) :

Le contenu de tous les articles de la section concernée peut être affiché intégralement dans la zone principale de la page d'accueil (avec des liens pour voir les commentaires, ajouter un commentaire ou référencer la page):

Affichée dans la zone réservée aux nouvelles (uniquement les articles de la section) , dans le panneau extra sur le côté de la page :

Listée dans la zone principale, dans une boîte gadget :

Affichée dans des boîtes gagdet distinctes :

Listée sur le côté de la page d'accueil, dans une boîte extra (nécessite de purger le cache pour voir le changement : http://localhost/control/purge.php) :

Affichée dans des boîtes extra distinctes (nécessite de purger le cache pour voir le changement : http://localhost/control/purge.php) :

Enfin, on peut choisir de ne pas afficher la section et ses articles dans la page d'accueil :

Onglet Options

Editeurs Liste les membres ayant le rôle d'éditeur pour cette section (et les droits associés). Pour ajouter un éditeur, cliquer sur Editeurs.

Pour ajouter un éditeur, saisir le début de son surnom, jusqu'à ce qu'il apparaisse dans le champ en dessous. Cliquer alors sur le surnom dans le champ pour l'ajouter à la liste des éditeurs. Pour retirer un éditeur, cliquer sur le lien retirer figurant à côté de son surnom.

La liste des éditeurs apparaît dans le cartouche fournissant les informations sur la page :

Lecteurs Liste les membres ayant le rôle de lecteur pour cette section (et les droits associés).

Pour assigner un membre à une section, aller sur Profils des utilisateurs (http://localhost/users/) et désigner le membre concerné :

Gérer les sections qui lui sont attribuées :

Sélectionner dans la liste déroulante ou désélectionner à l'aide du bouton les sections concernant le membre :

Visibilité Permet d'indiquer qui a le droit d'accéder en lecture au contenu de la section:

• tout le monde • uniquement les visiteurs connectés (les membres) • uniquement les éditeurs de la section et les associés du site (utilisateurs ayant les

pleins pouvoir sur le site)

Verrouillé Permet d'indiquer qui a le droit d'ajouter des commentaires dans la section :

• tout le monde • uniquement les éditeurs de la section et les associés du site (utilisateurs ayant les

pleins pouvoir sur le site)

Les visiteurs non connectés qui veulent ajouter un commentaire sont routés, au préalable, vers une page leur demandant soit de se connecter avec leur compte, soit de s'enregistrer, afin de pouvoir contribuer aux commentaires.

Date d'activation Permet de fixer la date et l'heure à partir desquelles la section sera visible et accessible à tous :

Date d'expiration Permet de fixer la date et l'heure à partir desquelles la section ne sera plus visible par tous (mais uniquement aux membres connectés autorisés comme ses éditeurs par exemple).

Plus d'options

Famille Permet d'associer la section à une famille de section :

La famille associée est affichée juste au dessus du titre de la section :

Les familles permettent de catégoriser les sections dans les présentations de sous-sections sous forme de forums :

Titre compact Lorsque le titre de la section est long, permet de définir un titre plus court :

Ce titre plus court est utilisé dans les listes :

Ainsi que dans le menu contextuel :

Langage Permet de préciser la langue dans laquelle est rédigé la section :

Cette information est reprise dans le code de la page HTML générée afin de pouvoir être exploitée par les moteurs de recherche :

Meta-information Permet de définir des lignes additionnelles à insérer entre les balises <head> de la page HTML générée.

Résultat dans le code de la page :

Adresse web de la vignette Adresse url de l'image servant de vignette à la page.

Le lien Ajouter une image permet de charger une image qui servira de vignette. La vignette de la section est l'image (de taille réduite) qui est associée au titre et à l'introduction la section lorsque celle-ci apparaît dans une liste :

Noter que la vignette de la page peut également être définie via la gestion des images accessible sur le premier onglet Information :

Adresse web de l'icône Adresse url de l'image servant d'icône à la page :

L'icône de la section est l'image (en taille réelle) qui est automatiquement affiché en haut de la section :

L'icône d'une section est automatiquement reprise comme icône par défaut de ses sous-sections. Noter que l'icône de la page peut également être définie via la gestion des images, accessible sur le premier onglet Information puis Images :

Adresse web de la puce Adresse url de l'image servant de vignette par défaut aux articles de la section qui en seraient dépourvu :

Changer d'overlay Permet de modifier l'overlay utilisé pour construire la section en le choisissant par la liste des overlay disponibles.

Pour plus d'information, voir le chapitre sur les overlays plus loin.

Modifier la page d'accueil Pour configurer la page d'accueil, utiliser le lien Configurer dans la boite outil du panneau extra sur le côté de la page d'accueil :

Onglet Panneau principal

Article de couverture Permet d'indiquer si l'article de couverture doit être inséré dans la page d'accueil (c'est à cela que sert l'article de couverture), avec ou sans son titre :

Sections Permet de définir de quelle manière doivent apparaître les sections sur la page d'accueil :

1- Le nombre maximum de sections listées 2- Indique de lister les sections principales 3- Limite l'affichage au contenu d'une seule section dont l'identifiant est précisé 4- Indique de ne pas lister les sections 5- Mise en page de type "menu" (liste les sections dans la barre de menu) 6- Mise en page de type "Decorated" (liste décorée) :

7- Mise en page de type "Map" (deux colonnes, comme Yahoo!) :

8- Mise en page de type "Freemind" (graphique intéractif) :

9- Mise en page de type "Jive" (forum avec 5 fils de discussion par section) :

10- Mise en page de type "Yabb" (forum de discussion) :

11- Mise en page de type "Inline" (liste les sous-sections et leur contenu) :

12- Mise en page de type "Folded" (une boîte dépliable par section) :

13- Mise en page de type "Compact" (une liste compacte, comme DMOZ) :

14- Mise en page de type "Titles" (seulement les titres et les vignettes) :

15- Mise en page personnalisée

Flash Permet de lister les pages récentes dans un objet flash :

Nécessite l'installation préalable sur le serveur de l'extension PHP "Ming" (voir chapitre sur l'installation de YACS).

Boîtes gadget Permet d'indiquer si faut afficher des boîtes gadget au milieu de la page d'accueil :

Pour ajouter du contenu dans une boite gadget, aller dans la section spéciale intitulée Boîte gadget :

Créer un article dans la section spéciale Boîte gadget :

Le titre et l'introduction de l'article créé s'affiche dans une boîte sur la page d'accueil :

Pages Permet d'indiquer de quelle manière annoncer les articles récents en page d'accueil :

1- Mise en page de type "daily" (pour les weblogs et les blogmarks : les articles s'affichent avec leur contenu intégral et des liens permettant de commenter) :

2- Mise en page de type "newspaper" (pour mettre en avant le dernier article, suivi des

trois articles précédents) :

3- Mise en page de type "boxesandarrows" (pour mettre en avant les deux articles les plus récents, puis lister les articles précédents) :

4- Mise en page de type "slashdot" (pour lister les pages récentes de la même façon) :

5- Mise en page de type "digg" (liste des pages élues par les membres de la communauté

avec un lien permettant de voter directement) :

6- Mise en page de type "decorated" (liste décorée des pages les plus récentes. Cette mise en page convient aux sites avec un article de couverture assez long en page d'accueil) :

7- Mise en page de type "compact" (liste compacte des articles les plus récents. Cette

mise en page convient aux pages d'accueil avec beaucoup de composants : boîtes gadgets, ...) :

8- Mise en page de type "alistapart" (affiche seulement la page la plus récente, et un

menu pour accéder aux pages précédentes. Cette mise en page convient aux sites avec un petit nombre de publications) :

9- Mise en page personnalisée 10- Ne pas annoncer les articles récents en page d'accueil 11- Permet de modifier le nombre maximum d'articles à annoncer en page d'accueil

Options Permet d'ajouter la liste des fichiers et/ou la liste des liens récemment ajoutés :

Onglet Panneau de côté

A la une Permet de configurer l'affichage de la liste des articles sélectionnés pour être "A la Une"

Nouvelles Permet de configurer l'affichage de la liste des articles récents dans le panneau extra sur le côté de la section.

1- Liste fixe, limitée à la quantité d'article précisée. 2- Liste animée (défilement vertical, comme sur un téléprompteur), limitée à la quantité

d'article précisée en [1]. 3- Affichage des liens vers les articles, un à la fois, les uns après les autres (comme un

slide show automatique), limitée à la quantité d'article précisée en [1].

4- Les articles des sous-sections ne sont pas remontés dans le panneau extra de la page d'accueil.

Attention. Pour que les articles remontent en tant que nouvelles, il faut : • que leur section soit configurée pour contribuer à la page d'accueil dans la zone

réservée aux nouvelles :

• que les articles soient configurés pour pouvoir s'afficher en page d'accueil :

Extra Permet de sélectionner des éléments à ajouter au panneau extra sur le côté de la page :

Page de couverture Il s'agit d'une page spéciale sur laquelle est défini le contenu "rédactionnel" destiné a être affiché sur la page d'accueil. On y accède à partir de la page d'accueil, via la boîte Outils (si l'on dispose des droits "associé" nécessaires) :

Rédiger le contenu désiré, comme pour un article classique :

La page de couverture est alors reprise sur la page d'accueil :

Organisation d'une page YACS En fonction des réglages effectués, YACS gère "tout seul" la mise en page et le remplissage de zones particulières dont voici les principales :

1- La bannière 2- Les onglets 3- Le panneau de navigation 4- Le panneau extra 5- Le contenu principal 6- Le panneau gadget 7- Le contenu additionnel 8- Le cartouche d'info sur la page

La bannière Il s'agit d'une bannière statique qui s'affiche de la même manière sur toutes les pages du site :

Pour modifier son contenu, aller dans http://localhost/skins/configure.php (ou Panneau de contrôle > Configuration > Fabrication des pages > Méta-information) :

Les onglets de menu Lorsque le thème utilisé (skin) prévoit d'afficher les onglets de menu, ceux-ci sont automatiquement créés pour pointer vers les sections dont la section parente est Niveau de base. Pour qu'une section de niveau de base n'apparaisse pas dans les onglets, modifier la section pour qu'elle soit listée avec les sections spéciales et n'apparaisse pas en zone principale :

Le panneau de navigation Il s'agit d'une zone apparaissant sur toutes les pages du site, positionnée habituellement dans une colonne latérale (à gauche dans notre exemple). Cette zone peut contenir plusieurs composants (des "boîtes" prédéfinies) :

1- Le menu du site 2- Le menu utilisateur 3- Les boîtes de navigation 4- Le panneau extra

Paramétrage du panneau de navigation Le choix des composants à afficher se fait en se rendant sur la page http://localhost/skins/configure.php ou via le panneau de contrôle :

Il suffit alors d'indiquer les mots-clés correspondants aux composant souhaités (séparés par un espace), dans l'ordre d'apparition voulu dans le panneau de navigation. Pour mémoire, la liste des mots-clés possible est rappelée sous la zone de saisie des composants.

Sur cette même page de configuration, on peut également préciser le nombre maximum de boîtes de navigation à afficher dans le panneau de navigation (le panneau extra pouvant contenir un nombre important de boites) :

Les composants du panneau de navigation

La boîte menu Ce composant (mot-clé : menu) fourni une zone de saisie libre afin de lancer une recherche des mots saisis à travers les contenus du site. On trouve ensuite une liste de lien vers certaines pages du site qui deviennent, ainsi, facilement accessibles via ce petit menu présent sur toutes les pages.

La boîte user Ce composant (mot-clé : user) présente 2 visages différents, en fonction du contexte. Si le visiteur s'est connecté avec son compte et son mot de passe, le composant affiche son nom suivi d'une liste de liens utiles :

1- un accès à la fiche personnelle de l'utilisateur connecté 2- une synthèse récapitulative des pages en attente de

publication (uniquement si l'utilisateur connecté joue un rôle lui permettant de publier des pages en attente)

3- un accès au panneau de contrôle du site (uniquement si l'utilisateur connecté joue un rôle lui permettant de contrôler et administrer le site)

4- le moyen de se déconnecter Si le visiteur n'est pas connecté, le composant affiche :

1- Les champs à renseigner afin de se connecter avec son compte et son mot de passe

2- Un lien permettant de s'enregistrer sur le site afin d'avoir un compte et un mot de passe pour pourvoir s'identifier et se connecter

3- Un lien utile en cas de mot de passe oublié

Le panneau extra (du panneau de navigation) Ce composant du panneau de navigation (mot-clé : extra) permet d'afficher le contenu du panneau extra dans le panneau de navigation (voir plus loin la présentation du panneau extra). C'est une manière de regrouper toutes les boites dans un seul panneau à afficher.

Les boîtes de navigation Ce composant (mot-clé : navigation) permet d'ajouter, dans le panneau de navigation, une liste de lien vers des pages particulières (par exemple, une page "A propos"). Ces pages particulières sont celles qui ont été ajoutées à la page "Boîtes de navigation". Pour accéder à cette dernière, il faut passer par la carte du site en étant connecté avec un compte ayant le rôle d'associé afin de visualiser les sections spéciales, masquées aux autres utilisateurs, et parmi lesquelles figure la page "Boîtes de navigation".

Le panneau extra A l'instar du panneau de navigation, le panneau extra est une zone apparaissant sur toutes les pages du site, positionnée habituellement dans une colonne latérale (à droite dans notre exemple). Cette zone peut contenir plusieurs composants (des "boîtes" prédéfinies) :

1- Profil de l'utilisateur 2- Outils 3- Nouvelles (news) 4- Données de l'overlay 5- Boîtes extra 6- Commandes de partage de page 7- Commandes pour rester informé 8- Pages ayant le même nom 9- Suivant et précédent 10- Sections environnantes 11- Catégorisation 12- Liens pour contribuer 13- Serveurs de nouvelles 14- Carte Freemind 15- Liens vers cette page 16- Pages visitées

Paramétrage du panneau extra Le choix des composants à afficher se fait en se rendant sur la page http://localhost/skins/configure.php ou via le panneau de contrôle :

Après avoir sélectionné l'onglet Composants, il suffit d'indiquer les mots-clés correspondants aux composant souhaités (séparés par un espace), dans l'ordre d'apparition voulu dans le panneau extra. Pour mémoire, la liste des mots-clés possible est rappelée sous la zone de saisie des composants.

Sur cette même page de configuration, on peut également préciser le nombre maximum de boîtes extra à afficher dans le panneau extra :

Les composants du panneau extra

profile Ce composant permet d'afficher le profil de l'auteur. Il affiche alors :

• le surnom du membre qui a posté le billet (c'est-à-dire, celui qui a créé la page) • son image "avatar" si elle est définie • la date de création du billet

tools Ce composant liste les actions réalisables sur la page en cours de consultation. La composition de cette liste d'action dépend :

• du visiteur en cours, identifié ou pas, et de ses droits sur cette page.

• du type de page (page d'accueil, article, blog, etc.) Par exemple, pour une page de type "section", voici le contenu de la boite "outils" vu par un membre connecté ayant tous les droits (6 actions possibles sur la page) :

Pour cette même page, voici le contenu de la boite "outils" vu par un autre membre connecté, sans pouvoir particulier (2 actions possibles sur la page):

Enfin, si c'est un visiteur non connecté qui affiche cette même page, la boite "outils" sera invisible car le visiteur non identifié n'a aucune action autorisée sur cette page.

news Ce composant affiche les articles récents des sections inférieures :

overlay A compléter… (Je suppose que ce composant permet d'afficher un contenu "extra" généré par l'overlay utilisé pour la page ou la section).

boxes Ce composant permet d'ajouter facilement des boites extra personnalisées mais uniquement sur la page d'accueil et sur les pages de type "section". Voici un exemple de boite extra ajoutée sur la page d'accueil :

Ces boites personnalisées correspondent au contenu des pages qui sont ajoutées à la section spéciale "Boite extra" associé à la page d'accueil ou à la page "section" concernée. Pour disposer des liens vers les sections "Boite extra", il faut être un membre connecté disposant des droits nécessaires sur la page d'accueil ou sur la page de section concernée.

Share Ce composant permet d'ajouter des liens pour référencer ou imprimer la page :

channels Ce composant permet d'ajouter des liens concernant la syndication et la surveillance de page, afin de pouvoir rester informé des nouveautés :

En cliquant sur Surveiller, le membre connecté recevra un email pour le prévenir de chaque nouvel article ou commentaire ajouté à la page concernée.

Twins

Ce composant permet de lister les pages ayant le même nom, s'il y en a :

neighbours Ce composant permet d'afficher des liens vers l'article suivant et précédent (dans la liste des articles de la section concernée) :

contextual Ce composant permet d'afficher des liens vers :

• la section mère (supérieure) • les sections "sœurs" (de même niveau) • les sections "filles" (inférieurs)

categories Ce composant affiche des liens permettant d'associer la page à une catégorie (réservé aux associés) et d'accéder à certaines catégories (semaine et mois en cours). Pour une page article :

Pour une page section :

bookmarklets Affiche un lien permettant de contribuer via la création d'une nouvelle page :

servers Serveurs de nouvelles, pour les associés.

download Permet de télécharger le contenu de la section sous forme de carte mentale Freemind (fichier d'extension .mm).

referrals Liens vers cette page, si présents.

Visited Permet d'afficher la liste des dernières pages visitées par l'utilisateur :

Divers

Overlay Les overlays permettent d'adapter la structure des pages pour accueillir des contenus particuliers (fiche de contact, recette de cuisine, pétition, sondage,…). La liste des overlays correspond aux fichiers php du dossier /overlay :

Chaque fichier overlay contient les fonctions qui permettent de gérer le paramétrage et l'affichage de l'article.

Etiquettes Voilà comment fonctionne le système des étiquettes. L'éditeur d'une page saisi librement des mots-clés servant à étiqueter sa page, en les séparant par des virgules :

Les étiquettes d'une page sont visibles en bas de la page, en dessous de la zone de

commentaire : Utiliser le menu du panneau de navigation pour accéder à la section des catégories :

La page de section des catégories contient une sous-section Mots-clés regroupant les sous-sections correspondant à chaque mot-clé :

Aller sur la page d'un mot-clé pour lister toutes les pages associées à ce mot-clé :

Lorsqu'un article est présenté en page d'accueil, ses mots-clés sont également listés (les 3 premiers, par ordre alphabétique). On accède à la page du mot clé en cliquant dessus.

Référencer cette page Un lien propose parfois de référencer la page en cours. Cette possibilité permet d'obtenir le code qui permettra de faire un lien vers cette page dans une autre page du site YACS ou sur d'autres sites Une page propose alors le code pré formaté, à insérer :

1- A l'intérieur d'un contenu rédigé dans YACS 2- En lien hypertexte dans une page HTML 3- Comme adresse Web (url) pour accéder à la page à partir d'un navigateur

Un mécanisme de trackback permet aux auteurs des sites ayant mis un lien vers votre page d'obtenir, en échange, un lien vers la page de leur site qui cite la votre.

yacs pour les nuls

Documents