Antes: Como Criar um Evento?
Importar um modelo predefinido para um evento faz-se selecionando um ou mais modelos predefinidos no modal da biblioteca Adicionar modelos, aberto com o botão "Adicionar mais" na página Templates (Modelos), e premindo "Adicionar". No código REAL, esta é a ÚNICA via de importação disponível para o utilizador (adicionar a partir da biblioteca predefinida). Embora na base de código estejam definidos métodos de importação a partir de um ficheiro (.aktemplate) (TemplateFileService.ImportFromFileAsync/ExportToFileAsync) e um carregador de modelos empacotados (LoadBundledTemplateJsonAsync), NENHUMA interface os invoca, ou seja, a funcionalidade de importação a partir de ficheiro atualmente NÃO EXISTE na interface.
- O utilizador tem de ter sessão iniciada e um evento selecionado, se currentEventInfo for null, AddTemplateToCurrentEvent falha silenciosamente (RepositoryResponse.Success=false).
- A biblioteca (AllLocalPhotoTemplates / AllLocalVídeoGifTemplates) tem de conter modelos predefinidos; esta lista é preenchida a partir do servidor/CloudSync e dos modelos por omissão e, se estiver vazia, o modal mostra Ainda não há modelos.
Passo a passo
Passo 1 · Abrir a página de modelos
Settings → Templates (/templates)
A partir das Definições, aceda à página Modelos (Templates). A página abre na rota /templates e, no topo, aparecem dois separadores (Foto, Video & GIF) e a secção Modelos ativos.
🔎 Elementos no ecrã: Separadores: Foto, Video & GIF; título Modelos ativos + emblema de contador

Passo 2 · Selecionar o separador correto
Templates (/templates) → barra de separadores
Selecione o separador de acordo com o tipo de modelo que vai importar: Foto para saída de fotografia, Video & GIF para saída de vídeo/GIF. O separador selecionado determina a lista da biblioteca (foto vs vídeo) apresentada no modal.
🔎 Elementos no ecrã: separador Foto, separador Video & GIF
Passo 3 · Premir o botão Adicionar mais
Templates (/templates) → ações do cabeçalho da secção
Clique no botão Adicionar mais à direita do cabeçalho da secção. Isto invoca OpenBrowseModal() no VM do editor e abre o modal da biblioteca 'Adicionar modelos' (biblioteca de fotos a partir do separador de foto, biblioteca de vídeos a partir do separador de vídeo).
🔎 Elementos no ecrã: botão Adicionar mais (btn-outline); ao lado, botão Criar novo (roxo)
Passo 4 · Explorar o modal da biblioteca Adicionar modelos
BrowseLibraryModal, modal Adicionar modelos
No modal Adicionar modelos que se abre, examine os cartões dos modelos predefinidos. Os cartões surgem numa disposição masonry e, ao deslocar para baixo, carregam-se mais em páginas de 30 (scroll infinito). Os modelos já adicionados ao evento apresentam o emblema Adicionado e não podem ser selecionados. No topo do modal há dois separadores (3.3.0 e posteriores): Os meus modelos (a sua própria biblioteca; o modal abre sempre neste separador) e Modelos do editor (o catálogo de modelos do editor prontos a usar). Para encontrar cartões, pode escrever um nome na caixa Pesquisar por nome ou escolher um tipo de camada no menu Todos os tipos de camada para mostrar apenas os modelos que contêm essa camada (3.4.1 e posteriores; os dois filtros funcionam em conjunto e aplicam-se ao separador aberto).
🔎 Elementos no ecrã: título do modal Adicionar modelos, subtítulo Selecione os modelos para adicionar; separadores Os meus modelos / Modelos do editor (ao lado, o número de modelos ou o contador de importação); caixa Pesquisar por nome e menu Todos os tipos de camada; caixa de seleção nos cartões e emblema Adicionado; em cada cartão, o nome + formato (OutputSize.DisplayName); se nada corresponder ao filtro, Nenhum resultado encontrado

Passo 5 · Selecionar um ou mais modelos
BrowseLibraryModal, grelha de cartões
Clique no(s) cartão(ões) do(s) modelo(s) que pretende adicionar. Cada clique ativa/desativa a seleção do cartão (a caixa de seleção fica roxa). Os cartões com Adicionado não podem ser clicados (são ignorados em OnCardClick). O número no botão Adicionar em baixo mostra apenas a quantidade de cartões selecionados ainda não adicionados.
🔎 Elementos no ecrã: caixa de seleção roxa no cartão (browse-selected), botão 'Adicionar (N)' no rodapé

Passo 6 · Importar para o evento com o botão Adicionar
BrowseLibraryModal, rodapé
Prima o botão 'Adicionar (N)' no rodapé. Para cada modelo selecionado, é invocado AddTemplateToCurrentEvent(templateLocalId); isto cria um junction (TemplateEventJunction) entre o modelo e o evento atual e associa o modelo ao evento. A seleção é limpa e o modal fecha-se.
🔎 Elementos no ecrã: botão 'Adicionar (N)' (btn-update-now); botão Cancelar; à esquerda, botão vermelho 'Eliminar (N)'
Passo 7 · (Passo intermédio) Popup de sugestão para ativar o modo
Diálogo de confirmação (BlazorUserDialogService)
Se o modo de saída do modelo adicionado (Foto/GIF/Vídeo) estiver desativado no evento, depois de o modal fechar surge o popup de confirmação 'ativar o modo?' (TemplateModeSuggestionService.CheckAndOfferAsync). Se responder 'Sim', a definição correspondente (por ex. PhotoOutputFormatActive / GifOutputFormatActive / VídeoOutputFormatActive) é ativada; se responder Não, nada muda. Um modelo de foto com vários fotogramas (2+) pode também sugerir o modo GIF.
🔎 Elementos no ecrã: título do diálogo de informação (por ex. 'EnableGifModeTitle'), botões Sim / Não

Passo 8 · O modelo adicionado aparece na grelha Modelos ativos
Templates (/templates) → grelha de Modelos ativos
O modal fecha-se e o(s) modelo(s) selecionado(s) surge(m) na grelha Modelos ativos do separador. Se o pull/sincronização ainda estiver em curso, o indicador 'Importando...' e um contador X/Y aparecem no título; quando estiver pronto, o cartão fica totalmente visível.
🔎 Elementos no ecrã: emblema de contador (X/Y) no título + etiqueta Importando...; novo cartão de modelo na grelha

Passo 9 · Editar o modelo (opcional)
grelha de Templates → ações de GalleryItemCard / TemplateEditor (/templateeditor)
Na grelha Modelos ativos, passe o cursor sobre um cartão e clique no ícone Editar (lápis) ou diretamente no cartão → é invocado LoadTemplateForEditing e passa-se para /templateeditor. Se o modelo estiver 'pristine' (gerado por omissão/pelo assistente, nunca modificado), tem o emblema 'Bloqueado' e a edição cria, na verdade, uma cópia (tooltip Clonar e editar): a cópia é criada na primeira alteração e, neste evento, ocupa o lugar do cartão bloqueado na mesma posição; o original do modelo predefinido não é alterado. Nos modelos modificados, é diretamente Editar e a alteração é gravada no mesmo modelo. O cartão dispõe ainda das ações Duplicar e Remover.
🔎 Elementos no ecrã: Ações do cartão: Clonar e editar / Editar, Duplicar, Remover, mover (arrastar); emblema Bloqueado

Passo 10 · (Não é uma importação alternativa) Criar de raiz
Templates (/templates) → assistente CreateNewTemplateModal
Em vez da importação a partir da biblioteca, o botão Criar novo abre um assistente (CreateNewTemplateModal: tipo → modelo do editor → formato → disposição → estilo) e produz o modelo de raiz. Isto NÃO é uma importação, mas sim o fluxo de criação de um novo modelo; é distinto da importação a partir da biblioteca predefinida. No passo 2 do assistente (Começar a partir de um modelo do editor, 3.4.1 e posteriores), também pode copiar um modelo do editor com Duplicar e continuar e começar a editá-lo diretamente.
🔎 Elementos no ecrã: botão Criar novo; passos do assistente (Tipo/Modelo do editor/Formato/Disposição/Estilo)
O modal permite seleção múltipla: pode marcar vários cartões e importá-los em lote com um único Adicionar.
O número no botão 'Adicionar (N)' conta apenas os cartões selecionados ainda não adicionados (sem o emblema Adicionado); um cartão já adicionado não pode ser selecionado.
No mesmo modal, com o botão vermelho 'Eliminar (N)' no canto inferior esquerdo, pode eliminar completamente os modelos selecionados da biblioteca (junction do evento + registo da biblioteca), isto pede um diálogo de confirmação.
Uma cópia do modelo que adiciona a partir do separador Modelos do editor é adicionada a Os meus modelos e ao evento; o original do modelo predefinido não é alterado. Neste separador não existe o botão Excluir: os modelos do catálogo do editor não podem ser eliminados.
Editar um modelo predefinido pristine (Bloqueado) não danifica o original; cria automaticamente uma cópia e edita-a (Clonar e editar).
Depois de adicionar um modelo, se o modo de saída estiver desativado, responder Sim à sugestão 'ativar o modo?' ativa de imediato o respetivo interruptor no ecrã de boas-vindas do quiosque e na página de definições Mode.
Esperar uma importação a partir de ficheiro (.aktemplate): o código (TemplateFileService.ImportFromFileAsync/ExportToFileAsync e o carregador empacotado wwwroot/templates) existe, mas não está ligado a nenhum botão da interface, para o utilizador NÃO há importação a partir de ficheiro; a única via é adicionar a partir da biblioteca predefinida.
Tentar adicionar sem um evento selecionado: quando currentEventInfo é null, AddTemplateToCurrentEvent devolve silenciosamente Success=false e o modelo não é adicionado.
Adicionar a partir do separador errado: o modal do separador Foto mostra a biblioteca de fotos e o modal do separador Video & GIF mostra a biblioteca de vídeos; o modelo que procura pode estar no outro separador.
Confundir Criar novo com uma importação: este produz um modelo de raiz com o assistente, não importa um modelo predefinido.
Como Criar um Modelo de Fotografia? · Como Editar um Modelo Existente?