Un total de 133 pages a été trouvé avec le mot clé documentation.

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

Extension Progress Bar

→
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é.

Télécharger l'extension Progress Bar
la décompresser et la copier dans le répertoire tools de votre YesWiki,
Vérifier que dans le fichier desc.xml active soit sur "1" et c'est fini !

Paramètres des actions

[100%] done

[40%] done

[60%] done

[50%] done

[5%] done

[25%] done

[6/14] done

→

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.

téléchargement: https://github.com/YesWiki/yeswiki-extension-captcha/archive/master.zip
code source: https://github.com/YesWiki/yeswiki-extension-captcha

Extension Tags

→

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)

Télécharger l'extension Tags
Les décompresser et les copier dans le répertoire tools de votre YesWiki
Ajouter dans une page de votre YesWiki l'action correspondante entre {{ }}

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 {{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

Action listepages : N'existe pas

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...

→

affiche le petit message "galope avec yeswiki" au sein du footer + info au survol de la version

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

Télécharger l'extension a_multilinguisme

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

Télécharger l'extension facette

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

Télécharger l'extension IP-Block

Extension : despam

Pour effacer les pages affectées de spam de manière radicale (à réserver aux plus aguerris)

Télécharger l'extension despam

Extension : Post-installation

Ajout de pages supplémentaires une fois le wiki installé

Télécharger l'extension Post-installation

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.

Télécharger l'extension Attach

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 :

Télécharger toutes les extensions

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.

Extension Contact

→

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é.

Télécharger l'extension Contact
la décompresser et la copier dans le répertoire tools de votre YesWiki, et c'est fini!

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".

→

Wikical

Action Login

→

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é.

Télécharger l'extension Login
la décompresser et la copier dans le répertoire tools de votre YesWiki, et c'est fini!

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

→

Activité

Duplicateur

Googleanalytics

Google Drive

Notif

Ebook pdf

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

page inutile : voir plutôt DocumentationColonneMenu

DocumentationEffacerUtilisateurOuChangerMotDePasse

Modifier son mot de passe

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

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

Si vous avez perdu votre mot de passe,

allez sur la page ParametresUtilisateur (accessible depuis le menu "roue crantée" : "se connecter"
- Vous pouvez également ajouter dans une page l'action {{lostpassword}} qui permet de retrouver son mot de passe
voir plus bas "permettre aux utilisateurs de récupérer leur mot de passe par mail en cas d'oubli)
allez dans la partie "récupération du mot de passe"
ajoutez votre mail dans le champ "email" et cliquez sur "envoyer"
vous allez recevoir un nouveau mail avec un lien pour générer un nouveau mot de passe
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}}

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.

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é.

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

Ajouter des thèmes graphiques

Importer un thème graphique pré-existant

Pour les bidouilleurs confirmés :

Pour installer un nouveau thème graphique :

Récupérer le fichier compressé (par exemple depuis la liste disponible sur le site de Yeswiki)
Le dé-compresser
L'envoyer par ftp dans votre yeswiki, dans le dossier "thèmes" /theme .

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.

→

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)

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~~

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

Syntaxe Markdown

YesWiki dans sa version Doryphore intègre une bibliothèque Markdown.
Afin d'utiliser la syntaxe markdown vous devez utiliser les balises suivantes :

""<div class="markdown"> votre markdown ici </div>""

Mémo syntaxe Markdown

# Titre 1

# Titre 1

|
| Titre 2 |

## Titre 2

## Titre 2

|
| Titre 3 |

### Titre 3

### Titre 3

|
| Gras |

Un peu de **texte en gras**

Un peu de **texte en gras**

|
| Italique |

Un peu de *texte en italique*

Un peu de *texte en gras*

|
| Citation |

> Laurent.
> YesWiki c'est génial?
> Les autres.
> C'est bon on a compris !!!!

> Laurent. > YesWiki c'est génial? > Les autres. > C'est bon on a compris !!!!

|
| Liste |

* Lait
* Oeuf
* Fromage
    * Fourme
    * Langres
* Jambon

* Lait * Oeuf * Fromage * Fourme * Langres * Jambon

|
| Liste ordonnée |

1. Introduction
2. Acte 1
3. Acte 2
    1. Scène 1
    2. Scène 2
4. Acte 3

1. Introduction 2. Acte 1 3. Acte 2 1. Scène 1 2. Scène 2 4. Acte 3

|
| Code Source |

Voilà du `JavaScript()`

Voilà du `JavaScript()`

|
| Bloc de code |

Voilà un peu de code en JavaScript :

```
function bonjour() {
    alert('Bonjour');
}
```

Le langage est normalement détecté automatiquement,
mais vous pouvez aussi le spécifier:

```sql
SELECT * FROM users;
DELETE FROM sessions;
```

Voilà un peu de code en JavaScript : ``` function bonjour() { alert('Bonjour'); } ``` Le langage est normalement détecté automatiquement, mais vous pouvez aussi le spécifier: ```sql SELECT * FROM users; DELETE FROM sessions; ```

|
| Lien Hypertexte |

Ceci est détecté comme un lien:

https://yeswiki.net

Et ceci est un lien avec un texte ancré :

[YesWiki](https://yeswiki.net)

Et ceci est un lien avec un texte ancré 
et un texte en survol :

[YesWiki](https://yeswiki.org "Page d'accueil de YesWiki")

Ceci est détecté comme un lien: https://yeswiki.net Et ceci est un lien avec un texte ancré : [YesWiki](https://yeswiki.net) Et ceci est un lien avec un texte ancré et un texte en survol : [YesWiki](https://yeswiki.org "Page d'accueil de YesWiki")

|
| Images |![Icône YesWiki](https://frama.link/YesWiki) |

![Icône YesWiki](https://frama.link/YesWiki)

|
|Ligne Horizontale |

Une ligne :
***
ou
Une autre ligne :
---

Une ligne : *** ou Une autre ligne : ---

|
|]

Tableaux

Les tableaux sont créés en utilisant des pipes | et des traits d'union -.

Voici un tableau en Markdown :

|     Mardi     |    Mercredi   |
| ------------- | ------------- |
|    Laurent    |    Jérémie    |
|   Sébastian   |    Romain     |

Et voici le rendu :

| Mardi | Mercredi | | ------------- | ------------- | | Laurent | Jérémie | | Sébastian | Romain |

Notez qu'il faut au moins trois caractères de séparation dans chaque cellule titre.

La ligne 2 peut être utilisée pour aligner les colonnes:

| Ce Tableau     | Est              | Cool            |
| -------------- |:----------------:| ---------------:|
| col 3 est      | alignée à droite | Doryphore       |
| col 2 est      | centrée          | Cercopithèque   |

Et voici le rendu :

| Ce Tableau | Est | Cool | | -------------- |:----------------:| ---------------:| | col 3 est | alignée à droite | Doryphore | | col 2 est | centrée | Cercopithèque |

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.

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".
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 :

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>

Color

Widgets à intégrer

Yeswiki peut accueillir quelques fonctionnalités complémentaires par l'intégration de petits bouts de code ça et là...

un popup informatif à l'ouverture de la page

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

Gérer les droits des actions et des handlers

Les actions sont définies dans la page Liste des actions.
Les handlers sont définis dans la page Liste des handlers.
Un handler correspond à un bout de code que nous devons ajouter en fin d'url pour déclencher un mode. Exemple :

/raw

pour voir le code d'une page.

Documentation des actions

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

Quelques actions pour commencer

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

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

Un joli bouton cliquables pour vos liens

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

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

Permet de créer un sommaire mobile sur la page

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

Toutes les actions par ordre alphabétique

S'abonner à une liste de discussion / diffusion

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

active des styles permettant d'animer vos pages

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

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

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

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

Lister les pages qui font un lien vers la page courante

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

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

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

Un joli bouton cliquables pour vos liens

mise en page par colonne

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

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.

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

Affiche le NomWiki de la page courante

Se désabonner à une liste de discussion / diffusion

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

Pour les thèmes : active le double clic

Interface de création d'un ebook

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

Gestion des droits des actions

Gérer des groupes d'utilisateurs

Gestion des droits des handlers

Finir les actions grid, col

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

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

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

Ouverture d'une zone avec des colonnes

Liste des pages

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

Liste la totalité des pages du site.

{{Listusers/last}

Donne la liste des derniers comptes utilisateurs.

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

Affiche un moteur de recherche

Liste les pages dont je suis le propriétaire

Liste les pages que j'ai modifié

Permet de créer des onglets dans une page

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

Permet de faire des points cliquables sur une image

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

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

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

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

Tester directement les styles disponibles sur votre wiki

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

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

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

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

Permet d'afficher un pdf présent sur le site

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

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

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

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

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.

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

Permet d'intégrer une vidéo en provenance de Youtube, Vimeo ou Peertube

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

Documentation des handlers

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...
/editiframe : permet d'ouvrir la page en mode édition mais en cachant les autre spages du squelette (utile quand une image ou un spam sur le bandeau empêche de voir le contenu de la page à modifier ou dans le cas d'un wiki intégré en iframe)

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

Il est possible de choisir les droits d'utilisation de chaque action et de chaque handler grâce aux actions {{editactionsacls}} et {{edithandlersacls}}.

Les pages d'aide associées sont EditActions et EditHandlersAcls.

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

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

Cliquer sur "voir"
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)
Cliquer sur enregistrer

image EditerGroupe.png (14.3kB) — Pour ajouter des compte utilisateurs à un groupe

Pour créer un nouveau groupe

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

Pour utiliser la gestion des groupes

Cela se fait dans les pages de gestion des droits

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.

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 :

photobox.tpl.html

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut

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

Paramètres personnalisables :

largeur vignette : thumbwidth="100" > indiquer le nb de px sans préciser l'unité
hauteur vignette : thumbheight > idem
redimensionnent vignette : thumbresize
- aux dimensions exactes, quitte à rogner l'image (crop)
- ou garder dimensions originales à l'intérieur des dimensions (fit)
marge entre les images :thumbmargin par defaut 1;
largeur image plein écran bigwidth
hauteur image plein écran bigheight
redimensionnent image plein écran : bigresize
- aux dimensions exactes, quitte à rogner l'image (crop)
- ou garder dimensions originales à l'intérieur des dimensions (fit)

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 documentation

Empêcher les mises à jour d'effacer vos personnalisations locales

En tant qu'utilisateur avancé, vous avez modifié des fichiers sur votre hébergement (par ftp par exemple), et ces fichiers sont écrasés à chaque mise à jour.

Cette page n'est pas utile pour les fichiers des dossiers "files" et "cache".

Il existe à la racine de votre hébergement le dossier "custom"" qui n'est pas affecté par les mises à jour. Chaque fichier présent dans ce dossier est utilisé à la place du fichier habituel.

Exemple :

Vous avez modifié le fichier "agenda.tpl.html" situé dans le dossier "/tools/bazar/presentation/templates" pour une personnalisation pour votre YesWiki.
Cette modification en sera pas préservée lors des mises à jour.
Pour éviter ceci, suivez la méthode suivante.

Méthode :

Version cercopitheque et doryphore jusqu'à 2020-11-23-1

pour un template de thème graphique (détails sur les thèmes en suivant ce lien) :
- 1. identifier le fichier. Par exemple :
```
/themes/margot/squelettes/1col.tpl.html
```
  (“margot” est le nom de dossier du thème utilisé)
- 1. le copier dans le dossier :
```
/custom/themes/margot/squelettes/1col.tpl.html
```
  (attention avec certaines versions de cercopitheque la mise à jour peut effacer ce dossier custom, pensez à le sauvegarder avant mise à jour)
pour un template bazar (détails sur les templates bazar en suivant ce lien):
- 1. identifier le fichier. Par exemple :
```
/tools/bazar/presentation/templates/mon_template.tpl.html
```
  (“bazar” est le nom de l'extension où se trouve le template)
- 1. le copier dans le dossier :
```
/themes/tools/bazar/templates/mon_template.tpl.html
```
pour une action (détails sur les actions en suivant ce lien):
- 1. mettre votre fichier
```
monaction.php
```
  dans le dossier
```
custom/actions
```
- 2. ET modifier la valeur dans wakka.config.php de
```
'action_path' => 'actions',
```
  vers
```
'action_path' => 'actions:custom:actions',
```
  (attention avec certaines versions de cercopitheque la mise à jour peut effacer ce dossier custom, pensez à le sauvegarder avant mise à jour)

Version doryphore à partir de 2020-11-23-1

pour un template de thème graphique (détails sur les thèmes en suivant ce lien) :
- 1. identifier le fichier. Par exemple :
```
/themes/margot/squelettes/1col.tpl.html
```
  (“margot” est le nom de dossier du thème utilisé)
- 1. le copier dans le dossier :
```
/custom/themes/margot/squelettes/1col.tpl.html
```
pour un template bazar (détails sur les templates bazar en suivant ce lien):
- 1. identifier le fichier. Par exemple :
```
/tools/bazar/presentation/templates/mon_template.tpl.html
```
  (“bazar” est le nom de l'extension où se trouve le template)
- 1. le copier dans le dossier :
```
/custom/templates/bazar/mon_template.tpl.html
```
cas particulier des templates pour les fiches :
- créer un fichier
```
fiche-X.tpl.html
```
  ou
```
fiche-X.twig
```
  dans le dossier
```
/custom/templates/bazar/
```
  , X est le numéro du formulaire associé
- pour les extensions, il est possible prendre le dessus sur un template bazar en mettant le fichier dans le dossier
```
/tools/my-extension-folder/templates/bazar/
```
pour une action (détails sur les actions en suivant ce lien):
- mettre votre fichier
```
monaction.php
```
  dans le dossier
```
custom/actions
```
pour un fichier javascript :
- mettre votre fichier
```
monscript.js
```
  dans le dossier
```
custom/javascripts
```

Découvrir le module bazar (création de formulaires) en vidéo

Ces tutos sont basés sur la version cercopithèque et ne reprennent donc pas le constructeur graphique de formulaire présent sur la dernière version doryphore. Cela étant le plus gros des vidéos reste d'actualité.

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)

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)
Avec la version Doryphore, les templates personnalisés seront chargés prioritairement depuis lerépertoire custom/templates/bazar/templates.
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 1^er 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';
}
?>

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 plusieurs bases de données d'un coup 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é.
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"`
period	n'affiche que les résultats dont la fiche est plus récente que la date donnée. Exemple: period="2020-12-31" ; à partir de Doryphore 2021-02-04-2
redirecturl	permet de rediriger sur une page voulue lors de la validation du formulaire redirecturl="une url complète (pas juste une page wiki)"
random	permet de mélanger les fiches pour les afficher dans un ordre aléatoire. Exemple: random="1"
user	n'affiche que les résultats dont l'utilisateur donnée est le propriétaire ; vide par défaut. Exemple: user="Wikiadmin ; à partir de Doryphore 2021-02-04-2
filteruserasowner	n'affiche que les résultats dont l'utilisateur courant est le propriétaire ; faux par défaut. Exemple: filteruserasowner="true" ; à partir de Doryphore 2021-02-04-2
search	permet d'afficher une barre de recherche en haut de l'affichage des résultats. Exemple: search="true" ; faux par défaut
shownumentries	affiche le nombre de résultats trouvés en en-tête. Exemple : shownumentries="true" ; faux par défaut
barregestion	affiche la barre de gestion en bas de chaque fiche. Exemple : barregestion="false" ; true par défaut

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

{{bazarliste id="<urlduwiki>|<idduform>"}}

Il est maintenant possible d'utiliser l'action bazarliste pour afficher les données distantes. Tout est décrit dans cette documentation.

Les templates disponibles sous yeswiki

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

Accordéon

Affiche sous forme de fiches à déplier/plier

- En savoir plus...

annuaire_alphabetique.tpl.html

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

- En savoir plus...

blog.tpl.html

Le template blog permet d'afficher des actualités :

dernier article mis en avant dans un bloc de couleur (optionnel)
affiche la date et l'auteur de l'article sous le titre (optionnel)
le résumé : 280 premiers caracteres du champ soustitre

- En savoir plus...

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)

- En savoir plus...

compteur.tpl.html

ce template permet d'afficher la somme du champ bf_nombre

- En savoir plus...

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.

- En savoir plus...

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.

- En savoir plus...

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".

- En savoir plus...

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.

- En savoir plus...

liste_liens.tpl.html

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

- En savoir plus...

liste_liens_date.tpl.html

affiche une liste de liens pointant vers les fiches

- En savoir plus...

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.

- En savoir plus...

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.

- En savoir plus...

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 !

- En savoir plus...

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)

- En savoir plus...

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

- En savoir plus...

photobox.tpl.html

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

Paramètres personnalisables :

largeur vignette : thumbwidth="100" > indiquer le nb de px sans préciser l'unité
hauteur vignette : thumbheight > idem
redimensionnent vignette : thumbresize
- aux dimensions exactes, quitte à rogner l'image (crop)
- ou garder dimensions originales à l'intérieur des dimensions (fit)
marge entre les images :thumbmargin par defaut 1;
largeur image plein écran bigwidth
hauteur image plein écran bigheight
redimensionnent image plein écran : bigresize
- aux dimensions exactes, quitte à rogner l'image (crop)
- ou garder dimensions originales à l'intérieur des dimensions (fit)

- En savoir plus...

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).

- En savoir plus...

timeline.tpl.html

affiche les fiches sous forme de ligne du temps

- En savoir plus...

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.

- En savoir plus...

20 fiches trouvées

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)

cliquer sur l'option (en bas) "Éditer permissions"
- un tableau à trois colonnes s'affiche (une colonne par type de droit : lecture, écriture, commentaire)
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.

pour en savoir plus sur le groupe admin se reporter à la rubrique gérer des groupes d'utilisateurs

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

map.tpl.html

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut

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
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
barregestion	obsolète "true" or "false" : si présent (defaut), ajout des liens vers la gestion de la fiche
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 documentation

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é par des virgules
titles	Texte de chaque onglet séparé 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

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 ses 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.

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
Exemple de syntaxe à copier/coller :

checkboxfiche***3***Liste des fiches*** *** ***TestfichE,Testfiche2***bf_liste_fiche***tags***1*** ***Choisissez vos fiches*** ***@admins*** *** ***listeNomDeLaListe=id_oui

Position	paramètre
0	Type de champ : checkboxfiche
1	Numéro de formulaire : Pour trouver l'identifiant du formulaire, aller sur la page Base de donnée , cliquez sur Formulaires et récupérez l'ID du formulaire que vous souhaitez utiliser (ex: 3) NB : il faudra évidemment que vous ayez créé un formulaire
2	Intitulé affiché : (exemple : Liste des fiches) 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
3	Non-utilisé
4	Non-utilisé
5	Valeurs par défaut : indiquer les NomWiki des fiches du formulaire qui seront sélectionnées par défaut, séparés par des virgules. Dans l'exemple : 2 fiches sélectionnées dont les NomWiki sont TestfichE et Testfiche2
6	Identifiant du champ : c'est le nom unique qui sera utilisé pour identifier ce champ parmi les autres. (ex.: bf_liste_fiche) Il est nécessaire de le définir si un formulaire utilise plusieurs fois checkboxfiche pour le même ID de formulaire.
7	Choix du mode de complétion : vide = normal (cases à cocher - par défaut) tags = autocomplétion par tags dragndrop = complétion par glisser-déposer (disponible à partir de Doryphore uniquement)
8	Saisie obligatoire : indique si la saisie de ce champ est obligatoire. 0 ou vide = non obligatoire, 1 = obligatoire
9	Présence dans le moteur de recherche : vide = non (par défaut), 1 = oui
10	Texte d'aide à la saisie : ce qui est écrit dans cette zone deviendra une bulle d'aide visible lorsque l'utilisateur cliquera sur un petit point d'interrogation bleu (dans l'exemple : "Choisissez vos fiches")
11	Droits d'accès au contenu du champ. (NON FONCTIONNEL avant Doryphore) 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 à tout le monde (*). Il est possible de combiner plusieurs groupes en les séparant par des espaces.
12	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 à la saisie au groupe des administrateurs uniquement (@admins). Il est possible de combiner plusieurs groupes en les séparant par des espaces.
13	Mots-clés : mots clés séparés par des virgules aussi utilisés pour compléter les critères de tri du champ 15 ci-dessous
14	Appelation sémantique : utilisation avancée
15	Critère de tri : 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" : checkboxIDDeLaListeIdentifiantduchamp=IDValeurDeLaListe ou checkboxficheIDDuformulaireIdentifiantduchamp=NomWikiFiche (l'identifiant du champ correspond au champ en position 6 pour les checkbox et checkboxfiche) si on a utilisé un champ "liste déroulante" : listeIDDeLaListeIdentifiantduchamp=IDValeurDeLaListe ou listeficheIDDuformulaireIdentifiantduchamp=NomWikiFiche si on a utilisé un champ "bouton radio" : radioIDDeLaListeIdentifiantduchamp=IDValeurDeLaListe 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

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

Developpement

Cette page est migrée et découpée en bas de la page de documentation générale.

Ici : https://yeswiki.net/?DocumentatioN

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 :

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

Action {{map}} permet d'afficher des points sur une carte.
Action {{bazarcartocoul}}

Veuillez utiliser l'action {{bazarcarto}}.

Sous forme de trombinoscope

Avec un système de recherche (facette)

Des paramètres supplémentaires pour le filtrage

l'Extension Pdf

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

ExtensionsSupplementairesYesWiki

Extension

Extensions installables
Extensions dépréciées

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.
LMS : Permet d'utiliser YesWiki comme une plateforme d'apprentissage (LMS : Learning Management System).
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

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 :

de créer des base de données avec des champs au format divers (texte, texte long, date, lieu, liste déroulante, liste à cocher, fichier à télécharger, image, url, email....)
d'ajouter des données dans vos bases de données (vous et tous ceux à qui vous le permettez) via des formulaires d'encodage agréables
de montrer le contenu (tout ou une partie seulement) de vos bases de données sous différents rendus et ce simplement !
- vue calendrier
- vue liste, annuaire...
- vue cartographique
- ... (vous avez la main pour créer votre propre vue si vous êtes un peu débrouillard)
de permettre à vos visiteurs de chercher dans vos bases de données via des modules simples

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

"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

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 :
- mauve : #990066 /
- vert : #99cc33 /
- rouge : #cc3333 /
- orange : #ff9900 /
- bleu : #006699
- Voir les codes hexa des couleurs : http://fr.wikipedia.org/wiki/Liste_de_couleurs

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.

{{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 bandeauboatseattle.png (0.2MB) CC-BY-SA NicolasGeiger

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 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"

Glossaire

Ajouter un mot au Glossaire

Glossaire

Action
Base de données
Bootstrap
Cercopithèque
Classes CSS
Embed
Extension

FTP
Handler
Hébergement
iCAL
Iframe
Pad
RSS

Template
URL
Widget
XML

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

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...

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 :

pour les thèmes graphiques (Voir la fiche sur les thèmes graphiques)
pour les formulaires bazar : c'est la case dans laquelle vous devez saisir le code dictant les questions du formulaire

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.

Adapté de https://fr.wikipedia.org/wiki/Widget

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

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

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',

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_17" 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

animation

démo de l'action

animation

Permet de créer des sections de texte sur lequel vous pourrez appliquer des effets
Comportements
La bibliothèque animation permet d'ajouter des animations sur des parties choisies (titres, images ou texte) au sein des class avec différents styles que vous pouvez découvrir sur animate.css.

Ces class peuvent s'appliquer aux éléments suivants :

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 :

Ajoutez : { {section class="wow slideInRight" data="wow-iteration=3"} }, ce qui donnera le comportement du texte "exemple" quand vous êtes arrivé
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"

Action {{textsearch}}

→

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

→

blog.tpl.html

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut

Présentation rapide Le template blog permet d'afficher des actualités :

dernier article mis en avant dans un bloc de couleur (optionnel)
affiche la date et l'auteur de l'article sous le titre (optionnel)
le résumé : 280 premiers caracteres du champ soustitre

Détails des différents paramètres spécifiques à ce template

image Capture_composant_blog.png (31.5kB)

Pour rendre toutes les options visibles, cochez la case "Paramètres avancés" dans le composant "Afficher les données d'un formulaire".
Options :

Afficher l'entête = header="true"
Afficher l'auteur = show_author="1"
Afficher la date = show_date="1"

Pour faire apparaitre le résumé si votre formulaire ne contient pas un champ "soustitre", vous pouvez appeler n'importe quel autre champ texte en utilisant le paramètre correspondance de la manière suivante :

{{bazarliste id="2" template="blog" correspondance="soustitre=bf_chapo"}}

Lien vers un wiki où le template est visible https://adrets-asso.fr/?Blog

Code source du formulaire qui a servi pour cet exemple image*bf_image*Image*400*300*1200*900*right*0* * * * * * * * * *
texte*bf_titre*Titre*80*255* * *text*1* * * * * * * * * *
textelong*soustitre*Résumé*40* * * *wiki*1* * * * * * * * * *
textelong*bf_description*Billet*40* * * *wiki*1* * * * * * * * * *

Mot clés documentation

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

Changer les droits de lectures et d'écriture par défaut

Par défaut, les pages de votre wiki sont visible set éditables par tout visiteur. Pour limiter la lecture et l'écriture aux seuls administrateurs par exemple, il faut changer les lignes

  'default_write_acl' => '*', // droits d'écriture par défaut des pages
  'default_read_acl' => '*', // droits de lecture par défaut des pages

  'default_write_acl' => '@admins', // droits d'écriture par défaut des pages
  'default_read_acl' => '@admins', // droits de lecture par défaut des pages

Changer l'url de votre wiki

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/?"

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

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

Pour tous les détails sur les droits d'accès : https://yeswiki.net/?DocumentationDroitsDAcces

Envoyer un mail aux @admins à chaque nouvel encodage de fiche

'BAZ_ENVOI_MAIL_ADMIN' => true

Laisser ouverte en écriture votre page tout en vous protégeant des spams

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

Changer le thème par défaut de votre wiki


  '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.

Cacher le bouton Thèmes de votre wiki en mode édition


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

Changer l'affichage par défaut des cartes

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

Empêcher la création de pages SAUF via les formulaires

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

utiliser une base sql avec port privé...

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',

Facebook opengraph : choisir l'image utilisée quand on partage un wiki sur FB

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

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

Concerne

Codes utiles /raw...
Hors yeswiki

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>',

'contact_mail_func' => 'smtp',
  'contact_smtp_host' => 'smtp-relay.sendinblue.com',
  'contact_smtp_port' => '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://

Liste des handlers disponibles par défaut

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

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

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/
Attention, la version actuelle de YesWiki possède quelques bugs empêchant le bon fonctionnement sur Windows :

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

Action {{bazarliste}} : afficher les données d'autres YesWiki

L'action {{bazarliste}} permet d'afficher les données des formulaires. Il est possible d'afficher les données d'autres YesWiki en même temps que les données locales.
Cette fiche de documentation correspond à une action en cours de développement uniquement utilisable avec la version doryphore à partir de 2021-05-12.

Il est possible d'afficher les données d'un autre site YesWiki.

1. Mettre à jour le YesWiki et le distant pour avoir la version Doryphore après 2021-05-12-24
2. Définir l'action

{{bazarliste id="1" template="map" ...}}

pour correspondre au besoin (documentation ou utiliser le bouton composants lors de la modification d'une page)
3. Identifier l'adresse des YesWiki distants et les formulaires recherchés. Ex:

https://www.example.com/?PagePrincipale

formulaire 4 et

https://www.example.com/trombi2/?PagePrincipale

formulaire 5
5. remplacer pour l'action bazarliste id par

id="1,https://www.example.com/?PagePrincipale|4,https://www.example.com/trombi2/?PagePrincipale|5,6"

6. Sauver la page et enjoy

Explications:

chaque formulaire est séparé par une virgule
un formulaire local est uniquement représenté par un nombre. Dans l'exemple, nous avons les formulaires 1 et 6
un formulaire distant est représenté par son url suivi de `|` suivi du numéro de son formulaire. Dans l'exemple, nous avons deux formulaires distants.
S'il faut plusieurs formulaires distants d'un même YesWiki, il faut à chaque fois répéter l'url devant `|`

Rafraichir les données locales:

Il y a un système de cache des requêtes externes dont la durée est paramètrable par les variables baz_external_service_time_cache_for_entries et baz_external_service_time_cache_for_forms (voir config.yaml). Pour forcer un rafraîchissement des données, il faut être connecter et ajouter à la fin de l'url :

&refresh=1

Pour aller plus loin, et avoir des couleur différentes par formulaire (entre données du formulaire local et distants):
Sur la base du fonctionnement colorfield="id_typeannonce" (voir ActionBazarliste section color), definir un ID pour le formulaire externe n'existant pas en local (999 par exemple) de la manière suivante

id="5,http://www.exemple.com/?PagePincipale|1->999" color="green=5, blue=999"

NB : Dans l'exemple ci-dessus l'id du formulaire local est 5 et celui du formulaire distant 1

Pour aller plus loin, pour les personnes connaissant les fields:

pour configurer l'affichage des données sur le site local, il faut plutôt créer un formulaire qui ressemble au formulaire distant (même nom de champs) mais avec vos adaptations
noter le numéro de ce formulaire en local (A pour l'exemple)
noter le numéro du formulaire distant (B pour l'exemple)

entrer dans id ceci

id="http://www.exemple.com/?PagePincipale|B->A"

Tout se joue avec l'association de B vers A.

Pour lier à un template custom fiche-x.tpl.html:
x étant le numéro du formulaire local concerné

1. dupliquer le formulaire distant sur le YesWiki local en utilisant la fonctionnalité d'importation disponible en bas de la page BazaR
2. copier le fichier fiche-x.tpl.html dans le dossier local custom/templates/bazar/ avec le nom fiche-y.tpl.html où y est le numéro du formulaire dupliqué en local

3. modifier le formulaire y en local en mode code en remplaçant, z étant le numéro du formulaire distant

liste***...***...*** *** ***...

par

externalselectlistfield***...***...*** https://www.example.com/?BazaR/json&demand=forms&id=y***liste***...

listefiche***...***...*** *** ***...

par

externalselectentryfield***...***...*** https://www.example.com/?BazaR/json&demand=forms&id=y***listefiche***...

listefiches***...***...*** *** ***...

par

externallinkedentryfield***...***...*** https://www.example.com/?BazaR/json&demand=forms&id=y***listefiches***...

listefichesliees***...***...*** *** ***...

par

externallinkedentryfield***...***...*** https://www.example.com/?BazaR/json&demand=forms&id=y***listefichesliees***...

checkbox***...***...*** *** ***...

par

externalcheckboxlistfield***...***...*** https://www.example.com/?BazaR/json&demand=forms&id=y***checkbox***...

checkboxfiche***...***...*** *** ***...

par

externalcheckboxentryfield***...***...*** https://www.example.com/?BazaR/json&demand=forms&id=y***checkboxfiche***...

radio***...***...*** *** ***...

par

externalradiolistfield***...***...*** https://www.example.com/?BazaR/json&demand=forms&id=y***radio***...

tags***...***...*** *** ***...

par

externaltagsfield***...***...*** https://www.example.com/?BazaR/json&demand=forms&id=y***tags***...

fichier***...***...*** *** ***...

par

externalfilefield***...***...*** https://www.example.com/?BazaR/json&demand=forms&id=y***fichier***...

image***...***...*** *** ***...

par

externalimagefield***...***...*** https://www.example.com/?BazaR/json&demand=forms&id=y***image***...

Dans l'exemple:

le formulaire concerné est
```
https://www.example.com|z
```

la formule entrée dans le paramètre id de

{{bazarliste id="}}

est

https://www.example.com|z->y

Si dans votre formulaire local vous voulez un comportement correct pour les liens, inspirez-vous des externalfields, comme par exemple :

pour les urls vers les fiches
```
$fiche['url']
```
pour les urls vers les fiches avec un handler
```
$fiche['url'] . '/pdf'
```
pour savoir si la fiche est externe
```
isset($fiche['external-data'])
```
pour avoir l'url de base du site distant pour les fiches externes
```
$fiche['external-data']['baseUrl']
```

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

Créer son compte et/ou s'identifier

INSERER ICI UN MOT RELATIF A action login

création d'un compte YesWiki

aller sur la page spéciale ParametresUtilisateur
- elle est généralement également accessible via le menu de configuration "roue crantée" : "se connecter"
- Renseigner tous les champs puis cliquer sur Nouveau compte
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
choisir un mot de passe et donner un mail
cliquer sur "Nouveau compte"

S'identifer sur yeswiki

aller sur la page spéciale ParametresUtilisateur,
- elle est généralement également accessible via le menu de configuration "roue crantée" : "se connecter"
- Renseigner les deux premiers champs puis cliquer sur IDENTIFICATION (en cochant la case Se souvenir de moi, vous serez identifiés durant quelques mois)
remplir le formulaire avec son nom YesWiki et son mot de passe
cliquer sur "connexion"

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)

trombinoscope.tpl.html

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut

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 documentation

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

La page Mediathèque vous permettra de trouver des images open sources, des icones...

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

joli texte entouré de rouge

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...

Doryphore

Présence d'une redirection vers "DocumentationInstallation"

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 ?

/!\ Avant toute chose, faites un backup de votre ftp et de votre base de données.
Aussi, la version doryphore nécessite une version de php >= 7.2.

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)
ajouter le thème margot à partir de GererMisesAJour (roue - crantée>Gestion du site> onglet Mises à jour / extensions> thèmes>margot)
é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
- en cas de page blanche suite à la mise à jour, retourner à la page d'accueil de votre site
- relancer la mise à jour en cliquant sur ré-installer
- puis cliquer sur le lien proposé pour finaliser l'installation (Finaliser la mise à jour (lancer les actions de post-installation)
célébrer !

PROCEDURE DE SAUVETAGE

En cas de bug à la mise à jour entre deux versions de Doryphore (page blanche), tester de pousser par ftp la derniere version doryphore téléchargeable sur https://repository.yeswiki.net/doryphore (télécharger le fichier zip commençant par https://repository.yeswiki.net/doryphore/yeswiki-doryphore-2021-)

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

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 ?

Des soucis pour réparer votre wiki spammé (impossible de vous connecter...) => c'est par ici

Utiliser les paramètres de contrôle d'accès via le wakka config ou la page "Fichier de conf"

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)

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 :

s'identifier en tant qu'administrateur du wiki (WikiAdmin par défaut)
éditer les permissions de la page pour mettre le compte WikiAdmin propriétaire de la page
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 :

é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 limiter la création de nouveaux comptes

Pour éviter que des inconnus puissent se créer des comptes, vous pouvez limiter l'action UserSettings aux seuls administrateurs.
Si cela a l'avantage de bloquer réserver la création de nouveaux comptes aux seuls admin,cela limite vraiment l'autonomie de vos utilisateurs.

Pour supprimer les commentaires indésirables

Ajouter l'action {{erasespamedcomments}} dans la page de votre choix. (Elle n'est accessible qu'aux administrateurs)
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 :

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 )
identifiez-vous à l'aide des identifiants de la base de données Mysql plutôt que vos identifiants wiki
la liste des extensions apparaît, cliquer sur "Nettoyage Spam"
Sélectionner l'intervalle de temps à prendre en compte pour les dernière modifications
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!!
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

mettre à jour YesWiki quand une nouvelle version sort, la protection antispam fait partie des priorités de développement
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.

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 flux RSS pour rester informé des nouveautés
https://video.coop.tools/feeds/videos.xml?videoChannelId=175

Afficher des cartes avec un fond perso

Concerne

Bazar (formulaire)
Carte

La réponse Il faut ajouter les paramètres des sources de votre carte dans le répertoire de Leaflet

/yeswiki/tools/bazar/libs/vendor/leaflet/leaflet-providers.js

A partir de la ligne 78 :

L.TileLayer.Provider.providers = {

On trouve la liste des providers et vous pouvez y ajouter le lien vers votre propre tileset.

MaCarte: {
			url: 'http://[URL de vos tiles]/{z}/{x}/{y}.png',
			options: {
				maxZoom: 5,
				minZoom: 2,
				attribution: 'Mon propre fond de carte!'
			}
		},

Ensuite lors de la création d'une carte, vous pouvez choisir votre fond, en écrivant un truc du type :

{{bazarliste id="" template="map.tpl.html" provider="MaCarte" lat="" lon="" zoom="1"  width="" height="" query="" zoommolette="true" }}

Pour créer votre propre tileset, vous pouvez utiliser ImageMagick

Exporter la page au format pdf Voir la fiche

Afficher des fiches bazar sous forme de listes avec titre de la fiche et sous-titre

Concerne

Bazar (formulaire)

La réponse Il "suffit" d'utiliser la syntaxe suivante :

{{bazarliste id="xx" correspondance="soustitre=bf_montant"}}

dans correspondance, vous indiquez quel champ vous souhaitez voir affiché en sous-titre (dans cet exemple bf_montant)

Lien vers la doc https://yeswiki.net/?ActionBazarliste

Exporter la page au format pdf Voir la fiche

Afficher la saisie de plusieurs formulaires Bazar sur une même page

Concerne

Bazar (formulaire)

La réponse Sur la page de votre choix,

Pour afficher la saisie des formulaires 1,2,3,4,... entrez la syntaxe :

{{bazar voirmenu="0" vue="saisir" id="1,2,3,4,..."}}

Pour afficher la saisie de tous les formulaires, entrez la syntaxe :

{{bazar voirmenu="0" vue="saisir"}}

Cela permet de :

présenter de manière épurée et de choisir vos formulaires
d'économiser le nombre de page crées

(le rendu en image)

Lien vers la doc https://yeswiki.net/?BazarAfficherFormulaireSaisie

Exporter la page au format pdf Voir la fiche

Afficher le menu hamburger et autres nouvelles icones avec le thème Margot sur une version précédente de YesWiki (Cercopithèque)

Concerne

Mise à jour, pb de mise à jour

La réponse Ajouter dans la PageFooter de votre yeswiki :

""<link href="https://stackpath.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css" rel="stylesheet" integrity="sha384-wvfXpqpZZVQGK6TAh5PVlGOfQNHSoD2xbE+QkPxCAFlNEevoEH3Sl0sibVcOQVnN" crossorigin="anonymous">""

Exporter la page au format pdf Voir la fiche

Afficher les contours d'une zone sur une carte

Concerne

Carte
Graphisme, mise en page

La réponse Alors, la première étape consiste à récupérer le contour de la zone. Pour cela, il faut contacter votre cousin SIGiste et lui demander un export des contours de la zone au format

Voir la suite sur la page BazarCartoMulticouche

Exporter la page au format pdf Voir la fiche

afficher les fiches sans coordonnées de localisation

Concerne

Bazar (formulaire)
Carte
Codes utiles /raw...

La réponse Le template map ({{bazarliste id="..." template="map"}}) n'affiche pas les fiches qui ne possèdent pas de coordonnées de localisation.

Il y avait avant un template dédié pour les afficher. Il est maintenant possible d'utiliser une query pour les afficher comme l'ancien template "liste.fiches_horscate.tpl.html".

Code pour avoir exactement le même comportement que "liste.fiches_horscate.tpl.html"
```
{{bazarliste id="x" template="liste_liens" query="bf_latitude="}}
```
Code pour afficher la liste des fiches sans coordonnées de localisation mais en liste accordéon
```
{{bazarliste id="x" query="bf_latitude="}}
```

A noter : certaines fiches peuvent appraître sur cette liste alors qu'elles sont bien affichés sur la carte. Ceci est dû au fait que les coordonnées de localisation sont stockées avec la clé "carte_google". Il suffit juste de les ouvrir et les enregistrer pour que les données soient à nouveau enregistrées au bon format.

Lien vers la doc https://yeswiki.net/?DocQuery

Exporter la page au format pdf Voir la fiche

Afficher un formulaire de saisie dans une modal

Concerne

Bazar (formulaire)

La réponse Il n'est pas possible d'utiliser un formulaire dans une fenêtre modale qui n'est pas iframe (bouton valider qui risque de ne pas marcher, champ géolocalisation etc.)
Par exemple le lien d'un bouton modal ne doit pas etre

{{button class="modalbox" link="Trombicreer" text="Créer ma fiche" }}

mais

{{button class="modalbox" link="?Trombicreer/iframe" text="Créer ma fiche" title="Créer ma fiche"}}

Exporter la page au format pdf Voir la fiche Modifier

Afficher une autre info en plus du nom sous les photos du trombi

Concerne

Bazar (formulaire)

Exporter la page au format pdf Voir la fiche

Afficher une icone dans une page

Concerne

Graphisme, mise en page
Images
Codes utiles /raw...

La réponse Pour avoir une jolie icone correspondant à la bibliothèque font Awesome il suffit d'utiliser le code suivant

""<i class="fas fa-ambulance"></i>""

et vous obtiendrez

En allant sur le site de font Awesome vous pourrez choisir icone à votre pied
Il vous suffira de remplacer "ambulance" par le nom de l'icone qui vous intéresse et le tour sera joué

Exporter la page au format pdf Voir la fiche

Ajouter un picto aux éléments de ma liste dans un formulaire

Concerne

Bazar (formulaire)

La réponse

Il existe des bibliothèques d'icones qui permettent d'illustrer les éléments de vos listes.

La bibliothèque fontawesome est intégrée à Yeswiki (version Doryphore)

Sélectionnez votre icon, puis copiez le code HTML proposé.

Éditez votre liste via Bazar et collez ce code HTML à coté de l'intitulé de votre liste

Une autre bibliothèque très pratique en svg qui permet de choisir la couleur du picto : https://tablericons.com/
Son fonctionnement est simplissime : après avoir sélectionné taille et couleur, vous cliquez sur le picto choisi, le code HTML est copié directement, il ne reste plus qu'à le coller dans votre liste.

Lien vers la doc https://yeswiki.net/?Bootstrap232glyphes

Exporter la page au format pdf Voir la fiche

Ajouter un suivi statistique sur mon wiki

Concerne

Hors yeswiki

La réponse

Placer un suivi stat sur mon wiki

Pour se faire, 2 possibilités :

1. Dolomon, pour un suivi "simple" et minimaliste
2. Matomo, plus complet (et complex)

DOLOMON

Le service de Framasoft qui permet d'utiliser Dolomon - Framaclic - ferme le 12 janvier 2021.

Pour trouver une alternative

https://alt.framasoft.org/fr/framaclic/

Pensez à exporter vos données si vous voulez en garder une trace

https://docs.framasoft.org/fr/dolomon/deframasoftiser.html

Démarche à suivre

1) se créer un compte sur https://framaclic.org

2) ajouter un dolo

image Capture_decran_20190701_a_105640.png (88.7kB)

cliquer sur gif transparent
nommer votre dolo

3) récupérer l'url de votre dolo

image Capture_decran_20190701_a_105658.png (19.8kB)

4) placer ce morceau de code dans la page footer du wiki à suivre.

""<img src="urldevotredolo" alt="cequevousvoulezcommetexte">""

MATOMO

Matomo est une alternative à Google analytics, qui vous permet de suivre la fréquentation de votre site

TUTO A VENIR

Lien vers la doc https://yeswiki.net/?TutoDolomon

Exporter la page au format pdf Voir la fiche

Ajouter une ancre à une page

Concerne

Codes utiles /raw...

La réponse Une ancre permet de faire pointer un lien vers un endroit précis dans la page, autre qu'en haut de la page.
Pour ajouter une ancre dans votre page, il suffit de placer le code suivant à l'endroit voulu, généralement sur un titre :

""<div id="monancre"></div>""

puis d'appeler cette ancre depuis le lien suivant :
https://mondomaine.ext/?PageCourante#monancre

Nota 1 : <div> est un conteneur de type bloc et occasionne un saut de ligne.

Nota 2 : pour éviter un saut de ligne intempestif, on pourra remplacer <div> par <span> qui est un conteneur de type in line n'occasionnant pas de saut de ligne :

""<span id="monancre"></span>""

Exporter la page au format pdf Voir la fiche

Améliorer les aperçus générés lors de la publication sur les réseaux sociaux

Concerne

Codes utiles /raw...

La réponse Lorsque l'on publie sur les réseaux sociaux, si l'image ou le titre qui est généré automatiquement ne nous va pas, il y a quelques astuces applicables :

Pour le titre, mettre en tout début de page, ça ne s'affichera ni dans le html ni dans le rendu mais ce sera pris en compte pour générer l'aperçu.
Pour la description, elle est accessible pour les fiches (bf_description) mais pas pour les pages.
Pour les images, lorsque l'on utilise l'action
Action {{attach ...}} : paramètre "file" obligatoire.
entre la première image est également utilisée comme vignette.

Exporter la page au format pdf Voir la fiche

Avoir des iframes qui s'adapte automatiquement en hauteur

Concerne

Graphisme, mise en page

La réponse La class class="auto-resize" est la clé :) ! Voir sur la documentation

Exporter la page au format pdf Voir la fiche

avoir des listes multi-langues ?

Concerne

Bazar (formulaire)

La réponse Avec la version doryphore 4.2.0 (sortie avril 2022), il est possible de configurer des listes multilangues.

Pour ceci, dans la page de gestion des listes de votre wiki (?BazaR&vue=listes):

cliquer sur Saisir une nouvelle liste (?BazaR&vue=listes&action=saisir_liste)
pour chaque elément de la liste :
- mettre une clé comme d'habitude (ex. cle1, cle2)
- pour la valeur, mettre
```
<span lang="fr">Clé 1</span><span lang="en">Key 1</span>
```
  (si Français ou Anglais)
- comme il y 6 langues possibles en YesWiki, il est préférable de toutes les définir pour éviter que le texte ne s'affiche pas
```
<span lang="fr">Clé 1</span><span lang="en">Key 1</span><span lang="pt">Chave 1</span><span lang="ca">Tecla 1</span><span lang="es">Clave 1</span><span lang="nl">Sleutel 1</span>
```
- si vous ne souaitez pas traduire toutes les langues, il vaut mieux les définir mais laisser le texte en Français ou Anglais pour cette langue, afin que le texte reste affiché.

Exporter la page au format pdf Voir la fiche Modifier

Cacher la phrase par défaut "Saisir une fiche"

Concerne

Bazar (formulaire)

La réponse Par défaut quand on appelle un formulaire en mode saisie, une phrase générique apparaît en haut du formulaire et indique
"saisir une fiche : "

image Capture_decran_20190617_a_162845.png (38.7kB)

Ce n'est pas toujours très beau. Il est possible de la cacher en plaçant sur ce petit bout de code dans la page qui accueille le formulaire en mode saisie :

""<style>
h3.titre_type_fiche {display:none;}
</style>""

Exporter la page au format pdf Voir la fiche

Cacher les facettes (tri par case à cocher) en affichage sur smartphone

Concerne

Bazar (formulaire)
Graphisme, mise en page

La réponse L'affichage facette actuel ne se prête pas bien à l'utilisation sur smartphone. Les cases à cocher pour le tri prennent souvent trop de place ;-(. Par défaut elles se placent au-dessus ou au-dessous des fiches.

Dans l'attente d'un affichage smartphone compatible, il est possible de cacher les champs de tri d'une page avec facette lorsqu'elle est affichée sur un petit écran en plaçant sur la page concernée ce bout de code :
Ce code est à adapter si votre colonne de facette est différent de 3.

""<style>
@media screen and (max-width: 720px) {
  .facette-container .col-xs-9 {
     width:100%;
  }
  .facette-container .col-xs-3 {
     display:none;
  }
}
</style>""

Exporter la page au format pdf Voir la fiche

Changer le texte qui apparaît dans le champ de recherche d'un formulaire en mode "recherche"

Concerne

Bazar (formulaire)

La réponse Ajouter ce code sur la page en question et l'adapter :

""<script>
document.addEventListener('DOMContentLoaded', function() {
  $('.search-input').attr('placeholder', 'mon texte personnalisé');
});
</script>""

Exporter la page au format pdf Voir la fiche

Comment afficher les fiches d'un autre Yeswiki ?

Concerne

Bazar (formulaire)
Codes utiles /raw...

La réponse Il est possible d'afficher les fiches d'un autre YesWiki dans son YesWiki.

Une page de documentation dédiée a été créée : ActionBazarlisteDonneesExternes

Lien vers la doc https://yeswiki.net/?ActionBazarlisteDonneesExternes

Exporter la page au format pdf Voir la fiche

Comment afficher les fiches d'un formulaire agenda sur son téléphone ou dans son agenda personnel ?

Concerne

Bazar (formulaire)

La réponse Depuis les dernières mises à jour, il est possible d'afficher les fiches d'un formulaire agenda sur son téléphone, sur ordinateur ou dans son agenda personnel.

1. se rendre sur la page BazaR
2. choisir le formulaire concerné (il doit avoir la notion ICAL à droite de son nom)
3. Faire un clic droit sur ICAL puis copier le lien
4. Utiliser ce lien pour l'ajouter dans son agenda de téléphone ou d'ordinateur

Important:
Il se peut que votre serveur ne soit pas sur le bon fuseau horaire ce qui pourrait créer des décalages lors de la synchronisation. Rendez-vous sur la page GererConfig pour définir le bon fuseau horaire. Toutes les nouvelles fiches bazar, ou les fiches modifiées seront alors sur le bon fuseau horaire. Les fiches précédemment enregistrées apparaitront avec un décalage hoaraire qui disparait dès qu'elle est modifiée.

A noter
Pour être sûr que l'agenda s'affiche bien, le formulaire "agenda" doit générer des fiches accessible en lecture (*).

Exporter la page au format pdf Voir la fiche

Comment faire pour convertir un template Bazar .tpl.html en .twig ?

Concerne

Bazar (formulaire)

La réponse Il existe un tutoriel dans la documentation : ConvertirEnTwig

Convertir un template Bazar

.tpl.html

.twig

.twig

: qu'est-ce ?

```
.twig
```
est un langage pour décrire des modèles (templates) pour la génération de sortie HTML à partir d'un script PHP.
Il y a une documentation officielle bien garnie

Comment faire ?

1. Choisir un template à convertir. (Exemple :
```
liste_liens.tpl.html
```
)

Le code source de la version de travail de ce fichier est recopiée à la fin de cette page.

2. Vérifier la présence de ce fichier dans le dossier
```
tools/bazar/presentation/templates/
```
3. Copier le fichier dans le dossier
```
custom/bazar/templates/
```
4. Identifier les fonctions php non standards ; ici
```
getCustomValueForEntry()
```

5. Recopier le contenu de

custom/bazar/templates/liste_liens.tpl.html

dans

custom/bazar/templates/liste_liens.twig

en retirant ce qui concerne les fonctions non-standard.

<?php
if(count($fiches)>0) : ?>
    <?php echo $info_res;?>
    <ul class="BAZ_liste <?php echo $param['class'];?>">
    <?php
    foreach($fiches as $fiche): ?>
        <li class="bazar-entry" <?php echo $fiche['html_data'];?>>
          <a href="<?php echo $fiche['url']; ?>"
           target="_blank">
            <?php
            if (!empty($color)) {
              echo '<span class="pellet" style="background-color:'.$color.';"></span> ';
            }
            if (!empty($icon)) {
              echo '<i class="'.$icon.'"></i> ';
            }

            echo '<span class="entry-title">'.$fiche['bf_titre'].'</span>';
            ?>
          </a>
        </li>
        <?php
    endforeach; ?>
    </ul>
    <?php echo $pager_links;?>
<?php endif; ?>

6. traduire le code
```
php
```
en
```
.twig
```
(voir le tableau de conversion utilisé en fin de cette fiche) pour obtenir ceci

{% if fiches|length > 0 %}
  {{ info_res }}
  <ul class="BAZ_liste {{ param.class }}">
    {% for in,fiche in fiches %}
      <li class="bazar-entry" {{ fiche.html_data }}>
        <a href="{{ fiche.url }}" target="_blank">
         {% if colors[id] %}
           <span class="pellet" style="background-color:{{ colors[id] }}"></span>
         {% endif %}
         {% if icons[id] %}
           <i class="{{ icons[id] }}"></i>
         {% endif %}
         <span class="entry-title">{{ fiche.bf_titre }}</span>
       </a>
      </li>
    {% endfor %}
  </ul>
  {{ pager_links }}
{% endif %}

7. tester ce fichier avec le code suivant dans une page de test
```
{{bazarliste id="1" template="liste_liens.twig"}}
```
Tout ne fonctionnera pas car il n'y a plus les couleurs et les icônes.

8. pour rétablir les icônes et les couleurs, il faut conserver le fichier
```
liste_liens.tpl.html
```
mais complétement le réécrire avec ceci

<?php
$colors = [];
$icons = [];
foreach ($fiches as $id => $fiche){
    $colors[$id] = getCustomValueForEntry(
      $param['color'],
      $param['colorfield'],
      $fiche,
      ''
    );
    
    $icons[$id] = getCustomValueForEntry(
      $param['icon'],
      $param['iconfield'],
      $fiche,
      ''
    );
}
echo $this->render('@bazar\liste_liens.twig',[
        'fiches' => $fiches,
        'param' => $param,
        'colors' => $colors,
        'icons' => $icons,
        'info_res' => $info_res,
        'pager_links' => $pager_links,
    ]);

La première partie permet de stocker les informations de couleur et d'icône dans les variables
```
colors
```
et
```
icons
```
.
Ensuite, on génère le rendu du fichier
```
.twig
```
grâce à
```
echo $this->render()
```
.
Il faut alors passer en paramètre un tableau qui a la liste exhaustive des variables utilisées par le
```
.twig
```

Le test se fait avec ceci

{{bazarliste id="1" template="liste_liens"}}

{{bazarliste id="1" template="liste_liens.tpl.html"}}

9. Il est alors possible de publier le code dans le coeur de YesWiki en mettant les fichiers dans les dossiers suivant:
- ```
tools/bazar/presentation/templates/liste_liens.tpl.html
```
- ```
tools/bazar/templates/liste_liens.twig
```

Conversion de php vers .twig

PHP

.twig

<?php if(count($fiches)>0) : ?>

{% if fiches|length > 0 %}

<?php endif; ?>

{% endif %}

<?php echo $info_res;?>

{{ info_res }}

<?php echo $param['class'];?>

{{ param.class }}

<?php foreach($fiches as $fiche): ?>

{% for fiche in fiches %}

<?php foreach($fiches as $id => $fiche): ?>

{% for id,fiche in fiches %}

<?php endforeach; ?>

{% endfor %}

<?php echo $fiche['html_data'];?>

{{ fiche.html_data }}

<?php echo $fiche['url']; ?>

{{ fiche.url }}

if (!empty($color)) {

{% if colors[id] %}

avec introdution de la variable

colors

echo '<span class="pellet" style=

"background-color:'.$color.';"></span> ';

<span class="pellet" style="background-color:{{ colors[id] }}"></span>

if (!empty($icon)) {

{% if icons[id] %}

avec introdution de la variable

icons

echo '<i class="'.$icon.'"></i> ';

<i class="{{ icons[id] }}"></i>

echo '<span class="entry-title">'

.$fiche['bf_titre'].'</span>';

<span class="entry-title">{{ fiche.bf_titre }}</span>

<?php echo $pager_links;?>

{{ pager_links }}

Code source de liste_liens.tpl.html

<?php
if(count($fiches)>0) : ?>
    <?php echo $info_res;?>
    <ul class="BAZ_liste <?php echo $param['class'];?>">
    <?php
    foreach($fiches as $fiche): ?>
        <li class="bazar-entry" <?php echo $fiche['html_data'];?>>
          <a href="<?php echo $fiche['url']; ?>"
           target="_blank">
            <?php
            $style = '';
            $color = getCustomValueForEntry(
              $param['color'],
              $param['colorfield'],
              $fiche,
              ''
            );
            if (!empty($color)) {
              echo '<span class="pellet" style="background-color:'.$color.';"></span> ';
            }
            $icon = getCustomValueForEntry(
              $param['icon'],
              $param['iconfield'],
              $fiche,
              ''
            );
            if (!empty($icon)) {
              echo '<i class="'.$icon.'"></i> ';
            }

            echo '<span class="entry-title">'.$fiche['bf_titre'].'</span>';
            ?>
          </a>
        </li>
        <?php
    endforeach; ?>
    </ul>
    <?php echo $pager_links;?>
<?php endif; ?>

Lien vers la doc https://yeswiki.net/?ConvertirEnTwig

Exporter la page au format pdf Voir la fiche

Comment faire pour installer chez O2switch

Concerne

Hors yeswiki

La réponse je ne sais pas encore

Exporter la page au format pdf Voir la fiche Modifier

comment faire pour que les pdf s'ouvrent directement dans le browser (et pas se téléchargent)

Concerne

Hors yeswiki

La réponse Certains pdf s'ouvrent directement dans le browser, certains se téléchargent directement...
Pour forcer l'ouverture dans le browser, la fonction {{attach}} pose parfois problème.

Pour contourner ce "problème"

créer un formulaire bazar avec un champ fichier (vous permettant de déposer le pdf)
récupérer sur cette fiche le lien vers le pdf (clic droit, enregistrer le l'adresse du lien)
utiliser cette adresse dans votre wiki

Autre piste

voir la doc réalisée par Laurent Bouquet : http://www.le-projet.cc/bio/?PagePdf

Lien vers la doc http://www.le-projet.cc/bio/?PagePdf

Exporter la page au format pdf Voir la fiche

Comment faire pour travailler avec git en local ?

La réponse Ceci est réservé aux utilisations avancées.

Il est possible de travailler en local avec git afin de faire tourner son site internet sur une branche de travail qui n'est pas encore déployée dans les mises à jour.

Tutoriel "Astuce : travailler avec git en local"

Lien vers la doc https://yeswiki.net/?AstuceGitEnLocal

Exporter la page au format pdf Voir la fiche

Comment résoudre un problème d'affichage de l'intitulé d'un champ Bazar ?

Concerne

Bazar (formulaire)

La réponse A l'affichage des questions se supperposent sans qu'on prenne pourquoi. Voici comment chercher une solution :

vérifier que le wiki et son thème son à jour : c'est peut-être un problème déjà résolu (Doc sur la mise à jour)
vider le cache du navigateur parce que c'est peut-être le comportement de la version précédente qui s'affiche encore
retourner modifier le formulaire et regarder le code Wiki. Dans le cas de cette image le problème était à ce niveau là : les intitulés de questions n'avaient pas été tapés mais copiés-collés et les balises html se sont embarquées sans que ça se voit. Dans le code on peut "nettoyer" tout ça et ça marche !

CommentResoudreUnProblemeDAffichageDUnF_capture-decran-du-2022-01-21-21-12-28.png

Exporter la page au format pdf Voir la fiche Modifier

Créer un lien "Retour à la page précédente"

Concerne

Codes utiles /raw...

La réponse Il est parfois utile de pouvoir insérer un lien "Retour à la page précédente" quelle que soit cette page. Pour cela, il faut utiliser ce bout de code :

""<a href="#" onclick="javascript:history.back();">Précédent</a> ""

On peut aussi ajouter la propriété title="Retourner à la page précédente" qui permet d'afficher un texte complémentaire au survol du lien.

Exporter la page au format pdf Voir la fiche

Créer un liste pour formulaire bazar via un tableur

Concerne

Bazar (formulaire)

La réponse Quand on doit créer une nouvelle liste avec beaucoup d'éléments que l'on peut récupérer sur le web ()en csv par exemple), il est possible de remplir cette liste rapidement (càd pas à la main une par une) via une manipulation dans un tableau (en concaténant les infos).
Un fichier tableur exemple est fourni dans cette fiche.

comment procéder ?

créer votre liste avec juste une clé/valeur
récupérer le nomwiki de votre liste et ouvrez la page
le contenu de cette page s'apparente à :

{"titre_liste":"Titre de votre liste","label":{XXXXXXXXXXXXXXXXX}}

ouvrez le tableur exemple et compléter la colonne clé et la colonne valeur
récupérez (copiez) ensuite la dernière ligne de la dernière colonne du tableur (en gros la liste concaténée)
et copiez-la dans la pagewiki de votre liste à la place des XXXX (enlevez la dernière virgule)
sauvez votre page
retournez voir dans la page bazar de votre wiki si la liste a bien été complétée.

Exporter la page au format pdf Voir la fiche

Créer une page qui reste parfaitement vierge

Concerne

Graphisme, mise en page

La réponse Dans toute page, pour pouvoir l'enregistrer, on doit y mettre au moins un caractère qui ne soit pas un espace.
Une solution pour avoir une page vierge consiste à y mettre un espace insécable :
& n b s p ;
C'est utile pour certaines pages qui sont intégrées dans le site et apparaissent donc à l'écran mais sur lesquelles on ne veut voir aucun texte, par exemple une page de colonne ou de titre.

Lien vers la doc https://yeswiki.net/?ReglesDeFormatage

Exporter la page au format pdf Voir la fiche

Dans un accordéon, comment faire pour cacher le titre d'une fiche bazar qui fait un peu doublon

Concerne

Bazar (formulaire)
Graphisme, mise en page

La réponse il suffit dans la page concernée et rajouter

""<style>
h1.BAZ_fiche_titre {
    display:none
}
</style>""

DaansUnAccordeonCommentFairePourCacherL_capture-decran-de-2019-07-05-22-59-37.png

Exporter la page au format pdf Voir la fiche

Déterminer les latitude, longitude et niveau de zoom pour votre carte

Concerne

Bazar (formulaire)
Carte

La réponse Allez sur OpenStreetMap, choisissez la zone qui vous convient, ainsi que le niveau de zoom souhaité.
Regardez maintenant l'adresse dans la barre d'adresse de votre navigateur. Elle est sous la forme :

https://www.openstreetmap.org/#map=15/43.8593/3.9014&layers=CN

Le premier chiffre (ici 15) indique le niveau de zoom (1=Monde, 5=Pays, 10=Région, 5=Communal)
Le second (ici 43.8593) indique la latitude du centre de votre carte
Le troisième (ici 3.9014) indique la longitude du centre de votre carte

Et hop !

Exporter la page au format pdf Voir la fiche

Écrire sans tenir compte des ChatsMots

Concerne

Codes utiles /raw...

La réponse Pour éviter qu'un mot comprenant plusieurs majuscules ne soit traduit par Yeswiki en lien vers une nouvelle page, il suffit de taper le mot entre guillemets de cette manière ""ChatMot""

Exporter la page au format pdf Voir la fiche

Effacer toutes les fiches d'un formulaire

Concerne

Bazar (formulaire)
Phpmyadmin

La réponse CECI n'est plus nécessaire avec Doryphore car il existe maintenant une icône dans bazar pour vider chaque formulaire en cas de besoin.

Pour effacer les fiches d'un formulaire, il faut disposer d'un accès phpMyAdmin pour y exécuter des les requêtes suivantes :
Attention :

remplacer dans les requêtes le <préfixe> des tables et le numéro <id> du formulaire !
cette action est irréversible !

delete from <prefixe>_acls where page_tag IN (select tag from <prefixe>_pages where tag in (select resource from <prefixe>_triples where property="http://outils-reseaux.org/_vocabulary/type" and value="fiche_bazar") AND body LIKE '%"id_typeannonce":"<id>"%' );

delete from <prefixe>_pages where tag IN (select resource from <prefixe>_triples where property="http://outils-reseaux.org/_vocabulary/type" and value="fiche_bazar") AND body LIKE '%"id_typeannonce":"<id>"%';

delete from <prefixe>_triples where resource not IN (select tag from <prefixe>_pages WHERE 1) AND property="http://outils-reseaux.org/_vocabulary/type" and value="fiche_bazar";

Exporter la page au format pdf Voir la fiche

Faire disparaître le champ de recherche et la roue crantée au-dessous d'une certaine largeur d'écran

Concerne

Graphisme, mise en page

La réponse Pour cela, il suffit d'ajouter dans vos CSS ou à défaut dans la page footer du wiki :

""</style>
@media (max-width: 600px) {
.yeswiki-topnav-fast-access {
    display: none;
}
</style>""

600px correspond à une largeur au choix, au-dessous de laquelle doivent disparaître les éléments.

Exporter la page au format pdf Voir la fiche

Faire fonctionner l'« upload » de fichier sur certains sites d'OVH

Concerne

Graphisme, mise en page
Images

La réponse Parfois sur des sites d'OVH, lorsqu'on veut faire un « upload » d'un fichier (insertion d'image notamment), le téléchargement termine immédiatement en échec et avec l'image ci-dessous.

Pour résoudre ce soucis, la seule solution qui a été pour l'instant trouvé est de désactiver le firewall d'OVH. Pour modifier ce paramétrage, il est nécessaire d'avoir un accès FTP de l'hébergement. Il faut ainsi aller modifier le fichier .ovhconfig stocké à la racine de votre site (répertoire « / »). Si le firewall est activé, vous trouverez la ligne suivante :

http.firewall=security

Remplacez-la par celle-ci :

http.firewall=none

(si la première ligne n'est pas trouvée, vous pouvez tout de même essayer de résoudre ce problème en insérant la deuxième ligne en bas du fichier)

Lien vers la doc https://docs.ovh.com/fr/hosting/configurer-fichier-ovhconfig/#etape-3-modifier-le-fichier-ovhconfig

FaireFonctionnerLUploadDeFichierSurC_2022-04-08-10-56-capture-d-ecran.png

Exporter la page au format pdf Voir la fiche Modifier

Faire passer le texte à la ligne directement après une image

Concerne

Graphisme, mise en page
Images

La réponse Quand on insère une image dans un texte, le texte vient habiller l'image.
C'est souvent bien mais parfois on aimerait que le texte passe à la ligne juste après l'image.
Pour renvoyer le texte sous l'image insérée, placer ce bout de code juste après l'image :

""<div class="clearfix"> </div>""

Ce problème est résolu avec la dernière version de Doryphore (qui pose la question lors de l'insertion d'une photo dans la page wiki)

Exporter la page au format pdf Voir la fiche

générer un pdf "sur mesure" de la page wiki

Concerne

Graphisme, mise en page

La réponse Parfois on veut créer un pdf de la page wiki. Il existe bien le /pdf mais celui-ci a quelques limites. En attendant qu'elles soient résolues, il est possible de s'aider d'un petit plugin permettant de placer en bas de la page des boutons d'impression et de création d'un pdf (avec une certaine finesse de rendu fort appréciable)

Le code a insérer est celui-ci

""<script>var pfHeaderImgUrl = '';var pfHeaderTagline = '';var pfdisableClickToDel = 0;var pfHideImages = 0;var pfImageDisplayStyle = 'block';var pfDisablePDF = 0;var pfDisableEmail = 0;var pfDisablePrint = 0;var pfCustomCSS = '';var pfEncodeImages = 0;var pfShowHiddenContent = 0;var pfBtVersion='2';(function(){var js,pf;pf=document.createElement('script');pf.type='text/javascript';pf.src='//cdn.printfriendly.com/printfriendly.js';document.getElementsByTagName('head')[0].appendChild(pf)})();</script><a href="https://www.printfriendly.com" style="color:#6D9F00;text-decoration:none;" class="printfriendly" onclick="window.print();return false;" title="Printer Friendly and PDF"><img style="border:none;-webkit-box-shadow:none;box-shadow:none;" src="//cdn.printfriendly.com/buttons/printfriendly-pdf-button-nobg-md.png" alt="Print Friendly and PDF"/></a>""

Lien vers la doc https://www.printfriendly.com/

Exporter la page au format pdf Voir la fiche

Gérer la photo dans le partage sur les réseaux sociaux

Concerne

Graphisme, mise en page
Images
Hors yeswiki

La réponse Quand on partage une page sur les réseaux sociaux, YesWiki utilise pour le post "réseau social" l'image de votre page ou votre fiche s'il en existe une, sinon le post présente parfois un look étrange.

Pour éviter ce problème, vous pouvez activer le paramètre opengraph qui permet d'imposer une image par défaut. Ce paramètre est à placer dans le fichier waka-config.

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

Nota : idéalement, l'image doit faire 1200x630

Certains réseaux sociaux mettent en cache une image lors de la publication de votre premier post. Ainsi tous les autres posts auront la même vignette associée.
Pour Linkedin, par exemple, il faut suivre cette procédure pour changer l'image (Merci Florent ;-)

Exporter la page au format pdf Voir la fiche

Insérer des icônes dans les listes bazar

Concerne

Bazar (formulaire)
Graphisme, mise en page

La réponse Dans une liste bazar, l'ajout d'une image est souvent sympa
et rend l'aspect du filtre plus agréable lorsqu'on utilise groups (facette).

Plusieurs pistes :

utiliser les emojis : facile !
- ```
🛑 terminée
```
intégrer une image quelconque
- il faut qu'elle existe sur le web
- mettre ce code dans le champ de la liste
- ```
<img src="https://cliketik.fr/themes/img/produits/prod-bie.png" height="25"> Bière
```

InsererDesIconesDansLesListesBazar_capture-décran-2020-10-29-à-21.56.46.png

Exporter la page au format pdf Voir la fiche

Installer un mot de passe général au wiki

Concerne

Hors yeswiki

La réponse Pour installer un mot de passe général à son wiki, il suffit de créer un fichier .htaccess et un fichier .htpasswd que vous placerez à la racine de votre wiki en utilisant votre logiciel ftp.
Pour créer ces fichier, le site http://aspirine.org/htpasswd.html vous facilitera la tâche.

Nota : veillez à activer l'option "Voir les fichiers cachés" de votre logiciel FTP.

Lien vers la doc http://aspirine.org/htpasswd.html

Exporter la page au format pdf Voir la fiche

Intégrer un forum dans YesWiki

Concerne

Codes utiles /raw...

La réponse Très facile avec un iframe, il suffit de mettre ce code dans la page :

""<iframe width="100%" height="4000" frameborder="0" src="URL_du_forum"></iframe>""

Cependant, quand on suit un lien vers un forum ou un post,

""<a href="URL_du_post">texte de l'ancre</a>""

il n'apparait pas dans la page de l'iframe mais pointe vers la page d'origine du forum.

Pour y remédier, il suffit :

d'ajouter un identifiant "name" au forum :

""<iframe name="nom_quelconque" width="100%" height="4000" frameborder="0" src="URL_du_forum"></iframe>""

et d'ouvrir le lien dans l'iframe existant (target) en indiquant l'identifiant du forum :

""<a href="URL_du_post" target="nom_quelconque">texte de l'ancre</a>""

Lien vers la doc https://yeswiki.net/?DocumentationIntegrerDuHtml

Exporter la page au format pdf Voir la fiche

mettre des droits sur toutes les fiches d'un formulaire

Concerne

Bazar (formulaire)

La réponse Il est nécessaire de passer par la db et donc via phpmyadmin de votre serveur
Ensuite, bien identifier l'id du formulaire visé ET le préfixe des tables du wiki
ENSUITE : faire un backup de ces tables !!!!

PUIS enfin

UPDATE forum_acls set list="@admins" where privilege="write" and page_tag in (SELECT tag FROM forum_pages WHERE latest="Y" AND body LIKE '%id_typeannonce":"10"%');

=> remplacer forum par le bon préfixe et l'id du formulaire par le vôtre (ici 10)
=> on peut remplacer write par read

Lien vers la doc http://

Exporter la page au format pdf Voir la fiche

mettre un couleur de fond sur l'entièreté de la page footer

Concerne

Graphisme, mise en page

La réponse Souvent quand on place une couleur de fond dans le footer, elle ne couvre pas la totalité de la page (elle se place dans un container ce qui laisse un bord de chaque côté)

pour contourner, ajouter dans la page footer concernée :

full-widht dans la class du background ou de la section

ce code

""<style> #yw-footer {padding:0;}</style>""

Lien vers la doc http://

Exporter la page au format pdf Voir la fiche

Mettre un titre dans une autre couleur que celle par défaut

Concerne

Graphisme, mise en page

La réponse Vous pouvez utiliser le code suivant :

<span style="color:#446611;">texte coloré</span>

Mais il est à placer correctement, à savoir entre les ===== et pas autour des =====

======""<span style="color:#960018;">""Le réseau des Éco-jardins""</span>"" ======

Exporter la page au format pdf Voir la fiche

Modifier la page d'inscription au Wiki par un formulaire plus complet?

Concerne

Bazar (formulaire)

La réponse
remplacer dans PageRapideHaut

{{login template="modal.tpl.html" nobtn="1"}} par {{login template="modal.tpl.html" nobtn="1" signupurl="CreerCompteViaForm"}}

Créer la page PageLogin en y mettant

{{login signupurl="CreerCompteViaForm"}}

Créer la page CreerCompteViaForm en y mettant

{{bazar id="1" vue="saisir" voirmenu="0"}} (identifiant du formulaire à choisir)

configurer le formulaire associé avec un champ "créer un utilisateur" accompagné d'un champ e-mail.
>> doc mis à jour

Lien vers la doc https://yeswiki.net/?DocLogiN et https://yeswiki.net/?DocumentationLogin

Exporter la page au format pdf Voir la fiche Modifier

Modifier la typo de mon wiki en utilisant des google fontd

Concerne

Graphisme, mise en page

La réponse ajouter dans votre footer ou votre page css

choisissez votre font dans https://fonts.google.com/
sélectionnez votre font préférée
cliquez sur "select this style"
cliquez en haut à droite sur l'icone "view your selected family"
récupérer le code qui ressemble à ce qui se trouve ci dessous et positionnez le dans la page CSS ou dans le footer

""
<link rel="preconnect" href="https://fonts.gstatic.com">
<link href="https://fonts.googleapis.com/css2?family=Xanh+Mono&display=swap" rel="stylesheet">
""

Exporter la page au format pdf Voir la fiche

Modifier le mail envoyé lors de la création d'un compte utilisateur

La réponse Deux endroits possibles pour personnaliser le mail envoyé lors de la création d'un compte :

Il est possible de copier les templates tools/contact/templates/notify-newuser-email-subject.twig et tools/contact/templates/notify-newuser-email-text.twig dans le dossier custom/templates/contact et de les modifier à votre guise.

ou recopier les traductions de CONTACT_NEW_USER_SUBJECT et CONTACT_NEW_USER_MESSAGE que tu trouveras dans tools\contact\lang\contact_fr.inc.php et les recopier dans custom/lang/custom_fr.inc.php
Exemple de fichier custom/lang/custom_fr.inc.php

<?php

return [
   'CONTACT_NEW_USER_SUBJECT' => 'Bienvenue sur le site',
   'CONTACT_NEW_USER_MESSAGE' => "Bonjour!\n\n".
        "Votre inscription sur le site a ete finalisee, dorenavant vous pouvez vous identifier avec les informations suivantes :\n\n".
        "Url : {{ baseUrl }}\n\n".
        "Votre identifiant NomWiki : {{ wikiName }}\n\n".
        "Votre email : {{ email }}\n\n".
        "Votre mot de passe : (le mot de passe que vous avez choisi)\n\n".
        "Pour reinitialiser votre mot de passe : {{ urlForPasswordRenewal }}\n\n".
        "A tres bientot ! ",
];

Attention : aucun caractères spéciaux ne sera toléré dans ce fichier !! Il faudra donc écrire sans accent.

Exporter la page au format pdf Voir la fiche Modifier

Modifier le style de police de la barre de menu

Concerne

Graphisme, mise en page

La réponse L'idéal est de modifier la police en utilisant le fichier CSS du wiki. Mais si vous n'avez pas accès à ce fichier css, vous pouvez toujours ajouter et adapter ce bout de code dans la page footer de votre wiki :

""<style>
.navbar {
  font-family: 'Dosis regular', cursive;
}
</style>""

Vous pouvez aussi jouer sur la taille de la police

font-size: 1.2em;

la couleur

color: navy;

color : rgb(255,0,0);

Exporter la page au format pdf Voir la fiche

obtenir des infos supplémentaires sur une page

Concerne

Codes utiles /raw...

La réponse

/raw : montre le code wiki => quand il est utilisé sur une fiche bazar, il permet de vérifier les champs réellement remplis et singulièrement de vérifier leur nom précis (important pour les templates par ex) + les valeurs (par ex dans les listes ou checkbox)
&debug à la fin de l'url permet de montrer les messages d'erreur
&refresh=1 permet de rafraichir profondément le contenu de la page (y compris la cache)

Lien vers la doc http://

Exporter la page au format pdf Voir la fiche

Ouvrir le lien associé à une image dans un nouvel onglet

Concerne

Images

La réponse Un lien s'ouvre par défaut dans le même onglet. Pour forcer l'ouverture dans un nouvel onglet, il faut passer par du html en précisant le paramètre target="_blank" :

""<a href="https://www.lamangeoireduquartier.org" target="_blank"><img src="lien url de l'image" title="Mangeoire" alt="la mangeoire"></a>""

Lien vers la doc https://yeswiki.net/?DocumentationCreerUnLien

Exporter la page au format pdf Voir la fiche

Paramétrer Umap pour y insérer des fiches Yeswiki

Concerne

Bazar (formulaire)
Carte

La réponse La solution a été documentée sur cette page : BazarAfficherSurCarteUMAP

Lien vers la doc https://yeswiki.net/?BazarAfficherSurCarteUMAP

Exporter la page au format pdf Voir la fiche

Personnaliser les réactions possibles en bas d'une activité ou d'un module dans le LMS

Concerne

Extension LMS

La réponse remplacer

reactions***reactions*** *** *** *** *** *** *** *** ***

par

reactions***reactions***love,hate***J'aime,Je hais***love.jpg,hate.jpg*** *** *** *** *** ***

pour choisir en j'aime/je hais
love,hate : champs id
J'aime,Je hais : titre a l'écran
love.jpg,hate.jpg : images qui doivent etre présentes dans le dossier files du wiki

Exporter la page au format pdf Voir la fiche

pour remplacer la favicon par une icone svg

Concerne

Graphisme, mise en page
Images

La réponse 1) adapter et placer ce bout de code dans le footer (attention ne fonctionne bien que sur firefox)

""<link rel="icon" href="data:image/svg+xml,<svg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 100 100%22><text y=%22.9em%22 font-size=%2290%22>✌️</text></svg>">""

2) pour que cela marche de partout, il faut éditer le squelette du theme et remplacer la partie

<link rel="icon" ..

par la même chose

Lien vers la doc https://css-tricks.com/emojis-as-favicons/

Exporter la page au format pdf Voir la fiche

Pourquoi ai-je une partie de mes fiches qui s'affiche en italique dans une liste bazar ?

Concerne

Bazar (formulaire)
Graphisme, mise en page

La réponse Il peut arriver que dans le titre ou dans le texte de la fiche d'ouvrir une zone en italique avec le symbole mais sans le refermer ! Il suffit de mettre à nouveau en fin de la zone de texte ou bien de supprimer le symbole pour résoudre le souci normalement !

Exporter la page au format pdf Voir la fiche Modifier

recevoir un mail à chaque ajout de fiche

Concerne

Codes utiles /raw...
Hors yeswiki

La réponse Vous souhaitez recevoir un mail à chaque ajout dans un formulaire bazar ?

soit vous faites parties des @admins alors
- vous pouvez activer le param dans le wakka config
```
'BAZ_ENVOI_MAIL_ADMIN' => true
```
- ce qui envoie le contenu de la fiche A CHAQUE admin du wiki, ce qui n'est pas toujours super !
soit vous souhaitez être le seul à recevoir les fiches
- il faut "tricher" un peu en détournant les possibilités du champ mail
- placer dans votre formulaire les champs suivants
- ```
labelhtml***<div style="display:none"> *** *** *** 
champs_mail***bf_mail1***Email***40***255***votremail*** *** *** ***1*** ***@admins 
labelhtml***</div> *** *** ***
```

ceci aura pour effet de cacher le champ mail, d'y insérer votre mail par défaut ET d'envoyer une copie de la fiche à chaque validation !

ATTENTION, ceci ne fonctionne que si votre wiki peut envoyer des mails (voir https://yeswiki.net/?ReparerLesWikisQuiNEnvoientPasLesMails )

Lien vers la doc http://

Exporter la page au format pdf Voir la fiche

récupérer le fichier (.tpl.html) d'un template repéré sur un wiki

Concerne

Codes utiles /raw...

La réponse Il suffit de récupérer le nom du template sur la page (en utilisant /raw)
une fois le nom connu, on tape dans l'url

https://urlduwiki/themes/tools/bazar/templates/nomdutemplate.tpl.html

en remplaçant urlduwiki par l'url du wiki ;-) et nomdutemplate par le nom reperé via le /raw
puis récupérer le code source de la page

Lien vers la doc http://

Exporter la page au format pdf Voir la fiche

Rediriger l'utilisateur vers une page spécifique à la validation d'un formulaire

Concerne

Bazar (formulaire)

La réponse Pour rediriger l'utilisateur vers une page spécifique quand il a validé un formulaire, il faut ajouter le paramètre redirecturl="URLcomplete" dans

{{bazar voirmenu="0" vue="saisir" id=" " redirecturl="https://yeswiki.net/?BazarAfficherFormulaireSaisie"}}

Attention : ne pas utiliser l'adresse courte wiki dans redirecturl mais bien une URL complète (http://...).

Lien vers la doc https://yeswiki.net/?BazarAfficherFormulaireSaisie

Exporter la page au format pdf Voir la fiche

Remplir un champ tag avec des données prédéfinies

Concerne

Bazar (formulaire)

La réponse Les tags sont un moyen pratique pour avoir un critère de tri mais il peut être nécessaire de restreindre les termes (vélo ou bicyclette, vélo, velo ou Vélo ?).

Pour cela, on peut construire une base de mots-clés dans une liste et ensuite l'appeler dans son formulaire pour sélectionner les mots-clés :

checkboxfiche***id-form***le titre*** *** *** *** ***tags***1***0***

Exporter la page au format pdf Voir la fiche

Rendre une image non cliquable

Concerne

Graphisme, mise en page
Images

La réponse Pour rendre une image non cliquable, ajouter la propriété nofullimagelink dans l'action "attach" qui insère l'image :

{{attach file="image.jpg" desc="tralala" size="small" nofullimagelink="1"}}

Lien vers la doc https://yeswiki.net/?AttacH

Exporter la page au format pdf Voir la fiche

rendre une vidéo responsive (en largeur ET hauteur)

Concerne

Graphisme, mise en page

La réponse On peut facilement rendre un iframe de vidéo responsive en largeur en mettant 100% dans le widht MAIS il faut alors jouer "à la main" sur le nombre de pixels en hauteur.

On peut aussi utiliser ce code

""<div class="embed-responsive embed-responsive-16by9">
  <iframe class="embed-responsive-item" src="https://www.youtube.com/embed/xSa0_lyLKjI"></iframe>
</div>""

l'url de la vidéo à utiliser est la partie à repiquer dans l'iframe fourni par la plateforme et qui contient le /embed

Lien vers la doc https://getbootstrap.com/docs/4.0/utilities/embed/

Exporter la page au format pdf Voir la fiche

réparer des tables cassées (wiki non accessible)

Concerne

Bazar (formulaire)
Phpmyadmin

La réponse Si vous recevez un message de ce type à l'affichage de votre wiki

Query failed: delete from <prefixe>_referrers where time < date_sub(now(), interval '24' day) (Table './dehors/<prefixe>_referrers' is marked as crashed and last (automatic?) repair failed)

Vous pouvez réparer les tables en passant par phpmyadmin

choissisez la db
sélectionnez les tables concernées (voir votre <prefixe>)
dans "avec la sélection" => réparer la table

Exporter la page au format pdf Voir la fiche

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

Concerne

Codes utiles /raw...
Hors yeswiki

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>',

'contact_mail_func' => 'smtp',
  'contact_smtp_host' => 'smtp-relay.sendinblue.com',
  'contact_smtp_port' => '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://

Exporter la page au format pdf Voir la fiche

rétablir un bon format de table quand on a un nouveau wiki sur une vieille table

Concerne

Codes utiles /raw...
Phpmyadmin

La réponse on passe par phpmyadmin et on applique cette requête sql (en changeant le prefixe)

ALTER TABLE <prefixe>_nature
  DROP IF EXISTS bn_ce_id_menu,
  DROP IF EXISTS bn_commentaire,
  DROP IF EXISTS bn_appropriation,
  DROP IF EXISTS bn_image_titre,
  DROP IF EXISTS bn_image_logo,
  DROP IF EXISTS bn_couleur_calendrier,
  DROP IF EXISTS bn_picto_calendrier,
  DROP IF EXISTS bn_type_fiche,
  DROP IF EXISTS bn_label_class,
  MODIFY COLUMN bn_ce_i18n VARCHAR(5) NOT NULL DEFAULT '';

Exporter la page au format pdf Voir la fiche

Transférer des images d'une page vers une autre

Concerne

Images

La réponse

1. se rendre sur la page d'origine (ex. : PageDorigine) et copier le code l'action {{attach file="Mon_Fichier.txt" ...}}
2. se rendre sur la nouvelle page et coller tout ce code
3. ajouter en début du nom de fichier le nom de la page suivie de / ; exemple : {{attach file="PageDorigine/Mon_Fichier.txt" ...}}

pour les vieilles versions cercopithèques

Les images (et autres fichiers) figurant dans les pages de YW se trouvent dans le dossier /files sur le serveur. Au moment où le fichier est téléchargé, son nom est modifié : le NomDePage dans laquelle il se trouve est ajouté devant le nom du fichier.

Pour transférer des fichiers inclus dans une page vers une autre page, il suffit de les renommer en changeant leur NomDePage. Il faut bien sûr avoir accès au serveur en ftp. Par exemple, dans l'illustration ci-dessous, pour transférer les images de la page BrouilloN vers la page BoiteALivres, renommer les fichiers "BrouilloN_IMG_..." en "BoiteALivres_IMG_...". Les images seront supprimées de la page BrouilloN et apparaitront dans la page BoiteALivres.

Cette procédure est particulièrement intéressante quand on veut changer le nom d'une page existante qui contient des fichiers. Dans ce cas, on récupère le code wiki de la page existante et on le colle dans la nouvelle page, sauf que les fichiers restent attachés à l'ancienne page et qu'à la place des images apparaissent des boutons "Télécharger le fichier...". Une fois qu'on a renommé les fichiers, les images deviennent visibles dans la nouvelle page.

Lien vers la doc https://yeswiki.net/?AttacH

TransfererDesImagesDUnePageVersUneAutre_capture-decran-du-2021-04-15-00-10-12.png

Exporter la page au format pdf Voir la fiche

63 fiches trouvées

Concerne

Bazar (formulaire) (27)

Carte (5)

Graphisme, mise en page (20)

Images (8)

Mise à jour, pb de mise à jour (1)

Codes utiles /raw... (13)

Phpmyadmin (3)

Hors yeswiki (7)

Extension LMS (1)

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 ou sur la page GererConfig de votre wiki pour mettre les pays souhaités (sous format iso en 2 lettres : FR pour france, DE pour allemagne, etc..) Et la liste de tous les pays ici dans la variable $pays_bloque

$pays_bloque = array("ID", "MY");

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.

Utilisation de QrCode Troc : explications sur github

démo de l'action

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 !!! / la classe attach permet de charger l'action attach
file	le nom du fichier (uniquement svg, gif, jpg, jpeg ou png)
bgcolor	nom de la couleur de fond en ascii ex : #0845ff ou blue ((liste des codes couleurs sur wikipédia et voir cette page et celle-là)
width	en px = la largeur d'affichage du fichier, le cas échant
height	en px = la hauteur de votre bandeau
id	(pour les utilisateurs avancés) l'identifiant de cette section dans le code html
nocontainer	= "true" ; (pour les utilisateurs avancés) ne pas définir de container dans le code html
visibility	(pour les utilisateurs avancés sur doryphore uniquement) permet de contrôler l'affichage en fonction du type d'utilisateur, par contre le contenu reste visible en mode édition ; = "" tout le monde ; "+" un utilisateur connecté ; "@admins" un administrateur ; "NomWiki" le nom d'un utilisateur, "!@UnGroupe" aucun membre du groupe UnGroupe* , ... détails ICI

Mettre à jour YesWiki

Avec la sortie officielle de doryphore, il y a un changement majeur concernant le dossier templates.
Les fichiers de templates contenus dans ce dossier seront supprimés à la mise à jour.
Pensez à les déplacer dans le dossier custom en suivant cette documentation : DocumentationCustom

Sans changement de version

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ées.
Aussi, la version doryphore nécessite une version de php >= 7.3.

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.
Pour plus de facilité, vous pouvez installer le thème Margot dès maintenant : Roue crantée en haut à droite > Gestion du site > Onglet "Mises à jour / Extensions" > Thèmes, puis installer le thème Margot

Deuxième étape : installer la version doryphore

Après avoir récupéré la dernière version de YesWiki cercopitheque sur le site, mettez votre wiki à niveau en l'installant via FTP ou directement depuis l'interface de gestion des mises à jour.
Pour cela, vous pouvez suivre la procédure décrite ci-dessous.

Méthode A la plus simple

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

Méthode B pour les geeks - Mettre à niveau son wiki via ftp

... et aussi pour mieux comprendre comment ça marche en soulevant le capot ;)

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

Appliquer le nouveau thème

Le thème margot est le thème de base pour la version Doryphore.
Ce nouveau thème est conseillé. Pour l'appliquer :
-> roue crantée
-> gestion du site
-> thème graphique
-> tout en bas de la page
sélectionner margot
Appliquer
Ceci met à jour votre fichier wakka.config

Profiter de la nouvelle action login

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 à ajouter les liens précédemment présents en utilisant la syntaxe de l'action Button.

Mettre à jour l'interface de gestion du wiki

Mettre à jour la navigation de gestion
Cela vous assurera d'être sur une organisation à jour de la gestion du wiki.
Cliquez sur la 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 :

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

Cinquième étape : faites-vous plaisir !

Vous avez maintenant une version doryphore certifiée utilisable, vous pouvez utiliser 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 vous n'aimez pas le nouveau thème, vous pouvez retrouver l'ancien dans Mises à jour et extensions et l'installer.

Autres savoirs utiles autour des mises à jour

Pour changer le nom d'un wiki

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.php?wiki="
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 dans certaines pages, et qu'il faudra donc éditer pour mettre la nouvelle url.

Spécificités du passage de YesWiki Bachibouzouk à YesWiki Cercopithèque

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'];?>>

Spécificités du passage de YesWiki Anacoluthe à YesWiki Bachibouzouk

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 côté

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

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

Passer en unicode UTF-8, si votre version wiki est antérieure à 2018...

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

Pour les très vieux wikis avec des fichiers rangés par noms de page dans des sous dossiers dans files

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
```

Accordéon

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut

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 documentation

annuaire_alphabetique.tpl.html

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut

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 documentation

compteur.tpl.html

Ce template est fourni avec un yeswiki de base non il doit être téléchargé

CompteursTplHtml_capture-décran-2018-12-06-à-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 documentation

damier.tpl.html

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut

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.

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 documentation

galerie_photos.tpl.html

Ce template est fourni avec un yeswiki de base non il doit être téléchargé

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 documentation

liste_fiches_horscarte.tpl.html

Ce template est fourni avec un yeswiki de base non il doit être téléchargé

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 documentation

liste_galerie.tpl.html

Ce template est fourni avec un yeswiki de base non il doit être téléchargé

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 documentation

liste_liens_date.tpl.html

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut

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 documentation

liste_mails_seuls.tpl.html

Ce template est fourni avec un yeswiki de base non il doit être téléchargé

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 documentation

mails_maj.tpl.html

Ce template est fourni avec un yeswiki de base non il doit être téléchargé

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 documentation

material-card.tpl.html

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut

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 documentation

photo-oxygen.tpl.html

Ce template est fourni avec un yeswiki de base non il doit être téléchargé

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 documentation

semi-ouvert.tpl.html

Ce template est fourni avec un yeswiki de base non il doit être téléchargé

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 documentation

timeline.tpl.html

Ce template est fourni avec un yeswiki de base oui il est fourni par défaut

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 documentation

{{accordion}} et {{panel}}

démo de l'action

L'action accordion quand elle est utilisée autour d'une ou plusieurs actions panel permet d'afficher ces panels en mode accordéon. Les panels sont alors affichés fermés par défaut et un seul panel peut être ouvert à la fois.
Il est également possible de laisser un panel ouvert à l'affichage de la page en spécifiant sur ce panel le paramètre type = "colapsible" (voir la page de démo pour plus d'informations).

Comportements
Sert à masquer une ou plusieurs parties de la page

Remarque
Un ensemble de panels ouvrables/fermables sont différents d'un accordéon qui rassemblent plusieurs panels : dans le premier cas, l'ouverture/fermeture des panels est indépendantes tandis que dans le deuxième cas, l'ouverture d'un panel provoque la fermeture des autres panels qui font partie de l'accordéon.

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 bouton

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

Note: même s'ils peuvent se ressembler en apparence label ("étiquette") et bouton ne sont pas la même chose. Un label est une mise en forme du texte.

Je suis un label Je suis un bouton
Réduite au minimmum, la syntaxe pour créer un bouton serait

{{button link="DocumentatioN" text="Je suis un bouton de test"}}

ce qui donne "seulement":
Je suis un bouton de test
C'est pourquoi on peut personnaliser l'apparence et le comportement des boutons.

Personnaliser l'apparence des boutons

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-success" link="DocumentatioN" text="Voir la documentation"}}

donne :
Voir la documentation

{{button class="btn-success btn-lg" link="DocumentatioN" text="Voir la documentation"}}

donne :
Voir la documentation

{{button class="btn-success btn-sm" link="DocumentatioN" text="Voir la documentation"}}

donne :
Voir la documentation

{{button class="btn-success 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étrer le comportement du bouton

Paramètre title

Ajoute un titre au survol d'un bouton. Dans le cas d'une fenêtre modale (voir ci-dessous "Fenêtres modales"), 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

Ouvrir dans une nouvelle fenêtre à partir d'un bouton

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 nobtn="1" class="new-window" link="DocumentatioN" text="Voir la documentation"}}

donne :
Voir la documentation

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 modale 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

Configurer son YesWiki en Intranet : 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 ! )

1ere méthode : par le fichier wakka.config.php

Cette opération ne peut être effectuée que par le ou les administrateurs techniques du site (webmestre(s))

Dans le fichier "wakka.config.php", situé à la racine du Yeswiki remplacez :

'default_write_acl' => '*',
  'default_read_acl' => '*',

par

'default_write_acl' => '+',
  'default_read_acl' => '+',

2nd méthode : depuis le serveur

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

Action grid et col

Une colonne de 2, une de 4, une de 6

{{grid}}
{{col size="2"}}
Texte de la colonne à remplacer par votre texte (ou votre image ou...)
{{end elem="col"}} 
{{col size="4"}}
Texte de la colonne à remplacer par votre texte (ou votre image ou...)
{{end elem="col"}} 
{{col size="6"}}
Texte de la colonne à remplacer par votre texte (ou votre image ou...)
{{end elem="col"}}
{{end elem="grid"}}

donne

Texte de la colonne à remplacer par votre texte (ou votre image ou...)

Colonne de 4, une de 4, une de 4

{{grid}}
{{col size="4"}}
Texte de la colonne à remplacer par votre texte (ou votre image ou...)
{{end elem="col"}} 
{{col size="4"}}
Texte de la colonne à remplacer par votre texte (ou votre image ou...)
{{end elem="col"}} 
{{col size="4"}}
Texte de la colonne à remplacer par votre texte (ou votre image ou...)
{{end elem="col"}}
{{end elem="grid"}}

donne

Texte de la colonne à remplacer par votre texte (ou votre image ou...)

Colonne de 3, une de 3, une de 3 et une de 3

{{grid}}
{{col size="3"}}
Texte de la colonne à remplacer par votre texte (ou votre image ou...)
{{end elem="col"}} 
{{col size="3"}}
Texte de la colonne à remplacer par votre texte (ou votre image ou...)
{{end elem="col"}} 
{{col size="3"}}
Texte de la colonne à remplacer par votre texte (ou votre image ou...)
{{end elem="col"}}
{{col size="3"}}
Texte de la colonne à remplacer par votre texte (ou votre image ou...)
{{end elem="col"}}
{{end elem="grid"}}

donne

Texte de la colonne à remplacer par votre texte (ou votre image ou...)

Extension CheckAccessLink

Cette extension conditionne la visibilité du lien cible à son accessibilité.

L'objectif est de choisir caché certains liens aux utilisateurs non autorisés.

Fonctionnement:

Installer l'extension (via Roue Crantée / Gestion du site / Mise à jour / Extensions )
Il faut ajouter la chaine 'cacher_si_pas_autorise' à la fin de la syntaxe de lien, comme dans l'exemple suivant :

[[PageDeTest accéder sur la page de testcacher_si_pas_autorise]]

Le lien "page de test" ne s'affichera que si la page cible est accessible à l'utilisateur en cours.

Utilisation avancée

Il est possible de remplacer la chaine 'cacher_si_pas_autorise' dans wakka.config.php par autre chose en rajoutant une ligne

'alter_management_string' => '_ma_string_a_moi_',

Dans ce cas l'exempe précedent s'écrit de la façon suivante :

[[PageDeTest accéder sur la page de test_ma_string_a_moi_]]

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

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)

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

le wiki génère un fichier CSV à télécharger

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.

Afficher les fiches YesWiki sur une carte de type umap

Il existe un tutoriel suivant : BazarAfficherSurCarteUMAP pour afficher les fiches YesWiki sur une carte de type umap.

Gérer les personnalisations de thème en CSS

La solution : PageCSS

(uniquement à partir de Doryphore)

La mise en forme de YesWiki est gérée par un thème qu'il est possible de modifier comme l'explique la page Changer de thème graphique.
Toutefois, certaines modifications pour votre site demandent des personnalisations.

Vous pouvez les définir en CSS directement dans une page de votre wiki en y insérant par exemple le code suivant pour afficher le texte de tous les liens en rouge :

""<style>
a {
	color : red ;
}
</style>""

Toutefois, pour que ceci fonctionne, il faut l'intégrer dans une page qui est affichée tout le temps comme PageFooter. Mais ceci rend compliqué la lecture de cette page.

La solution : copier tout votre code CSS directement dans PageCSS. Cette page sera chargée automatiquement en début de votre page comme feuille de style en cascade CSS.

Voici ce qu'il faudrait y mettre pour notre exemple :

a {
	color : red ;
}

Liste des actions

{{nomaction param1="valeur1" param2="valeur2" ... paramN="valeurN"}}

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

Quelques actions pour commencer

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

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

Un joli bouton cliquables pour vos liens

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

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

Permet de créer un sommaire mobile sur la page

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

Toutes les actions par ordre alphabétique

S'abonner à une liste de discussion / diffusion

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

active des styles permettant d'animer vos pages

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

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

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

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

Lister les pages qui font un lien vers la page courante

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

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

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

Un joli bouton cliquables pour vos liens

mise en page par colonne

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

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.

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

Affiche le NomWiki de la page courante

Se désabonner à une liste de discussion / diffusion

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

Pour les thèmes : active le double clic

Interface de création d'un ebook

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

Gestion des droits des actions

Gérer des groupes d'utilisateurs

Gestion des droits des handlers

Finir les actions grid, col

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

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

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

Ouverture d'une zone avec des colonnes

Liste des pages

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

Liste la totalité des pages du site.

{{Listusers/last}

Donne la liste des derniers comptes utilisateurs.

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

Affiche un moteur de recherche

Liste les pages dont je suis le propriétaire

Liste les pages que j'ai modifié

Permet de créer des onglets dans une page

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

Permet de faire des points cliquables sur une image

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

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

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

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

Tester directement les styles disponibles sur votre wiki

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

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

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

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

Permet d'afficher un pdf présent sur le site

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

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

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

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

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.

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

Permet d'intégrer une vidéo en provenance de Youtube, Vimeo ou Peertube

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

démo de l'action

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}}). Il est possible d'afficher le fichier d'une autre page ex: 'NomAutrePage/NomFichier.ext'
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"
displaypdf	Permet d'afficher le fichier si c'est un pdf. Ex: displaypdf="1". Dans ce cas, class="left" ou "right" permet de définir la position du PDF, et les autres paramètres de l'action PDF sont utilisables

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 :

Sécuriser la structure d'un Yeswiki

Yeswiki est par nature un logiciel ouvert, c'est-à-dire que la création et la modification des pages est par défaut possible pour tous les utilisateurs. Cependant, en fonction du contexte d'utilisation vous pouvez avoir besoin de restreindre ces possibilités de contribution.
Vous trouverez sur cette page quelques exemples.

Protéger les pages de menu et d'administration

Vous pouvez vouloir protéger en écriture (c'est à dire interdire la modification) certaines pages "sensibles" de votre wiki, par exemple les Menus ou les pages liées à l'administration.

Pour se faire, vous pouvez utiliser la gestion des droits et voir comment affiner les droits d'édition des pages.

Par défaut la plupart des pages sont correctement protégées mais si vous avez un peu trop bidouillé dans la gestion des droits, voici un récapitulatif des pages clefs et de leur réglage conseillé.

Liste des pages à protéger

BazaR

| L/E | Peut contenir des informations personnelles |
|

DerniersChangements

| E | |
|

DerniersChangementsRSS

| E | |
|

DerniersCommentaires

| E | |
|

GererDroits

| L/E | Empècher l'accès aux fonctions vitales de YesWiki aux admins |
|

GererMisesAJour

| L/E | Empècher l'accès aux fonctions vitales de YesWiki aux admins |
|

GererSite

| L/E | Empècher l'accès aux fonctions vitales de YesWiki aux admins |
|

GererThemes

| L/E | Empècher l'accès aux fonctions vitales de YesWiki aux admins |
|

GererUtilisateurs

| L/E | Empècher l'accès aux fonctions vitales de YesWiki aux admins |
|

PageColonneDroite