Como Integrar um Plugin Personalizado na Interface do Discourse

[Elizeo_Rocha]

Estou desenvolvendo um novo plugin para minha instância do Discourse. Embora o plugin em si esteja funcionando bem, estou tendo dificuldades em integrá-lo à interface do usuário do Discourse. Revisei a documentação disponível, mas algumas partes ainda não estão claras para mim. Como sou novo nisso, agradeceria muito um guia detalhado, passo a passo, sobre como adicionar o plugin à interface do usuário. Mesmo um exemplo simples (como uma “caixa amarela” destacada) seria muito útil para entender o processo.

Obrigado pela sua ajuda!

[merefield (Robert)]

@Elizeo_Rocha

adicione o plugin à interface do usuário

Isso é um pouco vago. Você pode ser mais específico? O que exatamente você quer adicionar à interface do usuário?

Você já deu uma olhada no código-fonte de Plugin existente para ver o que eles estão fazendo? (Este é um dos benefícios do código aberto)

[Elizeo_Rocha]

@merefield Basicamente, quero adicionar um plugin à minha instância do Discourse que exiba uma pequena caixa na minha página. Meu objetivo é entender como fazer isso, como um plugin que exibe ‘Olá, Mundo!’ em uma dessas áreas, para que eu possa criar algo mais complexo no futuro

[Arkshine]

Você precisaria usar um plugin outlet.

Using Plugin Outlet Connectors from a Theme or Plugin

Discourse includes hundreds of Plugin Outlets which can be used to inject new content or replace existing contend in the Discourse UI. ‘Outlet arguments’ are made available so that content can be customized based on the context. Choosing an outlet To find the name of a plugin outlet, search Discourse core for “<PluginOutlet”, or use the plugin outlet locations theme component. (e.g. topic-above-posts). Wrapper outlets Some outlets in core look like <PluginOutlet @name="foo" />. These allow you…

Uma ferramenta útil para descobrir a localização e o nome do plugin outlet:

Introducing Discourse developer toolbar

When running the latest version of Discourse core in a development environment, you’ll notice a new toolbar on the left-hand-side of the screen: [Developer Tools] This provides one-click access to commonly-needed developer tools. So far, we have: Plugin Outlet Debug This shows all plugin outlets, with tooltips showing realtime values of all of the available @outletArgs. This was inspired by the popular plugin outlet locations theme component, and the plugin before it. But un…

[Elizeo_Rocha]

Obrigado! Vou tentar e voltarei com meu feedback.

[Elizeo_Rocha]

Funcionou! Instalei a extensão Ember.js para Chrome e consegui localizar o PluginOutlet no meu site. Após seguir a documentação, tudo funcionou como esperado.

[pfaffman (Jay Pfaffman)]

Dê uma olhada também nestes componentes de tema Links Personalizados no Cabeçalho e Links Personalizados no Cabeçalho (ícones).

Se tudo o que você quer fazer é adicionar um botão, você não precisa de um plugin.

[Heliosurge (Dan DeMontmorency)]

Não se esqueça do seu TC

Custom Components -- add button or text at any plugin outlet

Summary Add button or text anywhere Repository https://github.com/literatecomputing/discourse-custom-components Install Guide How to install a theme or theme component New to Discourse Themes? Beginner’s guide to using Discourse Themes Install this theme component Add a link button or arbitrary text at any plugin outlet. (Ignore the watermarks in the images–I took these screenshots on a staging/test site.) …