「スタイルシートが見つかりません」の正体。テーマアップロードで失敗した話。

WordPressにテーマをアップロードしたら、こんなエラーメッセージが出たことはありませんか？

「スタイルシートが見つかりません。」

初めて見ると「スタイルシートって何？」「何がいけなかったの？」と焦りますよね。実はこのエラー、原因はほぼ決まっています。そしてその原因を知っておくだけで、同じ失敗を防ぐことができます。

この記事では、WordPressのテーマアップロードでよくある失敗パターンと、正しい方法をわかりやすく解説します。

「スタイルシートが見つかりません」は何を意味するのか

まずエラーの意味を理解しましょう。

WordPressのテーマには、必ずstyle.cssというファイルが必要です。このファイルはテーマのデザイン情報だけでなく、テーマの名前やバージョンなどの基本情報も含んでいます。WordPressはテーマをインストールするとき、このファイルを探して「ここにテーマがありますよ」と認識します。

「スタイルシートが見つかりません」というエラーは、WordPressがstyle.cssを見つけられない状態を意味しています。

つまり原因はフォルダの構造がおかしいということです。

ではなぜフォルダ構造がおかしくなるのか。よくある失敗パターンが2つあります。

失敗パターン①：Macの右クリック圧縮で起きる問題

Macをお使いの方に特に多い落とし穴です。

Macでフォルダを右クリックして「”○○”を圧縮」を選ぶと、ZIPファイルが作成されます。一見問題なさそうに見えますが、このとき__MACOSXという隠しフォルダが一緒に圧縮されてしまいます。

__MACOSXはMacOSが管理用に自動生成する隠しフォルダです。

Macはファイルやフォルダを管理するために、見えないところで様々な情報を記録しています。例えば「このフォルダのアイコンの位置」「最後に開いた日時」「ファイルの色分けタグ」など、Macが使うための内部情報です。この情報を保存しているのが__MACOSXフォルダです。

Macを使っている分には全く問題ありません。しかし右クリックで圧縮すると、この__MACOSXフォルダがZIPの中に一緒に入ってしまいます。

イメージとしては、引越しのダンボールに「自分の荷物」と一緒に「引越し業者の道具」まで入ってしまった状態です。中身は増えているのに、必要なものがどれかわかりにくくなってしまう感じですね。

WordPressにとって__MACOSXは全く不要なものです。しかもこのフォルダが混入することで、ZIPを展開したときのフォルダ構造が複雑になり、WordPressが「テーマのファイルはどこ？」と正しく見つけられなくなることがあります。

Macで自分でZIPを作成する場合は、ターミナルで以下のコマンドを使うと__MACOSXを除外したクリーンなZIPが作成できます。

zip -r my-original-theme.zip my-original-theme –exclude “*.DS_Store” –exclude “__MACOSX/*”

失敗パターン②：ファイルマネージャーで展開すると二重構造になる

レンタルサーバーのファイルマネージャーを使ってZIPを展開したときに起きやすい問題です。

正しいフォルダ構造はこうなっているべきです。

themes/
└── my-original-theme/
       ├── style.css
       ├── functions.php
      └── ...

しかしファイルマネージャーで展開すると、こうなってしまうことがあります。

themes/
└── my-original-theme/
       └── my-original-theme/
              ├── style.css
              ├── functions.php
             └── ...

フォルダが二重になっているのがわかりますか？WordPressはthemes/テーマ名/style.cssという構造を期待しているのに、一層余分なフォルダが挟まってしまっています。これが「スタイルシートが見つかりません」の原因になります。

正しいテーマのアップロード方法

結論から言うと、テーマのアップロードはWordPressの管理画面から行うのが一番確実です。

手順はとてもシンプルです。

1. WordPress管理画面にログイン
2. 「外観」→「テーマ」をクリック
3. 「新しいテーマを追加」をクリック
4. 「テーマのアップロード」をクリック
5. ZIPファイルを選択してアップロード
6. 「今すぐインストール」→「有効化」

WordPressの管理画面からアップロードすると、ZIPの展開から正しいフォルダへの配置までWordPressが自動で正しく処理してくれます。二重構造になる心配もありません。

ファイルマネージャーを使う必要があるのは、管理画面にアクセスできないトラブルが起きたときなど、特別な状況に限られます。通常のテーマインストールは管理画面からが鉄則です。

Kuuテーマ開発中に実際に起きた話

これは実際にKuuテーマの開発・アップロード作業中に私が経験したトラブルです。

テーマを修正してZIPを作成し、シンレンタルサーバーのファイルマネージャーからアップロードして展開。ところが「スタイルシートが見つかりません」というエラーが出て、WordPressの管理画面にさえ入れない状態になってしまいました。

原因を調べると、ファイルマネージャーで展開したことでmy-original-theme/my-original-theme/という二重構造になっていたのです。

さらにその前には、Macの右クリック圧縮で作ったZIPに__MACOSXフォルダが混入して、別のトラブルを引き起こしたこともありました。

何度かこのエラーに遭遇して気づいたことがあります。

テーマのアップロードは管理画面から。これだけで多くの問題は防げる。

その後はZIPの作成をターミナルコマンドで行い、アップロードはWordPressの管理画面から行うという手順に統一しました。それ以降、同じトラブルは一度も起きていません。

テーマのアップロードは「管理画面から」が鉄則

「スタイルシートが見つかりません」というエラーの原因は、ほとんどの場合フォルダ構造の問題です。

• Macの右クリック圧縮は__MACOSXが混入することがある
• ファイルマネージャーでの展開は二重構造になることがある
• WordPressの管理画面からのアップロードが一番確実

テーマのインストールや入れ直しの際は、ぜひ管理画面からのアップロードを試してみてください。この一つを覚えるだけで、ほとんどの失敗は防ぐことができます。

WordPressの「なんでこうなるの？」という疑問も、仕組みを理解すれば怖くなくなります。一つひとつ積み重ねていきましょう

参考文献

気になる内容はぜひリンク先もご覧ください。