Drupalのモジュール（Display Suite）のコードフィールド内のトークン（Token）利用不可のものが多い

Drupal共有ソースサイトへの移行計画

• Drupal7で複数のサイト（ドメイン）を構築しました。それぞれのバージョンアップ、ソースのバグ管理に手間がかかります。
• 一つの共有ソースにすれば、Drupalのバージョンアップ、ソースのバグ管理に効率は良いと考えられています
• 例：以下イメージのようにサイト移行
  
• サイト移行時の両側の違い：
  • Drupalのバージョンは同じ：７
  • モジュール：共有ソース側の方が多い、また同じモジュールに違うバージョンが存在している可能性があります
  • DB：移行先に各サイトは別々のDBで違うコンテンツを有します

サイト移行の一番大きな問題点：メディア保存のフォルダが変わる

• サイト移行にどんな方法を使っても、元サイトのメディア（例：写真など）保存フォルダー（sites/default）が、共有ソース側に別名のフォルダ（それぞれのサイトのメディア保存フォルダ）に変わります
• 元サイトにあるメディア（写真、ファイル、ビデオなど）のパスが共有ソース側に移行先フォルダ名で書き換えなければならないです

移行方法１：共有ソース側で新規サイトを構築して、Featureモジュールで旧サイトの設定、Node Exportモジュールでコンテンツを移行します

• 共有ソース側で以降先のフォルダ（例：pine ⇒ sites/pine）を作成します
  • defaultフォルダ（sites/default）にあるdefault.settings.phpをコピーして、移行先のフォルダ（pine）にペストし、settings.phpに名前を変更します
  • sites.php（sites/sites.php）設定ファイルに移行元のドメイン名とフォルダ名を関連つけます（設定方法：「Drupalのソースを共有する複数サイトの構築」をご参考）
• 設定されたドメイン名で新サイトへアクセスし、Drupalのインストール手法で新しいサイトを構築します（新しいサイト、移行元のものはなにもない状態）
• モジュール（Feature）で元サイトの設定を移行します(Drupalのモジュール（Feature）を用いてサイト間のデータ移行/開発管理を行いますをご参考)
  • すべての元サイト設定移行はできません。例：テーマの設定が最初からやり直しが必要はあります（結構手間がかかる作業）
• モジュール（Node Export）でコンテンツ（例：Article）を元サイトから出力して、移行先にインポートします
  • 大量なコンテンツがある場合、Drushのコマンドで出力したほうが良いでしょう
  • コンテンツに含まれている画像、ビデオ、ファイルなどのパスを移行先のフォルダ名に合わせて変更しなければならない（今回：sites/default ➡ sites/pine すべてのパスを検索して、変更）
• 元サイトのメディア保存フォルダ(sites/default)にあるすべての内容（settings.php除外）を移行先にフォルダ（sites/pine）にコピーします
• 移行先でファイルシステム設定画面（ホーム » 管理 » 環境設定 » メディア » ファイルシステム）の元サイトと同じファイルパス設定を行います
  

移行方法２：元サイトのDBとメディア保存フォルダを移行先にコピーします

• 元サイトのすべてのものをそのままで移行先にコピーできれば、一番楽です
• 重要なのは、両サイトが側のDrupalバージョン、モジュールバージョンが完全一致していれば、うまく行きます
  • バージョンが合わなければ、移行後にサイトからエラーがでて、完全に動かなくなりことがあります（以下のエラー例で、実は一つのモジュールバージョン差で引き起こされています）
    
  • 移行する前にモジュールのバージョン合わせに十分に気を付ける必要はあります
  • もちろん、移行先にでのモジュールバージョンを変えると、他のサイトにも影響を与えるので、調整が必要となります
• 移行する前に、移行先と移行元のDB、メディアファイルフォルダ（sites/default）の内容をバックアップします（うまく行かなければ、バックアップで戻します）
• 移行するサイトのすべてDBテーブルをSQL文に出力（MySql：mysqldump）します
  • 出力されたファイルにあるすべてのメディア保存フォルダパスを移行先のフォルダパスに書き換えます（sites/default ➡ sites/pine）
    
  • もしドメイン名も変わる場合、新しいドメイン名で古いのを書き換えます
• 移行元のメディア保存フォルダにすべての内容（settings.phpも含む）、移行先にのメディア保存フォルダにコピーします（sites/default ➡ sites/pine）
• 移行先でファイルシステム設定画面（ホーム » 管理 » 環境設定 » メディア » ファイルシステム）の元サイトと同じファイルパス設定を行います
• ブラウザで移行先のページにアクセスし、管理者権限でデータベース更新（http://your-site-domin/update.php）を行います（Drushでも更新可能）
  

結論：新規サイト構築はエラーが少ないが手間がかかります。DBコピーは便利だがエラーが出やすいです。

• 安心で、きれいに移行する場合新規サイトを構築したほうが良いでしょう。多少手間がかかっても、難しいことは少ないです
• DBコピーの方式は上級者向けですね。常にエラーの調査、修正にが必要となります

コンテンツ表示管理画面でモジュール（Display Suite）の「コードフィールド」内にあるTokey情報を利用して新規フィールド作成

• コンテンツ管理画面（ホーム » 管理 » サイト構築 » コンテンツタイプ » Article » 表示管理）の下にある「Custom Fieldｓ」セクションで「コードフィールド追加」があります
  
• 「コードフィールド追加」ボタンをクリックして、フィールドラベル、適応範囲などを入力します。フィールド作成ページの下にある「トーク」チェックボックスをチェックして、Tokenの利用が可能になります
  
  • 「利用可能なトークンを表示」リンクをクリックして、サイト内すべてのトークンが表示されます
  • 必要なものを検索して、トークン（例：[user:name]）をコピーして、Field Codeフォーム入力すればよいです
• コードフィールドの修正はコンテンツ表示管理画面ではできません。DisplaySuiteの管理画面（ホーム » 管理 » サイト構築 » Display Suite » フィールド）で行います
  

新規作成したフィールドを画面表示させ、確認

• コンテンツ表示管理画面（ホーム » 管理 » サイト構築 » コンテンツタイプ » Article » 表示管理）で新規新規作成しフィールを適切な場所に配置します
• コンテンツ表示された画面で選択したトークンを確認します
• 実際の操作はビデオでご確認ください

DSのコードフィールドで表示されたすべてのトークの利用はできません

• ビデオに使用したトークン例：[user:name] と [current-user:name]があります
• 実際に[user:name]が何にも出力しませんでした。利用可能なのは [current-user:name]でした

DSのコードフィールドいろいろな場所（例：User、Profileなど）で使用可能なので、すべてのトークンが表示されても、その場所で利用できないものがあります

• DBが広範囲（コンテンツだけではない）で使用可能なので、当然コードフィールド内の利用可能なトークンを定義するのは難しいです。
• トークン一覧のフィルタリングにできないため、すべてのトークンが表示されます
• 利用場所を想定して、利用可能トークンの選択は必要となります

どんな場所でどのトークンが利用可能かのドキュメントはあまり見つかっていないです。

• 経験での判断といろいろなトークンを出力してみて確認したほうが良いでしょう

Drupalの部分的なコンテンツデータを別のDrualサイトに移行する場合そのコンテンツの構造定義とコンテンツCSVデータのエクスポート／インポートができます

• 背景：Drupal7.54
• Drupalのサイト引っ越しなどでデータ移行の必要があります、以下の移行方法はよく利用されます。
  • Drupalのモジュール（Feature）を用いてサイト間のデータ移行/開発管理を行います (162)
  • 同じDrupalバージョンの単一サイトを複数サイト（ドメイン）の一つDrupalの共有ソースサイトへの移行チャレンジ (161)
• ただし、部分的なコンテンツしか移行しない場合、上記方法では難しくなります
• ここで、コンテンツ定義とデータを別々でexport/import方法を説明します
  

Drupalのモジュール（Bundle copy、 Taxonomy CSV import/export）でコンテンツの構成／定義をExport/Importします

• モジュール（Bundle copy）でコンテンツの構成／定義を簡単に移行します（具体的にステップは省略）
• タクソノミーのタームの構成（フィールドが追加など）が変わらなければ、モジュール（、Taxonomy CSV import/export）でタームリストデータをcsvファイルの出力することはできます
  • 出力したCSVデータの別のサイトにインポートする場合、タクソノミーのボキャブラリーとタームIDが変わった可能性があります
  • コンテンツのフィールドに「Term Reference」タイプのものがあれば、コンテンツ追加／編集ボタンをクリックすると、「HTTP ERROR 500」エラーが発生するかもしれないです
    
  • 一番簡単な対応方法ではそのフィールドを一回削除して、再作成すればよいです（データインポートする前の段階）

Drupalのコンテンツ構成（フィールド）テーブルのデータをcsvフォーマットに出力します

• 現時点ではコンテンツのデータをcsvに出力するモジュールはあまり見当たらにです
• コンテンツのフィールドをDB上各テーブルを見つけ出します
  • コンテンツ（例：Article）のフィールドごとに一つのテールが存在しています
  • Title ➡　nodeテーブルの「title」フィールド
  • body ➡　field_data_bodyテーブルの「body_value」フィールド（またはbody_summaryなど）
  • カスタムフィールド ➡　field_data_CUSTOM_FIELD_NAMEの「field_data_CUSTOM_FIELD_NAME_value」フィールド
• これらのテーブルを「node」テーブルを中心してジョインして、新しいテーブルの書き込みます
  • すべてのコンテンツは「node」テーブルを基本にしています
  • 各フィールドのテーブルに「entity_id」がnodeテーブルの「nid」の関連付けキーとなります
  • 全フィールドと同じフィールドの新しいテーブルを一つ作成します（例：new_table）
  • 全フィールドをJOINしてデータを新しいテーブル（例：new_table）にコピーします

    INSERT INTO new_table (title, body, CUSTOM_FIELD_NAME,   ・・・・・・)
    SELECT 
       title,
       body.body_value,
       T1.field_data_CUSTOM_FIEDL_NAME_value,
      ・・・・・・
    FROM node
       left join field_data_body body on nid = body.entity_id
       left join field_data_CUSTOM_FIELD_NAME  T1  on T1.entity_id = nid
      ・・・・・・
      

• 新しいテーブル（new_table）の内容をｃｓｖフォーマットに出力します

Drupalのモジュール（Feeds Import）でコンテンツｃｓｖデータをインポートします

• モジュール（Feeds Import）がよく利用されるものなので、簡単にｃｓｖデータを確認コンテンツにインポートすることができます
• Feeds Importの説明は省略します(Drupalのモジュール（Feeds）で手動でデータインポート時の必須設定 (199)、FeedsモジュールでEnityにデータインポート (34)などを参考にしてください)

Drupalのコンテンツ表示設定にレイアウトの変更はできない。すべてのフィールド表示はしていない

• Drupalのコンテンツ表示管理画面（例：Article： ホーム » 管理 » サイト構築 » コンテンツタイプ » Article の「表示管理」）にある表示タイプ（例：全文）のレイアウト変更はできない
• そのレイアウトのコンテンツのすべてフィールドが表示されていない（例：投稿日付、投稿者など）
  

モジュール（Display Suite）導入で、同一表示タイプに複数のレイアウト選択可能、隠されたフィールドの表示/設定が可能になる

• Drupalのコンテンツ表示には大きな役割を果たしたモジュール（Display Suite）がぜひ利用してください
• 通常の方法でDisplay Suiteをインストール/有効化します
• コンテンツの表示管理画面（例：Article： ホーム » 管理 » サイト構築 » コンテンツタイプ » Article の「表示管理」）でDisplay Suiteのレイアウトが表示され、表示必要に応じ選択します
  
• また、初期隠されたフィールドも表示されます。表示必要に応じフィールドを表示場所に配置します
• 具体的な操作法はビデオでご参考ください
• Display Suiteの応用に「シリーズ記事」をご参考ください

コンテンツ表示管理画面でモジュール（Display Suite）の「コードフィールド」内にあるTokey情報を利用して新規フィールド作成

• コンテンツ管理画面（ホーム » 管理 » サイト構築 » コンテンツタイプ » Article » 表示管理）の下にある「Custom Fieldｓ」セクションで「コードフィールド追加」があります
  
• 「コードフィールド追加」ボタンをクリックして、フィールドラベル、適応範囲などを入力します。フィールド作成ページの下にある「トーク」チェックボックスをチェックして、Tokenの利用が可能になります
  
  • 「利用可能なトークンを表示」リンクをクリックして、サイト内すべてのトークンが表示されます
  • 必要なものを検索して、トークン（例：[user:name]）をコピーして、Field Codeフォーム入力すればよいです
• コードフィールドの修正はコンテンツ表示管理画面ではできません。DisplaySuiteの管理画面（ホーム » 管理 » サイト構築 » Display Suite » フィールド）で行います
  

新規作成したフィールドを画面表示させ、確認

• コンテンツ表示管理画面（ホーム » 管理 » サイト構築 » コンテンツタイプ » Article » 表示管理）で新規新規作成しフィールを適切な場所に配置します
• コンテンツ表示された画面で選択したトークンを確認します
• 実際の操作はビデオでご確認ください

DSのコードフィールドで表示されたすべてのトークの利用はできません

• ビデオに使用したトークン例：[user:name] と [current-user:name]があります
• 実際に[user:name]が何にも出力しませんでした。利用可能なのは [current-user:name]でした

DSのコードフィールドいろいろな場所（例：User、Profileなど）で使用可能なので、すべてのトークンが表示されても、その場所で利用できないものがあります

• DBが広範囲（コンテンツだけではない）で使用可能なので、当然コードフィールド内の利用可能なトークンを定義するのは難しいです。
• トークン一覧のフィルタリングにできないため、すべてのトークンが表示されます
• 利用場所を想定して、利用可能トークンの選択は必要となります

どんな場所でどのトークンが利用可能かのドキュメントはあまり見つかっていないです。

• 経験での判断といろいろなトークンを出力してみて確認したほうが良いでしょう

Drupalのコンテンツ表示設定にレイアウトの変更はできない。すべてのフィールド表示はしていない

• Drupalのコンテンツ表示管理画面（例：Article： ホーム » 管理 » サイト構築 » コンテンツタイプ » Article の「表示管理」）にある表示タイプ（例：全文）のレイアウト変更はできない
• そのレイアウトのコンテンツのすべてフィールドが表示されていない（例：投稿日付、投稿者など）
  

モジュール（Display Suite）導入で、同一表示タイプに複数のレイアウト選択可能、隠されたフィールドの表示/設定が可能になる

• Drupalのコンテンツ表示には大きな役割を果たしたモジュール（Display Suite）がぜひ利用してください
• 通常の方法でDisplay Suiteをインストール/有効化します
• コンテンツの表示管理画面（例：Article： ホーム » 管理 » サイト構築 » コンテンツタイプ » Article の「表示管理」）でDisplay Suiteのレイアウトが表示され、表示必要に応じ選択します
  
• また、初期隠されたフィールドも表示されます。表示必要に応じフィールドを表示場所に配置します
• 具体的な操作法はビデオでご参考ください
• Display Suiteの応用に「シリーズ記事」をご参考ください

コンテンツ表示管理画面でモジュール（Display Suite）の「コードフィールド」内にあるTokey情報を利用して新規フィールド作成

• コンテンツ管理画面（ホーム » 管理 » サイト構築 » コンテンツタイプ » Article » 表示管理）の下にある「Custom Fieldｓ」セクションで「コードフィールド追加」があります
  
• 「コードフィールド追加」ボタンをクリックして、フィールドラベル、適応範囲などを入力します。フィールド作成ページの下にある「トーク」チェックボックスをチェックして、Tokenの利用が可能になります
  
  • 「利用可能なトークンを表示」リンクをクリックして、サイト内すべてのトークンが表示されます
  • 必要なものを検索して、トークン（例：[user:name]）をコピーして、Field Codeフォーム入力すればよいです
• コードフィールドの修正はコンテンツ表示管理画面ではできません。DisplaySuiteの管理画面（ホーム » 管理 » サイト構築 » Display Suite » フィールド）で行います
  

新規作成したフィールドを画面表示させ、確認

• コンテンツ表示管理画面（ホーム » 管理 » サイト構築 » コンテンツタイプ » Article » 表示管理）で新規新規作成しフィールを適切な場所に配置します
• コンテンツ表示された画面で選択したトークンを確認します
• 実際の操作はビデオでご確認ください

DSのコードフィールドで表示されたすべてのトークの利用はできません

• ビデオに使用したトークン例：[user:name] と [current-user:name]があります
• 実際に[user:name]が何にも出力しませんでした。利用可能なのは [current-user:name]でした

DSのコードフィールドいろいろな場所（例：User、Profileなど）で使用可能なので、すべてのトークンが表示されても、その場所で利用できないものがあります

• DBが広範囲（コンテンツだけではない）で使用可能なので、当然コードフィールド内の利用可能なトークンを定義するのは難しいです。
• トークン一覧のフィルタリングにできないため、すべてのトークンが表示されます
• 利用場所を想定して、利用可能トークンの選択は必要となります

どんな場所でどのトークンが利用可能かのドキュメントはあまり見つかっていないです。

• 経験での判断といろいろなトークンを出力してみて確認したほうが良いでしょう

コンテンツ表示管理画面でモジュール（Display Suite）の「コードフィールド」内にあるTokey情報を利用して新規フィールド作成

• コンテンツ管理画面（ホーム » 管理 » サイト構築 » コンテンツタイプ » Article » 表示管理）の下にある「Custom Fieldｓ」セクションで「コードフィールド追加」があります
  
• 「コードフィールド追加」ボタンをクリックして、フィールドラベル、適応範囲などを入力します。フィールド作成ページの下にある「トーク」チェックボックスをチェックして、Tokenの利用が可能になります
  
  • 「利用可能なトークンを表示」リンクをクリックして、サイト内すべてのトークンが表示されます
  • 必要なものを検索して、トークン（例：[user:name]）をコピーして、Field Codeフォーム入力すればよいです
• コードフィールドの修正はコンテンツ表示管理画面ではできません。DisplaySuiteの管理画面（ホーム » 管理 » サイト構築 » Display Suite » フィールド）で行います
  

新規作成したフィールドを画面表示させ、確認

• コンテンツ表示管理画面（ホーム » 管理 » サイト構築 » コンテンツタイプ » Article » 表示管理）で新規新規作成しフィールを適切な場所に配置します
• コンテンツ表示された画面で選択したトークンを確認します
• 実際の操作はビデオでご確認ください

DSのコードフィールドで表示されたすべてのトークの利用はできません

• ビデオに使用したトークン例：[user:name] と [current-user:name]があります
• 実際に[user:name]が何にも出力しませんでした。利用可能なのは [current-user:name]でした

DSのコードフィールドいろいろな場所（例：User、Profileなど）で使用可能なので、すべてのトークンが表示されても、その場所で利用できないものがあります

• DBが広範囲（コンテンツだけではない）で使用可能なので、当然コードフィールド内の利用可能なトークンを定義するのは難しいです。
• トークン一覧のフィルタリングにできないため、すべてのトークンが表示されます
• 利用場所を想定して、利用可能トークンの選択は必要となります

どんな場所でどのトークンが利用可能かのドキュメントはあまり見つかっていないです。

• 経験での判断といろいろなトークンを出力してみて確認したほうが良いでしょう