Crayons controleurs et vues - doc complémentaire

Version 7 — Juillet 2020 — 78.242.xx.xx

On trouvera ici
- des compléments de documentation
- des exemples de contrôleurs et vues
- Un exemple d’utilisation du datepicker

Utilisation sur des objets non déclarés

Les crayons peuvent être utilisés, dans une boucle sur une table non déclarée à SPIP.

C’est transparent et il n’y a rien à coder au moins lorsque la table a un nom habituel pour SPIP avec un s à la fin du nom de la table. (Il est aussi conseillé en général, mais non nécessaire pour les crayons, que le nom de la clé primaire soit composé de ’id_’ suivi du nom de la table au singulier.)

Fonctions personnalisées de mise à jour

Dans des cas particuliers, il est possible de définir une fonction revision_typobjet ou typobjet_revision pour gérer l’enregistrement des valeurs. Cette fonction reçoit 3 arguments :
- $id : l’identifiant de l’enregistrement à modifier (valeur de la clé primaire)
- $colval : tableau de couples (champ, nouvelle valeur)
- $type : nom de la table, sans le s

Exemple :

function revision_spip_theme($id, $colval, $type) {
  sql_updateq($type.'s', $colval, "id_theme=".intval($id));
}

Edition par un input ligne ou par un textarea ?

La doc indique que « si un texte crayonnable est un champ MySQL MEDIUMTEXT ou plus long, les crayons affichent un TEXTAREA, et sinon, un INPUT. » mais en fait le code teste AUSSI si il y a des fins de ligne dans la valeur du champ, auquel cas c’est toujours un TEXTAREA.

C’est le code de _plugins_/crayons/action/crayons_html.php qui fait ça et qu’il est possible de surcharger localement pour modifier ce comportement, au niveau de la ligne 97.

Par exemple on peut simplement ajouter la condition suivante au test :

OR (strlen ($valeur[$champ]) > 30)

En langue diff, ça donnerait :

@@ -94,7 +94,8 @@


// si la valeur fait plusieurs lignes on doit mettre un textarea
+    // idem si la valeur fait plus de 30 caractères
-    // derogation specifique pour descriptif_site de spip_metas
+    // et derogation specifique pour descriptif_site de spip_metas
    if (
        preg_match(",[\n\r],", $valeur[$champ])
        OR (($champ == 'valeur') && ($id == 'descriptif_site'))
+        OR (strlen ($valeur[$champ]) > 30)                            
        OR
    // on regarde le type tel que defini dans serial

Nom servant d’index dans l’environnement reçu par un contrôleur

Le contrôleur reçoit une variable d’environnement avec la valeur de l’index de l’enregistrement édité. Le nom de cette variable est toujours de la forme ’id_table’ lorsque la table s’appelle ’TABLE’ ou ’TABLES’. C’est donc Le contrôleur reçoit un environnement avec la valeur de l’index de l’enregistrement édité , affecté à un nom qui est bien l’index de la table si la table suit les conventions de nommage élémentaires de SPIP mais ça ne l’est pas sinon . : c’est à dire lorsque le nom du champ index est de la forme ’ id_table ’ et la table s’appelle ’ TABLE ’ ou ’ TABLES ’.

Exemple : si Si donc la table est "PLOUF’, l’index reçu a pour nom ’id_plouf’ même si le vrai champ index de la table PLOUF est « mon_idploc ». Dans Il faudra alors dans ce dernier cas, il faudra faire le lien dans la boucle avec :
<BOUCLE(PLOUF){mon_idploc=#ENV{id_plouf}}>

Exemples d’un contrôleur unique servant à saisir plusieurs les différents champs constitutifs d’une adresse

Si la table PLOUF contient en fait des adresses, voici ce que pourrait donner un contrôleur pour crayonner l’adresse.

[(#REM)


Controleur pour le crayon 'plouf_detailsdeladresse' , uniquement html
    pour crayonner tous les champs de la table plouf qui définissent une adresse
    
    fichier plouf_detailsdeladresse.html à mettre dans le sous-dossier controleurs du dossier squelette
    
    appelé dans un fichier squelette par <span #EDIT{detailsdeladresse}>#NOM #PRENOM, #ASSO, #ADRESSE, #CP #VILLE - #TEL - #EMAIL #SITE</span>
]
#CACHE{0}
<BOUCLE_plouf(plouf){mon_idploc=#ENV{id_plouf}}>
<fieldset style="width:#ENV{largeur}px;#ENV{style}">
<legend>Détails de l'adresse</legend>


<label>Nom</label>
<input class="crayon-active" name="#ENV{name_nom}"  style="width:100%;" value="[(#NOM**|entites_html)]" />


<label>Prénom</label>
<input class="crayon-active" name="#ENV{name_prenom}"  style="width:100%;" value="[(#PRENOM**|entites_html)]" />


<label>Adresse</label>
<textarea class="crayon-active" name="#ENV{name_adresse}"     style="width:100%; height:#ENV{hauteur}|mul{2}px;">
[(#ADRESSE**|entites_html)]</textarea>


<label>CP</label>
<input class="crayon-active" name="#ENV{name_cp}"  style="width:100%; " value="[(#CP**|entites_html)]" />


<label>Ville</label>
<input class="crayon-active" name="#ENV{name_ville}"  style="width:100%; " value="[(#VILLE**|entites_html)]" />


<label>Tel</label>
<input class="crayon-active" name="#ENV{name_tel}"  style="width:100%; " value="[(#TEL**|entites_html)]" />


<label>Email</label>
<input class="crayon-active" name="#ENV{name_email}"  style="width:100%; " value="[(#EMAIL**|entites_html)]" />


<label>Site</label>
<input class="crayon-active" name="#ENV{name_site}"  style="width:100%; " value="[(#SITE**|entites_html)]" />


[(#REM)
    [<pre>(#ENV**|unserialize|print_r{1})</pre>]
]
</fieldset>


</BOUCLE_plouf>

Utiliser un datepicker dans un controleur

1. dans le controleur

#CACHE{0}
<BOUCLE_toto(MA_TABLE){id_ma_table}>
<input class="crayon-active date" type="text" name="#ENV{name_madate}" value="[(#MADATE|affdate{d/m/Y})]">
</BOUCLE_toto>
#INCLURE{fond=formulaires/dateur/inc-dateur}

2. dans le pipeline : crayons_verifier

function prefix_crayons_verifier($flux){
	$date = $flux['args']['content']['madate'];
	list($date,$heures)        = explode(' ' , $date);
	list($jour, $mois, $annee) = explode('/',$date);
	$heures = ( $heures ) ? $heures : "00:00:00";
	$date = intval($annee) .'-'. $mois .'-'. $jour. ' ' . $heures;


$flux['data']['normaliser'] = array('madate' => $date);
	return $flux;
}

3. La vue

#CACHE{0}
<BOUCLE_toto(MA_TABLE){id_ma_table}>
[(#MADATE|affdate{d/m/Y})]
</BOUCLE_toto>

Verifier la saisie sur un champ crayonnable

Crayons propose un pipeline permettant de vérifier la saisie d’un champ.

Par exemple, pour vérifier qu’une référence d’un produit n’existe pas déjà :

function produits_crayons_verifier($flux){


if ( $flux['args']['type'] == 'produit' && $flux['args']['modele'] == 'reference' ) {
    $str = $flux['args']['content']['reference'];
    $id_produit =  $flux['args']['id_objet'];
    if ( sql_getfetsel('reference','spip_produits',"reference='$str sql_getfetsel('refernece','spip_produits',"reference='$str ' AND id_produit!=intval($id_produit)") )
      $flux['data']['erreurs']['reference'] = _T('produits:reference_existante');
  }
  //   Voir  dans  les  logs  ce  qui  se  passe ...
   // spip_log($flux, _LOG_DEBUG);


// Voir dans les log ce qui se passe...
    // spip_log($flux, _LOG_DEBUG);


return $flux;
}

Il faudrait certainement utiliser sql_quote pour échapper l’argument utilisant $str

Retour à la version courante