Brand ownCloud Classic 10 с темой оформления и CSS

Для ownCloud Server Classic 10 создайте свой фирменный стиль в виде тематического приложения и поместите его в пользовательский каталог приложений, чтобы уменьшить вероятность его замены при обновлениях. Используйте эту тему для замены логотипов и определения цветов CSS; в веб-интерфейсе нет встроенного инструмента выбора цвета, который бы применял произвольные фирменные цвета. Приведенные ниже шаги относятся к веб-интерфейсу Classic Server, а не к ownCloud Infinite Scale.

Во-первых, разделите три направления брендинга.

Подтверждено: ownCloud Classic 10 поддерживает темы как приложения. Тема может переопределять CSS, изображения, шаблоны и переводы. В официальном руководстве разработчика также указано, что старая themeнастройка config.phpустарела в Classic 10. Действие: перед изменением файлов определите свой продукт и версию: эта процедура предназначена для ownCloud Server Classic 10.

Зависит от вашей версии: сервис ownBrander от ownCloud — это опция графического брендинга, предназначенная для корпоративных клиентов. Он позволяет создавать веб-темы и брендированные клиенты; доступ зависит от корпоративной подписки и соответствия требованиям учетной записи. Действие: если у вас есть корпоративный доступ, спросите у администратора ownCloud или контактного лица по учетной записи, включен ли ownBrander. В противном случае используйте приложение для создания тем и проверьте его на тестовом экземпляре.

Распространенное заблуждение: Infinite Scale (oCIS) использует другую модель веб-настройки, включая собственные файлы конфигурации и темы оформления. Инструкции для oCIS theme.jsonне применимы к темам оформления Classic Server. Действие: не копируйте файлы или конфигурацию из руководства по oCIS в установку Classic Server.

Ещё одно распространённое заблуждение заключается в том, что изменение логотипа на экране настроек автоматически меняет все логотипы, цвета и клиентские приложения. В руководстве разработчика Classic Server описаны переопределения тем на основе файловой системы; доступность функций и брендинг клиентских приложений зависят от версии и метода. Действие: спланируйте страницу входа, заголовок для авторизованных пользователей, значок сайта и любые настольные или мобильные клиенты как отдельные проверки.

Безопасная подготовка тематического приложения

Сначала сделайте резервную копию вашего экземпляра и протестируйте на тестовой копии. Запишите версию ownCloud, конфигурацию пакетов PHP/среды выполнения, каталоги приложений, пользователя веб-сервера и текущую конфигурацию, связанную с темой оформления. В официальном руководстве рекомендуется хранить пользовательские темы в отдельном каталоге приложения, чтобы уменьшить вероятность их потери при обновлениях. Действие: найдите настроенный вами каталог пользовательского приложения или используйте указанный в документации apps-externalкаталог, если он доступен; не предполагайте, что все пакеты используют один и тот же путь.

Для приложения-темы необходим appinfo/info.xmlфайл с идентификатором приложения, соответствующим его папке, <theme/>типом и диапазоном зависимостей ownCloud. В примере из руководства разработчика в качестве минимальной и максимальной версии используется Classic 10. Настройте это значение в соответствии с версиями, которые вы действительно поддерживаете, вместо того, чтобы копировать диапазон вслепую. Действие: начните с официального примера темы ownCloud и проверьте его текущие файлы, прежде чем адаптировать его.

Например, каталог темы может называться theme-acmeи содержать appinfo/info.xml, core/css/styles.css, а также переопределения изображений по путям, которые соответствуют путям ownCloud. Имя каталога и <id>значение должны совпадать. Действие: храните тему под контролем версий и используйте уникальный идентификатор, чтобы избежать конфликтов с установленными приложениями.

Изменить логотипы и цветовые схемы

Чтобы переопределить изображение, сохраните его относительный путь внутри темы. Например, путь по умолчанию для логотипа входа — core/img/logo-icon.svg, поэтому переопределение темы должно находиться по адресу theme-acme/core/img/logo-icon.svg. В руководстве перечислены другие пути к изображениям и отмечается, что обработка значков фавикона должна включать переопределение как SVG, так и PNG. Действие: проверьте ресурсы текущей установки и воспроизведите соответствующие пути внутри вашей темы вместо замены основных файлов.

Чтобы изменить цвета, создайте их core/css/styles.cssв теме оформления. В официальном руководстве описаны селекторы, например, #body-loginдля фона страницы входа и #body-public #headerдля заголовка страницы после авторизации. Минимальный пример:

#body-login {
  background: #17324d;
}

#body-public #header {
  background-color: #17324d;
}

Это изменяет указанные в документации области; это не полная палитра фирменного стиля для каждого приложения, диалога или стороннего интерфейса. Действие: используйте инструменты разработчика браузера на своем экземпляре, чтобы определить нужный компонент, а затем добавьте узконаправленные правила CSS в таблицу стилей темы. Избегайте широких селекторов, которые могут сделать текст, кнопки или состояния фокуса нечитаемыми.

Используйте вариант логотипа, подходящий для существующего пространства, и проверьте контрастность обычного текста, ссылок, элементов управления и фокуса клавиатуры. Точные размеры селекторов и ресурсов могут различаться в зависимости от установленной версии, темы и приложений. Действие: сравните ваши переопределения с текущим DOM и ресурсами на тестовом сервере, а не предполагайте, что старый селектор по-прежнему подходит.

Включите тему оформления и учетную запись для проверки целостности.

После размещения темы в нужном каталоге приложения и установки прав доступа, позволяющих веб-серверу читать её, включите её с помощью occкоманды установки. В официальном руководстве приведён docker compose exec owncloud occ app:enable theme-acmeпример для Docker; для установок без Docker следует использовать собственный поддерживаемый контекст команд. Темы также можно включить на экране «Администрирование приложений», где они отображаются среди отключенных приложений. Действие: следуйте форме команды для вашего развертывания и убедитесь, что идентификатор приложения соответствует каталогу и метаданным.

У частной темы может отсутствовать подпись Marketplace. В документации ownCloud указано, что идентификатор приложения добавляется integrity.ignore.missing.app.signatureпри необходимости, чтобы избежать предупреждения об отсутствии подписи. Это исключение относится только к неподписанным частным темам; это не означает, что проверку целостности следует отключать глобально. Действие: добавьте в документированный список разрешенных только идентификатор темы, если ваша установка выдает это предупреждение, и сохраните все остальные средства защиты целостности.

Права доступа к файлам в приложении темы должны позволять веб-серверу читать эти файлы. Точные имена пользователей и групп различаются в зависимости от пакета и хоста; www-dataпример в документации не является универсальным. Действие: проверьте фактическую учетную запись запущенной службы и установите узкие права доступа для каталога темы.

Проверьте результат и сохраните его.

Откройте страницу входа в систему в приватном окне браузера, затем войдите в систему и проверьте заголовок, навигацию, список файлов, страницы настроек и уменьшенные размеры области просмотра. Убедитесь, что логотип четкий, текст остается читаемым, индикаторы фокуса остаются видимыми, и никакие элементы управления не исчезают на заднем плане. В руководстве рекомендуется тестировать в рабочей среде разработки и использовать инструменты инспектора браузера для проверки изменений CSS. Действие: сначала протестируйте эти пути на тестовой среде, затем повторите после развертывания с чистым кэшем браузера.

Если ничего не меняется, убедитесь, что приложение темы включено, каталог находится в просканированном пути приложения, относительные имена файлов соответствуют значениям по умолчанию, а селектор CSS по-прежнему соответствует странице. Проверьте журналы ownCloud и веб-сервера на наличие ошибок загрузки или разрешений. Кэшированные CSS-файлы или ресурсы браузера могут задерживать видимые обновления. Действие: очистите кэш браузера или используйте приватное окно после подтверждения состояния файлов и приложения; не удаляйте производственные данные и не отключайте проверки целостности в качестве быстрого способа устранения неполадок.

Наконец, после каждого обновления ownCloud повторно тестируйте тему. Основная разметка и пути к ресурсам могут измениться, поэтому пользовательские CSS-стили могут стать неэффективными или конфликтовать с новым интерфейсом. В руководстве описан подход с использованием приложения темы, но он не гарантирует совместимость всех переопределений между версиями. Действие: сохраните откатную копию, сравните свою тему с версией, на которую вы обновляетесь, и удаляйте устаревшие переопределения только после тестирования.

Официальные ссылки

Оставить комментарий

Разверните ownCloud на HTTPS с помощью Let's Encrypt и Nginx.

Разверните ownCloud на HTTPS с помощью Let's Encrypt и Nginx.

Выберите HTTP-01 или DNS-01, настройте обратный прокси-сервер ownCloud и убедитесь, что Certbot автоматически обновляет сертификаты HTTPS.

Подключите ownCloud Infinite Scale к LDAP для входа пользователей в систему.

Перед развертыванием настройте вход в систему oCIS LDAP, согласуйте поиск пользователей и групп, а также проверьте настройки TLS и схемы.

Подключите S3-хранилище к ownCloud 10 в качестве внешнего хранилища.

Подключите S3-хранилище к ownCloud 10 в качестве внешнего хранилища.

Добавьте корзину Amazon S3 в ownCloud 10, подготовьте совместимые учетные данные и конечные точки, а также проверьте доступ, не путая монтирование с основным хранилищем.

Автоматизируйте создание дампов базы данных ownCloud с помощью безопасного ночного задания Cron.

Автоматизируйте создание дампов базы данных ownCloud с помощью безопасного ночного задания Cron.

Планируйте создание защищенных дампов MariaDB для сервера ownCloud, безопасно управляйте режимом обслуживания и проверяйте каждую резервную копию, прежде чем полагаться на нее.

Перенесите ownCloud Classic в oCIS с помощью поддерживаемой миграции.

Спланируйте миграцию с ownCloud 10 на oCIS, используя поддерживаемое приложение, упорядоченные команды, проверки подлинности и четкий список данных, требующих отдельной обработки.

Brand ownCloud Classic 10 с темой оформления и CSS

Замените логотипы ownCloud Classic 10 и настройте цвета веб-интерфейса с помощью тематического приложения, избегая при этом проблем, связанных с обновлением и проверкой целостности.

Настройка квот хранилища по умолчанию для ролей пользователей в ownCloud oCIS

Настройка квот хранилища по умолчанию для ролей пользователей в ownCloud oCIS

Назначайте новым пользователям ownCloud Infinite Scale ограничения на объем хранилища в байтах в зависимости от роли, используя пример файла proxy.yaml и контрольный список для безопасной проверки.

Устраните ошибки сертификата синхронизации ownCloud на уровне источника TLS.

Устраните ошибки сертификата синхронизации ownCloud на уровне источника TLS.

Восстановите синхронизацию ownCloud на рабочем столе, проверив имя хоста сервера, цепочку сертификатов, доверие к частному центру сертификации и проблемы с порталом авторизации, не отключая проверку TLS.

Устранить предупреждение ownCloud Integrity после обновления

Используйте отчет о недействительных файлах, чтобы выявить несоответствия в основных файлах или сигнатурах приложений, восстановить правильные файлы выпуска и безопасно проверить целостность.

Установите ownCloud Infinite Scale с помощью Docker Compose.

Разверните ownCloud Infinite Scale, используя официальный пример Compose, настройте домены и постоянное хранилище, затем проверьте TLS, контейнеры и первый вход в систему.