システム管理

このページでは a-blog cms を利用される上でよくはまるトラブルとその解決方法についてご紹介しています。

システム管理

目次

バックアップに失敗する

バックアップ機能が途中で止まってしまう場合、zipへの圧縮に失敗している可能性があります。圧縮に失敗する理由として圧縮に一時領域を使用するのですが、サーバーによって一時領域が足りず失敗してしまうことがあります。

これを解決するために、一時的に一時領域の場所を変更することで解決することがあります。

config.server.php に以下１行を追記します。「/path/to/tmp」は環境に合わせたパスを設定ください。（ドキュメントルートの一階層上など）

putenv('TMPDIR=/path/to/tmp'); // ドキュメントルートより上の階層を設定ください
一時領域の変更

Ver. 2.11.0 未満からアップデートしたらHTMLタグが表示されるようになってしまった

Ver. 2.11.0 から 校正オプションの仕様が変わり、校正オプションが指定されている場合も自動でサニタイズ（エスケープ）処理がされるようになりました。 これにより、アップデート後に閲覧画面を表示すると意図していないHTMLがタグのまま表示されてしまう可能性がございます。

詳細・対応方法は以下をご覧ください。

オンラインアップデートやバックアップ、リストア、CSVインポートなどで、プログレスバーが動かなくなる

オンラインアップデートやバックアップ、CSVインポートなどのバックグラウンドでプログラムを実行する機能を使用し、何かしらの理由により処理が止まってしまった場合、プログレスバーがそのままの状態で動かなくなってしまう場合があります。

バックグラウンドで実行される機能例

  • オンラインアップデート
  • バックアップ
  • リストア
  • CSVインポート

修正方法

この場合、a-blog cms 設置場所にある、cache ディレクトリ内にあるファイル（.htaccess以外）を削除していただくことで、プログレスバーを止めることができます。

.htaccess は削除しないでください。

接続元IPアドレスが正しく取得できない・ログイン制限が正常に動作しない

接続元IPアドレスのグローバル変数が正しく取得できなかったり、ログの接続元IPアドレスやログイン制限が正しく動作しない場合がございます。

これはリバースプロキシやCDN、ロードバランサーなどが入っている場合に、正しい接続元IPアドレスが取得できないためになります。

対策方法

リバースプロキシなどが入っている環境でも正しく接続元IPアドレスを取得するには「config.server.php」の「TRUSTED_PROXY_LIST」に信頼できるプロキシのIPアドレスを設定ください。

複数ある場合はカンマで区切って指定します。

define('TRUSTED_PROXY_LIST', 'xxx.xxx.xxx.xxx,yyy.yyy.yyy.yyy');

これは「X-Forwarded-For」HTTPヘッダーから接続元IPアドレスを取得するときに、偽装された接続元IPアドレスを取得しないようにするための対策となっております。 （「X-Forwarded-For」は簡単に偽装できるため）

アップデートしたら管理画面にスタイルが当たらなくなった

アップデートしたら管理画面にスタイルが当たらなくなってしまった場合、以下の原因が考えられます。

  • 管理画面のCSSが適用されていない
  • バージョンが古いテンプレートを使用している

詳しく説明していきます。

管理画面のCSSが適用されていない

a-blog cms の管理画面のCSSは、/themes/system/css/ディレクトリに設置されています。
以下のCSSがなかった場合、正常にページが表示されない可能性があります。

  • normalize.min.css
  • acms-system.min.css
  • acms-admin.min.css

アップデート時にうまくアップロードされていなかった場合、再度アップロードし直すことで解決できます。

CSSがうまくアップロードできていなかった場合は、以下のような特徴があります。

  • 一切管理画面のスタイルが適用されておらず、HTMLのデフォルトのスタイルが適用されている
  • サイドナビゲーション項目がページの上部に表示される
CSSがうまくアップロードできていない場合のダッシュボード画面。 一切管理画面のスタイルが適用されておらず、HTMLのデフォルトのスタイルが適用されており、サイドナビゲーション項目がページの上部に表示されます。

バージョンが古いテンプレートを使用している

古いテンプレートを使用している場合に、正しくスタイルが適用されない可能性があります。

よくあるパターンとしましては、/admin/blog/edit.htmlなどの一部分のファイルを使用しているテーマに設置しており、一部分だけスタイルが適用されていないケースです。
Ver.1系から使用されているサイトでとくにみられるケースです。たとえばブログ管理のページで、Ver.1系の/admin/blog/edit.htmlを適用していると以下の図のような状態になります。

Ver.1系の/admin/blog/edit.htmlを適用している場合のスクリーンショット。特徴としては、ツールチップが四角の画像になっており、保存・戻るボタンがページ内の下部に設置されており、「基本設定」「カスタム設定」「エクスポート・インポート」などのタブがない状態になります。しかし、サイドナビゲーションや、トピックパスにはスタイルが正常に適用されています。

Ver.1系の/admin/blog/edit.htmlを適用している場合は、以下のような特徴があります。

  • ツールチップが四角の画像になっている
  • 保存、戻るボタンがページ内の下部に設置されている
  • 「基本設定」「カスタム設定」「エクスポート・インポート」などのタブがない
  • サイドナビゲーションや、トピックパスにはスタイルが適用されている

この場合の解決策としては、原因となっているテンプレートをリネームまたは削除することで解決できます。
もし何らかの理由でアップロードしている場合は、/themes/system/から新しいテンプレートを複製し、カスタマイズし直してください。