Aplicativo de tema e CSS do ownCloud Classic 10 personalizado.

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.

Primeiro, separe as três rotas de branding.

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.

Prepare um aplicativo temático com segurança.

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.

Alterar logotipos e cores do tema

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.

Ative o tema e leve em consideração as verificações de integridade.

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.

Verifique o resultado e mantenha-o.

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.

Referências oficiais

Deixar um comentário

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.

Defina cotas de armazenamento padrão por função de usuário no ownCloud oCIS

Defina cotas de armazenamento padrão por função de usuário no ownCloud oCIS

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.

Corrigir erros de certificado de sincronização do ownCloud na origem do TLS

Corrigir erros de certificado de sincronização do ownCloud na origem do TLS

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.

Remover um aviso de integridade do ownCloud após uma atualização

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.

Instale o ownCloud Infinite Scale com o Docker Compose.

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 armazenamento de blobs S3 para o ownCloud Infinite Scale.

Configure o armazenamento de blobs S3 para o ownCloud Infinite Scale.

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.

Quando os uploads do ownCloud travam em 99%, verifique estes limites.

Quando os uploads do ownCloud travam em 99%, verifique estes limites.

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.

Limpar o aviso do arquivo .htaccess do Apache ownCloud com segurança

Limpar o aviso do arquivo .htaccess do Apache ownCloud com segurança

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.

Configure a auditoria do ownCloud Enterprise e verifique os registros.

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.

Conecte o ownCloud Infinite Scale ao Keycloak com OIDC.

Conecte o ownCloud Infinite Scale ao Keycloak com OIDC.

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.