a-blog cms 公式テーマ「site2019」のXDファイルがダウンロードできるようになりました。

使用用途について

site2019.xdはa-blog cms サンプルサイト内の「会社概要」「製品情報」などの計13ページ分のテンプレートを含んだXDファイルです。今回バージョンからスマホ用のアートボードが追加され、XD上で計26枚分のデザインを自由にカスタマイズできるようになりました。

公式テーマ「site2019」をベースにしてサイトを制作する際に、主に次のような用途でご利用いただけます。

• カスタマイズのシミュレーション
• サイトパーツのパターン作成
• デザインコンポーネントの管理
• プロトタイプの共有

ファイルの仕様について

ファイル内では、site2019のサイトパーツをコンポーネントとして登録し、使用しているモジュールIDやインクルードファイルについてコメントでまとめています。

さらに各コンポーネントごとに管理しやすくするため、ファイル内のマスターコンポーネントのみをまとめた「マスターコンポーネント一覧」というアートボードを用意しました。

特に多くの役職が携わる制作プロジェクトでは、デザインスタイルとテンプレート情報を一括して管理することで、作業工程に一貫性が生まれます。デザイナーの方だけでなく、ディレクターの方やエンジニアの方も、情報を共有をする資料の1つとして是非ご活用ください。

サーバー必要条件

必要ソフトウェア

• PHP 7.3 〜 8.3.x
• MySQL 5.0.0以上 or MariaDB
• Webサーバー (Apache2.0以上 or Nginx)
• ionCube Loader 4.6.2以上　＊Ver. 3.0 以上の場合不要

URLの書き換え

URLの書き換えができる必要があります。

Apache

• RewriteEngineの有効化
• .htaccessの利用許可(AllowOverride)
• UserDirディレクティブを使った場所では動きません（例: http://example.com/~hoge/）

Nginx

• /index.php にリライトされるようにRewrite設定を行う
• ルートディレクトリおよび、archive, media, storage, cache, private, themesディレクトリにある .htaccess の内容をNginx側で設定を行う

PHP Extensions

必須

• GD
• mbstring
• PCRE
• PDO
• PDO_MYSQL
• cURL
• zip

オプション

• ImageMagick - GDではなくImageMagickを利用したい場合（config.system.yaml => image_magick : on）
• Gettext - 管理画面を多言語化したい場合
• SimpleXML - 外部API系モジュールを利用したい場合
• OPcache - PHPの中間コードのキャッシュをしたい場合

a-blog cms Ver. 3.0 以上の場合は以下も利用可能です

• APC User Cache - CMSの内部キャッシュとして使用したい場合
• PhpRedis - キャッシュサーバーとしてRedisを使用したい場合

データベース必須ユーザー権限

• SELECT
• INSERT
• DELETE
• UPDATE
• CREATE
• ALTER
• INDEX
• DROP

メール送信

a-blog cms ではメール送信をするために２種類の方法があります。 両方法とも「symfony/mailer」ライブラリを使用して送信しています。

管理画面対応ブラウザ

a-blog cmsの管理画面を動作させるためのブラウザ環境です。すべてのブラウザで最新版を推奨しています。

• Google Chrome
• Mozilla Firefox
• Safari
• Microsoft Edge
• iOS Safari
• モバイル版 Google Chrome

• IPアドレス
• localhost
• ドットが１つ以上あるドメイン

＊ localhost を除くドットなしドメインはご利用いただけません。

サブドメイン・別ドメイン を子ブログに設定

インストールしたシステムの子ブログに、サブドメインや別ドメインを設定することも可能です。

その際には、サーバー側の設定で hoge.com と fuga.hoge.com などのドキュメントルートを同じディレクトリに設定する必要があります。また、ライセンスによって利用が制限されていますので、詳しくはライセンスページをご覧ください。

CMSで接続元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」は簡単に偽装できるため）

CMS機能を使った、常時TLS/SSL対応には、CMSがhttpsでのアクセスか判定できる必要があります。 a-blog cmsでは下記のパラメーターをみてhttpsのリクエストか判定しています。この判定がうまくいかない場合、リダイレクトループなど正常でない動作になる場合がありますのでご注意ください。

どれかに１つでも当てはまる場合にhttpsのリクエストとして判定

• $_SERVER['HTTPS'] に値がセットされている場合
• $_SERVER['SERVER_PORT'] === '443' の場合
• $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https' の場合

管理ページ > コンフィグ > アクセス設定 の BASIC認証を利用するためには、下記パラメーターがPHPで取得できる必要があります。

• $_SERVER['PHP_AUTH_USER']
• $_SERVER['PHP_AUTH_PW']

このパラメーターが取れない場合は、.htaccessなどでCMSの機能を使わず設定ください。

画像のロスレス圧縮（可逆圧縮）

画像をロスレス圧縮することにより、画像サイズを小さくすることができ、サイトのパフォーマンスも向上します。 CMSで画像のロスレス圧縮をする場合は、以下対応ライブラリをインストールする必要があります。全てインストールするのではなく、各拡張子で必要なライブラリをどれか1つあれば動作します。

• pngquant
• optipng
• pngcrush
• pngout
• advpng
• jpegtran
• jpegoptim
• gifsicle
• svgo