Drush for Drupal 8

Drupal 8 からDrushコマンドが変わりました、drush 9 がDrupal8版となります。

Drupal 8 のDrushコマンド

entityがエラー・警告になる場合は、drush entity-updates を実行します。

詳細は　https://drushcommands.com/drush-8x/core/entity-updates/

Drush 10 for Drupal 8.4+ and Drupal 9

インストールはComposerでインストールします。　composer require drush/drush

詳細は、　https://docs.drush.org/en/master/install/

FAQ

N/Aが表示される

コンテンツ作成画面で、追加したフィールドで複数の選択肢がある場合、その「フィールドの設定」で「許容する値の数」を「制限」で設定した場合に、最初の選択肢として、N/Aが表示されます。　「無制限」に設定すればN/Aは非表示になります。

エラー表示

 Missing $settings['hash_salt'] in settings.php

システム環境：　Drupal 8.8.6  PHP 7.4  Ubuntu 10.04.4  Drush Version 10.2.2

drushコマンドを実行して以下のエラーが起きた場合：

In Settings.php line 159:

  Missing $settings['hash_salt'] in settings.php.

対応：　別のDrupal 8.8で稼働している ['hash_salt'] の定義データをコピーして実行しました。参考にしたサイト：　https://www.drupal.org/project/zircon/issues/2875682

PHP Fatal error: Declaration of Drupal\Core\Database\Statement::fetch......

システム環境：　Drupal 8.9.20  PHP 8.1  Debian 11  Drush Version 10.6.2

drushコマンドを実行して以下のエラーが起きた場合：

PHP Fatal error: Declaration of Drupal\Core\Database\Statement::fetchAll($mode = null, $column_index = null, $constructor_arguments = null) must be compatible with PDOStatement::fetchAll(int $mode = PDO::FETCH_DEFAULT, mixed ...$args):

対応：　PHP7.4で運用したDrupal8の場合は、PHP8.1ではエラーになります。PHP7.4で運用します。　参考にしたサイト：　https://www.drupal.org/project/drupal/issues/2668564

コンテンツ作成のプレビュー表示

コンテンツ作成時に、プレビューを実行するとデザインテンプレートのメニューやナビゲーションなどのブロックと表示が重なってしまい、「コンテンツ編集へ戻る」などが見づらい、操作しづらい場合。

コンテンツタイプでフィールドを削除するとどうなるか

フィールドを削除すると、「エンティティフォームディスプレイ」、「エンティティビューディスプレイ」「Viewsで使われているView」などが一緒に削除されます。

Viewsなどのデータが削除されるので、削除する前に該当するViewsの設定を複製して、削除後に複製を有効にすることで、削除したフィールドのデータ以外はViewsで表示されます。

もしくは、該当するフィールドを削除しないで、そのコンテンツタイプの「フォームの表示管理」や「表示管理」などで無効にして、データを操作しない（見えない）状態で運用して、必要な時期に削除するような対応も可能です。

Drupal 8・９・１０での多言語化

多言語の設定

コアモジュールの有効化とLanguageの追加

Interface Translation  Content Translation  Configuration Translation  Content Language

Content Languageでコンテンツタイプ、タクソノミー、ブロック、メニュー、ユーザー、Paragraphsなどの翻訳有効化

Config Translation でサイト内の各アイテムを翻訳有効化

※確認事項　

□ 作成・編集ページに言語セレクターを表示
□ 翻訳を有効化

オリジナルの翻訳を選択して、上記の表示されている個所で、「翻訳を有効化」はチェックすると、Content Languageに反映されます。

オリジナルを日本語および英語に設定する場合、サイトのデフォルトが日本語にした場合、日本語をオリジナルにするとわかりやすいと思います。

「判定と選択」の設定

Drupal 8.7.4 では、管理画面 -> 環境設定 -> 地域と言語 -> Language の判定と選択で、「アカウント管理ページ」を有効にすると、翻訳する言語でも管理者の使用する言語が優先になるようです。たとえば、日本語メインにしたユーザーの場合、英語にコンテンツを翻訳しようとしても、管理画面では英語の表示にならない現象が起きます。

コンテンツタイプの「言語の設定」も「デフォルトの言語」は「投稿者の指定言語」が良いかもしれません。海外の人が英語で投稿(コメント)などする際に投稿者が使う英語などをデフォルトにできるかも。

Viewsでの多言語化

タクソノミーで定義したボキャブラリーのタームで参照している場合、そのタームを多言語化し、ページやブロックで表示させる場合に、表示されている言語で表示が切り替わる（フィルター）するような設定は、Filter Criteria で Taxonomy term: Translation language を追加して "interface text language selected for page" を選択します。

多言語化作業で便利なモジュール

Select translation (Select translation implements a Views filter to select which translation of a node should be displayed in a list of nodes.)

Simple entity translations  (It adds two additional forms for content translation.)

Translate Side by Side (Shows menus, nodes, blocks and taxonomy with source and target language side by side) ! install errow at Drupal 8.7.3 / Translate Side by Side 8.x-1.5

Content Translation Redirect ( if you need to redirect users from pages of non-existent translations of the content entity to a page with the original language)

Menu block current language (resolve this by providing a replacement for core's Menu block that filters out the untranslated menu links)

Menu Multilingual (multilingual features for menu blocks, to filter out menu items that do not have translated labels or link to untranslated content)

Menu block  (configurable blocks of menu links with advanced features)

Context  (allows to manage contextual conditions and reactions for different portions of site)

Language Switcher Extended (additional processors for the language switcher block links)

Language Icons (icons for language links, both for the Language switcher block and (optionally) for node links)

Language Switcher Dropdown (site visitors to switch languages using a drop-down select list instead of using hyperlinks)

Translation Views (fields and filter to build list in Views with information about translations)

英語がデフォルトのテンプレートなどの場合

海外のデザインテンプレートなどでは、データベース込みの環境をインストールした場合、英語がデフォルトになります。その場合、英語をデフォルト状態で、日本語やフランス語などを追加し、翻訳の設定を行います。ある程度の翻訳が終わった段階で、英語から日本語にデフォルトを変更して、URL判別などを調整します。

多言語機能は複雑なので、わかりやすくするためにも、デフォルトの言語を優先にして、多言語データができた段階で、どの言語をデフォルトにするか、選択する方法が好ましいと思います。

実際の運用

インストール後に、まだ多言語設定していない、フィールドやコンテンツなどを多言語を「追加」する場合は、まず、英語がデフォルトで開発されたテンプレートの場合は、英語モードでログインして、該当するところの多言語設定を確認します。英語があり、追加で日本語があります。もし日本語がなければ、そのコンテンツやフィールドを多言語対応に設定変更します。

• 英語のコンテンツは英語モードの環境で編集します。
• 日本語のコンテンツは、日本語モードの環境でフィールドやコンテンツなどの翻訳で「追加」してから編集します。

もし、英語モードの環境で日本語のコンテンツを「追加」して作成すると、上記の「英語＋日本語」にさらに「英語の日本語」が出来てしまいます。コンテンツが3種類になります。

Design Themeについて

デザインテンプレート

Morethanthemes

Morethanthemesサイト　https://www.morethanthemes.com/

Drupal７やDrupal8の有料デザインテンプレートサイトです。無料版もありますが、ソースをすべて編集できる有料版（Pro版）がお勧めです。

日本語＋英語の多言語サイトを構築するには

Morethanthemesサイトのデザインテンプレートは、多言語対応で、デフォルトが英語です。英語のほかに、日本語、ドイツ語などを翻訳するには、言語を追加して、翻訳機能を有効にします。

日本語をメインとするWebサイトにするためには、英語のデフォルトを日本語のデフォルトに変更します。

まず、英語をデフォルトで、日本語や他の言語を追加し、翻訳機能を有効にして、最後に、日本語をデフォルトにする設定のほうが、機能的にわかりやすい、設定が容易な多言語サイトになると思います。一度、英語がデフォルトの状態で作成されたコンテンツデータがある場合、途中でデフォルトの言語を日本語に変更すると、誤動作になる可能性があるかもしれません。

新規にコンテンツデータを作成する場合は、作成時のデフォルト状態を基本として考えます。

日本語をデフォルトに設定したときに、 言語判別の /ja /en などを変更調整します。

ただし、URLでの言語判別を選択しなくても、ブラウザなどの言語コードを判別する方法がスマートな設定になりそうです。その場合の設定は以下のようになります。

英語をインストール時のデフォルトで構築した場合、最初の設定（デフォルトを英語、その英語はインターフェイスの翻訳はなし）で運用構築します。英語と日本語を両方翻訳可能にも設定できるので、その場合は翻訳が誤動作することがあります。

画像をクリックして拡大

URLでの言語判定を使わない場合は、翻訳作業などを行うときに、英語モードのブラウザと日本語モードのブラウザを使って、言語ごとにそのブラウザで操作するほうが、わかりやすいかもしれません。

ブロックの翻訳は、場所やブロック機能などにより、翻訳しても多言語切り替えがうまくいかない場合があるので、その場合は、ブロックの設定で、特定の言語だけで使うブロック設定を行い、その言語ごとにブロックを追加して運用します。

また、コンテンツやページ、ブロックなどに組み込んでいるスクリプトなどで表示される機能は、コア本体の多言語機能と連携しないので、そのスクリプトを言語ごとのコンテンツで多言語化させます。

Drupal8の新規クリーンインストールを日本語デフォルトで実施した環境では、この問題は影響しません。英語を追加して、翻訳設定するだけです。

Cookie Consent Module の日本語化（翻訳）

Cookie Consentモジュールは、外部のJavaScriptライブラリーを採用しており、Drupalの多言語化機能には対応しておりません（2020年1月19日）。

今後対応する予定のようです。詳細は、https://mtt.desk.com/customer/portal/questions/17513494-d8-cookie-consent-module-translate

抜粋

Question：　D8 - Cookie consent module - translate

Answer：

the “Learn more” link and “Got it” button are set by the corresponding library as the default options.

You can check the link below for the corresponding options you can override in the JS initialization in order to set your own strings:

https://cookieconsent.insites.com/documentation/javascript-api/
https://www.screencast.com/t/pfzaVcpB

The file that you can use in order to set these is modules/custom/mt_cookieconsent/js/mt_cookieconsent.js.

Check the screenshot below for an example on how to override the “Got it” text:
https://www.screencast.com/t/0KYfivCc0fOI

参考：　modules/custom/mt_cookieconsent/js/mt_cookieconsent.js ファイルを編集して、画面の色を変更し、日本語を追加したサンプルです。

/*
 * MTCookieConsent scripts
 *  Add any module related script here
 */

(function ($, Drupal, drupalSettings) {

  Drupal.behaviors.mt_cookieconsent = {
    attach: function (context, settings) {
      // can access setting from 'drupalSettings';
      var theme_select = drupalSettings.mt_cookieconsent.theme_select;
      var alert_message = drupalSettings.mt_cookieconsent.alert_message;
      var target_url = drupalSettings.mt_cookieconsent.target_url;

      window.addEventListener("load", function(){
        window.cookieconsent.initialise({
          "palette": {
            "popup": {
             /* "background": "#000" */
              "background": "#f8f8ff"　　　<---- !
            },
            "button": {
             /* "background": "#fff" */
              "background": "#add8e6"　　<---- !
            }
          },
          "theme": theme_select,
          "content": {
            "message": alert_message,
            "link": '詳細へ Learn more',　　　<---- !
            "dismiss": '同意します OK!',         <---- !
            "href": target_url
          }
        });
      });
    }
  };
})(jQuery, Drupal, drupalSettings);

Migration to composer based site

※参考　

Drupal 8 Composer install : 2019年9月22日現在

composer create-project drupal-composer/drupal-project:8.x-dev (my_site_name_dir) --no-interaction

概要はここから：　https://mtt.desk.com/customer/portal/articles/2842962

抜粋

This article includes instructions on how to install a D8 distribution on a Composer-managed structure.



Make sure that you read the article “Using Composer to manage Drupal site dependencies” at Drupal.org, in order to understand the requirements and procedures of managing a site with Composer:



https://www.drupal.org/node/2718229



The steps below refer to the Level+ theme, as an example, but they can be applied to any of our premium Drupal 8 theme distributions.



1.  Install Composer on your machine. For more information, visit https://getcomposer.org/doc/00-intro.md.

2.  Install a Composer-based site. We recommend the following Composer template: https://github.com/drupal-composer/drupal-project

3.  Add the modules the Level+ theme uses to your site by running composer require drupal/<modulename>. Note that you do not need to enable the modules included in the modules folder since they will be enabled by the database import that will take place later. For example, for the Level+ theme, these modules are:

• entity_reference_revisions
• paragraphs
• superfish

4.  Copy all the contents of the theme folder of the Level+ distribution into your Composer-based installation.

5.  Copy the folders /sites/default/files/YYYY-MM  of the theme distribution into your Composer-based installation where YYYY-MM are date-related folder names. These folders contain images that are used on the demo website. For the Level+ theme, these folders are:

• /sites/default/files/2016-03
• /sites/default/files/2016-04
• /sites/default/files/2016-05
• /sites/default/files/2017-02

※他のテンプレート（minimalplus-academia）では、sites/　に mtt.settings.local.php というファイルがありました。テンプレートごとに必要なファイルをComposerベースの環境へ移行します。　さらに、以下の６．のように　..../sites/default/files/ 以下のファイルやディレクトリもすべてComposerベースの環境へ移行します。

6. Copy the following folders of the theme distribution into your Composer-based installation. These folders contain images and other files that are used on the demo website:

• /sites/default/files/pictures
• /sites/default/files/tmp

※他のテンプレート（minimalplus-academia）では、Drupal ROOTディレクトリに、　OneSignalSDKUpdaterWorker.js　と　OneSignalSDKWorker.js　と　example.gitignore　と　offline.html　と　service-worker.js　というファイルがありました。テンプレートごとに必要なファイルをComposerベースの環境のDrupal ROOTディレクトリへコピーして移行します。

7. Make sure the web server has Write permissions for all the /sites/default/files/ folder and all its subfolders.

8.  Import the database as described in the User Guide located in the ZIP file you downloaded.

 

※Drushコマンドの前に、Webブラウザで標準的なインストール手順でインストールを実行し、データベース名を設定して、その後、既存サイトへ移行する、によりデモ環境が立ち上がります。この時に、日本語のWebブラウザでインストールしますが、デモ環境は英語データだけ（多言語設定はしていない）になります。

9.  Run drush cr

10.  Run drush updb



By now, your installation should be completed. However, there is a chance that you will need to run the following command as an additional step:



drush entup

CSSファイルを追加修正する場合は、themes/custom/テーマ名/css/theme/local-theme.css を編集します。

Tourism

Composerベースのテーマにするには、上記の手順のほかに、元のテーマのソースデータで、....web/modules/contrib/ 以下のファイルとディレクトリも、移行先のComposerベースの環境にコピーします。

CSSファイルの編集

css/theme/local-theme.css ファイルを編集します。

Press+

テンプレートの概要：　https://www.morethanthemes.com/themes/pressplus

CSSファイルの編集：　..../themes/custome/pressplus/css/theme/local-theme.css を編集

テンプレートのバージョン8.x-5.0.0 -> 8.x-5.1.0 へアップグレードする手順概要

概要はここから：　https://docs.google.com/document/d/1hc-Tfwlwi5CNETZFG9Els4XU-jfsGO8BdhmWssXXDc4/edit

1. 新規に8.x-5.1.0版のFull－Installでデモデータベース込みのPro版でインストールします。
2. 既存の移行前の8.x-5.0.0版の環境をバックアップします。
3. 念のために、既存の環境をメンテナンスモードに設定。
4. テーマファイル　themes/custom/pressplus　で必要なファイルを入れ替えます。　もし、CSSなどで、追加したファイル、例えば、local*.css などはバックアップして後で入れ替えます。

   　css/base/local-base.css
   　css/components/local-components.css
   　css/theme/local-theme.css

   　pressplus.info.yml
   　pressplus.theme
   　pressplus.libraries.yml
   　/templates/field--block-content--mt-fancy-tabs-block.html.twig
   　/templates/field--block-content--mt-media-tabs-block.html.twig
   　/templates/field--block-content--mt-tabs-block.html.twig

5. キャッシュクリアとCronの実行
6. 追加モジュールの更新と確認、例えば、更新するモジュールのディレクトリを削除、更新

   　Field Group (field_group) 8.x-3.0-rc1 
   　Font Awesome (fontawesome) 8.x-2.13 
   　Video Embed Field (video_embed_field) 8.x-1.6 
   　Count Down (custom/mt_countdown) 8.x-1.0-beta3

7. Drupal8コアのアップデイト、キャッシュクリア、Cronの実行
8. メンテナンスモードの解除

Minimal+

環境　Minimal+ 8.x-5.4.0

表（テーブル）の罫線を表示させたい場合は、web/themes/custom/minimalplus/css/components/local-components.css ファイルに以下の設定を追加します。

※iPhoneで表示した場合、最上部と左側面の線が薄くなりますが、Android、PCでの表示では大丈夫でした。

table tr th {
/*  border-style: solid;  */
  border-width: 1px 1px 1px 1px;
 /*  color: #ffffff;
  padding: 15px 20px;
  font-size: 18px;
  font-weight: 700; */
}

table tr:first-child th {
  border-width: 1px 1px 1px 1px;
}

table tr td {
/*  border-style: solid; */
  border-width: 1px 1px 0px 0px;
/*  border-color: #707070;
  padding: 18px 20px;
  background-color: #ffffff;
  font-size: 15px;
  font-weight: 400;
  color: #6c6c6c; */
}

table thead + tbody tr:first-child th:first-child {
  border-top-width: 0px;
}

table tr th:last-child {
  border-right-width: 0px;
}

table tr:first-child td {
  border-top-width: 0px;
}

table tr:last-child td {
  border-bottom-width: 0px;
}
table thead + tbody tr:first-child td {
  border-top-width: 0px;
}
table tr th:first-child,
table tr td:first-child {
  border-left-width: 0px;
}
table tr th:last-child,
table tr td:last-child {
  border-right-width: 0px;
}

Viewsの使い方

ViewsはDrupal 8 の基本機能としてとてもパワフルなモジュールです。コンテンツタイプなどで登録したデータを、参照・加工するSQL文を作成管理するGUI機能です。

ほとんどのSQL文、select文からリレーションシップなどまで、一般的に使用するSQL文の機能は網羅しています。

Drupal 7では拡張モジュールですが、Drupal 8からはコア（標準機能）になりました。

FAQ

質問：

ブロック・ページで表示された画像をクリックした場合、標準ではその画像かコンテンツページへリンク設定になっていますが、指定したURLにリンクを設定したい

質問：

フィールドで日付、日付の範囲を使って、登録した日付データをもとに、Viewsのフィルターで、年、月、で選択フィルターとして使う方法について

Contextual Filterで、該当するフィールドがfield_dateの場合、node.field_date(year) や node.フ field_date(year_month)など使ってフィルターで設定すれば大丈夫です。詳しくは以下のページにて。ただし、シンプルな時間でのフィルターの場合は使えますが、複数の時間（年、月、日）などフィルターを設定する場合は、個別に時間のフィールドでグループまたはフィルターで取り扱う方法が容易のように思います。

Getting a view of unique years of a date field

https://drupal.stackexchange.com/questions/280829/getting-a-view-of-unique-years-of-a-date-field

コンテキスチュアルフィルターで追加

コンテキスチュアルフィルターの設定

実際のYearで検索したとき

※Dateでフィルターに関するモジュールやその技術情報として

• Views Date Range Filters

Create views plugins for date range fields　https://www.drupal.org/project/drupal/issues/2924061

Does this cover all parts of the patch and vice-versa?　https://www.drupal.org/project/views_daterange_filters/issues/3068036

The Views integration Datetime Range fields should extend the views integration for regular Datetime fields　https://www.drupal.org/project/drupal/issues/2786577?page=1

Drupal 8 Datetime Range field: How to filter with relative dates in a View　https://youtu.be/8UEiqAy6meQ

• Views Contextual Filters OR

• Views filters populate

DevOps ddev 環境

ddevは、オープンソースCMSのWordPress、Drupal、TYPO3、bacldropなどのDevOps環境して開発されています。

詳細は　ここから　https://www.drud.com/

参考書籍

• ddev+Drupalでの入門書籍（英語）　

Local Web Development With DDEV Explained: Your Step-by-Step Guide to Local Web Development With DDEV

Drupal Global Sprint 用のパッケージ

２０１９年DrupalCon Seattle で使ったSprint用データのダウンロード

https://github.com/drud/quicksprint/releases/tag/v1.0.1

ddev インストール

https://ddev.readthedocs.io/en/stable/#installation

Drupal 8　Quick Install 

https://ddev.readthedocs.io/en/stable/users/cli-usage/

インストール後の環境

Drupal 9.0.0.dev　Quick Install 

インストール環境： ubuntu 18.04.4

docker, docker compose, curl などをインストール、docker はsudoコマンドなしで実行できるように設定変更

参考サイト

• https://insilico-notebook.com/ubuntu-18-04-dockerce-install/
• https://www.virment.com/how-to-install-docker-compose-on-ubuntu/
• https://insilico-notebook.com/docker-run-without-sudo/

MacOSでは、DockerとDocker compose がインストールされていれば大丈夫だとおもいます。

quicksprint パッケージのダウンロード

• https://github.com/drud/quicksprint/releases/tag/v1.3.3

上記のページにある drupal_sprint_package.v1.3.3.tar.gz をダウンロード、自分のホームディレクトリなどへ。

• https://github.com/drud/quicksprint/releases/download/v1.3.3/drupal_spri...

解凍後、

$ cd drupal_sprint_package
$ ./install.sh

インストールが終了し、

$ mkcert -install
$ cd ~/sprint
$ ./start_sprint.sh

Drupal 9.0.0.dev をインストールし完了後、

Use the following URL's to access your site:
Website: http://sprint-20200405-1828.ddev.site:8080/
https://sprint-20200405-1828.ddev.site:8443/
(U:admin P:admin)
Mailhog: http://sprint-20200405-1828.ddev.site:8025/
phpMyAdmin: http://sprint-20200405-1828.ddev.site:8036/
Chat: https://drupal.org/chat to join Drupal Slack or https://drupalchat.me
See Readme.txt for more information.

が表示されればOKです。 この環境は、ブラウザの localhost で稼働します。

ddev はセキュリティのために sudo などを使わない、ホームディレクトリで、PCのLocalhostでしか稼働しません。 Docker環境を別のサーバー環境に移行させればサーバー環境として稼働します。

Docker環境は ~/sprint/sprint-20200405-1828 のようにインストールした時刻でDockerコンテナのディレクトリを作成します。

もし、Drupal 8.8.0環境に変更したい場合は、そのコンテナディレクトリの下にある、./switch_branch.sh を使います。

例えば、 $ ./switch_branch.sh 8.9.x と実行すると、Drupal 9.0.0 から Drupal 8.9.0 へソース環境を入れ替えてくれます。

ddev環境の使い方は、以下の簡単な説明をご覧ください。

hodota@demo2:~/sprint/sprint-20200405-1828$ cat Readme.txt

サイトへにアクセス

Website: http://sprint-[ts].ddev.site:8080/
https://sprint-[ts].ddev.site:8443/
(User:admin Pass:admin)

Mailhog: http://sprint-[ts].ddev.site:8025/
phpMyAdmin: http://sprint-[ts].ddev.site:8036/
Chat: https://drupal.org/chat to join Drupal Slack or drupalchat.eu!

よく使うddevコマンド：

ddev start (-h) [start project]
ddev stop (-h) [stop project, nothing lost]
ddev poweroff [stop all projects and resources, nothing lost]
ddev import-db --src=path to db [import database]
ddev help

ddev オンラインマニュアル https://ddev.readthedocs.io/
サポートは、Stack Overflow: https://stackoverflow.com/tags/ddev

Drupalブランチを9.0.xなどに切り替える必要がある場合は、ユーティリティswitch_branch.shを使用してください。 スクリプトは変更を隠しますが変更内容が失われないようにするため、まず自分で変更を保存することをお勧めします。switch_branch.shは既存のデータベースもドロップするため、実行後、手動でWebベースのインストールを行う必要があります。

サンプル:
./switch_branch.sh 9.0.x
./switch_branch.sh 8.8.x

ssh コマンドを使う場合：
コンテナディレクトリの下にdrupalディレクトリがあります。そのディレクトで ddev ssh と実行します。

hodota@demo2:~/sprint/sprint-20200405-1828/drupal$ ddev ssh
hodota@sprint-20200405-1828-web:/var/www/html$ ls
INSTALL.txt autoload.php composer.json core example.gitignore index.php profiles sites update.php web.config
README.txt composer composer.lock drush files modules robots.txt themes vendor

コンテナ環境でのssh 環境では、drush コマンドや composer コマンドが使えます。

ssh環境を抜ける場合は exit です。

ddev 英文マニュアル
https://ddev.readthedocs.io/en/stable/

FAQ

Q:　Debian Stretchでdockerインストール後、sudo 以下外の一般ユーザーでdockerを実行させるとエラー(Got permission denied while trying to connect to the Docker daemon socket......)になる。

A:　一般ユーザーをdockerグループに所属させ、ログアウト、再ログインして確認します。

　　Debian Stretch で　sudo gpasswd -a ユーザ名 [グループ名 docker]　で　追加します。その後、 id ユーザー名　で確認し、ログアウト、再ログイン

　さらに、Docker-Linuxの設定で確認します。

　Manage Docker as a non-root user　https://docs.docker.com/install/linux/linux-postinstall/

　To create the docker group and add your user:

Create the docker group.

$ sudo groupadd docker

Add your user to the docker group.

$ sudo usermod -aG docker $USER


Log out and log back in so that your group membership is re-evaluated.

If testing on a virtual machine, it may be necessary to restart the virtual machine for changes to take effect.

On a desktop Linux environment such as X Windows, log out of your session completely and then log back in.

On Linux, you can also run the following command to activate the changes to groups:

$ newgrp docker 


Verify that you can run docker commands without sudo.　

$ docker run hello-world

もしくは、以下のサイトで、UbuntuでのDocker、sudoなしなどの設定を確認します。

https://qiita.com/__8oki__/items/cf0414d02b20fe87af83

Q:　localhostでSSL認証を設定する(mkcert)をDebianにインストールする方法

A:　$ sudo apt-get update
　　$ sudo apt install libnss3-tools

　　最新のmkcertバイナリーパッケージのリリース情報を確認　https://github.com/FiloSottile/mkcert/releases  もし最新版が v.4.1 であれば

　　$ export VER="v1.4.1"
      $ wget -O mkcert https://github.com/FiloSottile/mkcert/releases/download/${VER}/mkcert-${VER}-linux-amd64

　参考にしたサイト：https://computingforgeeks.com/how-to-create-locally-trusted-ssl-certificates-on-linux-and-macos-with-mkcert/

　ダウンロード後、実行権限のパーミッションを付加して、/usr/local/binへ

　$ chmod +x  mkcert
   $ sudo mv mkcert /usr/local/bin

これで、mkcertコマンドが実行できます。

Q:　ddevのインストールおよびアップデイトの簡単な方法（スクリプト）

A:　$ curl -L https://raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh | bash

　参考にしたサイト：　Installation/Upgrade Script - Linux and macOS　https://ddev.readthedocs.io/en/stable/#installation

  スクリプトの概要：　https://github.com/drud/ddev/blob/master/scripts/install_ddev.sh

Drupal 8 へのマイグレーション

Drupal 7 から Drupal 8へデータの移行方法

　移行の概要は、英文で　ここから　

　Drupa 7.54　Drupal 8.3.2　でテストしました。

　まず、Drupal 7のコアとモジュールを最新版にします。　その後、バックアップをとり、コア以外の全てのモジュールをアンインストールします。

　コアモジュールだけでインストールしたデフォルト状態のDrupal 8 で、以下のモジュール（Migrate, Migrate Drupal, Migrate Drupal UI）を有効にします。

Drupal 7で使っていた拡張モジュールでDrupal 8 版がある場合は、Drupal 8 側でも同じモジュールをインストールし、有効にします。

　例えば、ViewsはDrupal 8 からコアに入りましたが、Cktools、Display Suiteなどなど。

　Drupal 8版で同じモジュールがない場合、もしくはあっても、そのモジュールでDrupal 7とDrupal 8で互換性、アップグレード可能か、確認します。

　Migrate Drupal UI のConfigureをクリックし、以下の画面で、念のためにメンテンスモードにします。

その後、「継続」をクリック、移行元のDrupal 7のデータベースやDrupalRootのディレクトリなどを設定し、データベースとファイルの意向確認をします。

Drupal 7とDrupal 8のモジュール環境など、条件が違うところを確認し、移行を実行します。

　すべて同じ環境ではないので、移行できないところは、コンテンツ（ノード）のデータとして移行されます。

　※Drupal 8.3.2 で検証用サーバーから公開用サーバーにデータベースとディレクトリを移行させようとしたところ、移行先の公開用サーバーで初期インストール動作になってしまいました。　そこで、初期インストールして、そこでマイグレーションを再度実行させました。また、データ移行後も、ページからメニューを設定する際に、メニュー設定ができないなどがありました。

Drupal 8 modules

カテゴリ

• Developer

モジュール比較表

• Comparison and Overview of Access Control modules　https://www.drupal.org/node/270000

Video関連モジュール

Video　ダウンロード　https://www.drupal.org/project/video

• 2018年2月現在は　video 8.x-2.x-dev　https://www.drupal.org/project/video/releases/8.x-2.x-dev
• video 8.x-2.x-dev版には、video_transcodeモジュールが付属し、media typeでvideoを追加可能、ビデオ変換を追加設定可能

Video Embed Field　ダウンロード　https://www.drupal.org/project/video_embed_field

Video Embed HTML5 ダウンロード https://www.drupal.org/project/video_embed_html5

Video Embed Meida　ダウンロード　

Video Embed WYSIWYG　ダウンロード 

Video Embed Field　概要マニュアル　https://www.drupal.org/node/2322455

Video embed field モジュールをインストール後、CKEditorで設定し、ビデオファイルを設定

実際のページで表示

Video Filter　ダウンロード　https://www.drupal.org/project/video_filter

Media entity　ダウンロード　https://www.drupal.org/project/media_entity

Media entity video　ダウンロード　https://www.drupal.org/project/media_entity_video

CKEditor Video　ダウンロード　https://www.drupal.org/project/ckeditor_video

CKEditor Video Detector　ダウンロード　https://www.drupal.org/project/ckeditor_videodetector

CKEditor Media Embed Plugin　ダウンロード　https://www.drupal.org/project/ckeditor_media_embed

Video Player 関連

Colorbox　ダウンロード　https://www.drupal.org/project/colorbox

Colorbox Load ダウンロード　https://www.drupal.org/project/colorbox_load

Colorbox inline ダウンロード　https://www.drupal.org/project/colorbox_inline

NG Lightbox　ダウンロード　https://www.drupal.org/project/ng_lightbox

Video Embed JW Player　ダウンロード　https://www.drupal.org/project/video_embed_jwplayer

Video.js (HTML5 Video Player)　ダウンロード　https://www.drupal.org/project/videojs

BigVideo　ダウンロード　https://www.drupal.org/project/bigvideo

Mediaモジュール

Media in Drupal 8 Initiative　https://www.drupal.org/project/ideas/issues/2786785

Media entityモジュールはDrupal 8.4からコアに入る予定ですが、Drupal 8.4.xでインストールするとMediaモジュールを使えるようです。

Entity API　ダウンロード　https://www.drupal.org/project/entity

Media entity　ダウンロード　https://www.drupal.org/project/media_entity

Media entity video　ダウンロード　https://www.drupal.org/project/media_entity_video

良く使うモジュール（composerインストール）

2019年7月1日現在　CMSLABO Baseシステムとして

https://www.drupal.org/project/admin_toolbar

https://www.drupal.org/project/module_filter

https://www.drupal.org/project/paragraphs

https://www.drupal.org/project/entity_reference_revisions

https://www.drupal.org/project/fpa

https://www.drupal.org/project/google_analytics

https://www.drupal.org/project/google_tag

https://www.drupal.org/project/paragraphs

https://www.drupal.org/project/entity_reference_revisions

https://www.drupal.org/project/entity_usage

https://www.drupal.org/project/viewsreference

https://www.drupal.org/project/bootstrap_paragraphs

https://www.drupal.org/project/scheduler

https://www.drupal.org/project/imce

https://www.drupal.org/project/ctools

https://www.drupal.org/project/token

https://www.drupal.org/project/pathauto

https://www.drupal.org/project/redirect

https://www.drupal.org/project/webform

https://www.drupal.org/project/metatag

https://www.drupal.org/project/shield

https://www.drupal.org/project/simple_sitemap

https://www.drupal.org/project/workbench

https://www.drupal.org/project/workbench_access

https://www.drupal.org/project/workbench_email

https://www.drupal.org/project/workbench_reviewer

https://www.drupal.org/project/libraries

https://www.drupal.org/project/captcha

https://www.drupal.org/project/recaptcha

https://www.drupal.org/project/quick_node_clone

https://www.drupal.org/project/field_group

https://www.drupal.org/project/social_simple

https://www.drupal.org/project/insert

https://www.drupal.org/project/sitemap

https://www.drupal.org/project/smtp

https://www.drupal.org/project/search_api

https://www.drupal.org/project/fullcalendar_view

https://www.ostraining.com/blog/drupal/how-to-integrate-a-calendar-in-dr...

https://www.drupal.org/project/asset_injector

https://www.drupal.org/project/back_to_top

https://www.drupal.org/project/lang_dropdown

https://www.drupal.org/project/languageicons

https://www.drupal.org/project/login_security

https://www.drupal.org/project/text_resize

https://www.drupal.org/project/social_media_links

https://www.drupal.org/project/anchor_link

https://www.drupal.org/project/fakeobjects

https://www.drupal.org/project/private_files_download_permission

https://www.drupal.org/project/menu_per_role

https://www.drupal.org/project/colorbox

https://www.drupal.org/project/content_moderation_notifications

https://www.drupal.org/project/computed_field

https://www.drupal.org/project/taxonomy_manager

https://www.drupal.org/project/cshs

https://www.drupal.org/project/chosen

https://github.com/harvesthq/chosen/releases

edit composer.json  /  check README.txt

https://www.drupal.org/project/views_data_export

https://www.drupal.org/project/address

https://www.drupal.org/project/schema_metatag

https://www.drupal.org/project/content_lock

https://www.drupal.org/project/environment_indicator

https://www.drupal.org/project/block_class

https://www.drupal.org/project/config_filter

https://www.drupal.org/project/config_split

https://www.drupal.org/project/roleassign

https://www.drupal.org/project/role_delegation

https://www.drupal.org/project/header_and_footer_scripts

https://www.drupal.org/project/layout_builder_restrictions

https://www.drupal.org/project/simple_ldap

https://www.drupal.org/project/linkit

https://www.drupal.org/project/field_group

https://www.drupal.org/project/field_group_table

https://www.drupal.org/project/flippy

管理画面テーマ

https://www.drupal.org/project/material_admin

システム管理用のモジュール

https://www.drupal.org/project/entity_update

フィールドで表計算のように四則演算できるモジュール（2020年7月現在）

• Math Field (Mathematical Expression Field Formatter)　テキストフィールドで演算しますが結果はマウスオーバーで表示される
• Views Math（開発段階のようです、ダウンロードなし）
• Views Simple Math Field (開発版段階です)　※eval-mathが必要です。
• Expression Field (alpha1版ですが動きました)　※eval-mathが必要です。
• Math Operation （演算フィールドが固定で自由度がないようです）

Drupal install at PostgreSQL

PostgreSQLのインストール

Debian Stretch の場合

参考にしたサイト　https://tecadmin.net/install-postgresql-on-debian/#

Setup Apt Repository

 wget -q https://www.postgresql.org/media/keys/ACCC4CF8.asc -O - | sudo apt-key add -

sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt/ stretch-pgdg main" >> /etc/apt/sources.list.d/pgdg.list'

PostgreSQLのインストール

sudo apt-get update
sudo apt-get install postgresql postgresql-contrib

sudo su - postgres
$ psql

Drupalのインストールには、PHPのPostgreSQLドライバーが必要です。たとえば、apt-get install php7.1-pgsql

管理機能

アドミン機能について

ユーザ管理

　詳細は　ここから

レポート

　最近のログメッセージ

ユーザーごとの検索フィルターを追加する方法

Viewsで「最近のログメッセージ」をコピーして、作業します。「Viewsのフィルターの条件」に「名前 (自動補完) 」を追加して、「このフィルターを訪問者へ表示し、変更できるようにする」
に設定します。 

ワークフローの設定

英語のDrupal 8 workflow に関する説明は　ここから

overview and sample workflow

• https://www.drupal.org/docs/8/core/modules/content-moderation/overview

customize the workflow configuration (Reviewステータスを追加)

• https://www.drupal.org/docs/8/core/modules/workflows/overview

Drupal 8 Workflow video

• https://www.previousnext.com.au/blog/workflows-new-tool-toolbox

Drupal 8 Workflow Notifications with Rules Part 1

• https://ianluckraft.co.uk/2018/02/drupal-8-workflow-notifications-with-r...

Drupal 8 Workflow Notifications with Rules Part 2

• https://ianluckraft.co.uk/2018/02/drupal-8-workflow-notifications-with-r...

Changing the Default Content Moderation State in Drupal 8

• https://ianluckraft.co.uk/2018/02/changing-the-default-content-moderatio...

Drupal 8 Workflow Notifications with Rules Part 3

• https://ianluckraft.co.uk/2018/03/drupal-8-workflow-notifications-with-r...

動作環境：　Drupal 8.4.3

基本設定：

ユーザーの役割

匿名ユーザー、承認済みユーザー、管理者、決裁担当

ユーザーごとに役割を設定します

シンプルなワークフロー

コンテンツの作成　ー＞　非掲載で保存　ー＞　決裁者が確認し掲載　するワークフロー

手順の概要

コンテンツタイプを作成し、標準の「掲載オプション」で「掲載」「フロントページへ掲載」を非設定（チェックを外す）にします。

権限の設定で、作成したコンテンツタイプ(My News)に対して、承認済みユーザーは作成や編集はできるが、掲載（発行）は決裁担当のみ実行できる設定にします。

決裁担当のみに、「コンテンツの管理」「コンテンツアクセス制御を迂回する」を権限設定します。

承認済みユーザーは、

「コンテンツ概要ページへアクセス」「すべてのリビジョンを表示」「自分の非掲載コンテンツを表示」「公開されたコンテンツを読む」「My News: 新しいコンテンツを作成」「My News: 自身が作成したコンテンツの編集」「My News: リビジョンを戻す」「My News: リビジョンを表示」 などを設定します。

上記の権限設定では、承認済みユーザーがコンテンツを作成し、決裁者が確認して掲載するワークフローです。掲載後は、決裁者以外のコンテンツを作成した承認済みユーザと決裁者は編集可能です。

コンテンツを作成した承認済みユーザーは、「My News リビジョンを戻す」権限が設定されていると、自分が作成したコンテンツは、リビジョンを戻して編集可能となります。　「My News 自分が作成したコンテンツの編集」を決裁者のみにすれば、承認済みユーザーは、新規にコンテンツを作成し、１回目の掲載は決裁者ができますが、それ以降はコンテンツをコピーして新規にコンテンツを作成するような手順となります。

できれば、決裁者がリビジョンを戻して、承認済みユーザーが非掲載で編集し、決裁者が掲載するようなワークフローが好ましいと思います。其のためには、「WorkFlowモジュール」と「Content Moderationモジュール」を有効にすることで改善できます。　詳細は下記のWorkflowモジュールを使う場合を参考に。

さらにログイン後の管理画面での権限設定として、承認済みユーザーには「管理ページとヘルプを利用」「管理用テーマの表示」「アドミニストレーション ツールバーの使用」などの権限を付与します。

コンテンツの追加

承認済みユーザーはコンテンツ（My News）を作成・編集できるが、掲載（発行）できない設定、決裁担当者のみ「掲載」や「プロモーションオプション」が設定できる、シンプルなワークフローです。

決裁担当者のコンテンツ編集画面

Worklowモジュールを使う場合

拡張機能の設定

管理画面 -> 拡張機能　でWorkFlowモジュールとContent Moderationモジュールを有効にします。

ワークフローの設定

管理画面 -> 環境設定 -> ワークフロー　でデフォルトのEditorialワークフローを編集するか、新規に追加します。

デフォルトEditorialワークフローの設定

デフォルトEditorialフローで運用する場合は、このワークフローを適応させるブロックタイプおよびコンテンツタイプを設定します。

「このワークフローの適用先:」で、コンテンツタイプ　My News を選択し保存します。

ワークフローの動作設定は、「状態」の中で、設定します。　例えば、publishedの場合は、デフォルトで「Create New Draft」「Publish」「Archive」の３種類で、

「Publish」の状態の設定で、ステータス遷移<推移>（transition）は、例えば、「Create New Draft」の設定は

「新しい状態を追加」で設定が可能です。

「推移」の設定は、例えば、Publish の場合は

「遷移を新規追加」で設定が可能です。

権限の設定

Workflowの設定管理機能（システム管理者向け）

ワークフローの遷移や状態などの設定

承認済みユーザーはDraft状態のコンテンツを作成し、その他の動作は決裁担当が行なう設定です。

コンテンツの編集で、権限により動作を設定しています。例えば、決裁担当者は、Drfatに戻したり、掲載（発行）したり可能です。

承認（Review）申請を追加設定

原稿作成　＜－＞　承認申請(Review)　＜－＞　発行(発行)　のプロセスを追加します。

Editorialのワークフローに、「状態」Review を追加設定します。

「Review」の設定は、デフォルト

「推移(Transition)」に「Ready for Review」を、「送信元」に「Draft」、「宛先」に「Review」、Draft -> Review の流れで追加します。

その他、「Create New Draft」の「送信元」に「Review」、「Review」から「Draft」へ を設定

さらに、「Review」から「Publish」への設定を追加

以下のようになります。

これで、Reviewが使えるようになります。

また、必要であれば「Archived」を「Unpublish」という名前に変更するとわかりやすいかもしれません。

このようなワークフローの動作とステータスの遷移などを実際の運用にあわせて設定します。

Drupal 8 のモジュール開発

• Extending Drupal 8 モジュール全般

https://www.drupal.org/docs/8/extending-drupal-8

• Drupal 8 APIs

https://www.drupal.org/docs/8/api

• Creating custom modules

https://www.drupal.org/docs/8/creating-custom-modules

• Hooks （HooksはDrupalのコアにあるソースで拡張する場合）

https://api.drupal.org/api/drupal/core%21core.api.php/group/hooks/8.6.x

cmslaboの勉強会で行ったモジュール開発の資料

• Drupal7の場合

http://cmslabo.org/sites/default/files/doc/workshop/2015/drupal_workshop...

• Drupal８の場合

http://cmslabo.org/sites/default/files/doc/workshop/2017/0419/drupal_wor...

入門用として便利な独自モジュール開発する拡張モジュール

• Module Builder

https://www.drupal.org/project/module_builder

• Module Builder on Drupal 8

https://youtu.be/jcKZwOgbE4w

• Module Builder - A module building helper

https://www.drupal.org/node/205585

その他Drupal8のモジュール開発、いっぱいあるようです。

• Drupal 8 module development 101

https://youtu.be/n_4HJynaPNo

• Drupal 8: Create a Simple Module

https://youtu.be/79zYcIoheCc

• How I Became a Drupal Developer in 3 months

https://youtu.be/vFyH9dCna6A