Aplicativo de tema e CSS do ownCloud Classic 10 personalizado.
Substitua os logotipos do ownCloud Classic 10 e ajuste as cores da interface web com um aplicativo de tema, evitando problemas de atualização e verificação de integridade.
Para o ownCloud Server Classic 10, crie sua identidade visual como um aplicativo de tema e coloque-o em um diretório de aplicativos personalizado para que as atualizações tenham menos probabilidade de substituí-lo. Use esse tema para substituir logotipos e definir cores CSS; não há um seletor de cores integrado que aplique cores de marca arbitrárias em toda a interface da web. As etapas abaixo abrangem a interface da web do Classic Server, não o ownCloud Infinite Scale.
Verificado: o ownCloud Classic 10 suporta temas como aplicativos. Um tema pode substituir CSS, imagens, modelos e traduções. O manual oficial do desenvolvedor também informa que a themeconfiguração antiga config.phpestá obsoleta no Classic 10. Ação: identifique seu produto e versão antes de alterar os arquivos: este procedimento é para o ownCloud Server Classic 10.
Depende da sua edição: o serviço ownBrander do ownCloud é uma opção de personalização gráfica descrita para clientes Enterprise. Ele permite criar temas web e clientes personalizados; o acesso depende de uma assinatura Enterprise e da elegibilidade da conta. Ação: se você tiver acesso Enterprise, pergunte ao administrador do ownCloud ou ao seu contato de conta se o ownBrander está habilitado. Caso contrário, use um aplicativo de tema e valide-o em uma instância de teste.
Equívoco comum: o Infinite Scale (oCIS) utiliza um modelo de personalização web diferente, incluindo seus próprios arquivos de configuração e tema. As instruções para oCIS theme.jsonnão se aplicam aos temas do Classic Server. Ação: não copie arquivos ou configurações de um guia do oCIS para uma instalação do Classic Server.
Outra suposição comum é que alterar o logotipo na tela de configurações altera automaticamente todos os logotipos, cores e clientes. O manual do desenvolvedor do Classic Server descreve as substituições de tema baseadas no sistema de arquivos; a disponibilidade do recurso e a personalização da marca do cliente dependem da edição e do método. Ação: planeje a página de login, o cabeçalho de login, o favicon e quaisquer clientes para desktop ou dispositivos móveis como verificações separadas.
Faça backup da sua instância e teste primeiro em uma cópia de teste. Anote a versão do ownCloud, o pacote PHP/runtime, os diretórios do aplicativo, o usuário do servidor web e a configuração atual relacionada ao tema. O manual oficial recomenda armazenar temas personalizados em um diretório de aplicativo personalizado para reduzir a chance de perdê-los durante as atualizações. Ação: localize o diretório de aplicativo personalizado configurado ou use o apps-externaldiretório documentado, quando disponível; não assuma que todos os pacotes usam o mesmo caminho.
Um aplicativo de tema precisa de um appinfo/info.xmlarquivo com um ID de aplicativo que corresponda à sua pasta, um <theme/>tipo e um intervalo de dependências do ownCloud. O exemplo do manual do desenvolvedor usa o Classic 10 como versão mínima e máxima. Ajuste isso para as versões que você realmente suporta, em vez de copiar um intervalo cegamente. Ação: comece com o exemplo de tema oficial do ownCloud e revise os arquivos existentes antes de adaptá-lo.
Por exemplo, um diretório de tema pode ser nomeado theme-acmee conter arquivos appinfo/info.xml.htaccess, core/css/styles.cssarquivos .csv e arquivos de imagem personalizados em caminhos que espelham os caminhos correspondentes do ownCloud. O nome do diretório e o <id>valor devem coincidir. Ação: mantenha o tema sob controle de versão e use um ID exclusivo para evitar conflitos com aplicativos instalados.
Para sobrescrever uma imagem, preserve seu caminho relativo dentro do tema. Por exemplo, o caminho padrão do logotipo de login é ` login.login` core/img/logo-icon.svg, portanto, a sobrescrita do tema deve estar em theme-acme/core/img/logo-icon.svg`login.login`. O manual lista outros caminhos de imagem e observa que o tratamento do favicon deve incluir sobrescritas tanto para SVG quanto para PNG. Ação: inspecione os recursos da instalação atual e reproduza os caminhos relevantes dentro do seu tema em vez de substituir os arquivos principais.
Para sobrescrever as cores, crie seletores core/css/styles.cssno tema. O manual oficial documenta seletores como #body-logino de fundo da tela de login e #body-public #headero de cabeçalho da tela de login. Um exemplo mínimo é:
#body-login {
background: #17324d;
}
#body-public #header {
background-color: #17324d;
}
Isso altera as áreas documentadas; não se trata de uma paleta de cores completa para todos os aplicativos, diálogos ou interfaces de terceiros. Ação: use as ferramentas de desenvolvedor do navegador em sua própria instância para identificar o componente desejado e, em seguida, adicione regras CSS com escopo restrito à folha de estilo do tema. Evite seletores amplos que possam tornar o texto, os botões ou os estados de foco ilegíveis.
Use uma variante do logotipo que se ajuste ao espaço existente e verifique o contraste do texto normal, links, controles e foco do teclado. Os seletores exatos e as dimensões dos recursos podem variar de acordo com a versão, o tema e os aplicativos instalados. Ação: compare suas alterações com o DOM e os recursos atuais no ambiente de teste, em vez de presumir que um seletor antigo ainda seja válido.
Após colocar o tema no diretório correto do aplicativo e definir a propriedade para que o servidor web possa lê-lo, habilite-o com o occcomando de instalação. O manual oficial fornece docker compose exec owncloud occ app:enable theme-acmeum exemplo com Docker; instalações sem Docker devem usar seu próprio contexto de comando compatível. Os temas também podem ser habilitados na tela de Aplicativos Administrativos, onde aparecem entre os aplicativos desabilitados. Ação: siga o formato de comando para sua implantação e confirme se o ID do aplicativo corresponde ao diretório e aos metadados.
Um tema privado pode não ter uma assinatura no Marketplace. O ownCloud documenta a adição do ID do aplicativo integrity.ignore.missing.app.signaturequando necessário para evitar o aviso de assinatura ausente. Essa exceção é específica para temas privados não assinados; isso não significa que a verificação de integridade deva ser desativada globalmente. Ação: adicione apenas o ID do tema à lista de permissões documentada se a sua instalação reportar esse aviso e preserve todas as outras proteções de integridade.
As permissões de arquivo do aplicativo de tema devem permitir que o servidor web leia os arquivos. Os nomes exatos de usuário e grupo variam de acordo com o pacote e o host; o www-dataexemplo da documentação não é universal. Ação: verifique a conta real do serviço em execução e defina a propriedade de forma restrita para o diretório do tema.
Abra a página de login em uma janela anônima do navegador, faça login e inspecione o cabeçalho, a navegação, a lista de arquivos, as páginas de configurações e os tamanhos de viewport menores. Confirme se o logotipo está nítido, se o texto permanece legível, se os indicadores de foco permanecem visíveis e se nenhum controle desaparece no fundo. O manual recomenda testar em um ambiente de desenvolvimento ativo e usar as ferramentas de inspeção do navegador para testar as alterações de CSS. Ação: teste esses caminhos primeiro em um ambiente de teste e, em seguida, repita o processo após a implantação, com o cache do navegador limpo.
Se nada mudar, verifique se o aplicativo de tema está ativado, se o diretório está dentro de um caminho de aplicativo verificado, se os nomes de arquivo relativos correspondem aos padrões e se o seletor CSS ainda corresponde à página. Verifique os logs do ownCloud e do servidor web em busca de erros de carregamento ou permissão. CSS em cache ou recursos do navegador podem atrasar as atualizações visíveis. Ação: limpe o cache do navegador ou use uma janela anônima após confirmar os arquivos e o status do aplicativo; não exclua dados de produção nem desative as verificações de integridade como uma solução paliativa para problemas.
Por fim, teste o tema novamente após cada atualização do ownCloud. A estrutura de marcação principal e os caminhos dos recursos podem mudar, portanto, o CSS personalizado pode se tornar ineficaz ou entrar em conflito com a nova interface. O manual estabelece a abordagem de tema-aplicativo, mas não garante que todas as alterações permaneçam compatíveis entre as versões. Ação: mantenha uma cópia de segurança, compare seu tema com a versão para a qual você está atualizando e remova as alterações obsoletas somente após os testes.
Substitua os logotipos do ownCloud Classic 10 e ajuste as cores da interface web com um aplicativo de tema, evitando problemas de atualização e verificação de integridade.
Atribua limites de armazenamento em bytes para novos usuários do ownCloud Infinite Scale por função, com um exemplo de proxy.yaml e uma lista de verificação de segurança.
Restaure a sincronização do ownCloud para desktop verificando o nome do host do servidor, a cadeia de certificados, a confiança da CA privada e problemas com o portal cativo, sem desativar a verificação TLS.
Use o relatório de arquivos inválidos para identificar arquivos principais ou assinaturas de aplicativos incompatíveis, restaurar os arquivos de versão corretos e verificar a integridade dos dados com segurança.
Implante o ownCloud Infinite Scale a partir do exemplo oficial do Compose, configure os domínios e o armazenamento persistente e, em seguida, verifique o TLS, os contêineres e o primeiro login.
Configure o driver S3NG, as permissões do bucket, o armazenamento persistente de metadados e o dimensionamento de upload para que o ownCloud Infinite Scale possa armazenar o conteúdo dos arquivos de forma confiável.
Descubra por que um upload para o servidor ownCloud para perto da conclusão, verificando o status do arquivo, a cota, o espaço em disco temporário, os limites do PHP e os tempos limite do proxy.
Defina AllowOverride All apenas para a raiz da web do ownCloud, valide o vhost ativo do Apache e recarregue com segurança para restaurar as regras do .htaccess.
Ative o aplicativo Enterprise Auditing do ownCloud, direcione os eventos admin_audit para um arquivo de log protegido e confirme se as ações reais do usuário estão sendo registradas.
Alinhe as declarações do emissor de domínio, do cliente web e do usuário do Keycloak para permitir que o ownCloud Infinite Scale faça login de usuários de forma confiável nos clientes web e móveis.