Version 3 — September 2017 — tofulm
On trouvera ici
- des compléments de documentation
- des exemples de contrôleurs et vues
- Un exemple d’utilisation du datepicker
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
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 : c’est à dire lorsque le nom du champ index est de la forme ’id_table’ et la table s’appelle ’TABLE’ ou ’TABLES’.
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”. Il faudra alors dans ce cas faire le lien dans la boucle avec :
<BOUCLE(PLOUF){mon_idploc=#ENV{id_plouf}}>
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>
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>