Plugin Insérer Modèles

Ce plugin fournit une aide à l’insertion des modèles dans vos textes à travers des formulaires de saisies. Ces formulaires sont accessibles dans la colonne de droite ou via un bouton dans le porte-plume.

Formulaires d’insertion dans la colonne latérale

Sur les pages d’édition des articles, des rubriques, des brèves et des mots-clés, le formulaire ci-dessous est affiché dans la colonne latérale. Son contenu est fonction des plugins et modèles installés sur votre site.

Encart d’insertion

Sélectionnez le modèle que vous souhaitez insérer et remplissez le formulaire.

Cliquez sur Insérer : l’appel du modèle est alors calculé et intégré à l’emplacement courant dans le texte.

Remarque : la liste des modèles proposés dépend des plugins installés sur votre site. En effet, charge à chaque plugin de déclarer à Insérer Modèles les modèles qu’il propose (cf. Comment déclarer un modèle pour le plugin « Insérer Modèles »). Si aucun plugin actif ne déclare de modèle à insérer, alors le formulaire d’Insérer modèles n’est pas affiché.

Exemples de plugins déclarant des modèles à Insérer modèles :
-  Plugin Modèles media,
-  Formidable, le générateur de formulaires,
-  Cite : des modèles pour les références bibliographiques,
-  Modèle exergue

Votre squelette ou plugin peut également déclarer ses modeles pour que Insérer modèles les propose. Pour cela, suivez les instructions dans la dernière partie de cet article.

Utilisation avec le porte-plume

Si le porte-plume est activé, un bouton pour l’insertion des modèles sera ajouté au porte-plume.

Positionnez le curseur à l’endroit du texte où vous souhaitez insérer le modèle puis cliquez sur le bouton en forme de pièce de puzzle, vous ferez apparaître une
fenêtre vous permettant de choisir le type de modèle que vous souhaitez insérer.

Il est également possible de choisir directement le type de modèle que vous souhaitez insérer via les boutons (sous-menu) qui apparaissent au survol avec la souris du bouton principal.

Remplissez le formulaire.

Insérer un modèle via la barre typographique

Lorsque vous cliquez sur Insérer, l’appel du modèle est calculé et automatiquement inséré à l’endroit où ce situait votre curseur dans le texte.

Page de configuration du plugin

La page de configuration du plugin permet :
-  de lister les pages d’édition où utiliser le plugin ;
-  de désactiver certains modèles, depuis la version 2 du plugin [1].

Formulaire de configuration du plugin

Déclarer des modèles à Insérer Modèles

Le plugin Insérer Modèles proposera à l’insertion tous les fichiers YAML trouvés dans un sous-répertoire modeles/ de plugins actifs. Ces fichiers permettent de décrire le formulaire d’insertion du ou des modèles concernés.

Pour plus de détails, voir Comment déclarer un modèle pour le plugin « Insérer Modèles ».

Notes

[1À noter que pour les dev, il est également possible de désactiver certains modèles via un pipeline.

Discussion

32 discussions

  • 2

    Bonjour,
    Pourriez vous fournir avec le plugin 2/3 fichiers yaml, afin d’avoir des exemples parlant (j’essaies d’adapter celui de formidable, mais c’est coton)...

    A bientôt
    Sam

    • Bonjour,

      vous pouvez trouver un exemple de fichier YAML dans le plugin cite en cours de développement (http://zone.spip.org/trac/spip-zone...) ou bien encore (mais il s’agit d’un exemple plus complexe avec des saisies personnalisées et un traitement particulier) dans le plugin modeles_media (http://zone.spip.org/trac/spip-zone...).

      Réaliser un formulaire d’insertion de modèle est relativement simple si on a bien compris le fonctionnement du plugin Saisies et la description YAML d’un tableau de saisies.

      Je vous invite donc à bien lire les documents suivants : Saisies et Saisies : Doc complémentaire.

      Par ailleurs, n’hésitez pas à poster ici la syntaxe de votre modèle (un ou plusieurs exemples d’appel). Je pourrai alors vous aider pour créer le fichier YAML correspondant.

      Bien cordialement

    • Merci beaucoup pour ces liens, ils m’ont beaucoup aidés.
      Le soucis est aussi que codant avec Espresso sous mac, il m’a fallut un moment pour comprendre qu’il ne faut pas de tabulation, et bien identer les items.
      Ceci dit, une fois compris, c’est du velour...
      Je reste un peu près sur qu’un petit dossier demo, avec 1 ou 2 coupes modele.html/modele.yaml serait super (même si on peu trouver pas mal de doc de par ailleurs).

      Merci encore pour votre réponse rapide, et ce super plugin.

      Sam

    Répondre à ce message

  • Excellente initiative, ce plugin !! Je testerai ça.

    Répondre à ce message

Ajouter un commentaire

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
  • 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 apparaît.

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.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom