2024.8.23|テーマをVer4.1.5.7にアップデートしました
お知らせ

Cocoonのアップデートによる影響への対応

この記事は約5分で読めます。

親テーマの「Cocoon」をVer1.9.9(Ver1.9.9.5.3)に更新するとCocoonのブロック(アイコンリスト、白抜きボックスなど)でエラーやデザイン崩れが発生しています。

このページではエラー表示やデザイン崩れに関する対処方法をまとめていますので、説明に沿って対応するようにしてください。

ブロックに「無効なコンテンツが含まれています」と表示される

Cocoonのバージョンを1.9.9に更新すると、すでにページ内に配置しているブロックが「このブロックには、想定されていないか無効なコンテンツが含まれています。」と表示され編集できないようになっている場合があります。

エラーが発生する可能性のあるブロック
  • アイコンリスト
  • タブボックス
  • ラベルボックス
  • 案内ボックス など

対処方法その1 そのまま触らず放置する

エラーが生じていてもページを更新しなければすでに公開しているページ上では表示されているはずですので、すでにページが完成している場合はそのまま触らず放置してください。

何もせず放置しておくと気づいたら直っていたりする場合もあります。また、Cocoonの次のバージョンアップで元に戻る場合もありますので、公開しているページが特に支障出ていない場合は放っておくようにしましょう。

対処方法その2 ブロックを作り直す

エラーが気になる場合やブロックを編集したい場合は大変面倒ですが、1つずつブロックを新たに挿入して作り直してください。

Cocoonブロックに枠線が付いたりブロック内の余白がおかしくなってしまった

Cocoonのバージョン1.9.9から(?)アイコンリストを含めCocoonの一部のブロックに「blank-box」というCSSのクラス名が新たに追加された影響で枠線がデフォルトで付くようになったり、余白がおかしくなってしまう現象が発生しています。

影響のあるブロック
  • アイコンリスト
  • タブボックス
  • 案内ボックス
  • 白抜きボックス
  • 付箋風ボックス など

この影響を解消するために修正用のCSSを用意しましたので、以下の手順に沿ってCSSファイルを更新してください。

最新版のテーマファイル(Ver1.2.1.1~)をお使いの場合はすでに修正した内容を反映していますので、以下の手順は必要ありません。

修正版CSSを適用する

STEP1

修正用のCSSファイルを開いてコードをコピーする

以下のリンク先を開くと修正版CSSファイル(Ver1.2.1.1)の中身が表示されるので、コードを全て選択してコピーしてください。

※Windowsの場合、キーボードのショートカットキーCtr+Aで全て選択できます。

STEP2

CSSファイルを上書きしてファイルを更新する

管理画面サイドメニューから「外観>テーマエディター」を開き「style.css」を編集する画面を表示します。

テーマの編集画面を開いたらファイルの内容を一旦全て削除し、先ほどコピーしたコードを貼り付けてファイルを更新してください。

もしファイルの更新をクリックしてもエラーが出てファイルを更新できない場合は、サーバーのWAF設定が影響していることが考えられますので、WAF設定を無効にした上で再度お試しください。

修正版CSS(Ver1.2.1.1)に含まれる内容

修正版のCSSには以下のCSSコードを追加・修正しています。

修正版CSSで追記・修正した内容
/* Ver1.2.1.1で削除
.blank-box {
    margin: 1em 0;
    padding: 0;
}
*/

.余白なし {
    margin: 0 !important;
    padding: 0 !important;
}

.枠線なし {
    border: none !important;
}

Ver1.2.1で「blank-box」のクラスに対して余白を無くすようにしていたので今回の修正で無効にし、追加CSSクラス用のスタイルを追加しました。

Cocoonのアイコンリストではデフォルトで枠線が付くようになっていますが、追加CSSクラスを入力することで枠線を非表示にしたり余白を無くしたりできるようになっていますので、デザイン面でこだわりたい場合は追加CSSクラスを使うようにしてください。

追加CSSクラスの使い方については以下のページにまとめていますので、使い方が分からない場合は以下のページを参考ください。

アイコンリスト(デフォルト)
  • これはアイコンリストです
  • これはアイコンリストです
  • これはアイコンリストです
アイコンリストの追加CSSクラスに「枠線なし」を追加した場合
  • これはアイコンリストです
  • これはアイコンリストです
  • これはアイコンリストです

ブロックやページの背景が白色の場合は枠線の色を白にすると背景色と同化されるので、特に背景色を指定していない場合は追加CSSクラスを追加せずとも枠線の色を白にした方が手っ取り早いです。

アイコンリストの追加CSSクラスに「余白なし」を追加した場合
  • これはアイコンリストです
  • これはアイコンリストです
  • これはアイコンリストです

KadenceBlocksの「RowLayout」などでブロックを入れ子にする場合はこの追加CSSクラスを指定すると見た目がスッキリします。

なお、追加CSSクラスは複数設定できますので、枠線も余白も無くしたい場合は「枠線なし 余白なし」と半角スペースで区切ってクラス名を入力します。

アイコンリストの追加CSSクラスに「枠線なし 余白なし」を追加した場合
  • これはアイコンリストです
  • これはアイコンリストです
  • これはアイコンリストです

現場からは以上です。