L’avantage de ce développement est :
tout d’abord d’être sous forme de plugin
que l’on ne visualise pas les tables de SPIP. Cela pour éviter les erreurs de manipulation d’un administrateur non averti.
être intégré à l’interface d’administration du site SPIP
avoir une interface beaucoup plus simple qu’un PhpMyAdmin, toujours pour limiter les erreurs et éviter de casser le site.
En fait, une contrib « La gestion de tables SQL supplémentaires » m’a beaucoup plu tout en me laissant sur ma faim, on ne pouvait qu’ajouter. Alors je me suis lancé dans un module pour faire plus, puis dans la version plugin !
Présentation
Dans SPIP, on peut ajouter une table ("matable" par ex.) et utiliser des boucles pour la parcourir : {BOUCLE_a(matable)} et extraire ses champs avec des balises {#CHAMP1}, {#CHAMP2}, etc.
L’objet de cette contrib est de visualiser, ajouter et modifier le contenu de ces tables.
Nom : TableDATA
Version : 0.40
Auteur : Christophe Boutin
Licence : GPL
Compatibilite SPIP : testé sur SPIP 1.9.1 & 1.9.2PR2
Site(s) exemple : www.studiofoveau.com , mais dans la partie privée :-)
Testé sur ces navigateurs [1]
| Testé | Plateforme | Navigateur | Version |
|---|---|---|---|
| oui | windows | Internet explorer | 6.0 |
| oui | windows | Firefox | 2.0.0.1 |
Petit rappel sur SPIP
A partir de la version 1.9, on trouve une fonction très intéressante : Un extrait de la page des nouveautés de SPIP 1.9
Détection automatique de tables SQL et de jointures
Dans un squelette comportant BOUCLE_a(xxx), la table xxx peut être n’importe quelle table SQL connue du serveur SQL. SPIP demandera alors au serveur SQL de décrire cette table, ce qui lui permettra de compiler le squelette en interprétant toute balise #NOM comme un accès au champ `xxx`.nom s’il existe. Ces champs sont également repérés dans les critères des boucles.
Dans un squelette comportant BOUCLE_a(table table1 ... tablen), les tables supplémentaires seront vues comme des candidates à une jointure, à travers les champs homonymes. Des exemples plus concrets seront donnés dans la documentation.
C’est très simple à mettre en oeuvre et très pratique. Par exemple, j’utilise cela pour modifier facilement un tarif d’une galerie de vente. Cela peut également permettre de faire, en douceur, la bascule entre vos anciens scripts (back office) et une refonte du site (front office) avec SPIP.
À lire également : implémenter une nouvelle boucle (déplacé depuis dans NouvelleBoucle).
Installation
Installer le fichier joint, après l’avoir dézippé, comme tous les autres plugins, cf. http://www.spip.net/fr_article3396.html
Utilisation
Lancement du script :
Pointez l’icône « configuration » puis cliquez sur l’icone « gestion table SQL ».
Une liste des tables supplémentaires (n’ayant pas le préfixe des tables spip) est affichée, choisissez la table sur laquelle vous souhaitez travailler.
L’administrateur dispose d’un bouton permettant d’afficher également les tables internes de SPIP.
Le script retourne une nouvelle page avec :
la liste des enregistrements (par groupe s’ils sont nombreux)
avec au dessous un formulaire d’ajout. (reprise de celui de Déesse A.)
En cliquant dans le titre du champ, il est possible de trié par ordre croissant ou décroissant sur ces valeurs.
Modification des valeurs des champs
Pour modifier les valeurs d’un enregistrement, double-cliquez dessus, alors un formulaire d’édition s’affiche avec les valeurs actuelles. Pour que cette fonction soit active une clé primaire doit être définie. Elle peut être dans le format « numérique » ou « texte ». Dans la version actuelle, cette clé primaire doit être sur un champ unique.
Au retour, un message d’information les conclusions de la commande. (Ok ou erreur).
Il est affiché tout en haut de la page.
On peut également le lancer en ligne de commande : Pour gérer le contenu d’une table « magasin », il suffit de taper l’url suivante :
url = .../spip/ecrire/?exec=tabledata&table=magasin
Verrou de protection
Ce plugin est dynamique, il s’adapte à la structure de la table que vous avez créée.
La clé primaire de la table est utilisée pour pointer l’enregistrement à modifier. Le plugin ne permet pas de modifier sa valeur. (Modifier cette valeur pourrait être dangereux pour l’intégrité des données de votre application. Imaginez si cette valeur est déjà utilisée pour faire une jointure sur un autre élément de la base.)
En fonction de la clé primaire choisie, le script détermine les limitations nécessaires pour éviter les fausses manipulations. L’utilisateur en est informé.
Dernières mises à jour :
Le 19 février 2007 (v0.40) :
- Voir ou masquer les tables de spip pour les administrateurs.
- Correctif liée à l’ajout du tri sur champ.
Le 18 février 2007 (v0.33) :
- Ajout du tri sur chaque champ.
- Correctif sur l’ajout pour reprendre les valeurs par défaut.
Le 16 février 2007 (v0.32) :
- Ajout d’un ascenceur sur la liste des enregistrements dans le cas d’un nombre important de champs dans la table.
- Correction d’affichage si la table est vide.
Le 12 février 2007 (v0.3) :
- Les fonctions sont activées suivant le paramétrage de la clé primaire et information de l’utilisateur.
- La modification des enregistrements ayant une clé primaire au format texte est prise en compte.
Le 7 février 2007 (v0.22) : Correction des url des icones.
Le 6 février 2007 :
- Packagé en Plugin,
- Ajout d’un bouton dans config,
- Affichage de la liste des tables pour le choix initial
Le 21 octobre 2007 :
- Mise en ligne d’un correctif de Marc VALLETEAU de MOULLIAC (merci de son retour)
La suite
Je me demande par exemple si :
j’ajoute la possibilité d’effacer un enregistrement ?
ou j’ajoute la recherche automatique d’un champ spécifique, genre « effacer » ENUM oui/non pour masquer les enregistrements devenus inutiles dans l’appli (effacer réellement s’est toujours délicat dans une base...)
Pour les experts, ou les curieux
Quelques commentaires faisant référence aux bases de données :
Nota : Que cela ne fasse pas peur aux débutants, il n’est pas nécessaire de tout comprendre pour que ça fonctionne
Ce plugin s’adapte à la structure de la table. Les fonctions sont activées suivant le choix de la clé primaire.
S’il n’y a pas de clé primaire : La modification n’est pas autorisée.
- Il n’est pas sûr que l’on pointe de façon unique un enregistrement. Plusieurs enregistrements pourraientt être touchés par la modification.
S’il y a plus d’un champ dans la clé primaire : La modification et l’ajout ne sont pas autorisées
- Simplement parce que le code n’est pas encore adapté à ce cas. Alors pour éviter un bug ..
S’il y a une clé primaire sans auto-incrément : La modification est autorisée mais pas l’ajout
- La clé permettra de pointer de façon unique l’enregistrement à modifier.
- Mais lors de l’ajout, si l’on n’est pas vigilant, il pourrait y avoir une erreur de duplication de clé.
S’il y a une clé primaire avec auto-incrément : La modification et l’ajout sont autorisées
- C’est le cas idéal. RAS
Comment distinguer les tables ?
Il faut faire un test du nom de la table. Elle ne doit pas débuter par le préfixe utilisé par SPIP. ( voir la variable $table_prefix description, par défaut "spip_").
Voir aussi
La Contrib PhpMyAdmin-PhpInfo
Voir les tables SPIP
RSS 2.0