Como parte do nosso projeto para atualizar o Discourse para a versão mais recente do Ember, trabalhamos em uma refatoração significativa das rotas de Descoberta (também conhecidas como ‘lista de tópicos’).
Este tópico é direcionado a desenvolvedores de temas/plugins e visa listar os tipos de atividades de temas/plugins que podem ser afetadas pela refatoração.
Contexto
Esta refatoração é necessária porque o Ember moderno não suporta mais ‘outlets nomeados’ como {{outlet \"topics\"}}, que usávamos extensivamente nessas rotas. Essencialmente, todos os controllers/templates que anteriormente eram renderizados em outlets nomeados foram convertidos em Componentes.
Ao longo do processo, aproveitamos a oportunidade para modernizar e consolidar o código relevante (por exemplo, todos os tipos de rotas de descoberta agora compartilham o mesmo controller e template).
A implementação da mudança no core ainda não está finalizada, mas um trabalho em andamento pode ser encontrado neste branch. Não temos uma data específica para a fusão, mas esperamos que ocorra nas próximas semanas. Se você tiver alguma dúvida ou preocupação, por favor, nos avise!
Quais atividades de temas/plugins são afetadas?
Esta refatoração afeta predominantemente a camada de ‘controller’. As rotas permanecem em grande parte inalteradas, e tudo a partir do componente <TopicList /> para baixo também não é afetado.
Esperamos que o único impacto seja em temas/plugins que acessam profundamente o código do core (por exemplo, via modifyClass e substituições de template). APIs e outlets definidos não são afetados.
Substituições de Template
Estes templates foram refatorados em componentes. Quaisquer substituições existentes deixarão de funcionar silenciosamente
navigation/categoriesnavigation/categorynavigation/defaultnavigation/filterdiscovery/topics
Estes templates foram extensivamente refatorados. Quaisquer substituições de template existentes provavelmente causarão erros catastróficos no site.
discoverytag/showuser-topics-listuser/messagesdiscovery/categoriescomponents/basic-topic-listcomponents/d-navigation
Tecnicamente, é possível substituir os novos templates introduzidos por esta mudança. No entanto, substituições de template não são recomendadas e estão sendo descontinuadas.
Portanto, todas as substituições de template devem ser removidas e substituídas por APIs de extensão mais robustas (por exemplo, plugin outlets). Se houver algo que você esteja fazendo que não pareça possível com os pontos de extensão existentes do Discourse, por favor, nos avise!
Chamadas modifyClass e lookup()
Estas classes não existem mais. modifyClass deixará de funcionar silenciosamente. Lookups retornarão null (e, portanto, podem levar a erros). Nos casos mais populares, introduzimos shims para retrocompatibilidade (veja notas de rodapé)
controller:discoverycontroller:discovery/topics[1]controller:discovery-sortable(->controller:discovery/list)controller:discovery-filter(->controller:discovery/filter)controller:navigation/categoriescontroller:navigation/category[2]controller:navigation/defaultcontroller:tag/show[3]controller:discovery.*(->controller:discovery/list)
Estas classes passaram por uma refatoração significativa. Chamadas modifyClass e lookup podem exigir refatoração:
route/discoveryroute/discovery.*route/tag-show
Rotas
Nomes de rotas (ou seja, router.currentRouteName) não foram alterados
Hooks model() da rota de descoberta (ou seja, router.currentRoute.attributes) permanecem em grande parte inalterados
Plugin Outlets
Todos os plugin outlets e seus argumentos não foram alterados.
HTML / CSS
A estrutura HTML e as classes são em grande parte inalteradas