SWELLのテーマファイルを調べるときに、テンプレート、PHPクラス、CSS・JavaScriptの置き場所を区別するための一覧です。2026年10月21日に手元のSWELL 2.19.0保存環境の直下ファイル・登録処理・style.cssを照合した一覧です。最新版の配布ZIPとの完全比較や再ビルドの検証ではありません。
- ブロックエディタ用のブロックと編集スタイル
- 表示速度や出力を調整する設定
- フックやテンプレートパーツによる拡張
- 管理画面・カスタマイザーの設定項目
などの機能があります。対応範囲や効果は、使うバージョン・ページ・設定に応じて確認します。
テーマ直下のテンプレートはWordPressのテンプレート階層に従って選ばれます。parts/にはSWELL独自のテンプレートパーツがありますが、直下のテンプレートを自動的に上書きする場所ではありません。子テーマで上書きできるかは、対象ファイルの呼び出し方を確認して判断します。
SWELLの技術的な構成面まとめ
SWELLの技術的な特徴をまとめると以下になります。
- 管理画面で変更する箇所と、コードで拡張する箇所を分ける
- 対象の呼び出し元を確認して変更範囲を決める
- テーマの更新前後で変更箇所を再確認する
もう少し詳細を書くと以下の通り。
| 項目 | 解説 |
|---|---|
| 構造設計 | 公式のSWELL 2.0変更点では、多くの機能のクラス化とテンプレートパーツの分割が説明されています。 |
| ブロックエディタ対応 | SWELL独自のブロックと編集用スタイルがあります。対応状況は使用するWordPress・SWELLの組み合わせで確認します。 |
| CSS/JSビルド構成 | 配布版のソース構成と再ビルド手順は本稿では未確認です。親テーマを直接編集する手順として扱わないでください。 |
| 表示速度対策 | 画像などの遅延読み込みやキャッシュに関する機能があります。効果は設定とページの内容によって変わります。 |
| ユーザーUI（管理画面） | カスタマイザーや投稿編集画面で設定します。画面と項目はバージョンによって変わります。 |
| 子テーマ拡張性 | 子テーマを使って拡張します。パーツの上書きは、対象ファイルの呼び出し方と子テーマ参照の有無を確認して判断します。 |
ファイル名だけでは上書き可否を判断できません。呼び出し元と実際の表示条件を確認してください。
WordPress テーマ「SWELL」のテーマ直下のフォルダ･ファイル
保存環境の直下にある主要フォルダ・ファイルをまとめます。
以下は保存環境で存在を確認した名前です。本稿の見直しではSWELL 2.0の公式変更点とWordPress公式資料を照合しました。配布ZIP全体の完全性、最新版との差、ビルド実行、各パーツの上書き可否は未照合です。親テーマを直接編集すると更新で変更が失われるため、カスタマイズは子テーマや利用可能なフックを検討します。
フォルダ
| フォルダ名 | 備考 | 補足 |
|---|---|---|
| assets | 静的アセット（素材）を格納するフォルダ | 保存環境にはJavaScriptライブラリ等もあるため、画像素材だけの場所ではありません。 |
| build | 掲載時の一覧にあるフォルダ | 保存環境ではCSS・JavaScriptの出力ファイルを確認。直接編集や再ビルドは案内しません。 |
| classes | テーマの中核をなすPHPクラスたち | 機能の本体。 テーマ機能を実装するPHPクラス群 |
| languages | 多言語対応（i18n）用の翻訳ファイル | POEditorなどで作成・編集 |
| lib | テーマの内部ライブラリ・フック・API | WPとの連携や初期設定。 登録処理やWordPressとの連携処理 |
| parts | テンプレートパーツ | テンプレートパーツ群 |
| src | 掲載時の一覧にあるフォルダ | 保存環境でソース用ディレクトリを確認。依存関係とビルド手順の実行検証はしていません。 |
| tmp | テンプレートファイルの置き場所 | 保存環境ではfront.phpとpopular.phpを確認 |
ファイル
基本的にはWordPressのテンプレートが直下に置かれています。
| 404.php | 404 Not Found ページのテンプレート |
|---|---|
| archive-term.php | SWELLのarchive.phpから呼ばれるターム用パーツ。WordPress標準のテンプレート階層名ではない |
| archive.php | アーカイブページ（一覧ページ）」全体に対応するテンプレート |
| attachment.php | 画像やPDFなど「添付ファイルの個別ページ」を表示するテンプレート |
| author.php | 「著者（Author）」別の投稿一覧ページを表示するテンプレート |
| comments.php | 投稿ページなどにコメント一覧と投稿フォームを表示するテンプレート |
| footer.php | フッター部分のテンプレートファイル |
| functions.php | SWELLテーマのエンジン部分（起動・構造）を司る中枢的なファイル |
| header.php | ヘッダー（ページ最上部）」＋初期構造の出力テンプレート |
| home.php | 投稿ページのトップ（home）」を表示するテンプレート |
| index.php | 他のテンプレートが存在しないときに使用される最終テンプレート |
| licence | SWELLで使われているサードパーティライブラリとそのライセンス情報 |
| page.php | 固定ページを表示するためのテンプレート |
| sass-builder.js | Sass（SCSS）ファイルを CSS にビルド（変換）する Node.js スクリプト |
| screenshot.png | テーマ選択画面等で使うプレビュー画像 |
| search.php | 検索結果ページ（検索クエリによる投稿一覧）を表示するテンプレート |
| searchform.php | 検索フォーム（検索入力欄＋送信ボタン）を出力するテンプレート |
| sidebar.php | サイドバーを出力するテンプレート |
| single-lp.php | ランディングページ（LP）専用テンプレート |
| single.php | 投稿記事ページを表示するためのテンプレート |
| style.css | WordPress テーマ「SWELL」のテーマ定義ファイル |
WordPress テーマ「SWELL」のテーマ定義ファイルの中身
下表のRequires PHP: 7.3.0は掲載した過去版の最低条件で、現在の運用推奨ではありません。PHP 7.3はサポートが終了しています。WordPressの要件とPHPのサポート期間を確認し、使用するSWELL・プラグインとの互換性も確認して、サポート中のPHPを選びます。
| 項目 | 内容 | 解説 |
|---|---|---|
Theme Name | SWELL | WordPressテーマの名称。管理画面でもこの名前で表示されます。 |
Theme URI | https://swell-theme.com/ | テーマの公式サイト。マニュアルや購入ページなどへのリンク。 |
Description | シンプルなのに高機能… | テーマの概要。管理画面で表示され、他のテーマと区別できます。 |
Version | 2.19.0 | テーマのバージョン。更新の際に重要。 |
Requires at least | 6.8 | WordPressの最低対応バージョン。 |
Requires PHP | 7.3.0 | この保存版の宣言上の最低値。PHP 7.3の運用を推奨する意味ではありません。 |
Author | LOOS,Inc. | 開発会社。WordPress有料テーマ「SWELL」の開発元。 |
Author URI | https://loos.co.jp/ | 開発者の公式サイト。会社概要など。 |
Text Domain | swell | 翻訳の識別子。__()や_e()関数で使われる。 |
Domain Path | /languages | 翻訳ファイル（.mo/.po）を格納するディレクトリ。 |
License | GNU General Public License | style.cssの宣言。licenceファイルには例外を除くGPL version 3の記載があります。個別素材の条件は別途確認します。 |
License URI | http://www.gnu.org/licenses/gpl.html | ライセンスの詳細説明ページへのリンク。 |
SWELLで使われているライブラリ･ライセンス一覧
同梱ライブラリとライセンスは、使用するSWELLの配布ファイルにあるライセンス表記と各ライブラリのLICENSEで確認します。今回、保存環境のlicenceファイルでLuminous・Swiperなどの例外表記を確認しました。ただし全同梱ファイルと各LICENSEの突合、バージョン、アイコン・フォント・コードごとの条件の全確認はしていません。
具体的な変更方法はSWELLカスタマイズまとめから選べます。
子テーマが必要かどうかの判断は、SWELLの子テーマは必要か｜要るケースと要らないケースにまとめています。
