バージョン1.7.0
リリース日：2013/06/24アップデートマニュアル
a-blog cmsをダウンロードいただき、ありがとうございます。 このドキュメントでは、a-blog cmsの新機能の概要やアップデート方法、その他注意事項などを説明しています。 v1.6.0以降からのアップデートを前提に解説しています。v1.6.0未満のバージョンからアップデートされる場合には別 途ドキュメント「旧バージョンからのアップデート」も合わせてご確認ください。 1. v1.7.0 へのアップデート方法 ...2 2. アップデート後の注意事項...4 3. 【重要】テーマの変更点とアップデート時の注意事項...6 4. システムの変更点（v1.7.0）...7 5. システムの変更点（v1.6.2）...8 6. システムの変更点（v1.6.1）...9 7. システムの変更点（v1.6.0）...10 8. 「omake」フォルダについて ...11 ご不明な点などがございましたら、a-blog cms ユーザーフォーラムまでお問い合わせください。 ‣ a-blog cms ユーザーフォーラム http://forum.a-blogcms.jp/ ‣ 旧バージョンからのアップデート(pdfファイル) http://www.a-blogcms.jp/archives/document/updateOldVer.pdf1. v1.7.0 へのアップデート方法
注意 アップデート作業中にサイト閲覧者がアクセスすると、サイトが正常に表示されない場合がありますので、 アップデート作業をされる際には作業時間・タイミングにご注意ください。1 ファイル・フォルダのバックアップ
以下のファイル・フォルダをバックアップします。 • license.php • config.server.php • カスタマイズしているテーマフォルダ • .htaccess（カスタマイズしている場合のみ） • 「private」フォルダ（カスタマイズしている場合のみ） • その他カスタマイズしているフォルダ・ファイル2 「setup」フォルダのアップロード
「setup」フォルダをアップロードします。 アップロードが完了した時点で、一般に公開しているa-blog cms のページはメンテナンスページの表示に切り替わり ます。アップデート作業をされる際には作業時間・タイミングにご注意ください。3 テーマファイルの更新
テーマファイルを更新します。 「themes」フォルダ内の「system」フォルダを、“フォルダごと上書き”します。 テーマをカスタマイズしている場合は、変更点（「【重要】テーマの変更点と注意事項」参照）に合わせてテンプレー トを書き換えてからアップロードします。4 プログラムファイルの更新
インストールパッケージの「ablogcms」フォルダ内にある「themes」フォルダ と「setup」フォルダ 以外のフォル ダ・ファイルを“上書き”します。このとき、「install」フォルダ内にある license.php / config.server.php / 「archives」フォルダは上書きしないでください。注意
「themes」フォルダ以外のファイルをカスタマイズしている場合は、フォルダ・ファイルを入れ替 える際、カスタマイズしているファイルを新しいファイルと入れ替えてしまわないようご注意くださ い。
5 メンテナンス画面からアップデート開始
a-blog cms を設置したアドレスにアクセスし、メンテナ ンス画面が表示されることを確認してください。 メンテナンス画面でユーザーIDとパスワードを入力し[ロ グイン]ボタンを押してログインします。 「アップデート実行画面へ」のリンクをクリックします。 「アップデートを実行できます」と表示されていることを 確認します。6 データベースの更新
セットアップ画面の[データベースの更新処理を実行]ボタンを押します。7 セットアップディレクトリの削除
アップデートプログラムの実行が終了したら、「setup」ディレクトリを削除します。 削除するまではメンテナンスページが表示されます。8 表示確認と公開
a-blog cmsを設置しているアドレスにアクセスします。各ページの表示を確認し、問題が無ければ公開となります。 必要に応じてデバッグモードをONにすることで、各種エラーメッセージが表示されたり、キャッシュ機能が無効となる など、動作確認のための状態となります。 サーバ上のファイル config.server.php 内の記述 「DEBUG_MODE」の値を確認の上、変更を行う場合は再度アップ ロードしてください。 デバッグモードON デバッグモードOFF define('DEBUG_MODE', 1); define('DEBUG_MODE', 0); 以上でアップデートは完了です。a-blog cms の新機能をご利用ください。2. アップデート後の注意事項
v.1.6.0以前
‣ 校正オプションの適応ルールについて v1.6.0以前からのアップデートの場合、v1.6.1で校正オプションの仕様が変わったため注意が必要です。 v1.6.0以前の校正オプションは、同一モジュール、同一変数の一つに校正オプションを適応すると、それ以降の 変数にも校正オプションが適応されました。 v1.6.1以降のバージョンでは、同一変数一つづつに校正オプションを適応できるようになりました。 この為、動きに違いがでてくる可能性がありますので、テンプレートを修正して頂くか、v.1.6.0以前の /php/Template.phpでファイルの上書きをして下さい。v1.6.0以前の/php/Template.phpを使用するとv1.6.0以前 の校正オプションの仕様で動くようになります。 参考:http://www.a-blogcms.jp/support/manual/customizing/entry-1700.htmlv.1.4系
‣ カスタムフィールド検索フラグの修正 v1.4.0b2∼v1.4.0正式版からのアップデートの場合、カスタムフィールドの問題を修正します。この問題では、 KEYWORDコンテキストを利用したエントリーの全文検索時にカスタムフィールドの値が、検索対象に含まれなくなっ ていることがあり、それを修正します。 ‣ ルールのユーザーエージェントについて v1.4.2より前のバージョンでルールのユーザーエージェントの設定をしていて、v1.4.2以降にアップデートする場合に は、再設定が必要です。v1.5系
‣ config.system.yamlの変更について v1.5.1より、/private/config.system.yaml に以下の項目が追加・変更されています。 tpl_find_from_ascendants_ccd: on この項目がonとなっていることで、子カテゴリー表示時に適用されるテンプレートの扱いが変更になります。2 階層以上のカテゴリーを使用しない場合には影響はありません。詳しくはa-blog cms マニュアル「カテゴリー表示時 のテンプレートの取扱いについて」をご覧ください。 jquery_version: 1.5.2 # (1.7.2|1.6.4|1.5.2) jQueryのバージョンが1.7.2に変更されています。標準は1.5.2となります。 google_api_key:Google Maps APIのバージョンが変わったことにより、この項目は削除されました。
‣ config.server.phpに追加された項目 v1.5.2では、/config.server.php に以下の項目が追加されています。 HOOK_ENABLE この値が1になっていると、HOOK機能（プログラマー向け拡張）が有効になります。詳しくは、/omake/php/ ACMS/User/Hook.phpをご覧ください。 アップデートでシステムファイルをアップロードした後に、アップデートプログラムを実行していない場合に、 「Notice: Use of undefined constant HOOK_ENABLE - assumed ‘HOOK_ENABLE’...」というエラーが表示され ます。その際はアップデートプログラムを改めて実行するか、config.server.phpに下記の記述を手動で追記してくださ い。
追加されたHOOK機能フラグ（1にするとON）
3. 【重要】テーマの変更点とアップデート時の注意事項
バージョンアップで変更となったテーマの変更点と注意事項です。アップデートされる場合は必ずお読みください。バージョン共通でアップデートする時の注意事項
‣ config.system.yaml に変更を加えている場合 private/config.system.yaml は、コンフィグの初期設定をしているファイルです。アップデート以前にこのファイル を変更している場合には、バックアップをとってから上書きして下さい。 このファイルはバージョンアップの都度、追加されている項目がありますので、変更を加えている場合は、手動で変更 差分を編集してください。v1.5.1以前からアップデートする場合の変更点
‣ /themes/system/include/column.html をカスタマイズして利用している場合 v1.5.2でユニット非表示関係の変更があります。カスタマイズされたファイルをテーマ内で利用している場合は、下記 のように変更を反映してください。（詳細はsystem内の実ファイルをチェックしてください） 変更があった部分のコード（4行目付近・data属性やclassが追加されています）<div class="js-edit_inplace align_{column:loop.align}" data-align="{column:loop.align}[align2label]" id="{column:loop.unit_eid}-{column:loop.utid}"><!-- END inplace#front -->
‣ /themes/system/admin/entry/edit.html をカスタマイズして利用している場合
v1.5.2でファイルサイズチェック関係の変更があります。カスタマイズされたファイルをテーマ内で利用している場合 は、下記の変更を反映してください。（詳細はsystem内の実ファイルをチェックしてください）
変更があった部分のコード（3行目と133行目付近・classが追加されています）
<form action="" method="post" enctype="multipart/form-data" id="entryForm" class="js-observeFileSize">
v1.4.xからアップデートする場合の変更点
‣ 同梱テーマ company1, company2, company3, plain, vicuna を利用している場合
v1.5.0より company1, company2, company3, plain, vicuna の各テーマの同梱を終了し、標準的なテーマとして blog, site の2つのテーマとスマーオフォン用テーマ jquerymobile を同梱しました。
サンプルの記述を含むテーマ sample@vicuna については廃止し、同等のテーマとして sample@blog を同梱しまし た。
4. システムの変更点（v1.7.0）
機能追加
• ダイレクト編集機能のインターフェース変更 • キャッシュクリア予約機能 • モジュール設定画面へのリンクに関する変数を追加 • 校正オプションの追加、絵文字削除 • ユーザーエージェントに「サイネージ」を追加既存仕様への追加・変更
• プライベートIPアドレスでのライセンス見直し • CSVによるエントリー更新でentry_idとカスタムフィールドのみでも更新できるように変更 • 変数dateに「date#」を追加修正された問題
• highslide.jsの読み込みバグを修正 • AndroidのUA処理を修正 • Wordpressインポートの不具合を修正 • ユーザー情報（購読者）の変更時に変更できない不具合を修正 • マルチアップロードの順序を修正 • テーマ変更画面にルールが適応される不具合を修正 • 複製におけるカスタムフィールドグループの画像が複製されない不具合を修正 • フォームからのファイルをメールに添付する機能の不具合を修正5. システムの変更点（v1.6.2）
機能追加
• 購読者アカウントの即時アクティブ化オプション • shopモジュール、注文数に応じて商品の在庫数が減少 • ベンチマークモードに機能追加 • バナーモジュールで表示数の設定を追加 • テンプレートのパスをコメントで出力既存仕様への追加・変更
• サイト表示の高速化修正された問題
• カスタムフィールドを使ったファイルアップロードにて、ファイルサイズが再編集時に消える • エントリー編集時のエラーで変更前の画像が消える • ユニットのwysiwigエディタで左上のソート番号を変更するとエディタで編集中の内容が消えてしまう • バナーモジュールでフィールドが増えるバグ • メンテナンスツールで小ブログのドメイン修正に対応6. システムの変更点（v1.6.1）
機能追加
• バナーモジュール（Banner）にランダム表示機能を追加 • バナーモジュール（Banner）に公開日時設定を追加 • 値が無い時用のブロック出力を追加（<!-- BEGIN field名:empty -->）既存仕様への追加・変更
• 校正オプションの上書きを廃止 • グローバル変数 %{HTTP_BID_ARCHIVES_DIR} を追加 • グローバル変数 %{HTTP_YM_ARCHIVES_DIR} を追加 • Twitter API1.1に対応 • アクセスログをPOSTのみにするオプション追加 • アクセスログの保存期間（7日、30日、90日、1年）を追加 • アクセスログのCSVダウンロード機能 • 管理側一覧ページ（エントリー、カテゴリー、ユーザー）へカスタムフィールドの値を出力可能に修正 • カスタムフィールド検索の値比較で小数点に対応修正された問題
• 管理側ナビゲーションに拡張アプリとチェックリストの項目追加 • Android2.3、Safari5.0のJavaScriptエラーを修正 • 新規インストールユーザーが検索にヒットしない不具合を修正7. システムの変更点（v1.6.0）
機能追加
• カスタムフィールド更新時に関連する全データを上書きしているところを、存在するフィールドのみ更新できるよ うに設定機能を追加 • チェックリストを用意 • キーワード検索でURLコンテキストではなくクエリでも指定できるように変更 • グローバル変数のユーザ定義をHookで出来るように拡張 • 拡張アプリ機能を追加 • Touchモジュールの先行評価を追加 • 管理ページ系403の場合も403.htmlテンプレートを使用するように変更 • ブログ、カテゴリー変更に伴う404を301リダイレクトするオプションを追加既存仕様への追加・変更
• キャッシュクリアの感度（cache_sensitivity）の初期値をhighに変更：子ブログ更新時に親ブログも更新するよ うに設定 • 読者登録機能を利用して購読者権限以外のユーザーを作成可能に • エントリーの複製時に日付を最新にするように変更 • Entry_Calendarにリンク先なしで出力できるように変更 • カテゴリーの選択をエントリー数の多い順を用意 • エントリーの複製時に日付を最新にするように変更 • generatorの閉じタグのオプションを追加修正された問題
• ユーザーIDをもたない注文者の情報がDBに記録されない問題への対応 • ダイレクト編集でタイトル編集時にクローズボタンが表示されない問題への対応 • エントリーボディ、サマリー系モジュールのページャーがオフセットを考慮していない問題を修正 • 同一ユーザログインでログアウトをするとすべてのブラウザでログアウトしてしまう問題を修正 • ショップモジュールで空の注文が入る問題を修正 • 同一ユーザでログインしている場合に一人がログアウトすると同じユーザでログインしている人がすべてログアウト になる問題を修正8. 「omake」フォルダについて
収録している内容について
‣ a-blogcmsCodehints.xmp
a-blog cms で使用するコードのコードヒントを収録したDreamweaver用拡張機能ファイルです。ファイルを開くと adobe Extention Managerから「a-blog cms Code Hints」がインストールできます。
‣ a-blogcmsSnippets.mxp
a-blog cms で使用するコードのスニペットを収録したDreamweaver用拡張機能ファイルです。ファイルを開くと adobe Extention Managerから「a-blog cms Snippets」がインストールできます。
‣ jsフォルダ 標準提供されていない機能を jQueryプラグイン化した JavaScript ファイルが含まれます。 ‣ phpフォルダ ユーザーがシステム（モジュール・構成オプションなど）を拡張するためのサンプルPHPファイルが含まれます。 ‣ scheme.sql a-blog cmsのMySQLデータベースのテーブル定義が書かれた参考ファイルです。 ‣ snippetsフォルダ a-blog cmsサイト内のリファレンスで公開しているものと同じスニペットのファイル群です。 ‣ varsフォルダ a-blog cmsサイト内のリファレンスで公開しているものと同じ変数表のファイル群です。
v1.4.2での変更点
v1.4.2より、themes/sample@vicuna/snippets 内にあったスニペットファイルを「omake」フォルダに移動して います。このファイルは、各種モジュールに必要な記述がモジュールごとにまとめられています。必要に応じてコードを コピーしてご利用ください。内容はa-blog cmsのリファレンスページにあるものと同じです。v1.5.0での変更点
• Dreamweaver拡張機能について、v1.5.0 で追加された内容を反映しました。 • jsフォルダにjquery.acms-latlngmapper.js を追加しました。 • phpフォルダにサンプルPHPファイルを追加しました。 • snippetsフォルダ、varsフォルダについて、 v1.5.0 で追加された内容を反映しました。v1.5.1での変更点
• snippetsフォルダ、varsフォルダについて、 v1.5.1 で追加された内容を反映しました。
v1.5.2での変更点
• snippetsフォルダ、varsフォルダについて、 v1.5.2 で追加された内容を反映しました。 • phpフォルダにACMS_User_Hookのサンプルファイルを追加しました。
