Un total de 126 pages ont été trouvées avec le mot clé documentation.

{{abonnement}}


  • Comportements
proposer une fenètre permettant de s'inscrire à une liste de discussion / diffusion

syntaxe minimale : {{abonnement mail="lolo@loo.lol"}}
syntaxe complexe : {{abonnement mailinglist="ezmlm" mail="lolo@loo.lol" template="subscribe-form.tpl.html" class="center"}}

Paramètres utilisables
  • les paramètres en gras sont obligatoires
  • un paramètre se déclare de la manière suivante nomduparametre="valeurduparametre"
nom du paramètre valeurs du paramètre
mailinglist indique si on travaille avec le logiciel ezmlm ou sympa pour la mailing list. Ceci permet de gérer les mails de confirmation envoyés par ezmlm ou sympa correctement
mail l'adresse d'abonnement à la liste, généralement de type subscribe_lolo@lolo.lol (sur ezmlm) sinon le nom de la liste sur framalistes
template permet d'appeler un template sinon par défaut subscribe-form.tpl.html
class pull-left / pull-right

Cette action donne :
Pour une liste sous ezmlm
{{abonnement mail="toto@mondomaine.be" mailinglist="ezmlm"}}

Pour une liste sous sympa (commes chez www.framalistes.org)
{{abonnement mail="toto@framalistes.org" mailinglist="sympa"}}

Accordéon

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut
accordeon_image_accordeon_accordeon.png
Présentation rapide Affiche sous forme de fiches à déplier/plier
Informations importantes à propos de ce template C'est l'affichage par défaut.
Lien vers un wiki où le template est visible http://yeswiki.net/cercopitheque/demo/?ListeAccordeon
Lien vers le wiki démo où le template est visible http://yeswiki.net/cercopitheque/demo/?ListeAccordeon
Code source du formulaire qui a servi pour cet exemple
texte***bf_titre***Prénom et nom***60***255*** *** *** ***1***0***
image***bf_image***Image de présentation (facultatif mais c'est plus sympa)***140***140***600***600***right*** *** ***
texte***bf_fonction***Mon métier, ma fonction***60***255*** *** *** ***0***0***
textelong***bf_description***Mes lieux d'investissement pro ou perso***5***5*** *** ***wiki *** 
textelong***bf_projet***Mon projet***5***5*** *** ***wiki *** 
texte***bf_tel***Téléphone pro (ou perso)***10***20*** *** *** *** ***0
champs_mail***bf_mail***Email (n'apparaitra pas sur le web)***60***255*** ***form*** ***1***0***
texte***bf_structure***Nom de la structure***60***255*** *** *** ***0***0***
lien_internet***bf_site_internet***Site Internet***40***255***http://*** *** ***0***0
texte***bf_adresse***Adresse***50***50*** *** *** ***0***0
texte***bf_code_postal***Code postal***8***8*** *** *** *** ***0
texte***bf_ville***Ville***50***80*** *** *** *** ***0
labelhtml***<span style="color:#cc3333;">Il faut maintenant cliquer sur le bouton bleu pour placer votre point sur la carte </span><br>*** ***
carte_google***bf_latitude***bf_longitude***cartogoogle***
labelhtml***<h3>Il ne vous reste plus qu'à valider ! </h3>*** ****** *** *** *** *** *** *** ***@admins
Mot clés

{{accordion}} et {{panel}}

démo de l'action
Description a saisir
Comportements
Sert a masquer une ou plusieurs parties de la page

syntaxe minimale :
{{accordion}}
{{panel title="Titre de la section 1"}}
texte a masquer
{{end elem="panel"}}
{{panel title="Titre de la section 2"}}
texte a masquer
{{end elem="panel"}}
...
{{end elem="accordion"}}

Paramètres utilisables
  • les paramètres en gras sont obligatoires
  • un paramètre se déclare de la manière suivante nomduparametre="valeurduparametre"
nom du paramètre valeurs du paramètre
title Titre qui apparaît et sur lequel il faut cliquer pour faire apparaître le texte masqué
class détermine la couleur dominante du titre et du panel : "panel-success" pour du vert ; "panel-info" pour du bleu ; "panel-warning" pour du orange ; "panel-danger" pour du rouge

Action {{bazarcarto}}

Cette action permet d'afficher le contenu d'une base de données (on parlera de fiches) sur un fond cartographique. Il faut bien entendu que ces fiches comportent une adresse postale !
Exemple de code pour mettre en couleur ou en icones :
  • colorfield="listeListetype"
  • color="orange = 1, green = 2, red= 3, blue= 4, purple = 5"
  • iconfield="listeListetype"
  • icon="graine-d-oasis = 1, oasis-ressource = 2, oasis-de-vie = 3, ecosite-sacre = 4"


image affichage_carto1.png (0.4MB)
image Capture_decran_20160405_a_095424.png (0.4MB)

Affiche cartographique multicouches
  • Affichage multicouches sur une carto Bazar. Où comment afficher potentiellement sur une carte : un fond de carte Openstreetmap + des données statiques Geojson + des tuiles dynamiques + bien sûr vos données de formulaire

Sur les yeswikis récents, utilisez cette syntaxe :
{{bazarliste id="" template="map.tpl.html" provider="OpenStreetMap" lat="" lon="" zoom=""  width="" height="" query=""}}


Syntaxe obsolète
{{bazarcarto id="" lat="" lon="" zoom=""  width="" height="" query=""}}


Paramètres utilisables
  • les paramètres en gras sont obligatoires
  • un paramètre se déclare de la manière suivante nomduparametre="valeurduparametre"
  • Des paramètres supplémentaires pour le filtrage : voir BazarFacette
nom du paramètre valeurs du paramètre
id id de la base de données à afficher, si vide toutes les bases de données sont affichées. Il est possible d'afficher sur une même carte plusieurs bases de données spécifiques en entrant leur id séparé par une virgule
query permet de n'afficher qu'une partie de la base de données en fonction d'un tri sur un champ voir la doc query
colorfield Définis le champ (souvent une liste) qui détermine la couleur du point. Par exemple colorfield="checkboxListeImaginaire" signifie qu'on va trier sur la base de la liste Listeimaginaire, et que cette liste est utilisé en tant que checkbox (cases à cocher) dans le formulaire. Pour une liste utilisée en tant que liste déroulante, on aurait écrit colorfield="listeListeImaginaire". Pour une carte qui affiche les résultats de plusieurs formulaires, il faut indiquer colorfield="id_typeannonce"
color fait la corrélation entre la valeur du champ et la couleur associée ex : color="darkgreen=Dir, pink=Secr" ... Attention : nombre de couleurs limitées pour carto ('red', 'darkred', 'lightred', 'orange', 'beige', 'green', 'darkgreen', 'lightgreen', 'blue', 'darkblue', 'lightblue', 'purple', 'darkpurple', 'pink', 'cadetblue', 'white', 'gray', 'lightgray', 'black') pour les agendas et les listes, possibilité d'utiliser les code hexadécimaux.
iconfield Définis le champ (souvent une liste) qui détermine l'icône du point.
icon Soit le nom de l'icône (ex: icon="glyphicon glyphicon-envelope") (voir la liste sur https://getbootstrap.com/docs/3.3/components/ ), soit utilise le paramètre "iconfield" pour faire la corrélation entre la valeur du champ et l'icône (ex : icon="plane=Dir, pencil=Secr")
smallmarker par défaut sur 0 si 1 met des petits marqueurs sur la carte plutôt que les gros
barregestion "true" or "false" : si présent (defaut), ajout des liens vers la gestion de la fiche
lat Permet de préciser la latitude du point central de la carte affichée. Par défaut la carte est centrée sur le centre du monde.
lon Permet de préciser la longitude du point central de la carte affichée. Par défaut la carte est centrée sur le centre du monde.
zoom Permet de préciser le niveau de zoom : de 1 (plus éloigné) à 15 (plus proche), par défaut : 8.
width Permet de préciser la largeur de la carte affichée, exemple : 600px pour une largeur de 600 pixels.
height Permet de préciser la hauteur de la carte affichée, exemple : 400px pour une hauteur de 400 pixels.
spider Permet d'éclater un regroupement de points lorsque l'on clique dessus. true ou false (false par défaut)
cluster Regroupe les points par zone. true ou false (False par défaut)
navigation "true" (par défaut) ou "false". Fait apparaître le contrôle du zoom avec les 2 boutons + et -
zoommolette "true" or "false"
provider Le nom du fournisseur de fond de carte. ex: "OpenStreetMap", "OpenStreetMap.France", "OpenStreetMap.BlackAndWhite", "OpenTopoMap", "Thunderforest", "Thunderforest.Landscape", "Thunderforest.SpinalMap". La liste des providers
typecarto obsolète Type de carto google utilisé : ROADMAP ou SATELLITE ou HYBRID ou TERRAIN (TERRAIN par defaut).
stylenavigation obsolète "SMALL" ou "ZOOM_PAN" ou "ANDROID" ou "DEFAULT"
layercarto obsolète Permet de préciser le fond carto utilisé. layercarto="google" : fond google / layercarto="osm" : fond OpenStreetMap (défaut).
choixcarte obsolète "true" ou "false"
stylechoixcarte obsolète "HORIZONTAL_BAR" ou "DROPDOWN_MENU" ou "DEFAULT"
echelle obsolète "true" or "false"

Action bazarcartocoul


Cette page est obsolète, consultez la documentation de l'action "ActionBazarcarto".

Cette action permet d'afficher des fiches sur un fond cartographique avec des couleurs différentes en fonction d'une liste. Voir un exemple en suivant ce lien

Syntaxe
{{bazarcartocoul id="" lat="" lon="" zoom=""  typecarto="" width="" height="" champcoul="" query=""}}


Paramètres utilisables
  • les paramètres en gras sont obligatoires
  • un paramètre se déclare de la manière suivante nomduparametre="valeurduparametre"
nom du paramètre valeurs du paramètre
id id de la base de données à afficher, si vide toutes les bases de données sont affichées. Il est possible d'afficher sur une même carte plusieurs bases de données spécifiques en entrant leur id séparé par une virgule
lat Permet de préciser la latitude du point central de la carte affichée. Par défaut la carte est centrée sur le centre du monde.
lon Permet de préciser la longitude du point central de la carte affichée. Par défaut la carte est centrée sur le centre du monde.
zoom Permet de préciser le niveau de zoom : de 1 (plus éloigné) à 15 (plus proche), par défaut : 8.
typecarto Type de carto google utilisé : ROADMAP ou SATELLITE ou HYBRID ou TERRAIN (TERRAIN par defaut).
width Permet de préciser la largeur de la carte affichée, exemple : 600px pour une largeur de 600 pixels.
height Permet de préciser la hauteur de la carte affichée, exemple : 400px pour une hauteur de 400 pixels.
spider Permet d'éclater un regroupement de points lorsque l'on clique dessus. True ou False (false par défaut)
layercarto Permet de préciser le fond carto utilisé. layercarto="google" : fond google / layercarto="osm" : fond OpenStreetMap (défaut).
champcoul Définis la liste qui détermine la couleur du point. (Par défaut 'ListeCouleur')
query permet de n'afficher qu'une partie de la base de données en fonction d'un tri sur un champ voir la doc query


Questions pour Florian

je vois dans carte oasis ces paramètres
  • colorfield="listeListetype"
    • je suppose que c'est champcoul ?? faut mettre colorfield ou champcoul ??
  • color="orange = 1, green = 2, red= 3, blue= 4, purple = 5"
    • ce champ est nécessaire du coup ou pas ?
  • iconfield="listeListetype"
    • on peut l'indiquer dans la doc ou spécifique à oasis ?
  • icon="graine-d-oasis = 1, oasis-ressource = 2, oasis-de-vie = 3, ecosite-sacre = 4"
    • on peut l'indiquer dans la doc ou spécifique à oasis ? et si oui c'est quoi le fonctionnement ?

j'ai aussi retrouvé ça ailleurs dans la doc....
iconprefix => prefixe des classes CSS utilisées pour icones dans les marqueurs de la carte ex fa fa- ou glyphicon glyphicon-
iconfield => désigne le champ utilisé pour les icones des marqueurs ex : checkboxListeProf
icon => fait la corélation entre la valeur du champ et l'icone associée ex : markericon="plane=Dir, pencil=Secr"
colorfield => désigne le champ utilisé pour les couleurs des marqueurs ex : checkboxListeProf
color => fait la corélation entre la valeur du champ et la couleur associée ex : markercolor="darkgreen=Dir, pink=Secr" (nombre de couleurs limitées pour carto ('red', 'darkred', 'lightred', 'orange', 'beige', 'green', 'darkgreen', 'lightgreen', 'blue', 'darkblue', 'lightblue', 'purple', 'darkpurple', 'pink', 'cadetblue', 'white', 'gray', 'lightgray', 'black') pour les agenda et liste, possibilité d'utiliser les code hexa
smallmarker => pour bazarcarto par défaut sur 0 si 1 met des petits marqueurs sur la carte plutôt que les gros

Action {{bazarliste}}

Cette action vous permet d'affiche le contenu d'une base de données (ou seulement une partie) sur une des pages du wiki et cela sous différentes formes suivant le template choisi (simple liste, liste déroulante, annuaire, liens...)

Syntaxe : {{bazarliste id="1"}}

Paramètres utilisables
  • les paramètres en gras sont obligatoires
  • un paramètre se déclare de la manière suivante nomduparametre="valeurduparametre"
  • Des paramètres supplémentaires pour le filtrage : voir BazarFacette
nom du paramètre valeurs du paramètre
id id de la base de données à afficher, si vide toutes les bases de données sont affichées. Il est possible d'afficher sur une même carte plusieurs bases de données spécifiques en entrant leur id séparé par une virgule. Avant, le paramètre s'appelait idtypeannonce qui marche encore, mais id, plus court, est recommandé.
categorienature Permet de filtrer des fiches par catégorie, par défaut toutes les catégories sont traités. c'est le nom de la Catégorie du formulaire
nb Indique le nombre limite de résultats a afficher, par ex. nb="12" pour afficher les 12 derniers. Par défaut : pas de limite
pagination Indique le nombre de fiches présentes par page avant pagination, par ex pagination="10". Par défaut : pas de pagination
ordre Permet d'afficher la liste par ordre croissant ou décroissant. Par défaut : rangé par ordre croissant (asc) sinon mettre "desc" pour l'ordre décroissant
champ Permet de choisir le champ utilisé pour le tri. Par défaut : tri sur le champ titre (bf_titre). Par date par ex : champ="date_creation_fiche" ou date_maj_fiche
query permet d'afficher une partie seulement de la base de données sur base d'un tri Voir le détail de la syntaxe
template Indique le look pour l'affichage des fiches. Par défaut : en accordéon. voir ci-dessous pour un aperçu des templates disponibles
iconfield On indique soit la liste, soit idtypeannonce qui doit servir à déterminer les différentes icons
icon Nom de l'icon (par ex glyphicon glyphicon-plane)="valeur de la liste ou id du formulaire"
colorfield On indique soit la liste, soit idtypeannonce qui doit déterminer les différentes couleurs
color Nom de la couleur (par ex red ou #ff3333)="valeur de la liste ou id du formulaire"
colorfield="id_typeannonce" color="green=28, blue=29, red=30, #ffffff=28"
redirecturl permet de rediriger sur une page voulue lors de la validation du formulaire redirecturl="une url complète (pas juste une page wiki)"

A savoir : appeler sur son wiki les fiches d'un autre wiki

{{bazarlisteexterne id="" url="urlduwiki"}}


Les templates disponibles sous yeswiki

ATTENTION: certains ne sont pas fourni par défaut avec yeswiki et doivent être téléchargés

20 fiches trouvées
Fourni par défaut ou pas
Accordéon

Accordéon

Affiche sous forme de fiches à déplier/plier

annuaire_alphabetique.tpl.html

annuaire_alphabetique.tpl.html

permet de créer une liste de type annuaire classée par ordre alphabétique

blog.tpl.html

blog.tpl.html

Le template blog permet d'afficher des actualités :
- dernier aticle mis en avant
- affiche la date et l'auteur del'article sous le titre
- le résumé affiché est un champ "bf_chapo" - car on ne voulait pas avoir une description tronquée

carousel.tpl.html

carousel.tpl.html

Ce template permet de faire un slider pour faire défiler des images automatiquement. Souvent utiliser en pageheader.
Tous les champs sont cachés si pas remplis sauf image bien sûr et bf_titre (champ obligatoire)
Cela dit on peut cacher aussi le bf_titre via un paramètre (voir ci-dessous)

compteur.tpl.html

compteur.tpl.html

ce template permet d'afficher la somme du champ bf_nombre

damier.tpl.html

damier.tpl.html

Affiche toutes les fiches d'un formulaire sur la même page sous la forme d'un damier de cases alternativement blanches et de couleur (la couleur est définie par le paramètre couleur).
L'affichage des fiches peut être
précédé de texte (contenu dans une page appelée via le paramètre pageDessus),
et/ou suivi de texte (contenu dans une page appelée via le paramètre pageDessous).
Pour chaque fiche sont affichés les champs :

  • bf_titre
  • bf_debut
  • bf_fin
  • bf_lieu
  • bf_image
  • bf_description
Et un bouton, permet de pointer vers l'adresse contenue dans bf_lien.
Le libellé du bouton provient du champ bf_bouton. Le bouton renvoie,
  • soit vers l'adresse contenue dans le champ bf_lien s'il est renseigné,
  • si bf_lien est vide, le bouton permet de télécharger le fichier indiqué par bf_fichier.
Si, ni lien, ni fichier ne sont renseignés, aucun bouton ne s'affiche.
Certaines fiches peuvent être mises en exergue. On utilise pour cela la valeur du champ bf_exergue. Les fiches mises en exergue seront celles dont ce champ porte la valeur précisée par le paramètre valeurexergue.

galerie_photos.tpl.html

galerie_photos.tpl.html

ce template permet d'afficher une galerie de photos "classique" en 6 colonnes avec la photo et le titre par dessous.

liste_fiches_horscarte.tpl.html

liste_fiches_horscarte.tpl.html

ce template permet de récupérer sour forme de liste les titres des fiches (avec une carte cartogoogle) pour lesquelles les utilisateurs ont oubliés de cliquer sur le bouton "placer le point sur la carte".

liste_galerie.tpl.html

liste_galerie.tpl.html

Ce template permet d'afficher une galerie photo en deux colonnes. Celle de gauche reprend en mini vignettes toutes les photos disponibles et sur celle de droite, une vue agrandie de la photo sélectionnée dans la partie gauche.

liste_liens.tpl.html

liste_liens.tpl.html

affiche les liens vers les fiches sous forme de liste à puces

liste_liens_date.tpl.html

liste_liens_date.tpl.html

affiche une liste de liens pointant vers les fiches

liste_mails_seuls.tpl.html

liste_mails_seuls.tpl.html

Ce template permet de récupérer sour forme de liste les emails d'un formulaire afin de pouvoir facilement les copier-coller dans un webmail.

mails_maj.tpl.html

mails_maj.tpl.html

Ce template affiche les fiches non mises à jour depuis x jours (180 par défaut, paramètre : nbjour="x") et d'envoyer un mail paramétrable aux contacts des fiches.

map.tpl.html

map.tpl.html

Cette action permet d'afficher le contenu d'une base de données (on parlera de fiches) sur un fond cartographique. Il faut bien entendu que ces fiches comportent une adresse postale !

material-card.tpl.html

material-card.tpl.html

présentation sous forme de vignettes graphiques souvent utilisées pour réaliser des annuaires visuels (si l'image n'est pas fournie une image par défaut est générée)

photo-oxygen.tpl.html

photo-oxygen.tpl.html

Galerie photo avec un joli effet zoom et rotation au survol de l'image
L'auteur est affiché au survol ainsi qu'une loupe pour affichage plein écran

photobox.tpl.html

photobox.tpl.html

permet de créer une sorte de galerie photos qui peut s'ouvrir en pleine page

semi-ouvert.tpl.html

semi-ouvert.tpl.html

ce template affiche sous forme de liste des "blocs" le contenu du formulaire avec une image à gauche et des champs (bf-titre et ... ) à droite + télécharger fichier, lien vers url et bouton en savoir plus pour ouvrir la fiche complètement (tous les champs de ce template sont cachés s'ils ne contiennent pas de données / ou image par défaut).

timeline.tpl.html

timeline.tpl.html

affiche les fiches sous forme de ligne du temps

trombinoscope.tpl.html

trombinoscope.tpl.html

affiche uniquement les fiches qui ont une image sous forme de bloc. Il est donc parfois nécessaire de rendre le champ image obligatoire sinon certaines fiches n'apparaitront pas.

Selon sa propre mise en page (avancé)

Doc en cours d'écriture

Il est possible de faire des templates spécifiques pour chaque formulaire et ainsi faire apparaître selon votre propre mise en page les infos contenues (ou une partie seulement) dans ces formulaires.

Pour ce faire il faut créer un fichier nommé fiche-id.tpl.html et le placer dans /themes/tools/bazar/templates (ID étant ici l'id du formulaire en question)
ATTENTION, ce faisant toutes les fiches possedant cet ID de formulaire seront avec le look personnalisé plutot que le look proposé par défaut... pour pouvoir réutiliser les templates, il faut enlever fiche-id.tpl.html (ou le renommer avec un .old)

Il vous reste ensuite à éditer ce fichier et à construire votre mise en page. (code html / css...)

La syntaxe est la suivante :

vous pouvez utiliser
<h2><?php echo $fiche['bf_titre']; ?></h2>
ici la mise en page se fait avec les balises html et un echo classique

<?php show($fiche["bf_champ"], â??Label du champs', 'classe CSS du paragraphe', â??balise HTML du paragraphe'); ?>
Les 3 champs sont facultatifs.
  • show($fiche : valeur brute telle qu'on la voit avec /raw (par ex si c'est une liste, il va chercher la valeur et pas ce qu'on voit nécessairement à l'écran)
  • un exemple : <?php show($fiche["bf_nomduchamp"], '', '', 'h5'); ?>

show($html["bf_champ"], â??Label du champs', 'classe CSS du paragraphe', â??balise HTML du paragraphe'); ?>
- show($html = montre la valeur contenue dans le champ mise en forme
  • exemple = <?php show($fiche["bf_telephone1"] . ' / ' . $fiche["bf_telephone2"], 'Téléphone(s) :'); ?>
  • principalement utilisé pour afficher le contenu de liste ou checkbox (<?php show($html["checkboxListeTheme"], '', ''); ?>)

Il est aussi possible d'affiche le contenu de formulaires liés

Il est possible d'appeler des formulaires liés en utilisant cette syntaxe
<?php echo $GLOBALS['wiki']->Format(
    '{{bazarliste idtypeannonce=«ID du formulaire lié" query=« listeficheID du formulaire de départ=' . $fiche['id_fiche'] . â??«  template="nom du template"}}'
); ?>

par exemple :
<?php echo $GLOBALS['wiki']->Format(
        '{{bazarliste idtypeannonce="6" query="listefiche7=' . $fiche['id_fiche'] . '"}}'
    ); ?>

  • Attention parfois c'est listefiche parfois checkboxfiche
  • Attention, il faut bien que les deux formulaires bazar soient bien liés.
  • Si les deux formulaires ne sont pas liés clairement (ou uniquement dans un sens), il faut alors aller voir dans /raw et voir comment le champ est renommé par yeswiki. Ce sera listeficheid ou checkboxficheid et utiliser la syntaxe : <?php show($html["checkboxfiche2"]); ?>

un 1er exemple complet

<?php
$imgwidth = 320;
$imgheight = 240;
?>
<?php
if ($_GET['wiki'] == $fiche['id_fiche']): ?>
    <h3>
    <a href="wakka.php?wiki=AnnuaireS">Répertoire des structures
    </a> </h3>
    <?php
endif; ?>
<?php
if (isset($fiche['imagebf_image']) && $fiche['imagebf_image'] != ''): ?>
    <img class="pull-left img-rounded img-profil" style="margin-right:20px;margin-bottom:20px;" alt="<?php
        echo htmlentities($fiche['bf_titre']); ?>" src="<?php
        echo redimensionner_image(
            'files/' . $fiche['imagebf_image'],
            'cache/image_' . $imgwidth . 'x' . $imgheight . '_' . $fiche['imagebf_image'],
            $imgwidth,
            $imgheight,
            'crop'
        ); ?>">
    <?php echo $html['imagebf_image']; ?>
    <?php
endif; ?>
<h2><?php echo $fiche['bf_titre']; ?></h2>
<?php show($fiche["bf_acronyme"], '', '', 'h5'); ?>
<?php if (!empty($fiche["bf_site_internet"] )) show('<a href="' . $fiche["bf_site_internet"] . '">' . $fiche["bf_site_internet"] . '</a>', ''); ?>
<?php show($fiche["bf_telephone1"] . ' / ' . $fiche["bf_telephone2"], 'Téléphone(s) :'); ?>
<?php show($fiche["bf_fax"], '', 'fax'); ?>
<?php show($html["bf_mail"] . ' / ' . $html['bf_mail_sec'], 'Mail(s) :'); ?>
<?php show($html["checkboxListeInfos"], 'Particularité : ', ''); ?>
<div class="clearfix"></div>
<div class="well">
  <?php echo $GLOBALS['wiki']->Format($fiche["bf_description_longue"]); ?>
</div>
<div class="row">
  <div class="col-md-6 span6">
    <h4>Centres d'intérêt</h4>
    <?php show($html["checkboxListeTheme"], '', ''); ?>
    <h4>Activités proposées</h4>
    <?php show($html["checkboxListeActivite"], '', ''); ?>
    <h4>Public cible</h4>
    <?php show($html["checkboxListePublic"], '', ''); ?>
  </div>
  <div class="col-md-6 span6">
    <h4>Matériel disponible en prêt</h4>
    <?php show($html["checkboxListeMatos"], 'Matériels de base :', ''); ?>
    <?php show($html["checkboxListeMatospro"], 'Matériels professionnel :', ''); ?>
    <?php show($html["checkboxListeInfrastructure"], 'Infrastructure :', ''); ?>
  </div> </div>
  <hr>
  <h3>Coordonnées</h3>
  <?php echo $fiche["bf_adresse"]; ?><br>
  <?php echo $fiche["bf_code_postal"]; ?> -
  <?php echo $fiche["bf_ville"]; ?><br>
  <?php show($fiche["bf_capcacite"], 'Capacité  :'); ?>
  <?php show($fiche["bf_horaire"], 'Horaire :'); ?>
  <h3>Liste des personnes liées :</h3>
  <?php echo $GLOBALS['wiki']->Format(
    '{{bazarliste idtypeannonce="6" query="listefiche7=' . $fiche['id_fiche'] . '"}}'
); ?>
<?php
 if ($fiche['checkboxListeIndic'] == '1') :   ?>
 <div class="pull-right">
  <h4>A voir aussi sur</h4>
 <A HREF="http://www.inforjeunestournai.be/" target="blank"> <img class="img-responsive" src="files/logo-wape.jpg"></A>
</div>
<?php endif; ?>
  <br>Pour éditer cette fiche, double cliquer sur cette phrase.



Autre exemple complet – Un template qui n'affiche les informations que pour les membres du groupe @admins

<?php
if($GLOBALS['wiki']->UserIsAdmin()) {
	// on recupere les valeurs de la fiche
	$fichebazar['values'] = baz_valeurs_fiche($fiche['id_fiche']);
	// on recupere les infos liees à ce type de fiche
	$f = $fichebazar['values']['id_typeannonce'];
	$fichebazar['form'] =  baz_valeurs_formulaire($f);
	// on parcourt le tableau des valeurs pour les afficher
	for ($i = 0; $i < count($fichebazar['form']['template']); ++$i) {
		if (function_exists($fichebazar['form']['template'][$i][0])) {
			echo $fichebazar['form']['template'][$i][0](
				 $formtemplate,
				 $fichebazar['form']['template'][$i],
				 'html',
				 $fichebazar['values']
			);
		}
	}
} else {
    echo 'Votre inscription est bien prise en compte, elle n\'est visible que par les admins';
}
?>
Unknown action "animation"
démo de l'action

{{animation}}

Permet de créer des sections de texte sur lequel vous pourrez appliquer des effets
Comportements
L'action {{animation}} doit être placée en haut de page pour ajouter ensuite des animations sur des parties choisies (titres, images ou texte) avec différents styles que vous pouvez découvrir sur animate.css .


Ces class peuvent s'appliquer aux éléments suivants :
  • L'action {{backgroundimage}} qui permet de mettre des images de fond ou des aplats de couleur
  • L'action {{attach}} notamment quand elle sert à insérer une image dans votre page
  • L'action {{section}} grâce à laquelle, tout élément de votre page pourra clignoter, rebondir, s'envoler...
et autres endroits où on peut mettre des champs class...

Exemple :
  1. ajoutez { {animation} } en haut de la page
  2. puis ajoutez : { {section class="wow slideInRight" data="wow-iteration=3"} }, ce qui donnera le comportement du texte "exemple" quand vous êtes arrivé
  3. la partie à animer doit être fermée par { {end elem="section"} }
Explication :
  • class="wow slideInRight" => l'effet choisi fait apparaitre le texte entre { {section} } et { {end elem="section"} } par glissement depuis la droite de l'écran
  • data="wow-iteration=3" => ici, effet slideInRight répété trois fois

pour comprendre les éléments que vous pourrez activer :
  • class="wow => puis le nom de l'effet que vous trouverez sur animate.css "
vous pourrez ensuite ajouter :
  • data="
    • wow-iteration=le nb d'itération souhaitée,
    • wow-length=la durée en seconde de l'effet (ex : 2s),
    • wow-offset=délais de l'animation quand l'élément apparaît à l'écran,
    • wow-delay=délais de l'animation quand la page est chargée en seconde"
image oiseau.png (0.2MB)

annuaire_alphabetique.tpl.html

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut
annuairealphabetiquetplhtml_capture-décran-2018-12-08-à-12.27.09.png
Présentation rapide permet de créer une liste de type annuaire classée par ordre alphabétique
Informations importantes à propos de ce template il faut au moins un bf_titre
Lien vers un wiki où le template est visible https://co-construire.be/wakka.php?wiki=InscritS
Lien vers le wiki démo où le template est visible http://yeswiki.net/cercopitheque/demo/?AnnuaireAlpha
Mot clés

{{ariane}}

Ajoute un fil d'ariane basé sur la navigation de l'internaute (affiche l'historique des ses pages consultées sous forme de fil d'ariane)
Comportements
ajoute un filtre d'ariane reprenant l'historique des pages visitées
  • permet de revenir en arrière
syntaxe minimale : {{ariane}}
syntaxe complexe : {{ariane nb="6"}}

Paramètres utilisables
  • les paramètres en gras sont obligatoires
  • un paramètre se déclare de la manière suivante nomduparametre="valeurduparametre"
nom du paramètre valeurs du paramètre
nb nb de sous menu exploré" par défaut 4

  • Attention : plutôt à placer dans le squelette de votre theme par ex juste au dessus de {WIKINI_PAGE}
Cette action donne :

Astuces pour des mises en page qui déchirent

Petit préambule : plusieurs astuces permettent de jouer très fortement sur les apparences de vos pages.
Ceci dit, si vous n'avez aucune capacité graphique, il y a de forte chance pour que votre page soit à l'image de vos compétences...


D'abord, pensez à illustrer


Les actions qu'il vous faut

  • Background image permet de créer des aplats de couleur ou des images en fond de texte.
  • Avec nav vous aurez un menu de type navigation supplémentaire au sein de votre page
  • Comme son nom l'indique button transforme vos liens en boutons multicolores auxquels vous pourrez rajouter des icônesd
  • Accordion permettra d'activer des parties de texte sous un accordéon
  • Grid et col et le colonage de votre page n'aura plus de mystère
  • Tocjs ajoutera automatiquement un sommaire qui reprendra vos titres ; ce sommaire suivra la page lors du scroll

Bootstrap quand tu nous tiens


Bootstrap est une bibliothèque qui permet de préfigurer des mises en forme, des styles

sur le site de bootstrap , il est possible de récupérer des éléments de style qui donneront des looks à toute une série de composants. Il suffit de copier le code des éléments proposés, d'ajouter deux guillemets devant et derrière et le tour est joué. Ainsi :

<div class="alert alert-danger" role="alert">joli texte entouré de rouge</div>
donne

Et là, il suffit de cliquer sur la petite croix pour supprimer ce cadre...


Et avec une pincée d'html

Un code en html entouré de deux guillemets sera interprété
<span style="color:red;">texte coloré</span>
et donnera texte coloré
Sur internet vous trouverez une foule d'exemples à copier pour améliorer vos pages

Et autres librairies

L'action {{animation}} placée en haut de votre page ou de votre site permettra de solliciter des animations que vous trouverez documentés ici (en anglais) mais aussi de jouer sur la durée, le délais, la répétition de vos animations !!! Attention le kitch n'est pas loin, à utiliser avec parcimonie et légèreté
Ces class peuvent s'appliquer aux éléments suivants :
  • L'action {{backgroundimage}} qui permet de mettre des images de fond ou des aplats de couleur
  • L'action {{attach}} notamment quand elle sert à insérer une image dans votre page
  • L'action {{ section }} grâce à laquelle, tout élément de votre page pourra clignoter, rebondir, s'envoler...
et autres endroits où on peut mettre des class...

ainsi,
class="wow slideInRight" data="wow-delay=3s, wow-iteration=3"
donnera le comportement de cette ligne...
démo de l'action

{{attach}}

Permet de lier un fichier à une page, de téléverser (uploader) ce fichier et de télécharger ce fichier.
L'usage de cette action est simplifiée par le bouton "joindre / insérer un fichier" dans la barre de menu.
Comportements
Affiche un lien de téléchargement de fichier
  • Si le fichier est une image, elle est affichée dans la page.
  • Lorsque le fichier est sur le serveur, il est possible de faire une mise à jour de celui-ci.
syntaxe minimale : {{attach file="lolo.jpg" desc="lolo"}}
syntaxe complexe : {{attach file="lolo.jpg" desc="image lolo.jpg (0.3MB)" size="medium" class="left medium" legend="le texte de la légende" link="https://yeswiki.net/wakka.php?wiki=AccueiL"}}

Paramètres utilisables
  • les paramètres en gras sont obligatoires
  • un paramètre se déclare de la manière suivante nomduparametre="valeurduparametre"
nom du paramètre valeurs du paramètre
file nom du fichier tel qu'il sera dans le wiki (attention a conserver la meme extension que pour le fichier original). pas d'url (voir {{player}})
desc Texte du lien pour télécharger le fichier ou contenu du parametre alt pour une image.
caption Uniquement pour une image, texte au survol de celle-ci.
legend Uniquement pour une image, texte en dessous de celle-ci.
link Lien vers lequel renvoie l'image
nofullimagelink Uniquement pour une image, Pas de lien pour afficher l'image en grand quand on clique dessus: nofullimagelink="1"
class Ajoute une classe CSS à la balise figure entourant l'image / lightshadow, left / right / center, whiteborder, zoom, img-rounded, mg-circle, img-thumbnail
size small, medium, large ou original. Définis la taille de l'image par rapports aux paramètres
small: largeur de 140px, hauteur de 97px ; medium: largeur de 300px, hauteur de 209px ; large: largeur de 780px, hauteur de 544
La largeur peut aussi être réglé finement grâce au paramètre "width" ci-dessous)
width Largeur de l'image en pixels. Ex: width="400"
height Hauteur de l'image en pixels. Ex: height="300"


Ouvrir le lien d'une image dans une fenêtre modale
/!\ class="modalbox" ne fonctionne pas avec les images car les classes css s'appliquent ici a l'image et non au lien
Une méthode de substitution existe via du code html : <a href="monlien.fr" class="modalbox" title="Titre de la modale">{{attach file="monimage.jpg" desc="imagetest" data-size="modal-lg" size="original" class="center" nofullimagelink="1"}} </a>

nofullimagelink="1" évite qu'il y ai un lien vers l'image en plus grand (comme on rajoute un lien par dessus, on ne peut pas avoir un lien dans un lien)

data-size="modal-lg" fait une modale plus large que celle de base

Exemple :

Mettre une image, (un bandeau) en entête ou un applat de couleur


passez votre PageHeader en mode édition, vous devez voir un code du style
{{section bgcolor="var(--neutral-color);" class="cover white text-center"}}
======Description de mon wiki======
Double cliquer ici pour changer le texte et l'image de fond.
{{end elem="section"}}

  • Pour ajouter une image au bandeau, ajouter file="bandeau.jpg" sauver, puis charger votre bandeau préalablement préparé : cette image devra avoir comme taille 1920 X 300 et 90 dpi de résolution
  • Vous souhaitez que le texte soit foncé : enlever le white dans class="white ..."
  • Vous souhaitez que le texte soit centré ou à gauche : remplacer text-right par text-center ou text-left
  • Vous souhaitez un aplat d'une autre couleur : supprimer file="bandeau.jpeg" et remplacer dans bgcolor="var(--neutral-color)" par un code couleur :

En résumé :
{{section bgcolor="#990066" class="cover text-center"}}
======Description de mon wiki======
Double cliquer ici pour changer le texte et l'image de fond.
{{end elem="section"}}

donne

Description de mon wiki

Double cliquer ici pour changer le texte et l'image de fond.
et
{{section file="bandeau.jpg" class="cover white text-center"}}
======Description de mon wiki======
Double cliquer ici pour changer le texte et l'image de fond.
{{end elem="section"}}

donne

Description de mon wiki

Double cliquer ici pour changer le texte et l'image de fond.


Une petite Bandothèque au cas où...


Pour télécharger un bandeau, cliquez dessus puis clic droit/enregistrer sous (ou pomme clic sous apple).
Pour en fabriquer, elles doivent faire 1920 X 250 px et avoir une résolution de 72 dpi.
image horizon.jpg (86.6kB)
image Puzzle.jpg (0.1MB)
image spiral.jpg (0.3MB)
image vache.jpg (90.6kB)
image vague.jpg (0.1MB)
image ville.jpg (0.2MB)
image etoile.jpg (0.2MB)
image route.jpg (0.3MB)
image citron.jpg (0.2MB)
image bois.jpg (0.2MB)
image bandeauboatseattle.png (0.2MB) CC-BY-SA NicolasGeiger
image couleur.jpg (45.7kB)
image fenetre.jpg (0.3MB)
image vitre.jpg (0.1MB)
image faience.jpg (0.4MB)
image champ.jpg (0.1MB)
image grille.jpg (0.2MB)
image homme.jpg (80.1kB)
image bandeau.jpg (0.1MB)
image foule.jpg (0.2MB)
image toto.jpeg (0.2MB)

Afficher le contenu d'une base de données

démo de l'action bazar
Il est possible d'afficher le contenu d'une base de données sous différentes formes :

Sous forme de carte

image affichage_carto1.png (0.4MB)
  • Affichage multicouches sur une carto Bazar. Où comment afficher potentiellement sur une carte : un fond de carte Openstreetmap + des données statiques Geojson + des tuiles dynamiques + bien sûr vos données de formulaire

Actions dépréciées
Veuillez utiliser l'action {{bazarcarto}}.

Sous forme de trombinoscope

image affichage_trombi1.png (0.3MB)

Avec un système de recherche (facette)

image facette.png (0.6MB)
Des paramètres supplémentaires pour le filtrage

Permettre la saisie de données dans un formulaire


image formulaire_structure1.png (38.9kB)
Voilà à quoi ressemble un formulaire (cliquez pour afficher cette image en plein écran)

Permet d'afficher un formulaire de saisie afin d'ajouter des données. La syntaxe est à placer sur la page où l'on souhaite faire apparaître le formulaire de saisie
Syntaxe minimale : {{bazar voirmenu="0" vue="saisir" id=" "}}

Paramètres utilisables
  • les paramètres en gras sont obligatoires
  • un paramètre se déclare de la manière suivante nomduparametre="valeurduparametre"
nom du paramètre valeurs du paramètre
id Id du formulaire dans lequel on souhaite ajouter des données
vue valeur à indiquer = saisir
redirecturl Page vers laquelle on souhaite renvoyer l'utilsateur lorsqu'il fait valider = une url complète
voirmenu si valeur=0 n'affiche pas le menu complet si valeur=1 affiche tout le menu / si ce paramètre n'est pas indiqué, le menu est affiché par défaut


Voilà à quoi ça ressemble (cliquez sur l'image pour la voir en plein écran) :
image formulaire_evenement1.png (40.1kB)
image formulaire_phototeque1.png (29.8kB)

Affichage cartographique multicouches


Où comment afficher potentiellement sur une carte :
  • un fond de carte Openstreetmap
  • + des données statiques Geojson
  • + des tuiles dynamiques
  • + bien sûr vos données issues de vos formulaires

Prenons l'exemple d'une association qui souhaite faire apparaitre :
  • un fond de carte Openstreetmap
  • les délimités des régions françaises (fichier GeoJson)
  • tous les itinéraires cyclables pour se rencontrer (depuis un serveur de tuiles)
  • et enfin la localisation des membres de son réseau (depuis un formulaire Bazar)

Etape 1 : fabriquer son formulaire


Etape 2 : trouver des données cartographiques

  • des serveurs de tuiles (de cartes) pour faire apparaitre des cartes dynamiques provenant d'une source distante (par exemple des serveurs de tuiles openstreetmap sur différents sujets)

  • des données au format Geojson : ce sont des données statiques que l'on peut obtenir de différentes façons : un tableur CSV avec des données lat/lon, un fichier opendata, une extraction de données openstreetmap, etc.
    • Une fois récupéré le fichier GeoJson, l'ouvrir avec un éditeur de texte.
    • Copier le code complet.
    • Coller les data GeoJson dans une page du Wiki dédiée (que vous appellerez ensuite avec le handler "/raw" comme dans l'exemple ci-après.)

Etape 3 : visualiser les résultats sur carte
  • Choisir la page ou créer une page où seront affichés les résultats.
  • Insérez l'action Bazar Carto ([ActionBazarcarto voir documentation]) en utilisant le code suivant. Exemple ici avec :
    • 1 layer tiles Waymarkedtrails un serveur qui montre les grandes voies cyclables en France
    • 1 layer geojson avec contours de certaines régions de France (issu de OSM boundaries) copié/collé dans la page BacASableGeoJson1

{{Bazarcarto layers="Waymarkedtrails|Tiles|https://tile.waymarkedtrails.org/cycling/{z}/{x}/{y}.png,Régions|GeoJson|wakka.php?wiki=BacASableGeoJson1/raw" }}




  • * "layers" : une liste de layers (couches).
Pour comprendre les termes du code :
  • * format pour chaque layer : NOM|TYPE|URL ou NOM|TYPE|OPTIONS|URL
  • * - OPTIONS: facultatif ex: "color:red; opacity:0.3"
  • * nota bene: le séparateur d'options est le ';' et pas la ',' qui est déjà utilisée pour séparer les LAYERS.
  • * - TYPE: Tiles ou GeoJson
  • * - URL: Attention au Blocage d?une requête multi-origines (Cross-Origin Request).

Création d'un formulaire de saisie

La page base de données est installée par défaut et se trouve dans la roue crantée en haut à droite
Première étape :
  • Se connecter avec un compte administrateur. Puis se rendre sur le menu Base de données.
image formulaire.png (0.1MB)
Vous devez vous identifier comme admin
  • Pour accéder un menu de création du formulaire, il faut cliquer sur l'onglet "Formulaires".
    image formulaire.png (0.1MB)
    Cliquer sur formulaire

3 façons de créer un formulaire

Méthode 1 :
L'importer depuis un autre wiki

en cliquant simplement sur le lien formulaire :
image Capture_du_20160405_091317.png (0.1MB)
Importer les formulaires d'un autre yeswiki
Méthode 2 :
Partir d'un modèle par copier coller

en cliquant sur formulaire puis créer un nouveau formulaire :
image tuto_formulaire.png (85.4kB)
Créer un nouveau formulaire
Méthode 3 :
Le créer soi-même

en cliquant sur formulaire puis créer un nouveau formulaire :
image tuto_formulaire.png (85.4kB)
Créer un nouveau formulaire

Facette : un module de recherche dans bazar


Facette est une interface graphique qui permet d'interroger une base de données sur base de critères prédéfinis (via des listes ou des checkbox)
Facette s'active TOUT SEUL quand l'action {{bazarliste}} s'accompagne du paramètre groups
Par défaut toutes les fiches sont affichées.

{{bazarliste id=" " groups="Nomduneliste,duchamp"  titles="titredelaliste, duchamp" pagination="15" template="nomdutemplate.tpl.html"}}

image Capture_decran_20160405_a_105411.png (0.1MB)
Paramètres utilisables
  • les paramètres en gras sont obligatoires
  • un paramètre se déclare de la manière suivante nomduparametre="valeurduparametre"
nom du paramètre valeurs du paramètre
id Id du formulaire dans lequel il faut faire la recherche
groups On place les champs du formulaire sur lesquels on veut permettre la recherche, séparés par des virgules (les champs) / si c'est un liste, indiquer listeListeNomdelaliste / si c'est un checkbox, indiquer checkboxListeNomdelaliste / si c'est un champ, indiquer bf_nomduchamp /si c'est une liste qui est formé par le contenu d'un autre formulaire, indiquer listefiche+id de l'autre formulaire / si c'est un checkbox qui est formé par le contenu d'un autre formulaire, indiquer checkboxfiche+id de l'autre formulaire
Si le but de la recherche est de choisir parmi plusieurs formulaires affichés, utiliser groups="id_typeannonce"
groupsexpanded true ou false permet de plier ou pas par défaut les champs de recherche.
titles on place dans le même ordre que dans "groups" le nom des champs de recherche
groupicons une liste de class css pour mettre des icônes aux intitulés des groupes, juste à gauche des valeurs indiquées dans titles. ex: groupicons="glyphicon glyphicon-plane,glyphicon glyphicon-home"
filterposition Pour aligner l'encadré de filtre à droite /par défaut/ ou à gauche (filterposition="left") des fiches bazar
filtercolsize Pour choisir la largeur des encadrés "filtres". Chiffre entre 1 et 12. Ex : filtercolsize="12" et filterposition="left" placera les filtres au-dessus des résultats et sur toute la largeur
template Nom du template à utiliser / par défaut bazarliste / Attention tous les templates ne fonctionnent pas avec facette / Si on souhaite un rendu cartographique : map.tpl.html
pagination Nombre de fiches qu'on veut voir par page
height Hauteur en pixels
zoom Niveau de zoom quand on utilise un rendu cartographique
lat Latitude pour centrer la carte quand on utilise un rendu cartographique
long Longitude pour centrer la carte quand on utilise un rendu cartographique

Des exemples ?

En combinant champ mot clé et critères prédéfinis

Il est possible de combiner une recherche par mot clé libre et des critères prédéfinis.
image Capture_decran_20160405_a_105411.png (0.1MB)
{{bazar id="" vue="consulter" voirmenu="0" groups="Nomduneliste,duchamp"  titles="titredelaliste, duchamp" pagination="15" template="nomdutemplate.html.tpl"}}

Paramètres utilisables
  • les paramètres en gras sont obligatoires
  • un paramètre se déclare de la manière suivante nomduparametre="valeurduparametre"
nom du paramètre valeurs du paramètre
id Id du formulaire dans lequel il faut faire la recherche
groups On place les champs du formulaire sur lesquels on veut permettre la recherche séparés par des virgules / si c'est un liste, indiquer listeListeNomdelaliste / si c'est un checkbox, indiquer checkboxListeNomdelaliste / si c'est un champ, indiquer bf_nomduchamp /si c'est une liste qui est formé par le contenu d'un autre formulaire, indiquer listefiche+id de l'autre formulaire / si c'est un checkbox qui est formé par le contenu d'un autre formulaire, indiquer checkboxfiche+id de l'autre formulaire
Si le but de la recherche est de choisir parmi plusieurs formulaires affichés, utiliser groups="id_typeannonce"
groupsexpanded true ou false permet de plier ou pas par défaut les champs de recherche.
titles on place dans le même ordre que dans "groups" le nom des champs de recherche
template Nom du template à utiliser / par défaut bazarliste / Attention tous les templates ne fonctionnent pas avec facette / Si on souhaite un rendu cartographique : map.tpl.html
pagination Nombre de fiches qu'on veut voir par page
height Hauteur en pixels
zoom Niveau de zoom quand on utilise un rendu cartographique
lat Latitude pour centrer la carte quand on utilise un rendu cartographique
long Longitude pour centrer la carte quand on utilise un rendu cartographique

Importer/exporter depuis/vers bazar


Il est possible
  • d'importer des données externes (d'un tableur par exemple) dans un formulaire bazar
  • d'exporter des données d'un formulaire bazar pour les utiliser ensuite dans un tableur classique

Étapes pour importer des données

  • se connecter au wiki (il faut être parmi les administrateurs pour pouvoir importer des données)
  • se rendre sur la page permettant la gestion des formulaires (elle contient l'action{{bazar}})
  • cliquer sur le bouton importer
  • choisir parmi les formulaires celui dans lequel on souhaite importer des données
image importbazzar1.png (34.6kB)
  • le wiki fournit alors diverses infos sur la structure du fichier nécessaire pour permettre un bonne importation
  • le wiki fournit un fichier type vide au format CSV comme exemple (on peut le remplir et se servir de celui-ci ensuite)
image importbazarnext1.png (55.1kB)
  • une fois que l'on a préparé son fichier d'importation selon les consignes données
  • on choisit son fichier à importer
  • on clique sur le bouton Importer le fichier`
  • une étape de contrôle / validation est proposée
  • si tout s'est bien passé on reçoit un message

Étapes pour exporter des données

  • se connecter au wiki (il faut être parmi les administrateurs pour pouvoir importer des données)
  • se rendre sur la page permettant la gestion des formulaires (elle contient l'action{{bazar}})
  • cliquer sur le bouton exporter
  • choisir parmi les formulaires celui que l'on souhaite exporter
image bazarexport1.png (34.6kB)
  • le wiki génère un fichier CSV à télécharger
image bazarexportnext1.png (26.6kB)

Quoi faire avec mon fichier CVS ? Un CSV peut s'ouvrir avec Excel, Open Office, Google Doc ... en précisant simplement que le caractère d'espacement est une virgule.

Rechercher dans la base de données

Il existe plusieurs façons de permettre une recherche par les utilisateurs dans la base de données.

Par mots-clés libres

Il est possible d'afficher TOUT le contenu d'une des base de données avec un champ de recherche par mot clé


image Capture_decran_20160405_a_103557.png (73.4kB)

Par critères prédéfinis

Facette est une interface graphique qui permet d'interroger une base de données sur base de critères prédéfinis (via des listes ou des checkbox)

image Capture_decran_20160405_a_103643.png (0.2MB)

En combinant mots-clés et critères

Il est possible de combiner recherche par mot clé ET recherche par critères prédéfinis.

image Capture_decran_20160405_a_103643.png (0.2MB)

Créer un widget carto avec bazar

L'outil Widget permet d'afficher les contenus venant d'un formulaire bazar sous forme :
  • d'une fenêtre dans la page de votre wiki
  • d'une fenêtre dans n'importe quel site web autre (dans Wordpress, Spip, Joomla, etc.)

Nous nous intéressons ici à la création de cartes issues de formulaires bazar. (Voir page ActionBazarcarto pour en savoir plus sur l'affichage carte)

Voici par exemple le widget issu du bazar des personnes ressources YesWiki

Créer facilement des cartes


Vous avez besoin de créer des cartes pour :
  • montrer les membres de votre réseau,
  • faire une carte des adhérents,
  • partager vos initiatives, projets
  • faire une carte pour un événement, un colloque, un festival
  • inventorier des éléments du patrimoine, l'accessibilité de lieux,
  • etc...

Vous pouvez utiliser yeswiki pour :
  • fabriquer des cartes thématiques pour afficher dans votre wiki
  • utiliser yeswiki comme cartothèque, c'est à dire un lieu central pour créer des cartes à la volée et les afficher dans n'importe quel site web via un code embed

Etape 1 : rendez-vous sur la page Bazar de votre wiki

  • choisissez le formulaire que vous voulez afficher sous forme de cartes.
  • cliquez sur le bouton Widget
image Capture_bazar.png (13.1kB)



Etape 2 : Sur la page widget

  • Type de Visualisation : par défaut vos données s'affichent sous forme d'accordéon. Choisissez cartes avec fiches entières
  • Options de la carte : Choisir un fond de carte en fonction de ses besoins : topographie, délimités communaux, noir et blanc ou couleur, etc. (Voir la liste des fournisseurs de cartes )
image pagewidgetcarto.png (0.5MB)


















Etape 3 : Sélection des couches Facettes

  • Sélectionnez les couches Facettes que vous voulez voir apparaitre
  • Attention : pour l'instant le widget carto ne gère pas de couleurs différentes en fonction des couches facettes. Donc tous les points sont affichés avec le style par défaut. Mais ça viendra !
image widgetcartofacette.png (15.1kB)











Etape 4 : choix code d'intégration

Avant la création du code final vous pouvez aussi :
  • ajuster la taille des marqueurs
  • définir des coordonnées
  • définir la taille d'affichage du widget carto

Une fois tout paramétré vous avez deux codes à copier/coller à votre disposition :
  • le premier un iframe à installer dans votre site web (voir intégration iframe en fonction de votre CMS wordpress, spip, joomla, etc)
  • le second c'est l'action Bazar à intégrer dans la page de votre choix de votre wiki


image widgetembed.png (90.8kB)


Alternative, utiliser gogocarto


{{bazarliste id="2" template="gogomap.tpl.html" width="100%" height="600px" groups="checkboxListeCategories" titles="Mes catégories" colorfield="checkboxListeCategories" color="#98A100= market, #1E8065= organic" iconfield="checkboxListeCategories" icon="leaf=market,cogs=organic"  iconprefix="fa fa-"}}


image Capture_dcran_de_20191021_122151.png (0.1MB)

Pour les icones, j'ai utilisé la librairie fontawesome, vous pouvez trouver des icones ici : https://fontawesome.com/icons?d=gallery&m=free

Toute la configuration de gogocarto n'est pas disponible via des paramètres de bazarliste. A la place, vous pouvez donner un fichier de configuration en utilisant "jsonconfurl"
{{bazarliste id="2" template="gogomap.tpl.html" jsonconfurl="https://pixelhumain.github.io/GoGoCartoJs/web/data/configuration-pwa.json"}}


Voir tout la configuration possible sur https://pixelhumain.github.io/GoGoCartoJs/docs/configuration.html

blog.tpl.html

Ce template est fourni avec un yeswiki de base non il doit être téléchargé
blogtplhtml_capture-blog.png
Présentation rapide Le template blog permet d'afficher des actualités :
- dernier aticle mis en avant
- affiche la date et l'auteur del'article sous le titre
- le résumé affiché est un champ "bf_chapo" - car on ne voulait pas avoir une description tronquée
Détails des différents paramètres spécifiques à ce template pas de paramètres, pas de variantes
Lien vers les fichiers à télécharger si besoin https://github.com/YesWiki/templates-bazar/blob/master/templates/blog.tpl.html
Informations importantes à propos de ce template dans le template ci-dessous, les lignes "labelhtml" sont facultatives. Elles ont été ajoutées pour permettre la mise en forme de l'article complet lorsqu'on clique sur "Plus d'infos".
Lien vers un wiki où le template est visible https://adrets-asso.fr/?Blog
Lien vers le wiki démo où le template est visible http://yeswiki.net/cercopitheque/demo/?BloG
Code source du formulaire qui a servi pour cet exemple
labelhtml*** *** ***<div class=" sans-titre">
texte***bf_titre***Titre de l'article de blog***255***255*** *** *** ***1***0***
labelhtml*** *** ***</div>
labelhtml*** *** ***<div class="row">  <div class="col-md-3 text-center">
jour***bf_date_article***Date de l'article***1*** *** *** *** ***1***0
labelhtml*** *** ***</div> <div class="col-md-3 text-center">
listefiche***3***Auteur*** *** *** *** *** ***0***0***
labelhtml*** *** ***</div></div>
labelhtml*** *** ***<div class=" sans-titre">
labelhtml*** *** ***<div class="row">  <div class="col-md-4 text-center">
image***bf_image***Image de présentation (350x150px)***350***150***350***150***right***1***0***Votre image doit être au format .jpg ou .gif ou .png en de taille 350x150px
labelhtml*** *** ***</div>  <div class="col-md-8 lead  ">
textelong***bf_chapo***Chapo de l'article***40***10*** *** *** ***0
labelhtml*** *** ***</b></i></div>  </div>
textelong***bf_description***Corps de l'article***40***10*** *** *** ***0
labelhtml*** *** ***</div>
lien_internet***bf_video***Lien vers une vidéo***40***255***http://*** *** ***0***0
lien_internet***bf_site_internet***Lien Internet***40***255***http://*** *** ***0***0
fichier***bf_fichier***Document joint***20000000*** *** *** *** ***0*** ***ne pas dépasser 20 Mo
Mot clés

{{button}}

démo de l'action
Un joli bouton cliquables pour vos liens
Comportements
permet d'ajouter un bouton de différentes couleurs, tailles...

syntaxe minimale : {{button link="http://lolo.lol"}}
syntaxe complexe : {{button link="http://lolo.lol" text="cliquez ici pour aller sur le site" icon="book" class="btn-primary"}}

Moi je voudrais...

Pour créer un bouton, il vous suffit d'utiliser le code suivant, en inscrivant derrière "link" le lien de la page vers lequel mène votre bouton, et derrière "text" le texte que vous voulez voir apparaître dans votre bouton.

{{button link="http://lolo.lol" text="cliquez ici pour aller sur le site"}}

Pour ajouter un icone, nous allons ajouter dans le code du bouton le paramètre correspondant en ajoutant icon="nom de mon icone". Cela donnera par exemple pour un icone de livre :

{{button link="http://lolo.lol" text="cliquez ici pour aller sur le site" icon="book"}}

Pour retrouver le nom des différents icones disponibles, il vous suffit d'aller voir sur l'un de ces deux liens :

Nous allons pour cela ajouter un paramètre dans le code du bouton en ajoutant class="Ma classe". Pour un bouton prenant toute la page, cela donnera :
{{button link="http://lolo.lol" text="cliquez ici pour aller sur le site" class="btn-block"}}

Il existe plusieurs paramètres possibles en fonction de la taille désirée, du plus petit au plus grand :
  • btn-xs | très petit
  • btn-sm | moyen
  • btn-lg | grand
  • btn-block | pour avoir le bouton en pleine largeur
/!\ Si vous utilisez d'autres options faisant appel au paramètre "class", il vous faudra mettre un espace entre les différentes informations de class.


Nous allons pour cela utiliser un nouveau paramètre : le "nobtn" qui permet de ne pas afficher les bords et la couleur du bouton. Cela permettra d'utiliser des boutons transparents qui donneront l'illusion de menus classiques. En les combinant au paramètre "icon" (voir plus haut), le tour sera joué.

Il suffira donc de remplacer les liens des menus par des boutons de ce type:
{{button link="http://lolo.lol" text="cliquez ici pour aller sur le site" icon="book" nobtn="1"}}


Nous allons pour cela ajouter un paramètre dans le code du bouton en ajoutant class="Ma classe". Pour un bouton prenant toute la page, cela donnera :
{{button link="http://lolo.lol" text="cliquez ici pour aller sur le site" class="btn-success"}}

Il existe de nombreux paramètres possibles en fonction de la couleur souhaitée, celle-ci dépendra de votre thème, le mieux sera de les tester :
  • btn-success
  • btn-primary
  • btn-info
  • btn-warning
  • btn-danger
  • btn-inverse


/!\ Si vous utilisez d'autres options faisant appel au paramètre "class", il vous faudra mettre un espace entre les différentes informations de class.

Une page de démo très complète est accessible via ce lien : https://yeswiki.net/?DemoButton




Paramètres utilisables
  • les paramètres en gras sont obligatoires
  • un paramètre se déclare de la manière suivante nomduparametre="valeurduparametre"
nom du paramètre valeurs du paramètre
link nom de la page wiki ou url
text texte affiché sur le bouton
title texte affiché au survol du bouton
icon nom de l'icone sur boostrat https://getbootstrap.com/docs/3.3/components
nobtn si la valeur est à " 1", alors la mise en forme type "bouton" n'apparaît pas
class Aller piocher dans la page de demo les valeurs disponibles


Visualisation :
cliquez ici pour aller sur le site
Pour inclure un petit bouton "important" ou "info"
Important et Info
""<span class="label label-important">Important</span>"" et ""<span class="label label-info">Info</span>""

Pour inclure un bouton cliquable Plus d'infos sur les boutons = http://yeswiki.net/wakka.php?wiki=DocButton
découvrez le crie de mouscron
version wiki (donc sans ""  "") copier coller ceci : {{button class="btn btn-danger" link="lienverspage" icon="plus icon-white" text="votre texte"}}

Pour un bouton cliquable qui ouvre dans une autre fenêtre
""<a href="votrelien" target="_blank" class="btn btn-primary btn-large">votre texte</a>""
un bouton vert ? remplacer btn btn-danger par btn btn-success
un bouton orange ? remplacer btn btn-danger par btn btn-warning,
un bouton bleu ? remplacer btn btn-danger par btn btn-info

Et pour cacher un bouton ?
Parfois on souhaite simplement cacher un bouton (pour pouvoir ensuite le rendre visible très rapidement, sans avoir à retaper tout le code....)
Il suffit d'ajouter une classe "hide" dans le code en première position :
Pour reprendre l'exemple ci dessus
  • Bouton caché :
version wiki (donc sans ""  "") copier coller ceci : {{button class= "hide" "btn btn-danger" link="http://www.criemouscron.be" icon="plus icon-white" text="découvrez le crie de mouscron"}}

carousel.tpl.html

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut
carouseltplhtml_capture-décran-2018-12-09-à-17.18.13.png
Présentation rapide Ce template permet de faire un slider pour faire défiler des images automatiquement. Souvent utiliser en pageheader.
Tous les champs sont cachés si pas remplis sauf image bien sûr et bf_titre (champ obligatoire)
Cela dit on peut cacher aussi le bf_titre via un paramètre (voir ci-dessous)
Détails des différents paramètres spécifiques à ce template sanstitre="oui" permet de cacher le titre de la fiche (bf_titre)
Lien vers un wiki où le template est visible https://yeswiki.net
Lien vers le wiki démo où le template est visible http://yeswiki.net/cercopitheque/demo/?CarouseL
Mot clés

Types de champs possibles

Comment ajouter des champs dans vos formulaires ?

L'espace Template de votre formulaire permet de décrire l'ensemble des champs dont vous avez besoin, à raison d'un champ par ligne.

Exemple d'une ligne de code permettant de créer un champ "texte".
Nous allons détailler la description d'un champ typique. Vous pourrez par la suite la modifier pour l'adapter à vos besoins en comprenant comment elle fonctionne :

texte***bf_titre***Nom prénom***255***255*** *** *** ***1***0***

Pour comprendre cette ligne cabalistique, observez qu'elle propose 13 zones paramétrables séparées par trois étoiles comptez la position de la zone et lisez ci-dessous sa description

Chaque zone sert-elle toujours à la même chose ?
Certaines des zones sont :
  • génériques : elles servent toujours à la même chose (par exemple la première zone sert toujours à indiquer le type de champ) ;
  • quasi-génériques : la zone sert pratiquement toujours à la même chose pour tous les types de champs à quelques exceptions près ;
  • spécifiques : la zone sert à donner des informations différentes suivant le type de champ (texte, bouton, etc.) ;
  1. Type de champ (générique) : texte (chaque type de champ possède sa description) attention, une "fote", une majuscule provoquera une erreur au niveau de ce champ
  2. Identifiant du champ (quasi générique) : bf_contact (sans accents, tout attaché)
    • Nous vous conseillons de garder les intitulés proposés. Si vous les changez, cela pourra poser des problèmes dans les modes de restitutions
    • Si vous utilisez un autre champ de ce type dans le même formulaire, l'identifiant du champ devra être différent
    • Si vous modifiez cet identifiant alors que certaines fiches ont été saisies, vous perdrez les données de ce champ des précédentes fiches)
  3. Intitulé affiché (quasi générique) : Contact
    • Cette zone indique ce que vos utilisateurs verront à l'écran, suivi de deux point ":"
    • vous pouvez changer cet intitulé au cours de la vie de votre site sans incidences
  4. Taille à l'écran (spécifique) : 15 (caractères)
  5. Nombre de caractère max (spécifique) : 15
  6. Valeur par défaut (spécifique) : non renseigné
  7. ici Non-utilisé : dans certains types de champs, toutes les zones ne sont pas utilisées, dans ce cas, les laisser vide
  8. ici Non-utilisé
  9. Saisie obligatoire (quasi générique) : 1 (champ obligatoire) 0 ou vide (pas d'obligation)
  10. Présence dans le moteur de recherche (quasi générique) : 1 (utilisé dans les recherches) 0 ou vide (pas utilisé)
  11. Texte d'aide à la saisie (quasi générique) : ce qui est écrit dans cette zone deviendra une bulle d'aide visible lorsque l'utilisateur cliquera sur un petit point d'interrogation bleu
  12. Droits d'accès au contenu du champ. (NON FONCTIONNEL) Même fonctionnement que pour les droits d'accès aux pages : le contenu de ce champ permet de réserver en lecture l'accès à son contenu : * (tout le monde, par défaut), + (utilisateurs identifiés), % (propriétaire de la fiche et administrateur uniquement), @admins (membre du groupe admins). Ici le champ indique un accès au groupe des administrateurs uniquement (@admins).
  13. Droits d'accès à la saisie du champ. (quasi générique) Même fonctionnement que pour les droits d'accès aux pages : le contenu de ce champ permet de réserver l'écriture dans ce champ du formulaire : * (tout le monde, par défaut), + (utilisateurs identifiés), % (propriétaire de la fiche et administrateur uniquement), @admins (membre du groupe admins). Ici le champ indique un accès au groupe des administrateurs uniquement (@admins).

nb : si vous voyez le code suivant dans votre template de formulaire, les champs manquant seront proposés avec leurs valeurs par défaut
texte***bf_contact***Contact

Pour les retrouver, il suffira d'ajouter les zones paramétrables grâces aux petites étoiles
texte***bf_contact***Contact*** *** *** *** *** *** *** *** ***

puis de compléter les champs qui vous intéressent (ici aide contextuelle) de la manière suivante
texte***bf_contact***Contact*** *** *** *** *** *** *** ***entrez ici votre contact***



Un seul champ indispensable Important

Par exemple, pour un annuaire :
texte***bf_titre***Nom prénom***255***255*** *** *** ***1***0***

Par exemple, pour un événement :
texte***bf_titre***Titre de l'événement***255***255*** *** *** ***1***0***

Affichage dans le formulaire de saisie :
image titrenomevenement1.png (6.6kB)
Une entrée contenant le champ bf_titre est obligatoire!!

Pour aller plus loin
Il est possible de générer ce champ bf_titre de manière automatique en concaténant 2, 3 ou plus de champs
dans ce cas, il ne faut pas qu'un champs avec l'identifiant bf_titre soit déjà présent
Syntaxe :
titre***{{bf_nom}}  - {{bf_prenom}} - {{listeListeOuiNon}} - {{checkboxListePartenaires}}*** ***

dans ce cas : le titre généré est le nom puis le prénom séparé d'un tiret. Si vous souhaitez mettre des listes, indiquez s'il s'agit de liste ou checkbox comme dans l'exemple.



Les plus courants

textelong***bf_adresse1***Adresse postale***200***5*** *** *** ***1***0***
texte***bf_code_postal***Code postal*** ***5*** *** *** ***0***1***
texte***bf_ville***Ville***50***80*** *** *** ***1*** ***
texte***bf_pays***Pays***50***80*** *** *** ***1*** ***


champs_mail***bf_mail***Email***40***255*** *** *** ***0***0***l'adresse mail doit être de la forme quelquechose@domaine.extension

Le champ en 7ème position s'il est rempli avec form rendra invisible le mail et le remplacera par un petit formulaire de contact direct.
champs_mail***bf_mail***Email***40***255*** ***form*** ***0***0***l'adresse mail doit être de la forme quelquechose@domaine.extension

Le champs en 10ème position permet s'il vaut 1 d'envoyer par mail le contenu du formulaire à l'adresse mail renseignée dans ce champ / cela permet donc d'envoyer aux gens une copie mail du formulaire qu'ils viennent de remplir par ex)
champs_mail***bf_mail***Email***40***255*** ***form*** ***0***1***l'adresse mail doit être de la forme quelquechose@domaine.extension

Le champs en 12ième position permet de réserver la lecture de l'adresse au groupe des admins
champs_mail***bf_mail***Email***40***255*** *** *** ***0***0***l'adresse mail doit être de la forme quelquechose@domaine.extension***@admins

Attention, ces mails peuvent tomber dans les spam !!

Syntaxe :
carte_google***bf_latitude***bf_longitude***cartogoogle***1

Attention Il faut obligatoirement un champ adresse contenant bf_adresse1 (ou bf_adresse2) et/ou bf_ville et/ou bf_pays disponible pour effectuer la géolocalisation


Affichage dans le formulaire de saisie :
image champadresse_carto.png (0.3MB)


Pour changer le centre et le niveau de zoom par défaut de la carte dans le formulaire (c' est à dire la carte que les gens voient lorsqu'ils veulent valider/déplacer le marker) => DocumentationFichierDeConfiguration

Exemple de syntaxe à copier/coller :
jour***bf_date_debut_evenement***Début de l'événement***1*** *** *** *** ***1***0

jour***bf_date_fin_evenement***Fin de l'événement***1*** *** *** *** ***1***0


  1. Type de champ : jour
  2. Identifiant du champ : bf_date_debut_evenement
  3. Intitulé affiché : Début de l'événement
  4. Non-utilisé
  5. Non-utilisé
  6. indiquer today ici permet d'afficher par défaut la date du jour
  7. Non-utilisé
  8. Non-utilisé
  9. Saisie obligatoire : 1 (oui)
  10. Non-utilisé
Syntaxe :
Affichage dans le formulaire de saisie :
image champdate.png (6.9kB)

image***bf_image***Image de présentation (facultatif)***140***140***600***600***right*** *** ***Votre image doit être au format .jpg ou .gif ou .png

  1. Type de champ : image
  2. Identifiant du champ : bf_image (sans accents, tout attaché)
  3. Intitulé affiché : image de présentation (facultatif)
  4. Hauteur de la vignette : 140 (en px)
  5. Largeur de la vignette : 140 (en px)
  6. Hauteur de l'image redimensionnée : 600 (en px)
  7. Largeur de l'image redimensionnée : 600 (en px)
  8. Classe css associée à l'image : right (ou center ou left)
  9. Saisie obligatoire : 0 (non)
  10. Présence dans le moteur de recherche : non renseigné (non).
  11. Texte d'aide à la saisie : Votre image doit être au format .jpg ou .gif ou .png, ce qui est écrit dans cette zone deviendra bulle d'aide visible lorsqu'ils cliqueront sur un petit point d'interrogation bleu
  12. Droits d'accès du champ. * (tout le monde, par défaut), + (utilisateurs identifiés), % (propriétaire de la fiche et administrateur uniquement), @admins (membre du groupe admins).
Affichage dans le formulaire de saisie :
image champimage.png (6.2kB)

lien_internet***bf_site_internet***Site Internet***40***255***http://*** *** ***0***0***Le lien doit être valide


Affichage dans le formulaire de saisie :
image champlieninternet.png (2.3kB)

Exemple de syntaxe à copier/coller :
checkbox***ListeFormations***Type de formation*** ***1*** *** *** ***1***1***

  1. Type de champ : checkbox
  2. Identifiant du champ : ListeFormations Pour trouver l'identifiant de la liste, aller sur la page Base de donnée , cliquez sur Listes et récupérez l'ID de la liste que vous souhaitez utiliser dans le menu déroulant (ex: ListeDepartementsFrancais) NB : il faudra évidemment que vous ayez fabriqué une liste
  3. Intitulé affiché : Type de formation
  4. Non-utilisé
  5. Valeur par défaut : l'élément dont l'identifiant est 1.
  6. Non-utilisé
  7. Identifiant de la liste (si la même liste est utilisées plusieurs fois dans le même formulaire) : non renseigné ici, si vous utilisez plusieurs fois cette liste dans le formulaire, allez voir l'encadré ci-dessous
  8. Non-utilisé
  9. Saisie obligatoire : 0 (non).
  10. Présence dans le moteur de recherche : 0 (non).
  11. Texte d'aide à la saisie : ce qui est écrit dans cette zone deviendra bulle d'aide visible lorsqu'ils cliqueront sur un petit point d'interrogation bleu
  12. Droits d'accès du champ. * (tout le monde, par défaut), + (utilisateurs identifiés), % (propriétaire de la fiche et administrateur uniquement), @admins (membre du groupe admins).
Attention!
Si l'on utilise plusieurs fois une liste dans un même formulaire : il faut mettre un identifiant en 7ieme position pour les différencier (cf. bf_origine et bf_arrivee)

Affichage dans le formulaire de saisie :
image champcheckbox.png (20.4kB)
Pour aller plus loin Si vous souhaitez que votre checkbox soit alimentée non pas par une liste mais par le contenu d'un autre formulaire bazar c'est possible via cette syntaxe :
checkboxfiche***id formulaire concerné***libellé qui doit apparaître*** *** *** *** *** ***1***0***



Exemple de syntaxe à copier/coller :
liste***ListeDepartementsFrancais***Département*** *** ***1*** *** ***1***1***

  1. Type de champ : liste
  2. Identifiant du champ : ListeDepartementsFrancais Pour trouver l'identifiant de la liste, aller sur la page Base de donnée , cliquez sur Listes et récupérez l'ID de la liste que vous souhaitez utiliser dans le menu déroulant (ex: ListeDepartementsFrancais) NB : il faudra évidemment que vous ayez fabriqué une liste
  3. Intitulé affiché : Département
  4. Non-utilisé
  5. Non-utilisé
  6. Valeur par défaut : l'élément dont l'identifiant est 1. si vous laissez ce champ vide, sera affiché "choisir"
  7. Identifiant de la liste (si la même liste est utilisées plusieurs fois dans le même formulaire) : non renseigné ici, si vous utilisez plusieurs fois cette liste dans le formulaire, allez voir l'encadré ci-dessous
  8. Non-utilisé
  9. Saisie obligatoire : 0 (non).
  10. Présence dans le moteur de recherche : 0 (non).
  11. Texte d'aide à la saisie : Lister les formations ici. ce qui est écrit dans cette zone deviendra bulle d'aide visible lorsqu'ils cliqueront sur un petit point d'interrogation bleu
  12. Droits d'accès du champ. * (tout le monde, par défaut), + (utilisateurs identifiés), % (propriétaire de la fiche et administrateur uniquement), @admins (membre du groupe admins).
Attention!
Si l'on utilise plusieurs fois une liste dans un même formulaire : il faut mettre un identifiant en 7ieme position pour les différencier (cf. bf_origine et bf_arrivee)

liste***ListeDepartementsAlpins***Département d'origine*** ***05*** ***bf_origine*** ***0***1***
liste***ListeDepartementsAlpins***Département d'arrivée*** ***05*** ***bf_arrivee*** ***0***1***

Affichage dans le formulaire de saisie :
image champliste1.png (8.4kB)



Exemple de syntaxe à copier/coller :
radio***ListeFormations***Type de formation*** ***1*** *** *** ***1***1***

  1. Type de champ : radio
  2. Identifiant du champ : ListeFormations Pour trouver l'identifiant de la liste, aller sur la page Base de donnée , cliquez sur Listes et récupérez l'ID de la liste que vous souhaitez utiliser dans le menu déroulant (ex: ListeDepartementsFrancais) NB : il faudra évidemment que vous ayez fabriqué une liste
  3. Intitulé affiché : Type de formation
  4. Non-utilisé
  5. Valeur par défaut : l'élément dont l'identifiant est 1.
  6. Non-utilisé
  7. Identifiant de la liste (si la liste est utilisées plusieurs fois dans le même formulaire) : non renseigné ici, si vous utilisez plusieurs fois cette liste dans le formulaire, allez voir l'encadré ci-dessous
  8. Non-utilisé
  9. Saisie obligatoire : 0 (non).
  10. Présence dans le moteur de recherche : 0 (non).
  11. Texte d'aide à la saisie : non renseigné.
  12. Droits d'accès du champ. * (tout le monde, par défaut), + (utilisateurs identifiés), % (propriétaire de la fiche et administrateur uniquement), @admins (membre du groupe admins).
Attention!
Si l'on utilise plusieurs fois une liste dans un même formulaire : il faut mettre un identifiant en 7ieme position pour les différencier (cf. bf_origine et bf_arrivee)

Affichage dans le formulaire de saisie :
image champradio.png (6.7kB)


texte***bf_tel***Téléphone***10***20*** *** *** *** ***0


texte***bf_contact***Contact***15***15*** *** *** ***1***0*** ***

Explication :
  1. Type de champ : texte
  2. Identifiant du champ : bf_contact (sans accents, tout attaché)
  3. Intitulé affiché : Contact
  4. Taille à l'écran : 15 caractères
  5. Nombre de caractère max : 15 caractères
  6. Valeur par défaut : ici non renseigné, si texte alors il sera proposé par défaut
  7. Non-utilisé
  8. Non-utilisé
  9. Saisie obligatoire : 1 (oui) 0 ou vide (non)
  10. Présence dans le moteur de recherche : 0 (non)
  11. Texte d'aide à la saisie : ce qui est écrit dans cette zone deviendra bulle d'aide visible lorsqu'ils cliqueront sur un petit point d'interrogation bleu
  12. Droits d'accès du champ. * (tout le monde, par défaut), + (utilisateurs identifiés), % (propriétaire de la fiche et administrateur uniquement), @admins (membre du groupe admins).

Exemple de syntaxe à copier/coller :
textelong***bf_description***Description***80***5*** *** ***wiki***0*** ***

Explication :
  1. Type de champ : textelong
  2. Identifiant du champ : bf_description (sans accents, tout attaché)
  3. Intitulé affiché : Formations proposées
  4. Largeur de la zone de saisie : 80 caractères
  5. Nombre de lignes de la zone de saisie : 5 lignes (attention au delà la case commence à être trop haute)
  6. Valeur par défaut : non renseigné
  7. Non-utilisé
  8. Format d'écriture : wiki (par défaut, syntaxe wiki) html (propose un éditeur wyzywig), ou nohtml (html non interprété)
  9. Saisie obligatoire : 0 (non).
  10. Présence dans le moteur de recherche : non renseigné (non).
  11. Texte d'aide à la saisie : ce qui est écrit dans cette zone deviendra bulle d'aide visible lorsqu'ils cliqueront sur un petit point d'interrogation bleu
  12. Droits d'accès du champ. * (tout le monde, par défaut), + (utilisateurs identifiés), % (propriétaire de la fiche et administrateur uniquement), @admins (membre du groupe admins).

Permet de joindre un fichier à une fiche.
Exemple de syntaxe à copier/coller :
fichier***bf_fichierstage***Documents produits lors du stage***20000000*** *** *** *** ***0*** ***ne pas dépasser 20 Mo

Explication :
  1. Type de champ : fichier
  2. Identifiant du champ : bf_fichierstage (sans accents, tout attaché)
  3. Intitulé affiché : Documents produits lors du stage
  4. Taille maximum du fichier : 2000000 (20 mega, c'est beaucoup !).
  5. Non-utilisé
  6. Non-utilisé
  7. Non-utilisé
  8. Non-utilisé
  9. Saisie obligatoire : 0 (non)
  10. Présence dans le moteur de recherche : non renseigné (non).
  11. Texte d'aide à la saisie : ne pas dépasser 20 Mo, ce qui est écrit dans cette zone deviendra bulle d'aide visible lorsqu'ils cliqueront sur un petit point d'interrogation bleu
  12. Droits d'accès du champ. * (tout le monde, par défaut), + (utilisateurs identifiés), % (propriétaire de la fiche et administrateur uniquement), @admins (membre du groupe admins).

Permet d'entrer des mots-clés dans le champ.
Chaque mot-clé est validé par la touche "entrée"
Exemple de syntaxe à adapter :
tags***bf_tags***Trois mots-clés que Yeswiki vous inspire***150***1*** *** *** ***0***1***Appuyer sur la touche "Entrée" pour séparer les mots-clés


En image
image capturetags.png (6.0kB)


Pour complexifier

inscriptionliste***info@gcn-quinoa.org***Je souhaite m'inscrire à la liste pour recevoir des informations sur le réseau***bf_mail***ezmlm***


Explication des zones
  1. Type de champ : inscriptionliste
  2. adresse de la liste : l'adresse de la mailing liste que vous avez précédemment crée (via votre hébergement, via framaliste...)
  3. Intitulé affiché : Je souhaite m'inscrire à la liste pour recevoir des informations sur le réseau
  4. Mail à inscrire : indique le champ utilisé dans le formulaire pour inscrire l'adresse mail. Pr défaut bf_mail
  5. gestionnaire de liste : indique quel logiciel est utilisé pour la liste. par exemple : ezmlm (pour des listes crées chez OVH), sympa (pour des framalistes)

Affichage dans le formulaire de saisie :
image champinscription.png (5.0kB)

labelhtml***<h3>Coordonnées</h3>*** ***<h3>Coordonnées</h3>

On peut écrire ce que l'on veut en langage HTML! (par exemple, pour mettre un titre : <h3>nom du titre</h3>)
On écrit 2 fois le titre : la première fois c'est pour apparaître dans la saisie, la deuxième fois c'est pour la visualisation de la fiche

Il s'agit d'une utilisation détournée de labelhtml
d'abord on ouvre un label html de ce type
labelhtml***<div style="display:none">*** *** ***

Ensuite on place les champs qui doivent être encodés mais pas vus ensuite / par ex :
jour*bf_date_debut_publication*Date de publication*1* * * * *1*0
jour
*bf_date_fin_publication*Date de déplubication*1* * * * *1*0

on ferme le labelhtml
labelhtml***</div> *** *** ***


utilisateur_wikini***bf_titre***bf_mail***

Attention, veiller à bien utiliser en complément cet autre champ (pour gérer les droits de la fiche-utilisateur créée) dans votre formulaire, écrit de la sorte
acls*** * ***user***user***


Une question s'affiche seulement si un choix précis a été fait dans une liste ou un checkbox précédent.

Dans ces 2 exemples (avec une liste et un checkbox), une première question propose de choisir parmi des compétences, et une seconde question s'affiche seulement si on choisit "autre" (écrit exactement comme ça comme clé dans la ListeCompetences).

Exemple 1 :
La liste propose une option "autre" qui, si elle est sélectionnée, fait apparaître une question texte pour préciser :
liste***ListeCompetences***Compétences*** ***1*** *** *** ***1***1***
labelhtml***<div id="ListeCompetences_autre" style="display:none;">*** ***
textelong***bf_autrecompetence***Autre(s) compétence(s)***80***5*** *** ***wiki***0*** *** ***
labelhtml***</div> <!-- fin de la condition -->*** ***


Exemple 2 :
Le checkbox propose une option "autre" qui, si elle est cochée, fait apparaître une question texte pour préciser :
checkbox***ListeCompetences***Compétences*** ***1*** *** *** ***1***1***
labelhtml***<div id="checkboxListeCompetences_autre" style="display:none;">*** ***
textelong***bf_autrecompetence***Autre(s) compétence(s)***80***5*** *** ***wiki***0*** *** ***
labelhtml***</div> <!-- fin de la condition -->*** ***



Il faut intégrer plusieurs éléments dans la constitution du formulaire comme le montre l'exemple ci-dessous pour 3 onglets :
NB : Les noms des onglets (Onglet 1, Onglet 2, Onglet 3) peuvent être modifiés dans les différentes occurrences ci-dessous, l'exemple est également transposable pour seulement 2 onglets ou plus de 3.

Voir un exemple

Indique qu'il y aura 3 onglets :
labelhtml***<ul class="nav nav-tabs" role="tablist"><li role="presentation" class="active"><a href="#menu1" role="tab" data-toggle="tab">Onglet 1</a></li><li role="presentation"><a href="#menu2" role="tab" data-toggle="tab">Onglet 2</a></li><li role="presentation"><a href="#menu3" role="tab" data-toggle="tab">Onglet 3</a></li></ul><div class="tab-content"><!--indique qu'il y aura 3 onglets, les noms des onglets (Onglet 1, Onglet 2,...) peuvent être modifiés ici (et dans leur différentes occurences ci-dessous)--> *** ***

Ouvre le premier onglet :
labelhtml***<div role="tabpanel" class="tab-pane active" id="menu1"><br><br><!--ouvre le premier onglet-->*** ***


Questions de l'onglet 1


Affiche un bouton pour passer à l'onglet 2 :
labelhtml***<a class="btn btn-lg btn-primary pull-right" href="#menu2" role="tab" data-toggle="tab">Onglet 2<i class="glyphicon glyphicon-chevron-right"></i></a><!--Affiche un bouton pour passer à l'onglet 2-->*** ***

Ferme l'onglet 1 et ouvre l'onglet 2 :
labelhtml***<div class="clearfix"></div></div><!-- ferme l'onglet 1 --> <div role="tabpanel" class="tab-pane" id="menu2"><br><br><!-- ouvre l'onglet 2-->*** ***


Questions de l'onglet 2


Affiche un bouton pour revenir à l'onglet 1 et un bouton pour passer à l'onglet 3 :
labelhtml***<a class="btn btn-lg btn-primary pull-left" href="#menu1" role="tab" data-toggle="tab"> <i class="glyphicon glyphicon-chevron-left"></i> Onglet 1</a><a class="btn btn-lg btn-primary pull-right" href="#menu3" role="tab" data-toggle="tab">Onglet 3<i class="glyphicon glyphicon-chevron-right"></i></a><!--Affiche un bouton pour revenir à l'onglet 1 et un bouton pour passer à l'onglet 3-->*** ***

Ferme l'onglet 2 et ouvre l'onglet 3 :
labelhtml***<div class="clearfix"></div></div><!-- ferme l'onglet 2 --> <div role="tabpanel" class="tab-pane" id="menu3"><br><br><!-- ouvre l'onglet 3-->*** ***


Questions de l'onglet 3


Affiche un bouton pour revenir à l'onglet 2 et un bouton pour enregistrer la fiche :
labelhtml***<a class="btn btn-lg btn-primary pull-left" href="#menu2" role="tab" data-toggle="tab"> <i class="glyphicon glyphicon-chevron-left"></i>Onglet 2</a><button class="pull-right btn btn-lg btn-success bouton_sauver" name="valider" type="submit">Enregistrer</button><!--Affiche un bouton pour revenir à l'onglet 2 et un bouton pour enregistrer la fiche*** ***

Ferme l'ensemble des onglets et efface les boutons Valider/Annuler en bas de chaque onglet :
labelhtml***<div class="clearfix"></div></div><!-- ferme l'onglet 3 --> </div><!-- ferme l'ensemble des onglets --><style>#formulaire .form-actions { display:none; }</style><!--Efface les boutons Valider/Annuler en bas de chaque onglet-->*** ***


Utile par exemple pour simplifier un formulaire long.

Voici le bout de code à insérer dans votre fomulaire
labelhtml***<div class="panel-group" id="accordion" role="tablist" aria-multiselectable="true"><div class="panel panel-default"><div class="panel-heading" role="tab" id="headingOne"><h4 class="panel-title"><a role="button" data-toggle="collapse" data-parent="#accordion" href="#collapseOne" aria-expanded="true" aria-controls="collapseOne"> Cliquez ici pour accéder aux champs optionnels       </a> </h4> </div>    <div id="collapseOne" class="panel-collapse collapse" role="tabpanel" aria-labelledby="headingOne"> <div class="panel-body">*** *** ***
textelong***bf_textelong***description***20***4*** ***1000*** *** ***
texte***bf_adresse***Adresse postale***200***200*** *** *** *** ***0***
labelhtml***</div></div></div></div>*** *** ***

Voir un exemple ici


Pour insérer plusieurs accordions :
Si vous voulez une 3ème, 4ème... accordion, pensez à personnaliser les parties écrites en majuscules dans le code (par ex COLLAPSE3 ou ACCORDION3...)
labelhtml***<div class="panel-group" id="ACCORDION1" role="tablist" aria-multiselectable="true"><div class="panel panel-default"><div class="panel-heading" role="tab" id="headingOne"><h4 class="panel-title"><a role="button" data-toggle="collapse" data-parent="#ACCORDION1" href="#COLLAPSE1" aria-expanded="true" aria-controls="COLLAPSE1">Tu souhaites rejoindre l'organisation (en amont de l'événement) </a> </h4> </div>    <div id="COLLAPSE1" class="panel-collapse collapse" role="tabpanel" aria-labelledby="headingOne"> <div class="panel-body">*** *** ***
ICI INSERER LES CHAMPS QUE VOUS VOULEZ
labelhtml***</div></div></div></div>*** *** ***

labelhtml***<div class="panel-group" id="ACCORDION2" role="tablist" aria-multiselectable="true"><div class="panel panel-default"><div class="panel-heading" role="tab" id="headingOne"><h4 class="panel-title"><a role="button" data-toggle="collapse" data-parent="#ACCORDION2" href="#COLLAPSE2" aria-expanded="true" aria-controls="COLLAPSE2">Tu souhaites donner un coup de main (durant l'événement) </a> </h4> </div>    <div id="COLLAPSE2" class="panel-collapse collapse" role="tabpanel" aria-labelledby="headingOne"> <div class="panel-body">*** *** ***
ICI INSERER LES CHAMPS QUE VOUS VOULEZ
labelhtml***</div></div></div></div>*** *** ***

Voir un exemple avec plusieurs accordions par là


acls***accès à la fiche en lecture***accès à la fiche en écriture***accès à la fiche en commentaire***

Par exemple :
acls***+***NelsonMandela***NelsonMandela***
signifie que seuls les utilisateurs enregistrés peuvent lire la fiche, et que seul l'utilisateur NelsonMandela peut modifier et commenter la fiche

Pour rappels les différents symbole sont :
  • * signifie "tout le monde sans identfication"
  • + signifie les utilisateurs enregistrés
  • % signifie l'utilisateur qui a crée la fiche
  • @admins signifie le groupe d'utilisateur @admins
- et on peut aussi spécifier un ou pluieurs comptes utilisateurs en particulier.


metadatas***colibris***1col.tpl.html***colibris.bootstrap.min.css***foret.jpg


  • 1 ) type de champ : metadas
  • theme : nom de dossier
  • squelette : squelette de theme
  • style : style css du theme associe
  • bgimg : image de fond dans files/backgrounds
permet de définir le thème associé à la fiche

Cases a cocher:
checkboxfiche***36***Médias liés***<vide>***<vide>***<vide>***id*** ***0***0***


Auto-complétion
checkboxfiche***36***Médias liés***<vide>***<vide>***<vide>***id***tags***0***0***


Plus d'explications sur cette page.
texte***bf_range***slider***0***10*** *** ***range***

texte***bf_color***couleur***0***10*** *** ***color***

champs_cache***bf_champs_cache***valeur cachée***

Il suffit d'utiliser la combinaison des deux actions "cacher des champs en mode vue" et "adresse mail", ce qui nous donne :
labelhtml***<div style="display:none"> *** ******
champs_mail***bf_mail1***Email***40***255***monmail@votremail.fr *** *** *** ***1*** ***@admins
labelhtml***</div>*** *** ***


Pour comprendre : Un champs mail permanent est intégré, c'est un champs "adresse mail" dont le contenu est pré-remplis avec notre propre adresse mail ... mais il est rendue invisible lors de la saisie grâce à l'action "cacher des champs en mode vue".
Il est également invisible pour l'utilisateur qui reçoit sa fiche grâce au paramètre de confidentialité définis sur"@admins"

mot_de_passe***bf_cache***mot de passe***

bookmarklet***Veille cooperative***Copier ce bookmark***bf_url***

  • Type de champ : listefichesliees
  • id de la fiche liée :
  • query :
  • param de l'action : champs="bf_nom" ordre="desc"
  • nombre de fiche : nb="x"
  • template de restitution : template="liste_liens.tpl.html"
  • type de fiche liee : checkbox pour checkboxfiche , rien pour listefiche
  • Non-utilisé
  • Non-utilisé
  • Non-utilisé
  • Non-utilisé

Changer les polices du wiki

Il est possible de changer les polices par défaut utilisées dans le wiki afin de lui donner une touche plus personnelle.
  • La première méthode (la propre) consiste à travailler directement dans le fichier css de votre wiki. Cela nécessite toutefois d'avoir accès au serveur sur lequel se trouve ce fichier css. Ceci n'est malheureusement pas à la portée de tous (techniquement ou pratiquement).
  • Il existe une deuxième méthode, moins propre, qui permet en déposant un bout de code html dans la page footer de votre wiki de "passer au-dessus" des polices fournies par défaut avec Yeswiki.

A défaut de mieux pour l'instant :

Voici une méthode s'appuyant sur google fonts

  • rendez vous sur google fonts et faites un choix parmi les polices proposées (max 3 pour éviter l'effet "arbre de Noël sur votre wiki)
    • chaque fois que vous voyez une police qui vous plait, vous cliquer sur le + rouge
    • une fois votre choix effectué, vous récupérer le code fourni par google en bas de page
    • ça devrait ressembler à ceci
<link href="https://fonts.googleapis.com/css?family=Gloria+Hallelujah|Roboto" rel="stylesheet">
et ceci fourni pour exemple
font-family: 'Gloria Hallelujah', cursive;
    font-family: 'Roboto', sans-serif;


Rendez vous maintenant dans votre PageFooter pour y coller ce code
""<link href="https://fonts.googleapis.com/css?family=Gloria+Hallelujah|Roboto" rel="stylesheet">""

et ensuite celui-ci que vous adaptez en fonction de vos envies les titres et la police pour tout le document (body)
""<style>
h1 {
  font-size: 32px;
  font-family: 'Gloria Hallelujah', cursive;
  color:#7EB6D9;
}

h2 {
  font-size: 28px;
  font-family: 'Gloria Hallelujah', cursive;
  color:#707322;
}

h3 {
  font-size: 24px;
  font-family: 'Gloria Hallelujah', cursive;
  color:red;
}

h4 {
  font-size: 20px;
}

h5 {
  font-size: 16px;
}

body {font-family: 'Roboto', sans-serif;}
</style>""


compteur.tpl.html

Ce template est fourni avec un yeswiki de base non il doit être téléchargé
compteurstplhtml_capture-décran-2018-12-06-à-12.56.26.png
Présentation rapide ce template permet d'afficher la somme du champ bf_nombre
Détails des différents paramètres spécifiques à ce template (si votre formulaire initial n'avait pas de champ bf_nombre, vous pouvez utiliser correspondance="bf_nombre=votre champ")
Lien vers les fichiers à télécharger si besoin https://github.com/YesWiki/templates-bazar
Informations importantes à propos de ce template Les champs nécessaires minimaux sont bf_nombre.
(si pas dans votre formulaire, utilisez correspondance="bf_nombre=votre champ").
Lien vers un wiki où le template est visible https://unarbrepourlawapi.be
Lien vers le wiki démo où le template est visible http://yeswiki.net/cercopitheque/demo/?CompteurS
Code source du formulaire qui a servi pour cet exemple
texte***bf_titre***Nom de l'événement***60***255*** *** *** ***1***0***
textelong***bf_description***Description***40***10*** *** *** *** 
textelong***bf_chapo***Chapo de l'article***40***10*** *** *** ***0
texte***bf_nombre***Nombre de participants***60***255*** *** *** ***0***0***
Ce texte n'apparait pas dans le formulaire
il est NECESSAIRE d'avoir les deux champs ci-dessous si on veut un affichage en calendrier
jour***bf_date_debut_evenement***Début de l'événement***1*** *** *** *** ***1***0
jour***bf_date_fin_evenement***Fin de l'événement***1*** ***  *** ***  ***1***0
texte***bf_horaire***Horaire***60***255*** *** *** ***0***0***
jour***bf_date_debut_publication***Début de la publication***1*** ***  *** ***  ***1***0
jour***bf_date_fin_publication***Fin de la publication***1*** ***  *** ***  ***1***0
texte***bf_horaire***Horaire***60***255*** *** *** ***0***0***
lien_internet***bf_site_internet***Site Web***40***255***http://*** *** ***0***0
image***bf_image***Image (facultatif)***140***140***600***600***right*** *** ***Votre image doit être au format .jpg ou .gif ou .png
fichier***fichier***Documents***20000000*** *** *** *** ***0*** ***ne pas dépasser 20 Mo
texte***bf_adresse***Adresse***50***50*** *** *** ***0***0
texte***bf_code_postal***Code postal***8***8*** *** *** *** ***0
texte***bf_ville***Ville***50***80*** *** *** *** ***0
labelhtml***<span style="color:#cc3333;">Il faut maintenant cliquer sur le bouton bleu pour placer votre point sur la carte </span><br>*** ***
carte_google***bf_latitude***bf_longitude***cartogoogle***
labelhtml***<h3>Il ne vous reste plus qu'à valider ! </h3>*** ****** *** *** *** *** *** *** ***
Mot clés

Créer une page de menu (gauche ou droite)

page inutile : voir plutôt DocumentationColonneMenu

damier.tpl.html

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut
damiertplhtml2_capture-template-damier.png
Présentation rapide Affiche toutes les fiches d'un formulaire sur la même page sous la forme d'un damier de cases alternativement blanches et de couleur (la couleur est définie par le paramètre couleur).
L'affichage des fiches peut être
précédé de texte (contenu dans une page appelée via le paramètre pageDessus),
et/ou suivi de texte (contenu dans une page appelée via le paramètre pageDessous).
Pour chaque fiche sont affichés les champs :
  • bf_titre
  • bf_debut
  • bf_fin
  • bf_lieu
  • bf_image
  • bf_description
Et un bouton, permet de pointer vers l'adresse contenue dans bf_lien.
Le libellé du bouton provient du champ bf_bouton. Le bouton renvoie,
  • soit vers l'adresse contenue dans le champ bf_lien s'il est renseigné,
  • si bf_lien est vide, le bouton permet de télécharger le fichier indiqué par bf_fichier.
Si, ni lien, ni fichier ne sont renseignés, aucun bouton ne s'affiche.
Certaines fiches peuvent être mises en exergue. On utilise pour cela la valeur du champ bf_exergue. Les fiches mises en exergue seront celles dont ce champ porte la valeur précisée par le paramètre valeurexergue.
Détails des différents paramètres spécifiques à ce template Les paramètres peuvent être passés dans l'action bazar ou bazarliste, mais sont spécifiques à ce template.
Les paramètres génériques à tous les templates et particulièrement applicables avec le présent template sont rappelés à la fin.

pageDessus=NomWikiDeLaPage
  • S'il est rempli,
    • indique le nom Wiki d'une page du wiki qui apparaîtra au dessus des fiches.
  • S'il n'est pas rempli ou pas présent,
    • rien n'apparaîtra avant les fiches.
pageDessous=NomWikiDeLaPage
  • S'il est rempli,
    • indique le nom Wiki d'une page du wiki qui apparaîtra au dessous des fiches.
  • S'il n'est pas rempli ou pas présent,
    • rien n'apparaîtra après les fiches.
nbcol="4"
  • S'il est rempli,
    • permet de changer le nombre de fiches affichées sur une ligne.
  • S'il n'est pas rempli ou pas présent,
    • les fiches seront 4 par ligne.
ATTENTION -
1. Sur un écran de téléphone, une seule fiche sera affichée par ligne.
2. Sur un écran d'ordinateur, le nombre de colonnes sera le suivant :
  • si nbcol = 1, alors les fiches apparaîtront sur 1 colonne,
  • si nbcol = 2, alors les fiches apparaîtront sur 2 colonnes,
  • si nbcol = 3, alors les fiches apparaîtront sur 3 colonnes,
  • si nbcol = 4, alors les fiches apparaîtront sur 4 colonnes,
  • si nbcol = 5 ou 6, alors les fiches apparaîtront sur 6 colonnes,
  • si nbcol 7 ou plus, alors les fiches apparaîtront sur 12 colonnes.
ordreaffichage="image, titre, date, lieu, texte, bouton"
  • S'il est rempli,
    • permet de définir l'ordre d'affichage des informations de toute fiche.
  • S'il n'est pas rempli ou pas présent,
    • les informations de chaque fiche seront affichées dans l'ordre "image, titre, date, lieu, texte, bouton"
Pour afficher, par exemple, le titre, puis l'image, puis le bouton, puis le texte, il faut préciser, en séparant les mots par des virgules : ordreaffichage="titre, image, bouton, texte"
ATTENTION – Si une information est absente de la liste, par exemple, comme ci-dessus, ni date, ni lieu ne figurent, cette information ne sera pas affichée.
couleur="SeaGreen" ou couleur="#2E8B57"
  • S'il est rempli, indique la couleur utilisée (nom ou code de couleur HTML)
  • S'il n'est pas rempli ou pas présent, la couleur sera SeaGreen=#2E8B57.
urldebase="https://adresse.demon.site/?"
Permet de préciser l'adresse de base du wiki.
Ne pas oublier de mettre le "?" à la fin.
  • S'il n'est pas rempli ou pas présent,
    • les liens internes au Wiki ne fonctionneront pas.
valeurexergue="1"
  • S'il est rempli,
    • indique, la valeur du champ bf_exergue pour laquelle une fiche sera mise en $exergue. Autrement dit seront mises en exergue les fiches dont le champ bf_exergue porte la même valeur que le paramètre valeurexergue.
  • S'il n'est pas rempli ou pas présent,
    • aucune fiche ne sera mise en exergue.
ombreportee="oui"
  • S'il est rempli,
    • indique, si chaque fiche est présentée sans une ombre portée (non) ou avec (tous les autres cas). Si on choisit d'avoir une ombre portée, les coins des fiches sont également arrondis. Sinon, les fiches sont des rectangles.
  • S'il n'est pas rempli ou pas présent ou pas égal à "non",
    • il y a une ombre portée

Paramètres génériques à tous les templates et particulièrement applicables ici

correspondance
Permet, lorsque le nom de l'un ou plusieurs des champs de votre formulaire diffère(nt) de (bf_image, bf_bouton, bf_description, bf_exergue, bf_lien ou bf_fichier), de préciser le(s)quel(s) de vos champs utiliser.
Ex. : correspondance="bf_texte=bf_monchamp, bf_image=bf_photo_vacances"
champ
Permet de trier les fiches autrement que par ordre alphabétique des titres.
Ce paramètre permet de définir le champ de votre formulaire sur lequel s'effectuera le tri des fiches avant leur affichage.
Ex. : champ="bf_monchamp" *
ordre
Permet de trier les fiches autrement que par ordre alphabétique des titres.
Ce paramètre permet de changer l'odre de tri des fiches.
Par défaut, les fiches sont affichées dans l'ordre croissant des titres ou du champ défini par le paramètre champ.
On peut changer cet ordre et le rendre décroissant.
Ex. : ordre="desc"
Informations importantes à propos de ce template
Limitations sur ce template
Lien vers un wiki où le template est visible https://osons.cc/?PageEquipe
Code source du formulaire qui a servi pour cet exemple Exemple de formulaire :
texte***bf_titre...
image***bf_image...
jour***bf_debut... <= date et heure éventuelles de début de l'événement
jour***bf_fin... <= date et heure éventuelles de fin de l'événement
texte***bf_lieu
textelong***bf_description...
texte***bf_lien... <= lien à activer en cliquant sur le bouton
fichier***bf_fichier... <= fichier à télécharger cliquant sur le bouton
texte***bf_bouton... <= texte à afficher sur le bouton
texte***bf_exergue... <= détermine les fiches à mettre en exergue
Mot clés

Action bouton

Affiche un lien sous forme de bouton cliquable, avec de nombreuses possibilités de personnalisation.

Paramètre class

Précise la classe CSS utilisée pour l'apparence du bouton.
On peut combiner plusieurs classes en les mettant d'affilée avec un espace.

Classes de taille de boutons
{{button class="btn-default btn-lg" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation
{{button class="btn-default" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation
{{button class="btn-default btn-sm" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation
{{button class="btn-default btn-xs" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation
Bouton sur toute la largeur
{{button class="btn-default btn-block" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation
Classes de couleur de bouton
{{button class="btn-success" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation

{{button class="btn-primary" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation

{{button class="btn-info" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation
{{button class="btn-warning" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation
{{button class="btn-danger" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation
{{button class="btn-inverse" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation
Mettre un bouton à droite de la page:
{{button class="pull-right btn-danger" link="DocumentatioN" text="Voir la documentation"}}

Voir la documentation

Paramètre icon

Rajoute une icône au début du bouton.
Voir liste disponible ici (https://getbootstrap.com/docs/3.3/components/#glyphicons) ou là (https://icons.getbootstrap.com/). On en trouve également ici : https://fontawesome.com/v4.7.0/icons/ .
Il faudra enlever le 'icon-' devant le nom des icônes.

{{button icon="plane" link="http://fr.wikipedia.org/wiki/%C3%87a_plane_pour_moi" text="Ca plane pour moi!"}}
donne:
Ca plane pour moi!

Paramètre nobtn

si ce paramètre est égal à 1 , il n'y a pas de décoration type bouton autour, juste un lien avec une éventuelle icône
{{button nobtn="1" icon="book" link="DocumentatioN" text="Doc"}}
donne :
Doc

Paramètre title

Ajoute un titre au survol d'un bouton. Dans le cas d'une fenêtre modale, ce titre sert de titre de la fenêtre
{{button class="modalbox" icon="book" link="DocumentatioN" text="Doc" title="Voir la superbe documentation"}}
donne :
Doc

Fenêtres modales

Une fenêtre modale est une fenêtre qui s'ouvre en "popup" au dessus de la page active. Ceci permet par exemple d'afficher du contenu venant d'ailleurs sans quitter la page sur laquelle on est.
ATTENTION :
  • les modales ne fonctionnent que si on demande l'affichage d'une page du wiki (les liens vers des pages extérieures ne fonctionnent pas)
  • si la page que vous affichez en modalbox contient un formulaire bazar en vue saisir, il ne pourra être validé.
Pour une fenêtre modal classique
{{button icon="book" class="btn-primary modalbox" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation

Pour une fenêtre modale qui s'affiche au survol (et qui disparaît quand on retire la souris)
{{button icon="book" class="btn-primary modalbox-hover" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation

Ouvrir dans une nouvelle fenêtre

Pour permettre l'ouverture dans une nouvelle page, il existe cette syntaxe wiki utilisant l'action button sinon vous pouvez bien sûr utiliser le code html suivant
{{button class="btn btn-link new-window " link="DocumentatioN" text="Voir la documentation"}}
donne
Voir la documentation
  • Cette page est migrée et découpée en bas de la page de documentation générale.
Ici : https://yeswiki.net/?DocumentatioN

Action {{button text="..." link="..."}}

Affiche un lien sous forme de bouton cliquable, avec de nombreuses possibilités de personnalisation.


Code minimal

{{button text="Voir la documentation" link="DocumentatioN"}}
donne:
Voir la documentation

Code toutes options

{{button link="DocumentatioN" class="btn-success btn-lg" icon="glyphicon glyphicon-book" text="Voir la documentation" title="Cliquer pour voir la doc"}}
donne:
Voir la documentation

Paramètres disponibles


Paramètre link (obligatoire)


Indique le lien qui sera ouvert au clic du bouton.
Peut être un NomWiki pour un lien interne au wiki ou une adresse url d'un site pour n'importe quel autre lien



Paramètre text


Texte à l'intérieur du bouton.



Paramètre class


Précise la classe CSS utilisée pour l'apparence du bouton.
On peut combiner plusieurs classes en les mettant d'affilée avec un espace.

Classes de taille de boutons
{{button class="btn-default btn-lg" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation
{{button class="btn-default btn-sm" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation
{{button class="btn-default btn-xs" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation

Bouton sur toute la largeur
{{button class="btn-default btn-block" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation
Classes de couleur de bouton
{{button class="btn-default" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation
{{button class="btn-primary" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation
{{button class="btn-info" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation

{{button class="btn-success" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation
{{button class="btn-warning" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation
{{button class="btn-danger" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation


Mettre un bouton à droite de la page:
""<div class="pull-right">""{{button class="btn-danger" link="DocumentatioN" text="Voir la documentation"}}""</div>""
ou
{{button class="pull-right btn-danger" link="DocumentatioN" text="Voir la documentation"}}
Voir la documentation



Paramètre icon


Rajoute une icône parmi celles disponibles ici : https://getbootstrap.com/docs/3.3/components/#glyphicons , placée devant le bouton. Il faudra enlever le 'icon-' devant le nom des icônes.
{{button class="btn-success" icon="glyphicon glyphicon-plane" link="https://fr.wikipedia.org/wiki/%C3%87a_plane_pour_moi" text="Ca plane pour moi!"}}
donne:
Ca plane pour moi!
{{button class="btn-danger" icon="glyphicon glyphicon-facetime-video" link="https://youtube.com" text="Aller sur youtube"}}
donne:
Aller sur youtube



Paramètre nobtn


si ce paramètre est égal à 1 , il n'y a pas de décoration type bouton autour, juste un lien avec une éventuelle icône
{{button nobtn="1" icon="glyphicon glyphicon-book" link="DocumentatioN" text="Doc"}}
donne :
Doc


Paramètre title


Ajoute un titre au survol d'un bouton. Dans le cas d'une fenêtre modale, ce titre sert de titre de la fenêtre
{{button class="modalbox" icon="glyphicon glyphicon-book" link="DocumentatioN" text="Doc" title="Voir la superbe documentation"}}
donne :
Doc


Fenêtres modales

Une fenêtre modale est une fenêtre qui s'ouvre en "popup" au dessus de la page active. Ceci permet par exemple d'afficher du contenu venant d'ailleurs sans quitter la page sur laquelle on est.
ATTENTION :
  • les modales ne fonctionnent que si on demande l'affichage d'une page du wiki (les liens vers des pages extérieures ne fonctionnent pas)
  • si la page que vous affichez en modalbox contient un formulaire bazar en vue saisir, il ne pourra être validé.
Pour une fenêtre modal classique
{{button icon="book" class="btn-primary modalbox" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation


Pour une fenêtre modale qui s'affiche au survol (et qui disparaît quand on retire la souris)
{{button icon="book" class="btn-primary modalbox-hover" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation


Pour une fenêtre modale qui s'affiche au survol d'un bouton "lien" (et qui disparaît quand on retire la souris)
{{button icon="book" class="btn btn-link btn-glossaire modalbox-hover" link="DocumentatioN" text="Voir la documentation"}}
donne :
Voir la documentation

Ouvrir dans une nouvelle fenêtre

Pour permettre l'ouverture dans une nouvelle page, il existe cette syntaxe wiki utilisant l'action button sinon vous pouvez bien sûr utiliser le code html suivant
{{button class="btn btn-link new-window " link="DocumentatioN" text="Voir la documentation"}}
donne
Voir la documentation

Captcha


L'extension captcha rajoute sur chaque page en mode édition, un champ captcha à compléter avant de valider la page.
Ceci permet de limiter le spam sur le wiki.

Statistique

Avec google stat

se connecter sur son compte google analytics
aller dans la roule crantée, créer un compte pui sremplir les infos demandées
  • nom du compte = ça vous décidez
  • nom du site web = ça vous décidez
  • URL du site Web : ça c'est l'url de votre wiki
cochez ce que vous souhaitez garder puis
  • => obtenir un ID de suivi

Récupérez le code global site tag et insérez le dans la page footer de votre wiki

A priori ça devrait compter les passants sur chacune des pages de votre wiki

Google Drive

Markdown

Query, un paramètre pour n'afficher qu'une partie de la base de données

Il est possible d'afficher seulement une partie des données présentes dans la base de données en utilisant le paramètre query.

Vous souhaitez :
  • trier sur base du contenu d'une (ou plusieurs) liste(s)
    • query="listeListeGenre=M|listeListeDep=26"
    • notez qu'il est possible de trier sur plusieurs valeurs au sein de la même query en séparant les valeurs par une virgule (sans espace)
    • Notez bien que la syntaxe est bien liste+Nomdelaliste=clé ou liste+Nomdelaliste=clé1,clé2 (dans votre liste, la clé n'est pas le texte mais bien l'identifiant que vous avez indiqué juste devant)
  • trier sur base du contenu d'une (ou plusieurs) checkbox(s)
    • query="checkboxListeGenre=M|checkboxListeDep=26"
    • Notez bien que la syntaxe est bien checkbox+Nomdelaliste=clé
  • trier sur base du contenu de boutons radios
    • query="radioListeGenre=M|radioListeDep=26"
    • Notez bien que la syntaxe est bien radio+Nomdelaliste=clé
  • trier sur base du contenu d'un champ (bf_...)
    • query="bf_titre=a.*" (affiche tous les titres commençant par a)
    • query="bf_titre=*.a" (affiche tous les titres finissant par a)
    • query="bf_titre=NomYeswiki (affiche la fiche dont le champ titre est NomYeswiki)
    • query="bf_titre=." (affiche toutes les fiches dont le champ "bf_titre" est vierge)
  • trier sur base d'une liste dynamique de type "checkboxfiche"
    • query="checkboxfiche<numeroduformulaireappelé>=Chat-Mot dufiltre"}}
    • Exemple :
      {{bazarliste id="2" query="checkboxfiche1=TesT"}}
      
      Cet exemple est un annuaire. Ici, on veut voir les personnes qui ont rempli l'annuaire (formulaire 2), en affichant uniquement les personnes qui appartiennent au groupe de travail "Test" (dont le ChatMot est TesT - donc à écrire exactement comme ça)


dupliquer une liste bazar

Info importante
Il est essentiel de veiller à bien respecter la clé sur laquelle vous souhaitez effectuer le tri.
Une majuscule manquante ou en trop, une faute de frappe et le tri ne sera pas effectif !!!
Lorsque cette clé vient d'une liste ou d'un checkbox, veillez à bien vérifier la valeur de votre clé en visitant dans l'action {{bazar}} l'onglet liste.

Action {{textsearch}}

Moteur de recherche interne aux page du wiki. Recherche en texte plein.


Exemple :





Cette action utilise la fonction d'indexation en texte intégral de MySQL et hérite de ses qualités et défauts :
  • la recherche est quasi instantanée
  • la recherche est limitée à des mots de 4 lettres au minimim
  • la recherche n'accepte pas de caractères génériques (ou caractères joker : ".*?", etc.)
  • la recherche n'est pas lématisée : MotWiki
    • la recherche de "protocole" ne trouvera pas "protocoles" ; fdfdf
    • la recherche de "lascif" ne trouvera pas "lascive"
  • la recherche n'est pas effectuée sur une partie de MotWiki : la recherche de "text" ne donnera pas ActionTextSearch pour résultat


Documentation de YesWiki version cercopithèque

Un travail de toilettage de la documentation est en cours. Pour accéder au nouveau sommaire en cours de construction (et pourquoi pas y participer !), rendez-vous sur cette page.

Vidéos et Comment faire pour... Glossaire Si vous ne trouvez pas de réponse à votre pied, utilisez le Forum d'entraide.
Pour les supers débutants, quelques trucs si l'informatique vous fait peur.

Pour les développeurs :

Liste des actions

Définition
Une action exécute une série d'opérations et affiche le résultat obtenu à l'endroit où elle est décrite dans la page.
C'est utilisé par exemple pour afficher un button, la liste des utilisateurs, un nuage de mots-clés.

Il est possible de spécifier des paramètres afin de personnaliser ce résultat (ordre du tri, nombre d'entrées, taille...). Certains paramètres peuvent être obligatoires.

Syntaxe
Une action s'écrit avec 2 accolades ouvrantes, suivi du nom de l'action, suivi par des éventuels paramètres, puis fermée par 2 accolades fermantes :
{{nomaction param1="valeur1" param2="valeur2" ... paramN="valeurN"}}

Vous pouvez bénéficier d'actions supplémentaires en installant des extensions supplémentaires à YesWiki


Voici quelques actions simples régulièrement utilisées sur les wikis

{{backgroundimage}}

Insérer une image en fond de page, en bandeau

{{button}}

Un joli bouton cliquables pour vos liens

{{contact}}

Permet d'afficher un formulaire d'envoi de mails, d'inscription ou de désinscription à une newsletter, et la possibilité d'envoyer des pages de votre site par mail.

{{ grid }} et {{ col }}

Ouverture d'une zone avec des colonnes

{{include page="PagePrincipale"}}

Permet d'inclure dans une page une autre page du wiki (ici la page PagePrincipale).

{{tocjs}}

Permet de créer un sommaire mobile sur la page

{{ProgressBar}}

Permet d'afficher la progression d'une tâche à l'intérieur d'une page wiki.


{{abonnement}}

S'abonner à une liste de discussion / diffusion

{{ accordion }}

Masque une partie du texte qui apparaît lorsqu'on clique dessus.

{{ animation }}

active des styles permettant d'animer vos pages

{{admintag}}

Administrer tous les mots clés du wiki, réservé aux administrateurs.

{{ariane}}

Générer un fil d'Ariane en fonction de la navigation de l'usager

{{attach}}

Joindre un fichier a une page, et affiche les formats images .jpg .gif .png, les cartes mentales .mm, et les vidéos .flv.

{{backgroundimage}}

Insérer une image en fond de page, en bandeau

{{backlinks}}

Lister les pages qui font un lien vers la page courante

{{barreredaction}}

Afficher la barre d'édition qui se trouve en bas de cette page (à l'intérieur des thèmes)

{{bazar}}

Un générateur et gestionnaire de base de données, véritable outil dans l'outil !!!

{{bazaruserpage}}

Permet d'afficher les fiches que j'ai rédigées dans bazar

{{button}}

Un joli bouton cliquables pour vos liens

{{ col }}

mise en page par colonne

{{configuration}}

Affiche les paramètres du fichier de configuration qui ne sont pas "sensibles".

{{contact}}

Permet d'afficher un formulaire d'envoi de mails, d'inscription ou de désinscription à une newsletter, et la possibilité d'envoyer des pages de votre site par mail.

{{correspondance}}

Permet, dans bazar, d'envoyer les contenus de champs spécifiques dans d'autres champs génériques utilisés dans les templates...

{{currentpage}}

Affiche le NomWiki de la page courante

{{desabonnement}}

Se désabonner à une liste de discussion / diffusion

{{diaporama}}

Affiche une page sous format diaporama / DOC à compléter

{{doubleclick}}

Pour les thèmes : active le double clic

{{ebookgenerator}}

Interface de création d'un ebook

{{ebooklist}}

Liste des ebooks créées par le générateur des ebooks

{{editactionsacls}}

Gestion des droits des actions

{{editgroups}}

Gérer des groupes d'utilisateurs

{{edithandlersacls}}

Gestion des droits des handlers

{{ end }}

Finir les actions grid, col

{{filemanager}}

Gestionnaire de fichiers attachés à une page / DOC à compléter

{{gererdroits}}

Administration des droits de manière globale pour toutes les pages

{{gererthemes}}

Administration des thèmes de manière globale pour toutes les pages

{{ grid }}

Ouverture d'une zone avec des colonnes

{{includepages}}

Liste des pages

{{include page="PagePrincipale"}}

Permet d'inclure dans une page une autre page du wiki (ici la page PagePrincipale).

{{lang}}


{{ListPages}}

Liste la totalité des pages du site.

{{Listusers/last}

Donne la liste des derniers comptes utilisateurs.

{{filtertags}}


{{listsubscribtion}}


{{listpagestag}}


{{login}}

Affiche la liste des pages qui pointent vers la page dans laquelle est placée cette action.

{{lostpassword}}


{{mailinglist}}


{{mailperiod}}


{{moteurrecherche}}

Affiche un moteur de recherche

{{mypages}}

Liste les pages dont je suis le propriétaire

{{mychanges}}

Liste les pages que j'ai modifié

{{nav}}

Permet de créer des onglets dans une page

{{nuagetag}}


{{ panel }}

Masque une partie du texte qui apparaît lorsqu'on clique dessus. (Lié a accordion)

{{player}}


{{pointimage}}

Permet de faire des points cliquables sur une image

{{recentchangesrss}}

Affiche le lien vers le flux RSS du wiki ou en combinaison avec le Handler xml le flux lui même.

{{share}}

Partage de la page sur les réseaux sociaux / DOC à compléter

{{ section }}

Permet de délimiter des zones de textes sur lesquels appliquer des styles particuliers

{{syndication url=""}}

Permet d'afficher un flux rss à l'intérieur d'une page wiki.

{{newtextsearch}}


{{themeselector}}

Tester directement les styles disponibles sur votre wiki

{{titrepage}}


{{toc}}

Génère une table des matières, sur la base des titres présents sur une page

{{tocjs}}

Génère une table des matières, sur la base des titres présents sur une page, contrairement à toc, la table suit le scrolle de la page

{{OrphanedPages}}

Liste toutes les pages orphelines (pages n'ayant aucune autres pages qui pointent vers elles)

{{PageIndex}}

Liste toutes les pages classées par ordre alphabétique et regroupées par lettre.

{{ProgressBar}}

Permet d'afficher la progression d'une tâche à l'intérieur d'une page wiki.

{{RecentChanges}}

Affiche la liste des pages récemment modifiées.

{{redirect page="PagePrincipale"}}

Permet d'être redirigé automatiquement vers une autre page lorsqu'une page est demandée.

{{TextSearch}}

Permet de lister les pages contenant un ou plusieurs mots entré(s) par l'utilisateur.

{{trail toc="NomDePage"}}

Permet de lier des pages entres elles grâce à une page de sommaire.
Cette action affiche un navigateur du type "précedente/suivante" en indiquant le nom des pages précende et suivante.

{{UserSettings}}

Permet aux utilisateurs d'effectuer les actions suivantes : création d'un nouveau compte, authentification, réglage des paramètres utilisateur, changement de mot-de-passe

{{valeur}}



Liste tous les MotWiki du site qui n'ont pas vu la création d'une page.

{{yeswikiversion}}



Ajouter des thèmes graphiques

Importer un thème graphique pré-existant

Pour les bidouilleurs confirmés :

Pour installer un nouveau thème graphique :

Pour installer une nouvelle image de fond :
  • L'envoyer par ftp dans files/backgrounds.
Seuls 2 formats d'images sont acceptés :
  • .jpg pour les images de fond pleine page (limiter la résolution à moins de 1920x1080 pixels pour éviter des temps de chargement trop longs)
  • .png pour les images en mosaïque (répétées sur l'axe horizontal et vertical)

Le thème et l'image de fond seront alors accessibles (en étant connecté sur votre wiki en mode édition) grâce au bouton "Thème graphique"

Pour définir une configuration graphique par défaut se rendre sur la partie "Changer de thème graphique"

Modifier un thème graphique pré-existant


Modifier un thème graphique revient à modifier :

  • Les squelettes : qui se trouvent dans le répertoire "themes/squelettes" d'un thème graphique donné
  • La feuille de style : qui se trouve dans le répertoire "themes/styles"
  • Les images de fond : qui se trouvent dans le répertoire "/files/backgrounds"

L'architecture de Yeswiki est basée sur Bootstrap . Pour modifier les thèmes graphiques et squelettes de Yeswiki il convient de maîtriser cette bibliothèque libre de mise en forme.

Modifier le thème graphique va donc revenir à adapter un squelette en modifiant celui-ci avec la syntaxe Bootstrap adaptée et la feuille de style associée.

C'est quoi ce bazar ?


Bazar est une extension importante de Yeswiki qui lui ajoute des fonctionnalités de création et de gestion de bases de données.

Elle vous permet :

Par défaut, quand on installe un nouveau wiki, une page "gestion des bases de données" est créée. Elle est accessible via la roue crantée en haut à droite du menu.

Pour pouvoir créer et modifier, il faut être connecté en tant qu'administrateur.
La consultation et la recherche sont ouvertes à tous (par défaut mais paramétrable si besoin)
Pour installer bazar sur votre wiki, il suffit d'insérer sur n'importe quelle page
{{bazar}}


Ci-dessous, un exemple de gestionnaire bazar

image bazar.png (57.9kB)

"Rechercher" vous permet de rechercher parmi les fiches déjà présentes dans vos bases de données.
Vous pouvez aussi trier vos fiches pour n'afficher que celles appartenant à une base de données choisie via la liste déroulante de droite

"Saisir" vous permet de saisir des données dans une de vos base de données. Il suffit de cliquer sur l'icône + correspondant à la ligne de la base de donnée que vous souhaitez compléter

"Formulaire" vous permet de gérer vos bases de données (modification ou création)

"Liste" vous permet de créer les listes (et leurs contenus) que vous utiliserez ensuite dans vos formulaires de saisie de données.

"Importer" vous permet d'importer des données en nombre (en provenance d'un tableur par exemple) directement dans une de vos bases de données selon la procédure suivante

"Exporter" vous permet d'exporter les données d'une de vos bases de données pour un usage externe (dans un tableur par exemple) selon la procédure suivante

Déplacer YesWiki sur un nouvel hébergement


Voici le principe, non détaillé
1) Par FTP de l'ancien hébergeur : récupérer l'ensemble des dossiers du yeswiki de votre ancien hébergeur. (on peut vider le dossier cache pour gagner de la place)
2) Par phpmyadmin de l'ancien hébergeur : récupérer les tables de yeswiki, en choisissant (si vous ne savez pas quelle est la base à accéder ni les identifiants et préfixe de tables; voir dans le fichier wakka.config.php téléchargé précédemment)
3) Par phpmyadmin du nouvel hébergeur : importer les tables de yeswiki précédemment récupérées
4) Editer le fichier wakka.config.php téléchargé précédemment et changer :
  • 'base_url' (mettre l'url du nouvel hébergement)
  • changer les parametres d'accès à mysql 'mysql_host', 'mysql_database', 'mysql_user', 'mysql_password'
5) Par FTP du nouvel hébergeur : copier les fichiers téléchargés précédemment et le fichier wakka.config.php modifié
6) Aller sur le wiki nouvel hébergeur et vérifier que tout fonctionne. Dans le moteur de recherche, chercher l'ancienne url du yeswiki pour voir si certaines pages n'avait pas le lien en dur, et dans ce cas le changer
7) effacer par ftp l'ancien yeswiki hébergé et faire une redirection vers le nouveau

Problèmes éventuels : si la configuration php pour le safe_mode du serveur est différente entre les 2 hébergements, il faudra changer ce paramètre ou modifier la structure des fichiers du répertoires files pour que les fichiers joints soient visibles.

Changer de thème graphique

Tester les thèmes !

Pour une page...


Chaque page d'un wiki peut s'afficher de diverses manières, à la demande des rédacteurs. Il est ainsi possible de choisir :

  • Le Thème graphique : ensemble des éléments esthétiques d'un wiki.
  • Le Squelette : qui définit l'architecture de chaque page (nbre de colonnes, etc.)
  • Le Style : qui correspond à l'aspect visuel de la page (couleurs, graphisme, etc.)
  • L'Image de fond qui permet de changer l'image de fond (logique non ?)

Tous ces éléments peuvent être variés d'une page à l'autre. Mais afin de maintenir une cohérence graphique sur l'ensemble de votre wiki, il est conseillé de se cantonner à l'usage d'un seul et même thème graphique.
La liste des thèmes par défaut est modifiable, cela relève d'une tache d'administrateur : voir la documentation.

Pour modifier ces éléments sur une page (précédemment créée ou nouvelle) :

  • Passer en mode édition (double clic ou "éditer la page")
  • En bas de votre page, apparait un gros bouton Thème graphique
image BontonTheme.png (2.9kB)
  • La fenêtre modale suivante apparaîtra alors :
image ChangerTheme.png (0.1MB)
Amusez vous à tester, ça ne peut pas faire de mal
  • Choisissez chaque élément de ces menus déroulants
  • cliquez sur Appliquer puis
  • Sauvez la page

Configuration graphique par défaut

Pour changer le thème graphiques sur l'ensemble du site, on peut personnaliser la configuration wakka.config.php et rajouter les valeurs:
'favorite_theme' => 'nom du theme correspondant au nom du sous-répertoire theme correspondant à ce thème personnalisé', 
'favorite_squelette' => 'nom du squelette en liaison avec le thème personnalisé.tpl.html', 
'favorite_style' => 'nom de la feuille de style en liaison avec le thème personnalisé.css'

exemple
'favorite_theme' => 'yeswiki',
'favorite_squelette' => 'responsive-1col.tpl.html',
'favorite_style' => 'blue.css',

Mais cela ne s'applique que pour les nouvelles pages créées.
Pour les anciennes pages, il faut alors modifier chaque page en mode édition, bouton thème,
ou bien forcer le thème pour toutes les pages en ajoutant dans wakka.config.php : 'hide_action_template' => '1',


Extension Contact

L'extension contact permet d'afficher un formulaire d'envoi de mails, d'inscription ou de désinscription à une newsletter, et la possibilité d'envoyer des pages de votre site par mail.

Info Sous cerco, cette extension a reçu une amélioration permettant le renvoi d'un message d'avertissement précisant que le message a bien été envoyé.

Installation

ATTENTION : cette extension est en cours de développement, elle est mise à disposition à des fins de test, l'utiliser en production serait risqué.


Paramètres des actions

Minimum {{contact}}
Toutes options {{contact mail=" "}}

Description des paramètres :

  • mail (obligatoire) :
  • class

Exemples

Contact

{{contact mail="florian@outils-reseaux.org"}} donne à l'écran :

Abonnements/Désabonnement à une liste

{{abonnement mail="liste-subscribe@outils-reseaux.org"}} donne à l'écran :

{{desabonnement mail="liste-unsubscribe@outils-reseaux.org"}} donne à l'écran :

Mlm : Si je comprends bien c'est : Cela envoie un mail pour l'utilisateur, d'inscription ou de désinscription, à une liste mail déjà existante.
La liste mail doit donc exister au préalable.

Paramétrage avancé

Cette action est configurée par défaut pour envoyer des messages en utilisant la méthode "smtp" de votre hébergement. Si cette méthode ne fonctionne pas (erreur 500, message non acheminés ...), utiliser la méthode "mail" ou "sendmail" en modifiant le fichier wiki.php du répertoire tools/contact, par exemple, remplacer define('CONTACT_MAIL_FACTORY', 'smtp'); par define('CONTACT_MAIL_FACTORY', 'mail'); (ligne 16).

Handler /mail

Aller sur le lien http://yeswiki.net/wakka.php?wiki=DocumentationContact/mail
(cependant cette action n'est visible que pour les administrateurs)
Quand on est administrateur (et connecté comme tel au wiki) et qu'on ajoute à la barre d'adresse d'une page l'action "/mail", cela affiche une boite de dialogue pour entrer :
- le mail de l'expéditeur
- l'objet du mail
- le mail du destinataire (peut-on indiquer plusieurs destinataires ?)
- un bouton "envoyer"
L'action envoie alors un mail au destinataire, contenant le contenu de la page à laquelle on a ajouté l'action "/mail".

Créer une nouvelle page


Le concept des ChatMots

Chaque page d'un wiki porte un nom contenant au moins deux majuscules non consécutives, autrement dit un mot à deux bosses ou ChatMot.
Ce nom doit être
  • tout attaché,
  • sans accent et
  • sans caractère spéciaux.
ChatMot
Pour "masquer" ce chatmot et le faire apparaître en tant que "ceci est un chatmot",

Créer une page et son lien dans le wiki

Pour ajouter une page il suffit d'
  • Ecrire un ChatMot dans une page existante (dans une page menu ou dans une page classique).
  • Sauver la page, le ChatMot apparaît et forme un lien permanent vers cette nouvelle page. Il est suivi d'un petit crayon.
  • Cliquer sur le lien, vous arrivez dans le mode édition de la nouvelle page.
  • Ecrivez et cliquez sur "sauver"

Pour aller plus loin

Lors de la création d'une nouvelle page, celle-ci adoptera un format par défaut. Mais vous pouvez choisir de le modifier et d'ajouter des colonnes. Pour voir comme faire, c'est par ici

Créer un lien

vers une autre page du wiki ou vers un autre site


Lien interne (au sein du wiki)

La caractéristique qui permet de reconnaître un lien dans un wiki : c'est un ChatMot (un mot avec deux bosses).
On écrit le ChatMot de la page YesWiki vers laquelle on veut pointer.
  • Si la page existe, un lien est automatiquement créé
  • Si la page n'existe pas, apparaît un lien avec crayon permettant de créer la page (voir DocumentationCreerUnePage). En cliquant dessus on arrive vers la nouvelle page en mode "Édition", après avoir sauvé la page, le lien sera actif.

Lien externe (vers d'autres sites internet)

Il suffit de coller l'adresse du site dans la page wiki
Exemple : http://outils-reseaux.org

Personnaliser le texte des liens

Les liens insérés ci-dessus sont donc soit des ChatMots soit des adresse url ... pas forcément jolis.
On peut personnaliser le texte de ces liens. Pour cela on utilise les double crochets [[ ]]
Entre les crochets, on indique en premier le lien (ChatMot ou url) puis le texte que l'on souhaite voir.



Remarque
Cela fonctionne aussi avec les adresses mail

  • La ligne suivante... [[mailto:accueil@outils-reseaux.org Envoyer un mail]]
  • ...apparaîtra ainsi : Envoyer un mail


Devenir propriétaire d'une page et gérer ses droits d'accès


Pour devenir propriétaire d'une page

  • On devient automatiquement propriétaire des nouvelles pages que l'on crée lorsque l'on est connecté sous son nom YesWiki
  • Pour devenir propriétaire d'une page sans propriétaire, il suffit de cliquer sur Appropriation (en bas de page)
image Appropriation.png (14.1kB)
Si vous êtes identifié, on vous propose de vous approprier la page
image VousEtesProprio.png (16.5kB)
Et voilà
  • On ne peut devenir propriétaire d'une page qui a déjà un propriétaire, mais le propriétaire lui même peut décider de changer de propriétaire (cf. ci-dessous la rubrique "pour changer de propriétaire")
--> le propriétaire peut gérer les droits d'accès à sa page
image EditerPermissions.png (14.2kB)
Et maintenant, on peut éditer les permissions (mais aussi supprimer la page)

Les trois types de droits d'accès d'une page

Chaque page possède trois niveaux de contrôle d'accès qui permettent :
  • de lire la page
  • de lire, d'écrire ou de modifier la page
  • de lire et de laisser un commentaire sur la page
Nota : pour toute nouvelle page créée, YesWiki applique les droits d'accès définis par défaut lors de l'installation du Wiki
sur ce YesWiki, les droits en lecture et écriture sont par défaut, ouverts à tout internaute.

Allez plus loin Pour ceux qui sont en capacité de modifier le fichier wakka-config.php. Il est possible d'attribuer, par défaut à toute nouvelle page du wiki, des droits d'accès personnalisés.
Pour ce faire modifier ces 3 lignes en remplaçant les * par la syntaxe voulue (voir ci-dessous)
'default_write_acl' => '*',
'default_read_acl' => '*',
'default_comment_acl' => '@admins',


Pour gérer les droits d'accès d'une page

(il faut être propriétaire de la page pour modifier les droits d'accès)
  1. cliquer sur l'option (en bas) "Éditer permissions"
    • un tableau à trois colonnes s'affiche (une colonne par type de droit : lecture, écriture, commentaire)
  2. compléter le tableau selon le code suivant :
    • le nom YesWiki d'un utilisateur autorise seulement cette personne, ex : JamesBond
    • le symbole étoile * désigne tous les utilisateurs
    • le symbole plus + désigne les utilisateurs enregistrés
    • le symbole pourcentage % désigne le créateur de la fiche/page
    • le symbole point d'exclamation ! permet la négation, par exemple !JamesBond signifie que JamesBond ne doit pas avoir accès à cette page
    • le symbole arobase @ permet d'autoriser l'accès à un groupe d'utilisateur (ex @admins) : cela donnera les droits à tout un groupe et donc à tous les membres qui lui appartiennent (pour plus de détails cf. page sur la gestion des groupes d'utilisateur.


--> les personnes faisant partie du groupe admin ont tous les droits en lecture, écriture et commentaire par défaut.
image EditerPermissionsLolo.png (22.0kB)
On peut changer les droits en lecture, écriture et commentaires

Pour changer de propriétaire

  • le propriétaire d'une page ou un administrateur peut décider de changer de propriétaire
  • sous le tableau de gestion des droits (cf. ci-dessus) un menu déroulant permet de changer le propriétaire d'une page.

Apprendre à gérer les droits d'accès en vidéo



Éditer une page

Un wiki est organisé autour de pages de contenus et de zones de menus de navigation (horizontal et/ou vertical...).
Il y a trois manières pour éditer et modifier une page. Les trois ayant le même résultat, utilisez celle qui vous convient.
Vous savez que vous êtes en mode édition quand la barre d'édition suivante apparaît
image BarreEdition.png (7.4kB)
Lien vers: DocumentationEdition
Barre d'édition de Yeswiki

Double-clic

image ImpEcran.png (76.1kB)
Le double clic est une spécificité de Yeswiki : pour modifier le contenu d'une page il vous suffit de double-cliquer sur le contenu à modifier. Vous atteignez ainsi le mode édition de la page.

Le double-clic ne fonctionne pas ? Cette page a été protégée en écriture. Voir le tutoriel sur les droits

"Éditer la page"

image EditerPage.png (7.0kB)
En bas d'une page wiki, vous trouvez un lien "Éditer la page" avec une icône crayon. Ce lien vous mène lui aussi au mode édition de la page.

Le lien "éditer la page" n'existe pas ? Cette page a été protégée en écriture. Voir le tutoriel sur les droits

Ajouter "/edit" à l'url

image ImgUrl1.png (2.2kB)
Dans la barre du navigateur se trouve l'adresse URL de la page sur laquelle vous vous trouver. Si vous ajouter "/edit" à la fin de celle-ci (puis en validant avec la touche [ENTREE]) vous atteignez le mode édition.

Le mode édition n'apparaît pas après l'ajout de "/edit" ? Cette page a été protégée en écriture. Voir le tutoriel sur les droits

Une fois vos modifications effectuées, vous enregistrez en cliquant sur le bouton "Sauver" en bas de page.
image sauverbis.png (2.9kB)

Voir aussi


Modifier son mot de passe

  1. allez sur la page ParametresUtilisateur dans la partie "changement de mot de passe"
    • (également accessible par le menu configuration "roue crantée" : "se connecter")
  2. mettez votre ancien mot de passe dans le champ "votre ancien mot de passe"
  3. mettez un nouveau mot de passe dans le champ "nouveau mot de passe"
  4. cliquez sur "changer"

Récupérer son mot de passe en cas d'oubli

Si vous avez perdu votre mot de passe,
  1. allez sur la page ParametresUtilisateur (accessible depuis le menu "roue crantée" : "se connecter"
  2. voir plus bas "permettre aux utilisateurs de récupérer leur mot de passe par mail en cas d'oubli)
  3. allez dans la partie "récupération du mot de passe"
  4. ajoutez votre mail dans le champ "email" et cliquez sur "envoyer"
  5. vous allez recevoir un nouveau mail avec un lien pour générer un nouveau mot de passe
  6. changez votre mot de passe pour un nouveau que vous n'oublierez pas ;-)

Permettre aux utilisateurs de récupérer leur mot de passe par mail

ATTENTION : cette fonctionnalité nécessite la version Cercopithèque
il suffit d'insérer ce bout de code (on parle "d'action" quelque part. La page ParametresUtilisateur semble assez appropriée
{{lostpassword}}


Activité

Duplicateur

Googleanalytics

Extension ipblock

Permet de bloquer l?accès par provenance de pays en prenant des plages d'ip supposées appartenir a ce pays.
Cette méthode ne fonctionne plus très bien actuellement, car il est possible de passer par un VPN ou des réseaux type TOR.

Configuration

Aller sur le fichier tools/ipblock/handlers/page/__edit.php et mettre les pays souhaités (sous format iso en 2 lettres : FR pour france, DE pour allemagne, etc..) dans la variable $pays_bloque
$pays_bloque = array("ID", "MY");

l'Extension Pdf

  • 186 Ko génére un pdf à partir d'une page wiki
  • utiliser un [[ PrincipeDesHandlers handler]] /pdf pour afficher la page en Pdf dans votre navigateur.

Qrcode


Cette extension permet d'ajouter dans le petit bouton partager en bas de page un qrcode spécifique à la page.
En le récupérant, vous obtenez un qrcode pointant vers la page en question.

Tableau


donne :

ligne 1 colonne 1 ligne 1 colonne 2 ligne 1 colonne 3
ligne 2 colonne 1 ligne 2 colonne 2 ligne 2 colonne 3
ligne 3 colonne 1 ligne 3 colonne 2 ligne 3 colonne 3
ligne 4 colonne 1 ligne 4 colonne 2 ligne 4 colonne 3

Webhooks


Webhooks sortants qui sont appelés à chaque addition/modification/suppression d'un élément du Bazar.

Page Github: https://github.com/YesWiki/yeswiki-extension-webhooks

Configuration


Après l'installation, rendez-vous sur la page principale du Bazar et vous trouverez en bas le formulaire pour ajouter des webhooks sortants.

- A gauche vous pouvez choisir le format de sortie du webhook (Brut, Mattermost, Slack)
- A droite vous devez entrer l'URL du webhook à appeler

Chaque fois que vous cliquez sur "Mettre à jour", une nouvelle colonne est ajoutée.
Si vous souhaitez effacer un webhook, il suffit de mettre un URL vide et l'élément sera supprimé lors de la mise à jour.

Mattermost


Pour permettre à une chatroom Mattermost (comme Framateam) de recevoir des messages à chaque fois qu'un élément est ajouté/édité/supprimé, suivez ces instructions:

- Connectez-vous à votre chatroom Mattermost en tant qu'administrateur
- Dans le menu principal, choisissez "Intégration"
- Choisissez "Webhooks entrants"
- Créez un webhook avec les configurations de votre choix
- Sur la page Bazar de votre wiki, choisissez "Mattermost" et copiez l'adresse fournie par Mattermost.

C'est fait !

Slack


Pour connecté votre Bazar à une chatroom Slack, suivez le guide ici: https://api.slack.com/incoming-webhooks

Sur la page Bazar de votre wiki, choisissez "Slack" et copiez l'adresse fournie par Slack.

Brut


Si vous choisissez le format Brut, toutes les informations à propos de l'élément Bazar ajouté/édité/supprimé sera POSTée à l'URL indiquée. C'est une option qui conviendra plus à des développeurs.

En plus, ces informations seront envoyées:

- action: type d'action effectuée (add/edit/delete)
- text: texte formatté qui décrit l'action effectuée (la même que celle envoyée à Mattermost/Slack)

Si vous souhaitez voir les données envoyées par le webhook, vous pouvez utiliser une URL spéciale de test pour les webhooks entrant : http://VOTRE_ADRESSE.COM/?BazaR&vue=test-webhook. Toutes les données envoyées sur cette URL seront insérées dans la table yeswiki_triples.

Wikical

Wikicolor


Wikicolor permet d'afficher du texte dans une couleur spécifique, via la syntaxe :

  • ~~(yellow)en rouge~~
  • ~~(blue)en rouge~~
  • ~~(brown)en rouge~~
  • ~~(green)en rouge~~
  • ~~(palevioletred)en rouge~~

Configurer YesWiki : le fichier wakka.config.php

Une fois le YesWiki créé, on peut aller éditer le fichier wakka.config.php, se trouvant à la racine du dossier du YesWiki, accessible par FTP. Le fichier de configuration déclare un tableau avec des valeurs pour chaque élément de configuration.

Voici le contenu du fichier de configuration par défaut, voir les commentaires en fin de ligne pour le détail de chaque élément de configuration :

<?php
// wakka.config.php créée Fri Jun  8 20:58:37 2012
// ne changez pas la wikini_version manuellement!

$wakkaConfig = array ( // tableau de configuration
  'wakka_version' => '0.1.1', // Ne pas toucher, version originale du code de wakka, ancêtre de wikini
  'wikini_version' => '0.5.0', // Ne pas toucher, version originale du code de wikini, ancêtre de YesWiki
  'debug' => 'no', // active le mode de débogage si passé à la valeur 'yes' (infos sur le nombre de requêtes, le temps écoulé et force l'affichage des erreurs php pour les développeurs) astuce : on peut aussi passer &debug dans l'url pour debugguer
  'mysql_host' => 'localhost', 
  'mysql_database' => 'yeswiki',
  'mysql_user' => 'yeswiki',
  'mysql_password' => '#######',
  'table_prefix' => 'yeswiki_',
  'root_page' => 'PagePrincipale',
  'wakka_name' => 'YesWiki de présentation', // titre du YesWiki
  'base_url' => 'http://localhost/?', // url d'accès au site
  'rewrite_mode' => '0', 
  'meta_keywords' => 'yeswiki, wiki, gpl, php, super', // mot clé pour le référencement (séparés par des virgules, par plus de 20-30)
  'meta_description' => 'Un site de présentation de ce merveilleux outil qu\'est YesWiki', // description du site en une phrase, pour le référencement (Attention : ne pas mettre de "." (point) dans ces méta descriptions
  'action_path' => 'actions',
  'handler_path' => 'handlers',
  'header_action' => 'header',
  'footer_action' => 'footer',
  'navigation_links' => 'DerniersChangements :: DerniersCommentaires :: ParametresUtilisateur',
  'referrers_purge_time' => 24,
  'pages_purge_time' => 90, // nbr de jours après lesquels les révisions sont effacées
  'default_write_acl' => '*', // droits d'écriture par défaut des pages
  'default_read_acl' => '*', // droits de lecture par défaut des pages
  'default_comment_acl' => '*', // droits des commentaires
  'preview_before_save' => '0',
  'allow_raw_html' => '1', // autorise le html
);

Les éléments que vous pouvez rajouter sur wakka.config.php

Mon wiki se trouve à l'adresse suivante http://site-coop.net/Louise, je souhaiterais qu'il se nomme maintenant http://site-coop.net/Mathieu
- Via ftp, il faut changer le nom du dossier Louise en le nommant Mathieu
- dans le fichier wakka.config.php, il faut changer la ligne
'base_url' => 'http://site-coop.net/Louise/?" 

en
'base_url' => 'http://site-coop.net/Mathieu/?"

et tester si tout fonctionne dans votre navigateur (attention les majuscules et minuscules ont leur importance)

'BAZ_ENVOI_MAIL_ADMIN' => true


Quelques paramètres peuvent être ajoutés au fichier de configuration wakkaconfig afin de gérer plus finement les droits d'édition des pages et fiches bazar de votre wiki. L'objectif de ces ajouts vise à ne pas rendre trop complexe l'édition des pages tout en luttant contre le spam devenu fléau ces derniers temps !

Les paramètres ajoutables au wakkaconfig


  'password_for_editing' => 'votremotdepasse',
  'password_for_editing_message' => 'un message qui apparait au dessus du champ mot de passe',
  'use_hashcash' => true, //ne pas toucher pour l'instant
  'use_nospam' => true, // ne pas toucher pour l'instant
  'use_alerte' => true,
  'use_captcha' => true, 


Quelques détails

Paramètre Actions
'password_for_editing' demande un mot de passe AVANT de rentrer en mode édition que ce soit pour les pages wiki ET les fiches bazar. Si vous êtes connectés, ce mot de passe ne vous est pas demandé
'password_for_editing_message' vous pouvez indiquer un message afin de donner à vos usagers une info sur le mot de passe à rentrer (on fait le pari que les turcs spanners ne le liront pas ;-)
'use_captcha' => true place un captcha en bas des pages wiki, à remplir avant de pouvoir faire valider. A remplir même si vous êtes connectés



  'favorite_theme' => 'yeswiki', // theme par défaut, présent dans /themes ou /tools/templates/themes
  'favorite_squelette' => 'responsive-1col.tpl.html', // squelette par défaut
  'favorite_style' => 'yellow.css', // style css par défaut
  'favorite_background_image' => 'graphy.png', // image de fond par défaut, située dans /files/backgrounds
  'hide_action_template' => '1', // Force le template par défaut et empêche la modification du thème lors de l'édition.



  'hide_action_template' => '1', // Cache le bouton thème et empêche la modification du thème lors de l'édition.


Par défaut les cartes sont centrées sur le centre de la France et affiche l'intégralité de la France. On peut forcer le centre ailleurs en configurant dans wakaconfig :

  'baz_map_center_lat' => '50.725777', //permet de caler les cartes utilisées dans le wiki sur cette latitude
  'baz_map_center_lon' => '4.867795', //permet de caler les cartes utilisées dans le wiki sur cette longitude
  'baz_map_zoom' => '8', //permet de caler les cartes utilisées dans le wiki sur ce niveau de zoom


Permet de saisir une fiche formulaire même si la création de page YesWiki est interdite

  'default_write_acl' => '@admins', // ceci interdit la création de pages sauf pour les @admins
  'bazarIgnoreAcls' => true, // ceci permet de passer au-dessus de cette interdiction uniquement via les formulaires


si la base mysql utilise un autre port que 3306, vous pouvez spécifier le numéro du port privé

 'mysql_port' => 'n° du port',


pour ouvrir une image par défaut : il faut mettre un lien vers l'image dans le wakka.config.php
idéalement, l'image doit faire 1200x630 selon les specs imposées par facedebouc
par défaut il prend cette image, et si une image est présente dans la page (mise avec attach) ou une fiche bazar avec bf_image , il remplace par cela

'opengraph_image' => 'https://domaine.ext/nomdelimage.jpg',


réparer les wikis qui n'envoient pas les mails ;-(

La réponse sur certains hébergements, l'envoi de mail par défaut ne marche pas , il faut créer un compte smtp
et donc rajouter dans le fichier wakka.config.php les parametres suivants
'contact_mail_func' => 'smtp',
  'contact_smtp_host' => 'ssl://<mon serveur smtp>:465',
  'contact_smtp_user' => 'user@mail.ext',
  'contact_smtp_pass' => '<monpassword>',


Attention, tous les serveur mail n'accepte pas de jouer ce jeu.

avec sendinblue

créez-vous un compte puis allez dans les paramètres (via ce lien ) chercher votre clé smtp (limitée à 300 mails par jour)
'contact_mail_func' => 'smtp',
  'contact_smtp_host' => 'smtp-relay.sendinblue.com:587',
  'contact_smtp_user' => 'monmail@pourmoncomptesendinblue.com',
  'contact_smtp_pass' => '<ma cle smtp>',

avec gmail

Gmail le fait mais avec une limite d'envoi journalière et souvent un blocage de scurité à lever via un paramètre : plus d'infos ici
https://support.google.com/accounts/answer/6010255
'contact_smtp_host' => 'ssl://smtp.gmail.com:465',


Autre piste possible, acheter un nom de domaine chez gandi et utiliser le smtp lié
Lien vers la doc http://


Gérer des groupes d'utilisateurs


Utiliser l'action {{editgroups}}. Pour utiliser cette action, il faut être identifié et être du groupe @admins
  • (après l'installation de YesWiki, seul le compte maître créé lors de l'installation fait partie du groupe @admins)
image admingroups.png (7.3kB)
Interface de gestion des groupes

Pour ajouter un utilisateur à un groupe

  1. Cliquer sur "voir"
  2. Ajouter le nom du l'utilisateur dans la fenêtre "éditer le groupe"" (en faisant retour à la ligne entre deux utilisateurs et surtout ne pas mettre de virgule)
  3. Cliquer sur enregistrer
image EditerGroupe.png (14.3kB)
Pour ajouter des compte utilisateurs à un groupe

Pour créer un nouveau groupe

  1. Écrire le nom groupe dans le champ "créer un nouveau groupe"
  2. Cliquer sur définir

Pour utiliser la gestion des groupes

Cela se fait dans les pages de gestion des droits
  1. ajouter dans le champ concerné @ suivi du nom d'un groupe (ex @admins) Cela donnera les droits à tout un groupe et donc à tous les membres qui lui appartiennent.

Liste des handlers disponibles par défaut


Rajouter dans la barre d'adresse (à la fin de l'URL) :


/edit : pour passer en mode Edition
/revisions : pour voir les versions de l'historique
/slide_show : pour transformer le texte en diaporama
/diaporama : idem slide_show en un peu différent
/mail : envoie la page en mailing
/raw : affiche le code wiki non formaté de la page
/deletepage : si vous êtes propriétaire de la page, vous pouvez la supprimer
/claim : si la page n'a pas de propriétaire, vous pouvez vous l'approprier
/acls : si vous êtes propriétaire de la page, vous pouvez gérer les droits
/share : pour afficher des possibilités de partage sur les réseaux sociaux, et pour générer un code embed (iframe) qui permettra d'afficher la page sur un site externe.
/dbutf8 : s'utilise en tant qu'admin pour passer les wikis antérieur à 2018 en utf8
/update : permet lors du passage de cerco à doryphore, de mettre à jour plein de trucs nécessaires à son bon fonctionnement
&debug : permet d'afficher en bas de page toutes les actions effectuées au niveau informatique, permet de repérer les bugs, causes de plantage...

Liés à l'extension ebook

/epub : permet de générer un livre numérique au format .epub lisible sur liseuse, tablette ou avec Calibre
/pdf : permet de générer un pdf

Créer son compte et/ou s'identifier

INSERER ICI UN MOT RELATIF A action login

création d'un compte YesWiki

  1. aller sur la page spéciale ParametresUtilisateur
  2. choisir un "nom YesWiki" qui comprend 2 majuscules - exemple : JamesBond
    • pour en savoir plus sur le concept du ChatMot, rendez-vous sur la page créer un lien
  3. choisir un mot de passe et donner un mail
  4. cliquer sur "Nouveau compte"

S'identifer sur yeswiki

  1. aller sur la page spéciale ParametresUtilisateur,
  2. remplir le formulaire avec son nom YesWiki et son mot de passe
  3. cliquer sur "connexion"

Installer YesWiki sur son espace Internet

Pré-requis

Préparation

  • Décompressez le fichier téléchargé sur votre disque dur et renommez-le à votre convenance (par exemple monYeswiki)
  • Créer une base de données vide sur votre espace d'hébergement (par exemple mabase).
  • Le plus souvent, il vous faudra créer un utilisateur pour cette base de donnée avec un identifiant et un mot de passe (par exemple identifiant = moi, mot de passe = oups)
  • Dans la mesure du possible évitez les identifiant avec "tiret" (genre moi-moi) car ça crée parfois une erreur lors de l'installation
  • Noter le nom de votre base de données et les identifiants et mot de passe d'accès à celle-ci.

Upload par FTP

  • Connectez-vous à votre espace personnel par FTP (filezilla par exemple)
  • Glissez et déposez votre dossier local (monYeswiki) sur votre espace personnel
  • Sur certains hébergements, il faut attribuer des droits d'accès en écriture au dossier principal du wiki (monYeswiki) : mettre les droit d'accès en écriture pour tous (chmod 777), en faisant clic droit sur le dossier puis "droits d'accès au dossier" dans filezilla)
    • Il est bon aussi (pour éviter des erreurs futures lors de l'insertion d'images dans le wiki par exemple) de déjà attribuer au dossier "Cache" et "File" des droits d'accès en écriture pour tous (777)
  • Fermez le client Ftp. Nous allons pouvoir configurer le yeswiki.

Paramétrage du YesWiki

  • Ouvrez votre navigateur et tapez l'url de votre site perso jusqu'au répertoire créé.
  • Une page de configuration s'ouvre.
  • Renseignez le nom de votre serveur MySQL (donné par votre hébergeur, en général c'est "localhost")
  • Renseignez le nom de votre base de données MySQL (dans notre exemple : mabase) (attention en php 5.5, ne pas mettre de tiret dans les noms de bases mysql)
  • Renseignez le nom d'utilisateur et le mot de passe de votre base de données MySQL (dans notre exemple : moi et oups)
  • Renseignez le préfixe des tables : par défaut yeswiki_ (vous pouvez laisser comme cela)
  • Modifiez le nom de votre YesWiki (cela deviendra le titre de votre wiki affiché en grand en haut du site... modifiable par après si nécessaire - ne pas mettre de caractères spéciaux html, typiquement "&Eacute", "&Egrave"; )
  • Renseignez la page d'accueil de votre YesWiki. Ceci doit être un NomWiki. : par défaut PagePrincipale (vous pouvez laisser comme cela)
  • Renseignez les champs mots-clés et description si vous le souhaitez (si vous laissez vide cela ne posera pas de problème)
  • Renseignez les champs (Administrateur, Mot de passe, Confirmation du mot de passe et Adresse e-mail) afin de créer un compte administrateur pour gérer votre wiki
  • Les pages par défaut de YesWiki nécessitent du code html pour fonctionner cocher la case "Autoriser l'insertion de HTML brut.". Vous pourrez alors plus facilement intégrer des widgets HTML.

Conclusion

Les tables MySQL sont automatiquement créées.
Si tout a bien fonctionné vous en avez confirmation.
Le fichier de configuration est écrit. C'est terminé.

En vidéo

Déposer mon wiki sur mon hébergement avec Filezilla


créer mon yeswiki



Que faire en cas d'erreur ligne 97 dans wiki.php ?

Il arrive que lors de l'installation, une des tables (prefixe_nature) ne puisse être créée par yeswiki. Ceci entraîne une erreur à la ligne 97 du wiki.php et empêche l'affiche de votre yeswiki ;-(

Pour résoudre ce problème (pas très grave)

  • éditer votre fichier wiki.php (situé dans tools/bazar/wiki.php avec l'aide d'un éditeur html (comme Atom par exemple)
  • remplacer dans wiki.php le bout de code
    if ($resultat->numRows() == 0) {
    
    par
    if (FALSE && $resultat->numRows() == 0) {
    
  • créér la table préfixe_nature (prefixe est à remplacer par votre préfixe de table,, indiqué lors de l'installation du wiki)
    • pour ce faire, rendez-vous dans votre phpmyadmin et rentrez y avec votre nom d'user et mot de passe (dans notre exemple moi et oups)
    • sélectionnez votre base de donnée (dans notre exemple mabase)
    • exécutez cette requête SQL
      • CREATE TABLE IF NOT EXISTS `votrepréfixe_nature` (
          `bn_id_nature` int(10) unsigned NOT NULL DEFAULT '0',
          `bn_label_nature` varchar(255) DEFAULT NULL,
          `bn_description` text,
          `bn_condition` text,
          `bn_ce_id_menu` int(3) unsigned NOT NULL DEFAULT '0',
          `bn_commentaire` tinyint(3) unsigned NOT NULL DEFAULT '0',
          `bn_appropriation` tinyint(3) unsigned NOT NULL DEFAULT '0',
          `bn_image_titre` varchar(255) NOT NULL DEFAULT '',
          `bn_image_logo` varchar(255) NOT NULL DEFAULT '',
          `bn_couleur_calendrier` varchar(255) NOT NULL DEFAULT '',
          `bn_picto_calendrier` varchar(255) NOT NULL DEFAULT '',
          `bn_template` text NOT NULL,
          `bn_ce_i18n` varchar(5) NOT NULL DEFAULT '',
          `bn_type_fiche` varchar(255) NOT NULL,
          `bn_label_class` varchar(255) NOT NULL,
          PRIMARY KEY (`bn_id_nature`)
        ) ENGINE=MyISAM DEFAULT CHARSET=latin1;
        
    • Cette requête va créer la table manquante.

Cas particulier : pour les installation sur un serveur local WAMP

Si vous installez votre Yeswiki sur votre PC en utilisant WAMPServer,
Vous aurez probablement un message d'erreur lorsque vous souhaitez "Sauver" une page.
Le problème peut être réglé en rajoutant la ligne 'use_hashcash' => false, dans le wakka.config.php
Et voilà votre wiki devrait fonctionner maintenant ;-)

Intégrer des éléments d'ailleurs (vidéos, pad...)


Pour insérer des widgets

Un widget est un petit module qui permet d'embarquer et de re-publier dynamiquement des contenus et fonctions issus de services proposés par d'autres sites internet.
On peut donc insérer des widgets , grâce à leur code html. Il suffit pour cela récupérer les bouts de codes qui vous sont proposés par des sites tiers et de les incorporer dans votre page en ajoutant avant et après deux guillemets.
""coller ici le code HTML fourni par le site tiers""


Pour insérer un pad sur une page du wiki
  • sur votre pad, cliquer sur le bouton "partager" en haut à droite du pad et copier le code <iframe>....
  • coller ce code là où vous le souhaitez dans votre wiki (en oubliant pas de mettre deux doubles guillemets avant et après votre code)

""<iframe name='embed_readwrite' src='http://pad.coop-tic.eu/p/testIframe?showControls=true&showChat=true&showLineNumbers=true&useMonospaceFont=false' width=600 height=400></iframe>""



Pour insérer une vidéo sur une page du wiki
  • aller sur youtube ou viméo ou un autre site de vidéo.Choisissez votre vidéo, cliquer sur partager/intégrer et copier le code qui devrait commencer par <iframe>....
  • coller ce code là où vous le souhaitez dans votre wiki (en oubliant pas de mettre deux doubles guillemets avant et après votre code)
""<iframe width="560" height="315" src="https://www.youtube.com/embed/VxpI99Q_dNE?list=PLaQm6xd2SrjYXoYn-mwgDz6nPBEhe7l_L" frameborder="0" allowfullscreen></iframe>""



Pour insérer un iframe : en gros une partie d'un autre site...
""<iframe width=100% height="1250" src="https://cocotier.xyz" frameborder="0" allowfullscreen></iframe>""




Astuce pour rendre redimensionnable la largeur de certaines iframes

Pour un wiki dont la page s'adapte à la taille de la fenêtre (quand on n'est pas en plein écran), on peut vouloir que la largeur de certaines iframe s'adapte de même. Pour cela :
  • on ne met pas de valeur numérique pour le width
  • ou bien on remplace par width="100%" overflow="auto"

Quelques exemples en vidéo

{ {attach file="iconvideo.png" desc="image iconvideo.png (1.8kB)" size="original" class="left original"}}Intégrer une vidéo youtube dans yeswiki
{ {attach file="iconvideo.png" desc="image iconvideo.png (1.8kB)" size="original" class="left original"}} Intégrer un pdf avec scribd
{ {attach file="iconvideo.png" desc="image iconvideo.png (1.8kB)" size="original" class="left original"}}Intégrer un diaporama google
{ {attach file="iconvideo.png" desc="image iconvideo.png (1.8kB)" size="original" class="left original"}}Intégrer une galerie picasa
{ {attach file="iconvideo.png" desc="image iconvideo.png (1.8kB)" size="original" class="left original"}}Intégrer une carte google


{ {attach file="logo.png" desc="image logo.png (43.8kB)" size="original" class="left"}}


démo de l'action

Joindre un fichier : image, son, téléchargement ...

En cliquant sur le bouton "Joindre / Insérer un fichier", vous aurez la possibilité de choisir un fichier se trouvant sur votre ordinateur.
image dossier.png (0.1MB)
choisir son fichier à télécharger sur le wiki

En fonction du type de fichier, YesWiki vous proposera des interfaces différentes :
  • s'il s'agit d'un fichier image (svg, png, gif, jpg, bmp...), s'affichera l'interface suivante
image joindreimage1.png (41.1kB)
On peut y choisir l'alignement de l'image, sa taille à l'affichage ainsi que le texte qui s'affichera au survol
image joindreimage2.png (48.4kB)
En cliquant sur Paramètres avancés, on pourra ajouter un lien associé, des effets graphiques ainsi que modifier le texte alternatif

  • Pour tout autre fichier (.doc, .pdf, .xls, .odt, .txt...) vous pourrez modifier le texte associé par défaut "Télécharger le fichier nom du fichier (taille du fichier)"
image joindretxt.png (32.6kB)
On peut modifier le texte qui servira de lien vers ce fichier.
  • Les fichiers de type audio (mp3) et vidéo (flv) seront interprétés sous forme de lecteur audio.
  • les fichiers de type freeplane ou freemind (.mm) seront affichés sous forme de carte heuristique cliquable.

Une fois un fichier joint à une page, il est encore possible de modifier le texte qui lui est associé, même si la page a été sauvegardée. Pour cela il faut re-éditer la page, trouver dans la page l'instruction (l'action) qui concerne ce fichier, elle aura cette forme :
{{attach file="exemple.txt" desc="Telecharger le fichier exemple.txt (2.7kB)"}}

exemple.txt correspond au nom de votre fichier et "Telecharger le fichier exemple.txt (2.7kB)" correspond au texte qui servira de lien vers ce fichier.

Pour changer ce texte, il faut modifier le libellé entre guillemets après desc, soit par exemple :
{{attach file="exemple.txt" desc="Fichier exemple en téléchargement"}}.

Le nouveau texte associé au fichier sera donc "Fichier exemple en téléchargement".
Il ne vous reste plus qu'a sauver votre page pour prendre en compte ces modifications.

Pour toutes les infos sur l'action allez sur la page AttacH

On dispose d'un lien vers l'image ou le fichier

Si le fichier à joindre est déjà stocké en ligne, il est possible de créer un lien vers celui-ci. On utilise les doubles crochets : il faut saisir l'adresse où trouver le fichier suivie du texte de remplacement.

  • [[http://mondomaine.ext/image.jpg texte de remplacement de l'image]] pour les images.
Affichera l'image

  • [[http://mondomaine.ext/document.pdf texte du lien vers le téléchargement]] pour les documents.
apparaîtra ainsi : texte du lien vers le téléchargement

Pour toutes les infos sur les liens allez sur la page DocumentationCreerUnLien


Action Login

L'action Login permet d'afficher un formulaire d'identification simplifié et configurable.
De plus, quand on arrive sur une page où il faut être identifié, un formulaire d'identification minimal sera proposé plutôt qu'un message d'erreur.

Installation

ATTENTION : cette extension est en cours de développement, elle est mise à disposition à des fins de test, l'utiliser en production serait risqué.


Paramètres des actions

Minimum {{login}}
Toutes options {{login template="minimal.tpl.html" class=" " signupurl=" " userpage=" " exitpage=" "}}

Description des paramètres :

  • template (facultatif) : choix du look du template. Choix possibles : default.tpl.html ou horizontal.tpl.html ou minimal.tpl.html (voir les exemples ci dessous. Si rien n'est entré, "default.tpl.html" est utilisé.
  • class (facultatif) : ajoute une classe CSS de votre choix au formulaire d'identification afin de personnaliser l'apparence et le positionnement.
  • signupurl (facultatif) : indique un lien vers la page pour faire une nouvelle inscription. Par défaut, il s'agit de la page ParametresUtilisateur.
  • userpage (facultatif) : quand on se connecte, on est redirigé vers le lien entré ici. Par défaut, on reste sur la page en cours. On peut aussi proposer comme paramètre : "user" pour que l'on soit redirigé vers la page de notre nom wiki.
  • exitpage (facultatif) : quand on se déconnecte, on est redirigé vers le lien entré ici. Par défaut, on reste sur la page en cours.

Exemples

Template par défaut

{{login}} donne à l'écran :

Template horizontal

{{login template="horizontal.tpl.html"}} donne à l'écran :

Template sans possibilité d'inscription

{{login signupurl="0"}} donne à l'écran :

Template minimal


C'est quoi une action, un handler, une extension ?

Action

Définition Une action exécute une série d'opérations et affiche le résultat obtenu à l'endroit où elle est décrite dans la page.
C'est utilisé par exemple pour afficher un bouton, la liste des utilisateurs, un nuage de mots-clés.
Il est possible de spécifier des paramètres afin de personnaliser ce résultat (ordre du tri, nombre d'entrées, taille...).

La liste des paramètres est indiquée sur la page de documentation de chaque action :
cf. Liste des actions

Certains paramètres peuvent être obligatoires.

Syntaxe
Une action s'écrit avec 2 accolades ouvrantes, suivi du nom de l'action, suivi par des éventuels paramètres, puis fermée par 2 accolades fermantes :
{{nomaction param1="valeur1" param2="valeur2" ... paramN="valeurN"}}


Action dépréciée
Une action qui fonctionne encore mais qui a été remplacée ou intégrée dans une nouvelle action et qui sera supprimée dans la prochaine version de "YesWiki".

Handler

Définition Un handler est une commande qui permet de modifier la façon d'afficher une page. On l'active en ajoutant à la fin de l'adresse URL, le signe / suivi du nom du handler.

Exemples

Ajouter /raw a la fin d'une adresse URL de YesWiki (dans la barre d'URL de votre navigateur), permet d'obtenir le contenu de la page sans interprétation, en syntaxe wiki.
http://yeswiki.net/cercopitheque/wakka.php?wiki=DocumentationFonctionsAvancees/raw

Ajouter /edit a la fin d'une adresse url de YesWiki (dans la barre d'url de votre navigateur), permet d'afficher la page en mode édition
http://yeswiki.net/cercopitheque/wakka.php?wiki=DocumentationFonctionsAvancees/edit

La liste des handlers existants est disponible sur la page Liste des handlers

Extension

Définition Une extension est un petit module optionnel que l'on pourra ajouter à son YesWiki de base pour par exemple voir les statistiques du wiki, inclure des espaces de coécriture ou pour récupérer des pages wiki au format PDF. Certaines actions sont réservées au compte super administrateur (en général WikiAdmin).

Les extensions permettent d'activer de nouvelles actions et handlers
Si un message d'alerte de type Action inconnue "toto" apparaît, soit vous avez mal orthographié votre action, soit l'outil correspondant n'est pas installé ou pas activé.

installation

Vous pouvez ajouter une extension en utilisant l'utilitaire de mise à jour disponible sur la page WikiAdmin. TODO: quelle version de YesWiki ? Sur Cercopithèque je ne trouve pas cette fonctionnalité.

Mise à jour simple

Si votre wiki est bien en version doryphore (installé après septembre 2020), il vous suffit de cliquer sur le menu roue crantée, d'accéder à la gestion du site, de cliquer sur l'onglet "Mise à jour et extension" puis de cliquer sur le bouton "mettre à jour".

Si vous ne voyez qu'un bouton "Réinstaller" vous n'avez rien à faire, c'est que votre wiki est déjà à jour !

Passer de la version cercopitheque à la version doryphore

Le passage de cercopithèque à doryphore nécessite quelques manipulation pour s'assurer un wiki fonctionnel et profitant de toutes les nouveautés.

/!\ Avant toute chose, faites un backup de votre ftp et de votre base de donnée.

Première étape : s'assurer d'avoir la dernière version de cercopithèque

Mettre à jour votre wiki avec la dernière version de cercopithèque via le bouton "mettre à jour" que vous trouverez dans Gestion du site > mise à jour et extensions
Vous devriez ensuite voir sur cette page une version du wiki équivalente à la version disponible sur le dépot.


Deuxième étape : installer la version doryphore

Après avoir récupéré la dernière versiond e doryphore sur le site, mettez votre wiki à niveau en l'installant via FTP.
Pour cela, vous pouvez suivre la procédure décrite ci-dessous.
Redez-vous sur la page Mise à jour (dans roue crantée > gérer le site)
Remplacez {{update}} par {{update version="doryphore"}}
Sauvegardez votre page
Cliquez sur le bouton "changer de version"
Passez à la troisième étape :p
  • Allez sur la page de téléchargement pour récupérer la dernière version
    • Une fois le fichier téléchargé dans votre ordinateur (il est en version .zip), double cliquez dessus pour le convertir en dossier : c'est dans ce dossier que sont écrites l'ensemble des nouveautés tant attendues ;-)
    • Ouvrez le serveur distant dans lequel est hébergé votre site Yeswiki en utilisant votre accès FTP
    • Pour bien effectuer le transfert, vous devez avoir une vue qui ressemble à peu près à ça :
image Capturedecran20171004a155050OK.jpg (0.2MB)
  • Les fenêtres qui nous intéressent sont celles marquées d'une croix rouge : à gauche le contenu des dossiers et fichiers fraîchement installés dans mon ordinateur à partir de la page de téléchargement, et à droite les mêmes dossiers et fichiers présents dans votre serveur distant, classés dans le même ordre, issus d'une version précédente et que nous nous apprêtons à mettre à jour
  • Afin de sécuriser le transfert, allez d'abord dans la fenêtre de droite, que nous appellerons désormais votre serveur distant, et sélectionnez le dossier "tools"
  • A ce stade, il y a deux hypothèses
    • soit vous possédez déjà un dossier nommé "tools.old" juste en dessous (c'est ce qui permet de revenir en arrière en cas de mise à jour délicate). C'est le cas ? Supprimez-le (clic droit et supprimer), puis renommez juste au-dessus le dossier "tools" en "tools.old".
    • soit vous n'en avez pas : il vous suffit de renommer votre dossier "tools" en "tools.old"
  • Bravo, ça c'est fait, nous pouvons entamer la phase "roulement de tambours, concentration extrême" ! Allez dans la fenêtre de gauche, cliquez n'importe où et sélectionnez l'ensemble de son contenu (chez Mac c'est le raccourci cmd-A qui permet cette opération). Votre fenêtre doit ressembler à ça (tout est surligné en bleu) :
image Capture_decran_20171004_a_160811.png (0.1MB)
  • Effectuez alors un clic droit, et cette petite fenêtre va apparaitre
image Capture_decran_20171004_a_160947.png (0.1MB)
  • Sélectionnez "envoyer" (flèche rouge qui pointe vers le haut), et l'opération de transfert va démarrer
  • Attention ! Vous allez sans doute voir apparaître une fenêtre qui ressemble à ça :
image Capture_decran_20180130_a_151315.png (0.1MB)
  • Normal, le nom des fichiers est le même, mais pas de soucis, vous pouvez cocher les cases "remplacer" et "toujours effectuer cette action" pour ne pas avoir à y revenir, comme ci-après :
image Capture_decran_20180130_a_151333.png (0.1MB)
  • Cliquez sur "OK" pour valider cette commande, et cette fois vous pouvez attendre tranquillement la fin du transfert.
  • Dans votre ftp, ouvrez le fichier wakka.config, à la ligne'yeswiki_version', remplacez cercopitheque par doryphore
  • Une fois l'opération de transfert entièrement achevée (quelques minutes en fonction du débit de votre connexion) et votre fichier config mis à jour, vous pouvez tout simplement aller sur votre site pour découvrir les nouvelles fonctionnalités de votre Wiki fraîchement mis à jour.

Troisième étape : UPDATE

Mettez à jour tout plein de trucs nécessaires au passage à doryphore :
Connectez-vous en admin et ajouter à la fin de l'URL /update

Quatrième étape : débarassez-vous de tous les petits bugs

Le thème margot appliqué de base, mais possible que votre fichier config dise encore l'inverse, pour cela
-> roue crantée
-> gestion du site
-> thème graphique
-> tout en bas de la page
sélectionner margot
Appliquer
Rendez-vous sur la page "PageRapideHaut" de votre wiki
Rentrez en édition
Remplacez le contenu par
{{moteurrecherche template="moteurrecherche_button.tpl.html"}}
{{buttondropdown icon="cog" caret="0"}}
 - {{login template="modal.tpl.html" nobtn="1"}}
 - ------
 - {{button nobtn="1" icon="fa fa-question" text="Aide" link="AidE"}}
 - ------
 - {{button nobtn="1" icon="fa fa-wrench" text="Gestion du site" link="GererSite"}}
 - {{button nobtn="1" icon="fa fa-tachometer-alt" text="Tableau de bord" link="TableauDeBord"}}
 - {{button nobtn="1" icon="fa fa-briefcase" text="Base de données" link="BazaR"}}
{{end elem="buttondropdown"}}


/!\ Si vous aviez déjà modifié ce menu, pensez à mettre y ajouter les lien précédemment présents en utilisant la synthaxe de l'action Button.



Mettre à jour la navigation de gestion
Cela vous assurera d'être sur une organisation à jour de la gestion du wiki.
Cliquez sur roue crantée
Gestion du site
Editez la page
Remplacez le contenu par
{{nav links="GererSite, GererDroits, GererThemes, GererUtilisateurs, GererMisesAJour" titles="Gestion du site, Droits d'accès aux pages, Thèmes graphiques, Utilisateurs et groupes, Mises à jour / extensions"}}

===Gérer les menus et pages spéciales de ce wiki===
 - [[PageMenuHaut Éditer menu horizontal d'en haut]]
 - [[PageTitre Éditer le titre]]
 - [[PageRapideHaut Éditer le menu roue crantée]]
 - [[PageHeader Éditer le bandeau]]
 - [[PageFooter Éditer le footer]]
 - [[PageMenu Éditer le menu vertical (apparaissant sur les thèmes 2 colonnes ou plus)]]
 - [[ReglesDeFormatage Éditer le mémo de formatage (bouton "?" dans la barre d'édition )]]
------
===Gestion des mots clés ===
{{admintag}}


Selon le niveau de votre version antérieure, il est probable que les nouvelles fonctionnalités de l'administration du site soient encore cachées. Lorsque vous cliquerez sur la roue crantée pour accéder à l'espace de gestion du site, vous allez découvrir de nouveaux boutons qui vous promettent de super propriétés :

image Capture_decran_20171007_a_225301.png (75.9kB)

Hélas, après avoir cliqué sur le bouton "Droits d'accès aux pages" par exemple, vous risquez de tomber sur ça :

image Capture_decran_20171009_a_120851.png (11.5kB)
Donc, cette rubrique est destinée à vous permettre de créer toutes les pages manquantes et néanmoins super utiles de la nouvelle version.

Pour chaque nouvelle page à créer, la procédure sera la même :
  • Créez la page (en cliquant sur le lien avec un crayon)
  • Ajoutez le contenu correspondant à récupérer ci-dessous
  • Enregistrez la page

Contenu de la page GererDroits
{{nav links="GererSite, GererDroits, GererThemes, GererUtilisateurs, GererMisesAJour" titles="Gestion du site, Droits d'accès aux pages, Thèmes graphiques, Utilisateurs et groupes, Mises à jour / extensions"}}

===Gérer les droits des pages===
{{gererdroits}}


Contenu de la page GererThemes
{{nav links="GererSite, GererDroits, GererThemes, GererUtilisateurs, GererMisesAJour" titles="Gestion du site, Droits d'accès aux pages, Thèmes graphiques, Utilisateurs et groupes, Mises à jour / extensions"}}

===Gérer les thèmes des pages===
{{gererthemes}}

{{setwikidefaulttheme}}


Contenu de la page GererUtilisateurs
{{nav links="GererSite, GererDroits, GererThemes, GererUtilisateurs, GererMisesAJour" titles="Gestion du site, Droits d'accès aux pages, Thèmes graphiques, Utilisateurs et groupes, Mises à jour / extensions"}}

===Gérer les groupes d'utilisateurs===
{{editgroups}}

===Gérer les utilisateurs===
{{userstable}}


Contenu de la page GererMisesAJour
{{nav links="GererSite, GererDroits, GererThemes, GererUtilisateurs, GererMisesAJour" titles="Gestion du site, Droits d'accès aux pages, Thèmes graphiques, Utilisateurs et groupes, Mises à jour / extensions"}}

===Mises à jour / extensions===
{{update}}


Contenu de la page ReglesDeFormatage
Le contenu à coller est présent à jour ici : https://ferme.yeswiki.net/WikiDeBase/?ReglesDeFormatage/raw



Quatrième étape : faites vous plaisir !

Vous avez maintenant une version doryphore certifié utilisable, vous pouvez utilisez votre wiki comme avant mais en mieux : modifier le thème, installer des extension, mettre à jour le contenu, etc...

Par exemple vous étiez sur le thème yeswiki et que vous n'aimez le nouveau thème, vous pouvez le retrouver et l'installer dans mises à jour et extensions.

Autres savoirs-utiles autour des mises à jour

Mon wiki se trouve à l'adresse suivante http://site-coop.net/Louise, je souhaiterais qu'il se nomme maintenant http://site-coop.net/Mathieu
  • Via ftp, il faut changer le nom du dossier Louise en le nommant Mathieu
  • dans le fichier wakka.config.php, il faut changer la ligne 'base_url' => 'http://site-coop.net/Louise/wakka.php?wiki=" en 'base_url' => 'http://site-coop.net/Mathieu/wakka.phpwiki=?"
  • tester si tout fonctionne dans votre navigateur (attention les majuscules et minuscules ont leur importance)
  • on peut aussi rechercher l'ancienne adresse url dans le moteur de recherche pour vérifier s'il n'y pas des liens directs dnas certaines pages, et qu'il faudra donc editer pour mettre la nouvelle url.

1) Mise à jour des thèmes graphiques

Après migration et avec certains thèmes, l'affichage de l'indicateur de sous menu apparaît en double.
Il suffit d'enlever la partie javascript suivante du thème pour le corriger :
// on ajoute en jquery les classes css du bootstrap
/*menuhaut.find("> div > ul").each(function() { // menu du haut
    var $this = $(this);
    $this.addClass('nav').append($('<div>').addClass('clear').html());
    $this.find('>li:has(ul)').each(function() {
        $(this).addClass('dropdown').find('a:first').addClass('dropdown-toggle').attr({'href':'#', 'data-toggle':'dropdown'}).append('<b class="caret"></b>').next('ul:first').addClass('dropdown-menu')});
}); 

menuhaut.find("ul ul li:has(ul)").each(function() { // menu du haut
    var $this = $(this);
    $this.addClass('dropdown-submenu')
    $this.find('a:first').next('ul:first').addClass('dropdown-menu');
}); */


2) Changement de version de bootstrap (passage de la version 2 a la version 3)

  • il faut expliciter les images responsive en ajoutant class="img-responsive" aux balises images. Les images envoyées par attach ne sont pas impactées
  • la syntaxe des colonnes a changé : ce n'est plus "span4" mais "col-md-4" pour les classes css des largeurs de colonnes
voir tous les changements ici : http://getbootstrap.com/getting-started/#migration

3) Changement pour les templates BAZAR et la recherche Bazar

  • le moteur de recherche Bazar utilise maintenant des facettes, il faut mettre a jour les templates en ajoutant une classe css "bazar-entry" et des attributs html sur l'élément qui va être filtré (le li pour les listes, le a pour les liens, le div .panel pour les accordéons, etc, ..)
exemple pour une liste:
<li class="bazar-entry" <?php echo $fiche['html_data'];?>>


Scénario de migration des wikis

1) Mise à jour des thèmes graphiques

  • déplacer les thèmes autres que tools/templates/themes/yeswiki dans le dossier themes à la racine du wiki (le créer si besoin)
  • modifier chaque squelette de ces thèmes :
la partie haute "doctype html"

Remplacer

<!doctype html>
<!--[if lt IE 7]> <html class="no-js ie6 oldie" lang="fr"> <![endif]-->
<!--[if IE 7]>    <html class="no-js ie7 oldie" lang="fr"> <![endif]-->
<!--[if IE 8]>    <html class="no-js ie8 oldie" lang="fr"> <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="fr"> <!--<![endif]-->

Par

<!doctype html>
<!--[if lt IE 7]> <html class="no-js lt-ie9 lt-ie8 lt-ie7" lang="{{configuration param="lang"}}"> <![endif]-->
<!--[if IE 7]>    <html class="no-js lt-ie9 lt-ie8" lang="{{configuration param="lang"}}"> <![endif]-->
<!--[if IE 8]>    <html class="no-js lt-ie9" lang="{{configuration param="lang"}}"> <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="{{configuration param="lang"}}"> <!--<![endif]-->


Dans "head"

Remplacer

<meta charset="iso-8859-1">
  <title>{{titrepage}}</title>{{metarobots}}
  <meta name="keywords" content="{{configuration param="meta_keywords"}}" />
  <meta name="description" content="{{configuration param="meta_description"}}" />
  <meta name="author" content="">
  <meta name="viewport" content="width=device-width,initial-scale=1">
  <link rel="alternate" type="application/rss+xml" title="Flux RSS des derniers changements du wikini" href="{{configuration param="base_url"}}DerniersChangementsRSS/xml" />
  <link rel="shortcut icon" type="image/x-icon" href="{{configuration param="theme_path"}}images/favicon.ico">
  <link rel="apple-touch-icon" href="{{configuration param="theme_path"}}images/apple-touch-icon.png">
  <link rel="icon" type="image/png" href="{{configuration param="theme_path"}}images/favicon.png" />
  <link rel="stylesheet" href="{{configuration param="theme_path"}}styles/grid/960.css">
  {{liensstyle}}

Par

<!-- HTML Metas -->
	<meta charset="{{configuration param="charset"}}">
	{{metarobots}}
	<meta name="keywords" content="{{configuration param="meta_keywords"}}" />
	<meta name="description" content="{{configuration param="meta_description"}}" />
	<meta name="viewport" content="width=device-width" />

	<!-- Title of the page -->
	<title>{{configuration param="wakka_name"}} : {{currentpage}}</title>
	
	<!-- Favicons -->
	<link rel="shortcut icon" type="image/x-icon" href="{{configuration param="theme_path"}}images/favicon.ico" />
	<link rel="apple-touch-icon" href="{{configuration param="theme_path"}}images/apple-touch-icon.png" />
	<link rel="icon" type="image/png" href="{{configuration param="theme_path"}}images/favicon.png" />
	
	{{linkstyle othercss="bootstrap/bootstrap-responsive.min.css"}}
	{{linkrss}}



et partie basse (<script>)
  • remplacer {{liensjavascripts}} par {{linkjavascript}}

2) Récupération des bouts de code personnalisés (assez rare)

Récupérer tous les templates spécifiques que vous auriez créés dans /tools/bazar/presentation/templates , /tools/login/presentation/templates , /tools/syndication/presentation/templates ... il faudra les remettre a leur emplacement d'origine plus tard.

3) Déplacement de l'ancien dossier tools pour l'avoir de coté

Renommer les dossier tools en tools.old : on ne peut pas écraser car certains fichiers feront doublons..

4) Copie des fichiers de bachibouzouk

Écraser tout le wiki avec la nouvelle version bachibouzouk, téléchargée précédemment.

5) Rajout des bouts de code personnalisés (assez rare)

Rajouter les éventuels templates mis de coté à l'étape 2 (voir s'il faut les adapter).

6) Indication du thème par défaut

Rajouter au fichier wakka.config.php, un thème par défaut en renseignant 'favorite_theme', 'favorite_style', 'favorite_squelette'

7) Ménage après vérification

Après une utilisation intensive pendant quelques jours sans problèmes, on peut effacer le dossier tools.old, si l'on rencontre des problèmes avec des tools plus installés, ou des templates disparus, on peut les récupérer à partir de tools.old sinon

Si la version de votre wiki est antérieure à 2018, votre site ne doit pas être encodé en utf8, et vous le remarquez peut-être lorsque vous effectuez des copier-collés depuis d'autres documents : certains caractères ne sont pas pris en compte et affichent des points d?interrogation ou autres bizarreries.

Pour résoudre ce problème, un handler existe et va appliquer une correction à votre wiki.
Pour utiliser le handler :
  • Connectez-vous en tant qu'admin
  • Ajoutez ensuite "/dbutf8" à la fin de l'URL de n'importe quelle page de votre wiki
  • Laissez le handler faire effet, vous devriez voir une page apparaître
image MAJ_yeswiki.png (0.3MB)
Sur l'image : les messages qui s'affichent lorsque la commande est terminée
  • il se peut que la fonction attach n'affiche plus les images pour des wikis tres vieux qui changent de version de php
  • ajouter un script index.php dans le dossier files
<?php
$directory = getcwd();

$it = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($directory));

while ($it->valid()) {

    if (!$it->isDot()) {
        $oldfile = $it->getSubPathName();
        $newfile = str_replace('/', '_', $oldfile);
        if ($oldfile != $newfile) {
            echo 'Copy '.$oldfile.' to '.$newfile.'<br>';
            copy($oldfile, $newfile);
            echo '<hr>';
        }
    }

    $it->next();
}

  • aller sur l'url
    https://<monwiki>/files
    
    et voir la copie des fichiers
  • si tout marche bien sur une version récente de yeswiki, effacer les sous-dossiers aux noms de pages, et le fichier
    files/index.php
    

Choisir le nombre de colonnes


Choisir le nombre de colonnes pour une page a deux significations :

Des colonnes menu

En plus de votre menu horizontal, vous pouvez ajouter un ou des menus, à gauche et/ou à droite.

Exemple visuel d'une page avec une colonne menu à gauche (cliquez sur l'image pour la voir en plein écran) :

image colonnemenu.png (0.2MB)
Colonne menu

Des colonnes de mise en forme du contenu

Vous avez des possibilités de mise en forme en colonnes de votre contenu (texte, images ...) à l'intérieur du bloc central de contenu.

Exemple visuel d'une page dont le contenu est organisé en 3 colonnes (cliquez sur l'image pour la voir en plein écran) :

image colonnemiseenforme.png (56.6kB)
Colonne mise en forme du contenu

Créer des onglets

Il est possible de créer des onglets au sein d'une page wiki en utilisant l'action {{nav}}.
La syntaxe est (elle est à répéter sur toutes les pages concernée par la barre d'onglet)
{{nav links="NomPage1, NomPage2, NomPage3Personne" titles="TitreOnglet1, TitreOnglet2, TitreOnglet3"}}

Paramètres utilisables
  • les paramètres en gras sont obligatoires
  • un paramètre se déclare de la manière suivante nomduparametre="valeurduparametre"
nom du paramètre valeurs du paramètre
links nom des pages wiki ou url séparées par des virgules
titles Texte de chaque onglet séparées par des virgules
class soit nav nav-tabs, soit nav nav-pills. Vous pouvez ajouter à une de ces deux classes nav-justified (qui justifiera les onglets). L'affichage par défaut nav nav-pills

Exemples

class="nav nav-tabs" donne

class="nav nav-pills" donne

class="nav nav-pills nav-justified" donne

Éditer les pages spéciales de l'interface pour accéder au différentes zones : entête, pied de page, menu ...


Les parties entête, pied de page, menu... sont des pages autonomes et uniques qui s'affichent à des endroits précis de la page présentée au visiteur.

Par exemple, si l'on double-clique sur l'entête, on accède à la page PageHeader et l'on peut modifier son contenu comme dans une page classique.
Cette PageHeader s'affiche dans l'entête de la page. Elle est unique et se reproduit sur toutes les pages finales.

Pour éditer une page spéciale, il suffit de double-cliquer dessus. Ou bien - dans le cas d'un menu plus difficile à double-cliquer - il suffit d'appeler la page en écrivant son nom dans l'url .
Par exemple, pour accéder à la PageMenuHaut :

Exemple pour ce wiki : http://yeswiki.net/test/wakka.php?wiki=PageMenuHaut

Il suffit alors d'éditer la page comme une page classique.


Les pages usuelles se nomment, de haut en bas :
  • PageRapideHaut : moteur de recherche et menu de configuration "roue dentée" en haut à droite
  • PageHeader : entête de la page (bandeau...)
  • PageMenuHaut : menu horizontal en haut de la page
  • PageMenu : menu vertical optionnel généralement situé à gauche ou à droite de la partie contenu de la page
  • PageColonneDroite : colonne de droite qui s'affiche pour toutes les pages du site
  • PageFooter : bas de page


demande une maîtrise du ftp et accès au serveur

Extension Progress Bar

L'extension Progress Bar permet d'afficher la progression d'une tâche à l'intérieur d'une page wiki.

Installation

ATTENTION : cette extension est en cours de développement, elle est mise à disposition à des fins de test, l'utiliser en production serait risqué.


Paramètres des actions


[100%] done
[40%] done
[60%] done
[50%] done
[5%] done
[25%] done
[6/14] done

Suivre la vie de son wiki

Ajouter dans cette doc

  • infos sur action RecentChanges
  • afficher la liste des pages du site / actions ListPages et PageIndex
  • lister les pages orphelines / action OrphanedPages
  • afficher les pages dont je suis propriétaire / action mypages
  • afficher la liste des pages que j'ai modifié / action mychanges


Tableau de bord

Une page TableauDeBord accessible dans le menu "roue crantée". Il permet d'accéder aux
  • derniers comptes utilisateurs créés
  • dernières pages modifiées
  • dernières pages commentées
  • un index de toutes les pages du Wiki

Avec la page DerniersChangements

Vous verrez toutes les pages modifiées sur cette page :
[MONYESWIKI]/?DerniersChangements


Recevoir des notifications à la modification d'une page

Le flux RSS d'une page permet de suivre les modifications des pages et la création de nouvelles.

Ajoutez l'URL "[...]/wakka.php?wiki=DerniersChangementsRSS/xml" dans votre lecteur de flux RSS
exemple pour ce wiki : http://yeswiki.net/wakka.php?wiki=DerniersChangementsRSS/xml


Voir les statistiques de visite mon Wiki

  • Vous pouvez utiliser framaclic de framasoft . ce service simple basé sur Dolomon permet de générer un pixel invisible que vous devrez placer dans votre site (par exemple dans la page footer). A chaque fois que le pixel sera téléchargé, une visite de plus s'affichera sur votre tableau de bord framaclic. => TutoDolomon
  • Vous pouvez utiliser Google Analytic pour disposer de statistiques plus détaillées de votre site
    • cela nécessite de coller un code fourni par Google dans la PageFooter de votre Wiki
    • vous devrez également inscrire vos adresses mail Google pour recevoir les notifications (hebdomadaires ou mensuelles au choix)

Extension Tags


Ensemble d'actions permettant d'associer a des pages wiki des mot clés, afin de catégoriser le contenu.

Attention : ne marche qu'en PHP5.

Installation


ATTENTION : cette extension est en cours de développement, elle fonctionne uniquement avec la dernière version de YesWiki (bachibouzouk)


Fonctionnement des tags

En mode édition, noter des mot-clés, séparés par un espace, dans la zone de saisie prévue à cet effet en bas de page.
Attention : pas d'apostrophes !

On peut ensuite afficher les pages taguées de différentes façons grâce aux actions suivantes

Les actions utilisateurs


L'action {{microblog}}

Affiche un microblog sur la page, avec la liste des derniers billets, et un flux rss associé
Paramètres
  • tags : mots-clés utiliser automatiquement pour les billets du mini-blog
  • edit : possibilité d'éditer les billets au survol, par défaut c'est oui
  • class : associe une classe css aux pages (valeur "microblog" par défaut)
  • enhaut : si "oui" le formulaire des microblog apparait en haut, autre valeur : apparait en bas. "oui" par défaut
  • tri : trie par ordre alphabétique ("alpha") ou chronologique ("date")
  • nb : nombre maximum de pages affichées sur une même page (si pas de valeur : affiche toutes les pages).
  • nbcar : nombre maximum de caractères par billet de microblog
  • pageformulaire : nom de la page wiki qui contient le formulaire microblog (très optionnel)
  • template : permet de définir l'affichage du microblog, par exemple simple c'est sans la barre des tags.

Exemple : {{microblog tags="actu" edit="1" template="formulaire_microblog_simple.tpl.html"}} donne {{microblog tags="actu" edit="1" template="formulaire_microblog_simple.tpl.html"}}


L'action {{nuagetag}}

Affiche un nuage de mots clé, avec 6 niveaux de tailles de mot clés en fonction de leur fréquence d'utilisation.
Paramètres
  • tri : mettre "alpha" pour avoir un tri alphabétique, il sera mélangé aléatoirement sinon
Exemple :
{{nuagetag tri="1"}} donne
{{nuagetag tri="alpha"}} donne

L'action {{listepages}}

L'action {{listepages}} permet de faire s'afficher les pages taguées. Par défaut, tout le contenu de la page s'affiche, mais on peut modifier ce paramètre.
Paramètres
  • tags (obligatoire) : ensemble des mots-clés devant figurer dans les pages
  • notags : ensemble des mots-clés ne devant pas figurer dans les pages
  • edit : possibilité d'éditer les pages
  • class : associe une classe css aux pages (valeur "liste" par défaut)
  • tri : trie par ordre alphabétique ("alpha") ou chronologique ("date")
  • nb : nombre maximum de pages affichées sur une même page (si pas de valeur : affiche toutes les pages).
  • vue : indique le template à utiliser {{listepages tags="actu" vue="bulle_microblog.tpl.html"}}
Exemple : {{listepages tags="utilisateur" accordeon="1"}} donne
Unknown action "listepages"

L'action {{rss}}

Génère un flux RSS avec possibilité de sélectionner l'ensemble des pages contenant certains tags choisis.
Paramètres
  • tags (obligatoire) : ensemble des mots clés devant figurer dans le flux rss
  • notags : ensemble des mots clés ne devant pas figurer dans le flux rss
  • nbcar : nombre de caractères maximum de la page a afficher dans le flux rss
Attention : ne pas mettre le flux RSS d'un tag dans une page qui est elle-même taguée par ce mot-clé !
Exemple : {{rss tags="miniblog" nbcar="200"}} donne :

Les actions réservées au groupe d'administrateurs


L'action {{admintag}}

Affiche la liste complète des tags utilisés, avec les pages associées, en offrant la possibilité de les supprimer massivement.
Attention : il faut être identifié comme administrateur du Wikini
Exemple : {{admintag}} donne
Action {{admintags ...}} : l'action est réservée au groupe des administrateurs...

Les handlers

/ajaxaddcomment, /ajaxdeletepage, /ajaxedit
sont les équivalent ajax (donc renvoyant du json plutôt que du html) des handlers /addcomment, /deletepage, /edit


Les parametres de configuration

Dans le dossier tools/tags/wiki.php

ligne:
define('COMMENTAIRES_OUVERTS_PAR_DEFAUT', 1);
> pour afficher par défaut la possibilité d'ajouter des commentaires à une page (on peut toujours affine page par page par la suite)


define('CACHER_MOTS_CLES', 0);
> pour qu'en mode édition n'apparaissent pas les mots clés à saisir


Observations

Lorsqu'on édite une page pour modifier un tag (on touche uniquement au tag et pas au contenu de la page), puis qu'on sauvegarde la page, la boite de dialogue Cette page n'a pas été enregistrée car elle n'a subi aucune modification apparaît.
Voilà une action qui demande un clic supplémentaire...

Thème Interface

Le thème interface est un thème configurable par de biais d'une simple page wiki.
Un certain nombre d'éléments de styles sont simplifiés et configurables relativement simplement.
Pour cela il suffit de mettre dans la page footer si vous souhaitez que ce style s'applique à tout votre wiki les éléments que vous trouverez dans la page suivante


Titre 1

Titre 2

Titre 3

Titre 4

Titre 1
default
primary
success
Info
warning
danger
Attention ! Voici votre message. Success

Attention ! Voici votre message. Info

Attention ! Voici votre message. Warning

Attention ! Voici votre message. Danger

Titre default

Contenu default

Titre primary

Contenu primary

Titre success

Contenu success

Titre info

Contenu info

Titre warning

Contenu warning

Titre danger

Contenu danger

Ebook pdf

Doryphore


Nom de la version actuellement en phase de "beta test", avant une sortie imminente ! (et qui va remplacer la version actuelle, Cercopitheque)

Cette nouvelle version améliore considérablement l'utilisation des formulaires et propose un tout nouveau look, plus actuel. L'installation a aussi été revue et le wiki installé par défaut contiendra déjà les fonctionnalités les plus couramment utilisées (formulaires pré-installés, pages pré-formatées, aides plus visibles ...).
Cette version est stabilisée à 95 % et corrige déjà des nombreux petits bugs encore présents sur Cercopithèque. Nous avons besoin de votre aide pour lever les derniers bugs à corriger et permettre ensuite une migration massive des wikis existants vers cette nouvelle version (qui sera ensuite la seule maintenue)

VOUS SOUHAITEZ TESTER CETTE VERSION BÊTA ?


Soit sur un nouveau wiki pour regarder et tester : https://yeswiki.net/?PageCreer
Soit mettre à jour un wiki existant :
  • faire un backup (base mysql et fichiers)
  • s'identifier avec un compte avec des droits d'admins
  • passer sur la dernière version cercopithèque en passant par la page GererMisesAJour (roue - crantée>Gestion du site> onglet Mises à jour / extensions)
  • éditer la page GererMisesAJour et changer l'action update en update version="doryphore"
  • passer sur la dernière version doryphore depuis cette même page
dans l'url ajouter /update pour mettre a jour la base de données
  • célébrer !


Vous découvrez un bug ? Voici comment nous le déclarer : https://yeswiki.net/?LaGareCentrale

Éditer et modifier un menu

Un wiki comporte généralement plusieurs menus. Un menu est tout simplement une page Wiki.
image squelette_yeswiki.png (0.4MB)

Par défaut un wiki contient les menus suivants :
  • un menu horizontal, situé généralement en haut de page
  • un menu configuration, accessible en cliquant sur la roue dentée en haut à droite
  • un menu vertical, généralement situé à gauche ou à droite de la partie contenu de la page (pas représenté sur le dessin ci-dessus :-()

Il y a trois manières d'accéder à une page menu pour la modifier :

Roue crantée

image ImgRoueCrantee.png (18.2kB)
Accessible via dans la page "Gestion du site" du menu crantée en haut à droite du wiki

Dans la page Gestion du site, vous retrouvez les liens vers les pages "Éditer menu horizontal d'en haut" et "Éditer menu vertical sur le côté" (à créer)

Par l'url du menu

image ImgUrl.png (7.7kB)
Pour modifier des menus, il est possible de se rendre sur chacun d'entre eux via l'adresse de leur page.

Pour les menus par défaut ces url sont :


Double-clic

image ImpEcran.png (76.1kB)
La logique du double-clic chère à YesWiki fonctionne aussi pour les menus.
double-cliquer sur un menu lui-même vous amène au mode édition de la page qui le pilote.
Il n'est pas toujours évident se trouver l'endroit précis où le double-clic fonctionne (notamment si beaucoup de liens sont présents dans le menu), il est donc conseillé d'utiliser les méthodes proposées ci-dessus.

Modifier


Pré-requis : savoir faire des liens : Voir la page de la documentation "Créer une lien"

Une page menu est organisée comme une liste de puces. Un niveau de menu correspond au retrait de la puce.
Elle se provoque grâce à un espace placé en début de ligne. Un seul espace avant le tiret créera un titre de premier niveau (toujours apparent dans le menu). Deux espaces avant le tiret créera un titre de deuxième niveau (apparent après avoir cliqué sur le titre de premier niveau).
Vos titres de menu doivent mener à des pages en créant des liens (selon la méthode Yeswiki)

- Niveau 1
  - [[ChatMot Titre 1-A]]
  - Titre 1-B
 - Niveau 2
  - Titre 2-A
  - Titre 2-B
  - Titre 2-C

Niveau 1
Niveau 2
  • Titre 2-A
  • Titre 2-B
  • Titre 2-C

{{edithandlersacls}}


permet de gérer les droits d'utilisation des handlers par groupe ou user
  • * = tout le monde
  • + = tous les connectés (loggés)
  • @NomWiki = que la personne portant ce nomwiki
  • @admins = tous les personnes qui font partie du groupe @admins

image Capture_decran_20160203_a_095333.png (26.5kB)

Empêcher l'indexation de son YesWiki par les moteurs de recherche


Il est parfois intéressant de pouvoir limiter l'indexation de son Wiki par les moteurs de recherche.

Pour ce faire :
Il faut agir sur le fichier robot.txt qui se trouve à la racine de votre wiki.
Suggestion : il y a également une solution à la fois sûre et simple à mettre en place qui consiste à demander une authentification htaccess/htpassword. https://ouvaton.coop/proteger-par-htpasswd. É partir du moment où le wiki concerné est un outil de travail collaboratif, cette étape ne constitue pas une véritable contrainte.

Editez ce fichier et remplacez
# www.robotstxt.org/
# www.google.com/support/webmasters/bin/answer.py?hl=en&answer=156449

User-agent: *
par
User-Agent: *    
Disallow: /
ATTENTION Pour une efficacité réelle (étant donné que google ne respecte plus trop le robots.txt,, il convient de rajouter dans wakka.config.php, cette ligne
'meta' => array('robots' => 'noindex, nofollow'),


Voici d'autres exemples de fichier robots.txt :


Exclusion de toutes les pages :
User-Agent: *
Disallow: /

Exclusion d'aucune page (équivalent É l'absence de fichier robots.txt, toutes les pages sont visitées) :
User-Agent: *
Disallow:

Autorisation d'un seul robot :
User-Agent: nomDuRobot
Disallow :
User-Agent: *
Disallow: /

Exclusion d'un robot :
User-Agent: nomdurobot
Disallow: /
User-Agent: *
Disallow:

Exclusion d'une page :
User-Agent: *
Disallow: /repertoire/chemin/page.html

Exclusion de plusieurs page :
User-Agent: *
Disallow: /repertoire/chemin/page.html
Disallow: /repertoire/chemin/page2.html
Disallow: /repertoire/chemin/page3.html

Exclusion de toutes les pages d'un répertoire et ses sous-dossiers :
User-Agent: *
Disallow: /repertoire/

Indiquer à Google ne pas suivre un lien :
<a href="http://www.yeswiki.net" rel="nofollow">ancre du texte de la page wiki</a>

Extension

Définition Une extension est un petit module optionnel que l'on pourra ajouter à son YesWiki de base pour par exemple voir les statistiques du wiki, inclure des espaces de coécriture ou pour récupérer des pages wiki au format PDF. Certaines actions sont réservées au compte super administrateur (en général WikiAdmin).

Les extensions permettent d'activer de nouvelles actions et handlers
Si un message d'alerte de type Action inconnue "toto" apparaît, soit vous avez mal orthographié votre action, soit l'outil correspondant n'est pas installé ou pas activé.

installation

Vous pouvez ajouter une extension en utilisant l'utilitaire de mise à jour disponible sur la page WikiAdmin. TODO: quelle version de YesWiki ? Sur Cercopithèque je ne trouve pas cette fonctionnalité.


  • Activité : récupère la liste de tous les wikis installés sur un même espace et fourni leur flux RSS
  • Captcha permet d'installer un captcha lors de l'édition d'une page
  • Duplicateur : copie d'un ensemble de pages wiki d'un wiki à l'autre
  • Ferme : interface pour gérer une ferme à wikis (installer des nouveaux wikis sur le même domaine)
  • Googleanalytics : ajout de l'outils de statistiques Google Analytics aux pages de votre wiki
  • Statistique permet d'installer un gestionnaire de statistiques pour votre wiki
  • Espace co-écritire permet de créer des espaces de co-écriture au sein du wiki
  • Markdown permet d'utiliser du markdown au sein de wiki
  • Notif : recevoir par mail les modifications d'une page (en cours ou dépréciée ?)
  • Pdf : génére un pdf à partir d'une page wiki
  • Qrcode : générateur de qrcodes pour YesWiki
  • Wikical : petit calendrier généré à partir des éléments entrés dans un fichier calendrier standard (.ICS)
  • Wikicolor : coloration de texte dans YesWiki
  • Ebook pdf permet de créer un pdf à partir d'une sélection de page wiki

  • ebook : Générateur d'ebook aux formats epub et pdf à partir des pages wikis ou fiche bazar.
  • ferme : Gérer une ferme à wikis a partir d'un formulaire bazar.
  • googledrive : Créer des documents google et etherpad avec bazar.
  • ipblock : Bloque les accès en édition pour les adresses ip de différents pays.
  • loginldap : Remplace l'authentification de YesWiki par celle d'un annuaire LDAP,
  • markdown : Active markdown au sein de YesWiki.
  • qrcode : Générateur de Qrcodes et application QrcodeTroc
  • Webhooks : ajouter de webhooks sortant


  • Actions : ajoute la gestion des utilisateurs (suppression possible) à Yeswiki
  • Cartowiki : représentation géographique de données
  • Chatmot : création automatique d'un ChatMot à partir d'un titre de page
  • Convergence : système de vote participatif
  • Multilinguisme : changer la langue par défaut de YesWiki
  • Notif : recevoir par mail les modifications d'une page
  • Pointimagewiki : ajouter des points avec une description sur une image
  • Rss : informations plus complètes dans le flux RSS des dernières modifications
  • Tableau : ajoute une syntaxe pour formater des tableaux
  • Tableofcontent : ajout d'une table des matières à une page

galerie_photos.tpl.html

Ce template est fourni avec un yeswiki de base non il doit être téléchargé
galeriephotostplhtml_capture-décran-2018-12-06-à-15.55.20.png
Présentation rapide ce template permet d'afficher une galerie de photos "classique" en 6 colonnes avec la photo et le titre par dessous.
Lien vers les fichiers à télécharger si besoin https://github.com/YesWiki/templates-bazar
Informations importantes à propos de ce template Les champs nécessaires minimaux sont bf_titre, bf_image
Lien vers un wiki où le template est visible http://coop-site.net/concours/wakka.php?wiki=PourWikiDemoGalerie
Lien vers le wiki démo où le template est visible http://yeswiki.net/cercopitheque/demo/?GaleriePhotos
Code source du formulaire qui a servi pour cet exemple
texte***bf_titre***Titre de la photo***255***255*** *** *** ***1***0***
n'apparait pas dans le formulaire : 
cette listethemes doit être définie dans l'onglet liste sinon elle n'apparait pas ! 
checkbox***ListeThemes***Thèmes de la photo*** ***1*** *** *** ***1***1***
image***bf_image***Image***20000000*** *** *** *** ***0*** ***ne pas dépasser 20 Mo
Mot clés
Ajouter un mot au Glossaire

Glossaire

Action :
Une action exécute une série d'opérations et affiche le résultat obtenu à l'endroit où elle est décrite dans la page.
C'est utilisé par exemple pour afficher un bouton, la liste des utilisateurs, un nuage de mots-clés.
Il est possible de spécifier des paramètres afin de personnaliser ce résultat (ordre du tri, nombre d'entrées, taille...).

La liste des paramètres est indiquée sur la page de documentation de chaque action :
cf. Liste des actions

Certains paramètres peuvent être obligatoires.

Syntaxe
Une action s'écrit avec 2 accolades ouvrantes, suivi du nom de l'action, suivi par des éventuels paramètres, puis fermée par 2 accolades fermantes :
{{nomaction param1="valeur1" param2="valeur2" ... paramN="valeurN"}}


Action dépréciée
Une action qui fonctionne encore mais qui a été remplacée ou intégrée dans une nouvelle action et qui sera supprimée dans la prochaine version de "YesWiki".
Base de données :
Une base de données est un outil permettant de stocker et de retrouver l'intégralité de données brutes ou d'informations en rapport avec un thème ou une activité ; celles-ci peuvent être de natures différentes et plus ou moins reliées entre elles.

Quand on parle de base de données pour YesWiki, on peut se référer à 2 choses :

  • MySQL
Base de données dans laquelle on stocke les informations de YesWiki.
C'est invisible pour l'internaute.
Par exemple, quand vous créez une nouvelle page sur votre YesWiki, cela crée une nouvelle entrée dans la base de données MySQL.

  • Bazar
YesWiki permet de créer des base de données accessibles aux administrateurs et aux internautes directement sur le site. Cela prend la forme de formulaires pour la partie question et de fiches pour la partie réponse.
Par exemple, cette partie Glossaire est une base de données bazar.
En savoir plus sur l'action bazar
Bootstrap :
Bootstrap est une bibliothèque libre de mises en forme prédéfinies.
http://getbootstrap.com

YesWiki propose des thèmes créés avec des éléments Bootstrap. Par exemple les thèmes Bootstrap et Bootstrap3.
Bootstrap est aujourd'hui indispensable au fonctionnement de YesWiki. Par exemple, la mise en forme des formulaires bazar s'appuie sur Bootstrap.
Quand une action accepte un paramètre "class", vous pouvez y intégrer les classes CSS de Bootstrap. Il est alors très facile d'obtenir un rendu esthétique.
Cercopithèque :
Cercopithèque est le nom d'une version de YesWiki. Parfois abrégé "Cerco".

La précédente version s'appele Bachibouzouk.
La version suivante s’appellera Doryphore.

le nom des versions YesWiki viennent des insultes du capitaine Haddock dans la bande déssinée Tintin
Classes CSS :
CSS (Cascading Style Sheets ou feuilles de style en cascade) est un langage informatique qui décrit la présentation des documents HTML et XML.
Voir définition de Wikipédia .

Un thème est composé d'un squelette et d'une feuille de style. C'est cette feuille de style qui est au format CSS.
Vous pouvez préciser la mise en forme d'une action grâce aux classes CSS : Paramètre "class".
Embed :
Balise HTML qui permet d'incorporer un élément extérieur dans une page (Video, Audio...).
Voir la page dédiée à l'intégration de widgets
Extension :
Une extension est un petit module optionnel que l'on pourra ajouter à son YesWiki de base pour par exemple voir les statistiques du wiki, inclure des espaces de coécriture ou pour récupérer des pages wiki au format PDF. Certaines actions sont réservées au compte super administrateur (en général WikiAdmin).

Les extensions permettent d'activer de nouvelles actions et handlers
Si un message d'alerte de type Action inconnue "toto" apparaît, soit vous avez mal orthographié votre action, soit l'outil correspondant n'est pas installé ou pas activé.

installation

Vous pouvez ajouter une extension en utilisant l'utilitaire de mise à jour disponible sur la page WikiAdmin. TODO: quelle version de YesWiki ? Sur Cercopithèque je ne trouve pas cette fonctionnalité.
FTP :
File Transfer Protocol (protocole de transfert de fichiers), ou FTP, est le moyen de transférer des fichiers depuis son ordinateur vers un serveur web (et inversement).
Un logiciel client FTP est l'outil de base du webmestre. Par exemple : FileZilla .
Handler :
Un handler est une commande qui permet de modifier la façon d'afficher une page. On l'active en ajoutant à la fin de l'adresse URL, le signe / suivi du nom du handler.

Exemples

Ajouter /raw a la fin d'une adresse URL de YesWiki (dans la barre d'URL de votre navigateur), permet d'obtenir le contenu de la page sans interprétation, en syntaxe wiki.
http://yeswiki.net/cercopitheque/wakka.php?wiki=DocumentationFonctionsAvancees/raw

Ajouter /edit a la fin d'une adresse url de YesWiki (dans la barre d'url de votre navigateur), permet d'afficher la page en mode édition
http://yeswiki.net/cercopitheque/wakka.php?wiki=DocumentationFonctionsAvancees/edit

La liste des handlers existants est disponible sur la page Liste des handlers
Hébergement :
Espace web où sont stockées les données de votre site.
Un hébergeur vous vend un espace d'hébergement pour votre site. Souvent il vous propose aussi des noms de domaine, des bases de données, des adresses mails, des mailing-lists ...
Exemples d'hébergeurs : OVH.net, Ouvaton.coop, Gandi.net
Iframe :
Balise HTML qui permet d'insérer une page extérieure. Cela permet par exemple d'incorporer un pad, un outil Google ou autre.
Voir la page dédiée à l'intégration de widgets
Pad :
espace de co-écriture en ligne.
Un pad vous permet d'écrire un document à plusieurs et à distance, en visualisant les apports de chacun-e.
Sites proposant des pads : framapad, etherpad, piratepad ...
RSS :
Gestion d'un flux de données , format XML , et ce serait bien de pouvoir en intégrer un facilement dans une page YesWiki ... (ou Atom, à la rigueur...)
Template :
Un template est un modèle de conception de logiciel ou de présentation des données.
Dans YesWiki, on retrouve le terme template :
plop
URL :
Le sigle URL (de l'anglais Uniform Resource Locator, littéralement « localisateur uniforme de ressource ») est en fait "l'adresse web" d'un site internet. Vous pouvez la lire en haut de votre navigateur web. Elle commence généralement par http://www.
plop
Widget :
C'est un nom construit à partir des termes anglais « window » et « gadget ». Ici nous parlons de widget interactif, un petit outil, un code qui permet d'afficher des informations, des contenus, une carte dans une autre page de votre yeswiki ou même dans un autre site, autre CMS. Par exemple créer une carte à partir de bazar et l'afficher ailleurs dans le wiki. Voir page documentation.
XML :
Format de données "semi-structuré" très répandu sur Internet de part sa flexibilité: https://fr.wikipedia.org/wiki/Extensible_Markup_Language
iCAL :
Flux de données de type agenda/calendrier standardisé ... Et ce serait bien que YesWiki permette une exportation iCAL de ses propres Calendriers, ainsi que l'affichage d'agenda externes depuis leur lien iCAL...

Historique et révisions


Afficher la liste des modifications et faire des comparaisons entre les différentes versions de la page

Chaque modification d'une page est sauvegardée dans un historique. Il est possible de revenir à des versions (révisions) antérieures d'une page.

Pour y accéder il suffit de cliquer sur le lien en bas de page nommé : "Modifiée le : jour.mois.année à heure:minutes:secondes "
Il affichera alors une fenêtre affichant :
image Historique.png (36.4kB)

  • la liste des modifications effectuées sur la page affichées avec la date de modification

  • l'adresse IP depuis laquelle la modification a été effectuée, par exemple : 78.246.209.114

  • ou, si la modification a été effectuée depuis un compte connecté du site, le nom du compte, ici "WikiAdmin"



Un système de cases à cocher permet de comparer les différences entre deux versions (à dates données) via le bouton Voir différences

Rétablir une version antérieure

Dans l'historique, vous accédez aux versions antérieures en cliquant sur la date des modifications. Vous affichez alors une version antérieure de la page. En modifiant cette page via le bouton "Rééditer cette version archivée" située en bas de celle-ci, vous accédez alors au contenu de celle-ci. Pour mettre à jour cette page selon cette version il vous reste juste à "Sauver" la page.

Installation de Yeswiki sur Cloudron


Introduction

Cloudron est une plateforme qui permet de déployer des applications en un clic. C'est un logiciel libre, on peut donc installer cloudron sur son serveur, ou prendre une offre en SaaS (Software as a Service - c'est-à-dire qu'on achète l'accès à la plateforme/à l'application/au site web, qui reste hébergé, sécurisé et géré par celui que l'on paye). Cloudron (une entreprise allemande) propose des offres en Saas, en France c'est possible chez Ohm.coop.
Une fois installé, Cloudron permet de déployer etherpad (écriture collaborative), nextcloud (partage de documents) ou des dizaines d'applications (mattermost, rocketchat, etc..). Il permet aussi de déployer un LAMP (pour Linux Apache MySql Php, c'est à dire un petit serveur linux prêt à fonctionner) sur lequel il est possible d'installer Yeswiki.
L'avantage est de disposer de ses différentes applications sécurisées et au même endroit (voir avec le même identifiant/mot de passe, par exemple pour son cloud et son yeswiki (en cours de test pour Yeswiki)

Installation de Yeswiki

Une fois l'appli LAMP déployée,

image cloudron.png (24.7kB)




pour installer Yeswiki il faut avoir les identifiants de la base de donnée. Pour cela, il faut accéder au terminal


image lamp_cloudron.png (6.5kB)
accéder au terminal de l'appli LAMP

et entrer la commande
env | grep MYSQL_






Ensuite il faut comme pour une installation "normale" téléverser les fichiers du wiki sur le serveur. Pour se faire ouvrir un client ftp (Filezilla par exemple) et accéder au serveur en utilisant les identifiants suivants :

Hôte: sftp://sousdommainedulamp.domaineducloudron.extension (exemple sftp://bonjour.ohmdemo.fr)
Identifiant/mdp : même identifiant que celui de cloudron
Port : en général 2222

Ensuite l'installation se fait comme sur tout autre serveur (documentation classique)

Protéger son wiki par un mot de passe


Il est parfois nécessaire de protéger l'accès de tout un wiki (par exemple pour transformer tout un wiki en intranet).

En bref,
  • lors de l'accès au wiki protégé, un popup s'ouvre et demande login et mot de passe
  • une fois cette porte franchie, vous êtes sur un wiki que vous pouvez laisser en écriture ouverte à tous. Ce qui facilite pas mal la participation.

Attention, aucune des pages du wiki protégé n'est accessible en lecture si le mot de passe n'est pas renseigné (logique ! )

Suivant le type de serveur, la méthode à suivre est différente

Sous nginx

sur le site concerné, ajouter l'option
location /intranet {
auth_basic            "acces restreint";
auth_basic_user_file  /var/www/crie.be/private/htpasswd;
}


location /intranet => l'emplacement sur votre serveur du dossier à protéger
/var/www/crie.be/web/htpasswd; => emplacement sur votre serveur où se trouve le fichier contenant login et mot de passe chiffré

pour générer un mot de passe chiffré
  • allez sur http://www.tools.dynamicdrive.com/
  • taper un login et un mot de passe en vis-à-vis
  • faire submit
  • récupérer le code et le copier dans un fichier htpasswd
  • placer ce fichier htpasswd à l'emplacement renseigné plus haut

sous apache

à venir = utiliser protector.php

Aller plus loin en liant des formulaires entre eux...


Il peut être intéressant de lier des formulaires entre-eux pour par exemple :

créer une liste déroulante dont le contenu est rempli automatiquement et DYNAMIQUEMENT avec le contenu d'une autre formulaire bazar.

Ce bout de code est à insérer dans votre formulaire à l'endroit où vous souhaitez le voir apparaître
listefiche***numéro de formulaire***texte label*** *** *** *** *** ***recherche possible? (0 non, 1 oui)***obligatoire (0 non, 1 oui)*** *** ***listeNomDeLaListe=ID de la valeur de la liste


Le 13eme champ sert à pré-trier (ou à filtrer, ou encore faire une "query") sur la base d'une liste/checkbox utilisée dans le formulaire qu'on appelle.
  • si on a utilisé un champ "cases à cocher" : checkboxNomDeLaListe=ID de la valeur de la liste
  • si on a utilisé un champ "liste déroulante" : listeNomDeLaListe=ID de la valeur de la liste
Cas d'utilisation : vous voulez que seules les entrées du formulaire lié ayant une valeur donnée pour une liste donnée s'affichent.
Attention : ne fonctionne que sur les wikis récemment mis à jour



créer une zone de cases à cocher dont le contenu est rempli automatiquement et DYNAMIQUEMENT avec le contenu d'une autre formulaire bazar

Ce bout de code est à insérer dans votre formulaire à l'endroit où vous souhaitez le voir apparaître
checkboxfiche***numéro de formulaire***texte label*** *** *** *** *** ***recherche possible? (0 non, 1 oui)***obligatoire (0 non, 1 oui)*** *** ***listeNomDeLaListe=ID de la valeur de la liste


Le 13eme champ sert à pré-trier (ou à filtrer, ou encore faire une "query") sur la base d'une liste/checkbox utilisée dans le formulaire qu'on appelle.
  • si on a utilisé un champ "cases à cocher" : checkboxNomDeLaListe=ID de la valeur de la liste
  • si on a utilisé un champ "liste déroulante" : listeNomDeLaListe=ID de la valeur de la liste
Cas d'utilisation : vous voulez que seules les entrées du formulaire lié ayant une valeur donnée pour une liste donnée s'affichent.
Attention : ne fonctionne que sur les wikis récemment mis à jour


afficher dans une fiche bazar, les fiches qui y sont liées (par exemple une fiche présentant une structure et toutes les personnes qui s'y sont liées)

Ce bout de code est à insérer dans votre formulaire à l'endroit où vous souhaitez le voir apparaître



En complément à cette option, il vous est possible aussi d'appeler dans un formulaire les fiches liées.

Explication :
vous avez un formulaire bazar1 présentant des projets et un autre bazar2 permettant d'ajouter des commentaires sur ces projets (l'utilisateur choisissant dans une liste déroulante dynamique la fiche projet qu'il souhaite commenter - grâce à l'option listefiche)
En intégrant dans le syntaxe de votre formulaire bazar1 projet le code suivant
listefiches***id***query*** ***nb de fiches à afficher***nomdutemplate.tpl.html***

vous verrez apparaître en bas de chaque fiche projet l'ensemble des commentaires qui lui sont liés !

Position paramètre
type de champ listefiches (avec un s)
1 id du formulaire lié
2 query="" permet d'afficher une partie seulement de la base de données sur base d'un tri Voir le détail de la syntaxe
3 Vous pouvez mettre ici des paramètres tels que ceux qu'on peut mettre dans bazarliste, par ex ordre="desc" champ="bf_titre" pagination="10"
4 permet de limiter l'affichage des fiches liées, on met par ex 5
5 Indique le template d'affichage (look pour l'affichage des fiches). Par défaut : en accordéon.
6 mettre checkbox ici si vos fiches liées le sont via un checkbox

liste_fiches_horscarte.tpl.html

Ce template est fourni avec un yeswiki de base non il doit être téléchargé
listeficheshorscartetplhtml_capture-décran-2018-12-06-à-12.51.53.png
Présentation rapide ce template permet de récupérer sour forme de liste les titres des fiches (avec une carte cartogoogle) pour lesquelles les utilisateurs ont oubliés de cliquer sur le bouton "placer le point sur la carte".
Lien vers les fichiers à télécharger si besoin https://github.com/YesWiki/templates-bazar
Informations importantes à propos de ce template Les champs nécessaires minimaux sont bf_titre ainsi que les éléments standard d'adressage
Lien vers un wiki où le template est visible http://tousdehors.be/wakka.php?wiki=SansCarte
Lien vers le wiki démo où le template est visible http://yeswiki.net/cercopitheque/demo/?ListeFichesHorsCarte
Code source du formulaire qui a servi pour cet exemple
texte***bf_titre***Prénom et nom***60***255*** *** *** ***1***0***
image***bf_image***Image de présentation (facultatif mais c'est plus sympa)***140***140***600***600***right*** *** ***
texte***bf_fonction***Mon métier, ma fonction***60***255*** *** *** ***0***0***
textelong***bf_description***Mes lieux d'investissement pro ou perso***5***5*** *** ***wiki *** 
textelong***bf_projet***Mon projet***5***5*** *** ***wiki *** 
texte***bf_tel***Téléphone pro (ou perso)***10***20*** *** *** *** ***0
champs_mail***bf_mail***Email (n'apparaitra pas sur le web)***60***255*** ***form*** ***1***0***
texte***bf_structure***Nom de la structure***60***255*** *** *** ***0***0***
lien_internet***bf_site_internet***Site Internet***40***255***http://*** *** ***0***0
texte***bf_adresse***Adresse***50***50*** *** *** ***0***0
texte***bf_code_postal***Code postal***8***8*** *** *** *** ***0
texte***bf_ville***Ville***50***80*** *** *** *** ***0
labelhtml***<span style="color:#cc3333;">Il faut maintenant cliquer sur le bouton bleu pour placer votre point sur la carte </span><br>*** ***
carte_google***bf_latitude***bf_longitude***cartogoogle***
labelhtml***<h3>Il ne vous reste plus qu'à valider ! </h3>*** ****** *** *** *** *** *** *** ***@admins
Mot clés

liste_galerie.tpl.html

Ce template est fourni avec un yeswiki de base non il doit être téléchargé
listegalerietplhtml_liste_galerie.png
Présentation rapide Ce template permet d'afficher une galerie photo en deux colonnes. Celle de gauche reprend en mini vignettes toutes les photos disponibles et sur celle de droite, une vue agrandie de la photo sélectionnée dans la partie gauche.
Informations importantes à propos de ce template Les champs nécessaires minimaux sont
  • bf_titre
  • bf_image
  • bf_description
Lien vers un wiki où le template est visible http://coop-site.net/concours/wakka.php?wiki=PourWikiDemo
Lien vers le wiki démo où le template est visible http://yeswiki.net/cercopitheque/demo/?ListeGalerie
Code source du formulaire qui a servi pour cet exemple
texte***bf_titre***Titre de la photo***255***255*** *** *** ***1***0***
n'apparait pas dans le formulaire : 
cette listethemes doit être définie dans l'onglet liste sinon elle n'apparait pas ! 
checkbox***ListeThemes***Thèmes de la photo*** ***1*** *** *** ***1***1***
image***bf_image***Image***20000000*** *** *** *** ***0*** ***ne pas dépasser 20 Mo
Mot clés

liste_liens_date.tpl.html

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut
listeliensdatetplhtml_actionbazarliste_capture_liste_liens_date_20180309101559_20180309102233.png
Présentation rapide affiche une liste de liens pointant vers les fiches
Lien vers le wiki démo où le template est visible http://yeswiki.net/cercopitheque/demo/?ListeLiensDate
Code source du formulaire qui a servi pour cet exemple
texte***bf_titre***Prénom et nom***60***255*** *** *** ***1***0***
image***bf_image***Image de présentation (facultatif mais c'est plus sympa)***140***140***600***600***right*** *** ***
texte***bf_fonction***Mon métier, ma fonction***60***255*** *** *** ***0***0***
textelong***bf_description***Mes lieux d'investissement pro ou perso***5***5*** *** ***wiki *** 
textelong***bf_projet***Mon projet***5***5*** *** ***wiki *** 
texte***bf_tel***Téléphone pro (ou perso)***10***20*** *** *** *** ***0
champs_mail***bf_mail***Email (n'apparaitra pas sur le web)***60***255*** ***form*** ***1***0***
texte***bf_structure***Nom de la structure***60***255*** *** *** ***0***0***
lien_internet***bf_site_internet***Site Internet***40***255***http://*** *** ***0***0
texte***bf_adresse***Adresse***50***50*** *** *** ***0***0
texte***bf_code_postal***Code postal***8***8*** *** *** *** ***0
texte***bf_ville***Ville***50***80*** *** *** *** ***0
labelhtml***<span style="color:#cc3333;">Il faut maintenant cliquer sur le bouton bleu pour placer votre point sur la carte </span><br>*** ***
carte_google***bf_latitude***bf_longitude***cartogoogle***
labelhtml***<h3>Il ne vous reste plus qu'à valider ! </h3>*** ****** *** *** *** *** *** *** ***@admins
Mot clés

liste_mails_seuls.tpl.html

Ce template est fourni avec un yeswiki de base non il doit être téléchargé
listemailsseulstplhtml_capture-décran-2018-12-06-à-12.49.51.png
Présentation rapide Ce template permet de récupérer sour forme de liste les emails d'un formulaire afin de pouvoir facilement les copier-coller dans un webmail.
Détails des différents paramètres spécifiques à ce template Pas de paramètres
Informations importantes à propos de ce template Les champs nécessaires minimaux sont :
bf_titre
bf_mail
Lien vers un wiki où le template est visible http://tousdehors.be/wakka.php?wiki=EcrireTous
Lien vers le wiki démo où le template est visible http://yeswiki.net/cercopitheque/demo/?ListeMailsSeuls
Code source du formulaire qui a servi pour cet exemple
texte***bf_titre***Prénom et nom***60***255*** *** *** ***1***0***
image***bf_image***Image de présentation (facultatif mais c'est plus sympa)***140***140***600***600***right*** *** ***
texte***bf_fonction***Mon métier, ma fonction***60***255*** *** *** ***0***0***
textelong***bf_description***Mes lieux d'investissement pro ou perso***5***5*** *** ***wiki *** 
textelong***bf_projet***Mon projet***5***5*** *** ***wiki *** 
texte***bf_tel***Téléphone pro (ou perso)***10***20*** *** *** *** ***0
champs_mail***bf_mail***Email (n'apparaitra pas sur le web)***60***255*** ***form*** ***1***0***
texte***bf_structure***Nom de la structure***60***255*** *** *** ***0***0***
lien_internet***bf_site_internet***Site Internet***40***255***http://*** *** ***0***0
texte***bf_adresse***Adresse***50***50*** *** *** ***0***0
texte***bf_code_postal***Code postal***8***8*** *** *** *** ***0
texte***bf_ville***Ville***50***80*** *** *** *** ***0
labelhtml***<span style="color:#cc3333;">Il faut maintenant cliquer sur le bouton bleu pour placer votre point sur la carte </span><br>*** ***
carte_google***bf_latitude***bf_longitude***cartogoogle***
labelhtml***<h3>Il ne vous reste plus qu'à valider ! </h3>*** ****** *** *** *** *** *** *** ***@admins
Mot clés

Lutter contre le spam

Hélas comme la plupart des wikis ouverts (MediaWiki, DokuWiki), YesWiki n'échappe pas aux attaques de quelques emmerdeurs référenceurs soit-disant professionnels et autres robots de spam, qui polluent les contenus des pages.

Les 10 commandements du lutteur anti spam

1. Je consulte régulièrement mon wiki
2. Je m'abonne à son flux RSS => Voir la documentation : flux RSS
3. Je consulte la page TableauDeBordDeCeWiki de mon wiki (accessible depuis la "roue crantée")
4. Je vérifie les dernières pages modifiées dans le TableauDeBordDeCeWiki ou sur la page DerniersChangements
5. Je vérifie les derniers comptes crées sur la page TableauDeBordDeCeWiki. (Action {{Listusers last="20"}} )
6. J'édite les pages en question et je supprime les parties indésirables, puis je sauve. (Cela prend moins d'une minute)
7. Je protège l'accès en écriture des pages non collectives (PageRapideHaut, PageHeader, PageFooter, etc.) => Voir la doc
8. Je mets à jour mon YesWiki quand une nouvelle version sort.
9. Pour les plus endurcis, je fais le grand ménage avec l'outil despam (voir plus bas)
10. Je ne cède pas à la tentation de transformer mon espace collaboratif en bunker. Et je continue à mettre en balance les effets positifs de l'intelligence collective.

Les symptômes : comment identifier les spams ?

  • Vous pouvez découvrir sur une ou plusieurs pages des liens vers des sites externes qui semblent sans rapport avec l'objet du wiki (qui vendent des robes de mariée, des sites indonésien sans rapport, des liens commerciaux vers la loi duflot, des textes en langue étrangère etc..)
  • Il se peut aussi que de nouvelles pages soit créées, et dans certains cas de nouveaux utilisateurs wikis.
Dans tous les cas, il sera toujours possible de faire marche arrière, et les informations sensibles d'accès ftp ou mysql à votre serveur ne peuvent pas être trouvés comme cela.

Que faire si vous avez du spam ?


Utiliser les paramètres de contrôle d'accès via le wakka config

Des nouveaux paramètres ont été ajoutés dans le wakkaconfig et permettent notamment
  • d'ajouter un capcha en mode édition
  • d'ajouter un champ (mot de passe) en entrée du mode édition (+ un message informatif sur ce mot de passe)
  • Découvrez-les ici

Pour les ajouts dans une page isolée (moins de une minute)

  1. Editer la page en question et supprimer la partie indésirable, puis sauver. (Cela prend moins d'une minute)
Astuce: veiller à plusieurs à partir du flux RSS DerniersChangementsRSS et être vigilants collectivement (cela prend moins de temps à plusieurs)

Pour de nouvelles pages indésirables créées

Si vous pouvez vous connecter en tant que WikiAdmin :
  1. s'identifier en tant qu'administrateur du wiki (WikiAdmin par défaut)
  2. éditer les permissions de la page pour mettre le compte WikiAdmin propriétaire de la page
  3. supprimer la page à partir du lien sur la barre d'action en bas de page
Si vous ne pouvez pas vous connecter en tant que WikiAdmin :
  1. éditer la page et remplacer tout le texte de spam par un caractère (il faut au moins un contenu autre qu'un espace dans la page pour la sauver (pour ma part j'utilise ".")

Pour supprimer les commentaires indésirables

  1. Ajouter l'action {{erasespamedcomments}} dans la page de votre choix. (Elle n'est accessible qu'aux administrateurs)
  2. Ensuite cocher les commentaires indésirables et appuyer sur le bouton "Nettoyer >"

pour supprimer de nombreuses pages rapidement

SI vous êtes connecté-e en tant qu'admin, il vous suffit de coller ceci à la fin de l'url des pages à supprimer : /deletepage&confirme=oui
Cela vous évite toutes les manipulations décrites ICI , qui deviennent très fastidieuses lorsqu'on a plusieurs pages à supprimer. Attention, ce "raccourci" supprime définitivement la page sans message de confirmation, ne vous trompez donc pas !

pour les attaques massives sur de nombreuses pages (utilisateurs avancés)

cette technique nécessite des informations sur les codes FTP et Mysql

Pour faire le grand ménage avec le tools despam :
  1. aller sur la barre d'adresse url de votre navigateur et remplacer wakka.php (et ce qu'il y a derrière) par tools.php (pour avoir une url du type http://monadressedewiki/tools.php )
  2. identifiez-vous à l'aide des identifiants de la base de données Mysql plutôt que vos identifiants wiki
  3. la liste des extensions apparaît, cliquer sur "Nettoyage Spam"
  4. Sélectionner l'intervalle de temps à prendre en compte pour les dernière modifications
  5. cocher les choix adéquats, entre supprimer la page ou revenir à la version précédente
    • ATTENTION, il faut IMPÉRATIVEMENT vérifier les pages en question pour ne pas supprimer définitivement le contenu!!
  6. cliquer sur "Nettoyer"

pour supprimer les utilisateurs non désirables (utilisateurs avancés, non disponible par défaut)

Ajouter par FTP, dans le répertoire tools l'extension suivante : http://yeswiki.net/downloads/actions.zip

Pour la mise en oeuvre, voir la documentation suivante:
Télécharger le fichier doc_action_delete.pdf (0.7MB)

Les médicaments en préventifs

  1. mettre à jour YesWiki quand une nouvelle version sort, la protection antispam fait partie des priorités de développement
  2. en dernier recours (car cela coupe la facilité de passage à l'acte) gérer les droits d'accès des pages pour restreindre l'édition aux personnes identifiées.

{{mailperiod}}

Permet d'afficher un service d'abonnement mail sur n'importe quelle page de votre wiki pour en recevoir le contenu à interval régulier. (par ex le tableau de bord)


Piur activer ce service, placer {{mailperiod}} sur la page concernée.
Puis faites les démarches ci-dessous

une partie se déroule dans le service online https://cron-job.org, Le reste se paramètre dans votre wakka config

Définir le cron


Dans la partie "Schedule"

On peut choisir la fréquence (minutes, jour ou mois)
Si on veut un envoi hebdomadaire, il faut cliquer sur "user-defined". Une box s'ouvre et il faut cocher
  • tous les jours du mois
  • choisir le jour de l'envoi dans la colonne "days of week"
  • cocher tous les mois
  • choisir une heure et minute

Dans la partie "Notifications"
  • cocher "execution oft the cronjob fails" ET "the cronjob will be disabled because of too many failures"
  • request method : Get
  • et cocher enable cronjob


mettre à jour son wakka config

placer dans votre wakka config le nom de la clé utilisée dans l'url (voir ci-dessus)
'contact_passphrase' => 'CeciEstUnEssaideClePourProteger',


Comment désabonner une adresse/utilisateur ?

Le principe : Mailperiod créé des "groupes" d'utilisateur, dont le nom est MailNomdelapageFrequence . Par exemple; pour un abonnement "journalier" sur une page d'accueil, le nom du groupe créé est MailPagePrincipaleDay

Concrètement pour désabonner des utilisateurs ? Comme pour les autres groupes d'utilisateurs, il faut aller dans Gestion du site (page WikiAdmin) pour voir le groupe et effacer les NomsWikis des utilisateurs concernés.

mails_maj.tpl.html

Ce template est fourni avec un yeswiki de base non il doit être téléchargé
mailsmajtplhtml_imagination.jpg
Présentation rapide Ce template affiche les fiches non mises à jour depuis x jours (180 par défaut, paramètre : nbjour="x") et d'envoyer un mail paramétrable aux contacts des fiches.
Détails des différents paramètres spécifiques à ce template Le paramètre possible : nbjour=" "
Informations importantes à propos de ce template Les champs nécessaires minimaux sont
  • bf_titre
  • bf_mail
Lien vers le wiki démo où le template est visible http://yeswiki.net/cercopitheque/demo/?MailsMaj
Code source du formulaire qui a servi pour cet exemple
texte***bf_titre***Prénom et nom***60***255*** *** *** ***1***0***
image***bf_image***Image de présentation (facultatif mais c'est plus sympa)***140***140***600***600***right*** *** ***
texte***bf_fonction***Mon métier, ma fonction***60***255*** *** *** ***0***0***
textelong***bf_description***Mes lieux d'investissement pro ou perso***5***5*** *** ***wiki *** 
textelong***bf_projet***Mon projet***5***5*** *** ***wiki *** 
texte***bf_tel***Téléphone pro (ou perso)***10***20*** *** *** *** ***0
champs_mail***bf_mail***Email (n'apparaitra pas sur le web)***60***255*** ***form*** ***1***0***
texte***bf_structure***Nom de la structure***60***255*** *** *** ***0***0***
lien_internet***bf_site_internet***Site Internet***40***255***http://*** *** ***0***0
texte***bf_adresse***Adresse***50***50*** *** *** ***0***0
texte***bf_code_postal***Code postal***8***8*** *** *** *** ***0
texte***bf_ville***Ville***50***80*** *** *** *** ***0
labelhtml***<span style="color:#cc3333;">Il faut maintenant cliquer sur le bouton bleu pour placer votre point sur la carte </span><br>*** ***
carte_google***bf_latitude***bf_longitude***cartogoogle***
labelhtml***<h3>Il ne vous reste plus qu'à valider ! </h3>*** ****** *** *** *** *** *** *** ***@admins
Mot clés

map.tpl.html

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut
maptplhtml_actionbazarcarto_capture_decran_20160405_a_095424_20160405095303_20160405095541.png
Présentation rapide Cette action permet d'afficher le contenu d'une base de données (on parlera de fiches) sur un fond cartographique. Il faut bien entendu que ces fiches comportent une adresse postale !
Détails des différents paramètres spécifiques à ce template Paramètres utilisables
  • les paramètres en gras sont obligatoires
  • un paramètre se déclare de la manière suivante nomduparametre="valeurduparametre"
  • Des paramètres supplémentaires pour le filtrage : voir BazarFacette
nom du paramètre valeurs du paramètre
id id de la base de données à afficher, si vide toutes les bases de données sont affichées. Il est possible d'afficher sur une même carte plusieurs bases de données spécifiques en entrant leur id séparé par une virgule
query permet de n'afficher qu'une partie de la base de données en fonction d'un tri sur un champ voir la doc query
colorfield Définis le champ (souvent une liste) qui détermine la couleur du point. Par exemple colorfield="checkboxListeImaginaire" signifie qu'on va trier sur la base de la liste Listeimaginaire, et que cette liste est utilisé en tant que checkbox (cases à cocher) dans le formulaire. Pour une liste utilisée en tant que liste déroulante, on aurait écrit colorfield="listeListeImaginaire"
color fait la corrélation entre la valeur du champ et la couleur associée ex : color="darkgreen=Dir, pink=Secr" ... Attention : nombre de couleurs limitées pour carto ('red', 'darkred', 'lightred', 'orange', 'beige', 'green', 'darkgreen', 'lightgreen', 'blue', 'darkblue', 'lightblue', 'purple', 'darkpurple', 'pink', 'cadetblue', 'white', 'gray', 'lightgray', 'black') pour les agendas et les listes, possibilité d'utiliser les code hexadécimaux.
iconfield Définis le champ (souvent une liste) qui détermine l'icône du point.
icon Soit le nom de l'icône (ex: icon="glyphicon glyphicon-envelope") (voir la liste sur https://getbootstrap.com/docs/3.3/components/ ), soit utilise le paramètre "iconfield" pour faire la corrélation entre la valeur du champ et l'icône (ex : icon="plane=Dir, pencil=Secr")
smallmarker par défaut sur 0 si 1 met des petits marqueurs sur la carte plutôt que les gros
barregestion "true" or "false" : si présent (defaut), ajout des liens vers la gestion de la fiche
lat Permet de préciser la latitude du point central de la carte affichée. Par défaut la carte est centrée sur le centre du monde.
lon Permet de préciser la longitude du point central de la carte affichée. Par défaut la carte est centrée sur le centre du monde.
zoom Permet de préciser le niveau de zoom : de 1 (plus éloigné) à 15 (plus proche), par défaut : 8.
width Permet de préciser la largeur de la carte affichée, exemple : 600px pour une largeur de 600 pixels.
height Permet de préciser la hauteur de la carte affichée, exemple : 400px pour une hauteur de 400 pixels.
spider Permet d'éclater un regroupement de points lorsque l'on clique dessus. True ou False (false par défaut)
cluster Regroupe les points par zone. True ou False (False par défaut)
navigation "true" (par défaut) ou "false". Fait apparaître le contrôle du zoom avec les 2 boutons + et -
zoommolette "true" or "false"
provider Le nom du fournisseur de fond de carte. ex: "OpenStreetMap", "OpenStreetMap.France", "OpenStreetMap.BlackAndWhite", "OpenTopoMap", "Thunderforest", "Thunderforest.Landscape", "Thunderforest.SpinalMap". La liste des providers
typecarto obsolète Type de carto google utilisé : ROADMAP ou SATELLITE ou HYBRID ou TERRAIN (TERRAIN par defaut).
stylenavigation obsolète "SMALL" ou "ZOOM_PAN" ou "ANDROID" ou "DEFAULT"
layercarto obsolète Permet de préciser le fond carto utilisé. layercarto="google" : fond google / layercarto="osm" : fond OpenStreetMap (défaut).
choixcarte obsolète "true" ou "false"
stylechoixcarte obsolète "HORIZONTAL_BAR" ou "DROPDOWN_MENU" ou "DEFAULT"
echelle obsolète "true" or "false"
Lien vers un wiki où le template est visible https://www.basededonnees-habitatparticipatif-oasis.fr/wakka.php?wiki=ColibriS
Mot clés

material-card.tpl.html

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut
materialcardtplhtml_capture-décran-2018-12-06-à-13.12.22.png
Présentation rapide présentation sous forme de vignettes graphiques souvent utilisées pour réaliser des annuaires visuels (si l'image n'est pas fournie une image par défaut est générée)
Détails des différents paramètres spécifiques à ce template nbcol="1, 2, 3, 4 ou 6" permet de jouer avec le nombre de colonnes
type="simple" permet de courcircuiter le comportement normal du template et d'ouvrir le contenu de la fiche directement
modal="1" : ouvre la fiche en fenêtre modal si placé sur 1
Lien vers les fichiers à télécharger si besoin https://github.com/YesWiki/templates-bazar
Informations importantes à propos de ce template Pour ce template, il est nécessaire d'ajouter un dossier javascripts contenant le fichier lazyload.min.js et un autre dossier nommé styles avec le fichier material-card.css.
Le sous-titre ne s'affichera que si le formulaire contient un champ du genre
texte***bf_baseline***Ici le sous-titre***
Lien vers un wiki où le template est visible https://lamangeoireduquartier.org/?OiseauxMangeoire
Lien vers le wiki démo où le template est visible http://yeswiki.net/cercopitheque/demo/?MaterialCard
Code source du formulaire qui a servi pour cet exemple
texte***bf_titre***Titre de la photo***255***255*** *** *** ***1***0***
n'apparait pas dans le formulaire : 
cette listethemes doit être définie dans l'onglet liste sinon elle n'apparait pas ! 
checkbox***ListeThemes***Thèmes de la photo*** ***1*** *** *** ***1***1***
image***bf_image***Image***20000000*** *** *** *** ***0*** ***ne pas dépasser 20 Mo
Mot clés

IIlustrez vos wiki avec des images, vidéos...

Libres de droits ou avec une licence libre

Des images, des illustrations, etc.

  • Unsplash : des images hautes définition libres
  • Pixabay : des images, des illustrations et des vidéo
  • Wikimedia commons : 35 millions de fichiers médias utilisables librement
  • Pikwizard : Stunning FREE Stock Photos

Des icones

Et aussi...

  • Wordle : faites des "nuages de mots clés"
  • 3Dshapes : présentez des couvertures de livre, DVD et CD en perspective (3D)

Améliorez vos images

  • XNConvert : un logiciel pour redimensionner, découper, et améliorer plusieurs images d'un coup
  • Colorzilla : une extension pour les navigateurs afin de connaitre le code d'une couleur affichée à l'écran
  • Adobe color CC : trouvez les couleurs complémetaires d'une couleur particulière

Faites des vidéos et des animations pour vos Wiki de formation

  • Moovly : créez des vidéos de présentation animées
  • Camstudio : un logiciel pour enregistrer votre écran pour faire des vidéos de formation

{{moteurrecherche}}

  • Comportements
  • permet d'ajouter un formulaire de recherche au sein du wiki
syntaxe minimale : {{moteurrecherche}}

Paramètres utilisables
  • les paramètres en gras sont obligatoires
  • un paramètre se déclare de la manière suivante nomduparametre="valeurduparametre"
nom du paramètre valeurs du paramètre
btnclass change la couleur du bouton
iconclass place une icône sur le bouton / reprendre la syntaxe de l'icône sur bootstrap
template le nom du template à utiliser. 3 templates existent
  • moteurrecherche_basic.tpl.html , affiche le champ texte + le bouton "loupe
  • moteurrecherche_button.tpl.html , n'affiche que le bouton "loupe", sans le champ texte
  • moteurrecherche_navbar.tpl.html
class les paramètres de class pour faire varier la mise en page /A COMPLETER

Architecture et développement de Yeswiki

Dossiers et fichiers de la distribution

actions : contient les actions yeswiki de base que l'on peut mettre entre accolades par ex: {{nomdelaction parametre="valeur du paramètre"}}
cache : contient les vignette, cache des flux rss , et autre (peut être vidé)
files : contient les fichiers uploades par les utilisateurs
formatters : contient les fichiers qui gerent la syntaxe wiki (les = pour titres etc)
handlers/page : actions a passer dans l'url /edit /raw /show /revisions /acls
includes : bibliothèques php utilisées par le code, dont les classes php principales de yeswiki
lang : dossier de langues
setup : dossier appelle à l'installation (s'il ne trouve pas de fichier wakka.config.php)
setup/docs : contient des fichiers <NomWikiPage>.txt avec le contenu des pages créées a l'installation d'un wiki
themes : contient les themes et les templates (voir la documentation)
tools : contient les extensions de base de YesWiki, puis celles ajoutées par l'utilisateur.
vendor : bibliothèques externes
.gitignore : fichier de config de git (pour dire les fichier et dossier qu'il ne doit pas surveiller)
COPYING : texte de présentation de licence à lire
INSTALL : texte de présentation de l'install à lire
LICENSE : texte de présentation de licence à lire
README.md : texte de présentation générale de yeswiki (apparaît en bas de github)
index.php : fichier lancé par défaut, initialise yeswiki
interwiki.conf : ancienne conf pour gérer l'inter wiki (plus trop utilisé)
robots.txt : directives pour les robots des moteurs de recherche
wakka.basic.css : graphisme par défaut de wiki si l'extension templates n'est pas utilisée
wakka.config.php : fichier de configuration de yeswiki, contient les informations pour se connecter à la base de données entre autre, si ce fichier est inexistant, la procédure d'installation se lance
wakka.css : graphisme par défaut de wiki si l'extension templates n'est pas utilisée
wakka.php : nom historique présent pour retro-compatibilité, renvoie à index.php

Créer des themes YesWiki

TODO : cours plus détaillé
Pour créer un nouveau thème, il vaut mieux dupliquer un thème existant et le glisser dans le dossier themes.

Créer des actions YesWiki

Exemple pratique de l'action {{salutations}}

si l'on ajoute un fichier salutations.php dans le dossier actions, ce sera automatiquement reconnu comme un action wiki
exemple de contenu :

affichage de base

<?php
echo "bonjour c'est moi !";

Dans ce cas {{salutations}} écrit dans une page wiki affiche "bonjour c'est moi !

utiliser des parametres

<?php
$name = $this->GetParameter("name");  // permet de recuperer le parametre "name" (nom de quelqu'un) ex: ""{{salutations name="Florian" }}"" 
$adjectif = $this->GetParameter("adjectif");  // permet de recuperer le parametre "name" (nom de quelqu'un) ex: ""{{salutations name="Florian" adjectif="le magnifique"}} ""
echo "bonjour ".$name." ".$adjectif.", c'est moi !";

test des parametres

<?php
$name = $this->GetParameter("name");  // permet de recuperer le parametre "name" (nom de quelqu'un) ex: ""{{salutations name="Florian" }} ""
if (empty($name)) {
    echo "<div class="alert alert-error">Erreur : action salutations : le paramètre 'name' est obligatoire.</div>";
} else {
    echo "Bonjour ".$name." , c'est moi !";
}

ajout au fichier de configuration wakka.config.php

'moment_de_la_journee' => "jour" // ou "nuit"

dans l'action
<?php
// travailler avec un element du fichier de configuration
if ($this->config["moment_de_la_journee"] ""<span id="TOC_5_13" class="yeswiki-title-anchor"></span>""== 'jour') {
    echo "bonjour";
} elseif ($this->config["moment_de_la_journee"] == 'nuit') {
    echo "bonsoir";
}

requetes SQL

dans l'action
<?php
// pour les insert, update, delete, actions qui ne renvoient par de resultat
// Le prefixe des tables est sauvegardé dans le fichier config (clé : table_prefix)
// efface tout l'historique des page
$this->Query('DELETE FROM '.$this->config['table_prefix'].'pages WHERE latest="N";');
// Pour les requetes de selection
$results = $this->LoadAll('SELECT * FROM '.$this->config['table_prefix'].'pages WHERE latest="Y";'); // sort tous les résultats
$result = $this->LoadSingle('SELECT * FROM '.$this->config['table_prefix'].'pages WHERE latest="Y";'); // sort uniquement le premier résultat

liens

//affiche le lien en mode edition de la page courante
echo $this->href('edit', $this->GetPageTag());
// affiche le lien en mode consultation de la page ToTo
echo $this->href('', 'ToTo');
// donne la page courante (où l'on se trouve)
echo $this->href('', $this->GetPageTag());
// ajouter des parametres GET a l'url courante
echo $this->href('', $this->GetPageTag(), 'nb=10&type=photo');

gestion des droits

$this->HasAccess('read', $this->GetPageTag() [, user= ""]);
$this->HasAccess('write', $this->GetPageTag());
$this->HasAccess('comment', $this->GetPageTag());
$this->UserIsAdmin() // l'utilisateur est il admin
$this->GetUser() // l'utilisateur est il admin


Créer des extensions YesWiki

Pour démarrer

  • Créer un dossier dans /tools.
    • Les extensions s'appuient sur l'architecture de dossiers de YesWiki. Il faut donc, lorsqu'on crée une extension, respecter l'arborescence de dossiers de l'architecture de base de YesWiki.
  • Placer un fichier desc.xml à la base du dossier /tools/monextension.
    • l'attribut active de l'élément racine de ce fichier doit valoir 1, sinon l'extension ne sera reconnue comme active par YesWiki.
    • la valeur de l'attribut name doit être le nom de l'extension.
    • (voir les autres extensions pour le format)
  • Le dossier /tools/monextension doit contenir un fichier wiki.php.
    • Ce fichier sera le premier exécuté lors de l'exécution de l'extension. C'est donc le bon endroit pour initialiser ce dont on aura besoin (créer des tables, faire des inclusions, des définitions de constantes, aller lire les paramètres par défaut dans wakka.config.php, etc. (voir les autres extensions).
    • Ce fichier doit impérativement contenir en premières lignes de code :
    • if (!defined("WIKINI_VERSION")) {
          die("acc&egrave;s direct interdit");
      }
      

Important

En cas de conflit de nom, par exemple, si plusieurs extensions ont le même nom, ou si plusieurs tools ont le même nom, ou si plusieurs actions ont le même nom (vous voyez l'idée ?)
L'exécution se fait dans l'ordre alphabétique. Ce comportement est propagé dans les actions de ces tools et entre les tools entre eux
Exemple : L'action monaction.php du tools tools1 s'exécute avant l'action monaction.php du tools2

Après, c'est plus ou moins open bar

  • Créer des actions dans le dossier actions
  • Créer des handler dans le dossier handler/Page
  • idem formatters, lang..
  • On peut exécuter des bidouilles en amont ou après l'exécution d'une action, d'un handler ou d'un formatter en mettant des underscores :
    • __nomdufichier.php pour avant,
    • nomdufichier__.php pour après,
    • dans ce contexte, $plugin_output_new contient le buffer de l'action par défaut

Piste de standardisation du code

Bonnes pratiques
Composer : https://getcomposer.org/ gestion des dependances php et autoload
Norme php :
- PSR-1 PSR-1: Basic Coding Standard
- PSR-2 Coding Style Guide

Editeur de code opensource
- Visual Studio Code https://code.visualstudio.com/
- Atom https://atom.io/
  • avec des linter : des outils pour vérifier si le code respecte des standards
- Eclipse avec PDT (Php Development Tool)
  • contient un built-in formatter pour PSR-2

Développer avec YesWiki localement

Il est possible de développer localement sur votre PC en installant les programmes nécessaires, a savoir le language de programmation php, la base de données mysql, et un serveur web (apache ou nginx).

Si vous etes sous windows, le plus simple est d'utiliser Wamp qui regroupe en un seul programme les differentes briques http://www.wampserver.com/

Pour les Mac, l'équivalent c'est https://www.mamp.info/en/

Pour linux, selon le systèmes, ya des paquets a installer, par exemple pour ubuntu https://linuxconfig.org/how-to-install-lamp-ubuntu-18-04-bionic-beaver-linux-apache-mysql-php

Contribuer au dépot git


Dépôts git utilisés

https://github.com/YesWiki/yeswiki : dépôt du code de YesWiki
https://github.com/YesWiki , tous les dépôts commençant par yeswiki-theme-* : thèmes open source de YesWiki
https://github.com/YesWiki , tous les dépôts commençant par yeswiki-extension-* : : extensions supplémentaires de YesWiki à mettre dans le dossier tools

Utiliser git

Commandes git utiles pour gérer YesWiki

photobox.tpl.html

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut
photoboxtplhtml_capture-décran-2018-12-08-à-12.44.34.png
Présentation rapide permet de créer une sorte de galerie photos qui peut s'ouvrir en pleine page
Lien vers un wiki où le template est visible http://coop-site.net/concours/wakka.php?wiki=PhotoGagnanteS2018
Lien vers le wiki démo où le template est visible http://yeswiki.net/cercopitheque/demo/?PhotoboX
Mot clés

photo-oxygen.tpl.html

Ce template est fourni avec un yeswiki de base non il doit être téléchargé
photooxygentplhtml_capture-photo-oxygen.png
Présentation rapide Galerie photo avec un joli effet zoom et rotation au survol de l'image
L'auteur est affiché au survol ainsi qu'une loupe pour affichage plein écran
Détails des différents paramètres spécifiques à ce template Nécessite à minima les champs :
  • bf_image
  • bf_auteur
Lien vers les fichiers à télécharger si besoin https://github.com/YesWiki/templates-bazar/blob/master/templates/photo-oxygen.tpl.html
Lien vers un wiki où le template est visible https://nuitdeschercheurs-france.eu
Mot clés

{{ProgressBar}}

est obtenu en écrivant dans une page [ 90% ] en enlevant les espaces
Cette élégante action permet les affichages suivants :
mettre à jour la doc
acheter du beurre
tuer la poule
mettre à jour mon wiki
installer des pneus neige
apprendre le latin
faire du pain
lire Freud
pour en comprendre la syntaxe, ajoutez /raw à la suite de l'adresse de cette page : http://yeswiki.net/wakka.php?wiki=ProgressBar/raw

Règles de formatage

Accentuation

**Gras**
//Italique//
__Souligné__
@@Barré@@

Titres

======Titre 1======

=====Titre 2=====

====Titre 3====

===Titre 4===

==Titre 5==

Listes

 - Liste à puce niveau 1
 - Liste à puce niveau 1
  - Liste à puce niveau 2
  - Liste à puce niveau 2
 - Liste à puce niveau 1

 1. Liste énumérée
 2. Liste énumérée
 3. Liste énumérée

Liens

[[http://www.exemple.com Texte à afficher pour le lien externe]]
[[PageDeCeWiki Texte à afficher pour le lien interne]]

Lien qui force l'ouverture vers une page extérieure

""<a href="http://exemple.com" target="_blank">ton texte</a>""

Images

Pour télécharger une image, utiliser le bouton Joindre/insérer un fichier
.

Tableaux

Colonne 1 Colonne 2 Colonne 3
John Doe Male
Mary Smith Female

Attention, ne mettez aucun caractère (même pas d'espace) derrière le | qui marque la fin de la fin d'une la ligne (dernière colonne).

Boutons wiki

{{button class="btn btn-danger" link="lienverspage" icon="plus icon-white" text="votre texte"}}

Placer un bouton qui s'ouvre dans un autre onglet

""<a href="votrelien" target="_blank" class="btn btn-primary btn-large">votre texte</a>""

Ecrire en html

si vous déposez du html dans la page wiki, 
il faut l'entourer de ""  "" 
pour qu'il soit interprété

Placer du code en commentaire sur la page

""<!-- en utilisant ce code on peut mettre du texte qui n'apparait pas sur la page... ce qui permet de laisser des explications par exemple ou même d'écrire du texte en prépa d'une publication future -->""

Code exemples

Insérer un iframe

Inclure un autre site, ou un pad, ou une vidéo youtube, etc...
""<iframe width=100% height="1250" src="http://exemple.com" frameborder="0" allowfullscreen></iframe>""

Texte en couleur

""<span style="color:#votrecodecouleur;">votre texte à colorer</span>""
Quelques codes couleur => mauve : 990066 / vert : 99cc33 / rouge : cc3333 / orange : ff9900 / bleu : 006699Voir les codes hexa des couleurs : http://fr.wikipedia.org/wiki/Liste_de_couleurs

Message d'alerte

Avec une croix pour le fermer.
""<div class="alert">
<button type="button" class="close" data-dismiss="alert">×</button>
Attention ! Voici votre message.
</div>""

Label "important" ou "info"

Important et Info
""<span class="label label-danger">Important</span>"" et ""<span class="label label-info">Info</span>""

Mise en page par colonne

le total des colonnes doit faire 12 (ou moins)
{{grid}}
{{col size="6"}}
===Titre de la colonne 1===
Texte colonne 1
{{end elem="col"}}
{{col size="6"}}
===Titre de la colonne 2===
Texte colonne 2
{{end elem="col"}}
{{end elem="grid"}}

Créer des onglets dans une page

Il est possible de créer des onglets au sein d'une page wiki en utilisant l'action . La syntaxe est (elle est à répéter sur toutes les pages concernée par la barre d'onglet)
{{nav links="NomPage1, NomPage2, NomPage3Personne" titles="TitreOnglet1, TitreOnglet2, TitreOnglet3"}}

Formulaires de contact

{{contact mail="adresse.mail@exemple.com"}}

Inclure une page dans une autre

{{include page="NomPageAInclure"}}

Pour inclure une page d'un autre yeswiki : ( Noter le pipe | après les premiers [[ )
[[|http://lesite.org/nomduwiki PageAInclure]]

Image de fond avec du texte par dessus

Avec possibilité de mettre du texte par dessus
{{backgroundimage height="150" file="monbandeau.jpg" class="white text-center doubletitlesize"}}
=====Texte du titre=====
description
{{endbackgroundimage}}

Modifier le bandeau supérieur

En y plaçant une image par ex et/ou un dégradé de couleur
{{section class="white cover text-center " file="bandeau.jpg" bgcolor="linear-gradient(135deg, #fad961 0%,#f76b1c 100%);" height="200"}}
======Un wiki de demo======
{{end elem="section"}}

Utiliser accordion

{{accordion}}
{{panel title="le titre" class="panel-danger"}}
le contenu
{{end elem="panel"}}
{{end elem="accordion"}}


Rendre le Bazar sémantique

Qu'est-ce que le web sémantique ?


Selon Wikipedia , « le Web sémantique fournit un modèle qui permet aux données d'être partagées et réutilisées entre plusieurs applications, entreprises et groupes d'utilisateurs ». L'expression a été inventée par Tim Berners-Lee (inventeur du Web et directeur du W3C), qui supervise le développement des technologies communes du Web sémantique. Il le définit comme « une toile de données qui peuvent être traitées directement et indirectement par des machines pour aider leurs utilisateurs à créer de nouvelles connaissances ». Pour y parvenir, le Web sémantique met en œuvre le Web des données qui consiste à lier et structurer l'information sur Internet pour accéder simplement à la connaissance qu'elle contient déjà.

Pour résumer, si ouvrir ces données c'est bien, les ouvrir avec de la sémantique permet aux différentes applications de mieux comprendre le sens des données partagées, et donc d'en avoir un usage plus facile. Utiliser de la sémantique, c'est utiliser des languages que d'autres machines peuvent comprendre et traiter.

Pourquoi rendre le Bazar sémantique ?

Voir la présentation faite ici pour plus de contexte

La base de donnée Bazar n'est pas sémantique par défaut, mais elle peut le devenir en ajoutant certaines métadonnées sur les objets et les champs. Cela permet ensuite d'exporter les données sous format JSON-LD (en plus du format non-sémantique JSON). Un bouton "JSON-LD" apparait alors à côté des boutons "CSV" et "JSON".

La page d'un objet Bazar peut aussi être vue sous forme JSON-LD en utilisant ce header:

Accept: application/ld+json

Finallement, si le vocabulaire sémantique ActivityStreams est utilisé, cela permet de configurer l'extension webhooks pour utiliser ActivityPub.

Comment rendre le Bazar sémantique ?

Soit en important des modèles de formulaires existant (par exemple ceux de https://yeswiki.net), soit en créant ses propres modèles :

1. Cliquez sur la roue dentée en haut à droite et cliquez sur "Base de données" ((?BazaR))
2. Editez un formulaire existant ou créez en un nouveau
3. Cliquez sur "Configuration avancée" en bas du formulaire
4. Entrez un contexte sémantique, soit une simple URL (p.ex. https://www.w3.org/ns/activitystreams), soit un contexte plus compliqué sous forme de JSON. Dans l'exemple ci-dessous, on a un contexte principal ActivityStreams et un contexte plus particulier schema.org.

[
  "https://www.w3.org/ns/activitystreams",
  { "schema": "https://schema.org/" }
]

5. Entrez un type sémantique en dessous. Cela défini le type de l'objet entier. Vous pouvez définir le type avec un simple nom (Si vous entrez Article, cela utilisera l'objet https://www.w3.org/ns/activitystreams#Article), soit une liste de types séparés par une virgule. Dans l'exemple ci-dessous, le préfix schema: renvoie au contexte défini ci-dessus:

Article, schema:Article

6. Définissez le type sémantique de chaque champ. Pour cela, vous devez utiliser le 15ème des champs possibles du formulaire, séparé par trois étoiles. Voilà un exemple de formulaire, où le titre utilise la propriété https://www.w3.org/ns/activitystreams#title et https://schema.org/name.

texte***bf_titre***Titre***255***255*** *** *** ***1***0*** *** *** *** ***title, schema:name
textelong***bf_description***Contenu***40***30*** *** *** ***1***0*** *** *** *** ***content
image***bf_image***Image de présentation (facultatif)***140***140***600***600***right*** *** ***Votre image doit être au format .jpg ou .gif ou .png*** *** *** ***image

Si vous revenez sur la page principale, vous devriez avoir un bouton "JSON-LD" qui s'affiche sur la ligne du formulaire que vous avez modifié. Si vous cliquez dessus et que vous avez déjà entré des données dans ce formulaire, vous devriez voir les donnes représentées de cette manière :
[
  {
    @context: [
      "https://www.w3.org/ns/activitystreams",
      {
        schema: "https://schema.org/"
      }
    ],
    @type: [
      "Article",
      "schema:Article"
    ],
    @id: "http://localhost/?MonPremierArticle",
    title: "Mon premier article",
    schema:name: "Mon premier article",
    content: "Le premier article de mon blog est maintenant en ligne."
  }
]

Vous retrouvez toutes les informations définies ci-dessus. A noter que le champ titre est dupliqué, ce qui est obligatoire lorsqu'on a un même champ qui a plusieurs définitions sémantiques. A noter également que si vous n'aviez pas défini la définition sémantique d'un champ de ce bazar, il n'aurait pas été retourné dans le JSON ci-dessus.

Comment développer des templates Bazar spécifiques à un type sémantique ?

A partir du moment où un formulaire Bazar est sémantique, une nouvelle propriété "semantic" est ajoutée aux objets $fiche et $html, qui sont généralement utilisés pour récupérer et afficher les données d'une fiche donnée. Cette propriété contient un objet JSON-LD complet, avec le contexte, le type, l'ID et toutes les propriétés typées que vous avez définies.

Il est aussi possible de créer des templates particuliers à un type, pour une utilisation plus large par la communauté YesWiki. Un exemple se trouve dans le fichier /tools/bazar/presentation/templates/activitystreams/note.tpl.html. Ce template est automatiquement appliqué à tout objet qui a pour type une Note ActivityStreams.

  • Pour ajouter d'autres types ActivityStreams, il suffit d'ajouter d'autres fichiers dans le même dossier (en utilisant le nom du type en minuscule).

  • Pour faire un mapping avec d'autres vocabulaires sémantiques, il suffit d'éditer la variable globale "baz_semantic_types_mapping".

  • Si vous ne voulez pas utiliser le template par défaut d'un type sémantique, il suffit de décocher le champ "Utiliser un template sémantique s'il est disponible pour ce type d'objet" dans la configuration avancée du formulaire de l'objet.

Intégrer des emoji dans sa roue crantée ;-)

Si vous voulez voir un exemple avant de vous lancer, cliquez donc sur la roue crantée de ce wiki !

sur un wiki classique la page roue crantée c'est ça

{{moteurrecherche template="moteurrecherche_button.tpl.html"}}
{{buttondropdown icon="cog" caret="0"}}
 - {{login template="modal.tpl.html" nobtn="1"}}
 - ------
 - {{button nobtn="1" icon="fa fa-question" text="Aide" link="AidE"}}
 - ------
 - {{button nobtn="1" icon="fa fa-wrench" text="Gestion du site" link="GererSite"}}
 - {{button nobtn="1" icon="fa fa-tachometer-alt" text="Tableau de bord" link="TableauDeBord"}}
 - {{button nobtn="1" icon="fa fa-briefcase" text="Base de données" link="BazaR"}}
{{end elem="buttondropdown"}}

on peut l'embellir un peu en remplaçant les icones par des emojis

{{moteurrecherche template="moteurrecherche_button.tpl.html"}}
{{buttondropdown icon="cog" caret="0"}}
 - {{login template="modal.tpl.html" nobtn="1"}}
 - ------
 - {{button nobtn="1"  text="🚑  Aide" link="AidE"}}
 - ------
 - {{button nobtn="1" text="⚙️Gestion du site" link="GererSite"}}
 - {{button nobtn="1" text="📈 Tableau de bord" link="TableauDeBord"}}
 - {{button nobtn="1" text="🗄 Base de données" link="BazaR"}}
{{end elem="buttondropdown"}}
démo de l'action

{{section}}

Permet de créer des sections de texte sur lequel vous pourrez appliquer des effets
Comportements
Permet de délimiter un espace de texte, de titres... sur lequel s'applique un style particulier.
Cette action s'associe avec l'action {{animation}} qui placée en haut de page permettra d'appeler les styles animate.css et wow.css
  • l'action {{end elem="section"}} EST NECESSAIRE : Elle clôt la section qui sera affectée par vos effets
syntaxe minimale :
{{section}}
votre contenu à afficher sur l'image
{{end elem="section"}}
syntaxe complexe :
{{section class="wow bounce" bgcolor="orange" height="200"}}
votre contenu à afficher sur l'image
{{end elem="section"}}

Paramètres utilisables
  • les paramètres en gras sont obligatoires
  • un paramètre se déclare de la manière suivante nomduparametre="valeurduparametre"
nom du paramètre valeurs du paramètre
class Ajoute une classe CSS: full-height (l'image prendra tjrs la taille de l'écran même si on redimensionne), fixed (effet parallax), cover (trouve le meilleur ration pour couvrir la zone), center (centre en horizontal) / Rendez vous également au sein de l'action {{animation}} pour voir les effets dont vous disposez !!!
file ou bgcolor le nom du fichier (uniquement gif, jpg, jpeg ou png) ou la couleur en ascii de style #0845ff
(liste des codes couleurs sur wikipédia )
height en px = la hauteur de votre bandeau)

semi-ouvert.tpl.html

Ce template est fourni avec un yeswiki de base non il doit être téléchargé
semiouverttplhtml_semi_ouvert.png
Présentation rapide ce template affiche sous forme de liste des "blocs" le contenu du formulaire avec une image à gauche et des champs (bf-titre et ... ) à droite + télécharger fichier, lien vers url et bouton en savoir plus pour ouvrir la fiche complètement (tous les champs de ce template sont cachés s'ils ne contiennent pas de données / ou image par défaut).
Détails des différents paramètres spécifiques à ce template Les champs nécessaires minimaux sont
  • bf_titre
  • bf_image optionnelle
  • bf_date_debut_evenement optionnel
  • bf_description
  • bf_site_internet optionnel
  • champ fichierstage à télécharger optionnel
Lien vers le wiki démo où le template est visible http://yeswiki.net/cercopitheque/demo/?SemiOuvert
Code source du formulaire qui a servi pour cet exemple
texte***bf_titre***Nom de l'événement***60***255*** *** *** ***1***0***
textelong***bf_description***Description***40***10*** *** *** *** 
textelong***bf_chapo***Chapo de l'article***40***10*** *** *** ***0
texte***bf_nombre***Nombre de participants***60***255*** *** *** ***0***0***
Ce texte n'apparait pas dans le formulaire
il est NECESSAIRE d'avoir les deux champs ci-dessous si on veut un affichage en calendrier
jour***bf_date_debut_evenement***Début de l'événement***1*** *** *** *** ***1***0
jour***bf_date_fin_evenement***Fin de l'événement***1*** ***  *** ***  ***1***0
texte***bf_horaire***Horaire***60***255*** *** *** ***0***0***
jour***bf_date_debut_publication***Début de la publication***1*** ***  *** ***  ***1***0
jour***bf_date_fin_publication***Fin de la publication***1*** ***  *** ***  ***1***0
texte***bf_horaire***Horaire***60***255*** *** *** ***0***0***
lien_internet***bf_site_internet***Site Web***40***255***http://*** *** ***0***0
image***bf_image***Image (facultatif)***140***140***600***600***right*** *** ***Votre image doit être au format .jpg ou .gif ou .png
fichier***fichier***Documents***20000000*** *** *** *** ***0*** ***ne pas dépasser 20 Mo
texte***bf_adresse***Adresse***50***50*** *** *** ***0***0
texte***bf_code_postal***Code postal***8***8*** *** *** *** ***0
texte***bf_ville***Ville***50***80*** *** *** *** ***0
labelhtml***<span style="color:#cc3333;">Il faut maintenant cliquer sur le bouton bleu pour placer votre point sur la carte </span><br>*** ***
carte_google***bf_latitude***bf_longitude***cartogoogle***
labelhtml***<h3>Il ne vous reste plus qu'à valider ! </h3>*** ****** *** *** *** *** *** *** ***
Mot clés

Style interface


<style>
:root {
  --main-text-color:#0c0a3e;
  --main-text-fontsize:16px;
  --main-text-lineheight:1.5em;
  --main-text-fontfamily:'Inter UI', sans-serif;
  --main-selected-text-bg:#f3c677;
  --main-bg-color:#E1E1E1;
  --main-container-bg-color:#fff;

  /* full width */
  --main-container-margin: 0;
  --main-container-width: 100%;
  --main-container-text-width: 100%;
  --main-container-border-radius: 0;
  --main-container-box-shadow: none;
  --section-background-image-width:100vw;
  --section-background-image-margin:-50vw;
  --section-background-image-position:50%;

  /* contained page */
  /*
  --main-container-margin: 15px auto 15px auto;
  --main-container-width: 1000px;
  --main-container-text-width: 800px;
  --main-container-border-radius: 4px;
  --main-container-box-shadow: 0 1px 3px rgba(0, 0, 0, 0.35);
  --section-background-image-width:var(--main-container-width);
  --section-background-image-margin:calc((var(--main-container-text-width) - var(--main-container-width) - 30px) / 2);
  --section-background-image-position:0;*/

  --navbar-bg-color: #7b1e7a;
  --navbar-text-color: #FFF;
  --navbar-link-color: #FFF;
  --navbar-link-bg-color: transparent;
  --navbar-link-hover-color: #f3c677;
  --navbar-link-bg-hover-color: transparent;
  --navbar-border: none;
  --navbar-border-radius : 4px 4px 0 0;
  --navbar-shadow: 1px 1px 1px rgba(0,0,0,.2);


  --header-bg-color: #f4f4f4;
  --header-text-color: #414141;
  --header-title-color: #0c0a3e;

  --footer-bg-color: #0c0a3e;
  --footer-text-color: #99999b;
  --footer-link-color: #eee;
  --footer-title-color: #ccc;
  --footer-border-top:  none;

  --btn-border:none;
  --btn-border-radius:2px;
  --btn-default-color:#7b1e7a;
  --btn-default-background:#fff;
  --btn-default-border:1px solid #7b1e7a;
  --btn-default-hover-color:#b33f62;
  --btn-default-hover-background:#fff;
  --btn-default-hover-border:1px solid #b33f62;
  --btn-primary-color:#fff;
  --btn-primary-background:#7b1e7a;
  --btn-primary-border:1px solid #7b1e7a;
  --btn-primary-hover-color:#fff;
  --btn-primary-hover-background:#b33f62;
  --btn-primary-hover-border:1px solid #b33f62;
}
</style>

Téléchargements Extensions


Extensions à installer dans le répertoire /tools.

Extension : Actions

Pour disposer d'une action de gestion des utilisateurs, permettant entre autre de supprimer les utilisateurs non voulus. (par Jean-Pascal Milcent, de Tela Botanica)

Extension : a_multilinguisme (alpha version)

Permet de mettre le site yeswiki en anglais, pourrait être adapté pour d'autres langues

Extension : Facette

Permet de filtrer le contenu de fiches bazar grâce à des cases à cocher indiquant des critères de catégorisation de ces fiches

Extension : Gestionnaire de fiches Bazar

L'extension Bazar permet à la fois de gérer des formulaires et de gérer les données saisies dans ces formulaires.

Extension : IP-Block

Blocage par filtre ip des spammeurs indonésiens

Extension : despam

Pour effacer les pages affectées de spam de manière radicale (à réserver aux plus aguerris)

Extension : Post-installation

Ajout de pages supplémentaires une fois le wiki installé

Extension Syndication

L'extension syndication permet d'afficher une liste de liens issus d'un flux RSS

Extension Login

L'extension login permet d'afficher un formulaire d'identification simplifié et configurable.
De plus, quand on arrive sur une page où il faut être identifié, un formulaire d'identification minimal sera proposé plutôt qu'un message d'erreur.

Extension Contact

L'extension contact permet d'afficher un formulaire d'envoi de mail, d'inscription ou de désinscription à une newsletter, et la possibilité d'envoyer des pages de votre site par mail.


Extension Attach

Cette version permet de redimensionner les images automatiquement au moment de l'envoi.

Extension Tags

Ensemble d'actions wikini permettant d'associer a des pages wiki des mot clés, afin de catégoriser le contenu.

Extensions en vrac

Ici une copie brute de l'ensemble des extensions disponibles :

Afin d'éviter des erreurs, il est déconseillé d'écraser le dossier tools déjà présents sur votre espace ftp par ce dossier tools "complet".
Choisissez plutôt dans ce dossier tools "complet" ceux qui vous voulez installer et placez-les un par un dans votre dossier tools sur votre espace FTP.

timeline.tpl.html

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut
timelinetplhtml_timeline.png
Présentation rapide affiche les fiches sous forme de ligne du temps
Limitations sur ce template N'affiche que le titre et l'image. Pas de possibilité de cliquer pour voir le détail de chaque fiche. Pour faire cela, il faut écrire un autre {{bazarliste}} en utilisant un autre template.
Voir exemple "interpole" ci-dessous.
Lien vers un wiki où le template est visible https://interpole.xyz/?NotreHistoire
Mot clés

trombinoscope.tpl.html

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut
trombinoscopetplhtml_actionbazarliste_capture_trombinoscope_20180309101559_20180309102406.png
Présentation rapide affiche uniquement les fiches qui ont une image sous forme de bloc. Il est donc parfois nécessaire de rendre le champ image obligatoire sinon certaines fiches n'apparaitront pas.
Limitations sur ce template affiche uniquement les fiches qui ont une image sous forme de bloc. Il est donc parfois nécessaire de rendre le champ image obligatoire sinon certaines fiches n'apparaitront pas.
Lien vers le wiki démo où le template est visible http://yeswiki.net/cercopitheque/demo/?TrombI
Code source du formulaire qui a servi pour cet exemple
texte***bf_titre***Nom de l'événement***60***255*** *** *** ***1***0***
textelong***bf_description***Description***40***10*** *** *** *** 
textelong***bf_chapo***Chapo de l'article***40***10*** *** *** ***0
texte***bf_nombre***Nombre de participants***60***255*** *** *** ***0***0***
Ce texte n'apparait pas dans le formulaire
il est NECESSAIRE d'avoir les deux champs ci-dessous si on veut un affichage en calendrier
jour***bf_date_debut_evenement***Début de l'événement***1*** *** *** *** ***1***0
jour***bf_date_fin_evenement***Fin de l'événement***1*** ***  *** ***  ***1***0
texte***bf_horaire***Horaire***60***255*** *** *** ***0***0***
jour***bf_date_debut_publication***Début de la publication***1*** ***  *** ***  ***1***0
jour***bf_date_fin_publication***Fin de la publication***1*** ***  *** ***  ***1***0
texte***bf_horaire***Horaire***60***255*** *** *** ***0***0***
lien_internet***bf_site_internet***Site Web***40***255***http://*** *** ***0***0
image***bf_image***Image (facultatif)***140***140***600***600***right*** *** ***Votre image doit être au format .jpg ou .gif ou .png
fichier***fichier***Documents***20000000*** *** *** *** ***0*** ***ne pas dépasser 20 Mo
texte***bf_adresse***Adresse***50***50*** *** *** ***0***0
texte***bf_code_postal***Code postal***8***8*** *** *** *** ***0
texte***bf_ville***Ville***50***80*** *** *** *** ***0
labelhtml***<span style="color:#cc3333;">Il faut maintenant cliquer sur le bouton bleu pour placer votre point sur la carte </span><br>*** ***
carte_google***bf_latitude***bf_longitude***cartogoogle***
labelhtml***<h3>Il ne vous reste plus qu'à valider ! </h3>*** ****** *** *** *** *** *** *** ***
Mot clés

Vidéos didactiques et "Comment faire pour..."

Chaîne vidéos de Yeswiki

Toutes ces vidéos sont disponibles sous licence Creative Commons.
https://video.coop.tools/video-channels/yeswiki/videos



Et voici le lux RSS pour rester informé des nouveautés
https://video.coop.tools/feeds/videos.xml?videoChannelId=175

Comment faire pour

Url courtes dans yeswiki

Procédure pour apache avec un fichier .htaccess

1) Par FTP, créer un fichier .htaccess a la racine du wiki ou éditer l'existant pour ajouter :
RewriteEngine on  
RewriteCond %{REQUEST_FILENAME} !-f  
RewriteCond %{REQUEST_FILENAME} !-d  

RewriteCond %{REQUEST_URI} ^\/[^/]+\/(.+\..+)$ [NC]  
RewriteRule ^.*$ %1 [QSA,L]  

RewriteRule ^([A-Z0-9].+)$ wakka.php?wiki=$1& [QSA,L]
Attention : cette formule du fichier .htaccess n'est que valable pour un wiki a la racine, il faudra l'adapter pour des sous dossiers...


2) Editer le fichier de configuration wakka.config.php, et changer les lignes suivantes :
Changer
'base_url' => 'http://mondomaine.ext/wakka.php?wiki=',
'rewrite_mode' => '0',
Pour
'base_url' => 'http://mondomaine.ext/',
'rewrite_mode' => '1',
Attention : laisser le / a la fin de l'url pour 'base_url'

Découvrir le module bazar (création de formulaires) en vidéo























Widgets à intégrer


Yeswiki peut accueillir quelques fonctionnalités complémentaires par l'intégration de petits bouts de code ça et là...

Afficher une page de YesWiki dans un Wordpress


  • Appeler une page Yeswiki en Iframe toujours possible, mais empêche l'indexation par le moteur de recherche de wordpress.
La solution pour que la page soit répliquée dans le wordpress en prenant le style de ce dernier :
  • Dans le fichier functions.php de Wordpress dans le thème utilisé, ajouter les lignes suivantes à la fin

function wikihtml_func( $atts ) {
  $html = file_get_contents($atts['url']);
  return $html;
} 
add_shortcode( 'wikihtml', 'wikihtml_func' );


Il vous suffira ensuite, d'insérer le code suivant dans une page ou un article wordpress,

[wikihtml url="ICI_URL_DE_LA_PAGE_WIKI/html"]
Ex : [wikihtml url="https://yeswiki.net/?AccueiL/html"]


Exemple de page yeswiki affichée dans un wordpress :

La carte des fédérations départementales de l'ACEPP
La mise à jour des données de chaque membre de la fédération est réalisée sur le yeswiki en autonomie

{{yeswikiversion}}


affiche le petit message "galope avec yeswiki" au sein du footer + info au survol de la version
Filtrer :  A améliorer  Ã©dition  brother Printer Support  Call Girls Service in Chennai  Développement  dell printer support  Demandé  documentation  droits utilisateurs  extension  facile  fichiers  github  groupes  hp printer support  identification  insertion  intermédiaire  interopérabilité  liens  menus  mise en forme  modification  mots de passe  Newsletter  notifications  obsolète  pages  php  pieds de page  restauration  rss  sémantique  spam  style  thèmes  todo  versions  videos  widget