Índice de Guias para Desenvolvedores

[Discourse]

Documentação sobre como estender o Discourse com plugins, temas e componentes de tema, trabalhar com o código principal e usar a API do Discourse.

Introdução

• Introdução: Introdução ao Desenvolvimento do Discourse

Ambientes de Desenvolvimento

• Dev Container: Desenvolvendo o Discourse usando um Dev Container
• GitHub Codespaces: Desenvolvendo o Discourse no GitHub Codespaces
• Configuração Docker: Instale o Discourse para desenvolvimento usando o Docker
• Configuração macOS: Instale o Discourse no macOS para desenvolvimento
• Configuração Ubuntu/Debian: Instale o Discourse no Ubuntu ou Debian para Desenvolvimento
• Configuração Windows: Instale o Discourse no Windows para desenvolvimento
• Plugins não-Docker: Instale plugins em seu ambiente de desenvolvimento não-Docker
• Configuração local: Configurar um Ambiente de Desenvolvimento Discourse Local?
• Configuração multi-site: Configurar um ambiente de desenvolvimento multi-site
• Configuração Fedora: Configure o Discourse para desenvolvimento no Fedora Linux

Código e Internos

• Componentes Ember: Adicionar Componentes Ember ao Discourse
• Lint e formatar: Lint e formatar código automaticamente antes dos commits
• Testes de aceitação: Escrever testes de aceitação e testes de componentes para código Ember no Discourse
• Executar suítes de teste: Como executar suítes de teste QUnit do núcleo, plugin e tema do Discourse
• Compatibilidade de versão: Fixar versões de plugin e tema para instalações Discourse mais antigas (.discourse-compatibility)
• Propriedade de objeto Ember: Propriedade de objeto Ember (getOwner, injeções de serviço, etc.)
• Desempenho JS: Usando o ‘tachometer’ do Google para medir mudanças de desempenho JS no Discourse
• CI com GitHub Actions: Configurar Integração Contínua usando GitHub Actions
• Extensões Markdown: Guia do desenvolvedor para extensões Markdown
• Convertendo modais: Convertendo modais de controladores legados para a nova API de componente DModal
• API DModal: Usando a API DModal para renderizar janelas Modais (aka popups/diálogos) no Discourse
• API JS: Usando a API JS
• Conectores de saída de plugin: Usando Conectores de Saída de Plugin de um Tema ou Plugin
• modifyClass: Usando modifyClass para alterar o comportamento do núcleo
• Criando rotas: Criando Rotas no Discourse e Exibindo Dados
• Método de autenticação: Adicionando um novo método de autenticação ‘gerenciado’ ao Discourse
• Serialização acidental de modelos ActiveRecord: Prevenindo a serialização acidental de modelos ActiveRecord
• Substituindo templates: (não recomendado) Substituindo templates do Discourse de um Tema ou Plugin
• Objetos de serviço: Usando objetos de serviço no Discourse
• Especificações do sistema: Escrever especificações de sistema end-to-end para a interface do usuário do Discourse
• FormKit: Kit de ferramentas Discourse para renderizar formulários.
• AppEvents Triggers: Referência de AppEvents Triggers
• Transformers: Usando Transformers para customizar valores e comportamento do lado do cliente
• Customização da Lista de Tópicos: Customizando a lista de tópicos
• Diretrizes de CSS: Diretrizes para classes CSS usando BEM
• Projetando para Dispositivos: Projetando para Diferentes Dispositivos (Tamanho da Viewport, Toque/Hover, etc.)

Plugins

• Plugin básico: Desenvolvendo Plugins Discourse - Parte 1 - Crie um plugin básico
• Saída do plugin: Desenvolvendo Plugins Discourse - Parte 2 - Conecte-se a uma saída de plugin
• Configurações do site: Desenvolvendo Plugins Discourse - Parte 3 - Adicione configurações personalizadas do site
• Configuração do Git: Desenvolvendo Plugins Discourse - Parte 4 - Configurar o git
• Interface de administrador: Desenvolvendo Plugins Discourse - Parte 5 - Adicione uma interface de administrador
• Testes de aceitação: Desenvolvendo Plugins Discourse - Parte 6 - Adicionar testes de aceitação
• Publique seu plugin: Desenvolvendo Plugins Discourse - Parte 7 - Publique seu plugin
• Novos locais: Adicione um novo local do plugin
• Integração de bate-papo: Adicione um novo provedor à integração de bate-papo do discourse
• Extensão markdown-it: Reempacotando uma extensão markdown-it como um plugin Discourse
• Autocarregamento do Rails: Estruturando um plugin para autocarregamento do Rails

Temas e componentes

• …

[pfaffman (Jay Pfaffman)]

Existe um comando que faz algumas perguntas e cria um esqueleto de plugin. Há um tópico descrevendo-o, e eu postei várias vezes nesse tópico. Não consigo encontrá-lo aqui. Não consigo encontrá-lo em Developing Discourse Themes & Theme Components. Mas, realmente, não consigo encontrá-lo em lugar nenhum.

Talvez GitHub - discourse/discourse-plugin-skeleton: Template for Discourse plugins tenha um README que diga como executar esse comando (mas então ele teria que apagar tudo isso quando criasse o plugin esqueleto - um problema de ovo e galinha, com certeza).

Theme Developer Quick Reference Guide vincula ao criador de temas, então esse está respondido.

EDIT: Encontrei!! Automating Discourse Plugin Setup with `create-discourse-plugin` gem

@JammyDodger

procura uma maneira de bloquear tópicos contra acessos não autorizados do TL4…

Opa. Desculpe.

Acho que o treinamento do usuário é a resposta. Tentarei notar. Mas também, um componente de tema que substituísse responder por responder-como-tópico-vinculado poderia ser uma boa ideia.

Mas, de qualquer forma, por favor, adicione o link mencionado (ou apenas mencione a tarefa rake?) aqui e exclua isso.

[JammyDodger]

procura uma maneira de bloquear tópicos contra acessos rápidos de TL4…

Mas é este aqui no Community wiki?

Automating Discourse Plugin Setup with `create-discourse-plugin` gem

This plugin is now bundled with Discourse core. There is no need to use this gem. To create a new plugin, use: rake plugin:create[plugin-name] Since I started developing discourse plugins, I felt the overall setup could be more straightforward. We should have a better overall developer experience when creating a plugin. In that spirit, I’ve created in my free time this gem called create-discourse-plugin What does it do? It clones and creates a copy of the discourse-plugin-skeleton …