オリジナルのテーマを作成するには、2 つの方法があります。
- PowerCMS の管理画面で、現在のワークスペース/スペースのデザインをテーマとしてエクスポートする
- テーマの設定ファイルやテンプレートを、自分で作成する
手軽なのは管理画面でテーマをエクスポートする方法です。テーマのファイルを自分で作成する方法は、技術的な知識が必要ですが、より柔軟性があります。本ページでは、管理画面でテーマを作成、保存する方法を解説します。
テーマ用にワークスペース/スペースをカスタマイズする
まずは、PowerCMS でワークスペース/スペースを設計・制作します。テーマに保存できる項目は以下の通りです。
- テンプレート
- デザインで利用する、画像などのファイル
- カテゴリ
- フォルダ
- カスタムフィールドの設定
テンプレート
ワークスペース/スペースのテンプレートをテーマとして書き出すためには、以下の点を注意して制作します。
- 他のスペースのテンプレートを Include せず、同じスペース内でテンプレート構造を完結させる。
- リンクや画像の URL は、絶対パスで記述せず、ワークスペース/スペースの公開パスを起点とした相対パスで記述する。
- カテゴリやフォルダ、カスタムフィールドをテンプレートタグで指定する場合は、それらを忘れずにテーマに含める。
- プラグインに依存するテンプレートタグがある場合は、必要なプラグインを同時に配布する。
テーマで利用するファイル
デザイン用の画像や JavaScript を、テーマにエクスポートします。標準では、以下の拡張子のファイルが含まれます。
- jpg、jpeg、gif、png、js、css、ico、swf、flv
環境変数 ThemeStaticFileExtensions を指定すると、エクスポートするファイルの種類を追加できます。
テーマで必要なファイルは、ワークスペース/スペースの公開パスにフォルダを作成してアップロードしてください。エクスポート時に、フォルダを指定してファイルをテーマに含めます。トップレベルのフォルダのみ指定可能です。サブフォルダは指定できませんが、指定したトップレベル内のサブフォルダのファイルはエクスポートされます。例えば、以下のようなフォルダにファイルをアップロードします。
サイトルート/ theme-images/ logo.jpg corner.png theme-js/ jquery.theme.js theme-css/ theme.css
カテゴリとフォルダ
テーマにエクスポートする、カテゴリとフォルダを作成します。エクスポートしたテーマを適用すると、自動でカテゴリとフォルダが作成されます。
テーマのエクスポート
以下の手順でテーマをエクスポートします。
- ページ上部のナビゲージョンからワークスペースあるいはスペースを選択する
- サイドメニューから [インポート / エクスポート] - [テーマのエクスポート] を選択する
テーマの設定項目
- 名前(必須)
管理画面のテーマ一覧に表示する名前です。
- 出力ファイル名(必須)
/themes/ フォルダに、出力ファイル名でテーマを保存します。アルファベット、数字、ダッシュ( - )、
アンダースコア( _ )のみ利用できます。- バージョン(必須)
テーマの内容を更新したら、バージョン番号を新しくします。
- 説明
管理画面のテーマ一覧に表示するテーマの説明です。
- 作者名
このテーマの作者の名前。
- 作者のページ
作者のホームページ。作者名からリンクします。
オプション
テーマに含めてエクスポートする項目のチェックボックスを選びます。"詳細" をクリックして、エクスポートする内容を選択します。
- カテゴリ
カテゴリをテーマにエクスポートすると、テーマ適用時に、自動でカテゴリを作成します。
- フォルダ
フォルダをテーマにエクスポートすると、テーマ適用時に、自動でフォルダを作成します。
- ファイル
詳細をクリックしてフォルダ名を入力します。フォルダ名は、フォーム内に一行ずつ記載します。スペースのサイトルート直下のみ指定可能です。
theme-images theme-js theme-css
- テンプレートセット
カスタマイズしたテンプレートをエクスポートします。詳細をクリックして、テーマとして必要なテンプレートを選択してください。
- 出力形式
-
- "テーマディレクトリへのインストール" : このPowerCMSの/themes/フォルダにテーマを保存します。保存したテーマは、ワークスペース/スペースの[テーマの一覧]に表示されます。
- "zip形式アーカイブでダウンロード" : テーマをzip形式でダウンロードして、他のPowerCMSにインストールします。
項目を指定したら、[テーマのエクスポート] ボタンをクリックします。
テーマを利用する
作成したテーマは、別の PowerCMS で利用したり、配布することができます。
- ダウンロードしたフォルダを解凍して、他の PowerCMS の /themes/ フォルダにアップロードする
- 管理画面のテーマ一覧に表示される
- 次は
- 一覧へ