added mb_ pollyfils and added a test suite to ensure it still works

Author: gin0115

.github/workflows/unit-tests.yml

@@ -11,7 +11,21 @@ jobs:
     strategy:
       matrix:
         operating-system: [ubuntu-latest]
-        php-versions: [ '7.4', '8.0', '8.1', '8.2', '8.3', '8.4']
+        include:
+          - php: '7.4'
+            mbstring: true
+          - php: '8.0'
+            mbstring: true
+          - php: '8.1'
+            mbstring: true
+          - php: '8.2'
+            mbstring: true
+          - php: '8.3'
+            mbstring: true
+          - php: '8.3'
+            mbstring: false  # This is the special case
+          - php: '8.4'
+            mbstring: true
     runs-on: ${{ matrix.operating-system }}
     services:
       # Setup MYSQL
@@ -30,11 +44,12 @@ jobs:
 
     steps:
       - uses: actions/checkout@v4
-      - name: Setup proper PHP version
+       - name: Setup PHP ${{ matrix.php }} (mbstring = ${{ matrix.mbstring }})
         uses: shivammathur/setup-php@v2
         with:
           php-version: ${{ matrix.php }}
           tools: composer
+          extensions: ${{ matrix.mbstring && 'mbstring' || '' }}
 
       - name: Validate composer.json and composer.lock
         run: composer validate --strict

functions.php

@@ -21,6 +21,63 @@
 
 // region
 
+/**
+ * Polyfill for mb_strimwidth.
+ */
+if ( ! function_exists( 'mb_strimwidth' ) ) {
+	/**
+	 * Polyfill for mb_strimwidth.
+	 *
+	 * @param string  $source      The string to trim.
+	 * @param integer $start       The starting position.
+	 * @param integer $width       The width to trim to.
+	 * @param string  $trim_marker The marker to append if the string is trimmed.
+	 * @param string  $encoding    The character encoding.
+	 *
+	 * @return string
+	 */
+	function mb_strimwidth( $source, $start, $width, $trim_marker = '', $encoding = 'UTF-8' ) {
+		// Fallback using mb_substr if available
+		if ( function_exists( 'mb_substr' ) ) {
+			$substr = mb_substr( $source, $start, $width, $encoding );
+			if ( mb_strlen( $source, $encoding ) > $width ) {
+				return $substr . $trim_marker;
+			}
+			return $substr;
+		} else {
+			// Rough fallback using substr (not multibyte-safe!)
+			$substr = substr( $source, $start, $width );
+			if ( strlen( $source ) > $width ) {
+				return $substr . $trim_marker;
+			}
+			return $substr;
+		}
+	}
+}
+
+/**
+ * Polyfill for mb_strlen.
+ */
+if ( ! function_exists( 'mb_strlen' ) ) {
+	/**
+	 * Polyfill for mb_strlen.
+	 *
+	 * @param string $source   The string to measure.
+	 * @param string $encoding The character encoding.
+	 *
+	 * @return integer
+	 */
+	function mb_strlen( $source, $encoding = 'UTF-8' ) {
+		// Use preg_match_all to count UTF-8 characters
+		if ( 'UTF-8' === $encoding ) {
+			return preg_match_all( '/./u', $source, $matches );
+		}
+
+		// Fallback: use strlen (not multibyte-safe!)
+		return strlen( $source );
+	}
+}
+
 /**
  * Returns the plugin's main class instance.
  *