Added new {firstnamephonetic}, {lastnamephonetic}, {middlename} tags.

CHANGELOG.md

@@ -3,6 +3,9 @@ All notable changes to this project will be documented in this file.
 
 ## [2.6.2] 2024-12-14 (dev)
 - Performance optimization: Now caches login state.
+- New {firstnamephonetic} tag.
+- New {lastnamephonetic} tag.
+- New {middlename} tag.
 
 ## [2.6.1] 2024-11-20
 ### Update

README.md

@@ -170,6 +170,9 @@ FilterCodes are meant to be entered as regular text in the Moodle WYSIWYG editor
 * {firstname} : Display the user's first name.
 * {surname} or {lastname} : Display the user's surname (family/last name).
 * {fullname} : Display the user's first name and surname.
+* {middlename} : Display the user's middle name.
+* {firstnamephonetic} : Display the user's first name in phonetic.
+* {lastnamephonetic} : Display the user's last name in phonetic.
 * {alternatename} : Display the user's alternate name. If blank, it will display the user's first name instead.
 * {city} : Display the user's city.
 * {country} : Display the user's country.
@@ -1160,6 +1163,9 @@ Create a Page on your Moodle site, preferably in a course, so that those tags wo
 * Surname [{surname}]: {surname}
 * Last name [{lastname}]: {lastname}
 * Full name [{fullname}]: {fullname}
+* First name phonetic [{firstnamephonetic}]: {firstnamephonetic}
+* Last name phonetic [{lastnamephonetic}]: {lastnamephonetic}
+* Middle name [{middlename}]: {middlename}
 * Alternate name [{alternatename}]: {alternatename}
 * City [{city}]: {city}
 * Country [{country}]: {country}

classes/text_filter.php

@@ -2442,6 +2442,15 @@ function ($matches) use ($now) {
             }
         }
 
+        // Tags: {firstnamephonetic}, {lastnamephonetic}, {middlename}.
+        // Description: User's first name phonetic, last name phonetic and middle name as set in their profile.
+        // Parameters: None.
+        foreach (['firstnamephonetic', 'lastnamephonetic', 'middlename'] as $field) {
+            if (stripos($text, '{' . $field . '}') !== false) {
+                $replace['/\{' . $field . '\}/i'] = $this->isauthenticateduser() ? trim($USER->{$field}) : '';
+            }
+        }
+
         // Tag: {email}.
         // Description: User's email address as set in their profile.
         // Parameters: None.

version.php

@@ -25,7 +25,7 @@
 
 defined('MOODLE_INTERNAL') || die();
 
-$plugin->version   = 2024100702;            // The current plugin version (Date: YYYYMMDDXX).
+$plugin->version   = 2024100703;            // The current plugin version (Date: YYYYMMDDXX).
 $plugin->requires  = 2014051200;            // Requires Moodle version 2.7 or later.
 $plugin->component = 'filter_filtercodes';  // Full name of the plugin (used for diagnostics).
 $plugin->release   = '2.6.1';