Trechos de texto/markdown inseríveis, centralmente mantidos

Wiki da comunidade Desenvolvedores
1

Eu estava me perguntando se havia alguma maneira de definir um texto em um único local e inseri-lo nos posts com uma única referência curta.

É um pouco como a opção padrão Admin -> Personalizar -> Conteúdo de Texto, mas para minhas próprias variáveis personalizadas que podem ser inseridas nos posts.

Meu caso de uso era adicionar um aviso legal para meus links de afiliado. À medida que o número de links de afiliado crescia em vários posts e Tópicos, notei que meus avisos legais também se proliferavam junto com eles. Ocasionalmente, gosto de fazer melhorias nos avisos legais e isso se torna mais trabalhoso à medida que o número cresce.

Também estou considerando tornar meus links de afiliado mais genéricos, para que eu tenha um link centralmente gerenciado para cada link de produto, por exemplo, que aparece em vários lugares. Se esse link de produto mudar, preciso alterá-lo apenas em um lugar.

Obviamente, eu poderia fazer algum tipo de pesquisa e substituição no Rails, mas isso não é tão limpo/seguro nem ‘online’.

Então, eu queria um local para definir e manter uma string de texto em um único lugar e ter as alterações refletidas imediatamente em todos os lugares onde é usada na próxima visualização da página.

Leia mais para a solução de @Johani!:

3 curtidas
Developer Index
2

Uma opção possível é usar um componente de tema.

Isso deve ser colocado em header.html

<script type="text/discourse-plugin" version="0.8">
var disclaimer = settings.Disclaimer_text,
  disclaimer_selector = 'div[data-theme="disclaimer"]';

$.fn.disclaimer = function() {
  if (!this.length) {
    return;
  } else {
    this.each(function() {
      $(this).html(disclaimer);
    });
    return this;
  }
};

api.decorateCooked($elem => $elem.children(disclaimer_selector).disclaimer());

// criar botão no compositor
let currentLocale = I18n.currentLocale();

I18n.translations[currentLocale].js.disclaimer_button = "Adicionar aviso";
I18n.translations[currentLocale].js.composer.disclaimer_prompt = ""; // deixar vazio

api.onToolbarCreate(function(toolbar) {
  toolbar.addButton({
    trimLeading: true,
    id: "disclaimer-button",
    group: "insertions",
    icon: "exclamation-circle", // alterar ícone
    title: "disclaimer_button",
    perform: function(e) {
      return e.applySurround(
        '<div data-theme="disclaimer">',
        "</div>",
        "disclaimer_prompt"
      );
    }
  });
});
</script>

e isso deve ser colocado no arquivo settings.yml do seu componente

Disclaimer_text:
  default: "Lorem ipsum dolor sit amet, ei purto complectitur has, per at quas senserit. Et malis libris eos, vix id pericula dissentiet, aliquid apeirian pro eu. Sed ex viderer inciderint, vitae officiis dissentiet eos no. Omnes percipit singulis in has, ne nam nibh tation inciderint. Quas nulla ei sit, ex eam rebum voluptaria. Id eam altera similique. Ex justo assentior persequeris mea, ei hinc paulo ubique mei. <br><br>Cu nam epicurei torquatos, et accusam accommodare vim. Vis sint saperet officiis et. Ad consequat posidonium mea, et duo paulo quidam maluisset, vel an electram expetendis. An vis repudiare tincidunt, mentitum convenire eloquentiam ut vis, summo partiendo pro ad."
  description:
    en: Insira o texto do aviso desejado. Use &lt;br&gt; para quebras de linha.

Assim, você terá um botão no compositor que se parece com isto:

1
1906×1002 20.9 KB

e ao clicar no botão, será adicionado

<div data-theme="disclaimer"></div>

o que será convertido para o que você configurou nas definições do componente

1
1980×191 10.2 KB

e o resultado final ficará assim

1
11788×556 55.5 KB

e você pode usar

[data-theme="disclaimer"] {

}

no CSS para estilizar como preferir.

21 curtidas
How to have common content shared between pages?
Discourse Chatbot :robot:
3

That’s awesome! Thanks @Johani

Added to Tips’n’Tricks.

2 curtidas
4

Hi @merefield - funnily enough I was looking for similar functionality - inserting a standard snippet of text - but rather than a button I wanted a trigger string that would expand out to a piece of markdown. (OK, I suppose alternatively I could modify the button to a dropdown with a few options)

This is probably not a core Discourse feature but a plugin.

Ideal behaviour:

  • I type :stub: (I don’t mind about using something instead of the delimiting : characters, but wondered if hooking into the emoji interface might work since that has the kind of ‘completion’ type behaviour that I’d like)

  • Discourse replaces :stub: with

    > This article is a stub - please improve it by  **editing**  and  **adding links**  and  **detail**  (it’s a ‘wiki’ so any user can edit and add information) or by  **commenting**  below.

  • which is rendered as

    This article is a stub - please improve it by editing and adding links and detail (it’s a ‘wiki’ so any user can edit and add information) or by commenting below

  • and there should be somewhere in the UI to configure these snippets, a bit like the Custom Emoji interface

5 curtidas
5

Great idea for a plugin! Would you be ok for the text to appear only in the preview and the final cooked view?

4 curtidas
6

A sugestão de @pacharanero seria fantástica para nós também. No nosso caso, seria apenas para funcionários, então não gostaríamos que nada fosse exibido na barra de ferramentas do editor, mas inserir um código curto para inserir o bloco de atualização automática seria incrível :+1:

1 curtida
7

Por enquanto, uma forma não-Discourse e não-gerenciada centralmente de obter esse comportamento hoje é usar um gerenciador de área de transferência multiplataforma como o CopyQ e configurar a seção ‘Comandos/Atalhos Globais’ para que você possa inserir texto arbitrário na área de transferência.

Esses trechos podem então ser gerenciados na interface do CopyQ, atribuídos a uma tecla de atalho ou aparecer no menu de contexto do CopyQ. Não é tão bom quanto um plugin incorporado ao Discourse, mas tem a vantagem de funcionar em todos os aplicativos e já existe!

(Observe que isso teria que ser configurado em cada um dos computadores que você gostaria de usar dessa forma. Você pode exportar e importar esses comandos e atalhos globais para um arquivo, para permitir a configuração das mesmas configurações em várias máquinas ou em uma equipe)

8

Isso estaria absolutamente bem para mim. Acho que, ao contrário de DiscoTOC e Placeholders, ele precisaria ser renderizado corretamente no painel de visualização, mas no compositor ele poderia simplesmente mostrar qualquer frase de gatilho :slug: que fosse escolhida.

9

Obrigado pela resposta. A solução do CopyQ não faz o que eu procuro (acho que não, pelo menos).

Por exemplo, eu gostaria de inserir um trecho em uma postagem (por exemplo, :slug:) e, em seguida, sempre que isso for renderizado, ele renderiza o conteúdo atual para este slug (que pode conter markdown). Se eu alterar o conteúdo deste slug, todas as postagens que o utilizam seriam imediatamente atualizadas para ter o novo conteúdo (a postagem em si contém apenas o slug e o conteúdo é inserido na renderização).

Eu ficaria satisfeito se a busca não soubesse que o conteúdo existe também (e apenas mostrar a versão final processada é bom para mim).

Abraços

10

Aqui está uma abordagem diferente…

1 curtida