拡張アプリで様々な拡張をする場合、プログラムだけではなく管理ページを拡張したい場合があると思います。例えば、モジュールID化したいため、モジュール選択肢のテンプレートを拡張したい、拡張アプリ用の管理画面ページ（コンフィグページ）を作りたいなどです。

テンプレートの挿入方法

テンプレートを挿入するためには、ServiceProviderの initメソッド で 挿入処理を書く必要があります。

例: extension/plugins/SamplePlugin/ServiceProvider.php

<?php

namespace Acms\Plugins\SamplePlugin;

use ACMS_App;
use Acms\Services\Common\InjectTemplate;

class ServiceProvider extends ACMS_App
{
    /* 省略... */

    /**
     * サービスの初期処理
     */
    public function init()
    {
        $inject = InjectTemplate::singleton();
        $inject->add('admin-module-select', PLUGIN_DIR . 'SamplePlugin/template/module-select.html');
    }

    /* 省略... */
}

ポイント

Acms\Services\Common\InjectTemplate のオブジェクトを

$inject = InjectTemplate::singleton();

で取得して addメソッド でテンプレートを挿入します。

$inject->add('挿入先', 'テンプレートのパス');

• 第一引数: 挿入先の識別子
• 第２引数: 挿入するテンプレートパス（PLUGIN_DIR定数 を使うと便利です）

挿入先の仕込み

テンプレートはどこでも挿入できるわけではなく、挿入先に仕込みがされています。

例えば、モジュールIDのセレクトの選択肢のテンプレート（themes/system/admin/module/select.html）を見ると以下のような記述があります。

<!-- BEGIN_MODULE Admin_InjectTemplate id="admin-module-select" --><!-- END_MODULE Admin_InjectTemplate -->

この Admin_InjectTemplateモジュール の id に指定されている識別子が、テンプレートを挿入するときに使う Acms\Services\Common\InjectTemplate の addメソッド の第一引数に指定されます。

挿入先一覧

不具合修正

• CMS-6359 拡張アプリの状態が「要アップデート」の場合に、拡張メニューに、有効化がされていない拡張アプリのメニューが表示されてしまう問題の修正
• CMS-6357 Entry_Summary, Entry_GeoList, Entry_Photo, Entry_List, Entry_Headline, Entry_TagRelational, Category_EntrySummaryモジュールの変数表を更新（sort, usort, csort, ecd）
• CMS-6363 多言語ユニットの場合、ブログ・エントリーのインポートで、ID（メディアなど）がずれて正常にインポートできない問題を修正
• CMS-6364 レンタルサーバーによって、sendmailではメールが送信できない場合がある問題を修正
• CMS-6369 pdfjsをアップデート

CMS-6363 多言語ユニットの場合、ブログ・エントリーのインポートで、ID（メディアなど）がずれて正常にインポートできない問題を修正

多言語ユニットの利用している時、ブログ・エントリーのエクスポートをして、インポートをすると、メディアIDがずれてしまい、元と違った画像やファイルが表示されてしまう不具合を修正しました。

CMS-6364 レンタルサーバーによって、sendmailではメールが送信できない場合がある問題を修正

Ver. 3.0.24 での「CMS-6331 メールライブラリを変更 swiftmailer -> symfony/mailer & メールのISO-2022-JP文字コードを廃止」が影響して、レンタルサーバーによっては、メール送信ができない不具合を修正しました。

メール送信できない条件

• a-blog cms のバージョンが、Ver. 3.0.24
• sendmailを利用（管理ページのメールのコンフィグで、SMTPを設定していない）
• 再現する一部レンタルサーバー（現状ヘテムルで確認されています。Xserverは問題ありません）

最後に

該当する問題がありましたら、お早めにバージョンアップのご検討をお願いいたします。また、迅速にご報告いただいたユーザーの皆さま、誠にありがとうございました。

今後もご報告いただいた内容に対して真摯に受け止め修正と改善を行ってまいります。 今後ともどうぞよろしくお願いいたします。

Added

• Order_Summaryモジュールで注文商品・決済方法・追加手数料・配送地域・総注文商品（エントリー）数合計・総注文商品の数量合計のデータを出力できるブロック、変数を追加
• ShoppingForm モジュールで適用中の決済方法の説明用画像を表示できるように改良
• 決済方法に利用条件を設定できる機能及び、利用条件を満たした決済方法を表示するモジュール(Payment_Select)を追加
• フォーマットした送料無料のしきい値（小計）を表示するグローバル変数（%{SHIPPING_FREE_SUBTOTAL_FORMATTED} ）を追加
• ShoppingCart 及び ShoppingCart_Summary モジュールで配送グループ（shippingGroup）ブロックを表示できるように改修
• 決済方法・配送グループ・追加手数料にステータス設定を追加（公開 or 非公開）& Payment_Selectモジュールでステータスを考慮した決済方法のみを表示するように改修 & ステータスを考慮した配送グループ・追加手数料を表示するモジュール（ShippingGroup_AdminSelect・Addition_Select）を追加
• Squareで決済をした場合、レシート番号（square-receiptNumber）とレシートURL（square-receiptUrl）をメール用の変数として表示できる機能を追加
• ShoppingCart_Summary モジュールで税金情報と小計を表示できる変数を追加（taxAmount:loop, subtotal）

Changed

• ECテーマのカート追加・更新・削除時にJavaScriptを触らずにバリデーションを追加できる用に変更
• 管理画面のタブの分け方を変更
• ECテーマでOrder_SummaryモジュールからAPI経由で取得していたカート内商品のデータをShoppingCart_Summary に置き換え
• ECテーマの決済フォームのカテゴリーを cart → shopping に変更
• ECテーマ決済フォームにおいて、注文情報を Order_Summaryモジュールで表示するように変更
• ECテーマの不要なCSS及びJavaScript を削除など整理

Fixed

• ECテーマのカート追加時に、カラーとサイズの必須チェックをするように修正
• 送料無料のしきい値に0を設定した場合に、送料無料にならない問題の修正
• ShippingCart_Summaryモジュールの変数表に（sort, usort, csort, ecd）を追加
• 設定されている決済方法・配送グループ・追加手数料が0個の場合、エラーが出る問題を修正

Fixed

• fix: PHP7.4で syntax error, unexpected '|', expecting variable (T_VARIABLE) が発生する問題の修正
• ECテーマ詳細ページの Entry_Summary で ページネーションが表示されてしまう問題の修正

Fixed

• ECテーマ: IOSでモーダルの背景がスクロールできてしまう問題の修正
• ShippingGroup_AdminSelect モジュールの変数表が間違っている問題の修正
• Firefox でクレジットカード決済が必ずエラーになってしまう問題の修正
• Ver. 16 未満の Safariで Square の クレジットカード情報取得時にフォームが送信されない問題の修正
• カート及び決済フォームを表示するページはページキャッシュされないように修正

        <!-- BEGIN_MODULE Payment_Select -->
        <ul class="form-table-list">
          <!-- BEGIN payment:loop -->
          <li class="form-table-list-item">
            <div
              class="acms-form-radio payment-method-select"
            >
              <input
                id="input-radio-payment-method-{block}"
                type="radio"
                name="payment-method"
                value="{block}"
                \{payment-method:checked#{block}\}
                <!-- BEGIN_IF [\{payment-method\}/em/_and_/{payment.i}/eq/1] -->
                checked="checked"
                <!-- END_IF -->
                data-validator="payment-method"
              />
              <label for="input-radio-payment-method-{block}">
                <i class="acms-ico-radio"></i>{name}<!-- BEGIN_IF [{commissionPaid}/gt/0] -->：手数料 ¥{commissionPaid}[number_format]<!-- END_IF -->
              </label>
              <!-- BEGIN description:veil -->
              <div class="form-table-description">
                <!-- BEGIN_IF [{description}[delnl]/nem] -->
                <div class="form-table-message">{description}[nl2br]</div>
                <!-- END_IF -->
                <!-- BEGIN_IF [{image@path}/nem] -->
                <img
                  src="%{MEDIA_ARCHIVES_DIR}{image@path}"
                  class="acms-img-responsive"
                  alt="{image@alt}"
                  width="{image@width}"
                  height="{image@height}"
                >
                <!-- END_IF -->
                <!-- BEGIN_IF [{block}/eq/creditcard] -->
                @include("/include/parts/card-form.html")
                <!-- END_IF -->
              </div>
              <!-- END description:veil -->
            </div>
          </li>
          <!-- END payment:loop -->
        </ul>
        <!-- END_MODULE Payment_Select -->

<select name="item_shipping_group_id">
  <!-- BEGIN_MODULE ShippingGroup_AdminSelect -->
    <!-- BEGIN shippingGroup:loop -->
    <option value="{id}" \{item_shipping_group_id:selected#{id}\}>{name}</option>
    <!-- END shippingGroup:loop -->
    <!-- END_MODULE ShippingGroup_AdminSelect -->
  </select>
<input type="hidden" name="field[]" value="item_shipping_group_id" />

<!-- BEGIN_MODULE Addition_Select -->
<!-- BEGIN addition:veil -->
<h3>追加手数料</h3>
<table>
  <tbody>
    <tr>
      <th></th>
      <td>
        <ul>
          <!-- BEGIN addition:loop -->
          <li class="form-table-list-item">
            <div class="acms-form-checkbox">
              <input type="checkbox" name="addition[]" value="{id}" \{addition:checked#{id}\} id="input-checkbox-addition-{id}" />
              <label for="input-checkbox-addition-{id}">
                <i class="acms-ico-checkbox"></i>{name}（¥{fee}[number_format]）</label>
            </div>
          </li>
          <!-- END addition:loop -->
        </ul>
        <input type="hidden" name="field[]" value="addition" />
      </td>
    </tr>
  </tbody>
</table>
<!-- END addition:veil -->
<!-- END_MODULE Addition_Select -->