From eda51298843cf538d0d825ab8f4ad58b712331fa Mon Sep 17 00:00:00 2001
From: Ryan Cramer <ryan@processwire.com>
Date: Sun, 20 Jul 2025 10:28:43 -0400
Subject: [PATCH] Update $sanitizer->wordsArray() to support a `truncate`
 option

---
 wire/core/Sanitizer.php | 15 +++++++++++++--
 1 file changed, 13 insertions(+), 2 deletions(-)

diff --git a/wire/core/Sanitizer.php b/wire/core/Sanitizer.php
index e744c12c..dc6aa925 100644
--- a/wire/core/Sanitizer.php
+++ b/wire/core/Sanitizer.php
@@ -5013,6 +5013,7 @@ class Sanitizer extends Wire {
 	 *  - `maxWordLength` (int): Maximum word length (default=80)
 	 *  - `maxWords` (int): Maximum number of words allowed (default=0, no limit)
 	 *  - `stripTags` (bool): Strip markup tags so they don’t contribute to returned word list? (default=true)
+	 *  - `truncate` (bool): Truncate rather than remove words that exceed maxWordLength? (default=false) 3.0.250+
 	 * @return array
 	 * @since 3.0.160
 	 *
@@ -5030,6 +5031,7 @@ class Sanitizer extends Wire {
 			'keepNumberFormat' => true, 
 			'keepChars' => array(),
 			'stripTags' => true,
+			'truncate' => false,
 		);
 
 		$options = array_merge($defaults, $options);
@@ -5122,8 +5124,17 @@ class Sanitizer extends Wire {
 				continue;
 			}
 			$length = $this->multibyteSupport ? mb_strlen($word) : strlen($word);
-			if($length < $minLength || $length > $maxLength) {
-				// remove any words that are outside the min/max length requirements
+			if($length > $maxLength) {
+				// remove or truncate any words that are too long
+				if($options['truncate']) {
+					$word = $this->multibyteSupport ? mb_substr($word, 0, $maxLength) : substr($word, 0, $maxLength);
+					$words[$key] = $word;
+				} else {
+					unset($words[$key]);
+					continue;
+				}
+			} else if($length < $minLength) {
+				// remove any words that are are not long enough
 				unset($words[$key]);
 				continue;
 			} else if($keepChars !== '' && !strlen(trim($word, $keepChars))) {