mercredi 29 mars 2006, par Jacques J.,
leToph. Dernier ajout samedi 4 novembre 2006
Dans une récente contribution Jacques J. proposait d’intégrer un tableau issu d’un fichier csv dans un article. Pour cela, il utilisait une boucle gérant les documents joints du type csv.
Le principe a été repris dans la contribution proposée ici.
Comme indiqué dans la précédente contribution, SPIP n’accepte pas par défaut les fichiers csv en téléchargement.
Pour cela, il faut suivre la procédure décrite dans l’article correspondant sur www.spip.net
Par ftp, créer un répertoire csv dans /IMG/, et ne pas oublier de régler les droits d’écriture…
2 – La fonction
Elle s’inspire à la fois de la contribution de Jacques J., et de routines présentées notamment sur nexen.net.
Vous pouvez l’installer dans mes_fonctions.php3 comme à l’accoutumée. Voici les explications pas à pas :
Dans un premier temps, le filtre va ouvrir le fichier que vous avez téléchargé.
Il va lire les lignes une à une et les placer dans un tableau
L’apport principal de cette contribution est de permettre au créateur du fichier csv de « préprogrammer la mise en page ». En effet, il peut renseigner son fichier dont la structure ressemble à ceci :
Les variables pouvant être modifiées sont :
largeur totale du tableau dans la mise en page du squelette (en relatif ou en absolu)
présence d’une entete
l’alignement de chacune des colonnes
la largeur relative des colonnes, afin d’équilibrer le tableau
A noter que le filtre traite les retours de ligne générés sous Excel par la combinaison de touches ALT + Retour
Il va récupérer dans les lignes 1 et 2 les paramétrages du tableau :
rang 1 col 2 : largeur du tableau
rang 2 col 2 : existence d’une entete de tableau
S’il y a une entete, il va la traiter spécifiquement en lui affectant le style ad hoc.
Les autres lignes du tableau seront traitées en reprenant, cellule par cellule, les éléments situés dans la même colonne en rang 3 (largeur de la cellule) et 4 ( alignement).
A noter que le fichier d’exemple fourni au format xls comporte une fonction, en rang 3, qui affiche automatiquement la largeur de la colonne.
On notera au passage un « petit bricolage » permettant de traiter correctement les styles spip des tableaux :
La boucle document à utiliser est du type :
Vous trouverez dans l’archive :
le fichier mes_fonctions.php3.txt (extension en .txt par sécurité pour les manœuvres hatives)
un modèle de tableau au format .xls
un modèle de tableau au format .csv
Extension : adapter cette contribution pour traiter des balises de documents directement inclus dans les articles, mais vraisemblablement, cela nécessiterait une intervention sur le coeur du code.
très bonne contrib. J’errai sur macro word et je suis arrivé ici... avec les mêmes problèmes :
l’idée est de gérer des tableaux un peu plus évolués. Visiblement CSV ne gère pas les fusions de cellules (colspan et rowspan). Or spip le fait via |<| & |^|
(respectivement colspan et rowspan).
Je me demandais si l’on pouvait procéder exactement de la même façon : on intègre un petit " < " dans le csv (entre les points virgules) et on l’interprète dans mes fonctions.
je débute sous spip, et ce plugin m’interesse. Je l’ai installé mais je n’arrive pas à afficher le csv dans l’article. J’ai du raté un truc lors de l’instal, mise en ligne et tout mais je sais pas quoi.
Si quelqun pouvait expilquer étape par étape comment installer et faire fonctionner ce plugin, ca serait génial.
J’ai récemment approfondi, grace à l’aide de Marabbeh (voir plus bas). D’où une amorce de plugin qui n’est pas encore suscptible d’être diffusé en état, mais qui peut rendre service. Envoyez-moi un message en MP. J’envoie le fichier dès que je j’aurai un peu nettoyé.
J’ai un souci, je n’arrive pas a faire fonctionner cette fonction. Voici ce que j’ai fait avec la version 1.9 de SPIP :
insertion dans la base de donnees de
titre : CSV
extension : csv
inclus : embed
upload : oui
Ajout de la fonction dans mes_fonctions.php
Dans dist/modeles creation de doc_csv.html avec
[(#TITRE|supprimer_numero)]
[(#DESCRIPTIF)]
[(#URL_DOCUMENT|tableurcv)]
Ensuite lorsque j’ecris un article je joins mon document csv et dans l’article je tape
Lorsque je vais dans la partie publique je ne vois pas mon tableau, je ne vois que l’icone du document que l’on peut telecharger.
J’ai aussi essayé d’en faire un modèle. Cad au lieu de mettre la boucle présentée ci-dessus dans le squelette, le rédacteur peut indiquer lui-même, dans l’article, l’endroit où il va mettre son tableau, avec la balise <docXXX|csv>.
Voici le modèle doc_csv.html (quasiment la boucle de la contrib) :
Dans mon squelette, le critère doublons ne sert à rien. Puisque c’est dans un modèle et pas dans le squelette. D’ailleurs ça peut poser un problème. Mais dans mon cas, ça ne me gène pas d’afficher le document .csv d’origine.
Une autre suggestion :
Si votre fichier .xls contient des urls (http://www.mon-domaine.tld ou maito:mon-adresse@email.tld), ces adresses seront affichées telles quelles dans le fichier .csv, puis dans le tableau Spip. Pour en faire des liens cliquables, il faut ajouter une fonction :
function tableurcsv_formate_cellule($cellule, $url_max=25) {
// formate le contenu de la cellule
// change url en <a href="url">url</a> (et coupe à $url_max cars si plus long)
$re_url = "(?:(?:(?:ht|f)tps?)\:\/\/)?(?:(?:[a-zA-Z0-9]+(?:[@\-\.]?[a-zA-Z0-9]+)*)(?:\:[a-zA-Z0-9\-\.]+)?@)?(?:www.|ftp.|[a-zA-Z]+.)?[a-zA-Z0-9\-\.]+\.(?:[a-zA-Z]{2,})(?:\:[0-9]+)?\/?";
;
$re_email = "mailto:[\w|-]+(?:\.[\w|-]+)*@[a-z0-9-]+(?:\.[a-z0-9-]+)+";
if (preg_match("/(?:" . $re_url . "|" . $re_email. ")/", $cellule, $regs)) {
$url = (strlen($regs[0]) > $url_max) ? substr($regs[0], 0, $url_max) . '...' : $regs[0];
$cellule = str_replace($regs[0], '<a href="' . $regs[0] . '">'. $url . '</a>', $cellule);
}
return $cellule;
}
Puis modifier le filtre tableurcsv() tout à la fin. Remplacer :
La fonction tableurcsv_formate_cellule() est à mettre aussi dans mes_fonctions.php.
Dans cette fonction, le paramètre $url_max permet de limiter la taille du lien, s’il risque de prendre toute la largeur du tableau. Mais l’url de redirection reste intacte.