Caixa de Ferramentas do Desenvolvedor

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

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

Funcionalidades

Como funciona

O componente é projetado por padrão para ser discreto, então você aciona uma modal tocando no caractere de acento grave (crase) no seu teclado. Alternativamente, você pode habilitar um botão de gatilho na interface do usuário alternando uma configuração de tema.

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

Configurações

Nome Descrição
show header button Mostrar o gatilho para a caixa de ferramentas de desenvolvimento 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 caixa de ferramentas também fechará a modal da caixa de ferramentas.
custom links
Tradução Padrão
dev_utils.toggle_btn Dev 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 de Plugin
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 de 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