Add database column to track user language preference. (#1367)

- Based on work by Ere Maijala for Finna.
- Enables automated communication to be sent to users in the appropriate language (forthcoming feature).

module/VuFind/sql/migrations/pgsql/6.1/001-modify-user-columns.sql

@@ -7,3 +7,6 @@ ALTER TABLE "user"
 
 ALTER TABLE "user"
   ADD COLUMN user_provided_email boolean NOT NULL DEFAULT '0';
+
+ALTER TABLE "user"
+  ADD COLUMN last_language varchar(30) NOT NULL DEFAULT '';

module/VuFind/sql/mysql.sql

@@ -218,6 +218,7 @@ CREATE TABLE `user` (
   `verify_hash` varchar(42) NOT NULL DEFAULT '',
   `last_login` datetime NOT NULL DEFAULT '2000-01-01 00:00:00',
   `auth_method` varchar(50) DEFAULT NULL,
+  `last_language` varchar(30) NOT NULL DEFAULT '',
   PRIMARY KEY (`id`),
   UNIQUE KEY `username` (`username`),
   UNIQUE KEY `cat_id` (`cat_id`)

module/VuFind/sql/pgsql.sql

@@ -144,6 +144,7 @@ created timestamp NOT NULL DEFAULT '1970-01-01 00:00:00',
 verify_hash varchar(42) NOT NULL DEFAULT '',
 last_login timestamp NOT NULL DEFAULT '1970-01-01 00:00:00',
 auth_method varchar(50) DEFAULT NULL,
+last_language varchar(30) NOT NULL DEFAULT '',
 PRIMARY KEY (id),
 UNIQUE (username),
 UNIQUE (cat_id)

module/VuFind/src/VuFind/Bootstrapper.php

@@ -354,6 +354,14 @@ class Bootstrapper
                     );
                 }
             }
+
+            // Store last selected language in user account, if applicable:
+            if (($user = $sm->get(\VuFind\Auth\Manager::class)->isLoggedIn())
+                && $user->last_language != $language
+            ) {
+                $user->updateLastLanguage($language);
+            }
+
             // Send key values to view:
             $viewModel = $sm->get('ViewManager')->getViewModel();
             $viewModel->setVariable('userLang', $language);

module/VuFind/src/VuFind/Db/Row/User.php

@@ -681,6 +681,19 @@ class User extends RowGateway implements \VuFind\Db\Table\DbTableAwareInterface,
     }
 
     /**
+     * Updated saved language
+     *
+     * @param string $language New language
+     *
+     * @return void
+     */
+    public function updateLastLanguage($language)
+    {
+        $this->last_language = $language;
+        $this->save();
+    }
+
+    /*
      * Update the user's email address, if appropriate. Note that this does NOT
      * automatically save the row; it assumes a subsequent call will be made to
      * the save() method.