Contribuer au dépot git

Dépôts git utilisés

Utiliser git

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

Afficher le contenu d'une base de données

Sous forme de liste

• Action {{bazar}}
• Action {{bazarliste}}

Voir toutes possibilités

Sous forme de calendrier

• Action {{calendrier}}

Sous forme de carte

• Action {{bazarliste template="map.tpl.hptm""}} (ex-action{{bazarcarto}})

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

C'est quoi ce bazar ?

• 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

{{bazar}}

Ci-dessous, un exemple de gestionnaire bazar

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 !

• Voir un exemple de carte avec points d'une couleur
• Voir un exemple de carte avec points multicolors

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"

• 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

{{bazarliste id="" template="map.tpl.html" provider="OpenStreetMap" lat="" lon="" zoom=""  width="" height="" query=""}}

{{bazarcarto id="" lat="" lon="" zoom=""  width="" height="" query=""}}

• 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

Changer de thème graphique

Pour une page...

• 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 ?)

• 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 :

• Choisissez chaque élément de ces menus déroulants
• cliquez sur Appliquer puis
• Sauvez la page

Configuration graphique par défaut

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

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

Architecture et développement de Yeswiki

Dossiers et fichiers de la distribution

Créer des themes YesWiki

Créer des actions YesWiki

Exemple pratique de l'action {{salutations}}

affichage de base

<?php
echo "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"

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

requetes SQL

<?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ès direct interdit");
    }
    

Important

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

• avec des linter : des outils pour vérifier si le code respecte des standards

• contient un built-in formatter pour PSR-2

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

1. Ajoutez : { {section class="wow slideInRight" data="wow-iteration=3"} }, ce qui donnera le comportement du texte "exemple" quand vous êtes arrivé
2. la partie à animer doit être fermée par { {end elem="section"} }

• 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

• class="wow => puis le nom de l'effet que vous trouverez sur animate.css"

• 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}}

Exemple :

• 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

Configurer YesWiki : le fichier wakka.config.php

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

  '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

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

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

'BAZ_ENVOI_MAIL_ADMIN' => true

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

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

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

  '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

  '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

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

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

'contact_mail_func' => 'smtp',
  'contact_smtp_host' => 'ssl://<mon serveur smtp>:465',
  'contact_smtp_user' => 'user@mail.ext',
  'contact_smtp_pass' => '<monpassword>',

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

'contact_smtp_host' => 'ssl://smtp.gmail.com:465',

Liste des handlers disponibles par défaut

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

Liés à l'extension ebook

Développer avec YesWiki localement

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

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

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

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

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

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

&refresh=1

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

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

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

• 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
  

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

• 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' );

[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 :

Créer son compte et/ou s'identifier

création d'un compte YesWiki

1. aller sur la page spéciale ParametresUtilisateur
   • elle est généralement également accessible via le menu de configuration "roue crantée" : "se connecter"

   • 

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

S'identifer sur yeswiki

1. aller sur la page spéciale ParametresUtilisateur,
   • elle est généralement également accessible via le menu de configuration "roue crantée" : "se connecter"

   • 

2. remplir le formulaire avec son nom YesWiki et son mot de passe
3. cliquer sur "connexion"

Suivre la vie de son wiki

Tableau de bord

• 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

[MONYESWIKI]/?DerniersChangements

Recevoir des notifications à la modification d'une page

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)

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

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

Et avec une pincée d'html

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

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

class="wow slideInRight" data="wow-delay=3s, wow-iteration=3"

Doryphore

VOUS SOUHAITEZ TESTER CETTE VERSION BÊTA ?

• 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

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

• trier sur base du contenu d'une (ou plusieurs) liste(s)
  • query="listeListeGenre=M|listeListeDep=26"
  • notez qu'il est possible de trier sur plusieurs valeurs au sein de la même query en séparant les valeurs par une virgule (sans espace)
  • Notez bien que la syntaxe est bien liste+Nomdelaliste=clé ou liste+Nomdelaliste=clé1,clé2 (dans votre liste, la clé n'est pas le texte mais bien l'identifiant que vous avez indiqué juste devant)
• trier sur base du contenu d'une (ou plusieurs) checkbox(s)
  • query="checkboxListeGenre=M|checkboxListeDep=26"
  • Notez bien que la syntaxe est bien checkbox+Nomdelaliste=clé
• trier sur base du contenu de boutons radios
  • query="radioListeGenre=M|radioListeDep=26"
  • Notez bien que la syntaxe est bien radio+Nomdelaliste=clé
• trier sur base du contenu d'un champ (bf_...)
  • query="bf_titre=a.*" (affiche tous les titres commençant par a)
  • query="bf_titre=*.a" (affiche tous les titres finissant par a)
  • query="bf_titre=NomYeswiki (affiche la fiche dont le champ titre est NomYeswiki)
  • query="bf_titre=." (affiche toutes les fiches dont le champ bf_titre est vierge)
• trier sur base d'une liste dynamique de type "checkboxfiche"
  • query="checkboxfiche<numeroduformulaireappelé>=Chat-Mot dufiltre"}}
  • Exemple :

    {{bazarliste id="2" query="checkboxfiche2=TesT"}}
    

    Cet exemple est un annuaire. Ici, on veut voir les personnes qui ont rempli l'annuaire (formulaire 2), en affichant uniquement les personnes qui appartiennent au groupe de travail "Test" (dont le ChatMot est TesT - donc à écrire exactement comme ça)
• trier sur base d'un contenu vide
  • query="radioListeGenre="
  • Permet de ne garder que les fiches dont le champ radioListeGenre est vide (à partir de doryphore)
• trier sur base d'un contenu non vide
  • query="radioListeGenre!="
  • Permet de ne garder que les fiches dont le champ radioListeGenre n'est pas vide (à partir de doryphore)
• trier sur base d'un contenu différent d'une valeur
  • query="radioListeGenre!=M"
  • Permet de ne garder que les fiches dont le champ radioListeGenre n'est pas égale à M (à partir de doryphore)

{{attach}}

• les paramètres en gras sont obligatoires
• un paramètre se déclare de la manière suivante nomduparametre="valeurduparametre"

Extension ipblock

Configuration

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

Qrcode

• les paramètres en gras sont obligatoires
• un paramètre se déclare de la manière suivante nomduparametre="valeurduparametre"

Mettre à jour YesWiki

Sans changement de version

Passer de la version cercopitheque à la version doryphore

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

Deuxième étape : installer la version doryphore

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 :

• 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) :

• Effectuez alors un clic droit, et cette petite fenêtre va apparaitre

• 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 :

• 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 :

• 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

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 :

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 !

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

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