タクソノミー・タームの選択ツールについて

• 記事編集画面でタクソノミー・ターム（例：タグ）などの初期選択ツールが自動補完/セレクトボックスなどがあります
• Drupal7では：Hierarchical Select モジュールをよく使用しました。
  • とてもシンプルとは言えないですが、使いやすいモジュールでした
  • 選択だけではなく、新規タームの作成もできました
• Drupal8では： Hierachical SelectモジュールはDrupal8のバージョンを提供していない
  • Drupal8では、Simple Hierarchical Select, Chosen などのモジュールがあります
  • 階層別で選択では、Simple Hierachical Selectでは十分機能しています
  • Chosenはサードパーティーのモジュールで、jsライブラリのダウンロード/インストールが必要です

モジュール（Simple Hierachical Select）が使いやすいが問題があり

• 現時点では、Simple Hierachical Selectモジュールのバージョン：8.x-1.0-alpha4
• モジュールを通常にインストールして、設定画面で、新規ターム作成許可のチェックボックスが無効化されています
  
• この点をインターネットで調べてみたら、実際に解決されていない問題があります
  • 詳細説明ページ：https://www.drupal.org/project/shs/issues/2712115
  • パッチ幾つかが提供されていますが、根本的な対応策が見つかっていないようです
  • でも、ターム新規作成をしなければ、このモジュールが十分使えます

Durupl8ではテーマは単独のディレクトリで管理

• Drupal8のテーマ（theme）がモジュールのインストール/アンインストール（機能拡張）の部分でインストールすることができます
  • 「テーマ」管理画面でも「新しいテーマのインストール」ボタンをクリックして、インストールすることがもできます
• 通常モジュールのフォルダー（drupal8/modules）と違って、単独のフォルダー（drupak8/theme）で管理しています
  

インストールしたテーマ(theme)にカスタマイズのため、サブテーマ（sub-theme）の作成ができます

• いろいろテーマをインストールすることができます
• インストールしたテーマの一部分をカスタマイズをしたいことがよくあります
  • 例：個別の詳細をcssで定義して、cssファイルをテーマに追加したい
• Drupalでは複数のサブテーマ（sub-theme）を作成することができます
• 複数のサブテーマを並列/直列して親テーマに継承することができます
  
• 子テーマが親テーマの要素を継承します
  • 子テーマで各要素の再定義、追加などができます

テーマ/サーブテーマのディレクトの集約ができます

• 初期のテーマディレクトリにインストールした複数のテーマが入っています
• サブディレクトもテーマディレクト（drupal8/theme）に作成して保管しています
• 複数のテーマをインストールして、複数のサブテーマを作成したら、フォルダー数が多くなり、どっちがサブテーマかはわかりづらくなります
• ここで、元のテーマを集約するディレクトリ(contrib)、とカスタマイズのサブテーマのディレクトリ(custom)を作成して、集約することができます
  • themes
        +-- contrib
                 +-- theme 1
                 +-- theme 2
                 +-- theme ・・・
        +-- custom
                 +-- sub_theme 1
                 +-- sub_theme 2
                 +-- sub_theme ・・・
     
• 作成された集約ディレクトリ（例：contrib, custom）、各テーマ/サブテーマのディレクトリを移動します
  • 移動後に各テーマ/サブテーマの構成ファイル（例：_info.yml）の定義の修正（ディレクトリ名に合わせ）必要はありません

一つのエンティティタイプ（Entity Type）に最低一つのバンドルが必要

• Entityオブジェクトを生成する場合、最初エンティティタイプ（Entity Type）が必要
  • 例： 記事（Article）、基本ページ（Basic Page）を作成する前に、コンテントタイプが必要です（コンテントタイプ⇒エンティティタイプです、記事／基本ページはバンドルです）
• 前回紹介した「DrupalのEntityを定義する簡単な例－４：複数のバンドルの作成/拡張フィールド追加 」例では一つのエンティティタイプに複数のバンドルを定義します
  • プログラミングでバンドル（例：シングルタイプ、ツインタイプのルーム）を定義します

問題点：プログラミングで定義したバンドルは任意に追加することはできません

• 上記の例では、エンティティタイプを定義する同時にバンドルも定義します
• 実際には、エンティティタイプが定義してから、必要に応じていろいろなバンドルを追加する必要があります
  • 例：ルームでは施設によって、ツインタイプのものがあれば、ないところもあります
  • 例：コンテントタイプに記事、基本ページ以外に、必要に応じていろいろなバンドル（例：予約など）追加ができます

解決：エンティティ（Entity）を利用して別のエンティティタイプのバンドルに定義します

• モジュール：EntityAPIがこの方法を提供してくれました
• 一つのエンティティ（例：room type）を別のエンティティタイプ（例：room）のバンドルにする定義ができます
  
• 大きな利点は、エンティティタイプがプログラミングで定義、バンドルはDrupalのUIで登録することができます

一つのエンティティを他のエンティティのバンドルにする定義：　"bundle of" にあります

• プログラミングでエンティティを定義するときに、hook_entity_info を実装して定義します（前回も紹介したので、ここは詳細を省略）
• 他のエンティティタイプのバンドルにする定義： "bundle of" => "room"  (room typeがroomのバンドルに指定)

  function entity_room_entity_info()
  {
      $return = array(
          'room' => array(
              'label' => t('Room'),
              'entity class' => 'RoomEntity',
              'label callback' => 'entity_class_label', // see RoomEntity class
              'uri callback' => 'entity_class_uri',     // see RoomEntity class
              'controller class' => 'RoomController',
              'base table' => 'room',
              'fieldable' => TRUE,
              'entity keys' => array(
                  'id' => 'rid',
                  'bundle' => 'room_type_sys',
              ),
              'bundle keys' => array(
                  'bundle' => 'room_type_sys',
              ),
              'bundles' => array(),
              'load hook' => 'room_load',
              'view modes' => array(
                  'full' => array(
                      'label' => t('Default'),
                      'custom settings' => FALSE,
                  ),
              ),
              'module' => 'entity_room',
              'access callback' => 'entity_room_access',
          ),
      );
      $return['room_type'] = array(
          'label' => t('Room Type'),
          'entity class' => 'RoomTypeEntity',
          'controller class' => 'RoomTypeController',
          'base table' => 'room_type',
          'fieldable' => FALSE,
          'bundle of' => 'room',
          'exportable' => TRUE,
          'entity keys' => array(
              'id' => 'rtid',
              'name' => 'room_type_sys',
              'label' => 'room_type_label',
          ),
          'module' => 'entity_room',
          'admin ui' => array(                // Enable the entity API's admin UI.
              'path' => 'admin/structure/room-types',
              'file' => 'room_type.admin.inc',
              'controller class' => 'RoomTypeUIController',
          ),
          'access callback' => 'entity_room_access',
      );
  
      return $return;
  }
  

• カスタムモジュール（entity_room.zip）をダウンロードしてください
• エンティティの具体な操作は次回で説明します