La Fabrique

Published : 20 April 2012 – updated on 21 December 2021 – by Matthieu Marcillaud – 378 commentaires

1
2
3
4
5
121 Votes

La Fabrique est un outil pour créer des plugins, essentiel dans la phase de développement d’un site SPIP. La Fabrique est capable de générer le code source minimal d’un plugin pour SPIP 3 (elle accélère donc le démarrage d’un plugin) et peut s’occuper également de construire un plugin fonctionnel gérant un ou plusieurs objets éditoriaux et leurs liaisons (et là, elle devient formidable !). La base du plugin construit, il ne vous reste plus qu’à l’adapter à vos désirs les plus créatifs.

La Fabrique est un outil de construction de plugin spécialement orientée pour la gestion d’objets éditoriaux. Pour ceux qui ont connu le plugin «Chat» ou «Chat2», sachez que la Fabrique sait gérer tout ce qui est présent dans ce tutoriel / plugin, et même au-delà, bien au-delà.

N’allez pas trop vite !

Cette note est aussi présente lors de l’installation du plugin, mais redisons le encore :

  • la Fabrique crée un code fonctionnel mais qui ne répondra peut être pas à 100% de vos attentes. La Fabrique ne peut pas tout faire. À vous d’adapter ensuite le code généré.
  • un plugin est très vite fait grâce à la Fabrique. Mais attention : le code n’est qu’une partie d’un plugin. Si vous voulez que votre plugin perdure dans le temps, il faut qu’il soit utile, partagé, documenté, traduit, il faut assister les utilisateurs, et maintenir son code avec les évolutions de SPIP et c’est tout cela aussi un plugin !
  • la Zone de SPIP permet de collaborer sur les plugins. Essayez au maximum de ne pas créer des plugins existant déjà, pour éviter des doublons qui peuvent disperser d’autant les énergies pour toutes les tâches citées au point précédent.

Pré-requis

Pour faire fonctionner la Fabrique il faut :

  • PHP >= 5.3 (il est possible que 5.2 fonctionne aussi)
  • SPIP 3.0-RC minimum
  • Un navigateur récent (testé avec FF11 et Chrome 18.0)
  • Saisies >= 0.25
  • Et peut être un système Unix/Linux pour son serveur (appel de exec('diff') en PHP) [1]

Optionnellement mais conseillé :

Démonstration vidéo

Dans la vidéo suivante, vous verrez une présentation de la Fabrique impliquant la construction d’un plugin «Félins» dans lequel nous créons 1 objet éditorial «Chats».
Cette vidéo est aussi disponible en meilleure qualité sur medias.spip.net

Présentation de la Fabrique en vidéo

Accéder à la fabrique

Depuis SPIP 3.1, La fabrique est accessible dans le menu de développement (il faut activer l’option de vos préférences personnelles pour voir ce menu)

Documentation

En attendant une documentation plus riche ici, vous pouvez lire ces articles :

Capture d’écran

La Fabrique, version 1.13.3
Interface d’accueil de la Fabrique avec un objet éditorial «Chats» de renseigné dans un plugin nommé «Félins»

À tester

«La Fabrique» débute sa vie publique et doit être testée dans différents environnements. Vous êtes donc invités à explorer cet outil développé maintenant sur la Zone [2]

Limitation connue

Actuellement (version 1.16.3), à partir d’un certain nombre d’objets et de champs (environ 10 objets * 8 champs ici), le formulaire devient naturellement inopérant à cause d’une limitation voulue de PHP : max_input_vars, par défaut à 1000 dans php.ini.
Pour contourner, il faut modifier php.ini pour tolérer plus de champs (5000) par exemple.

Attention

Depuis la version 2.0.0, le menu de la fabrique se trouve dans celui de Développement. Celui-ci est activable depuis l’espace préférence de l’utilisateur.

Footnotes

[1] À faire vérifier par quelqu’un ayant un serveur local sous Windows

Discussion

5 years 1 year 3 months Without limit
par date
Filter

136 discussions

  • jmame

    il est possible d’installer le plugin sous spip 4 depuis la branche master (téléchargeable depuis le git puis installation manuelle). Pour rendre le plugin actif, il suffit d’installer d’abord le plugin jQuery ui manuellement.

    Reply to this message

  • 2
    Natacha Courcelles

    Bonjour
    y a t’il moyen d’ajouter aux statistiques de Spip 4 un objet créé avec La Fabrique ?

    merci
    Natacha

    Reply to this message

  • Natacha Courcelles

    Bonjour

    comment afficher un champs en fonction de la valeur de radio, case à cocher ou de sélecteur ?
    après un radio oui non Un nom de champ pour SQL “possible_section”

    data=[(#ARRAY{oui,oui,non,non})]

    dans le champ suivant j’ai mis

    @possible_section@ == "oui"

    ou
    mais il s’affiche quand même

    merci pour votre aide
    Natacha

    Reply to this message

  • Kingrise

    Bonjour et merci pour ce plugin très utile pour créer des outils rédactionnels supplémentaire... Est-ce que ce plugin sera porté sur la version 4.0 de Spip et y aura-t-il des modifications à apporter sur nos add-ons faits maison ?

    Merci

    Reply to this message

  • 1
    baloo

    Bonjour,
    j’essaye de faire un pluging avec la fabrique. Dans l’ensemble cela fonctionne bien. Il me reste un point que je n’arrive pas à comprendre :

    J’ai un objet X qui dépend en liaison directe d’un objet Y et qui peut être rattaché à des rubriques et des articles.
    Je vois bien la liste des objets X de l’objet Y.
    Je vois bien la liste des objets X.
    par contre si je rattache un objet x par exemple a 2 rubriques, j’ai dans la page de l’objet
    Liés à cet objet X et la liste de toutes les rubriques.
    J’ai vue que cela venait de l’element généré
    objets/liste/#GET{liste},objet,id_Y_X,ajax,env} />
    avec #GETliste=rubrique qui va chercher le code dans prive/objets/liste/rubriques de la dist 3.2
    Je n’arrive pas à résoudre ce pb même en mettant id_Y_X=#ID_OBJET
    savez vous comment résoudre ce pb

    • ben

      Salut,

      J’espère qu’en un an, tu as pu trouver solution à ton problème mais comme j’ai galéré pas mal avec cette même difficulté, je précise ici ce que j’ai fais pour résoudre ce problème pour les futurs galérien·ne·s :

      Dans mon cas, les objets liés sont surtout des articles, j’ai donc recopié le fichier racine-du-site/prive/objets/liste/articles.html dans plugins/xyz/prive/objets/liste et j’ai ajouté à la boucle liste_art de ce fichier le critère spip_xyz_liens.id_xyz?

      La documentation du plugin mériterait d’être clarifiée à ce niveau (avec cet exemple ?), j’ai trouvé d’autres personnes qui ne l’ont pas comprises sur ce point.

    Reply to this message

  • 1
    baloo

    bonjour,
    juste pour info pour les néophytes , je teste le mode de saisie php avec avec fabrique-issue_8 ,
    dans “options de saisie” il y a comme exemple :
    Exemple pour selection / checkbox / radio :
    datas=[(#ARRAY{cle1,valeur1,cle2,valeur2})]
    ce qui correspond au mode html
    ... peut être faudrait il indiquer la syntaxe aussi en mode php car dans ce cas cela génére

    array(
                        'saisie' => 'radio',
                        'options' => array(
                                'nom' => 'menu_selections',
                                
                                'label' => _T('page:champ_menu_selections_label'),
                                 'explication' => _T('page:champ_menu_selections_explication'),
                                'datas' => '[(#ARRAY{oui',
                                'oui' => '',
                                'non' => '',
                                'non})]' => '',
                                
                        ),
                ),

    qui bien sur ne fonctionne pas.

    Reply to this message

  • 3
    baloo

    bonjour,
    Sauriez vous t ce qui peut empêcher la création des tables alors que la création du plugin s’est bien déroulé , le plugin activé, le cache vidé?
    les tables ont un format standard nom : spip_ensembles

    SPIP 3.3.0-dev [24578]
    merci

    • Matthieu Marcillaud

      Le [24578] m’inquiète : c’est une version SVN et on n’utilise plus ça. Soit il reste un fichier .svn_revision à la racine de ton SPIP. Soit y a un autre soucis.

      Ensuite, il faut regarder tmp/log/mysql ou sqlite pour savoir quelle est l’erreur de création de la table. Ça peut être du à une mauvaise syntaxe de déclaration.

    • baloo

      cela venait de la présence d’une cote de de trop dans text NOT NULL DEFAULT “”“” difficile à voir qui ne génère pas d’erreur. La cote enlevée cela fonctionne.
      C’est bon par contre a l’affichage de la partie ’Autorisations’ de l’objet le plugin affiche deux fois xxx_voir par défaut : toujours .

    • baloo

      autan pour moi ... ne cherche pas c’est objets _voir et objet_voir ....

    Reply to this message

  • BD

    Bonjour,

    Je suis en train d’utiliser ce super plugin pour créer un objet éditorial et je rencontre deux problèmes.

    Lors d’un test (le dernier) le plugin a fait planter le spip (en local, bien sûr) avec une page blanche. Impossible donc de désinstaller le plugin depuis la page d’admin. J’ai donc supprimer le dossier du plugin et ça refonctionne. Problème: plusieurs messages d’erreurs s’affichent alors.
    -  Le premier (sur la page d’admin des plugins) m’indiquant

    "Actions non réalisées

    Le plugin « XXX » (version : 1.0.0) va être installé

    Certaines actions n’ont pas été réalisées. Cela peut provenir d’une erreur lors des actions à réaliser, ou d’un affichage de cette page alors que des actions sont encore en cours. Les actions avaient été lancées par test le 28 août 2020 à 13h54min."

    -  Le second, sur toutes les pages d’admin, m’indiquant que les deux tables que devait créer le plugin n’existent pas (Erreur SQL 1146 par le squelette /spip/ecrire/genie/maintenance.php)

    La question est la suivante: comment désinstaller proprement un plugin manuellement. Quels sont les fichiers de conf à supp? Un script a lancer?

    J’ai testé ceci https://gist.github.com/Cerdic/5848603#file-site-desactive-plugin-php mais sans succès (les chemins et fichiers ne correspondent pas).

    Je peux repartir d’un spip tout frais mais il y avoir mieux, surtout si ça arrive lors du déploiement sur le site en ligne! :s Si quelqu’un saurait comment procéder?

    Autre soucis, déjà évoqué plus bas, sûrement accessoire mais peut-être pas étranger au crash du plugin: les boutons “pré-remplir cet objet” et “supprimer cet objet éditorial” ne sont pas fonctionnels.
    Je suis sous spip SPIP 3.2.7 [24473] avec la Fabrique 2.3.15

    Reply to this message

  • YannX

    Erreur inopinée !

    Si, comme moi, vous avez chargé une version récente de Fabrique et qu’au moment de sauvegarder votre plugin, vous vous prenez une “Erreur inopinée” ?
    Je vous suggère de vérifier la version de PHP que votre serveur utilise...
    -  en PHP 5.6 j’avais l’erreur (sans en comprendre la cause)
    -  en passant sous PHP 7.2... actualiser la page restée ouverte a suffit !

    P.S.: normal que cet outil de développeur utilise les dernières possibilités du langage ! ;-)

    Reply to this message

  • escurel

    Bonjour,
    si c’est pas encore fait, je confirme que dans un environnement windows 7 pro 64bits, avec wampserver 3.1.9 (apache 2.4.33, php 5.6.35 à 7.2.4, MySQL 5.7.21, spip 3.2.5) la fabrique (2.3.15) bloque sur la génération des fichiers avec les messages suivant
    -  si le dossier /plugins/fabrique_auto/ est présent : La sauvegarde de ../plugins/fabrique_auto/alloc n’a pu être réalisée. Le plugin par précaution n’a pas été régénéré. La cause probable provient de droits insufisants ce répertoire source pour le serveur. (avec une faute “insuffisants” dans la chaîne de langue)
    -  si le dossier est absent : vérifier les droits d’écriture
    Le système a rencontré une erreur lors de l’écriture du fichier tmp/cache/fabrique/alloc /.plat. Veuillez, en tant qu’administrateur du site, vérifier les droits d’écriture sur le répertoire ecrire/tmp/cache/fabrique/alloc .
    La même chose dans un environnement Unix/Linux y a pas de soucis (sauf la faute d’orthographe ;)
    cordialement

    Reply to this message

Add a comment

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite / PostgreSQL
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparait.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Who are you?
[Log in]

To show your avatar with your message, register it first on gravatar.com (free et painless) and don’t forget to indicate your Email addresse here.

Enter your comment here

This form accepts SPIP shortcuts {{bold}} {italic} -*list [text->url] <quote> <code> and HTML code <q> <del> <ins>. To create paragraphs, just leave empty lines.

Add a document

Follow the comments: RSS 2.0 | Atom