Caixa de Ferramentas do Desenvolvedor

:discourse2: Resumo Developer Toolbox oferece acesso rápido a links, ações e configurações comuns frequentemente utilizados ao desenvolver com o Discourse.
:hammer_and_wrench: Link do Repositório https://github.com/discourse/discourse-dev-utils
:open_book: Novo nos Temas do Discourse? Guia para iniciantes sobre o uso de Temas do Discourse

:information_source: Apenas para desenvolvimento local. Não é útil para sites em produção

Recursos

Como funciona

O componente é projetado, por padrão, para ser discreto, então você aciona um modal tocando no caractere de barra grave ` no seu teclado. Alternativamente, você pode habilitar um botão de acionamento na interface alternando uma configuração do tema.

Uma vez que o modal aparece, você tem acesso a algumas ações, links e configurações comuns que normalmente precisaria ao desenvolver com o Discourse.

Configurações

Nome Descrição
show header button Mostrar o acionador do dev toolbox no painel do cabeçalho
remove button from flow Fixa o botão do cabeçalho no canto inferior direito. (Requer que show_header_button esteja habilitado)
actions close modal Acionar uma ação na toolbox também fechará o modal da toolbox.
custom links
Tradução Padrão
dev_utils.toggle_btn Developer Toolbox
dev_utils.modal.title Developer Toolbox
dev_utils.modal.cancel Cancelar
dev_utils.actions.title Ações Rápidas
dev_utils.actions.toggle_alerts Alternar Alertas
dev_utils.actions.toggle_plugin_outlets Alternar Saídas
dev_utils.links.title Links Rápidos
dev_utils.links.themes Temas
dev_utils.links.components Componentes de Tema
dev_utils.links.colors Cores
dev_utils.links.settings Configurações
dev_utils.links.plugins Plugins
dev_utils.links.user_prefs Preferências do Usuário
dev_utils.links.text Texto
dev_utils.links.plugin_api API do Plugin
dev_utils.links.docs Documentação do Discourse
dev_utils.common_settings.title Configurações Comuns
dev_utils.common_settings.none Selecione uma configuração
42 curtidas

Obrigado por este ótimo componente, Keegan!

No momento, o ícone do cabeçalho sempre é exibido. Uma pequena melhoria seria exibi-lo apenas para administradores. Assim, ao navegar pelo site como um usuário comum, a aparência não é alterada.

5 curtidas

Eu gosto bastante deste componente. Obrigado! :slight_smile: :+1:

Notei agora que o botão Discourse Docs leva para o link da API de Plugins em vez da documentação.

2 curtidas

Obrigado por identificar isso, @Lilly. Fiz uma atualização resolvendo isso:

Obrigado pela solicitação, @manuel. Adicionei isso agora:

3 curtidas

Isso parece muito bom – preciso identificar todas as tomadas, mas tanto \u003ckbd\u003eAlternar Tomadas\u003c/kbd\u003e quanto \u003ckbd\u003eAlternar Alertas\u003c/kbd\u003e parecem não fazer nada além de fechar a janela modal.

Eles deveriam exibir/mostrar ou destacar algo na tela quando ativados?

1 curtida

Adicionar/instalar este componente de tema além do Developer Toolbox faz com que o botão Toggle Outlets funcione…

2 curtidas

O link da API de Plugins não está abrindo o arquivo. Parece que ele precisa ser atualizado para app/assets/javascripts/discourse/app/lib/plugin-api.gjs?

2 curtidas

Obrigado, fiz o PR :+1:

3 curtidas

Obrigado @Arkshine pela correção, eu a incorporei :tada:

Também adicionei algumas atualizações (correções/modernizações), bem como um novo recurso onde você agora pode adicionar links personalizados definindo-os na configuração do tema:

3 curtidas

Podemos enviar a tradução para este componente no Crowdin? Não encontrei a entrada para ele.

1 curtida

Olá @th21, obrigado por nos informar. Adicionei como um projeto de tradução no Crowdin.

3 curtidas

Qual é o resultado esperado de “Alternar Alertas”? clicado e nada aconteceu

1 curtida

Destina-se a ocultar quaisquer alertas que você tenha em sua instância do Discourse. Se você tiver algum alerta em seu fórum como este:

Ele o ocultará da página. É bastante útil, por exemplo, ao aplicar temas e você deseja ver temporariamente a página sem nenhum alerta.

2 curtidas