브랜드 ownCloud Classic 10에 테마 앱과 CSS를 적용했습니다.

ownCloud Server Classic 10의 경우, 브랜딩 테마 앱을 만들어 사용자 지정 앱 디렉터리에 배치하면 업그레이드 시 앱이 교체될 가능성을 줄일 수 있습니다. 해당 테마를 사용하여 로고를 바꾸고 CSS 색상을 정의하세요. 웹 인터페이스 전체에 임의의 브랜드 색상을 적용하는 기본 제공 색상 선택기는 없습니다. 아래 단계는 ownCloud Infinite Scale이 아닌 Classic Server 웹 UI에 대한 설명입니다.

먼저, 세 가지 브랜딩 경로를 구분합니다.

확인됨: ownCloud Classic 10은 테마를 앱처럼 지원합니다. 테마는 CSS, 이미지, 템플릿 및 번역을 재정의할 수 있습니다. 공식 개발자 설명서에도 Classic 10에서는 기존 theme설정이 더 이상 사용되지 않는다고 명시되어 있습니다 . 조치: 파일을 변경하기 전에 제품 및 버전을 확인하십시오. 이 절차는 ownCloud Server Classic 10에 적용됩니다.config.php

사용 중인 에디션에 따라 다릅니다. ownCloud의 ownBrander 서비스는 엔터프라이즈 고객을 위해 개발된 그래픽 브랜딩 옵션입니다. 웹 테마와 브랜드 클라이언트를 생성할 수 있으며, 엔터프라이즈 구독 및 계정 자격 여부에 따라 이용 가능 여부가 결정됩니다. 조치: 엔터프라이즈 액세스 권한이 있는 경우 ownCloud 관리자 또는 계정 담당자에게 ownBrander 사용 가능 여부를 문의하십시오. 그렇지 않은 경우 테마 앱을 사용하여 테스트 인스턴스에서 유효성을 검사하십시오.

흔히 발생하는 오해: Infinite Scale(oCIS)은 자체 구성 및 테마 파일을 포함하여 다른 웹 사용자 지정 모델을 사용합니다. oCIS에 대한 지침은 theme.json클래식 서버 테마에는 적용되지 않습니다. 조치: oCIS 가이드의 파일이나 구성을 클래식 서버 설치에 복사하지 마십시오.

흔히 잘못 알고 있는 사실은 설정 화면에서 로고를 변경하면 모든 로고, 색상 및 클라이언트가 자동으로 변경된다는 것입니다. 클래식 서버 개발자 설명서에는 파일 시스템 기반 테마 재정의에 대한 내용이 나와 있으며, 기능 사용 가능 여부와 클라이언트 브랜딩은 에디션 및 방법에 따라 다릅니다. 조치: 로그인 페이지, 로그인 헤더, 파비콘, 데스크톱 또는 모바일 클라이언트를 각각 별도로 점검하십시오.

테마 앱을 안전하게 준비하세요

먼저 인스턴스를 백업하고 스테이징 환경에서 테스트하십시오. ownCloud 버전, PHP/런타임 패키징, 앱 디렉터리, 웹 서버 사용자 및 현재 테마 관련 구성을 기록해 두세요. 공식 설명서에서는 업그레이드 중 테마 손실 가능성을 줄이기 위해 사용자 지정 테마를 사용자 지정 앱 디렉터리에 저장하는 것을 권장합니다. 조치: 구성된 사용자 지정 앱 디렉터리를 찾거나, 가능한 경우 설명서에 나와 있는 디렉터리를 사용하십시오 apps-external. 모든 패키지가 동일한 경로를 사용한다고 가정하지 마십시오.

테마 앱에는 appinfo/info.xml폴더와 일치하는 앱 ID, <theme/>유형, ownCloud 종속성 범위가 포함된 파일이 필요합니다. 개발자 설명서의 예제에서는 최소 및 최대 버전으로 Classic 10을 사용하고 있습니다. 범위를 맹목적으로 복사하지 말고 실제로 지원하는 버전에 맞게 수정하십시오. 권장 사항: ownCloud의 공식 테마 예제를 참고하여 기존 파일을 검토한 후 수정하십시오.

예를 들어, 테마 디렉터리는 ownCloud 경로와 동일한 경로 아래에 , , 이미지 재정의 파일을 theme-acme포함하는 이름으로 지정될 수 있습니다 . 디렉터리 이름과 값은 일치해야 합니다. 조치: 테마를 버전 관리하고 설치된 앱과의 충돌을 방지하기 위해 고유 ID를 사용하십시오.appinfo/info.xmlcore/css/styles.css<id>

로고와 테마 색상을 변경하세요

이미지를 재정의하려면 테마 내에서 해당 이미지의 상대 경로를 유지해야 합니다. 예를 들어 로그인 로고의 기본 경로는 `<image>`이므로 core/img/logo-icon.svg테마 재정의는 `<image>` 경로에 있어야 합니다 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-acmeDocker 환경 예시가 나와 있지만, Docker를 사용하지 않는 설치 환경에서는 자체적으로 지원하는 명령어를 사용해야 합니다. 테마는 관리자 앱 화면에서도 활성화할 수 있으며, 비활성화된 앱 목록에 표시됩니다. 조치: 배포 환경에 맞는 명령어 형식을 따라 앱 ID가 디렉터리 및 메타데이터와 일치하는지 확인하십시오.

비공개 테마에는 마켓플레이스 서명이 없을 수 있습니다. ownCloud는 integrity.ignore.missing.app.signature서명 누락 경고를 방지하기 위해 필요한 경우 앱 ID를 추가하는 방법을 문서에 명시하고 있습니다. 이 예외는 서명되지 않은 비공개 테마에만 해당되며, 무결성 검사를 전체적으로 비활성화해야 한다는 의미는 아닙니다. 조치: 설치 환경에서 해당 경고가 표시되는 경우, 문서에 명시된 허용 목록에 테마 ID만 추가하고 다른 모든 무결성 보호 기능은 유지하십시오.

테마 앱의 파일 권한은 웹 서버가 파일을 읽을 수 있도록 허용해야 합니다. 정확한 사용자 및 그룹 이름은 패키지와 호스트에 따라 다르므로, 문서의 www-data예시는 보편적이지 않습니다. 조치: 실행 중인 서비스의 실제 계정을 확인하고 테마 디렉터리에 대한 소유권을 특정 사용자 또는 그룹으로 설정하십시오.

결과를 검증하고 유지하십시오.

로그인 페이지를 개인 브라우저 창에서 열고 로그인한 다음 헤더, 탐색 메뉴, 파일 목록, 설정 페이지 및 더 작은 뷰포트 크기에서 화면을 검사하세요. 로고가 선명하고, 텍스트를 읽을 수 있으며, 포커스 표시기가 제대로 표시되고, 컨트롤이 배경으로 사라지지 않는지 확인하세요. 매뉴얼에서는 실제 개발 환경에서 브라우저 검사 도구를 사용하여 CSS 변경 사항을 테스트하는 것을 권장합니다. 조치: 먼저 스테이징 환경에서 해당 경로를 테스트한 다음, 배포 후 브라우저 캐시를 정리한 상태에서 다시 테스트하세요.

변경 사항이 없으면 테마 앱이 활성화되어 있는지, 디렉터리가 스캔된 앱 경로 내에 있는지, 상대 파일 이름이 기본값과 일치하는지, CSS 선택기가 페이지와 여전히 일치하는지 확인하십시오. ownCloud 및 웹 서버 로그에서 로딩 또는 권한 오류를 확인하십시오. 캐시된 CSS 또는 브라우저 자산으로 인해 표시되는 업데이트가 지연될 수 있습니다. 조치: 파일 및 앱 상태를 확인한 후 브라우저 캐시를 지우거나 시크릿 창을 사용하십시오. 문제 해결을 위한 지름길로 프로덕션 데이터를 삭제하거나 무결성 검사를 비활성화하지 마십시오.

마지막으로, ownCloud를 업데이트할 때마다 테마를 다시 테스트하십시오. 핵심 마크업과 자산 경로가 변경될 수 있으므로 사용자 지정 CSS가 작동하지 않거나 새 인터페이스와 충돌할 수 있습니다. 설명서에서는 테마 앱 접근 방식을 설명하지만 모든 재정의가 릴리스 간에 호환성을 유지한다는 보장은 없습니다. 조치: 롤백 복사본을 보관하고, 업그레이드할 릴리스의 테마와 비교하여 테스트 후 더 이상 사용하지 않는 재정의를 제거하십시오.

공식 참조

댓글 남기기

브랜드 ownCloud Classic 10에 테마 앱과 CSS를 적용했습니다.

업그레이드 및 무결성 검사 관련 문제를 피하면서 테마 앱을 사용하여 ownCloud Classic 10 로고를 교체하고 웹 UI 색상을 조정하세요.

ownCloud oCIS에서 사용자 역할별 기본 스토리지 할당량 설정

ownCloud oCIS에서 사용자 역할별 기본 스토리지 할당량 설정

역할별로 새로운 ownCloud Infinite Scale 사용자에게 바이트 기반 스토리지 제한을 할당하는 방법을 안내합니다. proxy.yaml 예제와 안전성 검증 체크리스트가 포함되어 있습니다.

ownCloud 동기화 인증서 오류 해결 (TLS 소스)

ownCloud 동기화 인증서 오류 해결 (TLS 소스)

TLS 인증을 비활성화하지 않고 서버 호스트 이름, 인증서 체인, 개인 CA 신뢰 및 캡티브 포털 문제를 확인하여 ownCloud 데스크톱 동기화를 복원하세요.

업그레이드 후 ownCloud 무결성 경고를 해결하는 방법

잘못된 파일 보고서를 사용하여 코어 파일이나 앱 서명이 일치하지 않는 부분을 식별하고, 올바른 릴리스 파일을 복원하고, 무결성 검사를 안전하게 확인할 수 있습니다.

Docker Compose를 사용하여 ownCloud Infinite Scale을 설치하세요.

ownCloud Infinite Scale을 공식 Compose 예제를 사용하여 배포하고, 도메인 및 영구 스토리지를 구성한 다음, TLS, 컨테이너 및 첫 로그인을 확인합니다.

ownCloud Infinite Scale을 위한 S3 Blob 스토리지 구성

ownCloud Infinite Scale을 위한 S3 Blob 스토리지 구성

ownCloud Infinite Scale이 파일 콘텐츠를 안정적으로 저장할 수 있도록 S3NG 드라이버, 버킷 권한, 영구 메타데이터 저장소 및 업로드 크기를 설정합니다.

ownCloud 업로드가 99%에서 멈추는 경우, 다음 제한 사항을 확인하세요.

ownCloud 업로드가 99%에서 멈추는 경우, 다음 제한 사항을 확인하세요.

ownCloud 서버 업로드가 거의 완료될 무렵 중단되는 이유를 파일 상태, 할당량, 임시 디스크 공간, PHP 제한 및 프록시 시간 초과를 확인하여 알아보세요.

ownCloud Apache .htaccess 경고를 안전하게 제거하는 방법

ownCloud Apache .htaccess 경고를 안전하게 제거하는 방법

ownCloud의 웹 루트에만 AllowOverride All을 설정하고, 활성 Apache vhost를 확인한 다음, 안전하게 페이지를 새로 고침하여 .htaccess 규칙을 복원하십시오.

ownCloud Enterprise 감사 설정 및 로그 검증

ownCloud의 엔터프라이즈 감사 앱을 활성화하고, admin_audit 이벤트를 보호된 로그 파일로 라우팅하고, 실제 사용자 작업이 기록되는지 확인하십시오.

OIDC를 사용하여 ownCloud Infinite Scale을 Keycloak에 연결합니다.

OIDC를 사용하여 ownCloud Infinite Scale을 Keycloak에 연결합니다.

Keycloak의 영역 발급자, 웹 클라이언트 및 사용자 클레임을 정렬하여 ownCloud Infinite Scale이 웹 및 모바일 클라이언트 전반에서 사용자를 안정적으로 로그인할 수 있도록 합니다.