Formulaires de remplacement

[Discourse]

	Résumé	Les Formes de remplacement vous permettront de créer une documentation dynamique en générant un formulaire qui remplace toute occurrence d’un =MOTIF= dans votre publication par la valeur d’un champ de saisie textuelle ou sélectionnable.
	Aperçu	Aperçu sur Discourse Theme Creator
	Lien vers le dépôt	https://github.com/discourse/discourse-placeholder-theme-component
	Nouveau sur les thèmes Discourse ?	Guide du débutant pour utiliser les thèmes Discourse

Installer ce composant de thème

Comme il s’agit d’un #composant de thème #officiel maintenu par l’équipe Discourse, les demandes de Support, de bug, d’ux et de #fonctionnalité peuvent être soumises dans les catégories respectives ici sur Meta, et étiquetées avec le tag approprié du composant de thème. Cliquez sur un lien ci-dessous pour en démarrer un.

 Support  Bug  UX  Fonctionnalité

Fonctionnalités

Ajoutez des espaces réservés aux publications dans ce format :

[wrap=placeholder key=NAME description="Votre nom"][/wrap]
[wrap=placeholder key=COUNTRY default=US defaults=FR,DE,US,CN,AU,CA][/wrap]

Votre email : =NAME=-=COUNTRY=@example.com

Cela donnera le résultat suivant :

Ceci est utilisé dans la liste de diffusion

Votre email : =ZNAME=-=ZCOUNTRY=@example.com

Comme indiqué ci-dessus, le texte à l’intérieur de l’enveloppe sera utilisé comme longue description.

[wrap=placeholder key=NAME description="Votre nom"]
Ceci est utilisé dans la liste de diffusion
[/wrap]

Clés disponibles

• key : La clé qui doit être remplacée dans votre publication
• default/defaults : Valeur(s) par défaut
• description : Un texte d’espace réservé pour la saisie

Exemples

# créer un nouveau plugin
rails g plugin =PLUGIN_NAME=
cd plugins/=PLUGIN_NAME=

Set up file and image uploads to S3

So, you want to use S3 to handle image uploads? Here’s the definitive guide, but also see Configure an S3 compatible object storage provider for uploads to see how to configure your app.yml. S3 registration Head over to https://aws.amazon.com/free/ and click on [Create a Free Account] During the create account process, make sure you provide payment information, otherwise you won’t be able to use S3. There’s no registration fee, you will only be charged for what you use, if you exceed the AWS …

---

Nous l’utilisons pour créer des runbooks, des tutoriels et des modèles réutilisables (cela fonctionnera dans les blocs de code). Veuillez partager vos cas d’utilisation !

Paramètres

Traduction	Défaut
toolbar.builder	Ajouter un espace réservé
builder.errors.no_key	Une clé est requise.
builder.title	Ajouter un espace réservé
builder.insert	Insérer
builder.key.label	Clé
builder.key.description	La =Clé= à remplacer dans la publication.
builder.description.label	Description
builder.description.description	Description affichée sur la saisie sans valeur définie.
builder.values.label	Valeur(s) par défaut
builder.values.description	Valeur(s) optionnelle(s) pour votre espace réservé ; si plusieurs valeurs sont définies, une liste déroulante sera utilisée.

Hébergé par nous ? Les composants de thème sont disponibles pour utilisation sur nos plans Standard, Business et Enterprise.

[j.jaffeux (Joffrey Jaffeux)]

The big issue with math handling like this, is that you need to eval() and eval is unsafe, so you need to use some lib which provide a safe eval with a limited subset of the real eval. I’m unsure we want all this complexity for such a rare case.

[Benjamin_D (Benjamin Decotte)]

@joffreyjaffeux

Try combining this with the Reply Template theme component!

I tried ! and that would be a neat composer-preview-redux-in-OP kind of thing but.. I must be missing something, if I understand correctly the Reply Template component takes the raw and looks for “replacers”, but the Placeholder Forms component decorates the cooked?

What I’m trying to do is ease my users into adding some quizz Q&As in a topic, with minimal technical friction, clicks or even key strokes, :heavy-sigh:

[wrap=placeholder key="question" description="question"][/wrap]
[wrap=placeholder key="réponse" description="réponse"][/wrap]

[wrap=template key="template-spoiler" action="reply" tagsList="#qui, #quand, #où, #comment"]

## Question
=question=
### Réponse
[spoiler]
=réponse=
[/spoiler]
---
*Étiquette(s) ?*
[/wrap]

which gives

so far so good, but unfortunately, the placeholders =question= and =réponse= are kept in the composer when hitting the template button

[j.jaffeux (Joffrey Jaffeux)]

Yes I’m not sure what I was thinking when I wrote this… I probably had a different use case in mind, but can’t remember.

It can’t work this way for sure. I will think a little bit about this… Both theme components were experiments at the time and might deserve better treatment as people have been using it quite frequently.

[Benjamin_D (Benjamin Decotte)]

@j.jaffeux

I will think a little bit about this…

Thank you !

[Benjamin_D (Benjamin Decotte)]

I don’t know what’s cookin’ in the chef kitchen, but as I usually stuff myself with pistachios or whatnot while waiting, I managed to make it work (for my specific use of course as I’ve almost no idea of what I’m doing, but hey… )

Add 2 replacers

[j.jaffeux (Joffrey Jaffeux)]

Ideally I would like to be able to let admin define their own replacers, but eval is risky (and not even possible with a secure csp) so I’m not sure how I could achieve this…

[sewid (Sebastian)]

First of all - great and really helpful theme component.

But I think I found a bug. If I use a placeholder in a code snippet, that contains backticks (`), it is not working. An example is a SQL code snippet:

DELETE FROM `=TABLENAME=`
WHERE id NOT IN(
        SELECT
            id FROM (
                SELECT
                    id FROM `=TABLENAME=`
                ORDER BY
                    id DESC
                LIMIT 20
) subquery);

TABLENAME gets never replaced (if there is a TABLENAME placeholder).

[AquaL1te]

Ce serait génial si cela incluait également des conditions de type Jinja2. Ainsi, par exemple, quelqu’un pourrait créer une clé red et la mapper à l’icône , orange serait mappé à . Mais je peux m’en passer bien sûr, mais cela aurait été génial d’avoir ces conditions de test.

[maiki]

J’adore vraiment ce composant.

---

« Et vous vivez vraiment de la =NOUN_1= ? Quelle vie =ADJECTIVE_1= ! »

« J’en vis et j’en vis et j’en vis et j’en vis », dit =PERSON_1=. « C’est mon frère et ma sœur, et mes tantes, et mes =NOUN_2=, et ma nourriture et ma boisson, et mon (=ADJECTIVE_2=) =VERBING_1=. C’est ma =NOUN_3=, et je n’en veux pas d’autre. Ce qu’elle n’a pas ne vaut pas la peine d’être =VERBING_2=, et ce qu’elle ne sait pas ne vaut pas la peine d’être =VERBING_3=. Seigneur ! les =NOUNS_1= que nous avons eus ensemble ! Que ce soit en hiver ou en été, au printemps ou en automne, elle a toujours son =NOUN_4= et ses =NOUNS_2=. Quand les =NOUNS_3= sont là en février, et que mon =NOUN_4= et mon sous-sol débordent de =NOUN_5= qui ne me servent à rien, et que le =COLOR_1= =NOUN_6= coule devant ma meilleure fenêtre =NOUN_7= ; ou encore quand tout cela tombe =ADVERB_1= et montre des taches de =NOUN_8= qui sentent le =FOOD_1=, et que les =NOUNS_5= et les =NOUNS_6= obstruent les canaux, et que je peux =VERB_1= sur l’=MOISTURE= =NOUN_9= sur la plupart des =NOUN_10= et trouver de la =FOOD_2= fraîche à manger, et des choses =ADJECTIVE_3= que les gens ont laissées tomber des =NOUNS_7= ! »

---

Original tiré de la version Standard Ebooks de The Wind in the Willows, disponible en lecture en ligne (rechercher By it and with it).

[Don]

Bonjour

Merci pour ce composant Il correspond parfaitement à ce que j’essaie de réaliser actuellement. En fait, ma première pensée a été qu’il serait formidable s’il pouvait être combiné avec le composant Reply Template. Mais malheureusement, ce n’est pas possible, comme l’expliquent les messages précédents.

---

J’ai trouvé une solution de contournement pour l’utiliser comme modèle, cela fonctionne avec lien vers de nouveaux sujets et lien vers de nouveaux messages personnels.

Voici comment je l’ai fait :

1. Créez un formulaire de remplacement (pour rester simple, j’utilise l’exemple dans le message d’origine)

Votre email : =NAME=-=COUNTRY=@example.com

---

2. Créez un lien vers un nouveau sujet :
   J’ai configuré dans le lien :
3. catégorie
4. titre
5. corps

Si vous souhaitez ajouter des lignes vides, utilisez \ pour qu’elles ne cassent pas le lien ou pour les rendre invisibles, vous pouvez utiliser   qui ajoutera un espace dans la nouvelle ligne. Cela fera partie du modèle et créera une ligne vide,

<a href="https://meta.discourse.org/new-topic?category==CATEGORY=&title=This is a topic created by =NAME=&body=Hello :wave:
&nbsp;
This is a test topic... Let's see the placeholder form.
\
Your email: =NAME=-=COUNTRY=@example.com">Use template as new topic</a>

---

3. Créez un aperçu du sujet

Catégorie sélectionnée

=CATEGORY=

Titre du sujet

This is a topic created by =NAME=

Corps du sujet

Hello

This is a test topic… Let’s see the placeholder form.

Your email: =NAME=-=COUNTRY=@example.com

---

4. Créez un bouton “Utiliser le modèle comme nouveau sujet” (dans l’exemple ci-dessus, il s’agit d’un lien, vous pouvez en faire un bouton)

Créez un élément [wrap] à partir de ce texte. Cela le rend disponible pour le cibler avec CSS et le styliser. Je l’ajoute ci-dessous.

<a href="https://meta.discourse.org/new-topic?category==CATEGORY=&title=This is a topic created by =NAME=&body=Hello :wave:
&nbsp;
This is a test topic... Let's see the placeholder form.
\
Your email: =NAME=-=COUNTRY=@example.com">[wrap=template-button]Use template as new topic[/wrap]</a>

Stylisation de [wrap=template-button]
quelque chose comme

Common / CSS

[data-wrap="template-button"] {
  background: var(--tertiary);
  color: var(--secondary);
  border-radius: var(--d-button-border-radius);
  padding: 0.5em 0.65em;
  transition: background 0.25s;
  &:focus,
  &:hover {
    background: var(--tertiary-hover);
    color: var(--secondary);
  }
}

Le bouton modèle ressemblera à ceci

---

Démo

Use template as new topic

---

J’espère que ce petit tutoriel aidera ceux qui ont besoin de quelque chose de similaire

Modification : J’ai mis en place un sélecteur de catégorie qui permet de créer des sujets dans différentes catégories.

---

Voir la version brute de ce message…

[Lilly]

C’est incroyable Don, merci. Cela répond très bien à l’un de mes besoins

[jericson (Jon Ericson)]

Quelque chose à noter est que les blocs de code causent parfois des problèmes :

usermod -aG sudo =USERNAME=

Dans ce cas, highlight.js suppose qu’il s’agit de Java et convertit le bloc de code en :

  usermod -
  <span class="hljs-type">aG</span> 
  <span class="hljs-variable">sudo</span> 
  <span class="hljs-operator">=</span>
  USERNAME=

Je suis capable de le corriger en signalant qu’il s’agit en fait d’une commande shell :

    ```shell
    usermod -aG sudo =USERNAME=
    ```

Ce qui donne :

usermod -aG sudo =USERNAME=

Si tout le reste échoue, text empêche highlight.js de modifier les espaces réservés.

Une solution plus générale (que Meta Discourse doit utiliser) consiste à changer le paramètre langue de code par défaut de auto à plaintext ou quelque chose de similaire.

---

Ce n’est pas que cela importe beaucoup, mais utiliser java est un moyen d’éviter que l’espace réservé ne se développe lorsque vous voulez écrire sur les espaces réservés.

[putty (Derek Putnam)]

Pouvez-vous vérifier le lien de prévisualisation ? Il semble être cassé pour moi.

[NateDhaliwal]

C’est une fonctionnalité incroyable, et je peux en voir de nombreuses utilisations.
Cependant, dans notre réponse, est-il possible de masquer le =(nom)= jusqu’à ce que l’utilisateur commence à taper dans la zone de texte ? Je pense que les utilisateurs (surtout les nouveaux) pourraient ne pas comprendre son but, ou que cela ressemble à un formatage incorrect.

[JammyDodger]

@putty

Pouvez-vous vérifier le lien de prévisualisation ? Il semble être cassé pour moi.

Je pense que j’en ai un qui fonctionne à nouveau ( )

https://discourse.theme-creator.io/theme/Discourse/placeholder-forms

Je l’ai également ajouté à try.discourse.org pour que vous puissiez jouer plus concrètement avec.

[pfaffman (Jay Pfaffman)]

Peut-être pourriez-vous saisir une valeur par défaut qui s’affichera à la place.

[putty (Derek Putnam)]

Ça a marché ! Merci !

[bangarang]

Ce contournement ne semble plus fonctionner.

Existe-t-il d’autres options pour combiner reply-template et placeholder-forms ?

[tobiaseigen (Tobias Eigen) A scindé ce sujet ()]

4 messages ont été déplacées vers un nouveau sujet : Les liens ne fonctionnent pas dans les formulaires de remplacement