テーマアプリとCSSを使用したブランドownCloud Classic 10

ownCloud Server Classic 10 の場合、ブランディングをテーマ アプリとして作成し、カスタム アプリ ディレクトリに配置することで、アップグレード時にテーマが置き換えられる可能性を低くすることができます。そのテーマを使用してロゴを置き換え、CSS の色を定義します。Web インターフェイス全体に任意のブランド カラーを適用できる汎用的な組み込みカラー ピッカーはありません。以下の手順は Classic Server の Web UI を対象としており、ownCloud Infinite Scale には適用されません。

まず、3つのブランディングルートを分けます。

検証済み: ownCloud Classic 10 はテーマをアプリとしてサポートしています。テーマは CSS、画像、テンプレート、翻訳を上書きできます。公式開発者マニュアルにも、Classic 10 では古いtheme設定が非推奨になっていると記載されています。対処方法:ファイルを変更する前に、製品とバージョンを確認してください。この手順は ownCloud Server Classic 10 用です。config.php

エディションによって異なります。ownCloudのownBranderサービスは、エンタープライズ顧客向けのグラフィックブランディングオプションです。Webテーマやブランド化されたクライアントを作成できます。アクセスは、エンタープライズサブスクリプションとアカウントの資格要件によって異なります。対処方法:エンタープライズアクセス権をお持ちの場合は、ownCloud管理者またはアカウント担当者にownBranderが有効になっているかどうかを確認してください。そうでない場合は、テーマアプリを使用してテストインスタンスで検証してください。

よくある誤解: Infinite Scale(oCIS)は、独自の構成ファイルやテーマファイルを含む、異なるWebカスタマイズモデルを使用しています。oCISの手順は、theme.jsonClassic Serverのテーマには適用されません。対処方法: oCISガイドからファイルや構成をClassic Serverのインストール環境にコピーしないでください。

もう一つよくある誤解は、設定画面でロゴを変更すると、すべてのロゴ、色、クライアントが自動的に変更されるというものです。Classic Serverの開発者マニュアルでは、ファイルシステムベースのテーマオーバーライドについて説明しています。機能の利用可否とクライアントのブランディングは、エディションと方法によって異なります。対策:ログインページ、ログイン済みヘッダー、ファビコン、およびデスクトップまたはモバイルクライアントを個別のチェック項目として計画してください。

テーマアプリを安全に準備する

まずインスタンスをバックアップし、ステージングコピーでテストしてください。ownCloud のバージョン、PHP/ランタイムのパッケージ、アプリディレクトリ、Webサーバーユーザー、および現在のテーマ関連の設定を記録してください。公式マニュアルでは、アップグレード中にカスタムテーマが失われる可能性を減らすため、カスタムテーマをカスタムアプリディレクトリに保存することを推奨しています。対処方法:設定済みのカスタムアプリディレクトリを見つけるか、apps-external利用可能な場合はドキュメントに記載されているディレクトリを使用してください。すべてのパッケージが同じパスを使用しているとは限らないことに注意してください。

テーマアプリには、appinfo/info.xmlフォルダと一致するアプリID、<theme/>タイプ、およびownCloudの依存関係範囲を指定したファイルが必要です。開発者マニュアルの例では、最小バージョンと最大バージョンの両方にClassic 10を使用しています。範囲を盲目的にコピーするのではなく、実際にサポートするバージョンに合わせて調整してください。対策: ownCloudの公式テーマ例から始め、それを改変する前に現在のファイルを確認してください。

例えば、テーマディレクトリは という名前で、対応する ownCloud パスを反映するパスの下に 、 、 およびイメージのオーバーライドが含まれている場合があります。theme-acmeディレクトリ名と値は一致する必要があります。対策:テーマをバージョン管理下に置き、インストール済みのアプリとの競合を避けるために一意の ID を使用してください。appinfo/info.xmlcore/css/styles.css<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とアセットとオーバーライドを比較してください。

テーマとアカウントを有効にして、整合性チェックを実施する

テーマを正しいアプリディレクトリに配置し、Webサーバーが読み取れるように所有権を設定したら、インストールoccコマンドで有効にします。公式マニュアルでdocker compose exec owncloud occ app:enable theme-acmeはDockerの例を示していますが、Docker以外のインストールでは、サポートされている独自のコマンドコンテキストを使用する必要があります。テーマは、無効になっているアプリの中に表示される管理アプリ画面からも有効にできます。手順:デプロイメントのコマンドフォームに従い、アプリIDがディレクトリとメタデータと一致していることを確認してください。

プライベートテーマにはマーケットプレイスの署名がない場合があります。ownCloud では、integrity.ignore.missing.app.signature署名がないという警告を回避するために、必要に応じてアプリ ID を追加する方法をドキュメントに記載しています。この例外は署名のないプライベートテーマに特有のものであり、整合性チェックを全体的に無効にするべきという意味ではありません。対処方法:インストール時にこの警告が表示される場合は、ドキュメントに記載されている許可リストにテーマ ID のみを追加し、その他の整合性保護はすべて維持してください。

テーマアプリのファイル権限は、Webサーバーがファイルを読み取れるように設定する必要があります。正確なユーザー名とグループ名はパッケージとホストによって異なるため、ドキュメントのwww-data例は普遍的なものではありません。対処方法:実行中のサービスの実際のアカウントを確認し、テーマディレクトリの所有権を厳密に設定してください。

結果を確認し、維持する

プライベート ブラウザー ウィンドウでログイン ページを開き、サインインして、ヘッダー、ナビゲーション、ファイル リスト、設定ページ、およびより小さなビューポート サイズを検査します。ロゴが鮮明であること、テキストが読みやすいこと、フォーカス インジケータが表示されていること、およびコントロールが背景に消えないことを確認します。マニュアルでは、ライブ開発環境でテストし、ブラウザーのインスペクター ツールを使用して CSS の変更を試すことを推奨しています。アクション:まずステージング 環境でこれらのパスをテストし、デプロイ後にブラウザー キャッシュをクリアして再度テストします。

何も変化がない場合は、テーマアプリが有効になっていること、ディレクトリがスキャンされたアプリパス内にあること、相対ファイル名がデフォルトと一致していること、CSSセレクタがページと一致していることを確認してください。ownCloudとWebサーバーのログで、読み込みエラーや権限エラーがないか確認してください。キャッシュされたCSSやブラウザのアセットが、表示上の更新を遅らせる場合があります。対処方法:ファイルとアプリの状態を確認した後、ブラウザのキャッシュをクリアするか、プライベートウィンドウを使用してください。トラブルシューティングのショートカットとして、本番データを削除したり、整合性チェックを無効にしたりしないでください。

最後に、ownCloud のアップデート後には必ずテーマを再テストしてください。コアのマークアップやアセットのパスが変更される可能性があるため、カスタム CSS が無効になったり、新しいインターフェースと競合したりする可能性があります。マニュアルではテーマアプリのアプローチを説明していますが、すべてのオーバーライドがリリース間で互換性を維持することを保証するものではありません。対策:ロールバック用のコピーを保持し、アップグレード先のリリースとテーマを比較し、テスト後にのみ古いオーバーライドを削除してください。

公式資料

コメントを残す

テーマアプリとCSSを使用したブランドownCloud Classic 10

ownCloud Classic 10のロゴを置き換え、テーマアプリを使用してWeb UIの色を調整し、アップグレードや整合性チェックの落とし穴を回避します。

ownCloud oCISでユーザーロールごとにデフォルトのストレージクォータを設定する

ownCloud oCISでユーザーロールごとにデフォルトのストレージクォータを設定する

役割ごとに、新しいownCloud Infinite Scaleユーザーにバイト単位のストレージ制限を割り当てます。proxy.yamlの例と安全な検証チェックリストも含まれています。

ownCloud同期証明書のTLSソースエラーを修正する

ownCloud同期証明書のTLSソースエラーを修正する

TLS検証を無効にせずに、サーバーのホスト名、証明書チェーン、プライベートCAの信頼、およびキャプティブポータルの問題を確認することで、ownCloudデスクトップの同期を復元します。

アップグレード後にownCloudの整合性警告をクリアする

無効ファイルレポートを使用して、一致しないコアファイルまたはアプリ署名を特定し、正しいリリースファイルを復元し、整合性チェックを安全に検証します。

ownCloud Infinite ScaleをDocker Composeでインストールする

ownCloud Infinite Scaleを公式のComposeサンプルからデプロイし、ドメインと永続ストレージを設定した後、TLS、コンテナ、および初回ログインを確認します。

ownCloud Infinite Scale 用の S3 Blob Storage の設定

ownCloud Infinite Scale 用の S3 Blob Storage の設定

ownCloud Infinite Scaleがファイルコンテンツを確実に保存できるように、S3NGドライバー、バケットのアクセス許可、永続的なメタデータストレージ、およびアップロードサイズを設定します。

ownCloudのアップロードが99%で止まった場合は、これらの制限を確認してください。

ownCloudのアップロードが99%で止まった場合は、これらの制限を確認してください。

ownCloud Serverへのアップロードが完了間近で停止する原因を特定するには、ファイルの状態、クォータ、一時ディスク容量、PHPの制限、プロキシのタイムアウトなどを確認してください。

ownCloudのApache .htaccess警告を安全にクリアする

ownCloudのApache .htaccess警告を安全にクリアする

ownCloudのウェブルートに対してのみAllowOverride Allを設定し、アクティブなApache仮想ホストを検証し、安全にリロードして.htaccessルールを復元します。

ownCloud Enterprise Auditingを設定し、ログを確認する

ownCloudのエンタープライズ監査アプリを有効にし、admin_auditイベントを保護されたログファイルにルーティングして、実際のユーザー操作が記録されていることを確認します。

ownCloud Infinite ScaleをOIDCを使用してKeycloakに接続します。

ownCloud Infinite ScaleをOIDCを使用してKeycloakに接続します。

Keycloakのレルム発行者、Webクライアント、およびユーザークレームを整合させることで、ownCloud Infinite ScaleがWebクライアントとモバイルクライアント全体でユーザーを確実にサインインできるようにします。