Bump version to 3.0.246

Co-authored-by: poljpocket <mail@poljpocket.com>

README.md

@@ -40,7 +40,7 @@ development branch.
 ProcessWire is a timeless tool for web professionals that has always been 
 committed to the long term. It started in 2003, gained the name ProcessWire
 in 2006, and has been in active development as an open source project since 2010. 
-Now more than a decade later (2023), we’re just getting started, as ProcessWire 
+Now more than a decade later (2025), we’re just getting started, as ProcessWire 
 continues to grow and develop into the next 10 years and beyond. 
 
 While ProcessWire has been around for a long time, don’t feel bad if you haven’t 
@@ -71,9 +71,7 @@ in the ProcessWire forums, subscribe to our
 [weekly newsletter](https://processwire.com/community/newsletter/subscribe/)
 for the latest ProcessWire news, check out our
 [website showcase](https://processwire.com/sites/)
-to see what others are building with ProcessWire, and read our 
-[blog](https://processwire.com/blog/) 
-to stay up-to-date with the latest ProcessWire versions.
+to see what others are building with ProcessWire.
 
 Weekly ProcessWire news is posted by Teppo Koivula on his site 
 [ProcessWire Weekly](https://weekly.pw). 
@@ -129,20 +127,20 @@ replacing your `/wire/` directory with the one from the newer version.
 ### Pro module version upgrade notes (if applicable)
 
 - [FormBuilder](https://processwire.com/store/form-builder/)
-  version 0.4.0 or newer required, 0.5.2 or newer recommended.
+  version 0.5.5 or newer recommended.
 - [ListerPro](https://processwire.com/store/lister-pro/)
-  version 1.0.9 or newer required, 1.1.4 or newer recommended. 
+  version 1.1.6 or newer recommended. 
 - [ProFields](https://processwire.com/store/pro-fields/)
   the latest versions of all ProFields (10 modules) are recommended.
 - [LoginRegisterPro](https://processwire.com/store/login-register-pro/)
-  all versions supported but version 5 or newer recommended.   
+  version 8 or newer recommended.   
 - [ProCache](https://processwire.com/store/pro-cache/)
-  version 3.1.4 or newer required, 4.0.0 or newer recommended.
-  After upgrading, go to your ProCache settings in the admin (Setup > ProCache)
-  and see if it suggests any modifications to your .htaccess file.
-- For all other Pro modules not mentioned above (ProMailer, ProDrafts, 
-  ProDevTools, Likes) there are no specific version requirements but we 
-  recommend using the latest available versions when possible.
+  version 4.0.5 or newer recommended. After upgrading, go to your ProCache 
+  settings in the admin (Setup > ProCache) and see if it suggests any 
+  modifications to your .htaccess file.
+ 
+- For all other Pro modules not mentioned above we recommend using the 
+  latest available versions when possible.
 
 ## Debug Mode
 
@@ -156,12 +154,11 @@ we think you'll find it very handy during development or when resolving issues.
 
 1. Edit this file: `/site/config.php`
 2. Find this line: `$config->debug = false;` 
-3. Change the `false` to `true`, like below, and save. 
+3. Change the `false` to `true` like below, and save. 
 
 ```
 $config->debug = true; 
 ```
-
 This can be found near the bottom of the file, or you can add it if not
 already there. It will make PHP and ProcessWire report all errors, warnings,
 notices, etc. Of course, you'll want to set it back to false once you've 
@@ -172,14 +169,12 @@ resolved any issues.
 
 * [ProcessWire Support Forums](https://processwire.com/talk/)
 * [ProcessWire Weekly News](https://weekly.pw/)
-* [ProcessWire Blog](https://processwire.com/blog/)
 * [Sites running ProcessWire](https://processwire.com/sites/)
 * [Subscribe to ProcessWire Weekly email](https://processwire.com/community/newsletter/subscribe/)
 * [Submit your site to our directory](https://processwire.com/sites/submit/)
-* [Follow @processwire on Twitter](http://twitter.com/processwire/)
-* [Contact ProcessWire](https://processwire.com/contact/)
+* [Contact ProcessWire developer](https://processwire.com/contact/)
+* [Report issue](https://github.com/processwire/processwire-issues/issues)
 
 ------
 
-Copyright 2023 by Ryan Cramer / Ryan Cramer Design, LLC
-
+Copyright 2025 by Ryan Cramer / Ryan Cramer Design, LLC

composer.json

@@ -14,7 +14,7 @@
     }
   ],
   "require": {
-    "php": ">=5.5",
+    "php": ">=7.1",
     "ext-gd": "*"
   },
   "autoload": {

htaccess.txt

@@ -390,7 +390,7 @@ DirectoryIndex index.php index.html index.htm
   RewriteCond %{REQUEST_URI} (^|/)(site|site-[^/]+)/modules/.*\.(php|inc|tpl|module|info\.json)$ [NC,OR]
   
   # Block access to any software identifying txt, markdown or textile files
-  RewriteCond %{REQUEST_URI} (^|/)(COPYRIGHT|INSTALL|README|htaccess)\.(txt|md|textile)$ [NC,OR]
+  RewriteCond %{REQUEST_URI} (^|/)(COPYRIGHT|INSTALL|README|CHANGELOG|LICENSE|htaccess)\.(txt|md|textile)$ [NC,OR]
   
   # Block potential arbitrary backup files within site directories for things like config
   RewriteCond %{REQUEST_URI} (^|/)(site|site-[^/]+)/(config[^/]*/?|[^/]+\.php.*)$ [NC,OR]
@@ -448,7 +448,7 @@ DirectoryIndex index.php index.html index.htm
   RewriteCond %{REQUEST_FILENAME} !(favicon\.ico|robots\.txt)
 
   # -----------------------------------------------------------------------------------------------
-  # 18. Optionally (O) prevent PW from attempting to serve images or anything in /site/assets/. 
+  # 18. Optionally (O) prevent PW from serving some file types, or anything in /site/assets/. 
   # Both of these lines are optional, but can help to reduce server load. However, they
   # are not compatible with the $config->pagefileSecure option (if enabled) and they 
   # may produce an Apache 404 rather than your regular 404. You may uncomment the two lines
@@ -458,7 +458,7 @@ DirectoryIndex index.php index.html index.htm
   # section #2 above that makes ProcessWire the 404 handler. 
   # ----------------------------------------------------------------------------------------------- 
 
-  # RewriteCond %{REQUEST_URI} !\.(jpg|jpeg|gif|png|ico|webp|svg)$ [NC]
+  # RewriteCond %{REQUEST_URI} !\.(jpg|jpeg|gif|png|ico|webp|svg|js|css)$ [NC]
   # RewriteCond %{REQUEST_FILENAME} !(^|/)site/assets/
 
   # ----------------------------------------------------------------------------------------------- 
@@ -478,5 +478,4 @@ DirectoryIndex index.php index.html index.htm
 
 #################################################################################################
 # END PROCESSWIRE HTACCESS DIRECTIVES
-#################################################################################################
-
+#################################################################################################

install.php

@@ -11,7 +11,7 @@
  * If that file exists, the installer will not run. So if you need to re-run this installer for any
  * reason, then you'll want to delete that file. This was implemented just in case someone doesn't delete the installer.
  * 
- * ProcessWire 3.x, Copyright 2022 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2025 by Ryan Cramer
  * https://processwire.com
  * 
  * @todo 3.0.190: provide option for command-line options to install
@@ -47,7 +47,7 @@ class Installer {
 	 * Minimum required PHP version to install ProcessWire
 	 *
 	 */
-	const MIN_REQUIRED_PHP_VERSION = '5.3.8';
+	const MIN_REQUIRED_PHP_VERSION = '7.1.0';
 
 	/**
 	 * Test mode for installer development, non destructive
@@ -91,18 +91,19 @@ class Installer {
 	public function execute() {
 		
 		if(self::TEST_MODE) {
-			error_reporting(E_ALL | E_STRICT);
+			error_reporting(E_ALL);
 			ini_set('display_errors', 1);
 		}
 
 		// these two vars used by install-head.inc
 		$title = "ProcessWire " . PROCESSWIRE_INSTALL . " Installer";
 		$formAction = "./install.php";
-		
-		require("./wire/modules/AdminTheme/AdminThemeUikit/install-head.inc"); 
-
 		$step = $this->post('step');
 		
+		if($step === '5') require('./index.php');
+		
+		require("./wire/modules/AdminTheme/AdminThemeUikit/install-head.inc");
+
 		if($step === null) {
 			$this->welcome();
 		} else {
@@ -112,7 +113,7 @@ class Installer {
 				case 1: $this->compatibilityCheck(); break;
 				case 2: $this->dbConfig();  break;
 				case 4: $this->dbSaveConfig();  break;
-				case 5: require("./index.php");
+				case 5: 
 					/** @var ProcessWire $wire */
 					$wire->modules->refresh();
 					$this->adminAccountSave($wire);
@@ -187,7 +188,7 @@ class Installer {
 			if($dir->isDot() || !$dir->isDir()) continue; 
 			$name = $dir->getBasename();
 			$path = rtrim($dir->getPathname(), '/') . '/';
-			if(strpos($name, 'site-') !== 0) continue;
+			if(strpos($name, 'site-') !== 0 && $name !== 'site') continue;
 			$passed = true;
 			foreach($dirTests as $test) if(!is_dir($path . $test)) $passed = false;
 			foreach($fileTests as $test) if(!file_exists($path . $test)) $passed = false; 
@@ -402,11 +403,15 @@ class Installer {
 				$this->warn("Consider making directory $d writable, at least during development."); 
 			}
 		}
-		
-		if(is_writable("./site/config.php")) {
-			$this->ok("/site/config.php is writable");
+	
+		if(file_exists("./site/config.php")) {
+			if(is_writable("./site/config.php")) {
+				$this->ok("/site/config.php is writable");
+			} else {
+				$this->err("/site/config.php must be writable during installation. Please adjust the server permissions before continuing.");
+			}
 		} else {
-			$this->err("/site/config.php must be writable. Please adjust the server permissions before continuing.");
+			$this->err("Site profile is missing a /site/config.php file.");
 		}
 		
 		if(!is_file("./.htaccess") || !is_readable("./.htaccess")) {
@@ -474,11 +479,13 @@ class Installer {
 		if(!isset($values['dbPort'])) $values['dbPort'] = ini_get("mysqli.default_port"); 
 		if(!isset($values['dbUser'])) $values['dbUser'] = ini_get("mysqli.default_user"); 
 		if(!isset($values['dbPass'])) $values['dbPass'] = ini_get("mysqli.default_pw");
-		if(!isset($values['dbEngine'])) $values['dbEngine'] = 'MyISAM';
+		if(!isset($values['dbEngine'])) $values['dbEngine'] = 'InnoDB';
+		if(!isset($values['dbSocket'])) $values['dbSocket'] = ini_get("mysqli.default_socket");
+		if(!isset($values['dbCon'])) $values['dbCon'] = 'Hostname';
 
 		if(!$values['dbHost']) $values['dbHost'] = 'localhost';
 		if(!$values['dbPort']) $values['dbPort'] = 3306;
-		if(empty($values['dbCharset'])) $values['dbCharset'] = 'utf8';
+		if(empty($values['dbCharset'])) $values['dbCharset'] = 'utf8mb4';
 		if($values['dbCharset'] != 'utf8mb4') $values['dbCharset'] = 'utf8';
 		if($values['dbEngine'] != 'InnoDB') $values['dbEngine'] = 'MyISAM';
 
@@ -486,22 +493,45 @@ class Installer {
 			if(strpos($key, 'chmod') === 0) {
 				$values[$key] = (int) $value;
 			} else if($key != 'httpHosts') {
-				$values[$key] = htmlspecialchars($value, ENT_QUOTES, 'utf-8'); 
+				$values[$key] = htmlspecialchars($value, ENT_QUOTES, 'UTF-8'); 
 			}
 		}
 		
 		$this->input('dbName', 'DB Name', $values['dbName']); 
 		$this->input('dbUser', 'DB User', $values['dbUser']);
-		$this->input('dbPass', 'DB Pass', $values['dbPass'], array('type' => 'password', 'required' => false)); 
-		$this->input('dbHost', 'DB Host', $values['dbHost']); 
+		$this->input('dbPass', 'DB Pass', $values['dbPass'], array('type' => 'password', 'required' => false));
+		$this->select('dbCon', 'Connection', $values['dbCon'], array('Hostname', 'Socket'));
+		$this->clear();
+		
+		$this->input('dbHost', 'DB Host', $values['dbHost']);
 		$this->input('dbPort', 'DB Port', $values['dbPort']);
-	
-		$this->select('dbCharset', 'DB Charset', $values['dbCharset'], array('utf8', 'utf8mb4'));
-		$this->select('dbEngine', 'DB Engine', $values['dbEngine'], array('MyISAM', 'InnoDB'));
+		$this->input('dbSocket', 'DB Socket', $values['dbSocket'], array('width' => 300));
+		$this->select('dbCharset', 'DB Charset', $values['dbCharset'], array('utf8mb4', 'utf8'));
+		$this->select('dbEngine', 'DB Engine', $values['dbEngine'], array('InnoDB', 'MyISAM'));
 		$this->clear();
 	
+		// automatic required states for host, port and socket
+		echo "
+			<script>
+				jQuery(document).ready(function($) {
+					let ho = $('input[name=dbHost]'), po = $('input[name=dbPort]'), 
+						so = $('input[name=dbSocket]'), co = $('select[name=dbCon]');
+					co.on('change', function() {
+						if(co.val() === 'Hostname') {
+							ho.prop('required', true).closest('p').show();
+							po.prop('required', true).closest('p').show();
+							so.prop('required', false).closest('p').hide();
+						} else {
+							ho.prop('required', false).closest('p').hide();
+							po.prop('required', false).closest('p').hide();
+							so.prop('required', true).closest('p').show();
+						}
+					}).change();
+				});
+			</script>
+		";
+	
 		$this->p(
-			"The DB Charset option “utf8mb4” may not be compatible with all 3rd party modules.<br />" . 
 			"The DB Engine option “InnoDB” requires MySQL 5.6.4 or newer.", 
 			array('class' => 'detail', 'style' => 'margin-top:0')
 		);
@@ -666,27 +696,37 @@ class Installer {
 		$values['debugMode'] = $this->post('debugMode', 'int');
 
 		// db configuration
-		$fields = array('dbUser', 'dbName', 'dbPass', 'dbHost', 'dbPort', 'dbEngine', 'dbCharset');
+		$fields = array('dbUser', 'dbName', 'dbPass', 'dbHost', 'dbPort', 'dbSocket', 'dbEngine', 'dbCharset', 'dbCon');
 		
 		foreach($fields as $field) {
 			$value = $this->post($field, 'string');
 			$value = substr($value, 0, 255); 
 			if(strpos($value, "'") !== false) $value = str_replace("'", "\\" . "'", $value); // allow for single quotes (i.e. dbPass)
+			if($field != 'dbPass') $value = str_replace(array(';', '..', '=', '<', '>', '&', '"', "\t", "\n", "\r"), '', $value);
 			$values[$field] = trim($value); 
 		}
 	
 		$values['dbCharset'] = ($values['dbCharset'] === 'utf8mb4' ? 'utf8mb4' : 'utf8'); 
-		$values['dbEngine'] = ($values['dbEngine'] === 'InnoDB' ? 'InnoDB' : 'MyISAM'); 
+		$values['dbEngine'] = ($values['dbEngine'] === 'InnoDB' ? 'InnoDB' : 'MyISAM');
 
-		if(!$values['dbUser'] || !$values['dbName'] || !$values['dbPort']) {
+		if(empty($values['dbUser']) || empty($values['dbName'])) {
+			$this->alertErr("Missing database user and/or name");
 			
-			$this->alertErr("Missing database configuration fields"); 
+		} else if($values['dbCon'] === 'Socket' && empty($values['dbSocket'])) {
+			$this->alertErr("Missing database socket");
+			
+		} else if($values['dbCon'] === 'Hostname' && (empty($values['dbHost']) || empty($values['dbPort']))) {
+			$this->alertErr("Missing database host and/or port");
 			
 		} else {
 	
 			error_reporting(0); 
-			
-			$dsn = "mysql:dbname=$values[dbName];host=$values[dbHost];port=$values[dbPort]";
+		
+			if($values['dbCon'] === 'Socket') {
+				$dsn = "mysql:unix_socket=$values[dbSocket];dbname=$values[dbName]";
+			} else {
+				$dsn = "mysql:dbname=$values[dbName];host=$values[dbHost];port=$values[dbPort]";
+			}
 			$driver_options = array(
 				\PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES 'UTF8'",
 				\PDO::ATTR_ERRMODE => \PDO::ERRMODE_EXCEPTION
@@ -830,6 +870,7 @@ class Installer {
 		$file = __FILE__; 
 		$time = time();
 		$host = empty($values['httpHosts']) ? '' : implode(',', $values['httpHosts']);
+		$s = is_file("./site/config.php") ? file_get_contents("./site/config.php") : '';
 
 		if(function_exists('random_bytes')) {
 			$authSalt = sha1(random_bytes(random_int(40, 128)));
@@ -843,17 +884,27 @@ class Installer {
 			"\n/**" . 
 			"\n * Installer: Database Configuration" . 
 			"\n * " . 
-			"\n */" . 
+			"\n */";
+
+		if($values['dbCon'] === 'Socket') {
+			$cfg .= "\n\$config->dbSocket = '$values[dbSocket]';";
+		}
+		
+		$cfg .= 
 			"\n\$config->dbHost = '$values[dbHost]';" . 
 			"\n\$config->dbName = '$values[dbName]';" . 
 			"\n\$config->dbUser = '$values[dbUser]';" . 
 			"\n\$config->dbPass = '$values[dbPass]';" . 
 			"\n\$config->dbPort = '$values[dbPort]';";
 		
-		if(!empty($values['dbCharset']) && strtolower($values['dbCharset']) != 'utf8') $cfg .= "\n\$config->dbCharset = '$values[dbCharset]';";
-		if(!empty($values['dbEngine']) && $values['dbEngine'] == 'InnoDB') $cfg .= "\n\$config->dbEngine = 'InnoDB';";
+		if(!empty($values['dbCharset']) && strtolower($values['dbCharset']) != 'utf8') {
+			$cfg .= "\n\$config->dbCharset = '$values[dbCharset]';";
+		}
+		if(!empty($values['dbEngine']) && $values['dbEngine'] == 'InnoDB') {
+			$cfg .= "\n\$config->dbEngine = 'InnoDB';";
+		}
 		
-		$cfg .= 
+		if(strpos($s, '$config->userAuthSalt') === false) $cfg .= 
 			"\n" . 
 			"\n/**" . 
 			"\n * Installer: User Authentication Salt " . 
@@ -864,7 +915,9 @@ class Installer {
 			"\n * Do not change this value, or user passwords will no longer work." .
 			"\n * " . 
 			"\n */" . 
-			"\n\$config->userAuthSalt = '$authSalt'; " .
+			"\n\$config->userAuthSalt = '$authSalt'; ";
+
+		if(strpos($s, '$config->tableSalt') === false) $cfg .=
 			"\n" .
 			"\n/**" . 
 			"\n * Installer: Table Salt (General Purpose) " .
@@ -874,7 +927,9 @@ class Installer {
 			"\n * this value or it may break internal system comparisons that use it. " . 
 			"\n * " .
 			"\n */" . 
-			"\n\$config->tableSalt = '$tableSalt'; " .
+			"\n\$config->tableSalt = '$tableSalt'; ";
+		
+		$cfg .= 
 			"\n" . 
 			"\n/**" . 
 			"\n * Installer: File Permission Configuration" . 
@@ -888,13 +943,17 @@ class Installer {
 			"\n * " . 
 			"\n */" . 
 			"\n\$config->timezone = '$values[timezone]';" .
-			"\n" .
+			"\n";
+
+		if(strpos($s, '$config->defaultAdminTheme') === false) $cfg .=
 			"\n/**" .
 			"\n * Installer: Admin theme" .
 			"\n * " .
 			"\n */" .
 			"\n\$config->defaultAdminTheme = 'AdminThemeUikit';" .
-			"\n" . 
+			"\n";
+
+		if(strpos($s, '$config->installed ') === false) $cfg .=
 			"\n/**" .
 			"\n * Installer: Unix timestamp of date/time installed" .
 			"\n * " .
@@ -927,7 +986,9 @@ class Installer {
 			"\n */" .
 			"\n\$config->debug = " . ($values['debugMode'] ? 'true;' : 'false;') . 
 			"\n\n";
-		
+
+		if(strpos($s, '<' . '?php') === false) $cfg = '<' . "?php namespace ProcessWire;\n\n" . $cfg; 
+			
 		if(($fp = fopen("./site/config.php", "a")) && fwrite($fp, $cfg)) {
 			fclose($fp); 
 			$this->alertOk("Saved configuration to ./site/config.php"); 
@@ -1072,27 +1133,28 @@ class Installer {
 	 */
 	protected function profileImportSQL($database, $file1, $file2, array $options = array()) {
 		$defaults = array(
-			'dbEngine' => 'MyISAM',
-			'dbCharset' => 'utf8', 
+			'dbEngine' => 'InnoDB',
+			'dbCharset' => 'utf8mb4', 
 		);
 		$options = array_merge($defaults, $options); 
 		if(self::TEST_MODE) return;
 		$restoreOptions = array();
 		$replace = array();
-		if($options['dbEngine'] != 'MyISAM') {
-			$replace['ENGINE=MyISAM'] = "ENGINE=$options[dbEngine]";
-		}
-		if($options['dbCharset'] != 'utf8') {
-			$replace['CHARSET=utf8'] = "CHARSET=$options[dbCharset]";
-			if(strtolower($options['dbCharset']) === 'utf8mb4') {
-				if(strtolower($options['dbEngine']) === 'innodb') {
-					$replace['(255)'] = '(191)'; 
-					$replace['(250)'] = '(191)'; 
-				} else {
-					$replace['(255)'] = '(250)'; // max ley length in utf8mb4 is 1000 (250 * 4)
-				}
+		$replace['ENGINE=InnoDB'] = "ENGINE=$options[dbEngine]";
+		$replace['ENGINE=MyISAM'] = "ENGINE=$options[dbEngine]";
+		$replace['CHARSET=utf8mb4;'] = "CHARSET=$options[dbCharset];";
+		$replace['CHARSET=utf8;'] = "CHARSET=$options[dbCharset];";
+		$replace['CHARSET=utf8 COLLATE='] = "CHARSET=$options[dbCharset] COLLATE=";
+		
+		if(strtolower($options['dbCharset']) === 'utf8mb4') {
+			if(strtolower($options['dbEngine']) === 'innodb') {
+				$replace['(255)'] = '(191)'; 
+				$replace['(250)'] = '(191)'; 
+			} else {
+				$replace['(255)'] = '(250)'; // max ley length in utf8mb4 is 1000 (250 * 4)
 			}
 		}
+		
 		if(count($replace)) $restoreOptions['findReplaceCreateTable'] = $replace; 
 		require("./wire/core/WireDatabaseBackup.php"); 
 		$backup = new WireDatabaseBackup(); 
@@ -1196,6 +1258,7 @@ class Installer {
 		);
 		
 		foreach($this->findProfiles() as $name => $profile) {
+			if($name === 'site') continue;
 			$title = empty($profile['title']) ? $name : $profile['title'];
 			$items[$name] = array(
 				'label' => "Remove unused $title site profile (/$name/)", 
@@ -1772,10 +1835,6 @@ class Installer {
 		
 		if($value === null && empty($sanitizer)) return null;
 		
-		if(version_compare(PHP_VERSION, "5.4.0", "<") && function_exists('get_magic_quotes_gpc')) {
-			if(get_magic_quotes_gpc()) $value = stripslashes($value);
-		}
-		
 		switch($sanitizer) {
 			case 'intSigned':
 				$value = (int) $value;
@@ -2002,7 +2061,6 @@ class Installer {
 /****************************************************************************************************/
 
 if(!Installer::TEST_MODE && is_file("./site/assets/installed.php")) die("This installer has already run. Please delete it."); 
-error_reporting(E_ALL | E_STRICT); 
+error_reporting(E_ALL); 
 $installer = new Installer();
-$installer->execute();
-
+$installer->execute();

site-blank/config.php

@@ -17,7 +17,7 @@
  * This file is licensed under the MIT license
  * https://processwire.com/about/license/mit/
  *
- * ProcessWire 3.x, Copyright 2022 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2025 by Ryan Cramer
  * https://processwire.com
  *
  */
@@ -46,5 +46,4 @@ $config->appendTemplateFile = '_main.php';
 // Allow template files to be compiled for backwards compatibility?
 $config->templateCompile = false;
 
-/*** INSTALLER CONFIG ********************************************************************/
-
+/*** INSTALLER CONFIG ********************************************************************/

site-blank/install/install.sql

@@ -185,7 +185,6 @@ CREATE TABLE `modules` (
 ) ENGINE=MyISAM AUTO_INCREMENT=159 DEFAULT CHARSET=utf8;
 
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('1', 'FieldtypeTextarea', '0', '', NOW());
-INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('2', 'FieldtypeNumber', '0', '', NOW());
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('3', 'FieldtypeText', '0', '', NOW());
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('4', 'FieldtypePage', '0', '', NOW());
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('30', 'InputfieldForm', '0', '', NOW());
@@ -207,7 +206,6 @@ INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('28', '
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('29', 'FieldtypeEmail', '0', '', NOW());
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('108', 'InputfieldURL', '0', '', NOW());
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('32', 'InputfieldSubmit', '0', '', NOW());
-INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('33', 'InputfieldWrapper', '0', '', NOW());
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('34', 'InputfieldText', '0', '', NOW());
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('35', 'InputfieldTextarea', '0', '', NOW());
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('36', 'InputfieldSelect', '0', '', NOW());
@@ -218,7 +216,6 @@ INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('40', '
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('41', 'InputfieldName', '0', '', NOW());
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('43', 'InputfieldSelectMultiple', '0', '', NOW());
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('45', 'JqueryWireTabs', '0', '', NOW());
-INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('46', 'ProcessPage', '0', '', NOW());
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('47', 'ProcessTemplate', '0', '', NOW());
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('48', 'ProcessField', '0', '', NOW());
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('50', 'ProcessModule', '0', '', NOW());
@@ -267,7 +264,7 @@ INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('148',
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('149', 'InputfieldSelector', '2', '', NOW());
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('150', 'ProcessPageLister', '0', '', NOW());
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('151', 'JqueryMagnific', '1', '', NOW());
-INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('155', 'InputfieldCKEditor', '0', '', NOW());
+INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('155', 'InputfieldTinyMCE', '0', '', NOW());
 INSERT INTO `modules` (`id`, `class`, `flags`, `data`, `created`) VALUES('156', 'MarkupHTMLPurifier', '0', '', NOW());
 
 DROP TABLE IF EXISTS `pages`;

site-blank/templates/_main.php

@@ -11,8 +11,8 @@
 /** @var Page $page */
 /** @var Pages $pages */
 /** @var Config $config */
-
-$home = $pages->get('/'); // homepage
+	
+$home = $pages->get('/'); /** @var HomePage $home */
 
 ?><!DOCTYPE html>
 <html lang="en">
@@ -52,4 +52,4 @@ $home = $pages->get('/'); // homepage
 		<?php endif; ?>
 	
 	</body>
-</html>
+</html>

site-blank/templates/basic-page.php

@@ -1,11 +1,15 @@
 <?php namespace ProcessWire; 
 
 // Template file for pages using the “basic-page” template
+// -------------------------------------------------------
+// The #content div in this file will replace the #content div in _main.php
+// when the Markup Regions feature is enabled, as it is by default. 
+// You can also append to (or prepend to) the #content div, and much more. 
+// See the Markup Regions documentation:
+// https://processwire.com/docs/front-end/output/markup-regions/
 
 ?>
 
-
 <div id="content">
 	Basic page content 
-</div>	
-
+</div>	

site-blank/templates/home.php

@@ -1,10 +1,15 @@
 <?php namespace ProcessWire;
 
 // Template file for “home” template used by the homepage
+// ------------------------------------------------------
+// The #content div in this file will replace the #content div in _main.php
+// when the Markup Regions feature is enabled, as it is by default. 
+// You can also append to (or prepend to) the #content div, and much more. 
+// See the Markup Regions documentation:
+// https://processwire.com/docs/front-end/output/markup-regions/
 
 ?>
 
 <div id="content">
 	Homepage content 
-</div>	
-	
+</div>	

wire/config.php

@@ -12,7 +12,7 @@
  * You may also make up your own configuration options by assigning them 
  * in /site/config.php 
  * 
- * ProcessWire 3.x, Copyright 2022 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2025 by Ryan Cramer
  * https://processwire.com
  *
  * 
@@ -46,28 +46,40 @@ if(!defined("PROCESSWIRE")) die();
  * always have this disabled for live/production sites since it reveals more information
  * than is advisible for security. 
  * 
- * You may also set this to the constant `Config::debugVerbose` to enable verbose debug mode,
- * which uses more memory and time. 
+ * You may also set this to one of the constants:
+ * - `Config::debugVerbose` (or int `2`) for verbose debug mode, which uses more memory/time. 
+ * - `Config::debugDev` (or string `dev`) for core development debug mode, which makes it use
+ *    newer JS libraries in some cases when we are testing them. 
  * 
  * #notes This enables debug mode for ALL requests. See the debugIf option for an alternative.
  * 
- * @var bool
+ * @var bool|string|int 
  *
  */
 $config->debug = false;
 
 /**
  * Enable debug mode if condition is met
+ * 
+ * ~~~~~
+ * $config->debug = false; // setting this to false required when using debugIf
+ * $config->debugIf = '123.123.123.123'; // true if user matches this IP address
+ * $config->debugIf = [ '123.123.123.123', '456.456.456.456' ]; // array of IPs (3.0.212)+
+ * $config->debugIf = 'function_name_to_call'; // callable function name
+ * $config->debugIf = function() { // callable function (3.0.212+)
+ *   return $_SERVER['SERVER_PORT'] === '8888'; 
+ * }; 
+ * ~~~~~
  *
  * Set debug mode to be false above, and then specify any one of the following here:
- * 1) IP address of user required to enable debug mode;
- * 2) Your own callable function name (i.e. "debug_mode") in /site/config.php that returns
- * true or false for debug mode;
- * 3) PCRE regular expression to match IP address of user (must start and end with a "/"
- * slash). If IP address matches, then debug mode is enabled. Regular expression
- * example: /^123\.456\.789\./ would match all IP addresses that started with 123.456.789.
+ * - IP address of user required to enable debug mode;
+ * - Array of IP addresses where that debug mode should be enabled for (3.0.212+).
+ * - Your own callable function in /site/config.php that returns true or false for debug mode.
+ * - PCRE regular expression to match IP address of user (must start and end with a "/"
+ *   slash). If IP address matches, then debug mode is enabled. Regular expression
+ *   example: `/^123\.456\.789\./` would match all IP addresses that started with 123.456.789.
  * 
- * #notes When used, this overrides $config->debug, changing it at runtime automatically. 
+ * #notes When used, this will override a false $config->debug, changing it at runtime automatically. 
  * @var string
  *
  */
@@ -214,6 +226,36 @@ $config->usePageClasses = false;
  */
 $config->useLazyLoading = true;
 
+/**
+ * Default value for $useVersion argument of $config->versionUrls() method
+ * 
+ * Controls the cache busting behavior of the `$config->versionUrls()` method as used by
+ * ProcessWire’s admin themes (but may be used independently as well). When no 
+ * `$useVersion` argument is specified to the versionUrls() method, it will use the 
+ * default value specified here. If not specified, null is the default. 
+ * 
+ * - `true` (bool): Get version from filemtime.
+ * - `false` (bool): Never get file version, just use `$config->version`.
+ * - `foobar` (string): Specify any string to be the version to use on all URLs needing it.
+ * - `?foo=bar` (string): Optionally specify your own query string variable=value. 
+ * - `null` (null): Auto-detect: use file version in debug mode or dev branch only, 
+ *    otherwise use `$config->version`.
+ * 
+ * ~~~~~
+ * // choose one to start with, copy and place in /site/config.php to enable
+ * $config->useVersionUrls = null; // default setting
+ * $config->useVersionUrls = true; // always use filemtime based version URLs
+ * $config->useVersionUrls = false; // only use core version in URLs
+ * $config->versionUrls = 'hello-world'; // always use this string as the version
+ * $config->versionUrls = '?version=123'; // optionally specify query string var and value
+ * ~~~~~
+ * 
+ * @var null|bool|string
+ * @since 3.0.227
+ *
+ * $config->useVersionUrls = null;
+ */
+
 /**
  * Disable all HTTPS requirements?
  * 
@@ -304,8 +346,8 @@ $config->sessionExpireSeconds = 86400;
  * Use this to determine at runtime whether or not a session is allowed for the current request. 
  * Otherwise, this should always be boolean TRUE. When using this option, we recommend 
  * providing a callable function like below. Make sure that you put in some logic to enable
- * sessions on admin pages at minimum. The callable function receives a single $wire argument
- * which is the ProcessWire instance. 
+ * sessions on admin pages at minimum. The callable function receives a single $session argument
+ * which is the ProcessWire Session instance. 
  * 
  * Note that the API is not fully ready when this function is called, so the current $page and
  * the current $user are not yet known, nor is the $input API variable available. 
@@ -481,6 +523,18 @@ $config->sessionHistory = 0;
  */
 $config->userAuthHashType = 'sha1';
 
+/**
+ * Enable output formatting for current $user API variable at boot?
+ * 
+ * EXPERIMENTAL: May not be compatible with with all usages, so if setting to `true` 
+ * then be sure to test thoroughly on anything that works with $user API variable. 
+ * 
+ * @var bool
+ * @since 3.0.241
+ * 
+ */
+$config->userOutputFormatting = false;
+
 /**
  * Names (string) or IDs (int) of roles that are not allowed to login
  *
@@ -688,7 +742,7 @@ $config->contentTypes = array(
 	'txt' => 'text/plain', 
 	'json' => 'application/json',
 	'xml' => 'application/xml', 
-	);
+);
 
 /**
  * File content types
@@ -721,7 +775,7 @@ $config->fileContentTypes = array(
 	'webp' => 'image/webp',
 	'zip' => '+application/zip',
 	'mp3' => 'audio/mpeg',
-	);
+);
 
 /**
  * Named predefined image sizes and options
@@ -785,7 +839,7 @@ $config->imageSizerOptions = array(
 	'hidpiQuality' => 60, // Same as above quality setting, but specific to hidpi images
 	'defaultGamma' => 2.0, // defaultGamma: 0.5 to 4.0 or -1 to disable gamma correction (default=2.0)
 	'webpAdd' => false, // set this to true, if the imagesizer engines should create a Webp copy with every (new) image variation
-	);
+);
 
 /**
  * Options for webp images
@@ -803,7 +857,7 @@ $config->webpOptions = array(
 	'useSrcExt' => false, // Use source file extension in webp filename? (file.jpg.webp rather than file.webp)
 	'useSrcUrlOnSize' => true, // Fallback to source file URL when webp file is larger than source?
 	'useSrcUrlOnFail' => true, // Fallback to source file URL when webp file fails for some reason?
-	);
+);
 
 /**
  * Admin thumbnail image options
@@ -834,7 +888,7 @@ $config->adminThumbOptions = array(
 	'sharpening' => 'soft', // sharpening: none | soft | medium | strong
 	'quality' => 90,
 	'suffix' => '', 
-	);
+);
 
 /**
  * File compiler options (as used by FileCompiler class)
@@ -863,7 +917,7 @@ $config->fileCompilerOptions = array(
 	'exclusions' => array(), // exclude filenames or paths that start with any of these
 	'extensions' => array('php', 'module', 'inc'), // file extensions we compile
 	'cachePath' => '', // path where compiled files are stored, or blank for $config->paths->cache . 'FileCompiler/'
-	);
+);
 
 /**
  * Temporary directory for uploads
@@ -931,7 +985,7 @@ $config->protectCSRF = true;
  * @var int
  *
  */
-$config->maxUrlSegments = 4;
+$config->maxUrlSegments = 20;
 
 /**
  * Maximum length for any individual URL segment (default=128)
@@ -950,7 +1004,23 @@ $config->maxUrlSegmentLength = 128;
  * @var int
  * 
  */
-$config->maxUrlDepth = 30; 
+$config->maxUrlDepth = 30;
+
+/**
+ * Long URL response (URL depth, length or segments overflow)
+ *
+ * HTTP code that ProcessWire should respond with when it receives more URL segments,
+ * more URL depth, or longer URL length than what is allowed. Suggested values:
+ *
+ * - `404`: Page not found
+ * - `301`: Redirect to closest allowed URL (permanent)
+ * - `302`: Redirect to closest allowed URL (temporary)
+ *
+ * @var int
+ * @since 3.0.243
+ *
+ */
+$config->longUrlResponse = 404;
 
 /**
  * Pagination URL prefix
@@ -995,6 +1065,14 @@ $config->pageNameCharset = 'ascii';
  * 
  * Please note this whitelist is only used if pageNameCharset is 'UTF8'. 
  * 
+ * If your ProcessWire version is 3.0.244+ AND your installation date was before 10 Jan 2025, 
+ * AND you are enabling UTF8 page names now, please add the text `v3` (without the quotes) 
+ * at the beginning or end of your pageNameWhitelist. This will ensure that it uses a 
+ * newer/better UTF-8 page name conversion. The older version is buggy on PHP versions 7.4+, 
+ * but is used for existing installations so as not to unexpectedly change any existing page 
+ * names. When a new ProcessWire installation occurs after 5 Jan 2025 it automatically uses 
+ * the newer/better version and does not require anything further. 
+ * 
  * @var string
  * 
  */ 
@@ -1363,8 +1441,8 @@ $config->moduleServiceKey = 'pw301';
  */
 $config->moduleInstall = array(
 	'directory' => 'debug', // allow install from ProcessWire modules directory? 
-	'upload' => 'debug', // allow install by module file upload?
-	'download' => 'debug', // allow install by download from URL?
+	'upload' => false, // allow install by module file upload?
+	'download' => false, // allow install by download from URL?
 );
 
 /**
@@ -1650,14 +1728,15 @@ $config->modals = array(
  * This is an optimization that can reduce some database overhead. 
  *
  * @var array
+ * @deprecated No longer in use as of 3.0.218
  *
  */
 $config->preloadCacheNames = array(
-	'Modules.info',
+	//'Modules.info',
 	//'ModulesVerbose.info',
-	'ModulesVersions.info',
-	'Modules.wire/modules/',
-	'Modules.site/modules/',
+	//'ModulesVersions.info',
+	//'Modules.wire/modules/',
+	//'Modules.site/modules/',
 );
 
 /**

wire/core/AdminThemeFramework.php

@@ -17,6 +17,7 @@
  * @property bool $isLoggedIn
  * @property bool|string $isModal
  * @property bool|int $useAsLogin
+ * @property string $browserTitle Optional custom browser title for this request (3.0.217+)
  * @method array getUserNavArray()
  * @method array getPrimaryNavArray()
  * @method string renderFile($basename, array $vars = [])
@@ -93,6 +94,7 @@ abstract class AdminThemeFramework extends AdminTheme {
 	public function __construct() {
 		parent::__construct();
 		$this->set('useAsLogin', false);
+		$this->set('browserTitle', ''); 
 	}
 	
 	public function wired() {
@@ -191,8 +193,8 @@ abstract class AdminThemeFramework extends AdminTheme {
 	 *
 	 */
 	public function getHeadline() {
-		$headline = $this->wire('processHeadline');
-		if(!$headline) $headline = $this->wire()->page->get('title|name');
+		$headline = (string) $this->wire('processHeadline');
+		if(!strlen($headline)) $headline = $this->wire()->page->get('title|name');
 		if($headline !== 'en' && $this->wire()->languages) $headline = $this->_($headline);
 		return $this->sanitizer->entities1($headline);
 	}
@@ -262,7 +264,8 @@ abstract class AdminThemeFramework extends AdminTheme {
 		$input = $this->wire()->input;
 
 		if(!$this->isEditor) return array();
-		if($page->name != 'page' || $input->urlSegment1 || $input->get('modal')) return array();
+		if($page->name != 'page' && $page->name != 'list') return array();
+		if($input->urlSegment1 || $input->get('modal')) return array();
 		if(strpos($process, 'ProcessPageList') !== 0) return array();
 
 		/** @var ProcessPageAdd $module */
@@ -579,6 +582,9 @@ abstract class AdminThemeFramework extends AdminTheme {
 	 *
 	 */
 	public function getBrowserTitle() {
+		
+		$browserTitle = $this->browserTitle; // custom defined browser title
+		if(strlen($browserTitle)) return $this->sanitizer->entities($browserTitle);
 
 		$browserTitle = $this->wire('processBrowserTitle');
 		$modal = $this->wire()->input->get('modal');
@@ -670,7 +676,7 @@ abstract class AdminThemeFramework extends AdminTheme {
 		foreach($notices as $n => $notice) {
 			/** @var Notice $notice */
 
-			$text = $notice->text;
+			$text = (string) $notice->text;
 			$allowMarkup = $notice->flags & Notice::allowMarkup;
 			$groupByType = $options['groupByType'] && !($notice->flags & Notice::noGroup) && !($notice instanceof NoticeError); 
 			
@@ -936,4 +942,3 @@ abstract class AdminThemeFramework extends AdminTheme {
 	}
 
 }
-

wire/core/Breadcrumb.php

@@ -11,5 +11,6 @@ class Breadcrumb extends WireData {
 		$this->set('url', $url);
 		$this->set('title', $title);
 		$this->set('titleMarkup', '');
+		parent::__construct();
 	}
-}
+}

wire/core/Config.php

@@ -8,7 +8,7 @@
  * This file is licensed under the MIT license
  * https://processwire.com/about/license/mit/
  * 
- * ProcessWire 3.x, Copyright 2022 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  * 
  * #pw-summary Holds ProcessWire configuration settings as defined in /wire/config.php and /site/config.php. 
@@ -45,7 +45,7 @@
  * @property array $imageSizerOptions Options to set image sizing defaults. Please see the /wire/config.php file for all options and defaults. #pw-group-images
  * @property array $webpOptions Options for webp images. Please see /wire/config.php for all options. #pw-group-images
  * 
- * @property bool $pagefileSecure When used, files in /site/assets/files/ will be protected with the same access as the page. Routines files through a passthrough script. #pw-group-files
+ * @property bool $pagefileSecure When used, files in /site/assets/files/ will be protected with the same access as the page. Routes files through a passthrough script. Note if applying to existing site it may not affect existing pages and file/image fields until they are accessed or saved. #pw-group-files
  * @property string $pagefileSecurePathPrefix One or more characters prefixed to the pathname of protected file dirs. This should be some prefix that the .htaccess file knows to block requests for. #pw-group-files
  * @property string $pagefileUrlPrefix Deprecated property that was a string that prefixes filenames in PW URLs, becoming a shortcut to a page’s file’s URL (do not use, here for backwards compatibility only). #pw-internal
  * 
@@ -91,6 +91,7 @@
  * @property int $maxUrlSegments Maximum number of extra stacked URL segments allowed in a page's URL (including page numbers)  #pw-group-URLs
  * @property int $maxUrlSegmentLength Maximum length of any individual URL segment (default=128). #pw-group-URLs
  * @property int $maxUrlDepth Maximum URL/path slashes (depth) for request URLs. (Min=10, Max=60) #pw-group-URLs
+ * @property int $longUrlResponse Response code when URL segments, depth or length exceeds max allowed. #pw-group-URLs @since 3.0.243
  * @property string $wireInputOrder Order that variables with the $input API var are handled when you access $input->var. #pw-group-HTTP-and-input
  * @property bool $wireInputLazy Specify true for $input API var to load input data in a lazy fashion and potentially use less memory. Default is false. #pw-group-HTTP-and-input
  * @property int $wireInputArrayDepth Maximum multi-dimensional array depth for input variables accessed from $input or 1 to only allow single dimension arrays. #pw-group-HTTP-and-input @since 3.0.178
@@ -98,8 +99,8 @@
  * 
  * @property bool $advanced Special mode for ProcessWire system development. Not recommended for regular site development or production use. #pw-group-system
  * @property bool $demo Special mode for demonstration use that causes POST requests to be disabled. Applies to core, but may not be safe with 3rd party modules. #pw-group-system
- * @property bool|int $debug Special mode for use when debugging or developing a site. Recommended TRUE when site is in development and FALSE when not. Or set to Config::debugVerbose for verbose debug mode. #pw-group-system
- * @property string $debugIf Enable debug mode if condition is met #pw-group-system
+ * @property bool|int|string $debug Special mode for use when debugging or developing a site. Recommended TRUE when site is in development and FALSE when not. Or set to `Config::debug*` constant. #pw-group-system
+ * @property string|callable|array $debugIf Enable debug mode if condition is met. One of IP address to match, regex to match IP, array of IPs to match, or callable function that returns true|false. #pw-group-system
  * @property array $debugTools Tools, and their order, to show in debug mode (admin) #pw-group-system
  * 
  * @property string $ignoreTemplateFileRegex Regular expression to ignore template files #pw-group-template-files
@@ -151,10 +152,12 @@
  * @property bool $useMarkupRegions Enable support for front-end markup regions? #pw-group-system
  * @property bool|array $useLazyLoading Delay loading of fields (and templates/fieldgroups) till requested? Can improve performance on systems with lots of fields or templates. #pw-group-system @since 3.0.193
  * @property bool $usePageClasses Use custom Page classes in `/site/classes/[TemplateName]Page.php`? #pw-group-system @since 3.0.152
+ * @property bool|int|string|null $useVersionUrls Default value for $useVersion argument of $config->versionUrls() method #pw-group-system @since 3.0.227
  * @property int $lazyPageChunkSize Chunk size for for $pages->findMany() calls. #pw-group-system
  * 
  * @property string $userAuthSalt Salt generated at install time to be used as a secondary/non-database salt for the password system. #pw-group-session
  * @property string $userAuthHashType Default is 'sha1' - used only if Blowfish is not supported by the system. #pw-group-session
+ * @property bool $userOutputFormatting Enable output formatting for current $user API variable at boot? (default=false) #pw-group-session @since 3.0.241
  * @property string $tableSalt Additional hash for other (non-authentication) purposes. #pw-group-system @since 3.0.164
  * 
  * @property bool $internal This is automatically set to FALSE when PW is externally bootstrapped. #pw-group-runtime
@@ -192,6 +195,25 @@
  * @property int $externalPageID Page ID of page assigned to $page API variable when externally bootstrapped #pw-group-system-IDs
  * @property array $preloadPageIDs Page IDs of pages that will always be preloaded at beginning of request #pw-group-system-IDs
  * @property int $installed Timestamp of when this PW was installed, set automatically by the installer for future compatibility detection. #pw-group-system
+ * 
+ * @method array|string wireMail($key = '', $value = null)
+ * @method array imageSizes($key = '', $value = null)
+ * @method array|bool|string|int|float imageSizerOptions($key = '', $value = null)
+ * @method array|int|bool webpOptions($key = '', $value = null)
+ * @method array|string contentTypes($key = '', $value = null)
+ * @method array|string fileContentTypes($key = '', $value = null)
+ * @method array|string|bool fileCompilerOptions($key = '', $value = null)
+ * @method array|string|string[] dbOptions($key = '', $value = null)
+ * @method array|string|string[] dbSqlModes($key = '', $value = null)
+ * @method array|int|bool pageList($key = '', $value = null)
+ * @method array|bool pageEdit($key = '', $value = null)
+ * @method array|string pageAdd($key = '', $value = null)
+ * @method array|string moduleInstall($key = '', $value = null)
+ * @method array|string substituteModules($key = '', $value = null)
+ * @method array|string|bool AdminThemeUikit($key = '', $value = null)
+ * @method array|string modals($key = '', $value = null)
+ * @method array|bool markupQA($key = '', $value = null)
+ * @method array|string statusFiles($key = '', $value = null)
  *
  */
 class Config extends WireData {
@@ -202,6 +224,12 @@ class Config extends WireData {
 	 */
 	const debugVerbose = 2;
 
+	/**
+	 * Constant for core development debug mode (makes it use newer JS libraries in some cases)
+	 * 
+	 */
+	const debugDev = 'dev';
+
 	/**
 	 * Get config property
 	 * 
@@ -923,10 +951,134 @@ class Config extends WireData {
 	 */
 	public function setWire(ProcessWire $wire) {
 		parent::setWire($wire);
-		$paths = $this->paths;
-		if($paths) $paths->setWire($wire);
-		$urls = $this->urls;
-		if($urls) $urls->setWire($wire);
+		foreach(array('paths', 'urls', 'styles', 'scripts') as $key) {
+			$value = $this->get($key);
+			if($value instanceof Wire) $value->setWire($wire);
+		}
 	}
-}
 
+	/**
+	 * Given array of file asset URLs return them with cache-busting version strings
+	 *
+	 * URLs that aready have query strings or URLs with scheme (i.e. https://) are ignored,
+	 * except for URLs that already have a core version query string, i.e. `?v=3.0.227`
+	 * may be converted to a different version string when appropriate. 
+	 * 
+	 * URLs that do not resolve to a physical file on the file system, relative URLs, or
+	 * URLs that are outside of ProcessWire’s web root, are only eligible to receive a
+	 * common/shared version in the URL (like the core version).
+	 * 
+	 * To set a different default value for the `$useVersion` argument, you can populate
+	 * the `$config->useVersionUrls` setting in your /site/config.php with the default
+	 * value you want to substitute. 
+	 *
+	 * ~~~~~
+	 * foreach($config->versionUrls($config->styles) as $url) {
+	 *   echo "<link rel='stylesheet' href='$url' />";
+	 * }
+	 * // there is also this shortcut for the above
+	 * foreach($config->styles->urls() as $url) {
+	 *   echo "<link rel='stylesheet' href='$url' />";
+	 * }
+	 * ~~~~~
+	 *
+	 * #pw-group-URLs
+	 * #pw-group-tools
+	 *
+	 * @param array|FilenameArray|WireArray|\ArrayObject $urls Array of URLs to file assets such as JS/CSS files.
+	 * @param bool|null|string $useVersion What to use for the version string (`null` is default):
+	 *  - `true` (bool): Get version from filemtime.
+	 *  - `false` (bool): Never get file version, just use $config->version.
+	 *  - `null` (null): Auto-detect: use file version in debug mode or dev branch only, $config->version otherwise.
+	 *  - `foobar` (string): Specify any string to be the version to use on all URLs needing it.
+	 * `- ?foo=bar` (string): Optionally specify your own query string variable=value.
+	 *  - The default value (null) can be overridden by the `$config->useVersionUrls` setting. 
+	 * @return array Array of URLs updated with version strings where needed
+	 * @since 3.0.227
+	 *
+	 */
+	public function versionUrls($urls, $useVersion = null) {
+
+		$a = array();
+		$rootUrl = $this->urls->root;
+		$rootPath = $this->paths->root;
+		$coreVersionStr = "?v=$this->version";
+
+		if($useVersion === null) {
+			// if useVersion argument not specified pull from $config->useVersionUrls
+			$useVersion = $this->useVersionUrls;
+			if($useVersion === null) {
+				// if null or still not specified, auto-detect what to use
+				$useVersion = ($this->debug || ProcessWire::versionSuffix === 'dev');
+			}
+		}
+		
+		if(is_string($useVersion)) {
+			// custom version string specified 
+			if(!ctype_alnum(str_replace(array('.', '-', '_', '?', '='), '', $useVersion))) {
+				// if it fails sanitization then fallback to core version
+				$useVersion = false;
+				$versionStr = $coreVersionStr;
+			} else {
+				// use custom version str
+				$versionStr = $useVersion;
+				if(strpos($versionStr, '?') === false) $versionStr = "?v=$versionStr";
+			}
+		} else {
+			// use core version when appropriate
+			$versionStr = $coreVersionStr;
+		}
+
+		foreach($urls as $url) {
+			if(strpos($url, $coreVersionStr)) {
+				// url already has core version present in it
+				if($useVersion === false) {
+					// use as-is since this is already what's requested
+					$a[] = $url;
+					continue;
+				}
+				// remove existing core-version query string
+				list($u, $r) = explode($coreVersionStr, $url, 2);
+				if(!strlen($r)) $url = $u;
+			}
+			if(strpos($url, '?') !== false || strpos($url, '//') !== false) {
+				// leave URL with query string or scheme:// alone
+				$a[] = $url;
+			} else if($useVersion === true && strpos($url, $rootUrl) === 0) {
+				// use filemtime based version
+				$f = $rootPath . substr($url, strlen($rootUrl));
+				if(is_readable($f)) {
+					$a[] = "$url?" . base_convert((int) filemtime($f), 10, 36);
+				} else {
+					$a[] = $url . $versionStr;
+				}
+			} else {
+				// use standard or specified versino string
+				$a[] = $url . $versionStr;
+			}
+		}
+
+		return $a;
+	}
+
+	/**
+	 * Given a file asset URLs return it with cache-busting version string
+	 *
+	 * URLs that aready have query strings are left alone.
+	 *
+	 * #pw-group-URLs
+	 * #pw-group-tools
+	 *
+	 * @param string $url URL to a file asset (such as JS/CSS file)
+	 * @param bool|null|string $useVersion See versionUrls() method for description of this argument.
+	 * @return string URL updated with version strings where necessary
+	 * @since 3.0.227
+	 * @see Config::versionUrls()
+	 *
+	 */
+	public function versionUrl($url, $useVersion = null) {
+		$a = $this->versionUrls(array($url), $useVersion);
+		return isset($a[0]) ? $a[0] : $url;
+	}
+
+}

wire/core/Database.php

@@ -80,7 +80,7 @@ class Database extends \mysqli implements WireDatabase {
 
 		if($config) {
 			if($config->dbCharset) $this->set_charset($config->dbCharset); 
-				else if($config->dbSetNamesUTF8) $this->query("SET NAMES 'utf8'");
+				else if($config->get('dbSetNamesUTF8')) $this->query("SET NAMES 'utf8'");
 		}
 	}
 	
@@ -134,12 +134,12 @@ class Database extends \mysqli implements WireDatabase {
 	 *
 	 * Active in ProcessWire debug mode only
 	 *
-	 * @param ProcessWire $wire ProcessWire instance, if omitted returns queries for all instances
+	 * @param ProcessWire|null $wire ProcessWire instance, if omitted returns queries for all instances
 	 * @return array
 	 * @deprecated
 	 *
 	 */
-	static public function getQueryLog(ProcessWire $wire = null) {
+	static public function getQueryLog(?ProcessWire $wire = null) {
 		if($wire) {
 			return $wire->database->queryLog();
 		} else {

wire/core/DatabaseQuery.php

@@ -465,7 +465,7 @@ abstract class DatabaseQuery extends WireData {
 		if(is_array($value)) {
 			$curValue = array_merge($curValue, $value);
 		} else {
-			$curValue[] = trim($value, ", ");
+			$curValue[] = trim("$value", ", ");
 		}
 		
 		$this->set($method, $curValue); 
@@ -756,4 +756,3 @@ abstract class DatabaseQuery extends WireData {
 	}
 
 }
-

wire/core/DatabaseQuerySelectFulltext.php

@@ -196,7 +196,9 @@ class DatabaseQuerySelectFulltext extends Wire {
 	 * 
 	 */
 	protected function tableField() {
-		return "$this->tableName.$this->fieldName";
+		$fieldName = $this->fieldName;
+		if(!$fieldName) $fieldName = 'data';
+		return "$this->tableName.$fieldName";
 	}
 
 	/**
@@ -243,7 +245,7 @@ class DatabaseQuerySelectFulltext extends Wire {
  	 *
 	 */
 	protected function escapeLike($str) {
-		return str_replace(array('%', '_'), array('\\%', '\\_'), $str);
+		return str_replace(array('%', '_'), array('\\%', '\\_'), "$str");
 	}
 
 	/**
@@ -256,7 +258,7 @@ class DatabaseQuerySelectFulltext extends Wire {
 	 *
 	 */
 	protected function escapeAgainst($str) {
-		$str = str_replace(array('@', '+', '-', '*', '~', '<', '>', '(', ')', ':', '"', '&', '|', '=', '.'), ' ', $str);
+		$str = str_replace(array('@', '+', '-', '*', '~', '<', '>', '(', ')', ':', '"', '&', '|', '=', '.'), ' ', "$str");
 		while(strpos($str, '  ')) $str = str_replace('  ', ' ', $str);
 		return $str;
 	}
@@ -268,7 +270,7 @@ class DatabaseQuerySelectFulltext extends Wire {
 	 */
 	protected function value($value) {
 		$maxLength = self::maxQueryValueLength;
-		$value = trim($value);
+		$value = trim("$value");
 		if(strlen($value) < $maxLength && strpos($value, "\n") === false && strpos($value, "\r") === false) return $value;
 		$value = $this->sanitizer->trunc($value, $maxLength); 
 		return $value;
@@ -1267,7 +1269,7 @@ class DatabaseQuerySelectFulltext extends Wire {
 		
 		if(strpos($likeValue, "'") !== false || strpos($likeValue, "’") !== false) {
 			// match either straight or curly apostrophe
-			$likeValue = preg_replace('/[\'’]+/', '(\'|’)', $likeValue);
+			$likeValue = str_replace([ "'", "’" ], "('|’)", $likeValue);
 			// if word ends with apostrophe then apostrophe is optional
 			$likeValue = rtrim(str_replace("('|’) ", "('|’)? ", "$likeValue "));
 		}

wire/core/Debug.php

@@ -376,7 +376,7 @@ class Debug {
 			$obj = null;
 			$class = '';
 			$type = '';
-			$args = $trace['args'];
+			$args = isset($trace['args']) ? $trace['args'] : array();
 			$argStr = '';
 			$file = $trace['file'];
 			$basename = basename($file); 
@@ -451,8 +451,10 @@ class Debug {
 						$arg = '"' . $arg . '"';
 					} else if(is_bool($arg)) {
 						$arg = $arg ? 'true' : 'false';
+					} else if($arg === null) {
+						$arg = 'null';
 					} else {
-						// leave as-is
+						// leave as-is (int, float, etc.)
 					}
 					$newArgs[] = $arg;
 				}
@@ -533,7 +535,11 @@ class Debug {
 					$suffix = $options['ellipsis'];
 				}
 				foreach($value as $k => $v) {
-					$value[$k] = self::traceStr($v, $options); 
+					if(is_string($k) && strlen($k)) {
+						$value[$k] = "$$k => " . self::traceStr($v, $options);
+					} else {
+						$value[$k] = self::traceStr($v, $options);
+					}
 				}
 				$str = '[ ' . implode(', ', $value) . $suffix . ' ]';
 			}
@@ -632,6 +638,7 @@ class Debug {
 			case 'json_encode':
 				$value = json_encode($value, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
 				$value = str_replace('    ', '  ', $value);
+				if(strpos($value, '\\"') !== false) $value = str_replace('\\"', "'", $value);
 				break;
 			case 'var_export':
 				$value = var_export($value, true);

wire/core/Field.php

@@ -251,6 +251,18 @@ class Field extends WireData implements Saveable, Exportable {
 	 */
 	protected $tagList = null;
 
+	/**
+	 * Setup name to apply when field is saved 
+	 * 
+	 * Set via $field->type = 'FieldtypeName.setupName'; 
+	 * or applySetup() method
+	 * 
+	 * @var string 
+	 * @since 3.0.213
+	 * 
+	 */
+	protected $setupName = '';
+
 	/**
 	 * True if lowercase tables should be enforce, false if not (null = unset). Cached from $config
 	 *
@@ -513,7 +525,14 @@ class Field extends WireData implements Saveable, Exportable {
 
 		if($this->type) {
 			$typeData = $this->type->exportConfigData($this, $data);
-			$data = array_merge($typeData, $data); // argument order reversed per #1638
+			foreach($typeData as $key => $value) {
+				if($value === null && isset($data[$key])) {
+					// prevent null from overwriting non-null, alternative for #1638
+					unset($typeData[$key]);
+				}
+			}
+			// $data = array_merge($typeData, $data); // argument order reversed per #1638...
+			$data = array_merge($data, $typeData); // ...and later un-reversed per #1792
 		}
 
 		// remove named flags from data since the 'flags' property already covers them
@@ -680,6 +699,11 @@ class Field extends WireData implements Saveable, Exportable {
 			// good for you
 
 		} else if(is_string($type)) {
+			if(strpos($type, '.')) {
+				// FieldtypeName.setupName
+				list($type, $setupName) = explode('.', $type, 2);
+				$this->setSetupName($setupName);
+			}
 			$typeStr = $type;
 			$type = $this->wire()->fieldtypes->get($type);
 			if(!$type) {
@@ -855,7 +879,7 @@ class Field extends WireData implements Saveable, Exportable {
 	 * @return bool True if viewable, false if not
 	 * 
 	 */
-	public function ___viewable(Page $page = null, User $user = null) {
+	public function ___viewable(?Page $page = null, ?User $user = null) {
 		return $this->wire()->fields->_hasPermission($this, 'view', $page, $user);
 	}
 
@@ -869,12 +893,12 @@ class Field extends WireData implements Saveable, Exportable {
 	 * 
 	 * #pw-group-access
 	 *
-	 * @param Page|string|int|null $page Optionally specify a Page for context
-	 * @param User|string|int|null $user Optionally specify a different user (default = current user)
+	 * @param Page|null $page Optionally specify a Page for context
+	 * @param User|null $user Optionally specify a different user (default = current user)
 	 * @return bool
 	 *
 	 */
-	public function ___editable(Page $page = null, User $user = null) {
+	public function ___editable(?Page $page = null, ?User $user = null) {
 		return $this->wire()->fields->_hasPermission($this, 'edit', $page, $user);
 	}
 	
@@ -1041,7 +1065,13 @@ class Field extends WireData implements Saveable, Exportable {
 			foreach(array('showIf', 'requiredIf') as $depType) {
 				$theIf = $inputfield->getSetting($depType);
 				if(empty($theIf)) continue;
-				$inputfield->set($depType, preg_replace('/([_.|a-zA-Z0-9]+)([=!%*<>]+)/', '$1' . $contextStr . '$2', $theIf));
+				$theIf = preg_replace('/([_|a-zA-Z0-9]+)*([-._|a-zA-Z0-9]*)([=!%*<>]+)/', '$1' . $contextStr . '$2$3', $theIf);
+				if(stripos($theIf, 'forpage.') !== false) {
+					// de-contextualize if the field name starts with 'forpage.' as used by 
+					// repeaters (or others) referring to page in editor rather than item page
+					$theIf = preg_replace('/forpage\.([_.|a-z0-9]+)' . $contextStr . '([=!%*<>]+)/i', '$1$2', $theIf);
+				}
+				$inputfield->set($depType, $theIf);
 			}
 		}
 
@@ -1218,7 +1248,9 @@ class Field extends WireData implements Saveable, Exportable {
 			$table = $this->setTable;
 		} else {
 			$name = $this->settings['name'];
-			if(!strlen($name)) throw new WireException("Field 'name' is required");
+			$length = strlen($name);
+			if(!$length) throw new WireException("Field 'name' is required");
+			if($length > 58) $name = substr($name, 0, 58); // 'field_' + 58 = 64 max
 			$table = self::tablePrefix . $name;
 		}
 		if(self::$lowercaseTables) $table = strtolower($table); 
@@ -1235,6 +1267,7 @@ class Field extends WireData implements Saveable, Exportable {
 	 */
 	public function setTable($table = null) {
 		$table = empty($table) ? '' : $this->wire()->sanitizer->fieldName($table);
+		if(strlen($table) > 64) $table = substr($table, 0, 64);
 		$this->setTable = $table;
 	}
 
@@ -1546,6 +1579,18 @@ class Field extends WireData implements Saveable, Exportable {
 		return $url;
 	}
 
+	/**
+	 * Set setup name from Fieldtype to apply when field is saved 
+	 * 
+	 * @param string $setupName Setup name or omit to instead get the current value
+	 * @return string Returns current value
+	 * 
+	 */
+	public function setSetupName($setupName = null) {
+		if($setupName !== null) $this->setupName = $setupName;
+		return $this->setupName;
+	}
+
 	/**
 	 * debugInfo PHP 5.6+ magic method
 	 *
@@ -1579,4 +1624,3 @@ class Field extends WireData implements Saveable, Exportable {
 	}
 	
 }
-

wire/core/FieldSelectorInfo.php

@@ -13,7 +13,7 @@
  * This file is licensed under the MIT license
  * https://processwire.com/about/license/mit/
  *
- * ProcessWire 3.x, Copyright 2020 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  * 
  */
@@ -48,6 +48,7 @@ class FieldSelectorInfo extends Wire {
 	 * 
 	 */
 	public function __construct() {
+		parent::__construct();
 
 		$ftNops = array();
 		$ftOps = Selectors::getOperators(array(
@@ -81,7 +82,10 @@ class FieldSelectorInfo extends Wire {
 			// when input=select, page or checkbox, this contains the selectable options (value => label)
 			'options' => array(), 
 			// if field has subfields, this contains array of all above, indexed by subfield name (blank if not applicable)
-			'subfields' => array(), 
+			'subfields' => array(
+				// same as above, plus… DB column name (if different from 'name')
+				// 'col' => '',
+			), 
 		);
 
 		$this->schemaToInput = array(

wire/core/Fieldgroup.php

@@ -518,6 +518,7 @@ class Fieldgroup extends WireArray implements Saveable, Exportable, HasLookupIte
 	 *  - `namespace` (string): Additional namespace for Inputfield context. 
 	 *  - `flat` (bool): Return all Inputfields in a flattened InputfieldWrapper?
 	 *  - `populate` (bool): Populate page values to Inputfields? (default=true) since 3.0.208
+	 *  - `container` (InputfieldWrapper): The InputfieldWrapper element to add fields into, or omit for new. since 3.0.239
 	 * @param string|array $fieldName Limit to a particular fieldName(s) or field IDs (optional).
 	 *  - If specifying a single field (name or ID) and it refers to a fieldset, then all fields in that fieldset will be included. 
 	 *  - If specifying an array of field names/IDs the returned InputfieldWrapper will maintain the requested order. 
@@ -536,6 +537,7 @@ class Fieldgroup extends WireArray implements Saveable, Exportable, HasLookupIte
 				'namespace' => $namespace,
 				'flat' => $flat, 
 				'populate' => true, // populate page values?
+				'container' => null, 
 			);
 			$options = $contextStr;
 			$options = array_merge($defaults, $options);
@@ -544,11 +546,16 @@ class Fieldgroup extends WireArray implements Saveable, Exportable, HasLookupIte
 			$namespace = $options['namespace'];
 			$populate = (bool) $options['populate'];
 			$flat = $options['flat'];
+			$container = $options['container'];
 		} else {
 			$populate = true;
+			$container = null;
+		}
+	
+		if(!$container instanceof InputfieldWrapper) {
+			$container = $this->wire(new InputfieldWrapper());
 		}
 		
-		$container = $this->wire(new InputfieldWrapper());
 		$containers = array();
 		$inFieldset = false;
 		$inHiddenFieldset = false;
@@ -777,5 +784,3 @@ class Fieldgroup extends WireArray implements Saveable, Exportable, HasLookupIte
 	}
 
 }
-
-

wire/core/Fieldgroups.php

@@ -7,7 +7,7 @@
  * #pw-body For full details on all methods available in a Fieldgroup, be sure to also see the `WireArray` class.
  * #pw-var $fieldgroups
  * 
- * ProcessWire 3.x, Copyright 2022 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  *
  * @method Fieldgroup clone(Saveable $item, $name = '')
@@ -349,19 +349,46 @@ class Fieldgroups extends WireSaveableItemsLookup {
 	 *
 	 * @param Saveable $item Item to clone
 	 * @param string $name
-	 * @return bool|Saveable $item Returns the new clone on success, or false on failure
-	 * @return Saveable|Fieldgroup
+	 * @return Fieldgroup|false $item Returns the new clone on success, or false on failure
 	 *
 	 */
 	public function ___clone(Saveable $item, $name = '') {
-		return parent::___clone($item, $name);
-		// @TODO clone the field context data
-		/*
-		$id = $item->id; 
-		$item = parent::___clone($item);
-		if(!$item) return false;
-		return $item; 	
-		*/
+		if(!$item instanceof Fieldgroup) return false;
+		
+		$database = $this->wire()->database;
+		
+		/** @var Fieldgroup|false $fieldgroup */
+		$fieldgroup = parent::___clone($item, $name);
+		if(!$fieldgroup) return false;
+		
+		$sql = 
+			'SELECT fields_id, sort, data FROM fieldgroups_fields ' . 
+			'WHERE fieldgroups_id=:fieldgroups_id ' . 
+			'AND data IS NOT NULL';
+		
+		$query = $this->wire()->database->prepare($sql);
+		$query->bindValue(':fieldgroups_id', $item->id, \PDO::PARAM_INT);
+		$query->execute();
+		
+		$rows = $query->fetchAll(\PDO::FETCH_ASSOC);
+		$query->closeCursor();
+		
+		$sql = 
+			'UPDATE fieldgroups_fields SET data=:data ' . 
+			'WHERE fieldgroups_id=:fieldgroups_id ' . 
+			'AND fields_id=:fields_id AND sort=:sort';
+		
+		$query = $database->prepare($sql);
+		
+		foreach($rows as $row) {
+			$query->bindValue(':data', $row['data']); 
+			$query->bindValue(':fieldgroups_id', (int) $fieldgroup->id, \PDO::PARAM_INT);
+			$query->bindValue(':fields_id', (int) $row['fields_id'], \PDO::PARAM_INT);
+			$query->bindValue(':sort', (int) $row['sort'], \PDO::PARAM_INT);
+			$query->execute();
+		}
+		
+		return $fieldgroup;
 	}
 
 	/**
@@ -566,12 +593,12 @@ class Fieldgroups extends WireSaveableItemsLookup {
 	 * #pw-internal
 	 *
 	 * @param Field $field
-	 * @param Template $template
 	 * @param Fieldgroup $fieldgroup
+	 * @param Template|null $template
 	 * @return bool|string Returns error message string if not removeable or boolean false if it is removeable
 	 *
 	 */
-	public function isFieldNotRemoveable(Field $field, Fieldgroup $fieldgroup, Template $template = null) {
+	public function isFieldNotRemoveable(Field $field, Fieldgroup $fieldgroup, ?Template $template = null) {
 		
 		if(is_null($template)) $template = $this->wire()->templates->get($fieldgroup->name);
 
@@ -619,4 +646,3 @@ class Fieldgroups extends WireSaveableItemsLookup {
 	 */
 	public function ___fieldRemoved(Fieldgroup $fieldgroup, Field $field) { }
 }
-

wire/core/FieldgroupsArray.php

@@ -5,7 +5,7 @@
  *
  * WireArray of Fieldgroup instances as used by Fieldgroups class. 
  *
- * ProcessWire 3.x, Copyright 2016 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2024 by Ryan Cramer
  * https://processwire.com
  *
  *
@@ -25,6 +25,7 @@ class FieldgroupsArray extends WireArray {
 	 *
 	 */
 	public function getItemKey($item) {
+		/** @var Fieldgroup $item */
 		return $item->id;
 	}
 

wire/core/Fields.php

@@ -5,7 +5,7 @@
  *
  * Manages collection of ALL Field instances, not specific to any particular Fieldgroup
  * 
- * ProcessWire 3.x, Copyright 2022 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2024 by Ryan Cramer
  * https://processwire.com
  * 
  * #pw-summary Manages all custom fields in ProcessWire, independently of any Fieldgroup. 
@@ -27,6 +27,7 @@
  * @method void changeTypeReady(Saveable $item, Fieldtype $fromType, Fieldtype $toType) #pw-hooker
  * @method bool|Field clone(Field $item, $name = '') Clone a field and return it or return false on fail. 
  * @method array getTags($getFieldNames = false) Get tags for all fields (3.0.179+) #pw-advanced
+ * @method bool applySetupName(Field $field, $setupName = '')
  *
  */
 
@@ -106,6 +107,13 @@ class Fields extends WireSaveableItems {
 	 */
 	protected $flagNames = array();
 
+	/**
+	 * Flags to field IDs
+	 * 
+	 * @var array 
+	 */
+	protected $flagsToIds = array();
+
 	/**
 	 * Field names that are native/permanent to this instance of ProcessWire (configurable at runtime)
 	 * 
@@ -183,6 +191,50 @@ class Fields extends WireSaveableItems {
 		return $this->wire(new Field());
 	}
 
+	/**
+	 * Called after rows loaded from DB but before populated to this instance
+	 *
+	 * @param array $rows
+	 *
+	 */
+	protected function loadRowsReady(array &$rows) { 
+		for($flag = 1; $flag <= 256; $flag *= 2) {
+			$this->flagsToIds[$flag] = array();
+		}
+		foreach($rows as $row) {
+			$flags = (int) $row['flags'];
+			if(empty($flags)) continue;
+			foreach($this->flagsToIds as $flag => $ids) {
+				if($flags & $flag) $this->flagsToIds[$flag][] = (int) $row['id'];
+			}
+		}
+	}
+
+	/**
+	 * Given field ID return native property
+	 * 
+	 * This avoids loading the field if the property can be obtained natively. 
+	 * 
+	 * #pw-internal
+	 * 
+	 * @param int $id
+	 * @param string $property
+	 * @return array|bool|mixed|string|null
+	 * @since 3.0.243
+	 * 
+	 */
+	public function fieldIdToProperty($id, $property) {
+		$id = (int) $id;
+		if(isset($this->lazyIdIndex[$id])) {
+			$n = $this->lazyIdIndex[$id];
+			if(isset($this->lazyItems[$n][$property])) {
+				return $this->lazyItems[$n][$property];
+			}
+		}
+		$field = $this->get($id);
+		return $field ? $field->get($property) : null;
+	}
+
 	/**
 	 * Make an item and populate with given data
 	 *
@@ -249,7 +301,7 @@ class Fields extends WireSaveableItems {
 	 * @since 3.0.194
 	 *
 	 */
-	protected function initItem(array &$row, WireArray $items = null) {
+	protected function initItem(array &$row, ?WireArray $items = null) {
 		/** @var Field $item */
 		$item = parent::initItem($row, $items);
 		$fieldtype = $item ? $item->type : null;
@@ -316,7 +368,7 @@ class Fields extends WireSaveableItems {
 	 * $fields->save($field); 
 	 * ~~~~~
 	 *
-	 * @param Field|Saveable $item The field to save
+	 * @param Field $item The field to save
 	 * @return bool True on success, false on failure
 	 * @throws WireException
 	 *
@@ -336,8 +388,14 @@ class Fields extends WireSaveableItems {
 			// even if only the case has changed. 
 			$schema = $item->type->getDatabaseSchema($item);
 			if(!empty($schema)) {
-				$database->exec("RENAME TABLE `$prevTable` TO `tmp_$table`"); // QA
-				$database->exec("RENAME TABLE `tmp_$table` TO `$table`"); // QA
+				list(,$tmpTable) = explode(Field::tablePrefix, $table, 2);
+				$tmpTable = "tempf_$tmpTable";
+				foreach(array($table, $tmpTable) as $t) {
+					if(!$database->tableExists($t)) continue;
+					throw new WireException("Cannot rename to '$item->name' because table `$table` already exists");
+				}
+				$database->exec("RENAME TABLE `$prevTable` TO `$tmpTable`"); // QA
+				$database->exec("RENAME TABLE `$tmpTable` TO `$table`"); // QA
 			}
 			$item->prevTable = '';
 		}
@@ -357,9 +415,18 @@ class Fields extends WireSaveableItems {
 		}
 
 		if(!$item->type) throw new WireException("Can't save a Field that doesn't have it's 'type' property set to a Fieldtype"); 
+		$item->type->saveFieldReady($item);
 		if(!parent::___save($item)) return false;
 		if($isNew) $item->type->createField($item); 
 
+		$setupName = $item->setSetupName();
+		if($setupName || $isNew) {
+			if($this->applySetupName($item, $setupName)) {
+				$item->setSetupName('');
+				parent::___save($item);
+			}
+		}
+
 		if($item->flags & Field::flagGlobal) {
 			// make sure that all template fieldgroups contain this field and add to any that don't. 
 			foreach($this->wire()->templates as $template) {
@@ -418,7 +485,7 @@ class Fields extends WireSaveableItems {
 	 * 
 	 * This method will throw a WireException if you attempt to delete a field that is currently in use (i.e. assigned to one or more fieldgroups). 
 	 *
-	 * @param Field|Saveable $item Field to delete
+	 * @param Field $item Field to delete
 	 * @return bool True on success, false on failure
 	 * @throws WireException
 	 *
@@ -459,7 +526,7 @@ class Fields extends WireSaveableItems {
 	/**
 	 * Create and return a cloned copy of the given Field
 	 * 
-	 * @param Field|Saveable $item Field to clone
+	 * @param Field $item Field to clone
 	 * @param string $name Optionally specify name for new cloned item
 	 * @return Field $item Returns the new clone on success, or false on failure
 	 *
@@ -644,6 +711,7 @@ class Fields extends WireSaveableItems {
 			$field2->flags = 0; // intentional overwrite after above line
 		}
 		$field2->name = $field2->name . "_PWTMP";
+		$field2->prevFieldtype = $field1->type;
 		$field2->type->createField($field2); 
 		$field1->type = $field1->prevFieldtype;
 
@@ -773,7 +841,7 @@ class Fields extends WireSaveableItems {
 			// so use verbose/slow method to delete the field from pages
 			
 			$ids = $this->getNumPages($field, array('template' => $template, 'getPageIDs' => true)); 
-			$items = $this->wire('pages')->getById($ids, $template); 
+			$items = $this->wire()->pages->getById($ids, $template); 
 			
 			foreach($items as $page) {
 				try {
@@ -791,7 +859,7 @@ class Fields extends WireSaveableItems {
 			
 			// large number of pages to operate on: use fast method
 			
-			$database = $this->wire('database');
+			$database = $this->wire()->database;
 			$table = $database->escapeTable($field->getTable());
 			$sql = 	"DELETE $table FROM $table " .
 					"INNER JOIN pages ON pages.id=$table.pages_id " .
@@ -1078,6 +1146,30 @@ class Fields extends WireSaveableItems {
 		return $items;
 	}
 
+	/**
+	 * Find fields by flag
+	 * 
+	 * #pw-internal
+	 * 
+	 * @param int $flag
+	 * @param bool $getFieldNames
+	 * @return array|Field[]
+	 * @since 3.0.243
+	 * 
+	 */
+	public function findByFlag($flag, $getFieldNames = false) {
+		if(!isset($this->flagsToIds[$flag])) return array();
+		$items = [];
+		foreach($this->flagsToIds[$flag] as $id) {
+			if($getFieldNames) {
+				$items[] = $this->fieldIdToProperty($id, 'name');
+			} else {
+				$items[] = $this->get($id); 
+			}
+		}
+		return $items;
+	}
+
 	/**
 	 * Find fields by type
 	 * 
@@ -1224,7 +1316,7 @@ class Fields extends WireSaveableItems {
 	 * 
 	 * #pw-internal
 	 * 
-	 * @param Field|int|string Field to check
+	 * @param Field Field to check
 	 * @param string $permission Specify either 'view' or 'edit'
 	 * @param Page|null $page Optionally specify a page for context
 	 * @param User|null $user Optionally specify a user for context (default=current user)
@@ -1232,7 +1324,7 @@ class Fields extends WireSaveableItems {
 	 * @throws WireException if given invalid arguments
 	 *
 	 */
-	public function _hasPermission(Field $field, $permission, Page $page = null, User $user = null) {
+	public function _hasPermission(Field $field, $permission, ?Page $page = null, ?User $user = null) {
 		if($permission != 'edit' && $permission != 'view') {
 			throw new WireException('Specify either "edit" or "view"');
 		}
@@ -1270,7 +1362,7 @@ class Fields extends WireSaveableItems {
 	 * 
 	 * #pw-hooker
 	 * 
-	 * @param Field|Saveable $item
+	 * @param Field $item
 	 * @param Fieldtype $fromType
 	 * @param Fieldtype $toType
 	 * 
@@ -1282,7 +1374,7 @@ class Fields extends WireSaveableItems {
 	 * 
 	 * #pw-hooker
 	 * 
-	 * @param Field|Saveable $item
+	 * @param Field $item
 	 * @param Fieldtype $fromType
 	 * @param Fieldtype $toType
 	 * 
@@ -1420,6 +1512,41 @@ class Fields extends WireSaveableItems {
 		return $getCount ? $count : $items;
 	}
 
+	/**
+	 * Setup a new field using predefined setup name(s) from the Field’s fieldtype
+	 * 
+	 * If no setupName is provided then this method doesn’t do anything, but hooks to it might.
+	 * 
+	 * @param Field $field Newly created field
+	 * @param string $setupName Setup name to apply
+	 * @return bool True if setup was appled, false if not
+	 * @since 3.0.213
+	 * 
+	 */
+	protected function ___applySetupName(Field $field, $setupName = '') {
+		
+		$setups = $field->type->getFieldSetups();
+		$setup = isset($setups[$setupName]) ? $setups[$setupName] : null;
+		
+		if(!$setup) return false;
+		
+		$title = isset($setup['title']) ? $setup['title'] : $setupName;
+		$func = isset($setup['setup']) ? $setup['setup'] : null;
+		
+		foreach($setup as $property => $value) {
+			if($property === 'title' || $property === 'setup') continue;
+			$field->set($property, $value);
+		}
+		
+		if($func && is_callable($func)) {
+			$func($field);
+		}
+		
+		$this->message("Applied setup: $title", Notice::debug | Notice::noGroup);
+		
+		return true;
+	}
+
 	/**
 	 * Return field ID for given value (Field, field name, field ID) or 0 if none
 	 * 
@@ -1443,4 +1570,3 @@ class Fields extends WireSaveableItems {
 	}
 
 }
-

wire/core/FieldsArray.php

@@ -5,7 +5,7 @@
  * 
  * WireArray of Field instances, as used by Fields class
  *
- * ProcessWire 3.x, Copyright 2016 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  *
  */
@@ -27,7 +27,7 @@ class FieldsArray extends WireArray {
 	 * Per WireArray interface, Field keys have to be integers
 	 * 
 	 * @param int $key
-	 * @return int
+	 * @return bool
 	 *
 	 */
 	public function isValidKey($key) {
@@ -54,4 +54,4 @@ class FieldsArray extends WireArray {
 	public function makeBlankItem() {
 		return $this->wire(new Field());
 	}
-}
+}

wire/core/FieldsTableTools.php

@@ -4,7 +4,7 @@
  *
  * #pw-summary Methods for managing DB tables and indexes for fields, and related methods. Accessed from `$fields->tableTools()`.
  *
- * ProcessWire 3.x, Copyright 2020 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  * 
  * @since 3.0.150
@@ -39,8 +39,7 @@ class FieldsTableTools extends Wire {
 		$options = array_merge($defaults, $options);
 		$result = array();
 
-		/** @var WireDatabasePDO $database */
-		$database = $this->wire('database');
+		$database = $this->wire()->database;
 		$table = $database->escapeTable($field->getTable());
 		$col = $database->escapeCol($options['column']);
 		$sql = "SELECT $col, COUNT($col) FROM $table ";
@@ -107,8 +106,7 @@ class FieldsTableTools extends Wire {
 	 */
 	public function setUniqueIndex(Field $field, $add = true) { 
 
-		/** @var WireDatabasePDO $database */
-		$database = $this->wire('database');
+		$database = $this->wire()->database;
 		$col = 'data';
 		$table = $database->escapeTable($field->getTable());
 		$uniqueIndexName = $this->hasUniqueIndex($field, $col);
@@ -192,8 +190,7 @@ class FieldsTableTools extends Wire {
 	 *
 	 */
 	public function hasUniqueIndex(Field $field, $col = 'data') {
-		/** @var WireDatabasePDO $database */
-		$database = $this->wire('database');
+		$database = $this->wire()->database;
 		$table = $database->escapeTable($field->getTable());
 		$sql = "SHOW INDEX FROM $table";
 		$query = $database->prepare($sql);
@@ -222,6 +219,8 @@ class FieldsTableTools extends Wire {
 		static $checking = false;
 		if($checking) return;
 		
+		$database = $this->wire()->database;
+		
 		$col = 'data';
 
 		// is unique index requested?
@@ -232,7 +231,7 @@ class FieldsTableTools extends Wire {
 		
 		if($useUnique === $hasUnique) return;
 		
-		if(!$this->database->tableExists($field->getTable())) return;
+		if(!$database->tableExists($field->getTable())) return;
 	
 		$checking = true;
 
@@ -286,8 +285,7 @@ class FieldsTableTools extends Wire {
 	 */
 	public function deleteEmptyRows(Field $field, $col = 'data', $strict = true) {
 		
-		/** @var WireDatabasePDO $database */
-		$database = $this->wire('database');
+		$database = $this->wire()->database;
 		$table = $database->escapeTable($field->getTable());
 		$fieldtype = $field->type;
 		$schema = $fieldtype->getDatabaseSchema($field);
@@ -314,7 +312,7 @@ class FieldsTableTools extends Wire {
 		if(!in_array(trim($type), $types)) return false; // if not in allowed col types, fail
 		
 		if($col !== 'data') {
-			$col = $database->escapeCol($this->sanitizer->fieldName($col));
+			$col = $database->escapeCol($this->wire()->sanitizer->fieldName($col));
 			if(empty($col)) return false;
 		}
 
@@ -354,7 +352,7 @@ class FieldsTableTools extends Wire {
 	public function getUniqueIndexInputfield(Field $field) {
 	
 		$col = 'data';
-		$modules = $this->wire('modules'); /** @var Modules $modules */
+		$modules = $this->wire()->modules;
 		
 		if((bool) $field->flagUnique != $field->hasFlag(Field::flagUnique)) {
 			$this->checkUniqueIndex($field, true);
@@ -386,10 +384,9 @@ class FieldsTableTools extends Wire {
 	 * 
 	 */
 	public function valueExists(Field $field, $value, $col = 'data') {
-		/** @var WireDatabasePDO $database */
-		$database = $this->wire('database');
+		$database = $this->wire()->database;
 		$table = $database->escapeTable($field->getTable());
-		if($col !== 'data') $col = $database->escapeCol($this->sanitizer->fieldName($col)); 
+		if($col !== 'data') $col = $database->escapeCol($this->wire()->sanitizer->fieldName($col)); 
 		$sql = "SELECT pages_id FROM $table WHERE $col=:val LIMIT 1";
 		$query = $database->prepare($sql);
 		$query->bindValue(':val', $value); 
@@ -399,4 +396,4 @@ class FieldsTableTools extends Wire {
 		return $pageId;
 	}
 	
-}
+}

wire/core/Fieldtype.php

@@ -47,8 +47,10 @@
  * @method Field cloneField(Field $field)
  * @method void renamedField(Field $field, $prevName) 
  * @method void savedField(Field $field)
+ * @method void saveFieldReady(Field $field)
  * @method void install()
  * @method void uninstall()
+ * @method array getFieldSetups()
  * 
  * @property bool $_exportMode True when Fieldtype is exporting config data, false otherwise.  #pw-internal
  * @property string $name Name of Fieldtype module. #pw-group-other
@@ -176,6 +178,40 @@ abstract class Fieldtype extends WireData implements Module {
 		return $inputfield; 
 	}
 
+	/**
+	 * Get predefined setups for newly created fields of this type
+	 * 
+	 * ~~~~~
+	 * // Example that returns 2 setup options "foo" and "bar"
+	 * return array(
+	 *   'foo' => array(
+	 *     'title' => 'Foo', 
+	 *     'any_setting' => 'any_value',
+	 *     'setup' => function(Field $field) { 
+	 *        // optional code to setup $field when 'foo' is selected 
+	 *     }
+	 *   ),
+	 *   'bar' => array(
+	 *     'title' => 'Bar',
+	 *     'hello' => 'world', // example of any setting
+	 *     'setup' => function(Field $field) {
+	 *        // optional code to setup $field when 'bar' is selected
+	 *     }
+	 *   )
+	 * );
+	 * ~~~~~
+	 * 
+	 * #pw-internal
+	 * #pw-hooker
+	 * 
+	 * @return array
+	 * @since 3.0.213
+	 * 
+	 */
+	public function ___getFieldSetups() {
+		return array();
+	}
+
 	/**
 	 * Get any Inputfields used for configuration of this Fieldtype.
 	 *
@@ -992,8 +1028,9 @@ abstract class Fieldtype extends WireData implements Module {
 					if($a == 'CHARSET') $info['charset'] = $b;
 				}
 			}
-			if(!$info['engine']) $info['engine'] = $this->wire('config')->dbEngine;
-			if(!$info['charset']) $info['charset'] = $this->wire('config')->dbCharset;
+			$config = $this->wire()->config;
+			if(!$info['engine']) $info['engine'] = $config->dbEngine;
+			if(!$info['charset']) $info['charset'] = $config->dbCharset;
 			if($info['engine']) $info['engine'] = str_replace(array('MYISAM', 'INNODB'), array('MyISAM', 'InnoDB'), $info['engine']);
 			$info['transactions'] = $info['engine'] == 'InnoDB';
 		}
@@ -1505,6 +1542,7 @@ abstract class Fieldtype extends WireData implements Module {
 	 * Most Fieldtypes don't need to do anything here, but this exists just in case.
 	 * 
 	 * #pw-internal
+	 * #pw-hooker
 	 * 
 	 * @param Field $field
 	 * @param string $prevName Previous name (current name can be found in $field->name)
@@ -1513,12 +1551,30 @@ abstract class Fieldtype extends WireData implements Module {
 	public function ___renamedField(Field $field, $prevName) {
 	}
 
+	/**
+	 * Hook called by Fields::save() when a field is about to be saved
+	 * 
+	 * If field is a new field it will not yet have an id. 
+	 *
+	 * #pw-internal
+	 * #pw-hooker
+	 *
+	 * @param Field $field
+	 * @since 3.0.212
+	 *
+	 */
+	public function ___saveFieldReady(Field $field) {
+	}
+
 	/**
 	 * Called when Field using this Fieldtype has been saved 
 	 * 
 	 * This is primarily so that Fieldtype modules can identify when their fields are 
 	 * saved without having to add a hook to the $fields API var. 
 	 * 
+	 * #pw-internal
+	 * #pw-hooker
+	 * 
 	 * @param Field $field
 	 * @since 3.0.171
 	 * 

wire/core/FieldtypeMulti.php

@@ -866,18 +866,24 @@ abstract class FieldtypeMulti extends Fieldtype {
 	 *
 	 */
 	public function getLoadQueryAutojoin(Field $field, DatabaseQuerySelect $query) {
+		$database = $this->wire()->database;
 		if($this->get('useOrderByCols')) {
 			// autojoin is not used if sorting or pagination is active
 			$orderByCols = $field->get('orderByCols');
 			if(count($orderByCols) > 0) return null;
 		}
-		$table = $this->database->escapeTable($field->table);	
-		$schema = $this->trimDatabaseSchema($this->getDatabaseSchema($field)); 
-		$fieldName = $this->database->escapeCol($field->name); 
+		$table = $database->escapeTable($field->table);	
+		$schemaAll = $this->getDatabaseSchema($field);
+		$schema = $this->trimDatabaseSchema($schemaAll); 
+		$fieldName = $database->escapeCol($field->name); 
 		$separator = self::multiValueSeparator; 
-		if($field->distinctAutojoin) $table = "DISTINCT $table";
+		$orderBy = '';
+		if($field->distinctAutojoin) {
+			if(isset($schemaAll['sort'])) $orderBy = "ORDER BY $table.sort";
+			$table = "DISTINCT $table";
+		}
 		foreach($schema as $key => $unused) {
-			$query->select("GROUP_CONCAT($table.$key SEPARATOR '$separator') AS `{$fieldName}__$key`"); // QA
+			$query->select("GROUP_CONCAT($table.$key $orderBy SEPARATOR '$separator') AS `{$fieldName}__$key`"); // QA
 		}		
 		return $query; 
 	}
@@ -1039,5 +1045,3 @@ abstract class FieldtypeMulti extends Fieldtype {
 	}
 
 }
-
-

wire/core/Fieldtypes.php

@@ -6,7 +6,7 @@
  * #pw-summary Maintains a collection of Fieldtype modules.
  * #pw-var $fieldtypes
  * 
- * ProcessWire 3.x, Copyright 2020 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2024 by Ryan Cramer
  * https://processwire.com
  *
  * @property FieldtypeCheckbox $FieldtypeCheckbox
@@ -88,13 +88,24 @@ class Fieldtypes extends WireArray {
 	 */
 	protected $isAPI = false;
 
+	/**
+	 * Construct
+	 * 
+	 */
+	public function __construct() {
+		parent::__construct();
+		$this->usesNumericKeys = false;
+		$this->indexedByName = true;
+		$this->nameProperty = 'className';
+	}
+
 	/**
 	 * Construct the $fieldtypes API var (load all Fieldtype modules into it)
 	 *
  	 */
 	public function init() {
 		$this->isAPI = true;
-		foreach($this->wire()->modules->findByPrefix('Fieldtype', 3) as $name => $module) {
+		foreach($this->wire()->modules->findByPrefix('Fieldtype', 3) as /* $name => */ $module) {
 			$this->add($module); 
 		}
 	}
@@ -153,16 +164,6 @@ class Fieldtypes extends WireArray {
 		return $item->className();
 	}
 
-	/**
-	 * Does this WireArray use numeric keys only? 
-	 *
-	 * @return bool
-	 *
-	 */
-	protected function usesNumericKeys() {
-		return false;
-	}
-
 	/**
 	 * Per the WireArray interface, return a blank copy
 	 *
@@ -229,5 +230,3 @@ class Fieldtypes extends WireArray {
 	public function getNext($item, $strict = true) { $this->preload(); return parent::getNext($item, $strict); }
 	public function getPrev($item, $strict = true) { $this->preload(); return parent::getPrev($item, $strict); }
 }
-
-

wire/core/FileCompiler.php

@@ -1,7 +1,10 @@
 <?php namespace ProcessWire;
 
 /**
- * Class FileCompiler
+ * FileCompiler
+ * 
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
+ * https://processwire.com
  *
  * @todo determine whether we should make storage in dedicated table rather than using wire('cache').
  * @todo handle race conditions for multiple requests attempting to compile the same file(s).
@@ -127,6 +130,7 @@ class FileCompiler extends Wire {
 		if(strpos($sourcePath, '..') !== false) $sourcePath = realpath($sourcePath);
 		if(DIRECTORY_SEPARATOR != '/') $sourcePath = str_replace(DIRECTORY_SEPARATOR, '/', $sourcePath);
 		$this->sourcePath = rtrim($sourcePath, '/') . '/';
+		parent::__construct();
 	}
 
 	/**
@@ -135,8 +139,7 @@ class FileCompiler extends Wire {
 	 */
 	public function wired() {
 		
-		/** @var Config $config */
-		$config = $this->wire('config');
+		$config = $this->wire()->config;
 		$globalOptions = $config->fileCompilerOptions;
 
 		if(is_array($globalOptions)) {
@@ -172,10 +175,10 @@ class FileCompiler extends Wire {
 		if(!$this->isWired()) $this->wired();
 		
 		static $preloaded = false;
-		$config = $this->wire('config');
+		$config = $this->wire()->config;
 		
 		if(!$preloaded) {
-			$this->wire('cache')->preloadFor($this);
+			$this->wire()->cache->preloadFor($this);
 			$preloaded = true;
 		}
 		
@@ -184,6 +187,7 @@ class FileCompiler extends Wire {
 		}
 		
 		$this->addExclusion($config->paths->wire);
+		$this->addExclusion($config->paths->root . 'vendor/');
 
 		$rootPath = $config->paths->root;
 		$targetPath = $this->cachePath; 
@@ -211,7 +215,7 @@ class FileCompiler extends Wire {
 	protected function mkdir($path, $recursive = true) {
 		$chmod = $this->globalOptions['chmodDir'];
 		if(empty($chmod) || !is_string($chmod) || strlen($chmod) < 2) $chmod = null;
-		return $this->wire('files')->mkdir($path, $recursive, $chmod);
+		return $this->wire()->files->mkdir($path, $recursive, $chmod);
 	}
 
 	/**
@@ -224,7 +228,7 @@ class FileCompiler extends Wire {
 	protected function chmod($filename) {
 		$chmod = $this->globalOptions['chmodFile'];
 		if(empty($chmod) || !is_string($chmod) || strlen($chmod) < 2) $chmod = null;
-		return $this->wire('files')->chmod($filename, false, $chmod);
+		return $this->wire()->files->chmod($filename, false, $chmod);
 	}
 
 	/**
@@ -256,7 +260,7 @@ class FileCompiler extends Wire {
 		$phpClose = '?' . '>';
 		$phpBlocks = explode($phpOpen, $data);
 		
-		foreach($phpBlocks as $key => $phpBlock) {
+		foreach($phpBlocks as $phpBlock) {
 			$pos = strpos($phpBlock, $phpClose);
 			if($pos !== false) {
 				$closeBlock = substr($phpBlock, strlen($phpClose) + 2);
@@ -284,7 +288,6 @@ class FileCompiler extends Wire {
 		
 		// remove single quoted blocks
 		$this->rawDequotedPHP = preg_replace('/([\s(.=,])\'[^\']*\'/s', '$1\'string\'', $this->rawDequotedPHP);
-	
 	}	
 
 	/**
@@ -299,7 +302,7 @@ class FileCompiler extends Wire {
 		
 		if($this->globalOptions['siteOnly']) {
 			// only files in /site/ are allowed for compilation
-			if(strpos($filename, $this->wire('config')->paths->site) !== 0) {
+			if(strpos($filename, $this->wire()->config->paths->site) !== 0) {
 				// sourcePath is somewhere outside of the PW /site/, and not allowed
 				return false;
 			}
@@ -369,14 +372,14 @@ class FileCompiler extends Wire {
 			// target file already exists, check if it is up-to-date
 			// $targetData = file_get_contents($targetPathname);
 			$targetHash = md5_file($targetPathname);
-			$cache = $this->wire('cache')->getFor($this, $cacheName);
+			$cache = $this->wire()->cache->getFor($this, $cacheName);
 			if($cache && is_array($cache)) {
 				if($cache['target']['hash'] == $targetHash && $cache['source']['hash'] == $sourceHash) {
 					// target file is up-to-date 
 					$compileNow = false;
 				} else {
 					// target file changed somewhere else, needs to be re-compiled
-					$this->wire('cache')->deleteFor($this, $cacheName);	
+					$this->wire()->cache->deleteFor($this, $cacheName);	
 				}
 				if(!$compileNow && isset($cache['source']['ns'])) {
 					$this->ns = $cache['source']['ns'];
@@ -389,7 +392,7 @@ class FileCompiler extends Wire {
 			$targetPath = dirname($targetPathname);
 			$targetData = file_get_contents($sourcePathname);
 			if(stripos($targetData, 'FileCompiler=0')) return $sourcePathname; // bypass if it contains this string
-			if(strpos($targetData, 'namespace') !== false) $this->ns = $this->wire('files')->getNamespace($targetData, true);
+			if(strpos($targetData, 'namespace') !== false) $this->ns = $this->wire()->files->getNamespace($targetData, true);
 			if(!$this->ns) $this->ns = "\\";
 			if(!__NAMESPACE__ && !$this->options['modules'] && $this->ns === "\\") return $sourcePathname;
 			set_time_limit(120);
@@ -416,7 +419,7 @@ class FileCompiler extends Wire {
 						'time' => filemtime($targetPathname),
 					)
 				);
-				$this->wire('cache')->saveFor($this, $cacheName, $cacheData, WireCache::expireNever);
+				$this->wire()->cache->saveFor($this, $cacheName, $cacheData, WireCache::expireNever);
 			}
 		}
 	
@@ -427,7 +430,7 @@ class FileCompiler extends Wire {
 	
 		// show notices about compiled files, when applicable
 		if($compileNow) {
-			$message = $this->_('Compiled file:') . ' ' . str_replace($this->wire('config')->paths->root, '/', $sourcePathname);
+			$message = $this->_('Compiled file:') . ' ' . str_replace($this->wire()->config->paths->root, '/', $sourcePathname);
 			if($this->globalOptions['showNotices']) {
 				$u = $this->wire('user');
 				if($u && $u->isSuperuser()) $this->message($message);
@@ -484,7 +487,7 @@ class FileCompiler extends Wire {
 		if($this->options['modules']) {
 			// FileCompiler modules
 			$compilers = array();
-			foreach($this->wire('modules')->findByPrefix('FileCompiler', true) as $module) {
+			foreach($this->wire()->modules->findByPrefix('FileCompiler', true) as $module) {
 				if(!$module instanceof FileCompilerModule) continue;
 				$runOrder = (int) $module->get('runOrder');
 				while(isset($compilers[$runOrder])) $runOrder++;
@@ -694,7 +697,7 @@ class FileCompiler extends Wire {
 		}
 		
 		// replace absolute root path references with runtime generated versions
-		$rootPath = $this->wire('config')->paths->root; 
+		$rootPath = $this->wire()->config->paths->root; 
 		if(strpos($data, $rootPath)) {
 			$ns = __NAMESPACE__ ? "\\ProcessWire" : "";
 			$data = preg_replace('%([\'"])' . preg_quote($rootPath) . '([^\'"\s\r\n]*[\'"])%',
@@ -823,7 +826,7 @@ class FileCompiler extends Wire {
 		static $files = null;
 		if(is_null($files)) {
 			$files = array();
-			foreach(new \DirectoryIterator($this->wire('config')->paths->core) as $file) {
+			foreach(new \DirectoryIterator($this->wire()->config->paths->core) as $file) {
 				if($file->isDot() || $file->isDir()) continue;
 				$basename = $file->getBasename('.php');
 				if(strtoupper($basename[0]) == $basename[0]) {
@@ -834,12 +837,12 @@ class FileCompiler extends Wire {
 		}
 		
 		// also add in all modules
-		foreach($this->wire('modules') as $module) {
+		foreach($this->wire()->modules as $module) {
 			$name = __NAMESPACE__ ? $module->className(true) : $module->className();
 			if(!in_array($name, $classes)) $classes[] = $name;
 		}
 		$classes = array_merge($classes, $files);
-		if(!__NAMESPACE__) $classes = array_merge($classes, array_keys($this->wire('modules')->getInstallable()));
+		if(!__NAMESPACE__) $classes = array_merge($classes, array_keys($this->wire()->modules->getInstallable()));
 		
 		$rawPHP = $this->rawPHP;
 		$rawDequotedPHP = $this->rawDequotedPHP;
@@ -848,7 +851,6 @@ class FileCompiler extends Wire {
 		foreach($classes as $class) {
 			
 			if(__NAMESPACE__ && strpos($class, __NAMESPACE__ . '\\') !== 0) continue; // limit only to ProcessWire classes/interfaces
-			/** @noinspection PhpUnusedLocalVariableInspection */
 			if(strpos($class, '\\') !== false) {
 				list($ns, $class) = explode('\\', $class, 2); // reduce to just class without namespace
 			} else {
@@ -903,7 +905,6 @@ class FileCompiler extends Wire {
 				$ns = '';
 			}
 			if($ns) {}
-			/** @noinspection PhpUnusedLocalVariableInspection */
 			if(stripos($rawDequotedPHP, $function) === false) continue; // if function name not mentioned in data, quick exit
 		
 			$n = 0;
@@ -953,11 +954,12 @@ class FileCompiler extends Wire {
 	
 		// don't perform full copies of some directories
 		// @todo convert this to use the user definable exclusions list
-		if($source === $this->wire('config')->paths->site) return 0;
-		if($source === $this->wire('config')->paths->siteModules) return 0;
-		if($source === $this->wire('config')->paths->templates) return 0;
+		$config = $this->wire()->config;
+		if($source === $config->paths->site) return 0;
+		if($source === $config->paths->siteModules) return 0;
+		if($source === $config->paths->templates) return 0;
 		
-		if(!is_dir($target)) $this->wire('files')->mkdir($target, true);
+		if(!is_dir($target)) $this->wire()->files->mkdir($target, true);
 		
 		$dir = new \DirectoryIterator($source);
 		$numCopied = 0;
@@ -993,7 +995,7 @@ class FileCompiler extends Wire {
 		}
 		
 		if(!$numCopied) {
-			$this->wire('files')->rmdir($target, true);
+			$this->wire()->files->rmdir($target, true);
 		}
 		
 		return $numCopied;
@@ -1044,13 +1046,13 @@ class FileCompiler extends Wire {
 	public function clearCache($all = false) {
 		if($all) {
 			$targetPath = $this->cachePath; 
-			$this->wire('cache')->deleteFor($this);
+			$this->wire()->cache->deleteFor($this);
 		} else {
 			$this->init();
 			$targetPath = $this->targetPath;
 		}
 		if(!is_dir($targetPath)) return true;
-		return $this->wire('files')->rmdir($targetPath, true);
+		return $this->wire()->files->rmdir($targetPath, true);
 	}
 
 	/**
@@ -1089,11 +1091,14 @@ class FileCompiler extends Wire {
 	 * 
 	 */
 	protected function _maintenance($sourcePath, $targetPath) {
-
+		
+		$config = $this->wire()->config;
+		$files = $this->wire()->files;
+		
 		$sourcePath = rtrim($sourcePath, '/') . '/';
 		$targetPath = rtrim($targetPath, '/') . '/';
-		$sourceURL = str_replace($this->wire('config')->paths->root, '/', $sourcePath);
-		$targetURL = str_replace($this->wire('config')->paths->root, '/', $targetPath);
+		$sourceURL = str_replace($config->paths->root, '/', $sourcePath);
+		$targetURL = str_replace($config->paths->root, '/', $targetPath);
 		$useLog = $this->globalOptions['logNotices'];
 		
 		//$this->log("Running maintenance for $targetURL (source: $sourceURL)");
@@ -1111,7 +1116,7 @@ class FileCompiler extends Wire {
 
 			if($file->isDir()) {
 				if(!is_dir($sourceFile)) {
-					$this->wire('files')->rmdir($targetFile, true);
+					$files->rmdir($targetFile, true);
 					if($useLog) $this->log("Maintenance/Remove directory: $targetURL$basename");
 				} else {
 					$this->_maintenance($sourceFile, $targetFile);
@@ -1121,7 +1126,7 @@ class FileCompiler extends Wire {
 
 			if(!file_exists($sourceFile)) {
 				// source file has been deleted
-				$this->wire('files')->unlink($targetFile, true);
+				$files->unlink($targetFile, true);
 				if($useLog) $this->log("Maintenance/Remove target file: $targetURL$basename");
 				
 			} else if(filemtime($sourceFile) > filemtime($targetFile)) {
@@ -1198,4 +1203,3 @@ class FileCompiler extends Wire {
 	}
 
 }
-

wire/core/FileCompilerModule.php

@@ -43,6 +43,7 @@ abstract class FileCompilerModule extends WireData implements Module, Configurab
 	
 	public function __construct() {
 		$this->set('runOrder', 0);
+		parent::__construct();
 	}
 	
 	/**
@@ -60,7 +61,7 @@ abstract class FileCompilerModule extends WireData implements Module, Configurab
 	 * 2. If you only want to compile non-PHP sections of the file, implement the compileMarkup() method instead.
 	 * 
 	 * @param string $data
-	 * @return string
+	 * @return string|array
 	 * 
 	 */
 	public function compile($data) {
@@ -89,7 +90,7 @@ abstract class FileCompilerModule extends WireData implements Module, Configurab
 
 		if(!preg_match_all('!\?>(.+?)<\?!s', $data, $matches)) return array();
 
-		foreach($matches[1] as $key => $markup) {
+		foreach($matches[1] as $markup) {
 			$_markup = $this->compileMarkup($markup);
 			if($_markup !== $markup) {
 				$data = str_replace("?>$markup<?", "?>$_markup<?", $data);
@@ -154,7 +155,7 @@ abstract class FileCompilerModule extends WireData implements Module, Configurab
 	 * 
 	 */
 	public function getModuleConfigInputfields(InputfieldWrapper $inputfields) {
-		$f = $this->wire('modules')->get('InputfieldInteger');
+		$f = $inputfields->InputfieldInteger;
 		$f->attr('name', 'runOrder');
 		$f->attr('value', (int) $this->get('runOrder'));
 		$f->label = $this->_('Runtime execution order');

wire/core/FileLog.php

@@ -5,7 +5,7 @@
  *
  * Creates and maintains a text-based log file.
  * 
- * ProcessWire 3.x, Copyright 2016 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  *
  */
@@ -89,6 +89,7 @@ class FileLog extends Wire {
 	 * 
 	 */
 	public function __construct($path, $identifier = '') {
+		parent::__construct();
 		
 		if($identifier) {
 			$path = rtrim($path, '/') . '/';
@@ -98,19 +99,32 @@ class FileLog extends Wire {
 			$path = dirname($path) . '/';
 		}
 		$this->path = $path; 
-		if(!is_dir($path)) $this->wire('files')->mkdir($path);
 	}
-	
-	public function __get($key) {
-		if($key == 'delimiter') return $this->delimeter; // @todo learn how to spell
-		return parent::__get($key);
+
+	/**
+	 * Wired to API
+	 * 
+	 */
+	public function wired() {
+		parent::wired();
+		$this->path();
+	}
+
+	/**
+	 * @param string $name
+	 * @return mixed
+	 * 
+	 */
+	public function __get($name) {
+		if($name == 'delimiter') return $this->delimeter; // @todo learn how to spell
+		return parent::__get($name);
 	}
 
 	/**
 	 * Clean a string for use in a log file entry
 	 * 
 	 * @param $str
-	 * @return mixed|string
+	 * @return string
 	 * 
 	 */
 	protected function cleanStr($str) {
@@ -219,7 +233,7 @@ class FileLog extends Wire {
 		
 		// if we were creating the file, make sure it has the right permission
 		if($mode === 'w') {
-			$files = $this->wire('files'); /** @var WireFileTools $files */
+			$files = $this->wire()->files;
 			$files->chmod($this->logFilename);
 		}
 		
@@ -271,18 +285,42 @@ class FileLog extends Wire {
 		}
 	}
 
+	/**
+	 * Get filesize
+	 * 
+	 * @return int|false
+	 * 
+	 */
 	public function size() {
 		return filesize($this->logFilename); 
 	}
 
+	/**
+	 * Get file basename
+	 * 
+	 * @return string
+	 * 
+	 */
 	public function filename() {
 		return basename($this->logFilename);
 	}
 
+	/**
+	 * Get file pathname
+	 * 
+	 * @return string|bool
+	 * 
+	 */
 	public function pathname() {
 		return $this->logFilename; 
 	}
 
+	/**
+	 * Get file modification time
+	 * 
+	 * @return int|false
+	 * 
+	 */
 	public function mtime() {
 		return filemtime($this->logFilename); 
 	}
@@ -483,7 +521,7 @@ class FileLog extends Wire {
 		}
 		
 		if($options['toFile']) {
-			$toFile = $this->path . basename($options['toFile']); 
+			$toFile = $this->path() . basename($options['toFile']); 
 			$fp = fopen($toFile, 'w'); 
 			if(!$fp) throw new \Exception("Unable to open file for writing: $toFile"); 
 		} else {
@@ -536,7 +574,7 @@ class FileLog extends Wire {
 		
 		if($fp) {
 			fclose($fp);
-			$this->wire('files')->chmod($toFile); 
+			$this->wire()->files->chmod($toFile); 
 			return $cnt;
 		}
 			
@@ -553,8 +591,7 @@ class FileLog extends Wire {
 	 * @param $line
 	 * @param array $options
 	 * @param bool $stopNow Populates this with true when it can determine no more lines are necessary.
-	 * @return bool|int Returns boolean true if valid, false if not.
-	 * 	If valid as a result of a date comparison, the unix timestmap for the line is returned. 
+	 * @return bool Returns boolean true if valid, false if not.
 	 * 
 	 */
 	protected function isValidLine($line, array $options, &$stopNow) {
@@ -623,13 +660,15 @@ class FileLog extends Wire {
 
 		fclose($fpw);
 		fclose($fpr); 
+		
+		$files = $this->wire()->files;
 
 		if($cnt) {
-			$this->wire('files')->unlink($filename, true);
-			$this->wire('files')->rename("$filename.new", $filename, true);
-			$this->wire('files')->chmod($filename); 
+			$files->unlink($filename, true);
+			$files->rename("$filename.new", $filename, true);
+			$files->chmod($filename); 
 		} else {
-			$this->wire('files')->unlink("$filename.new", true);
+			$files->unlink("$filename.new", true);
 		}
 	
 		return $cnt;	
@@ -651,8 +690,9 @@ class FileLog extends Wire {
 			'dateTo' => time(),
 		));
 		if(file_exists($toFile)) {
-			$this->wire('files')->unlink($this->logFilename, true);
-			$this->wire('files')->rename($toFile, $this->logFilename, true);
+			$files = $this->wire()->files;
+			$files->unlink($this->logFilename, true);
+			$files->rename($toFile, $this->logFilename, true);
 			return $qty; 
 		}
 		return 0;
@@ -665,7 +705,7 @@ class FileLog extends Wire {
 	 * 
 	 */
 	public function delete() {
-		return $this->wire('files')->unlink($this->logFilename, true);
+		return $this->wire()->files->unlink($this->logFilename, true);
 	}
 
 	public function __toString() {
@@ -704,6 +744,16 @@ class FileLog extends Wire {
 		if($chunkSize > 0) $this->chunkSize = (int) $chunkSize;
 		return $this->chunkSize;
 	}
+
+	/**
+	 * Get path where the log is stored (with trailing slash)
+	 * @return string
+	 * 
+	 */
+	public function path() {
+		if(!is_dir($this->path)) $this->wire()->files->mkdir($this->path);
+		return $this->path;
+	}
 }
 
 

wire/core/FilenameArray.php

@@ -5,12 +5,12 @@
  *
  * Manages array of filenames or file URLs, like for $config->scripts and $config->styles.
  * 
- * ProcessWire 3.x, Copyright 2016 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  *
  */
 
-class FilenameArray implements \IteratorAggregate, \Countable {
+class FilenameArray extends Wire implements \IteratorAggregate, \Countable {
 
 	/**
 	 * Array of filenames indexed by MD5 hash of filename
@@ -87,6 +87,23 @@ class FilenameArray implements \IteratorAggregate, \Countable {
 		return new \ArrayObject($this->data); 
 	}
 
+	/**
+	 * Get cache-busting URLs for this FilenameArray
+	 * 
+	 * This is the same as iterating this FilenameArray except that it appends cache-busting
+	 * query strings to the URLs that resolve to physical files. 
+	 * 
+	 * @param bool|null|string $useVersion See Config::versionUrls() for arument details
+	 * @return array
+	 * @throws WireException
+	 * @see Config::versionUrls()
+	 * @since 3.0.227
+	 * 
+	 */
+	public function urls($useVersion = null) {
+		return $this->wire()->config->versionUrls($this, $useVersion);
+	}
+
 	/**
 	 * Make FilenameArray unique (deprecated)
 	 * 
@@ -124,6 +141,30 @@ class FilenameArray implements \IteratorAggregate, \Countable {
 		return $this; 
 	}
 
+	/**
+	 * Replace one file with another
+	 * 
+	 * @param string $oldFile
+	 * @param string $newFile
+	 * @return $this
+	 * @since 3.0.215
+	 * 
+	 */
+	public function replace($oldFile, $newFile) {
+		$key = $this->getKey($oldFile);
+		if(isset($this->data[$key])) {
+			$this->data[$key] = $newFile;
+		} else {
+			$key = array_search($oldFile, $this->data);
+			if($key !== false) {
+				$this->data[$key] = $newFile;
+			} else {
+				$this->add($newFile);
+			}
+		}
+		return $this;
+	}
+
 	/**
 	 * String value containing print_r() dump of all filenames
 	 * 

wire/core/Functions.php

@@ -37,12 +37,12 @@ function wire($name = 'wire') {
  * 
  * #pw-group-common
  * 
- * @param ProcessWire|Wire|null $wire To set specify ProcessWire instance or any Wire-derived object in it, or omit to get current instance.
+ * @param Wire|null $wire To set specify ProcessWire instance or any Wire-derived object in it, or omit to get current instance.
  * @return ProcessWire
  * @since 3.0.125
  * 
  */
-function wireInstance(Wire $wire = null) {
+function wireInstance(?Wire $wire = null) {
 	if($wire === null) return ProcessWire::getCurrentInstance();
 	if(!$wire instanceof ProcessWire) $wire = $wire->wire();
 	ProcessWire::setCurrentInstance($wire);
@@ -592,39 +592,90 @@ function wireDate($format = '', $ts = null) {
 
 /**
  * Render markup for a system icon
- * 
+ *
  * It is NOT necessary to specify an icon prefix like “fa-” with the icon name.
  * 
+ * Modifiers recognized in the class attribute:
+ * lg, fw, 2x, 3x, 4x, 5x, spin, spinner, li, border, inverse,
+ * rotate-90, rotate-180, rotate-270, flip-horizontal, flip-vertical,
+ * stack, stack-1x, stack-2x
+ * 
  * ~~~~~
  * // Outputs: "<i class='fa fa-home'></i>"
- * echo wireIconMarkup('home'); 
+ * echo wireIconMarkup('home');
+ * 
+ * // Outputs: "<i class='fa fa-home fa-fw fa-lg my-class'></i>"
+ * echo wireIconMarkup('home', 'fw lg my-class');
+ * 
+ * // Outputs "<i class='fa fa-home fa-fw' id='root-icon'></i>" (3.0.229+ only)
+ * echo wireIconMarkup('home', 'fw id=root-icon');
+ * echo wireIconMarkup('home fw id=root-icon'); // same as above
  * ~~~~~
  * 
  * #pw-group-markup
  * 
- * @param string $icon Icon name (currently a font-awesome icon name, but support for more in future)
- * @param string $class Additional attributes for class (example: "fw" for fixed width)
+ * @param string $icon Icon name (currently a font-awesome icon name)
+ * @param string $class Any of the following: 
+ *  - Additional attributes for class (example: "fw" for fixed width)
+ *  - Your own custom class(es) separated by spaces
+ *  - Any additional attributes in format `key="val" key='val' or key=val` string (3.0.229+)
+ *  - An optional trailing space to append an `&nbsp;` to the return icon markup (3.0.229+)
+ *  - Any of the above may also be specified in the $icon argument in 3.0.229+. 
  * @return string
  * 
  */
 function wireIconMarkup($icon, $class = '') {
+	static $modifiers = null;
+	$sanitizer = wire()->sanitizer;
+	$attrs = array();
+	$append = '';
+	if($modifiers === null) $modifiers = array_flip(array(
+		'lg', 'fw', '2x', '3x', '4x', '5x', 
+		'spin', 'spinner', 'li', 'border', 'inverse', 
+		'rotate-90', 'rotate-180', 'rotate-270', 
+		'flip-horizontal', 'flip-vertical', 
+		'stack', 'stack-1x', 'stack-2x', 
+	));
 	if(empty($icon)) return '';
-	if(strpos($icon, 'icon-') === 0) $icon = str_replace('icon-', 'fa-', $icon); 
-	if(strpos($icon, 'fa-') !== 0) $icon = "fa-$icon";
-	if($class) {
-		$modifiers = array(
-			'lg', 'fw', '2x', '3x', '4x', '5x', 'spin', 'spinner', 'li', 'border',
-			'rotate-90', 'rotate-180', 'rotate-270', 'flip-horizontal', 'flip-vertical',
-			'stack', 'stack-1x', 'stack-2x', 'inverse',
-		);
-		$classes = explode(' ', $class); 
-		foreach($classes as $key => $modifier) {
-			if(in_array($modifier, $modifiers)) $classes[$key] = "fa-$modifier";	
+	if(strpos($icon, ' ')) {
+		// class or extras specified in $icon rather than $class
+		list($icon, $extra) = explode(' ', $icon, 2);
+		$class = trim("$class $extra");
+	}
+	if(strpos($icon, 'icon-') === 0) {
+		list(,$icon) = explode('icon-', $icon, 2);
+		$icon = "fa-$icon";
+	} else if(strpos($icon, 'fa-') !== 0) {
+		$icon = "fa-$icon";
+	}
+	if($class !== '') {
+		$classes = array();
+		if(rtrim($class) !== $class) $append = '&nbsp;';
+		if(strpos($class, '=')) {
+			$re = '/\b([-_a-z\d]+)=("[^"]*"|\'[^\']*\'|[-_a-z\d]+)\s*/i';
+			if(preg_match_all($re, $class, $matches)) {
+				foreach($matches[1] as $key => $attrName) {
+					$attrVal = trim($matches[2][$key], "\"'");
+					$attrVal = $sanitizer->entities($attrVal);
+					$attrs[$attrName] = "$attrName='$attrVal'";
+					$class = str_replace($matches[0][$key], ' ', $class);
+				}
+				$class = trim($class);
+			}
+		}
+		if(isset($attrs['class'])) {
+			$class = trim("$class $attrs[class]"); 
+			unset($attrs['class']); 
+		}
+		foreach(explode(' ', $class) as $c) {
+			if(empty($c)) continue;
+			$classes[] = isset($modifiers[$c]) ? "fa-$c" : $c;
 		}
 		$class = implode(' ', $classes);
 	}
-	$class = trim("fa $icon $class"); 
-	return "<i class='$class'></i>";
+	$class = $sanitizer->entities(trim("fa $icon $class"));
+	$attrs['class'] = "class='$class'";
+	return "<i " . implode(' ', $attrs) . "></i>$append";
 }
 
 /**
@@ -680,7 +731,7 @@ function wireIconMarkupFile($filename, $class = '') {
 }
 
 /**
- * Given a quantity of bytes (int), return readable string that refers to quantity in bytes, kB, MB, GB, etc.
+ * Given a quantity of bytes (int), return readable string that refers to quantity in bytes, kB, MB, GB and TB
  * 
  * #pw-group-strings
  * 
@@ -690,96 +741,31 @@ function wireIconMarkupFile($filename, $class = '') {
  *  - `1` (int): Same as `true` but with space between number and unit label.
  *  - Or optionally specify the $options argument here if you do not need the $small argument. 
  * @param array|int $options Options to modify default behavior, or if an integer then `decimals` option is assumed:
- *  - `decimals` (int): Number of decimals to use in returned value (default=0).
+ *  - `decimals` (int|null): Number of decimals to use in returned value or NULL for auto (default=null).
+ *     When null (auto) a decimal value of 1 is used when appropriate, for megabytes and higher (3.0.214+). 
  *  - `decimal_point` (string|null): Decimal point character, or null to detect from locale (default=null). 
  *  - `thousands_sep` (string|null): Thousands separator, or null to detect from locale (default=null). 
  *  - `small` (bool): If no $small argument was specified, you can optionally specify it in this $options array.
- *  - `type` (string): To force return value as specific type, specify one of: bytes, kilobytes, megabytes, gigabytes; or just: b, k, m, g. (3.0.148+ only)
+ *  - `type` (string): To force return value as specific type, specify one of: bytes, kilobytes, megabytes, 
+ *     gigabytes, terabytes; or just: b, k, m, g, t. (3.0.148+ only, terabytes 3.0.214+). 
  * @return string
  * 
  */
 function wireBytesStr($bytes, $small = false, $options = array()) {
-	
-	$defaults = array(
-		'type' => '',
-		'decimals' => 0, 
-		'decimal_point' => null,
-		'thousands_sep' => null,
-	);
-
-	if(is_array($small)) {
-		$options = $small;
-		$small = isset($options['small']) ? $options['small'] : false;
-	}
-	if(!is_array($options)) $options = array('decimals' => (int) $options);
-	if(!is_int($bytes)) $bytes = (int) $bytes;
-	
-	$options = array_merge($defaults, $options);
-	$locale = array();
-	$type = empty($options['type']) ? '' : strtolower(substr($options['type'], 0, 1));
-	
-	// determine size value and units label	
-	if($bytes < 1024 || $type === 'b') {
-		$val = $bytes;
-		if($small) {
-			$label = $val > 0 ? __('B', __FILE__) : ''; // bytes
-		} else if($val == 1) {
-			$label = __('byte', __FILE__); // singular 1-byte
+	if(is_array($small)) $options = $small;
+	if(!is_array($options)) {
+		if(ctype_digit("$options")) {
+			$options = array('decimals' => (int) $options);
 		} else {
-			$label = __('bytes', __FILE__); // plural 2+ bytes (or 0 bytes)
-		}
-	} else if($bytes < 1000000 || $type === 'k') {
-		$val = $bytes / 1024;
-		$label = __('kB', __FILE__); // kilobytes
-	} else if($bytes < 1073741824 || $type === 'm') {
-		$val = $bytes / 1024 / 1024;
-		$label = __('MB', __FILE__); // megabytes
-	} else { 
-		$val = $bytes / 1024 / 1024 / 1024; 
-		$label = __('GB', __FILE__); // gigabytes
-	}
-
-	// determine decimal point if not specified in $options
-	if($options['decimal_point'] === null) {
-		if($options['decimals'] > 0) {
-			// determine decimal point from locale
-			if(empty($locale)) $locale = localeconv();
-			$options['decimal_point'] = empty($locale['decimal_point']) ? '.' : $locale['decimal_point'];
-		} else {
-			// no decimal point needed (not used)
-			$options['decimal_point'] = '.';
+			$options = array();
 		}
 	}
-
-	// determine thousands separator if not specified in $options
-	if($options['thousands_sep'] === null) {
-		if($small || $val < 1000) {
-			// no thousands separator needed
-			$options['thousands_sep'] = '';
-		} else {
-			// get thousands separator from current locale
-			if(empty($locale)) $locale = localeconv();
-			$options['thousands_sep'] = empty($locale['thousands_sep']) ? '' : $locale['thousands_sep'];
-		}
+	if(is_int($small) && !isset($options['decimals'])) {
+		$options['decimals'] = $small;
+	} else if(is_bool($small)) {
+		$options['small'] = $small;
 	}
-
-	// format number to string
-	$str = number_format($val, $options['decimals'], $options['decimal_point'], $options['thousands_sep']);
-
-	// in small mode remove numbers with decimals that consist only of zeros "0"
-	if($small && $options['decimals'] > 0) {
-		$test = substr($str, -1 * $options['decimals']);
-		if(((int) $test) === 0) {
-			$str = substr($str, 0, strlen($str) - ($options['decimals'] + 1)); // i.e. 123.00 => 123
-		} else {
-			$str = rtrim($str, '0'); // i.e. 123.10 => 123.1
-		}
-	}
-
-	// append units label to number
-	$str .= ($small === true ? '' : ' ') . $label;
-	
-	return $str;
+	return wire()->sanitizer->getNumberTools()->bytesToStr($bytes, $options);
 }
 
 /**
@@ -1158,7 +1144,7 @@ function wireInstanceOf($instance, $className, $autoload = true) {
  * @param string|callable $var
  * @param bool $syntaxOnly
  * @var string $callableName
- * @return array
+ * @return bool
  *
  */
 function wireIsCallable($var, $syntaxOnly = false, &$callableName = '') {
@@ -1184,7 +1170,7 @@ function wireIsCallable($var, $syntaxOnly = false, &$callableName = '') {
 function wireCount($value) {
 	if($value === null) return 0; 
 	if(is_array($value)) return count($value); 
-	if(is_object($value) && $value instanceof \Countable) return count($value);
+	if($value instanceof \Countable) return count($value);
 	return 1;
 }
 
@@ -1457,5 +1443,3 @@ function PageArray($items = array()) {
 	$pa = PageArray::newInstance($items);
 	return $pa;
 }
-
-

wire/core/FunctionsAPI.php

@@ -100,6 +100,23 @@ function page($key = '', $value = null) {
 	return wirePage($key, $value);
 }
 
+/**
+ * Return id for given page or false if it’s not a page
+ *
+ * Returns positive int (page id) for page that exists, 0 for NullPage,
+ * or false if given $value is not a Page.
+ * 
+ * #pw-group-Functions-API
+ *
+ * @param Page|mixed $value
+ * @return int|false
+ * @since 3.0.224
+ *
+ */
+function pageId($value) {
+	return wirePageId($value);
+}
+
 /**
  * Access a ProcessWire configuration setting ($config API variable as a function)
  * 
@@ -680,4 +697,3 @@ function region($key = '', $value = null) {
 function setting($name = '', $value = null) {
 	return wireSetting($name, $value);
 }
-

wire/core/FunctionsWireAPI.php

@@ -132,6 +132,21 @@ function wirePage($key = '', $value = null) {
 	return _wireDataAPI('page', $key, $value);
 }
 
+/**
+ * Return id for given page or false if it’s not a page
+ * 
+ * Returns positive int (page id) for page that exists, 0 for NullPage,
+ * or false if given $value is not a Page.
+ * 
+ * @param Page|mixed $value
+ * @return int|false
+ * @since 3.0.224
+ * 
+ */
+function wirePageId($value) {
+	return ($value instanceof Page ? $value->id : false);
+}
+
 /**
  * Access the $config API variable as a function
  *
@@ -166,9 +181,11 @@ function wireConfig($key = '', $value = null) {
  *
  */
 function wireModules($name = '') {
-	/** @var Modules $modules */
-	$modules = wire('modules');
-	return strlen($name) ? $modules->getModule($name) : $modules;
+	$name = (string) $name;
+	$modules = wire()->modules;
+	/** @var Modules|Module|ConfigurableModule|null $value */
+	$value = strlen($name) ? $modules->getModule($name) : $modules;
+	return $value;
 }
 
 /**
@@ -189,12 +206,14 @@ function wireUser($key = '', $value = null) {
  * See the pages() function for full usage details.
  *
  * @param string|array $selector Optional selector to send to find() or get()
- * @return Users|PageArray|User|mixed
+ * @return Users|PageArray|User|NullPage|mixed
  * @see pages()
  *
  */
 function wireUsers($selector = '') {
-	return _wirePagesAPI('users', $selector);
+	/** @var Users|PageArray|User|NullPage|mixed $value */
+	$value = _wirePagesAPI('users', $selector);
+	return $value;
 }
 
 /**
@@ -217,8 +236,7 @@ function wireSession($key = '', $value = null) {
  *
  */
 function wireFields($name = '') {
-	/** @var Fields $fields */
-	$fields = wire('fields');
+	$fields = wire()->fields;
 	return strlen($name) ? $fields->get($name) : $fields;
 }
 
@@ -230,8 +248,7 @@ function wireFields($name = '') {
  *
  */
 function wireTemplates($name = '') {
-	/** @var Templates $templates */
-	$templates = wire('templates');
+	$templates = wire()->templates;
 	return strlen($name) ? $templates->get($name) : $templates;
 }
 
@@ -242,7 +259,7 @@ function wireTemplates($name = '') {
  *
  */
 function wireDatabase() {
-	return wire('database');
+	return wire()->database;
 }
 
 /**
@@ -255,7 +272,9 @@ function wireDatabase() {
  *
  */
 function wirePermissions($selector = '') {
-	return _wirePagesAPI('permissions', $selector);
+	/** @var Permissions|Permission|PageArray|null|NullPage $value */
+	$value = _wirePagesAPI('permissions', $selector);
+	return $value;
 }
 
 /**
@@ -268,7 +287,9 @@ function wirePermissions($selector = '') {
  *
  */
 function wireRoles($selector = '') {
-	return _wirePagesAPI('roles', $selector);
+	/** @var Roles|Role|PageArray|null|NullPage $value */
+	$value = _wirePagesAPI('roles', $selector);
+	return $value;
 }
 
 /**
@@ -286,7 +307,8 @@ function wireRoles($selector = '') {
  *
  */
 function wireSanitizer($name = '', $value = '') {
-	$sanitizer = wire('sanitizer');
+	$name = (string) $name;
+	$sanitizer = wire()->sanitizer;
 	return strlen($name) ? $sanitizer->$name($value) : $sanitizer;
 }
 
@@ -306,8 +328,7 @@ function wireSanitizer($name = '', $value = '') {
  *
  */
 function wireDatetime($format = '', $value = '') {
-	/** @var WireDateTime $datetime */
-	$datetime = wire('datetime');
+	$datetime = wire()->datetime;
 	return strlen($format) ? $datetime->formatDate($value ? $value : time(), $format) : $datetime;
 }
 
@@ -318,7 +339,7 @@ function wireDatetime($format = '', $value = '') {
  *
  */
 function wireFiles() {
-	return wire('files');
+	return wire()->files;
 }
 
 /**
@@ -335,9 +356,7 @@ function wireFiles() {
  *
  */
 function wireCache($name = '', $expire = null, $func = null) {
-	/** @var WireCache $cache */
-	$cache = wire('cache');
-	return strlen($name) ? $cache->get($name, $expire, $func) : $cache;
+	return strlen($name) ? wire()->cache->get($name, $expire, $func) : wire()->cache;
 }
 
 /**
@@ -357,8 +376,7 @@ function wireCache($name = '', $expire = null, $func = null) {
  *
  */
 function wireLanguages($name = '') {
-	/** @var Languages $languages */
-	$languages = wire('languages');
+	$languages = wire()->languages;
 	if(!$languages) return null;
 	if(strlen($name)) return $languages->get($name);
 	return $languages;
@@ -392,8 +410,7 @@ function wireLanguages($name = '') {
  *
  */
 function wireInput($type = '', $key = '', $sanitizer = null, $fallback = null) {
-	/** @var WireInput $input */
-	$input = wire('input');
+	$input = wire()->input;
 	if(!strlen($type)) return $input;
 	$type = strtolower($type);
 	if(!strlen($key)) return $input->$type;
@@ -458,8 +475,7 @@ function wireInputCookie($key = '', $sanitizer = null, $fallback = null) {
  * 
  */
 function wireLog($logName = '', $message = '') {
-	/** @var WireLog $log */
-	$log = wire('log');
+	$log = wire()->log;
 	if(strlen($message)) {
 		if(!strlen($logName)) $logName = 'unknown';
 		return $log->save($logName, $message);
@@ -477,13 +493,14 @@ function wireLog($logName = '', $message = '') {
  *
  */
 function wireProfiler($name = null, $source = null, $data = array()) {
-	$profiler = wire('profiler');
+	$profiler = wire()->profiler;
 	if(is_null($name)) return $profiler;
 	if(!$profiler) return null;
 	if(is_string($name)) {
 		return $profiler->start($name, $source, $data);
 	} else {
-		return $profiler->stop($name);
+		$profiler->stop($name);
+		return null;
 	}
 }
 
@@ -495,8 +512,8 @@ function wireProfiler($name = null, $source = null, $data = array()) {
  * 
  */
 function wireUrls($key = '') {
-	if(empty($key)) return wire('config')->urls;
-	return wire('config')->urls($key);
+	if(empty($key)) return wire()->config->urls;
+	return wire()->config->urls($key);
 }
 
 /**
@@ -507,8 +524,8 @@ function wireUrls($key = '') {
  *
  */
 function wirePaths($key = '') {
-	if(empty($key)) return wire('config')->paths;
-	return wire('config')->paths($key);
+	if(empty($key)) return wire()->config->paths;
+	return wire()->config->paths($key);
 }
 
 /**
@@ -594,4 +611,3 @@ function _wireFunctionsAPI() {
 	);
 	return $names;
 }
-

wire/core/HookEvent.php

@@ -3,7 +3,7 @@
 /**
  * ProcessWire HookEvent
  *
- * ProcessWire 3.x, Copyright 2016 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  * 
  * Instances of HookEvent are passed to Hook handlers when their requested method has been called.
@@ -60,6 +60,7 @@ class HookEvent extends WireData {
 		);
 		if(!empty($eventData)) $data = array_merge($data, $eventData);
 		$this->data = $data;
+		parent::__construct();
 	}
 
 	/**
@@ -130,7 +131,6 @@ class HookEvent extends WireData {
 			return array_key_exists($key, $arguments) ? $arguments[$key] : null;
 		}
 
-		$value = null;
 		$argumentsByName = array();
 
 		foreach($names as $key => $name) {
@@ -161,8 +161,9 @@ class HookEvent extends WireData {
 		if(is_string($n) && !ctype_digit($n)) {
 			// convert argument name to position
 			$names = $this->getArgumentNames();	
-			$n = array_search($n, $names); 
-			if($n === false) throw new WireException("Unknown argument name: $n"); 
+			$name = $n;
+			$n = array_search($name, $names); 
+			if($n === false) throw new WireException("Unknown argument name: $name"); 
 		}
 
 		$this->data['arguments'][(int)$n] = $value;

wire/core/ImageSizer.php

@@ -95,6 +95,7 @@ class ImageSizer extends Wire {
 	 *
 	 */
 	public function __construct($filename = '', $options = array()) {
+		parent::__construct();
 		if(!empty($options)) $this->setOptions($options); 
 		if(!empty($filename)) $this->setFilename($filename);
 	}
@@ -114,7 +115,7 @@ class ImageSizer extends Wire {
 		
 		self::$knownEngines = array();
 		
-		$modules = $this->wire('modules');
+		$modules = $this->wire()->modules;
 		$engines = $modules->findByPrefix('ImageSizerEngine');
 		$numEngines = count($engines);
 		
@@ -228,7 +229,6 @@ class ImageSizer extends Wire {
 			$e = $this->getEngine($engineName);
 			if(!$e) continue;
 			
-			/** @var ImageSizerEngine $e */
 			$e->prepare($filename, $options, $inspectionResult);	
 			$supported = $e->supported();
 			
@@ -430,7 +430,7 @@ class ImageSizer extends Wire {
 				$engineClass = __NAMESPACE__ . "\\$engineName";
 				$engine = $this->wire(new $engineClass());
 			} else {
-				$engine = $this->wire('modules')->get($engineName);
+				$engine = $this->wire()->modules->get($engineName);
 			}
 			return $engine;
 		}
@@ -452,7 +452,7 @@ class ImageSizer extends Wire {
 		return $this->engine;
 	}
 	
-	public function __get($key) { return $this->getEngine()->__get($key); }
+	public function __get($name) { return $this->getEngine()->__get($name); }
 
 	/**
 	 * ImageInformation from Image Inspector in short form or full RawInfoData
@@ -607,7 +607,7 @@ class ImageSizer extends Wire {
 		$count = 0;
 		while(!feof($fh) && $count < 2) {
 			$chunk = fread($fh, 1024 * 100); //read 100kb at a time
-			$count += preg_match_all('#\x00\x21\xF9\x04.{4}\x00[\x2C\x21]#s', $chunk, $matches);
+			$count += preg_match_all('#\x00\x21\xF9\x04.{4}\x00[\x2C\x21]#s', $chunk);
 		}
 		fclose($fh);
 		return $count > 1;
@@ -618,7 +618,7 @@ class ImageSizer extends Wire {
 	 *
 	 * @param mixed $image Pageimage or filename
 	 *
-	 * @return mixed|null|bool
+	 * @return null|bool
 	 *
 	 */
 	static public function imageResetIPTC($image) {

wire/core/ImageSizerEngine.php

@@ -399,7 +399,7 @@ abstract class ImageSizerEngine extends WireData implements Module, Configurable
 		$this->inspectionResult = $inspectionResult;
 
 		// filling all options with global custom values from config.php
-		$options = array_merge($this->wire('config')->imageSizerOptions, $options);
+		$options = array_merge($this->wire()->config->imageSizerOptions, $options);
 		$this->setOptions($options);
 		$this->loadImageInfo($filename, false);
 	}
@@ -521,7 +521,7 @@ abstract class ImageSizerEngine extends WireData implements Module, Configurable
 		if(is_callable("$className::getModuleInfo")) {
 			$moduleInfo = $className::getModuleInfo();
 		} else {
-			$moduleInfo = $this->wire('modules')->getModuleInfoVerbose($className);
+			$moduleInfo = $this->wire()->modules->getModuleInfoVerbose($className);
 		}
 
 		if(!is_array($moduleInfo)) $moduleInfo = array();
@@ -635,7 +635,7 @@ abstract class ImageSizerEngine extends WireData implements Module, Configurable
 	 *
 	 */
 	public function writeBackIPTC($filename, $includeCustomTags = false) {
-		if($this->wire('config')->debug) {
+		if($this->wire()->config->debug) {
 			// add a timestamp and the name of the image sizer engine to the IPTC tag number 217
 			$entry = $this->className() . '-' . date('Ymd:His');
 			if(!$this->iptcRaw) $this->iptcRaw = array();
@@ -648,9 +648,10 @@ abstract class ImageSizerEngine extends WireData implements Module, Configurable
 		$dest = preg_replace('/\.' . $extension . '$/', '_tmp.' . $extension, $filename);
 		if(strlen($content) == @file_put_contents($dest, $content, \LOCK_EX)) {
 			// on success we replace the file
-			$this->wire('files')->unlink($filename);
-			$this->wire('files')->rename($dest, $filename);
-			$this->wire('files')->chmod($filename);
+			$files = $this->wire()->files;
+			$files->unlink($filename);
+			$files->rename($dest, $filename);
+			$files->chmod($filename);
 			return true;
 		} else {
 			// it was created a temp diskfile but not with all data in it
@@ -1460,7 +1461,7 @@ abstract class ImageSizerEngine extends WireData implements Module, Configurable
 	/**
 	 * Return the image type constant
 	 *
-	 * @return string
+	 * @return string|null
 	 *
 	 */
 	public function getImageType() {
@@ -1730,15 +1731,17 @@ abstract class ImageSizerEngine extends WireData implements Module, Configurable
 			$this->finalWidth, $this->finalHeight)) {
 			return false; // fallback or failed
 		}
+		
+		$files = $this->wire()->files;
 
 		if($this->webpOnly) {
-			$this->wire('files')->unlink($this->tmpFile);
+			$files->unlink($this->tmpFile);
 		} else {
 			// all went well, copy back the temp file,
 			if(!@copy($this->tmpFile, $this->filename)) return false; // fallback or failed 
-			$this->wire('files')->chmod($this->filename);
+			$files->chmod($this->filename);
 			// remove the temp file
-			$this->wire('files')->unlink($this->tmpFile);
+			$files->unlink($this->tmpFile);
 			// post processing: IPTC, setModified and reload ImageInfo
 			$this->writeBackIPTC($this->filename, false);
 		}
@@ -1758,6 +1761,7 @@ abstract class ImageSizerEngine extends WireData implements Module, Configurable
 	 */
 	public function rotate($degrees, $dstFilename = '') {
 
+		$files = $this->wire()->files;
 		$degrees = (int) $degrees;
 		$srcFilename = $this->filename;
 		
@@ -1767,7 +1771,7 @@ abstract class ImageSizerEngine extends WireData implements Module, Configurable
 		if($degrees < -360) $degrees = $degrees - 360;
 
 		if($degrees == 0 || $degrees == 360 || $degrees == -360) {
-			if($dstFilename != $this->filename) wireCopy($this->filename, $dstFilename);
+			if($dstFilename != $this->filename) $files->copy($this->filename, $dstFilename);
 			return true;
 		}
 
@@ -1787,13 +1791,13 @@ abstract class ImageSizerEngine extends WireData implements Module, Configurable
 		if($result) {
 			// success
 			if($tmpFilename != $dstFilename) {
-				if(is_file($dstFilename)) $this->wire('files')->unlink($dstFilename);
-				$this->wire('files')->rename($tmpFilename, $dstFilename);
+				if(is_file($dstFilename)) $files->unlink($dstFilename);
+				$files->rename($tmpFilename, $dstFilename);
 			}
-			$this->wire('files')->chmod($dstFilename);
+			$files->chmod($dstFilename);
 		} else {
 			// fail
-			if(is_file($tmpFilename)) $this->wire('files')->unlink($tmpFilename);	
+			if(is_file($tmpFilename)) $files->unlink($tmpFilename);	
 		}
 		
 		return $result;
@@ -2076,7 +2080,7 @@ abstract class ImageSizerEngine extends WireData implements Module, Configurable
 	 */
 	public function getModuleConfigInputfields(InputfieldWrapper $inputfields) {
 		
-		$f = $this->wire('modules')->get('InputfieldInteger');
+		$f = $inputfields->InputfieldInteger;
 		$f->attr('name', 'enginePriority');
 		$f->label = $this->_('Engine priority');
 		$f->description = $this->_('This determines what order this engine is tried in relation to other ImageSizerEngine modules.');
@@ -2086,7 +2090,7 @@ abstract class ImageSizerEngine extends WireData implements Module, Configurable
 		$f->icon = 'sort-numeric-asc';
 		$inputfields->add($f);
 		
-		$f = $this->wire('modules')->get('InputfieldRadios');
+		$f = $inputfields->InputfieldRadios;
 		$f->attr('name', 'sharpening'); 
 		$f->label = $this->_('Sharpening');
 		$f->addOption('none', $this->_('None'));
@@ -2098,7 +2102,7 @@ abstract class ImageSizerEngine extends WireData implements Module, Configurable
 		$f->icon = 'image';
 		$inputfields->add($f);
 
-		$f = $this->wire('modules')->get('InputfieldInteger');
+		$f = $inputfields->InputfieldInteger;
 		$f->attr('name', 'quality');
 		$f->label = $this->_('Quality');
 		$f->description = $this->_('Default quality setting from 1 to 100 where 1 is lowest quality, and 100 is highest.');

wire/core/ImageSizerEngineGD.php

@@ -377,7 +377,7 @@ class ImageSizerEngineGD extends ImageSizerEngine {
 		}
 
 		// write to file(s)
-		if(file_exists($dstFilename)) $this->wire('files')->unlink($dstFilename);
+		if(file_exists($dstFilename)) $this->wire()->files->unlink($dstFilename);
 		
 		$result = null; // null=not yet known
 		
@@ -457,7 +457,7 @@ class ImageSizerEngineGD extends ImageSizerEngine {
 		if(!function_exists('imagewebp')) return false;
 		$path_parts = pathinfo($filename);
 		$webpFilename = $path_parts['dirname'] . '/' . $path_parts['filename'] . '.webp';
-		if(file_exists($webpFilename)) $this->wire('files')->unlink($webpFilename);
+		if(file_exists($webpFilename)) $this->wire()->files->unlink($webpFilename);
 		return imagewebp($im, $webpFilename, $quality);
 	}
 	

wire/core/Inputfield.php

@@ -3,7 +3,7 @@
 /**
  * ProcessWire Inputfield - base class for Inputfield modules.
  * 
- * ProcessWire 3.x, Copyright 2021 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2024 by Ryan Cramer
  * https://processwire.com
  *
  * An Inputfield for an actual form input field widget, and this is provided as the base class
@@ -62,6 +62,7 @@
  * @property string $tabLabel Label for tab if Inputfield rendered in its own tab via Inputfield::collapsedTab* setting. @since 3.0.201 #pw-group-labels
  * @property string|null $prependMarkup Optional markup to prepend to the Inputfield content container. #pw-group-other
  * @property string|null $appendMarkup Optional markup to append to the Inputfield content container. #pw-group-other
+ * @property string|null $footerMarkup Optional markup to add to the '.Inputfield' container, after '.InputfieldContent'. @since 3.0.241 #pw-advanced
  * 
  * @method string|Inputfield label($label = null) Get or set the 'label' property via method. @since 3.0.110 #pw-group-labels
  * @method string|Inputfield description($description = null) Get or set the 'description' property via method. @since 3.0.110  #pw-group-labels
@@ -102,16 +103,16 @@
  * @property null|bool|Fieldtype $hasFieldtype The Fieldtype using this Inputfield, or boolean false when known not to have a Fieldtype, or null when not known. #pw-group-other
  * @property null|Field $hasField The Field object associated with this Inputfield, or null when not applicable or not known. #pw-group-other
  * @property null|Page $hasPage The Page object associated with this Inputfield, or null when not applicable or not known. #pw-group-other
- * @property null|Inputfield $hasInputfield If this Inputfield is owned/managed by another (other than parent/child relationship), it may be set here. 3.0.176+ #pw-group-other 
- * @property bool|null $useLanguages When multi-language support active, can be set to true to make it provide inputs for each language, where supported (default=false). #pw-group-behavior
+ * @property null|Inputfield $hasInputfield If this Inputfield is owned/managed by another (other than parent/child relationship), it may be set here. @since 3.0.176 #pw-group-other 
+ * @property bool|null $useLanguages When multi-language support active, can be set to true to make it provide inputs for each language, where supported (default=false). #pw-group-behavior #pw-group-languages
  * @property null|bool|int $entityEncodeLabel Set to boolean false to specifically disable entity encoding of field header/label (default=true). #pw-group-output
  * @property null|bool $entityEncodeText Set to boolean false to specifically disable entity encoding for other text: description, notes, etc. (default=true). #pw-group-output
- * @property int $renderFlags Options that can be applied to render, see "render*" constants (default=0). #pw-group-output 3.0.204+
+ * @property int $renderFlags Options that can be applied to render, see "render*" constants (default=0). @since 3.0.204 #pw-group-output 
  * @property int $renderValueFlags Options that can be applied to renderValue mode, see "renderValue" constants (default=0). #pw-group-output
  * @property string $wrapClass Optional class name (CSS) to apply to the HTML element wrapping the Inputfield. #pw-group-other
  * @property string $headerClass Optional class name (CSS) to apply to the InputfieldHeader element #pw-group-other
  * @property string $contentClass Optional class name (CSS) to apply to the InputfieldContent element #pw-group-other
- * @property string $addClass Formatted class string letting you add class to any of the above (see addClass method). #pw-group-other 3.0.204+
+ * @property string $addClass Formatted class string letting you add class to any of the above (see addClass method). @since 3.0.204 #pw-group-other 
  * @property int|null $textFormat Text format to use for description/notes text in Inputfield (see textFormat constants) #pw-group-output
  * 
  * @method string|Inputfield required($required = null) Get or set required state. @since 3.0.110 #pw-group-behavior
@@ -121,7 +122,11 @@
  * @method string|Inputfield headerClass($class = null) Get header class attribute or add a class to it. @since 3.0.110 #pw-group-other
  * @method string|Inputfield contentClass($class = null) Get content class attribute or add a class to it. @since 3.0.110 #pw-group-other
  * 
- *
+ * MULTI-LANGUAGE METHODS (requires LanguageSupport module to be installed)
+ * ======================
+ * @method void setLanguageValue($language, $value) Set language value for Inputfield that supports it. Requires LanguageSupport module. $language can be Language, id (int) or name (string). @since 3.0.238 #pw-group-languages 
+ * @method string|mixed getLanguageValue($language) Get language value for Inputfield that supports it. Requires LanguageSupport module. $language can be Language, id (int) or name (string). @since 3.0.238  #pw-group-languages 
+ * 
  * HOOKABLE METHODS
  * ================
  * @method string render()
@@ -393,6 +398,14 @@ abstract class Inputfield extends WireData implements Module {
 	 */
 	protected $editable = true;
 
+	/**
+	 * Header icon definitions
+	 * 
+	 * @var array 
+	 * 
+	 */
+	protected $headerActions = array();
+
 	/**
 	 * Construct the Inputfield, setting defaults for all properties
 	 *
@@ -421,8 +434,9 @@ abstract class Inputfield extends WireData implements Module {
 		$this->set('textFormat', self::textFormatBasic); // format applied to description and notes
 		$this->set('renderFlags', 0);  // See render* constants
 		$this->set('renderValueFlags', 0); // see renderValue* constants, applicable to renderValue mode only
-		$this->set('prependMarkup', ''); // markup to prepend to Inputfield output
-		$this->set('appendMarkup', ''); // markup to append to Inputfield output
+		$this->set('prependMarkup', ''); // markup to prepend to InputfieldContent output
+		$this->set('appendMarkup', ''); // markup to append to InputfieldContent output
+		$this->set('footerMarkup', ''); // markup to add to end of Inputfield output
 
 		// default ID attribute if no 'id' attribute set
 		$this->defaultID = $this->className() . self::$numInstances; 
@@ -1356,11 +1370,11 @@ abstract class Inputfield extends WireData implements Module {
 	 * 
 	 * #pw-internal
 	 *
-	 * @param array $attributes Associative array of attributes to build the string from, or omit to use this Inputfield's attributes.
+	 * @param array|null $attributes Associative array of attributes to build the string from, or omit to use this Inputfield's attributes.
 	 * @return string
 	 *
 	 */
-	public function getAttributesString(array $attributes = null) {
+	public function getAttributesString(?array $attributes = null) {
 
 		$str = '';
 
@@ -1392,7 +1406,7 @@ abstract class Inputfield extends WireData implements Module {
 				continue;
 			}
 
-			$str .= "$attr=\"" . htmlspecialchars($value, ENT_QUOTES, "UTF-8") . '" ';
+			$str .= "$attr=\"" . htmlspecialchars("$value", ENT_QUOTES, "UTF-8") . '" ';
 		}
 
 		return trim($str); 
@@ -1449,13 +1463,17 @@ abstract class Inputfield extends WireData implements Module {
 	 * 
 	 * #pw-group-output
 	 * 
-	 * @param Inputfield|InputfieldWrapper|null The parent InputfieldWrapper that is rendering it, or null if no parent.
+	 * @param Inputfield|null The parent InputfieldWrapper that is rendering it, or null if no parent.
 	 * @param bool $renderValueMode Specify true only if this is for `Inputfield::renderValue()` rather than `Inputfield::render()`. 
 	 * @return bool True if assets were just added, false if already added. 
 	 *
 	 */
-	public function renderReady(Inputfield $parent = null, $renderValueMode = false) {
-		$result = $this->wire()->modules->loadModuleFileAssets($this) > 0;
+	public function renderReady(?Inputfield $parent = null, $renderValueMode = false) {
+		if($this->className() === 'InputfieldWrapper') {
+			$result = false;
+		} else {
+			$result = $this->wire()->modules->loadModuleFileAssets($this) > 0;
+		}
 		if($this->wire()->hooks->isMethodHooked($this, 'renderReadyHook')) {
 			$this->renderReadyHook($parent, $renderValueMode);
 		}
@@ -1467,11 +1485,11 @@ abstract class Inputfield extends WireData implements Module {
 	 * 
 	 * Hook this method instead if you want to hook renderReady().
 	 * 
-	 * @param Inputfield $parent
+	 * @param Inputfield|null $parent
 	 * @param bool $renderValueMode
 	 * 
 	 */
-	public function ___renderReadyHook(Inputfield $parent = null, $renderValueMode = false) { }
+	public function ___renderReadyHook(?Inputfield $parent = null, $renderValueMode = false) { }
 
 	/**
 	 * This hook was replaced by renderReady
@@ -2077,6 +2095,86 @@ abstract class Inputfield extends WireData implements Module {
 		return $this->editable;
 	}
 
+	/**
+	 * Add header action
+	 *
+	 * This adds a clickable icon to the right side of the Inputfield header.
+	 * There are three types of actions: 'click', 'toggle' and 'link'. The 'click' 
+	 * action simply triggers your JS event whenever it is clicked. The 'toggle' action
+	 * has an on/off state, and you can specify the JS event to trigger for each. 
+	 * This function will automatically figure out whether you want a `click`,
+	 * `toggle` or 'link' action based on what you provide in the $settings argument.
+	 * Below is a summary of these settings:
+	 * 
+	 * Settings for 'click' or 'link' type actions
+	 * -------------------------------------------
+	 * - `icon` (string): Name of font-awesome icon to use.
+	 * - `tooltip` (string): Optional tooltip text to display when icon hovered. 
+	 * - `event` (string): Event name to trigger in JS when clicked ('click' actions only). 
+	 * - `href` (string): URL to open ('link' actions only). 
+	 * - `modal` (bool): Specify true to open link in modal ('link' actions only). 
+	 * 
+	 * Settings for 'toggle' (on/off) type actions 
+	 * -------------------------------------------
+	 * - `on` (bool): Start with the 'on' state? (default=false)
+	 * - `onIcon` (string): Name of font-awesome icon to show for on state. 
+	 * - `onEvent` (string): JS event name to trigger when toggled on. 
+	 * - `onTooltip` (string): Tooltip text to show when on icon is hovered. 
+	 * - `offIcon` (string): Name of font-awesome icon to show for off state. 
+	 * - `offEvent` (string): JS event name to trigger when toggled off. 
+	 * - `offTooltip` (string): Tooltip text to show when off icon is hovered. 
+	 * 
+	 * Other/optional settings (applies to all types) 
+	 * ----------------------------------------------
+	 * - `name` (string): Name of this action (-_a-zA-Z0-9).
+	 * - `parent` (string): Name of parent action, if this action is part of a menu.
+	 * - `overIcon` (string): Name of font-awesome icon to show when hovered. 
+	 * - `overEvent` (string): JS event name to trigger when mouse is over the icon.
+	 * - `downIcon` (string): Icon to display when mouse is down on the action icon (3.0.241+).
+	 * - `downEvent` (string): JS event name to trigger when mouse is down on the icon (3.0.241+).
+	 * - `cursor` (string): CSS cursor name to show when mouse is over the icon. 
+	 * - `setAll` (array): Set all of the header actions in one call, replaces any existing. 
+	 *    Note: to get all actions, call the method and omit the $settings argument. 
+	 * 
+	 * Settings for dropdown menu actions (3.0.241+)
+	 * ---------------------------------------------
+	 *  Note that menu type actions also require jQuery UI and /wire/templates-admin/scripts/main.js,
+	 *  both of which are already present in PW’s admin themes (AdminThemeUikit recommended).
+	 *  Requires ProcessWire 3.0.241 or newer.
+	 *  - `icon` (string): Icon name to use for dropdown toggle, i.e. 'fa-wrench'.
+	 *  - `tooltip` (string): Optional tooltip to describe what the dropdown is for.
+	 *  - `menuAction` (string): Action that toggles the menu to show, one of 'click' or 'hover' (default).
+	 *  - `menuItems` (array): Definition of menu items, each with one or more of the following properties.
+	 *     - `label` (string): Label text for the menu item (required).
+	 *     - `icon` (string): Icon name for the menu item, if desired.
+	 *     - `callback` (function|null): JS callback to execute item is clicked (not applicable in PHP).*
+	 *     - `event` (string): JS event name to trigger when item is clicked.
+	 *     - `tooltip` (string): Tooltip text to show when hovering menu item (title attribute).
+	 *     - `href` (string): URL to go to when menu item clicked.
+	 *     - `target` (string): Target attribute when href is used (i.e. "_blank").
+	 *     - `modal` (bool): Open href in modal window instead?
+	 *     - `active` (function|bool): Callback function that returns true if menu item active, or false.*
+	 *        if disabled. You can also directly specify true or false for this option.
+	 *     - NOTE 1: All `menuItems` properties above are optional, except for 'label'.
+	 *     - NOTE 2: To use `callback` or `active` as functions, you must define your menu in JS instead.
+	 *     - NOTE 3: For examples see the addHeaderAction() method in /wire/templates-admin/scripts/inputfields.js
+	 *
+	 * @param array $settings Specify array containing the appropriate settings above.
+	 * @return array Returns all currently added actions.
+	 * @since 3.0.240
+	 * 
+	 */
+	public function addHeaderAction(array $settings = array()) {
+		if(!empty($settings['setAll'])) {
+			if(is_array($settings['setAll'])) {
+				$this->headerActions = array_values($settings['setAll']);
+			}
+		} else {
+			$this->headerActions[] = $settings; // add new action
+		}
+		return $this->headerActions; // return all
+	}
+
 	/**
 	 * debugInfo PHP 5.6+ magic method
 	 *

wire/core/InputfieldWrapper.php

@@ -3,7 +3,7 @@
 /**
  * ProcessWire InputfieldWrapper
  *
- * ProcessWire 3.x, Copyright 2022 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2024 by Ryan Cramer
  * https://processwire.com
  *
  * About InputfieldWrapper
@@ -402,6 +402,8 @@ class InputfieldWrapper extends Inputfield implements \Countable, \IteratorAggre
 	/**
 	 * Insert new or existing Inputfield before or after another
 	 * 
+	 * #pw-group-manipulation
+	 * 
 	 * @param Inputfield|array|string $item New or existing item Inputfield, name, or new item array to insert.
 	 * @param Inputfield|string $existingItem Existing item or item name you want to insert before.
 	 * @param bool $before True to insert before, false to insert after (default=false).
@@ -549,7 +551,7 @@ class InputfieldWrapper extends Inputfield implements \Countable, \IteratorAggre
 		}
 		if($this->children()->has($item)) {
 			$this->children()->remove($item);
-		} if($this->getChildByName($item->attr('name')) && $item->parent) {
+		} else if($this->getChildByName($item->attr('name')) && $item->parent) {
 			$item->parent->remove($item);
 		}
 		return $this; 
@@ -721,6 +723,7 @@ class InputfieldWrapper extends Inputfield implements \Countable, \IteratorAggre
 		$classes = array();
 		$useColumnWidth = $this->useColumnWidth;
 		$renderAjaxInputfield = $this->wire()->config->ajax ? $this->wire()->input->get('renderInputfieldAjax') : null;
+		$toggleLabel = $sanitizer->entities1($this->_('Toggle open/close'));
 		
 		$lockedStates = array(
 			Inputfield::collapsedNoLocked, 
@@ -775,7 +778,8 @@ class InputfieldWrapper extends Inputfield implements \Countable, \IteratorAggre
 				$errors = $inputfield->getErrors(true);
 				if(count($errors)) {
 					$collapsed = $renderValueMode ? Inputfield::collapsedNoLocked : Inputfield::collapsedNo;
-					$errorsOut = implode(', ', $errors);
+					$comma = $this->_(','); // Comma or other character to separate multiple error messages
+					$errorsOut = implode("$comma ", $errors);
 				}
 			} else $errors = array();
 		
@@ -862,7 +866,7 @@ class InputfieldWrapper extends Inputfield implements \Countable, \IteratorAggre
 
 			// wrap the inputfield output
 			$attrs = '';
-			$label = $inputfield->getSetting('label');
+			$label = (string) $inputfield->getSetting('label');
 			$skipLabel = $inputfield->getSetting('skipLabel'); 
 			$skipLabel = is_bool($skipLabel) || empty($skipLabel) ? (bool) $skipLabel : (int) $skipLabel; // force as bool or int
 			if(!strlen($label) && $skipLabel !== Inputfield::skipLabelBlank && $inputfield->className() != 'InputfieldWrapper') {
@@ -882,25 +886,23 @@ class InputfieldWrapper extends Inputfield implements \Countable, \IteratorAggre
 				$icon = $icon ? str_replace('{name}', $sanitizer->name(str_replace(array('icon-', 'fa-'), '', $icon)), $markup['item_icon']) : ''; 
 				$toggle = $collapsed == Inputfield::collapsedNever ? '' : $markup['item_toggle']; 
 				if($toggle && strpos($toggle, 'title=') === false) {
-					$toggle = str_replace("class=", "title='" . $this->_('Toggle open/close') . "' class=", $toggle);
+					$toggle = str_replace("class=", "title='$toggleLabel' class=", $toggle);
+				}
+				$headerActions = $inputfield->addHeaderAction();
+				if(count($headerActions)) {
+					$label .= $this->renderHeaderActions($inputfield, $headerActions);
 				}
 				if($skipLabel === Inputfield::skipLabelHeader || $quietMode) {
 					// label only shows when field is collapsed
 					$label = str_replace('{out}', $icon . $label . $toggle, $markup['item_label_hidden']); 
 				} else {
 					// label always visible
-					$label = str_replace(array('{for}', '{out}'), array($for, $icon . $label . $toggle), $markup['item_label']); 
+					$label = str_replace('{out}', $icon . $label . $toggle, $markup['item_label']);
+					if($skipLabel !== Inputfield::skipLabelFor) $label = $this->setAttributeInMarkup('for', $for, $label, true);
 				}
 				$headerClass = trim($inputfield->getSetting('headerClass') . " $classes[item_label]");
-				if($headerClass) {
-					if(strpos($label, '{class}') !== false) {
-						$label = str_replace('{class}', ' ' . $headerClass, $label); 
-					} else {
-						$label = preg_replace('/( class=[\'"][^\'"]+)/', '$1 ' . $headerClass, $label, 1);
-					}
-				} else if(strpos($label, '{class}') !== false) {
-					$label = str_replace('{class}', '', $label); 
-				}
+				$label = $this->setAttributeInMarkup('class', $headerClass, $label);
+				
 			} else if($skipLabel === Inputfield::skipLabelMarkup) {
 				// no header and no markup for header
 				$label = '';
@@ -959,16 +961,9 @@ class InputfieldWrapper extends Inputfield implements \Countable, \IteratorAggre
 			}
 			$markupItemContent = $markup['item_content'];
 			$contentClass = trim($inputfield->getSetting('contentClass') . " $classes[item_content]");
-			if($contentClass) {
-				if(strpos($markupItemContent, '{class}') !== false) {
-					$markupItemContent = str_replace('{class}', ' ' . $contentClass, $markupItemContent); 
-				} else {
-					$markupItemContent = preg_replace('/( class=[\'"][^\'"]+)/', '$1 ' . $contentClass, $markupItemContent, 1);
-				}
-			} else if(strpos($markupItemContent, '{class}') !== false) {
-				$markupItemContent = str_replace('{class}', '', $markupItemContent); 
-			}
-			if($inputfield->className() != 'InputfieldWrapper') $ffOut = str_replace('{out}', $ffOut, $markupItemContent); 
+			$markupItemContent = $this->setAttributeInMarkup('class', $contentClass, $markupItemContent);
+			if($inputfield->className() != 'InputfieldWrapper') $ffOut = str_replace('{out}', $ffOut, $markupItemContent);
+			$ffOut .= $inputfield->getSetting('footerMarkup');
 			$out .= str_replace(array('{attrs}', '{out}'), array(trim($attrs), $label . $ffOut), $markup['item']); 
 			$lastInputfield = $inputfield;
 		} // foreach($children as $inputfield)
@@ -991,6 +986,115 @@ class InputfieldWrapper extends Inputfield implements \Countable, \IteratorAggre
 		return $out; 
 	}
 
+	/**
+	 * Set attribute value in markup, optionally replacing a {placeholder} tag
+	 * 
+	 * When a placeholder is present in the given $markup, it should be the 
+	 * attribute name wrapped in `{}`, i.e. `{class}`
+	 * 
+	 * Note that class attributes are appended while other attributes are replaced.
+	 * 
+	 * @param string $name Attribute name (i.e. "class", "for", etc.)
+	 * @param string $value Value to set for the attribute
+	 * @param string $markup Markup where the attribute or placeholder exists
+	 * @param bool $removeEmpty Remove attribute if it resolves to empty value?
+	 * @return string Updated markup
+	 * @since 3.0.242
+	 * 
+	 */
+	protected function setAttributeInMarkup($name, $value, $markup, $removeEmpty = false) {
+		
+		$placeholder = '{' . $name . '}';
+		$hasPlaceholder = strpos($markup, $placeholder) !== false; 
+		
+		if(strlen("$value")) {
+			if($hasPlaceholder) {
+				// replace existing class="… with class="… value
+				$replacement = $name === 'class' ? " $value" : $value;
+				$markup = str_replace($placeholder, $replacement, $markup);
+				
+			} else if(strpos($markup, " $name=") !== false) {
+				// update existing attribute value without a {class} being present
+				// for class attribute it appends existing, for others it replaces
+				$replacement = $name === 'class' ? "$1 $value" : $value;
+				$markup = preg_replace('/(\s' . $name . '=[\'"][^\'"]*)/', $replacement, $markup, 1);
+				
+			} else {
+				// insert attribute where it doesn't currently exist
+				$markup = preg_replace('!(<[a-z0-9]+)(\s*)!i', "$1 $name='$value'$2", $markup, 1);
+			}
+			
+			// remove unnecessary whitespace in class attribute values
+			if($name === 'class') {
+				foreach(array(" $name=' ", " $name=\" ") as $find) {
+					while(strpos($markup, $find)) {
+						$markup = str_replace($find, rtrim($find), $markup);
+					}
+				}
+			}
+			
+		} else if($hasPlaceholder) {
+			if($removeEmpty) {
+				// remove name="{name}"
+				$markup = str_replace(array(" $name='{" . $name . "}'", " $name=\"{" . $name . "}\""), '', $markup);
+			} else {
+				// replace {name} with blank string
+				$markup = str_replace($placeholder, '', $markup);
+			}
+			
+		} else {
+			// $value is empty and there is no placeholder, leave $markup as-is
+		}
+		
+		return $markup;
+	}
+
+	/**
+	 * Render Inputfield header actions
+	 * 
+	 * @param Inputfield $inputfield
+	 * @param array $actions
+	 * @return string
+	 * @since 3.0.240
+	 * 
+	 */
+	protected function renderHeaderActions(Inputfield $inputfield, array $actions) {
+		$sanitizer = $this->wire()->sanitizer;
+		$out = '';
+		$modal = false;
+		foreach($actions as $a) {
+			$icon = '';
+			$type = '';
+			if(isset($a['icon'])) {
+				$icon = $a['icon'];
+				if(isset($a['href'])) {
+					$type = 'link';
+					if(!empty($a['modal'])) $modal = true;
+				} else {
+					$type = 'click';
+				}
+			} else if(isset($a['offIcon'])) {
+				$type = 'toggle';
+				if(!isset($a['onIcon'])) $a['onIcon'] = $a['offIcon'];
+			} else if(isset($a['onIcon'])) {
+				$type = 'toggle';
+				$a['offIcon'] = $a['onIcon']; 
+			}
+			if($type === 'toggle') $icon = $a['on'] ? $a['onIcon'] : $a['offIcon'];
+			if(empty($icon) || empty($type)) continue;
+			$a['type'] = $type;
+			if(strpos($icon, 'fa-') !== 0) $icon = "fa-$icon";
+			$data = $sanitizer->entities(json_encode($a));
+			$out .= "<i class='_InputfieldHeaderAction fa fa-fw $icon' data-action='$data' hidden></i>";
+		}
+		if($modal) {
+			/** @var JqueryUI $jQueryUI */
+			$jQueryUI = $this->wire()->modules->get('JqueryUI');
+			$jQueryUI->use('modal');
+		}
+		return $out;
+	}
+
 	/**
 	 * Render the output of this Inputfield and its children, showing values only (no inputs)
 	 * 
@@ -1131,7 +1235,22 @@ class InputfieldWrapper extends Inputfield implements \Countable, \IteratorAggre
 		$url .= "renderInputfieldAjax=$inputfieldID";
 		$url = $sanitizer->entities($url);
 		
-		$out = "<div class='renderInputfieldAjax'><input type='hidden' value='$url' /></div>";
+		$valueInput = '';
+		$val = $inputfield->val();
+		if(!is_array($val) && !is_object($val)) {
+			$val = (string) $val;
+			if(strlen("$val") <= 1024) {
+				// keep value in hidden input so dependences can refer to it
+				$val = $sanitizer->entities("$val");
+				$valueInput = "<input type='hidden' id='$inputfieldID' value='$val' />";
+			}
+		}
+
+		$out =
+			"<div class='renderInputfieldAjax'>" .
+				"<input type='hidden' value='$url' />" .
+				$valueInput .
+			"</div>";
 		
 		if($inputfield instanceof InputfieldWrapper) {
 			// load assets they will need
@@ -1565,6 +1684,64 @@ class InputfieldWrapper extends Inputfield implements \Countable, \IteratorAggre
 		return $inputfield;
 	}
 
+	/**
+	 * Get Inputfield by Field (hasField)
+	 * 
+	 * This is useful in cases where the input name may differ from the Field name
+	 * that it represents, and you only know the field name. Applies only to 
+	 * Inputfields connected with a Page and Field (i.e. used for page editing).
+	 * 
+	 * #pw-group-retrieval-and-traversal
+	 * 
+	 * @param Field|string|int $field
+	 * @return Inputfield|InputfieldWrapper|null
+	 * @since 3.0.239
+	 * 
+	 */
+	public function getByField($field) {
+		if(!$field instanceof Field) $field = $this->wire()->fields->get($field);
+		return $this->getByProperty('hasField', $field);
+	}
+
+	/**
+	 * Get Inputfield by some other non-attribute property or setting
+	 * 
+	 * #pw-group-retrieval-and-traversal
+	 * 
+	 * @param string $property
+	 * @param mixed $value
+	 * @param bool $getAll Get array of all matching Inputfields rather than just first? (default=false)
+	 * @return Inputfield|InputfieldWrapper|null|array
+	 * @since 3.0.239
+	 * 
+	 */
+	public function getByProperty($property, $value, $getAll = false) {
+		$inputfield = null;
+		$value = (string) $value;
+		$a = array();
+		
+		foreach($this->children() as $child) {
+			/** @var Inputfield $child */
+			if((string) $child->getSetting($property) === $value) {
+				$inputfield = $child;
+			} else if($child instanceof InputfieldWrapper) {
+				if($getAll) {
+					$a = array_merge($a, $child->getByProperty($property, $value, true));
+				} else {
+					$inputfield = $child->getByProperty($property, $value);
+				}
+			}
+			if($inputfield) {
+				if($getAll) {
+					$a[] = $inputfield;
+				} else {
+					break;
+				}
+			}
+		}
+		return $getAll ? $a : $inputfield;
+	}
+
 	/**
 	 * Get value of Inputfield by name
 	 * 
@@ -1683,12 +1860,17 @@ class InputfieldWrapper extends Inputfield implements \Countable, \IteratorAggre
 		/** @var InputfieldSelect $f */
 		$f = $inputfields->getChildByName('collapsed');
 		if($f) {
-			// remove all options for 'collapsed' except for a few
+			// whitelist of collapsed options allowed for fieldsets/wrappers
 			$allow = array(
 				Inputfield::collapsedNo, 
 				Inputfield::collapsedYes, 
 				Inputfield::collapsedYesAjax,
 				Inputfield::collapsedNever,
+				Inputfield::collapsedHidden,
+				Inputfield::collapsedBlank,
+				Inputfield::collapsedPopulated,
+				Inputfield::collapsedBlankAjax,
+				Inputfield::collapsedBlankLocked,
 			);
 			foreach($f->getOptions() as $value => $label) {
 				if(!in_array($value, $allow)) $f->removeOption($value);
@@ -1796,11 +1978,11 @@ class InputfieldWrapper extends Inputfield implements \Countable, \IteratorAggre
 	 * #pw-group-manipulation
 	 *
 	 * @param array $a Array of Inputfield definitions
-	 * @param InputfieldWrapper $inputfields Specify the wrapper you want them added to, or omit to use current.
+	 * @param InputfieldWrapper|null $inputfields Specify the wrapper you want them added to, or omit to use current.
 	 * @return $this
 	 *
 	 */
-	public function importArray(array $a, InputfieldWrapper $inputfields = null) {
+	public function importArray(array $a, ?InputfieldWrapper $inputfields = null) {
 		
 		$modules = $this->wire()->modules;
 		
@@ -1953,4 +2135,3 @@ class InputfieldWrapper extends Inputfield implements \Countable, \IteratorAggre
 	}
 	
 }
-

wire/core/InputfieldsArray.php

@@ -5,12 +5,18 @@
  *
  * The default numeric indexing of a WireArray is not overridden.
  *
- * ProcessWire 3.x, Copyright 2016 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2024 by Ryan Cramer
  * https://processwire.com
  *
  */
 
 class InputfieldsArray extends WireArray {
+	
+	public function __construct() {
+		parent::__construct();
+		$this->usesNumericKeys = true;
+		$this->indexedByName = false;
+	}
 
 	/**
 	 * Per WireArray interface, only Inputfield instances are accepted.
@@ -31,6 +37,7 @@ class InputfieldsArray extends WireArray {
 	 *
 	 */
 	public function find($selector) {
+		/** @var WireArray|InputfieldsArray $a */
 		$a = parent::find($selector);
 		foreach($this as $item) {
 			if(!$item instanceof InputfieldWrapper) continue;
@@ -44,8 +51,4 @@ class InputfieldsArray extends WireArray {
 		return null; // Inputfield is abstract, so there is nothing to return here
 	}
 
-	public function usesNumericKeys() {
-		return true;
-	}
-
 }

wire/core/Interfaces.php

@@ -236,6 +236,58 @@ interface FieldtypeHasPageimages {
 	public function getPageimages(Page $page, Field $field);
 }
 
+/**
+ * Indicates Fieldtype has version support and manages its own versions
+ * 
+ */
+interface FieldtypeDoesVersions {
+	
+	/**
+	 * Get the value for given page, field and version
+	 * 
+	 * @param Page $page
+	 * @param Field $field
+	 * @param int $version
+	 * @return mixed
+	 * 
+	 */
+	public function getPageFieldVersion(Page $page, Field $field, $version);
+
+	/**
+	 * Save version of given page field
+	 * 
+	 * @param Page $page
+	 * @param Field $field
+	 * @param int $version
+	 * @return bool
+	 * 
+	 */
+	public function savePageFieldVersion(Page $page, Field $field, $version);
+
+	/**
+	 * Restore version of given page field to live page
+	 *
+	 * @param Page $page
+	 * @param Field $field
+	 * @param int $version
+	 * @return bool
+	 *
+	 */
+	public function restorePageFieldVersion(Page $page, Field $field, $version);
+
+	/**
+	 * Delete version
+	 * 
+	 * @param Page $page
+	 * @param Field $field
+	 * @param int $version
+	 * @return bool
+	 * 
+	 */
+	public function deletePageFieldVersion(Page $page, Field $field, $version);
+}
+
+
 /**
  * Indicates that an Inputfield provides tree selection capabilities
  *
@@ -706,7 +758,7 @@ interface InputfieldHasSelectableOptions {
 	 * @return self|$this
 	 * 
 	 */
-	public function addOption($value, $label = null, array $attributes = null);
+	public function addOption($value, $label = null, ?array $attributes = null);
 	
 	/**
 	 * Add selectable option with label, optionally for specific language
@@ -720,4 +772,103 @@ interface InputfieldHasSelectableOptions {
 	public function addOptionLabel($value, $label, $language = null);
 }
 
+/**
+ * Interface for WireCache handler classes
+ * 
+ * For example implementations of this interface see 
+ * WireCacheDatabase (core) and WireCacheFilesystem (module)
+ * 
+ * @since 3.0.218
+ * 
+ */
+interface WireCacheInterface {
+	
+	/**
+	 * Find caches by names and/or expirations and return requested values
+	 * 
+	 * ~~~~~
+	 * // Default options
+	 * $defaults = [
+	 *  'names' => [],
+	 *  'expires' => [],
+	 *  'expiresMode' => 'OR',
+	 *  'get' => [ 'name', 'expires', 'data' ],
+	 * ];
+	 * 
+	 * // Example options
+	 * $options['names'] = [ 'my-cache', 'your-cache', 'hello-*' ];
+	 * $options['expires'] => [ 
+	 *  '<= ' . WireCache::expiresNever, 
+	 *  '>= ' . date('Y-m-d H:i:s') 
+	 * ];
+	 * ~~~~~
+	 *
+	 * @param array $options
+	 *  - `get` (array): Properties to get in return value, one or more of [ `name`, `expires`, `data`, `size` ] (default=all)
+	 *  - `names` (array): Names of caches to find (OR condition), optionally appended with wildcard `*`.
+	 *  - `expires` (array): Expirations of caches to match in ISO-8601 date format, prefixed with operator and space (see expiresMode mode below).
+	 *  - `expiresMode` (string): Whether it should match any one condition 'OR', or all conditions 'AND' (default='OR')
+	 * @return array Returns array of associative arrays, each containing requested properties
+	 *
+	 */
+	public function find(array $options);
+	
+	/**
+	 * Save a cache
+	 *
+	 * @param string $name
+	 * @param string $data
+	 * @param string $expire
+	 * @return bool
+	 *
+	 */
+	public function save($name, $data, $expire);
 
+	/**
+	 * Delete cache by name
+	 * 
+	 * @param string $name
+	 * @return bool
+	 * 
+	 */
+	public function delete($name);
+	
+	/**
+	 * Delete all caches (except those reserved by the system)
+	 *
+	 * @return int
+	 *
+	 */
+	public function deleteAll();
+	
+	/**
+	 * Expire all caches (except those that should never expire)
+	 *
+	 * @return int
+	 *
+	 */
+	public function expireAll();
+
+	/**
+	 * Optional method to perform maintenance
+	 * 
+	 * When present, this method should return true if it handled maintenance or false if it did not.
+	 * If it returns false, WireCache will attempt to perform maintenance instead by calling find and 
+	 * delete methods where appropriate.
+	 * 
+	 * WireCache passes either null, a Page object or a Template object as the single argument.
+	 * When null is passed, it means "general maintenance". When a Page or Template object is
+	 * passed then it means that the given Page or Template was just saved, and to perform any 
+	 * necessary maintenance for that case. If the method handles general maintenance but not
+	 * object maintenance, then it should return true when it receives null, and false when it
+	 * receives a Page or Template. 
+	 * 
+	 * @param Page|Template|null $obj
+	 * @return bool
+	 * @since 3.0.219
+	 * 
+	 * The method below is commented out because it optional and only used only if present:
+	 * 
+	 */
+	// public function maintenance($obj = null);
+}

wire/core/LanguageFunctions.php

@@ -284,7 +284,14 @@ function _x($text, $context, $textdomain = null) {
  *
  */
 function _n($textSingular, $textPlural, $count, $textdomain = null) {
-	return $count == 1 ? __($textSingular, $textdomain) : __($textPlural, $textdomain); 	
+	$count = (int) $count;
+	if($count === 0 && wire()->languages) {
+		$plural = __('0-plural', 'common');
+		$value = strtolower($plural) === '0-singular' ? __($textSingular, $textdomain) : __($textPlural, $textdomain);
+	} else {
+		$value = $count === 1 ? __($textSingular, $textdomain) : __($textPlural, $textdomain);
+	}
+	return $value;
 }
 
 /**
@@ -423,5 +430,3 @@ function wireLangTranslations(array $values = array()) {
 function wireLangReplacements(array $values) {
 	return __(true, 'replacements', $values); 
 }
-
-

wire/core/MarkupFieldtype.php

@@ -74,12 +74,13 @@ class MarkupFieldtype extends WireData implements Module {
 	 * If you construct without providing page and field, please populate them
 	 * separately with the setPage and setField methods before calling render().
 	 * 
-	 * @param Page $page
-	 * @param Field $field
+	 * @param Page|null $page
+	 * @param Field|null $field
 	 * @param mixed $value
 	 * 
 	 */
-	public function __construct(Page $page = null, Field $field = null, $value = null) {
+	public function __construct(?Page $page = null, ?Field $field = null, $value = null) {
+		parent::__construct();
 		if($page) $this->setPage($page);
 		if($field) $this->setField($field); 
 		if(!is_null($value)) $this->setValue($value); 
@@ -112,7 +113,7 @@ class MarkupFieldtype extends WireData implements Module {
 				$valid = false;
 				if($value instanceof PageArray) {
 					// PageArray object: get array of property value from each item
-					$field = $this->wire('fields')->get($property);
+					$field = $this->wire()->fields->get($property);
 					if(is_object($field) && $field->type) {
 						$a = array();
 						foreach($value as $page) {
@@ -126,7 +127,8 @@ class MarkupFieldtype extends WireData implements Module {
 						}
 						return $this->arrayToString($a, false);
 					} else {
-						$value = $value->explode($property, array('getMethod' => 'getFormatted'));
+						$getMethod = strpos($property, '}') ? 'getText' : 'getFormatted';
+						$value = $value->explode($property, array('getMethod' => $getMethod));
 					}
 					$valid = true;
 					
@@ -139,25 +141,21 @@ class MarkupFieldtype extends WireData implements Module {
 					// Page object
 					$page = $value;
 					$value = $page->getFormatted($property);
-					$field = $this->wire('fields')->get($property);
+					$field = $this->wire()->fields->get($property);
 					if(is_object($field) && $field->type) return $field->type->markupValue($page, $field, $value);
 					$valid = true;
 				} else if($value instanceof LanguagesValueInterface) {
 					/** @var LanguagesValueInterface $value */
 					/** @var Languages $languages */
-					$languages = $this->wire('languages');
-					if($property) {
-						if($property === 'data') {
-							$languageID = $languages->getDefault()->id;	
-						} else if(is_string($property) && preg_match('/^data(\d+)$/', $property, $matches)) {
-							$languageID = (int) $matches[1];
-						} else {
-							$languageID = 0;
-						}
-						$value = $languageID ? $value->getLanguageValue($languageID) : (string) $value; 
+					$languages = $this->wire()->languages;
+					if($property === 'data') {
+						$languageID = $languages->getDefault()->id;	
+					} else if(is_string($property) && preg_match('/^data(\d+)$/', $property, $matches)) {
+						$languageID = (int) $matches[1];
 					} else {
-						$value = (string) $value;
+						$languageID = 0;
 					}
+					$value = $languageID ? $value->getLanguageValue($languageID) : (string) $value; 
 					
 				} else if($value instanceof WireData) {
 					// WireData object
@@ -268,14 +266,17 @@ class MarkupFieldtype extends WireData implements Module {
 	 * 
 	 */	
 	protected function valueToString($value, $encode = true) {
-		if(is_object($value) && ($value instanceof Pagefiles || $value instanceof Pagefile)) {
+		$isObject = is_object($value);
+		if($isObject && ($value instanceof Pagefiles || $value instanceof Pagefile)) {
+			return $this->objectToString($value);
+		} else if($isObject && wireInstanceOf($value, 'RepeaterPageArray')) {
 			return $this->objectToString($value);
 		} else if(WireArray::iterable($value)) {
 			return $this->arrayToString($value);
-		} else if(is_object($value)) {
+		} else if($isObject) {
 			return $this->objectToString($value);
 		} else {
-			return $encode ? $this->wire('sanitizer')->entities1($value) : $value;
+			return $encode ? $this->wire()->sanitizer->entities1($value) : $value;
 		}
 	}
 
@@ -305,11 +306,16 @@ class MarkupFieldtype extends WireData implements Module {
 	 * 
 	 */
 	protected function objectToString($value) {
-		if($value instanceof WireArray) { 
+		if($value instanceof WireArray) {
 			if(!$value->count()) return '';
+			if(wireInstanceOf($value, 'RepeaterPageArray')) {
+				return $this->renderInputfieldValue($value);
+			}
 		}
 		if($value instanceof Page) {
-			if($value->viewable()) {
+			if(wireInstanceOf($value, 'FieldsetPage')) {
+				return $this->renderInputfieldValue($value);
+			} else if($value->viewable()) {
 				return "<a href='$value->url'>" . $value->get('title|name') . "</a>";
 			} else {
 				return $value->get('title|name');
@@ -387,12 +393,12 @@ class MarkupFieldtype extends WireData implements Module {
 	 * 
 	 */
 	public function __toString() {
-		return $this->render();
+		return (string) $this->render();
 	}
 	
 	public function setPage(Page $page) { $this->_page = $page;  }
 	public function setField(Field $field) { $this->_field = $field;  }
-	public function getPage() { return $this->_page ? $this->_page : $this->wire('pages')->newNullPage(); }
+	public function getPage() { return $this->_page ? $this->_page : $this->wire()->pages->newNullPage(); }
 	public function getField() { return $this->_field; }
 
 	/**

wire/core/MarkupQA.php

@@ -17,7 +17,7 @@
  * 
  * Runtime errors are logged to: /site/assets/logs/markup-qa-errors.txt
  * 
- * ProcessWire 3.x, Copyright 2021 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  * 
  */ 
@@ -67,11 +67,12 @@ class MarkupQA extends Wire {
 	/**
 	 * Construct
 	 * 
-	 * @param Page $page
-	 * @param Field $field
+	 * @param Page|null $page
+	 * @param Field|null $field
 	 *
 	 */
-	public function __construct(Page $page = null, Field $field = null) {
+	public function __construct(?Page $page = null, ?Field $field = null) {
+		parent::__construct();
 		if($page) {
 			$this->setPage($page);
 			$page->wire($this);
@@ -80,8 +81,7 @@ class MarkupQA extends Wire {
 			$this->setField($field);
 			if(!$page) $field->wire($this);
 		}
-		/** @var Config $config */
-		$config = $this->wire('config');
+		$config = $this->wire()->config;
 		$this->assetsURL = $config->urls->assets;
 		$settings = $config->markupQA;
 		if(is_array($settings) && count($settings)) {
@@ -156,7 +156,7 @@ class MarkupQA extends Wire {
 	public function debug($set = null) {
 		if(is_bool($set)) {
 			if($set === true) {
-				$user = $this->wire('user');
+				$user = $this->wire()->user;
 				if(!$user || !$user->isSuperuser()) $set = false;
 			}
 			$this->settings['debug'] = $set;
@@ -213,7 +213,7 @@ class MarkupQA extends Wire {
 		// see if quick exit possible
 		if(stripos($value, 'href=') === false && stripos($value, 'src=') === false) return;
 
-		$config = $this->wire('config');
+		$config = $this->wire()->config;
 		$httpHost = $config->httpHost;
 		$rootURL = $config->urls->root;
 		$rootHostURL = $httpHost . $rootURL;
@@ -241,7 +241,7 @@ class MarkupQA extends Wire {
 			if($this->verbose()) {
 				$info = $this->page->get('_markupQA');	
 				if(!is_array($info)) $info = array();
-				if(!is_array($info[$this->field->name])) $info[$this->field->name] = array();
+				if(!isset($info[$this->field->name]) || !is_array($info[$this->field->name])) $info[$this->field->name] = array();
 				$info[$this->field->name]['href'] = substr_count($value, "\thref=");
 				$info[$this->field->name]['src'] = substr_count($value, "\tsrc=");
 				$this->page->setQuietly('_markupQA', $info);
@@ -326,19 +326,20 @@ class MarkupQA extends Wire {
 	
 		$info = $this->verbose() ? $this->page->get('_markupQA') : array();
 		if(!is_array($info)) $info = array();
+		
+		$counts = array(
+			'external' => 0,
+			'internal' => 0,
+			'relative' => 0,
+			'files' => 0,
+			'other' => 0,
+			'unresolved' => 0,
+			'nohttp' => 0,
+			'ignored' => 0,
+		);
+		
 		if(isset($info[$this->field->name])) {
-			$counts = $info[$this->field->name];	
-		} else {
-			$counts = array(
-				'external' => 0,
-				'internal' => 0,
-				'relative' => 0,
-				'files' => 0,
-				'other' => 0,
-				'unresolved' => 0,
-				'nohttp' => 0, 
-				'ignored' => 0, 
-			);
+			$counts = array_merge($counts, $info[$this->field->name]);	
 		}
 		
 		$re = '!' . 
@@ -393,7 +394,7 @@ class MarkupQA extends Wire {
 			} else if(strrpos($path, '.') > strrpos($path, '/')) {
 				// not relative and possibly a filename
 				// if this link is to a file that exists, then it's not a page link so skip it
-				$file = $this->wire('config')->paths->root . ltrim($path, '/');
+				$file = $config->paths->root . ltrim($path, '/');
 				if(file_exists($file)) {
 					$counts['files']++;
 					continue;
@@ -453,14 +454,14 @@ class MarkupQA extends Wire {
 				}
 			} else {
 				// did not resolve to a page, see if it resolves to a file or directory
-				$file = $this->wire('config')->paths->root . ltrim($path, '/');
+				$file = $config->paths->root . ltrim($path, '/');
 				if(file_exists($file)) {
 					if($debug) $this->message("MarkupQA sleepLinks link resolved to a file: $path");
 					$counts['files']++;
 				} else {
 					$parts = explode('/', trim($path, '/'));
 					$firstPart = array_shift($parts);
-					$test = $this->wire('config')->paths->root . $firstPart; 
+					$test = $config->paths->root . $firstPart; 
 					if(is_dir($test)) {
 						// possibly to something in another application, i.e. processwire.com/talk/
 						$counts['other']++;
@@ -506,9 +507,10 @@ class MarkupQA extends Wire {
 		if(!preg_match_all($re, $value, $matches)) return array();
 		
 		$replacements = array();
-		$languages = $this->wire('languages');
-		$rootURL = $this->wire('config')->urls->root;
-		$adminURL = $this->wire('config')->urls->admin;
+		$languages = $this->wire()->languages;
+		$config = $this->wire()->config;
+		$rootURL = $config->urls->root;
+		$adminURL = $config->urls->admin;
 		$adminPath = $rootURL === '/' ? $adminURL : str_replace($rootURL, '/', $adminURL);
 		$debug = $this->debug();
 		
@@ -539,10 +541,8 @@ class MarkupQA extends Wire {
 			} else {
 				$language = null;
 			}
-			
-			$livePath = $this->wire('pages')->getPath($pageID, array(
-				'language' => $language
-			));
+		
+			$livePath = $this->getPagePathFromId($pageID, $language);
 			
 			if($urlSegmentStr) {
 				$livePath = rtrim($livePath, '/') . "/$urlSegmentStr";
@@ -606,7 +606,7 @@ class MarkupQA extends Wire {
 	/**
 	 * Find pages linking to another
 	 * 
-	 * @param Page $page Page to find links to, or omit to use page specified in constructor
+	 * @param Page|null $page Page to find links to, or omit to use page specified in constructor
 	 * @param array $fieldNames Field names to look in or omit to use field specified in constructor
 	 * @param string $selector Optional selector to use as a filter
 	 * @param array $options Additional options
@@ -617,7 +617,11 @@ class MarkupQA extends Wire {
 	 * @return PageArray|array|int
 	 * 
 	 */
-	public function findLinks(Page $page = null, $fieldNames = array(), $selector = '', array $options = array()) {
+	public function findLinks(?Page $page = null, $fieldNames = array(), $selector = '', array $options = array()) {
+		
+		$pages = $this->wire()->pages;
+		$fields = $this->wire()->fields;
+		$database = $this->wire()->database;
 		
 		$defaults = array(
 			'getIDs' => false,
@@ -632,7 +636,7 @@ class MarkupQA extends Wire {
 		} else if($options['getCount']) {
 			$result = 0;
 		} else {
-			$result = $this->wire('pages')->newPageArray();
+			$result = $pages->newPageArray();
 		}
 		
 		if(!$page) $page = $this->page;
@@ -652,11 +656,11 @@ class MarkupQA extends Wire {
 		// find pages
 		if($options['getCount'] && !$options['confirm']) {
 			// just return a count
-			return $this->wire('pages')->count($selector);
+			return $pages->count($selector);
 		} else {
 			// find the IDs
 			$checkIDs = array();
-			$foundIDs = $this->wire('pages')->findIDs($selector);
+			$foundIDs = $pages->findIDs($selector);
 			if(!count($foundIDs)) return $result;
 			if($options['confirm']) {
 				$checkIDs = array_flip($foundIDs);
@@ -667,12 +671,12 @@ class MarkupQA extends Wire {
 		// confirm results
 		foreach($fieldNames as $fieldName) {
 			if(!count($checkIDs)) break;
-			$field = $this->wire('fields')->get($fieldName);
+			$field = $fields->get($fieldName);
 			if(!$field) continue;
 			$table = $field->getTable();
 			$ids = implode(',', array_keys($checkIDs));
 			$sql = "SELECT * FROM `$table` WHERE `pages_id` IN($ids)";
-			$query = $this->wire('database')->prepare($sql);
+			$query = $database->prepare($sql);
 			$query->execute();
 
 			while($row = $query->fetch(\PDO::FETCH_ASSOC)) {
@@ -698,7 +702,7 @@ class MarkupQA extends Wire {
 			} else if($options['getCount']) {
 				$result = count($foundIDs); 
 			} else {
-				$result = $this->wire('pages')->getById($foundIDs);
+				$result = $pages->getById($foundIDs);
 			}
 		}
 	
@@ -713,7 +717,7 @@ class MarkupQA extends Wire {
 	 * 
 	 */
 	protected function linkWarning($path, $logWarning = true) {
-		if($this->wire('page')->template == 'admin' && $this->wire('process') == 'ProcessPageEdit') {
+		if($this->wire()->page->template == 'admin' && $this->wire()->process == 'ProcessPageEdit') {
 			$this->warning(sprintf(
 				$this->_('Unable to resolve link on page %1$s in field "%2$s": %3$s'), 
 				$this->page->path, 
@@ -738,7 +742,7 @@ class MarkupQA extends Wire {
 	 */
 	public function checkImgTags(&$value, array $options = array()) {
 		if(strpos($value, '<img ') !== false && preg_match_all('{(<' . 'img [^>]+>)}', $value, $matches)) {
-			foreach($matches[0] as $key => $img) {
+			foreach($matches[0] as $img) {
 				$this->checkImgTag($value, $img, $options);
 			}
 		}
@@ -784,7 +788,7 @@ class MarkupQA extends Wire {
 		if(!isset($info['img_noalt'])) $info['img_noalt'] = 0; // blank alt
 
 		// determine current 'alt' and 'src' attributes
-		foreach($attrStrings as $n => $attr) {
+		foreach($attrStrings as $attr) {
 
 			if(!strpos($attr, '=')) continue;
 			list($name, $val) = explode('=', $attr);
@@ -868,7 +872,7 @@ class MarkupQA extends Wire {
 			if($this->page->of()) {
 				$alt = $pagefile->description;
 				if(strlen($alt)) {
-					$alt = $this->wire('sanitizer')->entities1($alt);
+					$alt = $this->wire()->sanitizer->entities1($alt);
 					$_img = str_replace(" $replaceAlt", " alt=\"$alt\"", $img);
 					$value = str_replace($img, $_img, $value);
 				}
@@ -896,6 +900,7 @@ class MarkupQA extends Wire {
 	 *
 	 */
 	protected function checkImgExists(Pageimage $pagefile, $img, $src, &$value) {
+		
 
 		$basename = basename($src);
 		$pathname = $pagefile->pagefiles->path() . $basename;
@@ -928,6 +933,7 @@ class MarkupQA extends Wire {
 		
 		$good = 0;
 		$bad = 0;
+		$debug = $this->debug() || $this->wire()->config->debug;
 		
 		foreach(array_reverse($variations) as $info) {
 			// definitely a variation, attempt to re-create it
@@ -937,14 +943,13 @@ class MarkupQA extends Wire {
 				$options['suffix'] = $info['suffix'];
 				if(in_array('hidpi', $options['suffix'])) $options['hidpi'] = true;
 			}
-			/** @var Pageimage $newPagefile */
 			$newPagefile = $pagefile->size($info['width'], $info['height'], $options);
 			if($newPagefile && is_file($newPagefile->filename())) {
 				if(!empty($info['targetName']) && $newPagefile->basename != $info['targetName']) {
 					// new name differs from what is in text. Rename file to be consistent with text.
 					rename($newPagefile->filename(), $pathname);
 				}
-				if($this->debug() || $this->wire('config')->debug) {
+				if($debug) {
 					$this->message($this->_('Re-created image variation') . " - $newPagefile->name");
 				}
 				$pagefile = $newPagefile; // for next iteration
@@ -971,7 +976,7 @@ class MarkupQA extends Wire {
 	 */
 	public function error($text, $flags = 0) {
 		$logText = "$text (field={$this->field->name}, id={$this->page->id}, path={$this->page->path})";
-		$this->wire('log')->save(self::errorLogName, $logText);
+		$this->wire()->log->save(self::errorLogName, $logText);
 		/*
 		if($this->wire('modules')->isInstalled('SystemNotifications')) {
 			$user = $this->wire('modules')->get('SystemNotifications')->getSystemUser();
@@ -1018,4 +1023,67 @@ class MarkupQA extends Wire {
 		$this->settings['verbose'] = $verbose ? true : false;
 	}
 
-}
+	/**
+	 * Given page ID return the path to it
+	 * 
+	 * @param int $pageID
+	 * @param Language|null $language
+	 * @return string
+	 * @since 3.0.231
+	 * 
+	 */
+	protected function getPagePathFromId($pageID, $language = null) {
+		
+		$pages = $this->wire()->pages;
+		$path = null;
+		
+		if($this->isPagePathHooked()) {
+			$page = $pages->get($pageID);
+			if($page->id) {
+				if($language && $language->id) {
+					$languages = $this->wire()->languages;
+					$languages->setLanguage($language);
+					$path = $page->path();
+					$languages->unsetLanguage();
+				} else {
+					$path = $page->path();
+				}
+			}
+		}
+		
+		if($path === null) {
+			$path = $pages->getPath($pageID, array(
+				'language' => $language
+			));
+		}
+		
+		return $path;
+	}
+
+	/**
+	 * Is the Page::path method hooked in a manner that might affect MarkupQA? 
+	 * 
+	 * @return bool
+	 * @since 3.0.231
+	 * 
+	 */
+	protected function isPagePathHooked() {
+		$config = $this->wire()->config;
+		$property = '_MarkupQA_pagePathHooked';
+		$hooked = $config->get($property);
+		if($hooked !== null) return $hooked;
+		$hooks = $this->wire()->hooks;
+		$hooked = $hooks->isHooked('Page::path()');
+		if($hooked) {
+			// only consider Page::path hooked if something other than LanguageSupportPageNames hooks it
+			$hookItems = $hooks->getHooks($this->page, 'path', WireHooks::getHooksStatic);
+			foreach($hookItems as $key => $hook) {
+				if(((string) $hook['toObject']) === 'LanguageSupportPageNames') unset($hookItems[$key]);
+			}
+			$hooked = count($hookItems) > 0;
+		}
+		$config->setQuietly($property, $hooked);
+		return $hooked;
+	}
+
+}

wire/core/Module.php

@@ -270,7 +270,7 @@
  * - Singular modules will have their instance active for the entire request after instantiated.
  * - Non-singular modules return a new instance on every `$modules->get("YourModule")` call.
  * - Modules that attach hooks are usually singular.
- * - Modules that may have multiple instances (like `Inputfield` modules) should _not_be singular.
+ * - Modules that may have multiple instances (like `Inputfield` modules) should _not_ be singular.
  *
  * If you are having trouble deciding whether to make your module singular or not, be sure to read 
  * the documentation below for the `isAutoload()` method, because if your module is 'autoload' then 
@@ -588,4 +588,3 @@ interface SearchableModule {
 	 */
 	public function search($text, array $options = array()); 
 }
-

wire/core/ModuleConfig.php

@@ -1,7 +1,7 @@
 <?php namespace ProcessWire;
 
 /**
- * Class ModuleConfig
+ * ModuleConfig class
  * 
  * Serves as the base for classes dedicated to configuring modules. 
  * 
@@ -11,6 +11,9 @@
  * This file is licensed under the MIT license
  * https://processwire.com/about/license/mit/
  * 
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
+ * https://processwire.com
+ * 
  */
 
 class ModuleConfig extends WireData {
@@ -46,6 +49,7 @@ class ModuleConfig extends WireData {
 	 * 
 	 */
 	public function __construct() {
+		parent::__construct();
 	}
 
 	/**
@@ -95,7 +99,7 @@ class ModuleConfig extends WireData {
 	 * Set an array that defines Inputfields
 	 * 
 	 * @param array $a
-	 * @return this
+	 * @return self
 	 * 
 	 */
 	public function add(array $a) {

wire/core/ModuleJS.php

@@ -10,7 +10,7 @@
  * 
  * See the Module interface (Module.php) for details about each method. 
  * 
- * ProcessWire 3.x, Copyright 2022 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  *
  * This file is licensed under the MIT license
@@ -110,23 +110,23 @@ abstract class ModuleJS extends WireData implements Module {
 		
 		$class = $this->className();
 		$config = $this->wire()->config;
+		$version = $config->version;
+		$debug = $config->debug;
 	
 		$file = $config->paths->$class . "$class.css";
 		if($this->loadStyles && is_file($file)) {
-			$mtime = filemtime($file);
-			$this->config->styles->add($config->urls->$class . "$class.css?v=$mtime");
+			if($debug) $version = filemtime($file);
+			$this->config->styles->add($config->urls->$class . "$class.css?v=$version");
 		}
 		
 		$file = $config->paths->$class . "$class.js"; 
-		$mtime = 0;
 		if($this->loadScripts && is_file($file)) {
 			$minFile = $config->paths->$class . "$class.min.js";
-			if(!$config->debug && is_file($minFile)) {
-				$mtime = filemtime($minFile);
-				$config->scripts->add($config->urls->$class . "$class.min.js?v=$mtime");
+			if(!$debug && is_file($minFile)) {
+				$config->scripts->add($config->urls->$class . "$class.min.js?v=$version");
 			} else {
-				$mtime = filemtime($file);
-				$config->scripts->add($config->urls->$class . "$class.js?v=$mtime");
+				if($debug) $version = filemtime($file);
+				$config->scripts->add($config->urls->$class . "$class.js?v=$version");
 			}
 		}
 
@@ -134,10 +134,10 @@ abstract class ModuleJS extends WireData implements Module {
 			foreach($this->requested as $name) {
 				$url = $this->components[$name]; 
 				if(strpos($url, '/') === false) {
-					$mtime = filemtime($config->paths->$class . $url);
+					if($debug) $version = filemtime($config->paths->$class . $url);
 					$url = $config->urls->$class . $url;
 				}
-				$url .= "?v=$mtime";
+				$url .= "?v=$version";
 				$config->scripts->add($url);
 			}
 			$this->requested = array();
@@ -167,13 +167,13 @@ abstract class ModuleJS extends WireData implements Module {
 
 		if($this->initialized) {
 			$url = $this->components[$name];
-			$mtime = 0;
+			$version = $config->version;
 			if(strpos($url, '/') === false) {
 				$file = $config->paths->$class . $url;
 				$url = $config->urls->$class . $url;
-				$mtime = filemtime($file);
+				if($config->debug) $version = filemtime($file);
 			}
-			$config->scripts->add($url . "?v=$mtime");
+			$config->scripts->add($url . "?v=$version");
 		} else {
 			$this->requested[$name] = $name;
 		}
@@ -186,4 +186,3 @@ abstract class ModuleJS extends WireData implements Module {
 	public function isSingular() { return true; }	
 	public function isAutoload() { return false; }
 }
-

wire/core/ModulePlaceholder.php

@@ -6,7 +6,7 @@
  * Holds the place for a Module until it is included and instantiated.
  * As used by the Modules class. 
  * 
- * ProcessWire 3.x, Copyright 2016 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://.processwire.com
  * 
  * @property bool $autoload
@@ -25,6 +25,7 @@ class ModulePlaceholder extends WireData implements Module {
 	protected $moduleInfo = array();
 
 	public function __construct() {
+		parent::__construct();
 		$this->set('autoload', false); 
 		$this->set('singular', true); 
 		$this->set('file', ''); 
@@ -35,7 +36,7 @@ class ModulePlaceholder extends WireData implements Module {
 			'title' => 'ModulePlaceholder: call $modules->get(class) to replace this placeholder.',  
 			'version' => 0, 
 			'summary' => '', 
-			);
+		);
 	}
 
 	public function init() { }
@@ -43,11 +44,11 @@ class ModulePlaceholder extends WireData implements Module {
 	public function ___uninstall() { }
 
 	public function setClass($class) {
-		$this->class = $class; 
+		$this->class = (string) $class; 
 	}
 	
 	public function setNamespace($ns) {
-		$this->ns = $ns;
+		$this->ns = (string) $ns;
 	}
 
 	public function get($key) {
@@ -65,10 +66,9 @@ class ModulePlaceholder extends WireData implements Module {
 
 	public function className($options = null) {
 		if($options === true || !empty($options['namespace'])) {
-			return trim($this->ns, '\\') . '\\' . $this->class;
+			return trim("$this->ns", '\\') . '\\' . $this->class;
 		}
 		return $this->class; 
 	}
 
 }
-

wire/core/ModulesClass.php

@@ -0,0 +1,91 @@
+<?php namespace ProcessWire;
+
+/**
+ * ProcessWire Modules: Class
+ * 
+ * Base for Modules helper classes. 
+ *
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
+ * https://processwire.com
+ *
+ */
+
+abstract class ModulesClass extends Wire {
+
+	/**
+	 * @var Modules
+	 *
+	 */
+	protected $modules;
+
+	/**
+	 * Debug mode?
+	 *
+	 * @var bool
+	 *
+	 */
+	protected $debug = false;
+
+	/**
+	 * Construct
+	 *
+	 * @param Modules $modules
+	 */
+	public function __construct(Modules $modules) {
+		$this->modules = $modules;
+		$modules->wire($this);
+		parent::__construct();
+	}
+
+	/**
+	 * Convert given value to module ID
+	 *
+	 * @param string|int|Module $name
+	 * @return int Returns 0 if module not found
+	 *
+	 */
+	protected function moduleID($name) {
+		return $this->modules->moduleID($name);
+	}
+
+	/**
+	 * Convert given value to module name
+	 *
+	 * @param int|string|Module $id
+	 * @return string Returns blank string if not found
+	 *
+	 */
+	protected function moduleName($id) {
+		return $this->modules->moduleName($id);
+	}
+	
+	/**
+	 * Save to the modules log
+	 *
+	 * @param string $str Message to log
+	 * @param array|string $options Specify module name (string) or options array
+	 * @return WireLog
+	 *
+	 */
+	public function log($str, $options = array()) {
+		return $this->modules->log($str, $options);
+	}
+	
+	/**
+	 * Record and log error message
+	 *
+	 * #pw-internal
+	 *
+	 * @param array|Wire|string $text
+	 * @param int $flags
+	 * @return Modules|WireArray
+	 *
+	 */
+	public function error($text, $flags = 0) {
+		return $this->modules->error($text, $flags);
+	}
+
+	public function getDebugData() {
+		return array();
+	}
+}

wire/core/ModulesConfigs.php

@@ -0,0 +1,721 @@
+<?php namespace ProcessWire;
+
+/**
+ * ProcessWire Modules: Configs
+ *
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
+ * https://processwire.com
+ *
+ */
+
+class ModulesConfigs extends ModulesClass {
+	
+	/**
+	 * Cached module configuration data indexed by module ID
+	 *
+	 * Values are integer 1 for modules that have config data but data is not yet loaded.
+	 * Values are an array for modules have have config data and has been loaded.
+	 *
+	 */
+	protected $configData = array();
+
+	/**
+	 * Get or set module configuration data
+	 * 
+	 * #pw-internal
+	 * 
+	 * @param int $moduleID
+	 * @param array $setData
+	 * @return array|int|null Returns one of the following:
+	 *  - Array of module config data 
+	 *  - Null if requested moduleID is not found
+	 *  - Integer 1 if config data is present but must be loaded from DB
+	 * 
+	 */
+	public function configData($moduleID, $setData = null) {
+		$moduleID = (int) $moduleID;
+		if($setData) {
+			$this->configData[$moduleID] = $setData;
+			return array();
+		} else if(isset($this->configData[$moduleID])) {
+			return $this->configData[$moduleID];
+		} else {
+			return null;
+		}
+	}
+	
+	/**
+	 * Return the URL where the module can be edited, configured or uninstalled
+	 *
+	 * If module is not installed, it returns URL to install the module.
+	 *
+	 * #pw-group-configuration
+	 *
+	 * @param string|Module $className
+	 * @param bool $collapseInfo
+	 * @return string
+	 *
+	 */
+	public function getModuleEditUrl($className, $collapseInfo = true) {
+		if(!is_string($className)) $className = $this->modules->getModuleClass($className);
+		$url = $this->wire()->config->urls->admin . 'module/';
+		if(empty($className)) return $url;
+		if(!$this->modules->isInstalled($className)) return $this->modules->getModuleInstallUrl($className);
+		$url .= "edit/?name=$className";
+		if($collapseInfo) $url .= "&collapse_info=1";
+		return $url;
+	}
+	
+	/**
+	 * Given a module name, return an associative array of configuration data for it
+	 *
+	 * - Applicable only for modules that support configuration.
+	 * - Configuration data is stored encoded in the database "modules" table "data" field.
+	 *
+	 * ~~~~~~
+	 * // Getting, modifying and saving module config data
+	 * $data = $modules->getConfig('HelloWorld');
+	 * $data['greeting'] = 'Hello World! How are you today?';
+	 * $modules->saveConfig('HelloWorld', $data);
+	 *
+	 * // Getting just one property 'apiKey' from module config data
+	 * @apiKey = $modules->getConfig('HelloWorld', 'apiKey');
+	 * ~~~~~~
+	 *
+	 * #pw-group-configuration
+	 * #pw-changelog 3.0.16 Changed from more verbose name `getModuleConfigData()`, which can still be used.
+	 *
+	 * @param string|Module $class
+	 * @param string $property Optionally just get value for a specific property (omit to get all config)
+	 * @return array|string|int|float Module configuration data, returns array unless a specific $property was requested
+	 * @see Modules::saveConfig()
+	 * @since 3.0.16 Use method getModuleConfigData() with same arguments for prior versions (can also be used on any version).
+	 *
+	 */
+	public function getConfig($class, $property = '') {
+
+		$emptyReturn = $property ? null : array();
+		$className = $class;
+		
+		if(is_object($className)) $className = wireClassName($className->className(), false);
+		
+		$id = $this->moduleID($className);
+		if(!$id) return $emptyReturn;
+	
+		$data = isset($this->configData[$id]) ? $this->configData[$id] : null;
+		if($data === null) return $emptyReturn; // module has no config data
+
+		if(is_array($data)) {
+			// great
+		} else {
+			// configData===1 indicates data must be loaded from DB
+			$configable = $this->isConfigable($className);
+			if(!$configable) return $emptyReturn;
+			$database = $this->wire()->database;
+			$query = $database->prepare("SELECT data FROM modules WHERE id=:id", "modules.getConfig($className)"); // QA
+			$query->bindValue(":id", (int) $id, \PDO::PARAM_INT);
+			$query->execute();
+			$data = $query->fetchColumn();
+			$query->closeCursor();
+			if(strlen($data)) $data = wireDecodeJSON($data);
+			if(empty($data)) $data = array();
+			$this->configData[(int) $id] = $data;
+		}
+
+		if($property) return isset($data[$property]) ? $data[$property] : null;
+
+		return $data;
+	}
+	
+	/**
+	 * Is the given module interactively configurable?
+	 *
+	 * This method can be used to simply determine if a module is configurable (yes or no), or more specifically
+	 * how it is configurable.
+	 *
+	 * ~~~~~
+	 * // Determine IF a module is configurable
+	 * if($modules->isConfigurable('HelloWorld')) {
+	 *   // Module is configurable
+	 * } else {
+	 *   // Module is NOT configurable
+	 * }
+	 * ~~~~~
+	 * ~~~~~
+	 * // Determine HOW a module is configurable
+	 * $configurable = $module->isConfigurable('HelloWorld');
+	 * if($configurable === true) {
+	 *   // configurable in a way compatible with all past versions of ProcessWire
+	 * } else if(is_string($configurable)) {
+	 *   // configurable via an external configuration file
+	 *   // file is identifed in $configurable variable
+	 * } else if(is_int($configurable)) {
+	 *   // configurable via a method in the class
+	 *   // the $configurable variable contains a number with specifics
+	 * } else {
+	 *   // module is NOT configurable
+	 * }
+	 * ~~~~~
+	 *
+	 * ### Return value details
+	 *
+	 * #### If module is configurable via external configuration file:
+	 *
+	 * - Returns string of full path/filename to `ModuleName.config.php` file
+	 *
+	 * #### If module is configurable because it implements a configurable module interface:
+	 *
+	 * - Returns boolean `true` if module is configurable via the static `getModuleConfigInputfields()` method.
+	 *   This particular method is compatible with all past versions of ProcessWire.
+	 * - Returns integer `2` if module is configurable via the non-static `getModuleConfigInputfields()` and requires no arguments.
+	 * - Returns integer `3` if module is configurable via the non-static `getModuleConfigInputfields()` and requires `$data` array.
+	 * - Returns integer `4` if module is configurable via the non-static `getModuleConfigInputfields()` and requires `InputfieldWrapper` argument.
+	 * - Returns integer `19` if module is configurable via non-static `getModuleConfigArray()` method.
+	 * - Returns integer `20` if module is configurable via static `getModuleConfigArray()` method.
+	 *
+	 * #### If module is not configurable:
+	 *
+	 * - Returns boolean `false` if not configurable
+	 *
+	 * *This method is named isConfigurableModule() in ProcessWire versions prior to to 3.0.16.*
+	 *
+	 * #pw-group-configuration
+	 *
+	 * @param Module|string $class Module name
+	 * @param bool $useCache Use caching? This accepts a few options:
+	 * 	- Specify boolean `true` to allow use of cache when available (default behavior).
+	 * 	- Specify boolean `false` to disable retrieval of this property from getModuleInfo (forces a new check).
+	 * 	- Specify string `interface` to check only if module implements ConfigurableModule interface.
+	 * 	- Specify string `file` to check only if module has a separate configuration class/file.
+	 * @return bool|string|int See details about return values in method description.
+	 * @since 3.0.16
+	 *
+	 * @todo this method has two distinct parts (file and interface) that need to be split in two methods.
+	 *
+	 */
+	public function isConfigurable($class, $useCache = true) {
+
+		$className = $class;
+		$moduleInstance = null;
+		$namespace = $this->modules->info->getModuleNamespace($className);
+		
+		if(is_object($className)) {
+			$moduleInstance = $className;
+			$className = $this->modules->getModuleClass($moduleInstance);
+		}
+		
+		$nsClassName = $namespace . $className;
+
+		if($useCache === true || $useCache === 1 || $useCache === "1") {
+			$info = $this->modules->getModuleInfo($className);
+			// if regular module info doesn't have configurable info, attempt it from verbose module info
+			// should only be necessary for transition period between the 'configurable' property being 
+			// moved from verbose to non-verbose module info (i.e. this line can be deleted after PW 2.7)
+			if($info['configurable'] === null) {
+				$info = $this->modules->getModuleInfoVerbose($className);
+			}
+			if(!$info['configurable']) {
+				if($moduleInstance instanceof ConfigurableModule) {
+					// re-try because moduleInfo may be temporarily incorrect for this request because of change in moduleInfo format
+					// this is due to reports of ProcessChangelogHooks not getting config data temporarily between 2.6.11 => 2.6.12
+					$this->error(
+						"Configurable module check failed for $className. " .
+						"If this error persists, please do a Modules > Refresh.",
+						Notice::debug
+					);
+					$useCache = false;
+				} else {
+					return false;
+				}
+			} else {
+				if($info['configurable'] === true) return $info['configurable'];
+				if($info['configurable'] === 1 || $info['configurable'] === "1") return true;
+				if(is_int($info['configurable']) || ctype_digit("$info[configurable]")) return (int) $info['configurable'];
+				if(strpos($info['configurable'], $className) === 0) {
+					if(empty($info['file'])) {
+						$info['file'] = $this->modules->files->getModuleFile($className);
+					}
+					if($info['file']) {
+						return dirname($info['file']) . "/$info[configurable]";
+					}
+				}
+			}
+		}
+
+		if($useCache !== "interface") {
+			// check for separate module configuration file
+			$dir = dirname($this->modules->files->getModuleFile($className));
+			if($dir) {
+				$files = array(
+					"$dir/{$className}Config.php",
+					"$dir/$className.config.php"
+				);
+				$found = false;
+				foreach($files as $file) {
+					if(!is_file($file)) continue;
+					$config = null; // include file may override
+					$this->modules->files->includeModuleFile($file, $className);
+					$classConfig = $nsClassName . 'Config';
+					if(class_exists($classConfig, false)) {
+						$parents = wireClassParents($classConfig, false);
+						if(is_array($parents) && in_array('ModuleConfig', $parents)) {
+							$found = $file;
+							break;
+						}
+					} else {
+						// bypass include_once, because we need to read $config every time
+						if(is_null($config)) {
+							$classInfo = $this->modules->files->getFileClassInfo($file);
+							if($classInfo['class']) {
+								// not safe to include because this is not just a file with a $config array
+							} else {
+								$ns = $this->modules->files->getFileNamespace($file);
+								$file = $this->modules->files->compile($className, $file, $ns);
+								if($file) {
+									/** @noinspection PhpIncludeInspection */
+									include($file);
+								}
+							}
+						}
+						if(!is_null($config)) {
+							// included file specified a $config array
+							$found = $file;
+							break;
+						}
+					}
+				}
+				if($found) return $found;
+			}
+		}
+
+		// if file-only check was requested and we reach this point, exit with false now
+		if($useCache === "file") return false;
+
+		// ConfigurableModule interface checks
+
+		$result = false;
+
+		foreach(array('getModuleConfigArray', 'getModuleConfigInputfields') as $method) {
+
+			$configurable = false;
+
+			// if we have a module instance, use that for our check
+			if($moduleInstance instanceof ConfigurableModule) {
+				if(method_exists($moduleInstance, $method)) {
+					$configurable = $method;
+				} else if(method_exists($moduleInstance, "___$method")) {
+					$configurable = "___$method";
+				}
+			}
+
+			// if we didn't have a module instance, load the file to find what we need to know
+			if(!$configurable) {
+				if(!wireClassExists($nsClassName, false)) {
+					$this->modules->includeModule($className);
+				}
+				$interfaces = wireClassImplements($nsClassName, false);
+				if(is_array($interfaces) && in_array('ConfigurableModule', $interfaces)) {
+					if(wireMethodExists($nsClassName, $method)) {
+						$configurable = $method;
+					} else if(wireMethodExists($nsClassName, "___$method")) {
+						$configurable = "___$method";
+					}
+				}
+			}
+
+			// if still not determined to be configurable, move on to next method
+			if(!$configurable) continue;
+
+			// now determine if static or non-static
+			$ref = new \ReflectionMethod(wireClassName($nsClassName, true), $configurable);
+
+			if($ref->isStatic()) {
+				// config method is implemented as a static method
+				if($method == 'getModuleConfigInputfields') {
+					// static getModuleConfigInputfields
+					$result = true;
+				} else {
+					// static getModuleConfigArray
+					$result = 20;
+				}
+
+			} else if($method == 'getModuleConfigInputfields') {
+				// non-static getModuleConfigInputfields
+				// we allow for different arguments, so determine what it needs
+				$parameters = $ref->getParameters();
+				if(count($parameters)) {
+					$param0 = reset($parameters);
+					if(strpos($param0, 'array') !== false || strpos($param0, '$data') !== false) {
+						// method requires a $data array (for compatibility with non-static version)
+						$result = 3;
+					} else if(strpos($param0, 'InputfieldWrapper') !== false || strpos($param0, 'inputfields') !== false) {
+						// method requires an empty InputfieldWrapper (as a convenience)
+						$result = 4;
+					}
+				}
+				// method requires no arguments
+				if(!$result) $result = 2;
+
+			} else {
+				// non-static getModuleConfigArray
+				$result = 19;
+			}
+
+			// if we make it here, we know we already have a result so can stop now
+			break;
+		}
+
+		return $result;
+	}
+
+
+	/**
+	 * Indicates whether module accepts config settings, whether interactively or API only
+	 *
+	 * - Returns false if module does not accept config settings.
+	 * - Returns integer `30` if module accepts config settings but is not interactively configurable.
+	 * - Returns true, int or string if module is interactively configurable, see `Modules::isConfigurable()` return values.
+	 *
+	 * @param string|Module $class
+	 * @param bool $useCache
+	 * @return bool|int|string
+	 * @since 3.0.179
+	 *
+	 */
+	public function isConfigable($class, $useCache = true) {
+		if(is_object($class)) {
+			if($class instanceof ConfigModule) {
+				$result = 30;
+			} else {
+				$result = $this->isConfigurable($class, $useCache);
+			}
+		} else {
+			$result = $this->isConfigurable($class, $useCache);
+			if(!$result && wireInstanceOf($class, 'ConfigModule')) $result = 30;
+		}
+		return $result;
+	}
+
+	/**
+	 * Populate configuration data to a ConfigurableModule
+	 *
+	 * If the Module has a 'setConfigData' method, it will send the array of data to that.
+	 * Otherwise it will populate the properties individually.
+	 *
+	 * @param Module $module
+	 * @param array|null $data Configuration data [key=value], or omit/null if you want it to retrieve the config data for you.
+	 * @param array|null $extraData Additional runtime configuration data to merge (default=null) 3.0.169+
+	 * @return bool True if configured, false if not configurable
+	 *
+	 */
+	public function setModuleConfigData(Module $module, $data = null, $extraData = null) {
+
+		$configurable = $this->isConfigable($module);
+		if(!$configurable) return false;
+		
+		if(!is_array($data)) $data = $this->getConfig($module);
+		if(is_array($extraData)) $data = array_merge($data, $extraData);
+
+		$nsClassName = $module->className(true);
+		$moduleName = $module->className(false);
+
+		if(is_string($configurable) && is_file($configurable) && strpos(basename($configurable), $moduleName) === 0) {
+			// get defaults from ModuleConfig class if available
+			$className = $nsClassName . 'Config';
+			$config = null; // may be overridden by included file
+			// $compile = strrpos($className, '\\') < 1 && $this->wire('config')->moduleCompile;
+			$configFile = '';
+
+			if(!class_exists($className, false)) {
+				$configFile = $this->modules->files->compile($className, $configurable);
+				// $configFile = $compile ? $this->wire('files')->compile($configurable) : $configurable;
+				if($configFile) {
+					/** @noinspection PhpIncludeInspection */
+					include_once($configFile);
+				}
+			}
+
+			if(wireClassExists($className)) {
+				$parents = wireClassParents($className, false);
+				if(is_array($parents) && in_array('ModuleConfig', $parents)) {
+					$moduleConfig = $this->wire(new $className());
+					if($moduleConfig instanceof ModuleConfig) {
+						$defaults = $moduleConfig->getDefaults();
+						$data = array_merge($defaults, $data);
+					}
+				}
+			} else {
+				// the file may have already been include_once before, so $config would not be set
+				// so we try a regular include() next. 
+				if(is_null($config)) {
+					if(!$configFile) {
+						$configFile = $this->modules->files->compile($className, $configurable);
+						// $configFile = $compile ? $this->wire('files')->compile($configurable) : $configurable;
+					}
+					if($configFile) {
+						/** @noinspection PhpIncludeInspection */
+						include($configFile);
+					}
+				}
+				if(is_array($config)) {
+					// alternatively, file may just specify a $config array
+					/** @var ModuleConfig $moduleConfig */
+					$moduleConfig = $this->wire(new ModuleConfig());
+					$moduleConfig->add($config);
+					$defaults = $moduleConfig->getDefaults();
+					$data = array_merge($defaults, $data);
+				}
+			}
+		}
+
+		if(method_exists($module, 'setConfigData') || method_exists($module, '___setConfigData')) {
+			/** @var _Module $module */
+			$module->setConfigData($data);
+			return true;
+		}
+
+		foreach($data as $key => $value) {
+			$module->$key = $value;
+		}
+
+		return true;
+	}
+
+	/**
+	 * Save provided configuration data for the given module
+	 *
+	 * - Applicable only for modules that support configuration.
+	 * - Configuration data is stored encoded in the database "modules" table "data" field.
+	 *
+	 * ~~~~~~
+	 * // Getting, modifying and saving module config data
+	 * $data = $modules->getConfig('HelloWorld');
+	 * $data['greeting'] = 'Hello World! How are you today?';
+	 * $modules->saveConfig('HelloWorld', $data);
+	 * ~~~~~~
+	 *
+	 * #pw-group-configuration
+	 * #pw-group-manipulation
+	 * #pw-changelog 3.0.16 Changed name from the more verbose saveModuleConfigData(), which will still work.
+	 *
+	 * @param string|Module $class Module or module name
+	 * @param array|string $data Associative array of configuration data, or name of property you want to save.
+	 * @param mixed|null $value If you specified a property in previous arg, the value for the property.
+	 * @return bool True on success, false on failure
+	 * @throws WireException
+	 * @see Modules::getConfig()
+	 * @since 3.0.16 Use method saveModuleConfigData() with same arguments for prior versions (can also be used on any version).
+	 *
+	 */
+	public function saveConfig($class, $data, $value = null) {
+		
+		$className = $class;
+		if(is_object($className)) $className = $className->className();
+		
+		$moduleName = wireClassName($className, false);
+		$id = $this->moduleID($moduleName);
+		
+		if(!$id) throw new WireException("Unable to find ID for Module '$moduleName'");
+
+		if(is_string($data)) {
+			// a property and value have been provided
+			$property = $data;
+			$data = $this->getConfig($class);
+			if(is_null($value)) {
+				// remove the property
+				unset($data[$property]);
+			} else {
+				// populate the value for the property
+				$data[$property] = $value;
+			}
+		} else {
+			// data must be an associative array of configuration data
+			if(!is_array($data)) return false;
+		}
+
+		// ensure original duplicates info is retained and validate that it is still current
+		$data = $this->modules->duplicates()->getDuplicatesConfigData($moduleName, $data);
+
+		$this->configData[$id] = $data;
+		$json = count($data) ? wireEncodeJSON($data, true) : '';
+		$database = $this->wire()->database;
+		$query = $database->prepare("UPDATE modules SET data=:data WHERE id=:id", "modules.saveConfig($moduleName)"); // QA
+		$query->bindValue(":data", $json, \PDO::PARAM_STR);
+		$query->bindValue(":id", (int) $id, \PDO::PARAM_INT);
+		$result = $query->execute();
+		// $this->log("Saved module '$moduleName' config data");
+
+		return $result;
+	}
+
+	/**
+	 * Get the Inputfields that configure the given module or return null if not configurable
+	 *
+	 * #pw-internal
+	 *
+	 * @param string|Module|int $moduleName
+	 * @param InputfieldWrapper|null $form Optionally specify the form you want Inputfields appended to.
+	 * @return InputfieldWrapper|null
+	 *
+	 */
+	public function getModuleConfigInputfields($moduleName, ?InputfieldWrapper $form = null) {
+
+		$moduleName = $this->modules->getModuleClass($moduleName);
+		$configurable = $this->isConfigurable($moduleName);
+		
+		if(!$configurable) return null;
+
+		/** @var InputfieldWrapper $form */
+		if(is_null($form)) $form = $this->wire(new InputfieldWrapper());
+		
+		$data = $this->getConfig($moduleName);
+		$fields = null;
+
+		// check for configurable module interface
+		$configurableInterface = $this->isConfigurable($moduleName, "interface");
+		if($configurableInterface) {
+			if(is_int($configurableInterface) && $configurableInterface > 1 && $configurableInterface < 20) {
+				// non-static 
+				/** @var ConfigurableModule|Module|_Module $module */
+				if($configurableInterface === 2) {
+					// requires no arguments
+					$module = $this->modules->getModule($moduleName);
+					$fields = $module->getModuleConfigInputfields();
+				} else if($configurableInterface === 3) {
+					// requires $data array
+					$module = $this->modules->getModule($moduleName, array('noInit' => true, 'noCache' => true));
+					$this->setModuleConfigData($module);
+					$fields = $module->getModuleConfigInputfields($data);
+				} else if($configurableInterface === 4) {
+					// requires InputfieldWrapper
+					// we allow for option of no return statement in the method
+					$module = $this->modules->getModule($moduleName);
+					$fields = $this->wire(new InputfieldWrapper()); /** @var InputfieldWrapper $fields */
+					$fields->setParent($form);
+					$_fields = $module->getModuleConfigInputfields($fields);
+					if($_fields instanceof InputfieldWrapper) $fields = $_fields;
+					unset($_fields);
+				} else if($configurableInterface === 19) {
+					// non-static getModuleConfigArray method
+					$module = $this->modules->getModule($moduleName);
+					$fields = $this->wire(new InputfieldWrapper()); /** @var InputfieldWrapper $fields */
+					$fields->importArray($module->getModuleConfigArray());
+					$fields->populateValues($module);
+				}
+			} else if($configurableInterface === 20) {
+				// static getModuleConfigArray method
+				$fields = $this->wire(new InputfieldWrapper()); /** @var InputfieldWrapper $fields */
+				$fields->importArray(call_user_func(array(wireClassName($moduleName, true), 'getModuleConfigArray')));
+				$fields->populateValues($data);
+			} else {
+				// static getModuleConfigInputfields method
+				$nsClassName = $this->modules->info->getModuleNamespace($moduleName) . $moduleName;
+				$fields = call_user_func(array($nsClassName, 'getModuleConfigInputfields'), $data);
+			}
+			if($fields instanceof InputfieldWrapper) {
+				foreach($fields as $field) {
+					$form->append($field);
+				}
+			} else if($fields instanceof Inputfield) {
+				$form->append($fields);
+			} else {
+				$this->error("$moduleName.getModuleConfigInputfields() did not return InputfieldWrapper");
+			}
+		}
+
+		// check for file-based config
+		$file = $this->isConfigurable($moduleName, "file");
+		if(!$file || !is_string($file) || !is_file($file)) {
+			// config is not file-based
+		} else {
+			// file-based config
+			$config = null;
+			$ns = $this->modules->info->getModuleNamespace($moduleName);
+			$configClass = $ns . $moduleName . "Config";
+			if(!class_exists($configClass)) {
+				$configFile = $this->modules->files->compile($moduleName, $file, $ns);
+				if($configFile) {
+					/** @noinspection PhpIncludeInspection */
+					include_once($configFile);
+				}
+			}
+			$configModule = null;
+
+			if(wireClassExists($configClass)) {
+				// file contains a ModuleNameConfig class
+				$configModule = $this->wire(new $configClass());
+
+			} else {
+				if(is_null($config)) {
+					$configFile = $this->modules->files->compile($moduleName, $file, $ns);
+					if($configFile) {
+						/** @noinspection PhpIncludeInspection */
+						include($configFile); // in case of previous include_once 
+					}
+				}
+				if(is_array($config)) {
+					// file contains a $config array
+					$configModule = $this->wire(new ModuleConfig());
+					$configModule->add($config);
+				}
+			}
+
+			if($configModule instanceof ModuleConfig) {
+				$defaults = $configModule->getDefaults();
+				$data = array_merge($defaults, $data);
+				$configModule->setArray($data);
+				$fields = $configModule->getInputfields();
+				if($fields instanceof InputfieldWrapper) {
+					foreach($fields as $field) {
+						$form->append($field);
+					}
+					foreach($data as $key => $value) {
+						$f = $form->getChildByName($key);
+						if(!$f) continue;
+						if($f instanceof InputfieldCheckbox && $value) {
+							$f->attr('checked', 'checked');
+						} else {
+							$f->attr('value', $value);
+						}
+					}
+				} else {
+					$this->error("$configModule.getInputfields() did not return InputfieldWrapper");
+				}
+			}
+		} // file-based config
+
+		if($form) {
+			// determine how many visible Inputfields there are in the module configuration
+			// for assignment or removal of flagsNoUserConfig flag when applicable
+			$numVisible = 0;
+			foreach($form->getAll() as $inputfield) {
+				if($inputfield instanceof InputfieldHidden || $inputfield instanceof InputfieldWrapper) continue;
+				$numVisible++;
+			}
+			$flags = $this->modules->flags->getFlags($moduleName);
+			if($numVisible) {
+				if($flags & Modules::flagsNoUserConfig) {
+					$info = $this->modules->info->getModuleInfoVerbose($moduleName);
+					if(empty($info['addFlag']) || !($info['addFlag'] & Modules::flagsNoUserConfig)) {
+						$this->modules->flags->setFlag($moduleName, Modules::flagsNoUserConfig, false); // remove flag
+					}
+				}
+			} else {
+				if(!($flags & Modules::flagsNoUserConfig)) {
+					if(empty($info['removeFlag']) || !($info['removeFlag'] & Modules::flagsNoUserConfig)) {
+						$this->modules->flags->setFlag($moduleName, Modules::flagsNoUserConfig, true); // add flag
+					}
+				}
+			}
+		}
+
+		return $form;
+	}
+
+	public function getDebugData() {
+		return array(
+			'configData' => $this->configData
+		);
+	}
+
+}

wire/core/ModulesDuplicates.php

@@ -6,7 +6,7 @@
  * Provides functions for managing sitautions where more than one
  * copy of the same module is intalled. This is a helper for the Modules class.
  *
- * ProcessWire 3.x, Copyright 2016 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  *
  */
@@ -40,6 +40,7 @@ class ModulesDuplicates extends Wire {
 	 *
 	 */
 	protected $numNewDuplicates = 0;
+	
 
 	/**
 	 * Return quantity of new duplicates found while loading modules
@@ -73,7 +74,7 @@ class ModulesDuplicates extends Wire {
 	public function hasDuplicate($className, $pathname = '') {
 		if(!isset($this->duplicates[$className])) return false;
 		if($pathname) {
-			$rootPath = $this->wire('config')->paths->root;
+			$rootPath = $this->wire()->config->paths->root;
 			if(strpos($pathname, $rootPath) === 0) $pathname = str_replace($rootPath, '/', $pathname);
 			return in_array($pathname, $this->duplicates[$className]);
 		}
@@ -90,7 +91,7 @@ class ModulesDuplicates extends Wire {
 	 */
 	public function addDuplicate($className, $pathname, $current = false) {
 		if(!isset($this->duplicates[$className])) $this->duplicates[$className] = array();
-		$rootPath = $this->wire('config')->paths->root;
+		$rootPath = $this->wire()->config->paths->root;
 		if(strpos($pathname, $rootPath) === 0) $pathname = str_replace($rootPath, '/', $pathname);
 		if(!in_array($pathname, $this->duplicates[$className])) {
 			$this->duplicates[$className][] = $pathname;
@@ -153,11 +154,12 @@ class ModulesDuplicates extends Wire {
 	public function getDuplicates($className = '') {
 
 		if(!$className) return $this->duplicates;
-
-		$className = $this->wire('modules')->getModuleClass($className);
+		
+		$modules = $this->wire()->modules;
+		$className = $modules->getModuleClass($className);
 		$files = isset($this->duplicates[$className]) ? $this->duplicates[$className] : array();
 		$using = isset($this->duplicatesUse[$className]) ? $this->duplicatesUse[$className] : '';
-		$rootPath = $this->wire('config')->paths->root;
+		$rootPath = $this->wire()->config->paths->root;
 
 		foreach($files as $key => $file) {
 			$file = rtrim($rootPath, '/') . $file;
@@ -167,7 +169,7 @@ class ModulesDuplicates extends Wire {
 		}
 
 		if(count($files) > 1 && !$using) {
-			$using = $this->wire('modules')->getModuleFile($className);
+			$using = $modules->getModuleFile($className);
 			$using = str_replace($rootPath, '/', $using);
 		}
 
@@ -191,8 +193,9 @@ class ModulesDuplicates extends Wire {
 	 *
 	 */
 	public function setUseDuplicate($className, $pathname) {
-		$className = $this->wire('modules')->getModuleClass($className);
-		$rootPath = $this->wire('config')->paths->root;
+		$modules = $this->wire()->modules;
+		$className = $modules->getModuleClass($className);
+		$rootPath = $this->wire()->config->paths->root;
 		if(!isset($this->duplicates[$className])) {
 			throw new WireException("Module $className does not have duplicates");
 		}
@@ -204,9 +207,9 @@ class ModulesDuplicates extends Wire {
 			throw new WireException("Duplicate module file does not exist: $pathname");
 		}
 		$this->duplicatesUse[$className] = $pathname;
-		$configData = $this->wire('modules')->getModuleConfigData($className);
+		$configData = $modules->getModuleConfigData($className);
 		$configData['-dups-use'] = $pathname;
-		$this->wire('modules')->saveModuleConfigData($className, $configData);
+		$modules->saveModuleConfigData($className, $configData);
 	}
 
 	/**
@@ -214,8 +217,9 @@ class ModulesDuplicates extends Wire {
 	 *
 	 */
 	public function updateDuplicates() {
-
-		$rootPath = $this->wire('config')->paths->root;
+		
+		$modules = $this->wire()->modules;
+		$rootPath = $this->wire()->config->paths->root;
 
 		// store duplicate information in each module's data field
 		foreach($this->getDuplicates() as $moduleName => $files) {
@@ -228,7 +232,7 @@ class ModulesDuplicates extends Wire {
 				$files[$key] = $file;
 			}
 			$files = array_unique($files);
-			$configData = $this->wire('modules')->getModuleConfigData($moduleName);
+			$configData = $modules->getModuleConfigData($moduleName);
 			if((empty($configData['-dups']) && !empty($files))
 				|| (empty($configData['-dups-use']) || $configData['-dups-use'] != $using)
 				|| (isset($configData['-dups']) && implode(' ', $configData['-dups']) != implode(' ', $files))
@@ -237,13 +241,13 @@ class ModulesDuplicates extends Wire {
 				$this->duplicatesUse[$moduleName] = $using;
 				$configData['-dups'] = $files;
 				$configData['-dups-use'] = $using;
-				$this->wire('modules')->saveModuleConfigData($moduleName, $configData);
+				$modules->saveModuleConfigData($moduleName, $configData);
 			}
 		}
 
 		// update any modules that no longer have duplicates
 		$removals = array();
-		$query = $this->wire('database')->prepare("SELECT `class`, `flags` FROM modules WHERE `flags` & :flag");
+		$query = $this->wire()->database->prepare("SELECT `class`, `flags` FROM modules WHERE `flags` & :flag");
 		$query->bindValue(':flag', Modules::flagsDuplicate, \PDO::PARAM_INT);
 		$query->execute();
 
@@ -258,10 +262,10 @@ class ModulesDuplicates extends Wire {
 		}
 
 		foreach($removals as $class => $flags) {
-			$this->wire('modules')->setFlags($class, $flags); 
-			$configData = $this->wire('modules')->getModuleConfigData($class);
+			$modules->setFlags($class, $flags); 
+			$configData = $modules->getModuleConfigData($class);
 			unset($configData['-dups'], $configData['-dups-use']);
-			$this->wire('modules')->saveModuleConfigData($class, $configData);
+			$modules->saveModuleConfigData($class, $configData);
 		}
 	}
 
@@ -275,7 +279,9 @@ class ModulesDuplicates extends Wire {
 	 *
 	 */
 	public function recordDuplicate($basename, $pathname, $pathname2, &$installed) {
-		$rootPath = $this->wire('config')->paths->root;
+		$config = $this->wire()->config;
+		$modules = $this->wire()->modules;
+		$rootPath = $config->paths->root;
 		// ensure paths start from root of PW install
 		if(strpos($pathname, $rootPath) === 0) $pathname = str_replace($rootPath, '/', $pathname);
 		if(strpos($pathname2, $rootPath) === 0) $pathname2 = str_replace($rootPath, '/', $pathname2);
@@ -295,7 +301,7 @@ class ModulesDuplicates extends Wire {
 		if(isset($installed[$basename]['flags'])) {
 			$flags = $installed[$basename]['flags'];
 		} else {
-			$flags = $this->wire('modules')->getFlags($basename);
+			$flags = $modules->getFlags($basename);
 		}
 		if($flags & Modules::flagsDuplicate) {
 			// flags already represent duplicate status
@@ -303,14 +309,14 @@ class ModulesDuplicates extends Wire {
 			// make database aware this module has multiple files by adding the duplicate flag
 			$this->numNewDuplicates++; // trigger update needed
 			$flags = $flags | Modules::flagsDuplicate;
-			$this->wire('modules')->setFlags($basename, $flags); 
+			$modules->setFlags($basename, $flags); 
 		}
 		$err = sprintf($this->_('There appear to be multiple copies of module "%s" on the file system.'), $basename) . ' ';
-		$this->wire('log')->save('modules', $err);
-		$user = $this->wire('user');
+		$this->wire()->log->save('modules', $err);
+		$user = $this->wire()->user;
 		if($user && $user->isSuperuser()) {
 			$err .= $this->_('Please edit the module settings to tell ProcessWire which one to use:') . ' ' .
-				"<a href='" . $this->wire('config')->urls->admin . 'module/edit?name=' . $basename . "'>$basename</a>";
+				"<a href='" . $config->urls->admin . 'module/edit?name=' . $basename . "'>$basename</a>";
 			$this->warning($err, Notice::allowMarkup);
 		}
 		//$this->message("recordDuplicate($basename, $pathname) $this->numNewDuplicates"); //DEBUG
@@ -327,10 +333,11 @@ class ModulesDuplicates extends Wire {
 	 *
 	 */
 	public function getDuplicatesConfigData($className, array $configData = array()) {
+		$config = $this->wire()->config;
 		// ensure original duplicates info is retained and validate that it is still current
 		if(isset($this->duplicates[$className])) {
 			foreach($this->duplicates[$className] as $key => $file) {
-				$pathname = rtrim($this->wire('config')->paths->root, '/') . $file;
+				$pathname = rtrim($config->paths->root, '/') . $file;
 				if(!file_exists($pathname)) {
 					unset($this->duplicates[$className][$key]);
 				}
@@ -341,7 +348,7 @@ class ModulesDuplicates extends Wire {
 			} else {
 				$configData['-dups'] = $this->duplicates[$className];
 				if(isset($this->duplicatesUse[$className])) {
-					$pathname = rtrim($this->wire('config')->paths->root, '/') . $this->duplicatesUse[$className];
+					$pathname = rtrim($config->paths->root, '/') . $this->duplicatesUse[$className];
 					if(file_exists($pathname)) {
 						$configData['-dups-use'] = $this->duplicatesUse[$className];
 					} else {
@@ -354,4 +361,11 @@ class ModulesDuplicates extends Wire {
 		}
 		return $configData;
 	}
+	
+	public function getDebugData() {
+		return array(
+			'duplicates' => $this->duplicates,
+			'duplicatesUse' => $this->duplicatesUse
+		);
+	}
 }

wire/core/ModulesFiles.php

@@ -0,0 +1,669 @@
+<?php namespace ProcessWire;
+
+/**
+ * ProcessWire Modules: Files
+ *
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
+ * https://processwire.com
+ *
+ */
+
+class ModulesFiles extends ModulesClass {
+	
+	/**
+	 * Core module types that are isolated by directory
+	 *
+	 * @var array
+	 *
+	 */
+	protected $coreTypes = array(
+		'AdminTheme',
+		'Fieldtype',
+		'Inputfield',
+		'Jquery',
+		'LanguageSupport',
+		'Markup',
+		'Process',
+		'Session',
+		'System',
+		'Textformatter',
+	);
+	
+	/**
+	 * Module file extensions indexed by module name where value 1=.module, and 2=.module.php
+	 *
+	 * @var array
+	 *
+	 */
+	protected $moduleFileExts = array();
+
+	/**
+	 * Get or set module file extension type (1 or 2)
+	 * 
+	 * @param string $class Module class name
+	 * @param int $setValue 1 for '.module' or 2 for '.module.php', or omit to get current value
+	 * @return int
+	 * 
+	 */
+	public function moduleFileExt($class, $setValue = null) {
+		if($setValue !== null) {
+			$this->moduleFileExts[$class] = (int) $setValue;
+			return $setValue;
+		}
+		return isset($this->moduleFileExts[$class]) ? $this->moduleFileExts[$class] : 0;
+	}
+
+	/**
+	 * Find new module files in the given $path
+	 *
+	 * If $readCache is true, this will perform the find from the cache
+	 *
+	 * @param string $path Path to the modules
+	 * @param bool $readCache Optional. If set to true, then this method will attempt to read modules from the cache.
+	 * @param int $level For internal recursive use.
+	 * @return array Array of module files
+	 *
+	 */
+	public function findModuleFiles($path, $readCache = false, $level = 0) {
+
+		static $startPath;
+		static $prependFiles = array();
+
+		$config = $this->wire()->config;
+		$cacheName = '';
+
+		if($level == 0) {
+			$startPath = $path;
+			$cacheName = "Modules." . str_replace($config->paths->root, '', $path);
+			if($readCache) {
+				$cacheContents = $this->modules->getCache($cacheName);
+				if($cacheContents) return explode("\n", trim($cacheContents));
+			}
+		}
+
+		$files = array();
+		$autoloadOrders = $this->modules->loader->getAutoloadOrders();
+
+		if(count($autoloadOrders) && $path !== $config->paths->modules) {
+			// ok
+		} else {
+			$autoloadOrders = null;
+		}
+
+		try {
+			$dir = new \DirectoryIterator($path);
+		} catch(\Exception $e) {
+			$this->trackException($e, false, true);
+			$dir = null;
+		}
+
+		if($dir) foreach($dir as $file) {
+
+			if($file->isDot()) continue;
+
+			$filename = $file->getFilename();
+			$pathname = $file->getPathname();
+
+			if(DIRECTORY_SEPARATOR != '/') {
+				$pathname = str_replace(DIRECTORY_SEPARATOR, '/', $pathname);
+			}
+
+			if(strpos($pathname, '/.') !== false) {
+				$pos = strrpos(rtrim($pathname, '/'), '/');
+				if($pathname[$pos+1] == '.') continue; // skip hidden files and dirs
+			}
+
+			// if it's a directory with a .module file in it named the same as the dir, then descend into it
+			if($file->isDir() && ($level < 1 || (is_file("$pathname/$filename.module") || is_file("$pathname/$filename.module.php")))) {
+				$files = array_merge($files, $this->findModuleFiles($pathname, false, $level + 1));
+			}
+
+			// if the filename doesn't end with .module or .module.php, then stop and move onto the next
+			$extension = $file->getExtension();
+			if($extension !== 'module' && $extension !== 'php') continue;
+			list($moduleName, $extension) = explode('.', $filename, 2);
+			if($extension !== 'module'  && $extension !== 'module.php') continue;
+
+			$pathname = str_replace($startPath, '', $pathname);
+
+			if($autoloadOrders !== null && isset($autoloadOrders[$moduleName])) {
+				$prependFiles[$pathname] = $autoloadOrders[$moduleName];
+			} else {
+				$files[] = $pathname;
+			}
+		}
+
+		if($level == 0 && $dir !== null) {
+			if(!empty($prependFiles)) {
+				// one or more non-core modules must be loaded first in a specific order
+				arsort($prependFiles);
+				$files = array_merge(array_keys($prependFiles), $files);
+				$prependFiles = array();
+			}
+			if($cacheName) {
+				$this->modules->saveCache($cacheName, implode("\n", $files));
+			}
+		}
+
+		return $files;
+	}
+	
+	/**
+	 * Get the path + filename (or optionally URL) for module
+	 *
+	 * @param string|Module $class Module class name or object instance
+	 * @param array|bool $options Options to modify default behavior:
+	 * 	- `getURL` (bool): Specify true if you want to get the URL rather than file path (default=false).
+	 * 	- `fast` (bool): Specify true to omit file_exists() checks (default=false).
+	 *  - `guess` (bool): Manufacture/guess a module location if one cannot be found (default=false) 3.0.170+
+	 * 	- Note: If you specify a boolean for the $options argument, it is assumed to be the $getURL property.
+	 * @return bool|string Returns string of module file, or false on failure.
+	 *
+	 */
+	public function getModuleFile($class, $options = array()) {
+
+		$config = $this->wire()->config;
+		$className = $class;
+		
+		if(is_bool($options)) $options = array('getURL' => $options);
+		if(!isset($options['getURL'])) $options['getURL'] = false;
+		if(!isset($options['fast'])) $options['fast'] = false;
+
+		$file = false;
+
+		// first see it's an object, and if we can get the file from the object
+		if(is_object($className)) {
+			$module = $className;
+			if($module instanceof ModulePlaceholder) $file = $module->file;
+			$moduleName = $module->className();
+			$className = $module->className(true);
+		} else {
+			$moduleName = wireClassName($className, false);
+		}
+
+		$hasDuplicate = $this->modules->duplicates()->hasDuplicate($moduleName);
+
+		if(!$hasDuplicate) {
+			// see if we can determine it from already stored paths
+			$path = $config->paths($moduleName);
+			if($path) {
+				$file = $path . $moduleName . ($this->moduleFileExt($moduleName) === 2 ? '.module.php' : '.module');
+				if(!$options['fast'] && !file_exists($file)) $file = false;
+			}
+		}
+
+		// next see if we've already got the module filename cached locally
+		if(!$file) { 
+			$installableFile = $this->modules->installableFile($moduleName);
+			if($installableFile && !$hasDuplicate) {
+				$file = $installableFile;
+				if(!$options['fast'] && !file_exists($file)) $file = false;
+			}
+		}
+
+		if(!$file) {
+			$dupFile = $this->modules->duplicates()->getCurrent($moduleName);
+			if($dupFile) {
+				$rootPath = $config->paths->root;
+				$file = rtrim($rootPath, '/') . $dupFile;
+				if(!file_exists($file)) {
+					// module in use may have been deleted, find the next available one that exists
+					$file = '';
+					$dups = $this->modules->duplicates()->getDuplicates($moduleName);
+					foreach($dups['files'] as $pathname) {
+						$pathname = rtrim($rootPath, '/') . $pathname;
+						if(file_exists($pathname)) $file = $pathname;
+						if($file) break;
+					}
+				}
+			}
+		}
+
+		if(!$file) {
+			// see if it's a predefined core type that can be determined from the type
+			// this should only come into play if module has moved or had a load error
+			foreach($this->coreTypes as $typeName) {
+				if(strpos($moduleName, $typeName) !== 0) continue;
+				$checkFiles = array(
+					"$typeName/$moduleName/$moduleName.module",
+					"$typeName/$moduleName/$moduleName.module.php",
+					"$typeName/$moduleName.module",
+					"$typeName/$moduleName.module.php",
+				);
+				$path1 = $config->paths->modules;
+				foreach($checkFiles as $checkFile) {
+					$file1 = $path1 . $checkFile;
+					if(file_exists($file1)) $file = $file1;
+					if($file) break;
+				}
+				if($file) break;
+			}
+			if(!$file) {
+				// check site modules
+				$checkFiles = array(
+					"$moduleName/$moduleName.module",
+					"$moduleName/$moduleName.module.php",
+					"$moduleName.module",
+					"$moduleName.module.php",
+				);
+				$path1 = $config->paths->siteModules;
+				foreach($checkFiles as $checkFile) {
+					$file1 = $path1 . $checkFile;
+					if(file_exists($file1)) $file = $file1;
+					if($file) break;
+				}
+			}
+		}
+
+		if(!$file) {
+			// if all the above failed, try to get it from Reflection
+			try {
+				// note we don't call getModuleClass() here because it may result in a circular reference
+				if(strpos($className, "\\") === false) {
+					$moduleID = $this->moduleID($moduleName);
+					$namespace = $this->modules->info->moduleInfoCache($moduleID, 'namespace');
+					if(!empty($namespace)) {
+						$className = rtrim($namespace, "\\") . "\\$moduleName";
+					} else {
+						$className = strlen(__NAMESPACE__) ? "\\" . __NAMESPACE__ . "\\$moduleName" : $moduleName;
+					}
+				}
+				$reflector = new \ReflectionClass($className);
+				$file = $reflector->getFileName();
+
+			} catch(\Exception $e) {
+				$file = false;
+			}
+		}
+
+		if(!$file && !empty($options['guess'])) {
+			// make a guess about where module would be if we had been able to find it
+			$file = $config->paths('siteModules') . "$moduleName/$moduleName.module";
+		}
+
+		if($file) {
+			if(DIRECTORY_SEPARATOR != '/') $file = str_replace(DIRECTORY_SEPARATOR, '/', $file);
+			if($options['getURL']) $file = str_replace($config->paths->root, '/', $file);
+		}
+
+		return $file;
+	}
+
+	/**
+	 * Include the given filename
+	 *
+	 * @param string $file
+	 * @param string $moduleName
+	 * @return bool
+	 *
+	 */
+	public function includeModuleFile($file, $moduleName) {
+
+		$wire1 = ProcessWire::getCurrentInstance();
+		$wire2 = $this->wire();
+
+		// check if there is more than one PW instance active
+		if($wire1 !== $wire2) {
+			// multi-instance is active, don't autoload module if class already exists
+			// first do a fast check, which should catch any core modules 
+			if(class_exists(__NAMESPACE__ . "\\$moduleName", false)) return true;
+			// next do a slower check, figuring out namespace
+			$ns = $this->modules->info->getModuleNamespace($moduleName, array('file' => $file));
+			if($ns === null) {
+				// unable to determine module namespace, likely file does not exist
+				$ns = (string) $ns;
+			}
+			$className = trim($ns, "\\") . "\\$moduleName";
+			if(class_exists($className, false)) return true;
+			// if this point is reached, module is not yet in memory in either instance
+			// temporarily set the $wire instance to 2nd instance during include()
+			ProcessWire::setCurrentInstance($wire2);
+		}
+
+		// get compiled version (if it needs compilation)
+		$file = $this->compile($moduleName, $file);
+
+		if($file) {
+			/** @noinspection PhpIncludeInspection */
+			$success = @include_once($file);
+		} else {
+			$success = false;
+		}
+		
+		if(!$success) {
+			// handle case where module has moved from /modules/Foo.module to /modules/Foo/Foo.module
+			// which can only occur during upgrades from much older versions. 
+			// examples are FieldtypeImage and FieldtypeText which moved to their own directories.
+			$file2 = preg_replace('!([/\\\\])([^/\\\\]+)(\.module(?:\.php)?)$!', '$1$2$1$2$3', $file);
+			if($file !== $file2) $success = @include_once($file2);
+		}
+
+		// set instance back, if multi-instance
+		if($wire1 !== $wire2) ProcessWire::setCurrentInstance($wire1);
+
+		return (bool) $success;
+	}
+	
+	/**
+	 * Compile and return the given file for module, if allowed to do so
+	 *
+	 * @param Module|string $moduleName
+	 * @param string $file Optionally specify the module filename as an optimization
+	 * @param string|null $namespace Optionally specify namespace as an optimization
+	 * @return string|bool
+	 *
+	 */
+	public function compile($moduleName, $file = '', $namespace = null) {
+
+		static $allowCompile = null;
+		
+		if($allowCompile === null) $allowCompile = $this->wire()->config->moduleCompile;
+
+		// if not given a file, track it down
+		if(empty($file)) $file = $this->modules->getModuleFile($moduleName);
+
+		// don't compile when module compilation is disabled
+		if(!$allowCompile) return $file;
+
+		// don't compile core modules
+		if(strpos($file, $this->modules->coreModulesDir) !== false) return $file;
+
+		// if namespace not provided, get it
+		if(is_null($namespace)) {
+			if(is_object($moduleName)) {
+				$className = $moduleName->className(true);
+				$namespace = wireClassName($className, 1);
+			} else if(is_string($moduleName) && strpos($moduleName, "\\") !== false) {
+				$namespace = wireClassName($moduleName, 1);
+			} else {
+				$namespace = $this->modules->info->getModuleNamespace($moduleName, array('file' => $file));
+			}
+		}
+
+		// determine if compiler should be used
+		if(__NAMESPACE__) {
+			$compile = $namespace === '\\' || empty($namespace);
+		} else {
+			$compile = trim($namespace, '\\') === 'ProcessWire';
+		}
+
+		// compile if necessary
+		if($compile) {
+			/** @var FileCompiler $compiler */
+			$compiler = $this->wire(new FileCompiler(dirname($file)));
+			$compiledFile = $compiler->compile(basename($file));
+			if($compiledFile) $file = $compiledFile;
+		}
+
+		return $file;
+	}
+
+	/**
+	 * Find modules that are missing their module file on the file system
+	 *
+	 * Return value is array:
+	 * ~~~~~
+	 * [
+	 *   'ModuleName' => [
+	 *     'id' => 123,
+	 *     'name' => 'ModuleName',
+	 *     'file' => '/path/to/expected/file.module'
+	 *   ],
+	 *   'ModuleName' => [
+	 *     ...
+	 *   ]
+	 * ];
+	 * ~~~~~
+	 *
+	 * #pw-internal
+	 *
+	 * @return array
+	 * @since 3.0.170
+	 *
+	 */
+	public function findMissingModules() {
+
+		$missing = array();
+		$unflags = array();
+
+		$sql = "SELECT id, class FROM modules WHERE flags & :flagsNoFile ORDER BY class";
+		$query = $this->wire()->database->prepare($sql);
+		$query->bindValue(':flagsNoFile', Modules::flagsNoFile, \PDO::PARAM_INT);
+		$query->execute();
+
+		while($row = $query->fetch(\PDO::FETCH_ASSOC)) {
+
+			$class = $row['class'];
+			if(strpos($class, '.') === 0) continue;
+
+			$file = $this->getModuleFile($class, array('fast' => true));
+
+			if($file && file_exists($file)) {
+				$unflags[] = $class;
+				continue;
+			}
+
+			$fileAlt = $this->getModuleFile($class, array('fast' => false));
+
+			if($fileAlt) {
+				$file = $fileAlt;
+				if(file_exists($file)) continue;
+			}
+
+			if(!$file) {
+				$file = $this->getModuleFile($class, array('fast' => true, 'guess' => true));
+			}
+
+			$missing[$class] = array(
+				'id' => $row['id'],
+				'name' => $class,
+				'file' => $file,
+			);
+		}
+
+		foreach($unflags as $name) {
+			$this->modules->flags->setFlag($name, Modules::flagsNoFile, false);
+		}
+
+		return $missing;
+	}
+
+	/**
+	 * Load module related CSS and JS files (where applicable)
+	 *
+	 * - Applies only to modules that carry class-named CSS and/or JS files, such as Process, Inputfield and ModuleJS modules.
+	 * - Assets are populated to `$config->styles` and `$config->scripts`.
+	 *
+	 * #pw-internal
+	 *
+	 * @param Module|int|string $module Module object or class name
+	 * @return int Returns number of files that were added
+	 *
+	 */
+	public function loadModuleFileAssets($module) {
+
+		$class = $this->modules->getModuleClass($module);
+		static $classes = array();
+		if(isset($classes[$class])) return 0; // already loaded
+		$config = $this->wire()->config;
+		$path = $config->paths($class);
+		$url = $config->urls($class);
+		$debug = $config->debug;
+		$coreVersion = $config->version;
+		$moduleVersion = 0;
+		$cnt = 0;
+
+		foreach(array('styles' => 'css', 'scripts' => 'js') as $type => $ext) {
+			$fileURL = '';
+			$file = "$path$class.$ext";
+			$fileVersion = $coreVersion;
+			$minFile = "$path$class.min.$ext";
+			if(!$debug && is_file($minFile)) {
+				$fileURL = "$url$class.min.$ext";
+			} else if(is_file($file)) {
+				$fileURL = "$url$class.$ext";
+				if($debug) $fileVersion = filemtime($file);
+			}
+			if($fileURL) {
+				if(!$moduleVersion) {
+					$info = $this->modules->info->getModuleInfo($module, array('verbose' => false));
+					$moduleVersion = (int) isset($info['version']) ? $info['version'] : 0;
+				}
+				$config->$type->add("$fileURL?v=$moduleVersion-$fileVersion");
+				$cnt++;
+			}
+		}
+
+		$classes[$class] = true;
+
+		return $cnt;
+	}
+
+	/**
+	 * Get module language translation files
+	 *
+	 * @param Module|string $module
+	 * @return array Array of translation files including full path, indexed by basename without extension
+	 * @since 3.0.181
+	 *
+	 */
+	public function getModuleLanguageFiles($module) {
+
+		$module = $this->modules->getModuleClass($module);
+		if(empty($module)) return array();
+
+		$path = $this->wire()->config->paths($module);
+		if(empty($path)) return array();
+
+		$pathHidden = $path . '.languages/';
+		$pathVisible = $path . 'languages/';
+
+		if(is_dir($pathVisible)) {
+			$path = $pathVisible;
+		} else if(is_dir($pathHidden)) {
+			$path = $pathHidden;
+		} else {
+			return array();
+		}
+
+		$items = array();
+		$options = array(
+			'extensions' => array('csv'),
+			'recursive' => false,
+			'excludeHidden' => true,
+		);
+
+		foreach($this->wire()->files->find($path, $options) as $file) {
+			$basename = basename($file, '.csv');
+			$items[$basename] = $file;
+		}
+
+		return $items;
+	}
+
+	/**
+	 * Setup entries in config->urls and config->paths for the given module
+	 *
+	 * @param string $moduleName
+	 * @param string $path
+	 *
+	 */
+	public function setConfigPaths($moduleName, $path) {
+		$config = $this->wire()->config;
+		$rootPath = $config->paths->root;
+		if(strpos($path, $rootPath) === 0) {
+			// if root path included, strip it out
+			$path = substr($path, strlen($config->paths->root));
+		}
+		$path = rtrim($path, '/') . '/';
+		$config->paths->set($moduleName, $path);
+		$config->urls->set($moduleName, $path);
+	}
+
+	/**
+	 * Get the namespace used in the given .php or .module file
+	 *
+	 * #pw-internal
+	 *
+	 * @param string $file
+	 * @return string Includes leading and trailing backslashes where applicable
+	 *
+	 */
+	public function getFileNamespace($file) {
+		$namespace = $this->wire()->files->getNamespace($file);
+		if($namespace !== "\\") $namespace = "\\" . trim($namespace, "\\") . "\\";
+		return $namespace;
+	}
+	
+	/**
+	 * Get the class defined in the file (or optionally the 'extends' or 'implements')
+	 *
+	 * #pw-internal
+	 *
+	 * @param string $file
+	 * @return array Returns array with these indexes:
+	 * 	'class' => string (class without namespace)
+	 * 	'className' => string (class with namespace)
+	 * 	'extends' => string
+	 * 	'namespace' => string
+	 * 	'implements' => array
+	 *
+	 */
+	public function getFileClassInfo($file) {
+
+		$value = array(
+			'class' => '',
+			'className' => '',
+			'extends' => '',
+			'namespace' => '',
+			'implements' => array()
+		);
+
+		if(!is_file($file)) return $value;
+		$data = file_get_contents($file);
+		if(!strpos($data, 'class')) return $value;
+		if(!preg_match('/^\s*class\s+(.+)$/m', $data, $matches)) return $value;
+
+		if(strpos($matches[1], "\t") !== false) $matches[1] = str_replace("\t", " ", $matches[1]);
+		$parts = explode(' ', trim($matches[1]));
+
+		foreach($parts as $key => $part) {
+			if(empty($part)) unset($parts[$key]);
+		}
+
+		$className = array_shift($parts);
+		if(strpos($className, '\\') !== false) {
+			$className = trim($className, '\\');
+			$a = explode('\\', $className);
+			$value['className'] = "\\$className\\";
+			$value['class'] = array_pop($a);
+			$value['namespace'] = '\\' . implode('\\', $a) . '\\';
+		} else {
+			$value['className'] = '\\' . $className;
+			$value['class'] = $className;
+			$value['namespace'] = '\\';
+		}
+
+		while(count($parts)) {
+			$next = array_shift($parts);
+			if($next == 'extends') {
+				$value['extends'] = array_shift($parts);
+			} else if($next == 'implements') {
+				$implements = array_shift($parts);
+				if(strlen($implements)) {
+					$implements = str_replace(' ', '', $implements);
+					$value['implements'] = explode(',', $implements);
+				}
+			}
+		}
+
+		return $value;
+	}
+
+	public function getDebugData() {
+		return array(
+			'moduleFileExts' => $this->moduleFileExts
+		);
+	}
+
+}

wire/core/ModulesFlags.php

@@ -0,0 +1,200 @@
+<?php namespace ProcessWire;
+
+/**
+ * ProcessWire Modules: Flags
+ *
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
+ * https://processwire.com
+ *
+ */
+
+class ModulesFlags extends ModulesClass {
+	
+	/**
+	 * Array of module ID => flags (int)
+	 *
+	 * @var array
+	 *
+	 */
+	protected $moduleFlags = array();
+
+	/**
+	 * Get or set flags for module by module ID
+	 * 
+	 * Omit all arguments to get flags for all modules indexed by module ID.
+	 * 
+	 * Returns null if given module ID not found.
+	 * 
+	 * @param int $moduleID This method only accepts module ID
+	 * @param int $setValue Flag(s) to set
+	 * @return array|mixed|null
+	 * 
+	 */
+	public function moduleFlags($moduleID = null, $setValue = null) {
+		if($moduleID === null) return $this->moduleFlags;
+		if(!ctype_digit("$moduleID")) $moduleID = $this->moduleID($moduleID);
+		if($setValue !== null) {
+			$this->moduleFlags[(int) $moduleID] = (int) $setValue;
+		} else if(isset($this->moduleFlags[$moduleID])) {
+			return $this->moduleFlags[$moduleID];
+		}	
+		return null;
+	}
+	
+	/**
+	 * Get flags for the given module
+	 *
+	 * @param int|string|Module $id Module to add flag to
+	 * @return int|false Returns integer flags on success, or boolean false on fail
+	 *
+	 */
+	public function getFlags($id) {
+		$id = ctype_digit("$id") ? (int) $id : $this->modules->getModuleID($id);
+		if(isset($this->moduleFlags[$id])) return $this->moduleFlags[$id];
+		if(!$id) return false;
+		$query = $this->wire()->database->prepare('SELECT flags FROM modules WHERE id=:id');
+		$query->bindValue(':id', $id, \PDO::PARAM_INT);
+		$query->execute();
+		if(!$query->rowCount()) return false;
+		list($flags) = $query->fetch(\PDO::FETCH_NUM);
+		$flags = (int) $flags;
+		$this->moduleFlags[$id] = $flags;
+		return $flags;
+	}
+
+	/**
+	 * Does module have flag?
+	 *
+	 * #pw-internal
+	 *
+	 * @param int|string|Module $id Module ID, class name or instance
+	 * @param int $flag
+	 * @return bool
+	 * @since 3.0.170
+	 *
+	 */
+	public function hasFlag($id, $flag) {
+		$flags = $this->getFlags($id);
+		return $flags === false ? false : ($flags & $flag);
+	}
+
+	/**
+	 * Set module flags
+	 *
+	 * #pw-internal
+	 *
+	 * @param string|int $id Module id or class
+	 * @param $flags
+	 * @return bool
+	 *
+	 */
+	public function setFlags($id, $flags) {
+		$flags = (int) $flags;
+		$id = ctype_digit("$id") ? (int) $id : $this->modules->getModuleID($id);
+		if(!$id) return false;
+		if($this->moduleFlags[$id] === $flags) return true;
+		$query = $this->wire()->database->prepare('UPDATE modules SET flags=:flags WHERE id=:id');
+		$query->bindValue(':flags', $flags);
+		$query->bindValue(':id', $id);
+		if($this->debug) $this->message("setFlags(" . $this->modules->getModuleClass($id) . ", " . $this->moduleFlags[$id] . " => $flags)");
+		$this->moduleFlags[$id] = $flags;
+		return $query->execute();
+	}
+
+	/**
+	 * Add or remove a flag from a module
+	 *
+	 * #pw-internal
+	 *
+	 * @param $id int|string|Module $class Module to add flag to
+	 * @param $flag int Flag to add (see flags* constants)
+	 * @param $add bool $add Specify true to add the flag or false to remove it
+	 * @return bool True on success, false on fail
+	 *
+	 */
+	public function setFlag($id, $flag, $add = true) {
+		$id = ctype_digit("$id") ? (int) $id : $this->modules->getModuleID($id);
+		if(!$id) return false;
+		$flag = (int) $flag;
+		if(!$flag) return false;
+		$flags = $this->getFlags($id);
+		if($add) {
+			if($flags & $flag) return true; // already has the flag
+			$flags = $flags | $flag;
+		} else {
+			if(!($flags & $flag)) return true; // doesn't already have the flag
+			$flags = $flags & ~$flag;
+		}
+		$this->setFlags($id, $flags);
+		return true;
+	}
+	
+	/**
+	 * Update module flags if any happen to differ from what's in the given moduleInfo
+	 *
+	 * @param int $moduleID
+	 * @param array $info
+	 *
+	 */
+	public function updateModuleFlags($moduleID, array $info) {
+
+		$flags = (int) $this->getFlags($moduleID);
+
+		if($info['autoload']) {
+			// module is autoload
+			if(!($flags & Modules::flagsAutoload)) {
+				// add autoload flag
+				$this->setFlag($moduleID, Modules::flagsAutoload, true);
+			}
+			if(is_string($info['autoload'])) {
+				// requires conditional flag
+				// value is either: "function", or the conditional string (like key=value)
+				if(!($flags & Modules::flagsConditional)) $this->setFlag($moduleID, Modules::flagsConditional, true);
+			} else {
+				// should not have conditional flag
+				if($flags & Modules::flagsConditional) $this->setFlag($moduleID, Modules::flagsConditional, false);
+			}
+
+		} else if($info['autoload'] !== null) {
+			// module is not autoload
+			if($flags & Modules::flagsAutoload) {
+				// remove autoload flag
+				$this->setFlag($moduleID, Modules::flagsAutoload, false);
+			}
+			if($flags & Modules::flagsConditional) {
+				// remove conditional flag
+				$this->setFlag($moduleID, Modules::flagsConditional, false);
+			}
+		}
+
+		if($info['singular']) {
+			if(!($flags & Modules::flagsSingular)) $this->setFlag($moduleID, Modules::flagsSingular, true);
+		} else {
+			if($flags & Modules::flagsSingular) $this->setFlag($moduleID, Modules::flagsSingular, false);
+		}
+
+		// handle addFlag and removeFlag moduleInfo properties
+		foreach(array(0 => 'removeFlag', 1 => 'addFlag') as $add => $flagsType) {
+			if(empty($info[$flagsType])) continue;
+			if($flags & $info[$flagsType]) {
+				// already has the flags
+				if(!$add) {
+					// remove the flag(s)
+					$this->setFlag($moduleID, $info[$flagsType], false);
+				}
+			} else {
+				// does not have the flags
+				if($add) {
+					// add the flag(s)
+					$this->setFlag($moduleID, $info[$flagsType], true);
+				}
+			}
+		}
+	}
+	
+	public function getDebugData() {
+		return array(
+			'moduleFlags' => $this->moduleFlags
+		);
+	}
+}

wire/core/ModulesInstaller.php

@@ -0,0 +1,843 @@
+<?php namespace ProcessWire;
+
+/**
+ * ProcessWire Modules: Installer
+ *
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
+ * https://processwire.com
+ *
+ */
+
+class ModulesInstaller extends ModulesClass {
+	
+	/**
+	 * Get an associative array [name => path] for all modules that aren’t currently installed.
+	 *
+	 * #pw-internal
+	 *
+	 * @return array Array of elements with $moduleName => $pathName
+	 *
+	 */
+	public function getInstallable() {
+		return $this->modules->getInstallable();
+	}
+
+	/**
+	 * Is the given module name installable? (i.e. not already installed)
+	 *
+	 * #pw-internal
+	 *
+	 * @param string $class Module class name
+	 * @param bool $now Is module installable RIGHT NOW? This makes it check that all dependencies are already fulfilled (default=false)
+	 * @return bool True if module is installable, false if not
+	 *
+	 */
+	public function isInstallable($class, $now = false) {
+		$installableFiles = $this->modules->installableFiles;
+		if(!array_key_exists($class, $installableFiles)) return false;
+		if(!wireInstanceOf($class, 'Module')) {
+			$nsClass = $this->modules->getModuleClass($class, true);
+			if(!wireInstanceOf($nsClass, 'ProcessWire\\Module')) return false;
+		}
+		if($now) {
+			$requires = $this->getRequiresForInstall($class);
+			if(count($requires)) return false;
+		}
+		return true;
+	}
+
+	/**
+	 * Install the given module name
+	 *
+	 * #pw-group-manipulation
+	 *
+	 * @param string $class Module name (class name)
+	 * @param array|bool $options Optional associative array that can contain any of the following:
+	 *  - `dependencies` (boolean): When true, dependencies will also be installed where possible. Specify false to prevent installation of uninstalled modules. (default=true)
+	 *  - `resetCache` (boolean): When true, module caches will be reset after installation. (default=true)
+	 *  - `force` (boolean): Force installation, even if dependencies can't be met.
+	 * @return null|Module Returns null if unable to install, or ready-to-use Module object if successfully installed.
+	 * @throws WireException
+	 *
+	 */
+	public function install($class, $options = array()) {
+
+		$defaults = array(
+			'dependencies' => true,
+			'resetCache' => true,
+			'force' => false,
+		);
+
+		if(is_bool($options)) {
+			// dependencies argument allowed instead of $options, for backwards compatibility
+			$dependencies = $options;
+			$options = array('dependencies' => $dependencies);
+		}
+
+		$options = array_merge($defaults, $options);
+		$dependencyOptions = $options;
+		$dependencyOptions['resetCache'] = false;
+
+		if(!$this->isInstallable($class)) return null;
+
+		$requires = $this->getRequiresForInstall($class);
+		if(count($requires)) {
+			$error = '';
+			$installable = false;
+			if($options['dependencies']) {
+				$installable = true;
+				foreach($requires as $requiresModule) {
+					if(!$this->isInstallable($requiresModule)) $installable = false;
+				}
+				if($installable) {
+					foreach($requires as $requiresModule) {
+						if(!$this->modules->install($requiresModule, $dependencyOptions)) {
+							$error = $this->_('Unable to install required module') . " - $requiresModule. ";
+							$installable = false;
+							break;
+						}
+					}
+				}
+			}
+			if(!$installable) {
+				$error = sprintf($this->_('Module %s requires: %s'), $class, implode(', ', $requires)) . ' ' . $error;
+				if($options['force']) {
+					$this->warning($this->_('Warning!') . ' ' . $error);
+				} else {
+					throw new WireException($error);
+				}
+			}
+		}
+
+		$database = $this->wire()->database;
+		$languages = $this->wire()->languages;
+		$config = $this->wire()->config;
+
+		if($languages) $languages->setDefault();
+
+		$pathname = $this->modules->installableFile($class);
+		
+		if(strpos($class, "\\") === false) {
+			$ns = $this->modules->info->getModuleNamespace($class, array(
+				'file' => $pathname
+			));
+			$nsClass = $ns . $class;
+		} else {
+			$nsClass = $class;
+		}
+		
+		if(!class_exists($nsClass, false)) {
+			$this->modules->files->includeModuleFile($pathname, $class);
+			$this->modules->files->setConfigPaths($class, dirname($pathname));
+		}
+
+		$module = $this->modules->newModule($nsClass, $class);
+		if(!$module) return null;
+		
+		$flags = 0;
+		$moduleID = 0;
+
+		if($this->modules->isSingular($module)) $flags = $flags | Modules::flagsSingular;
+		if($this->modules->isAutoload($module)) $flags = $flags | Modules::flagsAutoload;
+
+		$sql = "INSERT INTO modules SET class=:class, flags=:flags, data=''";
+		if($config->systemVersion >= 7) $sql .= ", created=NOW()";
+		$query = $database->prepare($sql, "modules.install($class)");
+		$query->bindValue(":class", $class, \PDO::PARAM_STR);
+		$query->bindValue(":flags", $flags, \PDO::PARAM_INT);
+
+		try {
+			if($query->execute()) $moduleID = (int) $database->lastInsertId();
+		} catch(\Exception $e) {
+			if($languages) $languages->unsetDefault();
+			$this->trackException($e, false, true);
+			return null;
+		}
+
+		$this->modules->moduleID($class, $moduleID);
+		$this->modules->add($module);
+		$this->modules->installableFile($class, false); // unset
+
+		// note: the module's install is called here because it may need to know its module ID for installation of permissions, etc. 
+		if(method_exists($module, '___install') || method_exists($module, 'install')) {
+			try {
+				/** @var _Module $module */
+				$module->install();
+
+			} catch(\PDOException $e) {
+				$error = $this->_('Module reported error during install') . " ($class): " . $e->getMessage();
+				$this->error($error);
+				$this->trackException($e, false, $error);
+
+			} catch(\Exception $e) {
+				// remove the module from the modules table if the install failed
+				$moduleID = (int) $moduleID;
+				$error = $this->_('Unable to install module') .  " ($class): " . $e->getMessage();
+				$ee = null;
+				try {
+					$query = $database->prepare('DELETE FROM modules WHERE id=:id LIMIT 1'); // QA
+					$query->bindValue(":id", $moduleID, \PDO::PARAM_INT);
+					$query->execute();
+				} catch(\Exception $ee) {
+					$this->trackException($e, false, $error)->trackException($ee, true);
+				}
+				if($languages) $languages->unsetDefault();
+				if(is_null($ee)) $this->trackException($e, false, $error);
+				return null;
+			}
+		}
+
+		$info = $this->modules->info->getModuleInfoVerbose($class, array('noCache' => true));
+		$sanitizer = $this->wire()->sanitizer;
+		$permissions = $this->wire()->permissions;
+
+		// if this module has custom permissions defined in its getModuleInfo()['permissions'] array, install them 
+		foreach($info['permissions'] as $name => $title) {
+			$name = $sanitizer->pageName($name);
+			if(ctype_digit("$name") || empty($name)) continue; // permission name not valid
+			$permission = $permissions->get($name);
+			if($permission->id) continue; // permision already there
+			try {
+				$permission = $permissions->add($name);
+				$permission->title = $title;
+				$permissions->save($permission);
+				if($languages) $languages->unsetDefault();
+				$this->message(sprintf($this->_('Added Permission: %s'), $permission->name));
+				if($languages) $languages->setDefault();
+			} catch(\Exception $e) {
+				if($languages) $languages->unsetDefault();
+				$error = sprintf($this->_('Error adding permission: %s'), $name);
+				if($languages) $languages->setDefault();
+				$this->trackException($e, false, $error);
+			}
+		}
+
+		// check if there are any modules in 'installs' that this module didn't handle installation of, and install them
+		$label = $this->_('Module Auto Install');
+
+		foreach($info['installs'] as $name) {
+			if(!$this->modules->isInstalled($name)) {
+				try {
+					$this->modules->install($name, $dependencyOptions);
+					$this->message("$label: $name");
+				} catch(\Exception $e) {
+					$error = "$label: $name - " . $e->getMessage();
+					$this->trackException($e, false, $error);
+				}
+			}
+		}
+
+		$this->log("Installed module '$module'");
+		if($languages) $languages->unsetDefault();
+		if($options['resetCache']) $this->modules->info->clearModuleInfoCache();
+
+		return $module;
+	}
+
+	/**
+	 * Returns whether the module can be uninstalled
+	 *
+	 * #pw-internal
+	 *
+	 * @param string|Module $class
+	 * @param bool $returnReason If true, the reason why it can't be uninstalled with be returned rather than boolean false.
+	 * @return bool|string
+	 *
+	 */
+	public function isUninstallable($class, $returnReason = false) {
+
+		$reason = '';
+		$reason1 = $this->_("Module is not already installed");
+		$namespace = $this->modules->info->getModuleNamespace($class);
+		$class = $this->modules->getModuleClass($class);
+
+		if(!$this->modules->isInstalled($class)) {
+			$reason = $reason1 . ' (a)';
+
+		} else {
+			$this->modules->includeModule($class);
+			if(!wireClassExists($namespace . $class, false)) {
+				$reason = $reason1 . " (b: $namespace$class)";
+			}
+		}
+
+		if(!$reason) {
+			// if the moduleInfo contains a non-empty 'permanent' property, then it's not uninstallable
+			$info = $this->modules->info->getModuleInfo($class);
+			if(!empty($info['permanent'])) {
+				$reason = $this->_("Module is permanent");
+			} else {
+				$dependents = $this->getRequiresForUninstall($class);
+				if(count($dependents)) $reason = $this->_("Module is required by other modules that must be removed first");
+			}
+
+			if(!$reason && in_array('Fieldtype', wireClassParents($namespace . $class))) {
+				foreach($this->wire()->fields as $field) {
+					$fieldtype = wireClassName($field->type, false);
+					if($fieldtype == $class) {
+						$reason = $this->_("This module is a Fieldtype currently in use by one or more fields");
+						break;
+					}
+				}
+			}
+		}
+
+		if($returnReason && $reason) return $reason;
+
+		return $reason ? false : true;
+	}
+
+	/**
+	 * Returns whether the module can be deleted (have it's files physically removed)
+	 *
+	 * #pw-internal
+	 *
+	 * @param string|Module $class
+	 * @param bool $returnReason If true, the reason why it can't be removed will be returned rather than boolean false.
+	 * @return bool|string
+	 *
+	 */
+	public function isDeleteable($class, $returnReason = false) {
+
+		$reason = '';
+		$class = $this->modules->getModuleClass($class);
+		$filename = $this->modules->installableFile($class);
+		$dirname = dirname($filename);
+
+		if(empty($filename) || $this->modules->isInstalled($class)) {
+			$reason = "Module must be uninstalled before it can be deleted.";
+
+		} else if(is_link($filename) || is_link($dirname) || is_link(dirname($dirname))) {
+			$reason = "Module is linked to another location";
+
+		} else if(!is_file($filename)) {
+			$reason = "Module file does not exist";
+
+		} else if(strpos($filename, $this->modules->coreModulesPath) === 0) {
+			$reason = "Core modules may not be deleted.";
+
+		} else if(!is_writable($filename)) {
+			$reason = "We have no write access to the module file, it must be removed manually.";
+		}
+
+		if($returnReason && $reason) return $reason;
+
+		return $reason ? false : true;
+	}
+
+	/**
+	 * Delete the given module, physically removing its files
+	 *
+	 * #pw-group-manipulation
+	 *
+	 * @param string $class Module name (class name)
+	 * @return bool
+	 * @throws WireException If module can't be deleted, exception will be thrown containing reason.
+	 *
+	 */
+	public function delete($class) {
+
+		$config = $this->wire()->config;
+		$fileTools = $this->wire()->files;
+
+		$class = $this->modules->getModuleClass($class);
+		$success = true;
+		$reason = $this->isDeleteable($class, true);
+		if($reason !== true) throw new WireException($reason);
+		$siteModulesPath = $config->paths->siteModules;
+
+		$filename = $this->modules->installableFile($class);
+		$basename = basename($filename);
+
+		// double check that $class is consistent with the actual $basename	
+		if($basename === "$class.module" || $basename === "$class.module.php") {
+			// good, this is consistent with the format we require
+		} else {
+			throw new WireException("Unrecognized module filename format");
+		}
+
+		// now determine if module is the owner of the directory it exists in
+		// this is the case if the module class name is the same as the directory name
+
+		$path = dirname($filename); // full path to directory, i.e. .../site/modules/ProcessHello
+		$name = basename($path); // just name of directory that module is, i.e. ProcessHello
+		$parentPath = dirname($path); // full path to parent directory, i.e. ../site/modules
+		$backupPath = $parentPath . "/.$name"; // backup path, in case module is backed up
+
+		// first check that we are still in the /site/modules/ (or another non core modules path)
+		$inPath = false; // is module somewhere beneath /site/modules/ ?
+		$inRoot = false; // is module in /site/modules/ root? i.e. /site/modules/ModuleName.module
+
+		foreach($this->modules->getPaths() as $key => $modulesPath) {
+			if($key === 0) continue; // skip core modules path
+			if(strpos("$parentPath/", $modulesPath) === 0) $inPath = true;
+			if($modulesPath === $path) $inRoot = true;
+		}
+
+		$basename = basename($basename, '.php');
+		$basename = basename($basename, '.module');
+
+		$files = array(
+			"$basename.module",
+			"$basename.module.php",
+			"$basename.info.php",
+			"$basename.info.json",
+			"$basename.config.php",
+			"{$basename}Config.php",
+		);
+
+		if($inPath) {
+			// module is in /site/modules/[ModuleName]/
+
+			$numOtherModules = 0; // num modules in dir other than this one
+			$numLinks = 0; // number of symbolic links
+			$dirs = array("$path/");
+
+			do {
+				$dir = array_shift($dirs);
+				$this->message("Scanning: $dir", Notice::debug);
+
+				foreach(new \DirectoryIterator($dir) as $file) {
+					if($file->isDot()) continue;
+					if($file->isLink()) {
+						$numLinks++;
+						continue;
+					}
+					if($file->isDir()) {
+						$dirs[] = $fileTools->unixDirName($file->getPathname());
+						continue;
+					}
+					if(in_array($file->getBasename(), $files)) continue; // skip known files
+					if(strpos($file->getBasename(), '.module') && preg_match('{(\.module|\.module\.php)$}', $file->getBasename())) {
+						// another module exists in this dir, so we don't want to delete that
+						$numOtherModules++;
+					}
+					if(preg_match('{^(' . $basename . '\.[-_.a-zA-Z0-9]+)$}', $file->getBasename(), $matches)) {
+						// keep track of potentially related files in case we have to delete them individually
+						$files[] = $matches[1];
+					}
+				}
+			} while(count($dirs));
+
+			if(!$inRoot && !$numOtherModules && !$numLinks) {
+				// the modulePath had no other modules or directories in it, so we can delete it entirely
+				$success = (bool) $fileTools->rmdir($path, true);
+				if($success) {
+					$this->message("Removed directory: $path", Notice::debug);
+					if(is_dir($backupPath)) {
+						if($fileTools->rmdir($backupPath, true)) $this->message("Removed directory: $backupPath", Notice::debug);
+					}
+					$files = array();
+				} else {
+					$this->error("Failed to remove directory: $path", Notice::debug);
+				}
+			}
+		}
+
+		// remove module files individually 
+		foreach($files as $file) {
+			$file = "$path/$file";
+			if(!file_exists($file)) continue;
+			if($fileTools->unlink($file, $siteModulesPath)) {
+				$this->message("Removed file: $file", Notice::debug);
+			} else {
+				$this->error("Unable to remove file: $file", Notice::debug);
+			}
+		}
+
+		$this->log("Deleted module '$class'");
+
+		return $success;
+	}
+
+
+	/**
+	 * Uninstall the given module name
+	 *
+	 * #pw-group-manipulation
+	 *
+	 * @param string $class Module name (class name)
+	 * @return bool
+	 * @throws WireException
+	 *
+	 */
+	public function uninstall($class) {
+
+		$class = $this->modules->getModuleClass($class);
+		$reason = $this->modules->isUninstallable($class, true);
+		
+		if($reason !== true) {
+			// throw new WireException("$class - Can't Uninstall - $reason"); 
+			return false;
+		}
+
+		// check if there are any modules still installed that this one says it is responsible for installing
+		foreach($this->getUninstalls($class) as $name) {
+
+			// catch uninstall exceptions at this point since original module has already been uninstalled
+			$label = $this->_('Module Auto Uninstall');
+			try {
+				$this->modules->uninstall($name);
+				$this->message("$label: $name");
+
+			} catch(\Exception $e) {
+				$error = "$label: $name - " . $e->getMessage();
+				$this->trackException($e, false, $error);
+			}
+		}
+
+		$info = $this->modules->info->getModuleInfoVerbose($class);
+		$module = $this->modules->getModule($class, array(
+			'noPermissionCheck' => true,
+			'noInstall' => true,
+			// 'noInit' => true
+		));
+		if(!$module) return false;
+
+		// remove all hooks attached to this module
+		$hooks = $module instanceof Wire ? $module->getHooks() : array();
+		foreach($hooks as $hook) {
+			if($hook['method'] == 'uninstall') continue;
+			$this->message("Removed hook $class => " . $hook['options']['fromClass'] . " $hook[method]", Notice::debug);
+			$module->removeHook($hook['id']);
+		}
+
+		// remove all hooks attached to other ProcessWire objects
+		$hooks = array_merge($this->getHooks('*'), $this->wire()->hooks->getAllLocalHooks());
+		foreach($hooks as $hook) {
+			/** @var Wire $toObject */
+			$toObject = $hook['toObject'];
+			$toClass = wireClassName($toObject, false);
+			$toMethod = $hook['toMethod'];
+			if($class === $toClass && $toMethod != 'uninstall') {
+				$toObject->removeHook($hook['id']);
+				$this->message("Removed hook $class => " . $hook['options']['fromClass'] . " $hook[method]", Notice::debug);
+			}
+		}
+
+		if(method_exists($module, '___uninstall') || method_exists($module, 'uninstall')) {
+			// note module's uninstall method may throw an exception to abort the uninstall
+			/** @var _Module $module */
+			$module->uninstall();
+		}
+		$database = $this->wire()->database;
+		$query = $database->prepare('DELETE FROM modules WHERE class=:class LIMIT 1'); // QA
+		$query->bindValue(":class", $class, \PDO::PARAM_STR);
+		$query->execute();
+
+		// add back to the installable list
+		if(class_exists("ReflectionClass")) {
+			$reflector = new \ReflectionClass($this->modules->getModuleClass($module, true));
+			$this->modules->installableFile($class, $reflector->getFileName());
+		}
+
+		$this->modules->moduleID($class, false);
+		$this->modules->remove($module);
+
+		$sanitizer = $this->wire()->sanitizer;
+		$permissions = $this->wire()->permissions;
+
+		// delete permissions installed by this module
+		if(isset($info['permissions']) && is_array($info['permissions'])) {
+			foreach($info['permissions'] as $name => $title) {
+				$name = $sanitizer->pageName($name);
+				if(ctype_digit("$name") || empty($name)) continue;
+				$permission = $permissions->get($name);
+				if(!$permission->id) continue;
+				try {
+					$permissions->delete($permission);
+					$this->message(sprintf($this->_('Deleted Permission: %s'), $name));
+				} catch(\Exception $e) {
+					$error = sprintf($this->_('Error deleting permission: %s'), $name);
+					$this->trackException($e, false, $error);
+				}
+			}
+		}
+
+		$this->log("Uninstalled module '$class'");
+		$this->modules->refresh();
+
+		return true;
+	}
+
+	/**
+	 * Return an array of other module class names that are uninstalled when the given one is
+	 *
+	 * #pw-internal
+	 *
+	 * The opposite of this function is found in the getModuleInfo array property 'installs'.
+	 * Note that 'installs' and uninstalls may be different, as only modules in the 'installs' list
+	 * that indicate 'requires' for the installer module will be uninstalled.
+	 *
+	 * @param $class
+	 * @return array
+	 *
+	 */
+	public function getUninstalls($class) {
+
+		$uninstalls = array();
+		$class = $this->modules->getModuleClass($class);
+		if(!$class) return $uninstalls;
+		$info = $this->modules->info->getModuleInfoVerbose($class);
+
+		// check if there are any modules still installed that this one says it is responsible for installing
+		foreach($info['installs'] as $name) {
+
+			// if module isn't installed, then great
+			if(!$this->modules->isInstalled($name)) continue;
+
+			// if an 'installs' module doesn't indicate that it requires this one, then leave it installed
+			$i = $this->modules->info->getModuleInfo($name);
+			if(!in_array($class, $i['requires'])) continue;
+
+			// add it to the uninstalls array
+			$uninstalls[] = $name;
+		}
+
+		return $uninstalls;
+	}
+	
+	/**
+	 * Return an array of module class names that require the given one
+	 *
+	 * #pw-internal
+	 *
+	 * @param string $class
+	 * @param bool $uninstalled Set to true to include modules dependent upon this one, even if they aren't installed.
+	 * @param bool $installs Set to true to exclude modules that indicate their install/uninstall is controlled by $class.
+	 * @return array()
+	 *
+	 */
+	public function getRequiredBy($class, $uninstalled = false, $installs = false) {
+
+		$class = $this->modules->getModuleClass($class);
+		$info = $this->modules->info->getModuleInfo($class);
+		$dependents = array();
+
+		foreach($this->modules as $module) {
+			$c = $this->modules->getModuleClass($module);
+			if(!$uninstalled && !$this->modules->isInstalled($c)) continue;
+			$i = $this->modules->info->getModuleInfo($c);
+			if(!count($i['requires'])) continue;
+			if($installs && in_array($c, $info['installs'])) continue;
+			if(in_array($class, $i['requires'])) $dependents[] = $c;
+		}
+
+		return $dependents;
+	}
+
+	/**
+	 * Return an array of module class names required by the given one
+	 *
+	 * Default behavior is to return all listed requirements, whether they are currently met by
+	 * the environment or not. Specify TRUE for the 2nd argument to return only requirements
+	 * that are not currently met.
+	 *
+	 * #pw-internal
+	 *
+	 * @param string $class
+	 * @param bool $onlyMissing Set to true to return only required modules/versions that aren't
+	 * 	yet installed or don't have the right version. It excludes those that the class says it
+	 * 	will install (via 'installs' property of getModuleInfo)
+	 * @param null|bool $versions Set to true to always include versions in the returned requirements list.
+	 * 	Set to null to always exclude versions in requirements list (so only module class names will be there).
+	 * 	Set to false (which is the default) to include versions only when version is the dependency issue.
+	 * 	Note versions are already included when the installed version is not adequate.
+	 * @return array of strings each with ModuleName Operator Version, i.e. "ModuleName>=1.0.0"
+	 *
+	 */
+	public function getRequires($class, $onlyMissing = false, $versions = false) {
+
+		$class = $this->modules->getModuleClass($class);
+		$info = $this->modules->getModuleInfo($class);
+		$requires = $info['requires'];
+		$currentVersion = 0;
+
+		// quick exit if arguments permit it 
+		if(!$onlyMissing) {
+			if($versions) foreach($requires as $key => $value) {
+				list($operator, $version) = $info['requiresVersions'][$value];
+				if(empty($version)) continue;
+				if(ctype_digit("$version")) $version = $this->modules->formatVersion($version);
+				if(!empty($version)) $requires[$key] .= "$operator$version";
+			}
+			return $requires;
+		}
+
+		foreach($requires as $key => $requiresClass) {
+
+			if(in_array($requiresClass, $info['installs'])) {
+				// if this module installs the required class, then we can stop now
+				// and we assume it's installing the version it wants
+				unset($requires[$key]);
+			}
+
+			list($operator, $requiresVersion) = $info['requiresVersions'][$requiresClass];
+			$installed = true;
+
+			if($requiresClass == 'PHP') {
+				$currentVersion = PHP_VERSION;
+
+			} else if($requiresClass == 'ProcessWire') {
+				$currentVersion = $this->wire()->config->version;
+
+			} else if($this->modules->isInstalled($requiresClass)) {
+				if(!$requiresVersion) {
+					// if no version is specified then requirement is already met
+					unset($requires[$key]);
+					continue;
+				}
+				$i = $this->modules->getModuleInfo($requiresClass, array('noCache' => true));
+				$currentVersion = $i['version'];
+			} else {
+				// module is not installed
+				$installed = false;
+			}
+
+			if($installed && $this->versionCompare($currentVersion, $requiresVersion, $operator)) {
+				// required version is installed
+				unset($requires[$key]);
+
+			} else if(empty($requiresVersion)) {
+				// just the class name is fine
+				continue;
+
+			} else if(is_null($versions)) {
+				// request is for no versions to be included (just class names)
+				$requires[$key] = $requiresClass;
+
+			} else {
+				// update the requires string to clarify what version it requires
+				if(ctype_digit("$requiresVersion")) $requiresVersion = $this->modules->formatVersion($requiresVersion);
+				$requires[$key] = "$requiresClass$operator$requiresVersion";
+			}
+		}
+
+		return $requires;
+	}
+
+
+	/**
+	 * Compare one module version to another, returning TRUE if they match the $operator or FALSE otherwise
+	 *
+	 * #pw-internal
+	 *
+	 * @param int|string $currentVersion May be a number like 123 or a formatted version like 1.2.3
+	 * @param int|string $requiredVersion May be a number like 123 or a formatted version like 1.2.3
+	 * @param string $operator
+	 * @return bool
+	 *
+	 */
+	public function versionCompare($currentVersion, $requiredVersion, $operator) {
+
+		if(ctype_digit("$currentVersion") && ctype_digit("$requiredVersion")) {
+			// integer comparison is ok
+			$currentVersion = (int) $currentVersion;
+			$requiredVersion = (int) $requiredVersion;
+			$result = false;
+
+			switch($operator) {
+				case '=': $result = ($currentVersion == $requiredVersion); break;
+				case '>': $result = ($currentVersion > $requiredVersion); break;
+				case '<': $result = ($currentVersion < $requiredVersion); break;
+				case '>=': $result = ($currentVersion >= $requiredVersion); break;
+				case '<=': $result = ($currentVersion <= $requiredVersion); break;
+				case '!=': $result = ($currentVersion != $requiredVersion); break;
+			}
+			return $result;
+		}
+
+		// if either version has no periods or only one, like "1.2" then format it to stanard: "1.2.0"
+		if(substr_count($currentVersion, '.') < 2) $currentVersion = $this->modules->formatVersion($currentVersion);
+		if(substr_count($requiredVersion, '.') < 2) $requiredVersion = $this->modules->formatVersion($requiredVersion);
+
+		return version_compare($currentVersion, $requiredVersion, $operator);
+	}
+
+	/**
+	 * Return an array of module class names required by the given one to be installed before this one.
+	 *
+	 * Excludes modules that are required but already installed.
+	 * Excludes uninstalled modules that $class indicates it handles via it's 'installs' getModuleInfo property.
+	 *
+	 * #pw-internal
+	 *
+	 * @param string $class
+	 * @return array()
+	 *
+	 */
+	public function getRequiresForInstall($class) {
+		return $this->getRequires($class, true);
+	}
+
+	/**
+	 * Return an array of module class names required by the given one to be uninstalled before this one.
+	 *
+	 * Excludes modules that the given one says it handles via it's 'installs' getModuleInfo property.
+	 * Module class names in returned array include operator and version in the string.
+	 *
+	 * #pw-internal
+	 *
+	 * @param string $class
+	 * @return array()
+	 *
+	 */
+	public function getRequiresForUninstall($class) {
+		return $this->getRequiredBy($class, false, true);
+	}
+
+	/**
+	 * Return array of dependency errors for given module name
+	 *
+	 * #pw-internal
+	 *
+	 * @param $moduleName
+	 * @return array If no errors, array will be blank. If errors, array will be of strings (error messages)
+	 *
+	 */
+	public function getDependencyErrors($moduleName) {
+
+		$moduleName = $this->modules->getModuleClass($moduleName);
+		$info = $this->modules->getModuleInfo($moduleName);
+		$errors = array();
+
+		if(empty($info['requires'])) return $errors;
+
+		foreach($info['requires'] as $requiresName) {
+			$error = '';
+
+			if(!$this->modules->isInstalled($requiresName)) {
+				$error = $requiresName;
+
+			} else if(!empty($info['requiresVersions'][$requiresName])) {
+				list($operator, $version) = $info['requiresVersions'][$requiresName];
+				$info2 = $this->modules->getModuleInfo($requiresName);
+				$requiresVersion = $info2['version'];
+				if(!empty($version) && !$this->versionCompare($requiresVersion, $version, $operator)) {
+					$error = "$requiresName $operator $version";
+				}
+			}
+
+			if($error) $errors[] = sprintf($this->_('Failed module dependency: %s requires %s'), $moduleName, $error);
+		}
+
+		return $errors;
+	}
+	
+	/**
+	 * Get URL where an administrator can install given module name
+	 *
+	 * If module is already installed, it returns the URL to edit the module.
+	 *
+	 * @param string $className
+	 * @return string
+	 *
+	 */
+	public function getModuleInstallUrl($className) {
+		if(!is_string($className)) $className = $this->modules->getModuleClass($className);
+		$className = $this->wire()->sanitizer->fieldName($className);
+		if($this->modules->isInstalled($className)) return $this->modules->getModuleEditUrl($className);
+		return $this->wire()->config->urls->admin . "module/installConfirm?name=$className";
+	}
+
+}

wire/core/ModulesLoader.php

@@ -0,0 +1,907 @@
+<?php namespace ProcessWire;
+
+/**
+ * ProcessWire Modules: Loader
+ *
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
+ * https://processwire.com
+ *
+ */ 
+
+class ModulesLoader extends ModulesClass {
+	
+	/**
+	 * Array of moduleName => order to indicate autoload order when necessary
+	 *
+	 * @var array
+	 *
+	 */
+	protected $autoloadOrders = array();
+	
+	/**
+	 * Array of moduleName => condition
+	 *
+	 * Condition can be either an anonymous function or a selector string to be evaluated at ready().
+	 *
+	 */
+	protected $conditionalAutoloadModules = array();
+
+	/**
+	 * Cache of module information from DB used across multiple calls temporarily by loadPath() method
+	 *
+	 */
+	protected $modulesTableCache = array();
+	
+	/**
+	 * Module created dates indexed by module ID
+	 *
+	 */
+	protected $createdDates = array();
+	
+	/**
+	 * Initialize all the modules that are loaded at boot
+	 *
+	 * #pw-internal
+	 *
+	 * @param null|array|Modules $modules
+	 * @param array $completed
+	 * @param int $level
+	 *
+	 */
+	public function triggerInit($modules = null, $completed = array(), $level = 0) {
+
+		$debugKey = null;
+		$debugKey2 = null;
+		
+		if($this->debug) {
+			$debugKey = $this->modules->debugTimerStart("triggerInit$level");
+			$this->message("triggerInit(level=$level)");
+		}
+
+		$queue = array();
+		
+		if($modules === null) $modules = $this->modules;
+
+		foreach($modules as $class => $module) {
+
+			if($module instanceof ModulePlaceholder) {
+				// skip modules that aren't autoload and those that are conditional autoload
+				if(!$module->autoload) continue;
+				if(isset($this->conditionalAutoloadModules[$class])) continue;
+			}
+
+			if($this->debug) $debugKey2 = $this->modules->debugTimerStart("triggerInit$level($class)");
+
+			$info = $this->modules->getModuleInfo($module);
+			$skip = false;
+
+			// module requires other modules
+			foreach($info['requires'] as $requiresClass) {
+				if(in_array($requiresClass, $completed)) continue;
+				$dependencyInfo = $this->modules->getModuleInfo($requiresClass);
+				if(empty($dependencyInfo['autoload'])) {
+					// if dependency isn't an autoload one, there's no point in waiting for it
+					if($this->debug) $this->warning("Autoload module '$module' requires a non-autoload module '$requiresClass'");
+					continue;
+				} else if(isset($this->conditionalAutoloadModules[$requiresClass])) {
+					// autoload module requires another autoload module that may or may not load
+					if($this->debug) $this->warning("Autoload module '$module' requires a conditionally autoloaded module '$requiresClass'");
+					continue;
+				}
+				// dependency is autoload and required by this module, so queue this module to init later
+				$queue[$class] = $module;
+				$skip = true;
+				break;
+			}
+
+			if(!$skip) {
+				if($info['autoload'] !== false) {
+					if($info['autoload'] === true || $this->modules->isAutoload($module)) {
+						$this->initModule($module);
+					}
+				}
+				$completed[] = $class;
+			}
+
+			if($this->debug) $this->modules->debugTimerStop($debugKey2);
+		}
+
+		// if there is a dependency queue, go recursive till the queue is completed
+		if(count($queue) && $level < 3) {
+			$this->triggerInit($queue, $completed, $level + 1);
+		}
+
+		$this->modules->isInitialized(true);
+
+		if($this->debug) if($debugKey) $this->modules->debugTimerStop($debugKey);
+
+		if(!$level && $this->modules->info->moduleInfoCacheEmpty()) {
+			if($this->debug) $this->message("saveModuleInfoCache from triggerInit");
+			$this->modules->info->saveModuleInfoCache();
+		}
+	}
+	
+	/**
+	 * Initialize a single module
+	 *
+	 * @param Module $module
+	 * @param array $options
+	 *  - `clearSettings` (bool): When true, module settings will be cleared when appropriate to save space. (default=true)
+	 *  - `configOnly` (bool): When true, module init() method NOT called, but config data still set (default=false) 3.0.169+
+	 *  - `configData` (array): Extra config data merge with module’s config data (default=[]) 3.0.169+
+	 *  - `throw` (bool): When true, exceptions will be allowed to pass through. (default=false)
+	 * @return bool True on success, false on fail
+	 * @throws \Exception Only if the `throw` option is true.
+	 *
+	 */
+	public function initModule(Module $module, array $options = array()) {
+
+		$result = true;
+		$debugKey = null;
+		$clearSettings = isset($options['clearSettings']) ? (bool) $options['clearSettings'] : true;
+		$throw = isset($options['throw']) ? (bool) $options['throw'] : false;
+
+		if($this->debug) {
+			static $n = 0;
+			$this->message("initModule (" . (++$n) . "): " . wireClassName($module));
+		}
+
+		// if the module is configurable, then load its config data
+		// and set values for each before initializing the module
+		$extraConfigData = isset($options['configData']) ? $options['configData'] : null;
+		$this->modules->configs->setModuleConfigData($module, null, $extraConfigData);
+
+		$moduleName = wireClassName($module, false);
+		$moduleID = $this->modules->moduleID($moduleName);
+
+		if($moduleID && $this->modules->info->modulesLastVersions($moduleID)) {
+			$this->modules->info->checkModuleVersion($module);
+		}
+
+		if(method_exists($module, 'init') && empty($options['configOnly'])) {
+
+			if($this->debug) {
+				$debugKey = $this->modules->debugTimerStart("initModule($moduleName)");
+			}
+
+			try {
+				$module->init();
+			} catch(\Exception $e) {
+				if($throw) throw($e);
+				$this->error(sprintf($this->_('Failed to init module: %s'), $moduleName) . " - " . $e->getMessage());
+				$result = false;
+			}
+
+			if($this->debug) {
+				$this->modules->debugTimerStop($debugKey);
+			}
+		}
+
+		// if module is autoload (assumed here) and singular, then
+		// we no longer need the module's config data, so remove it
+		if($clearSettings && $this->modules->isSingular($module)) {
+			if(!$moduleID) $moduleID = $this->modules->getModuleID($module);
+			if($moduleID && $this->modules->configs->configData($moduleID) !== null) {
+				$this->modules->configs->configData($moduleID, 1);
+			}
+		}
+
+		return $result;
+	}
+
+	/**
+	 * Call ready for a single module
+	 *
+	 * @param Module $module
+	 * @return bool
+	 *
+	 */
+	public function readyModule(Module $module) {
+		$result = true;
+		if(method_exists($module, 'ready')) {
+			$debugKey = $this->debug ? $this->modules->debugTimerStart("readyModule(" . $module->className() . ")") : null;
+			try {
+				$module->ready();
+			} catch(\Exception $e) {
+				$this->error(sprintf($this->_('Failed to ready module: %s'), $module->className()) . " - " . $e->getMessage());
+				$result = false;
+			}
+			if($this->debug) {
+				$this->modules->debugTimerStop($debugKey);
+				static $n = 0;
+				$this->message("readyModule (" . (++$n) . "): " . wireClassName($module));
+			}
+		}
+		return $result;
+	}
+	
+	/**
+	 * Trigger all modules 'ready' method, if they have it.
+	 *
+	 * This is to indicate to them that the API environment is fully ready and $page is in fuel.
+	 *
+	 * This is triggered by ProcessPageView::ready
+	 *
+	 * #pw-internal
+	 *
+	 */
+	public function triggerReady() {
+
+		$debugKey = $this->debug ? $this->modules->debugTimerStart("triggerReady") : null;
+		$skipped = $this->triggerConditionalAutoload();
+
+		// trigger ready method on all applicable modules
+		foreach($this->modules as $module) {
+			/** @var Module $module */
+			if($module instanceof ModulePlaceholder) continue;
+
+			$class = $this->modules->getModuleClass($module);
+			
+			if(isset($skipped[$class])) continue;
+
+			$id = $this->modules->moduleID($class);
+			$flags = $this->modules->flags->moduleFlags($id);
+			
+			if($flags & Modules::flagsAutoload) $this->readyModule($module);
+		}
+
+		if($this->debug) $this->modules->debugTimerStop($debugKey);
+	}
+
+
+	/**
+	 * Init conditional autoload modules, if conditions allow
+	 *
+	 * @return array of skipped module names
+	 *
+	 */
+	public function triggerConditionalAutoload() {
+
+		// conditional autoload modules that are skipped (className => 1)
+		$skipped = array();
+
+		// init conditional autoload modules, now that $page is known
+		foreach($this->conditionalAutoloadModules as $className => $func) {
+
+			if($this->debug) {
+				$moduleID = $this->modules->getModuleID($className);
+				$flags = $this->modules->flags->moduleFlags($moduleID);
+				$this->message("Conditional autoload: $className (flags=$flags, condition=" . (is_string($func) ? $func : 'func') . ")");
+			}
+
+			$load = true;
+
+			if(is_string($func)) {
+				// selector string
+				if(!$this->wire()->page->is($func)) $load = false;
+			} else {
+				// anonymous function
+				if(!is_callable($func)) $load = false;
+				else if(!$func()) $load = false;
+			}
+
+			if($load) {
+				$module = $this->modules->newModule($className);
+				if($module) {
+					$this->modules->set($className, $module);
+					if($this->initModule($module)) {
+						if($this->debug) $this->message("Conditional autoload: $className LOADED");
+					} else {
+						if($this->debug) $this->warning("Failed conditional autoload: $className");
+					}
+				}
+
+			} else {
+				$skipped[$className] = $className;
+				if($this->debug) $this->message("Conditional autoload: $className SKIPPED");
+			}
+		}
+
+		// clear this out since we don't need it anymore
+		$this->conditionalAutoloadModules = array();
+
+		return $skipped;
+	}
+	
+	/**
+	 * Retrieve the installed module info as stored in the database
+	 *
+	 */
+	public function loadModulesTable() {
+
+		$this->autoloadOrders = array();
+		$database = $this->wire()->database;
+
+		// skip loading dymanic caches at this stage
+		$skipCaches = array(
+			ModulesInfo::moduleInfoCacheUninstalledName,
+			ModulesInfo::moduleInfoCacheVerboseName
+		);
+
+		$query = $database->query(
+		// Currently: id, class, flags, data, with created added at sysupdate 7
+			"SELECT * FROM modules " .
+			"WHERE class NOT IN('" . implode("','", $skipCaches) . "') " .
+			"ORDER BY class",
+			"modules.loadModulesTable()"
+		);
+
+		/** @noinspection PhpAssignmentInConditionInspection */
+		while($row = $query->fetch(\PDO::FETCH_ASSOC)) {
+
+			$moduleID = (int) $row['id'];
+			$flags = (int) $row['flags'];
+			$class = $row['class'];
+
+			if($flags & Modules::flagsSystemCache) {
+				// system cache names are prefixed with a '.' so they load first
+				$this->modules->memcache(ltrim($class, '.'), $row['data']);
+				continue;
+			}
+
+			$this->modules->moduleID($class, $moduleID);
+			$this->modules->moduleName($moduleID, $class);
+			$this->modules->flags->moduleFlags($moduleID, $flags);
+
+			$autoload = $flags & Modules::flagsAutoload;
+			$loadSettings = $autoload || ($flags & Modules::flagsDuplicate) || ($class === 'SystemUpdater');
+
+			if($loadSettings) {
+				// preload config data for autoload modules since we'll need it again very soon
+				$data = $row['data'] ? json_decode($row['data'], true) : array();
+				$this->modules->configs->configData($moduleID, $data);
+				// populate information about duplicates, if applicable
+				if($flags & Modules::flagsDuplicate) $this->modules->duplicates()->addFromConfigData($class, $data);
+
+			} else if(!empty($row['data'])) {
+				// indicate that it has config data, but not yet loaded
+				$this->modules->configs->configData($moduleID, 1);
+			}
+
+			if(isset($row['created']) && $row['created'] != '0000-00-00 00:00:00') {
+				$this->createdDates[$moduleID] = $row['created'];
+			}
+
+			if($autoload) {
+				$value = $this->modules->info->moduleInfoCache($moduleID, 'autoload');
+				if(!empty($value)) {
+					$autoload = $value;
+					$disabled = $flags & Modules::flagsDisabled;
+					if(is_int($autoload) && $autoload > 1 && !$disabled) {
+						// autoload specifies an order > 1, indicating it should load before others
+						$this->autoloadOrders[$class] = $autoload;
+					}
+				}
+			}
+
+			unset($row['data'], $row['created']); // info we don't want stored in modulesTableCache
+			$this->modulesTableCache[$class] = $row;
+		}
+
+		$query->closeCursor();
+	}
+
+	/**
+	 * Given a disk path to the modules, determine all installed modules and keep track of all uninstalled (installable) modules.
+	 *
+	 * @param string $path
+	 *
+	 */
+	public function loadPath($path) {
+
+		$config = $this->wire()->config;
+		$debugKey = $this->debug ? $this->modules->debugTimerStart("loadPath($path)") : null;
+		$installed =& $this->modulesTableCache;
+		$modulesLoaded = array();
+		$modulesDelayed = array();
+		$modulesRequired = array();
+		$modulesFiles = $this->modules->files;
+		$rootPath = $config->paths->root;
+		$basePath = substr($path, strlen($rootPath));
+
+		foreach($modulesFiles->findModuleFiles($path, true) as $pathname) {
+
+			$pathname = trim($pathname);
+			if(empty($pathname)) continue;
+			$basename = basename($pathname);
+			list($moduleName, $ext) = explode('.', $basename, 2); // i.e. "module.php" or "module"
+
+			$modulesFiles->moduleFileExt($moduleName, $ext === 'module' ? 1 : 2);
+			// @todo next, remove the 'file' property from verbose module info since it is redundant
+
+			$requires = array();
+			$name = $moduleName;
+			$moduleName = $this->loadModule($path, $pathname, $requires, $installed);
+			if(!$config->paths->__isset($name)) $modulesFiles->setConfigPaths($name, dirname($basePath . $pathname));
+			if(!$moduleName) continue;
+
+			if(count($requires)) {
+				// module not loaded because it required other module(s) not yet loaded
+				foreach($requires as $requiresModuleName) {
+					if(!isset($modulesRequired[$requiresModuleName])) $modulesRequired[$requiresModuleName] = array();
+					if(!isset($modulesDelayed[$moduleName])) $modulesDelayed[$moduleName] = array();
+					// queue module for later load
+					$modulesRequired[$requiresModuleName][$moduleName] = $pathname;
+					$modulesDelayed[$moduleName][] = $requiresModuleName;
+				}
+				continue;
+			}
+
+			// module was successfully loaded
+			$modulesLoaded[$moduleName] = 1;
+			$loadedNames = array($moduleName);
+
+			// now determine if this module had any other modules waiting on it as a dependency
+			/** @noinspection PhpAssignmentInConditionInspection */
+			while($moduleName = array_shift($loadedNames)) {
+				// iternate through delayed modules that require this one
+				if(empty($modulesRequired[$moduleName])) continue;
+
+				foreach($modulesRequired[$moduleName] as $delayedName => $delayedPathName) {
+					$loadNow = true;
+					if(isset($modulesDelayed[$delayedName])) {
+						foreach($modulesDelayed[$delayedName] as $requiresModuleName) {
+							if(!isset($modulesLoaded[$requiresModuleName])) {
+								$loadNow = false;
+							}
+						}
+					}
+					if(!$loadNow) continue;
+					// all conditions satisified to load delayed module
+					unset($modulesDelayed[$delayedName], $modulesRequired[$moduleName][$delayedName]);
+					$unused = array();
+					$loadedName = $this->loadModule($path, $delayedPathName, $unused, $installed);
+					if(!$loadedName) continue;
+					$modulesLoaded[$loadedName] = 1;
+					$loadedNames[] = $loadedName;
+				}
+			}
+		}
+
+		if(count($modulesDelayed)) {
+			foreach($modulesDelayed as $moduleName => $requiredNames) {
+				$this->error("Module '$moduleName' dependency not fulfilled for: " . implode(', ', $requiredNames), Notice::debug);
+			}
+		}
+
+		if($this->debug) $this->modules->debugTimerStop($debugKey);
+	}
+
+	/**
+	 * Load a module into memory (companion to load bootstrap method)
+	 *
+	 * @param string $basepath Base path of modules being processed (path provided to the load method)
+	 * @param string $pathname
+	 * @param array $requires This method will populate this array with required dependencies (class names) if present.
+	 * @param array $installed Array of installed modules info, indexed by module class name
+	 * @return string Returns module name (classname)
+	 *
+	 */
+	public function loadModule($basepath, $pathname, array &$requires, array &$installed) {
+
+		$pathname = $basepath . $pathname;
+		$dirname = dirname($pathname);
+		$filename = basename($pathname);
+		$basename = basename($filename, '.php');
+		$basename = basename($basename, '.module');
+		$requires = array();
+		$duplicates = $this->modules->duplicates();
+
+		// check if module has duplicate files, where one to use has already been specified to use first
+		$currentFile = $duplicates->getCurrent($basename); // returns the current file in use, if more than one
+		if($currentFile) {
+			// there is a duplicate file in use
+			$file = rtrim($this->wire()->config->paths->root, '/') . $currentFile;
+			if(file_exists($file) && $pathname != $file) {
+				// file in use is different from the file we are looking at
+				// check if this is a new/yet unknown duplicate
+				if(!$duplicates->hasDuplicate($basename, $pathname)) {
+					// new duplicate
+					$duplicates->recordDuplicate($basename, $pathname, $file, $installed);
+				}
+				return '';
+			}
+		}
+
+		// check if module has already been loaded, or maybe we've got duplicates
+		if(wireClassExists($basename, false)) {
+			$module = $this->modules->offsetGet($basename);
+			$dir = rtrim((string) $this->wire()->config->paths($basename), '/');
+			if($module && $dir && $dirname != $dir) {
+				$duplicates->recordDuplicate($basename, $pathname, "$dir/$filename", $installed);
+				return '';
+			}
+			if($module) return $basename;
+		}
+
+		// if the filename doesn't end with .module or .module.php, then stop and move onto the next
+		if(strpos($filename, '.module') === false) return false;
+		list(, $ext) = explode('.module', $filename, 2);
+		if(!empty($ext) && $ext !== '.php') return false;
+
+		//  if the filename doesn't start with the requested path, then skip
+		if(strpos($pathname, $basepath) !== 0) return '';
+
+		// if the file isn't there, it was probably uninstalled, so ignore it
+		// if(!file_exists($pathname)) return ''; 
+
+		// if the module isn't installed, then stop and move on to next
+		if(!isset($installed[$basename])) {
+			// array_key_exists is used as secondary to check the null case
+			$this->modules->installableFile($basename, $pathname);
+			return '';
+		}
+
+		$info = $installed[$basename];
+		$this->modules->files->setConfigPaths($basename, $dirname);
+		$module = null;
+		$autoload = false;
+
+		if($info['flags'] & Modules::flagsAutoload) {
+
+			// this is an Autoload module. 
+			// include the module and instantiate it but don't init() it,
+			// because it will be done by Modules::init()
+
+			// determine if module has dependencies that are not yet met
+			$requiresClasses = $this->modules->info->getModuleInfoProperty($basename, 'requires');
+			if(!empty($requiresClasses)) {
+				foreach($requiresClasses as $requiresClass) {
+					$nsRequiresClass = $this->modules->getModuleClass($requiresClass, true);
+					if(!wireClassExists($nsRequiresClass, false)) {
+						$requiresInfo = $this->modules->getModuleInfo($requiresClass);
+						if(!empty($requiresInfo['error'])
+							|| $requiresInfo['autoload'] === true
+							|| !$this->modules->isInstalled($requiresClass)) {
+							// we only handle autoload===true since load() only instantiates other autoload===true modules
+							$requires[] = $requiresClass;
+						}
+					}
+				}
+				if(count($requires)) {
+					// module has unmet requirements
+					return $basename;
+				}
+			}
+			// if not defined in getModuleInfo, then we'll accept the database flag as enough proof
+			// since the module may have defined it via an isAutoload() function
+			/** @var bool|string|callable $autoload */
+			$autoload = $this->modules->info->moduleInfoCache($basename, 'autoload');
+			if(empty($autoload)) $autoload = true;
+			if($autoload === 'function') {
+				// function is stored by the moduleInfo cache to indicate we need to call a dynamic function specified with the module itself
+				$i = $this->modules->info->getModuleInfoExternal($basename);
+				if(empty($i)) {
+					$this->modules->files->includeModuleFile($pathname, $basename);
+					$namespace = $this->modules->info->getModuleNamespace($basename);
+					$className = $namespace . $basename;
+					if(method_exists($className, 'getModuleInfo')) {
+						$i = $className::getModuleInfo();
+					} else {
+						$i = $this->modules->getModuleInfo($className);
+					}
+				}
+				$autoload = isset($i['autoload']) ? $i['autoload'] : true;
+				unset($i);
+			}
+			// check for conditional autoload
+			if(!is_bool($autoload) && (is_string($autoload) || is_callable($autoload)) && !($info['flags'] & Modules::flagsDisabled)) {
+				// anonymous function or selector string
+				$this->conditionalAutoloadModules[$basename] = $autoload;
+				$this->modules->moduleID($basename, (int) $info['id']); 
+				$this->modules->moduleName((int) $info['id'], $basename);
+				$autoload = true;
+			} else if($autoload) {
+				$this->modules->files->includeModuleFile($pathname, $basename);
+				if(!($info['flags'] & Modules::flagsDisabled)) {
+					if($this->modules->refreshing) {
+						$module = $this->modules->offsetGet($basename);
+					} else if(isset($this->autoloadOrders[$basename]) && $this->autoloadOrders[$basename] >= 10000) {
+						$module = $this->modules->offsetGet($basename); // preloaded module
+					}
+					if(!$module) $module = $this->modules->newModule($basename);
+				}
+			}
+		}
+
+		if($module === null) {
+			// placeholder for a module, which is not yet included and instantiated
+			$ns = $this->modules->info->moduleInfoCache($basename, 'namespace');
+			if(empty($ns)) $ns = __NAMESPACE__ . "\\";
+			$singular = $info['flags'] & Modules::flagsSingular;
+			$module = $this->newModulePlaceholder($basename, $ns, $pathname, $singular, $autoload);
+		}
+
+		$this->modules->moduleID($basename, (int) $info['id']);
+		$this->modules->moduleName((int) $info['id'], $basename);
+		$this->modules->set($basename, $module);
+
+		return $basename;
+	}
+	
+	/**
+	 * Include the file for a given module, but don't instantiate it
+	 *
+	 * #pw-internal
+	 *
+	 * @param ModulePlaceholder|Module|string Expects a ModulePlaceholder or className
+	 * @param string $file Optionally specify the module filename if you already know it
+	 * @return bool true on success, false on fail or unknown
+	 *
+	 */
+	public function includeModule($module, $file = '') {
+
+		$className = '';
+		$moduleName = '';
+
+		if(is_string($module)) {
+			$moduleName = ctype_alnum($module) ? $module : wireClassName($module);
+			$className = wireClassName($module, true);
+		} else if(is_object($module)) {
+			if($module instanceof ModulePlaceholder) {
+				$moduleName = $module->className();
+				$className = $module->className(true);
+			} else if($module instanceof Module) {
+				return true; // already included
+			}
+		} else {
+			$moduleName = $this->modules->getModuleClass($module, false);
+			$className = $this->modules->getModuleClass($module, true);
+		}
+
+		if(!$className) return false;
+
+		// already included
+		if(class_exists($className, false)) return true;
+
+		// attempt to retrieve module
+		$module = $this->modules->offsetGet($moduleName); 
+
+		if($module) {
+			// module found, check to make sure it actually points to a module	
+			if(!$module instanceof Module) $module = false;
+
+		} else if($moduleName) {
+			// This is reached for any of the following:
+			// 1. an uninstalled module
+			// 2. an installed module that has changed locations
+			// 3. a module outside the \ProcessWire\ namespace
+			// 4. a module that does not exist
+			$fast = true;
+			if(!$file) {
+				// determine module file, if not already provided to the method
+				$file = $this->modules->getModuleFile($moduleName, array('fast' => true));
+				if(!$file) {
+					$fast = false;
+					$file = $this->modules->getModuleFile($moduleName, array('fast' => false));
+				}
+				// still can't figure out what file is? fail
+				if(!$file) return false;
+			}
+
+			if(!$this->modules->files->includeModuleFile($file, $moduleName)) {
+				// module file failed to include(), try to identify and include file again
+				if($fast) {
+					$filePrev = $file;
+					$file = $this->modules->getModuleFile($moduleName, array('fast' => false));
+					if($file && $file !== $filePrev) {
+						if($this->modules->files->includeModuleFile($file, $moduleName)) {
+							// module is missing a module file
+							return false;
+						}
+					}
+				} else {
+					// we already tried this earlier, no point in doing it again
+				}
+			}
+
+			// now check to see if included file resulted in presence of module class
+			if(class_exists($className)) {
+				// module in ProcessWire namespace
+				$module = true;
+			} else {
+				// module in root namespace or some other namespace
+				$namespace = (string) $this->modules->info->getModuleNamespace($moduleName, array('file' => $file));
+				$className = trim($namespace, "\\") . "\\$moduleName";
+				if(class_exists($className, false)) {
+					// successful include module
+					$module = true;
+				}
+			}
+		}
+
+		if($module === true) {
+			// great
+			return true;
+
+		} else if(!$module) {
+			// darn
+			return false;
+
+		} else if($module instanceof ModulePlaceholder) {
+			// the ModulePlaceholder indicates what file to load
+			return $this->modules->files->includeModuleFile($module->file, $moduleName);
+
+		} else if($module instanceof Module) {
+			// it's already been included, since we have a real module
+			return true;
+
+		} else {
+			return false;
+		}
+	}
+
+	/**
+	 * Check if user has permission for given module
+	 *
+	 * #pw-internal
+	 *
+	 * @param string|object $moduleName Module instance or module name
+	 * @param User|null $user Optionally specify different user to consider than current.
+	 * @param Page|null $page Optionally specify different page to consider than current.
+	 * @param bool $strict If module specifies no permission settings, assume no permission.
+	 *   - Default (false) is to assume permission when module doesn't say anything about it.
+	 *   - Process modules (for instance) generally assume no permission when it isn't specifically defined
+	 *     (though this method doesn't get involved in that, leaving you to specify $strict instead).
+	 *
+	 * @return bool
+	 *
+	 */
+	public function hasPermission($moduleName, ?User $user = null, ?Page $page = null, $strict = false) {
+
+		if(is_object($moduleName)) {
+			$module = $moduleName;
+			$className = $module->className(true);
+			$moduleName = $module->className(false);
+		} else {
+			$module = null;
+			$className = $this->modules->getModuleClass($moduleName, true); // ???
+			$moduleName = wireClassName($moduleName, false);
+		}
+
+		$info = $this->modules->getModuleInfo($module ? $module : $moduleName);
+		
+		if(empty($info['permission']) && empty($info['permissionMethod'])) {
+			return ($strict ? false : true);
+		}
+
+		if(!$user instanceof User) $user = $this->wire()->user;
+		if($user && $user->isSuperuser()) return true;
+
+		if(!empty($info['permission'])) {
+			if(!$user->hasPermission($info['permission'])) return false;
+		}
+
+		if(!empty($info['permissionMethod'])) {
+			// module specifies a static method to call for permission
+			if(is_null($page)) $page = $this->wire()->page;
+			$data = array(
+				'wire' => $this->wire(),
+				'page' => $page,
+				'user' => $user,
+				'info' => $info,
+			);
+			$method = $info['permissionMethod'];
+			$this->includeModule($moduleName);
+			
+			return method_exists($className, $method) ? $className::$method($data) : false;
+		}
+
+		return true;
+	}
+	
+	/**
+	 * Include site preload modules
+	 *
+	 * Preload modules load before all other modules, including core modules. In order
+	 * for a module to be a preload module, it must meet the following conditions:
+	 *
+	 * - Module info `autoload` value is integer of 10000 or greater, i.e. `[ 'autoload' => 10000 ]`
+	 * - Module info `singular` value must be non-empty, i.e. `[ 'singular' => true ]`
+	 * - Module file is located in: /site/modules/ModuleName/ModuleName.module.php
+	 * - Module cannot load any other modules at least until ready() method called.
+	 * - Module cannot have any `requires` dependencies to any other modules.
+	 *
+	 * Please note the above is specifically stating that the module must be in its
+	 * own “site/ModuleName/” directory and have the “.module.php” extension. Using
+	 * just the “.module” extension is not supported for preload modules.
+	 *
+	 * @param string $path
+	 * @since 3.0.173
+	 *
+	 */
+	public function preloadModules($path) {
+		
+		if(empty($this->autoloadOrders)) return;
+		
+		arsort($this->autoloadOrders);
+		
+		foreach($this->autoloadOrders as $moduleName => $order) {
+			if($order < 10000) break;
+			$info = $this->modules->info->moduleInfoCache($moduleName);
+			if(empty($info)) continue;
+			if(empty($info['singular'])) continue;
+			$file = $path . "$moduleName/$moduleName.module.php";
+			if(!file_exists($file) || !$this->modules->files->includeModuleFile($file, $moduleName)) continue;
+			if(!isset($info['namespace'])) $info['namespace'] = '';
+			$className = $info['namespace'] . $moduleName;
+			$module = $this->modules->newModule($className, $moduleName);
+			if($module) {
+				$this->modules->offsetSet($moduleName, $module);
+			}
+		}
+	}
+
+
+	/**
+	 * Get or set created date for given module ID
+	 *
+	 * #pw-internal
+	 *
+	 * @param int $moduleID Module ID or omit to get all
+	 * @param string $setValue Set created date value
+	 * @return string|array|null
+	 * @since 3.0.219
+	 *
+	 */
+	public function createdDate($moduleID = null, $setValue = null) {
+		if($moduleID === null) return $this->createdDates;
+		if($setValue) {
+			$this->createdDates[$moduleID] = $setValue;
+			return $setValue;
+		}
+		return isset($this->createdDates[$moduleID]) ? $this->createdDates[$moduleID] : null;
+	}
+
+	/**
+	 * Return a new ModulePlaceholder for the given className
+	 *
+	 * #pw-internal
+	 *
+	 * @param string $className Module class this placeholder will stand in for
+	 * @param string $ns Module namespace
+	 * @param string $file Full path and filename of $className
+	 * @param bool $singular Is the module a singular module?
+	 * @param bool $autoload Is the module an autoload module?
+	 * @return ModulePlaceholder
+	 *
+	 */
+	public function newModulePlaceholder($className, $ns, $file, $singular, $autoload) {
+		/** @var ModulePlaceholder $module */
+		$module = $this->wire(new ModulePlaceholder());
+		$module->setClass($className);
+		$module->setNamespace($ns);
+		$module->singular = $singular;
+		$module->autoload = $autoload;
+		$module->file = $file;
+		return $module;
+	}
+
+	/**
+	 * Called by Modules class when init has finished
+	 * 
+	 */
+	public function loaded() {
+		$this->modulesTableCache = array();
+	}
+
+	/**
+	 * Get the autoload orders
+	 * 
+	 * @return array Array of [ moduleName (string => order (int) ]
+	 * 
+	 */
+	public function getAutoloadOrders() {
+		return $this->autoloadOrders;
+	}
+
+	public function getDebugData() {
+		return array(
+			'autoloadOrders' => $this->autoloadOrders,
+			'conditionalAutoloadModules' => $this->conditionalAutoloadModules,
+			'modulesTableCache' => $this->modulesTableCache,
+			'createdDates' => $this->createdDates,
+		);
+	}
+
+}

wire/core/Notices.php

@@ -507,6 +507,12 @@ class NoticeWarning extends Notice {
 class Notices extends WireArray {
 	
 	const logAllNotices = false;  // for debugging/dev purposes
+	
+	public function __construct() {
+		parent::__construct();
+		$this->usesNumericKeys = true;
+		$this->indexedByName = false;
+	}
 
 	/**
 	 * Initialize Notices API var
@@ -548,8 +554,9 @@ class Notices extends WireArray {
 	 * 
 	 */
 	protected function allowNotice(Notice $item) {
-		
-		$user = $this->wire()->user;
+
+		// intentionally not using $this->wire()->user; in case this gets called early in boot
+		$user = $this->wire('user'); 
 		
 		if($item->flags & Notice::debug) {
 			if(!$this->wire()->config->debug) return false;

wire/core/NullPage.php

@@ -25,7 +25,7 @@
  * Placeholder class for non-existant and non-saveable Page.
  * Many API functions return a NullPage to indicate no match. 
  *
- * ProcessWire 3.x, Copyright 2016 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  * 
  * @property int $id The id property will always be 0 for a NullPage. 
@@ -65,6 +65,7 @@ class NullPage extends Page implements WireNull {
 	 * 
 	 * @param string $selector
 	 * @return null
+	 * @todo can this return NullPage instead?
 	 * 
 	 */
 	public function parent($selector = '') { return null; }
@@ -77,7 +78,9 @@ class NullPage extends Page implements WireNull {
 	 * @throws WireException
 	 * 
 	 */
-	public function parents($selector = '') { return $this->wire('pages')->newPageArray(); }
+	public function parents($selector = '') { 
+		return $this->wire()->pages->newPageArray(); 
+	}
 
 	/**
 	 * #pw-internal
@@ -95,6 +98,14 @@ class NullPage extends Page implements WireNull {
 	 */
 	public function isHidden() { return true; }
 
+	/**
+	 * #pw-internal
+	 *
+	 * @return bool
+	 *
+	 */
+	public function isNew() { return false; }
+
 	/**
 	 * #pw-internal
 	 * 
@@ -110,7 +121,22 @@ class NullPage extends Page implements WireNull {
 	 * @throws WireException
 	 * 
 	 */
-	public function ___rootParent() { return $this->wire('pages')->newNullPage(); }
+	public function ___rootParent() { 
+		return $this->wire()->pages->newNullPage(); 
+	}
+
+	/**
+	 * #pw-internal
+	 * 
+	 * @param string $selector
+	 * @param bool $includeCurrent
+	 * @return PageArray
+	 * @throws WireException
+	 * 
+	 */
+	public function siblings($selector = '', $includeCurrent = true) { 
+		return $this->wire()->pages->newPageArray(); 
+	}
 
 	/**
 	 * #pw-internal
@@ -121,18 +147,9 @@ class NullPage extends Page implements WireNull {
 	 * @throws WireException
 	 * 
 	 */
-	public function siblings($selector = '', $options = array()) { return $this->wire('pages')->newPageArray(); }
-
-	/**
-	 * #pw-internal
-	 * 
-	 * @param string $selector
-	 * @param array $options
-	 * @return PageArray
-	 * @throws WireException
-	 * 
-	 */
-	public function children($selector = '', $options = array()) { return $this->wire('pages')->newPageArray(); }
+	public function children($selector = '', $options = array()) { 
+		return $this->wire()->pages->newPageArray(); 
+	}
 
 	/**
 	 * #pw-internal
@@ -142,7 +159,9 @@ class NullPage extends Page implements WireNull {
 	 * @throws WireException
 	 * 
 	 */
-	public function getAccessParent($type = 'view') { return $this->wire('pages')->newNullPage(); }
+	public function getAccessParent($type = 'view') { 
+		return $this->wire()->pages->newNullPage(); 
+	}
 
 	/**
 	 * #pw-internal
@@ -152,7 +171,9 @@ class NullPage extends Page implements WireNull {
 	 * @throws WireException
 	 * 
 	 */
-	public function getAccessRoles($type = 'view') { return $this->wire('pages')->newPageArray(); }
+	public function getAccessRoles($type = 'view') { 
+		return $this->wire()->pages->newPageArray(); 
+	}
 
 	/**
 	 * #pw-internal
@@ -173,4 +194,3 @@ class NullPage extends Page implements WireNull {
 	 */
 	public function isChanged($what = '') { return false; }
 }
-

wire/core/PWPNG.php

@@ -115,7 +115,7 @@ class PWPNG {
 			'channels' => $ct,
 			'bits' => $bpc,
 			'dp' => $dp,
-			'palette' => (function_exists('utf8_encode') ? utf8_encode($pal) : $pal),
+			'palette' => (function_exists('mb_convert_encoding') ? mb_convert_encoding($pal, 'UTF-8', 'ISO-8859-1') : $pal),
 			'trans' => $trns,
 			'alpha' => $ct >= 4 ? true : false,
 			'interlace' => $interlaced,
@@ -149,4 +149,4 @@ class PWPNG {
 		$this->errors[] = $msg;
 	}
 
-}
+}

wire/core/Page.php

@@ -8,7 +8,7 @@
  * 1. Providing get/set access to the Page's properties
  * 2. Accessing the related hierarchy of pages (i.e. parents, children, sibling pages)
  * 
- * ProcessWire 3.x, Copyright 2022 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2024 by Ryan Cramer
  * https://processwire.com
  * 
  * #pw-summary Class used by all Page objects in ProcessWire.
@@ -70,6 +70,7 @@
  * @property bool $hasFiles Does this page have one or more files in its files path? #pw-group-files
  * @property bool $outputFormatting Whether output formatting is enabled or not. #pw-advanced
  * @property int $sort Sort order of this page relative to siblings (applicable when manual sorting is used). #pw-group-system
+ * @property int|null $sortPrevious Previous sort order, if changed (3.0.235+) #pw-group-system
  * @property int $index Index of this page relative to its siblings, regardless of sort (starting from 0). #pw-group-traversal
  * @property string $sortfield Field that a page is sorted by relative to its siblings (default="sort", which means drag/drop manual) #pw-group-system
  * @property null|array _statusCorruptedFields Field names that caused the page to have Page::statusCorrupted status. #pw-internal
@@ -104,7 +105,7 @@
  * 
  * Methods added by PageRender.module: 
  * -----------------------------------
- * @method string|mixed render($fieldName = '') Returns rendered page markup. If given a $fieldName argument, it behaves same as the renderField() method. #pw-group-output-rendering
+ * @method string|mixed render($arg1 = null, $arg2 = null) Returns rendered page markup. Please see the `PageRender::renderPage()` method for arguments and usage details. #pw-group-output-rendering
  * 
  * Methods added by PagePermissions.module: 
  * ----------------------------------------
@@ -119,6 +120,7 @@
  * @method bool addable($pageToAdd = null) Returns true if the current user can add children to the page, false if not. Optionally specify the page to be added for additional access checking. #pw-group-access
  * @method bool moveable($newParent = null) Returns true if the current user can move this page. Optionally specify the new parent to check if the page is moveable to that parent. #pw-group-access
  * @method bool sortable() Returns true if the current user can change the sort order of the current page (within the same parent). #pw-group-access
+ * @method bool cloneable($recursive = null) Can current user clone this page? Specify false for $recursive argument to ignore whether children are cloneable. @since 3.0.239 #pw-group-access
  * @property bool $viewable #pw-group-access
  * @property bool $editable #pw-group-access
  * @property bool $publishable #pw-group-access
@@ -129,6 +131,7 @@
  * @property bool $moveable #pw-group-access
  * @property bool $sortable #pw-group-access
  * @property bool $listable #pw-group-access
+ * @property bool $cloneable @since 3.0.239 #pw-group-access 
  * 
  * Methods added by PagePathHistory.module (installed by default)
  * --------------------------------------------------------------
@@ -139,7 +142,9 @@
  * Methods added by LanguageSupport.module (not installed by default) 
  * -----------------------------------------------------------------
  * @method Page setLanguageValue($language, $field, $value) Set value for field in language (requires LanguageSupport module). $language may be ID, language name or Language object. Field should be field name (string). #pw-group-languages
- * @method Page getLanguageValue($language, $field) Get value for field in language (requires LanguageSupport module). $language may be ID, language name or Language object. Field should be field name (string). #pw-group-languages
+ * @method Page setLanguageValues($field, array $values) Set value for field in one or more languages (requires LanguageSupport module). $field should be field/property name (string), $values should be array of values indexed by language name. @since 3.0.236 #pw-group-languages
+ * @method mixed getLanguageValue($language, $field) Get value for field in language (requires LanguageSupport module). $language may be ID, language name or Language object. Field should be field name (string). #pw-group-languages
+ * @method array getLanguageValues($field, array $langs = []) Get values for field or one or more languages (requires LanguageSupport module). $field should be field/property name (string), $langs should be array of language names, or omit for all languages. Returns array of values indexed by language name. @since 3.0.236 #pw-group-languages
  * 
  * Methods added by LanguageSupportPageNames.module (not installed by default)
  * ---------------------------------------------------------------------------
@@ -147,6 +152,10 @@
  * @method string localPath($language = null) Return the page path in the current user's language, or specify $language argument (Language object, name, or ID). #pw-group-languages #pw-group-urls
  * @method string localUrl($language = null) Return the page URL in the current user's language, or specify $language argument (Language object, name, or ID). #pw-group-languages #pw-group-urls
  * @method string localHttpUrl($language = null) Return the page URL (including scheme and hostname) in the current user's language, or specify $language argument (Language object, name, or ID). #pw-group-languages #pw-group-urls
+ * @method Page setLanguageStatus($language, $status = null) Set active status for language(s), can be called as `$page->setLanguageStatus('es', true);` or `$page->setLanguageStatus([ 'es' => true, 'br' => false ]);` to set multiple. @since 3.0.236 #pw-group-languages 
+ * @method array|bool getLanguageStatus($language = []) Get active status for language(s). If given a $language (Language or name of language) it returns a boolean. If given multiple language names (array), or argument omitted, it returns array like `[ 'default' => true, 'fr' => false ];`. @since 3.0.236 #pw-group-languages 
+ * @method Page setLanguageName($language, $name = null) Set page name for language with `$page->setLanguageName('es', 'hola');` or set multiple with `$page->setLanguageName([ 'default' => 'hello', 'es' => 'hola' ]);` @since 3.0.236 #pw-group-languages 
+ * @method array|string getLanguageName($language = []) Get page name for language(s). If given a Language object, it returns a string. If given array of language names, or argument omitted, it returns an array like `[ 'default' => 'hello', 'es' => 'hola' ];`. @since 3.0.236 #pw-group-languages 
  *
  * Methods added by PageFrontEdit.module (not always installed by default)
  * -----------------------------------------------------------------------
@@ -154,7 +163,7 @@
  * 
  * Methods added by ProDrafts.module (if installed)
  * ------------------------------------------------
- * @method ProDraft|\ProDraft|int|string|Page|array draft($key = null, $value = null) Helper method for drafts (added by ProDrafts). #pw-advanced
+ * @method ProDraft|int|string|Page|array draft($key = null, $value = null) Helper method for drafts (added by ProDrafts). #pw-advanced
  * 
  * Hookable methods
  * ----------------
@@ -377,7 +386,15 @@ class Page extends WireData implements \Countable, WireMatchable {
 	 * @var string
 	 *
 	 */
-	private $namePrevious; 
+	private $namePrevious;
+
+	/**
+	 * The previous sort value used by page, if changed during runtime.
+	 * 
+	 * @var int
+	 * 
+	 */
+	private $sortPrevious;
 
 	/**
 	 * The previous status used by this page, if it changed during runtime.
@@ -588,10 +605,10 @@ class Page extends WireData implements \Countable, WireMatchable {
 	/**
 	 * Create a new page in memory. 
 	 *
-	 * @param Template $tpl Template object this page should use. 
+	 * @param Template|null $tpl Template object this page should use. 
 	 *
 	 */
-	public function __construct(Template $tpl = null) {
+	public function __construct(?Template $tpl = null) {
 		parent::__construct();
 		if($tpl !== null) {
 			$tpl->wire($this);
@@ -601,6 +618,7 @@ class Page extends WireData implements \Countable, WireMatchable {
 		$this->parentPrevious = null;
 		$this->templatePrevious = null;
 		$this->statusPrevious = null;
+		$this->sortPrevious = null;
 	}
 
 	/**
@@ -700,7 +718,8 @@ class Page extends WireData implements \Countable, WireMatchable {
 				$this->setStatus($value); 
 				break;
 			case 'statusPrevious':
-				$this->statusPrevious = is_null($value) ? null : (int) $value; 
+			case 'sortPrevious':	
+				$this->$key = is_null($value) ? null : (int) $value; 
 				break;
 			case 'name':
 				$this->setName($value);
@@ -1150,6 +1169,58 @@ class Page extends WireData implements \Countable, WireMatchable {
 		return $this->values()->getDotValue($this, $key);
 	}
 
+	/**
+	 * Preload multiple fields together as a group (experimental)
+	 * 
+	 * This is an optimization that enables you to load the values for multiple fields into
+	 * a page at once, and often in a single query. For fields where it is supported, and
+	 * for cases where you have a lot of fields to load at once, it can be up to 50% faster 
+	 * than the default of lazy-loading fields. 
+	 * 
+	 * To use, call `$page->preload([ 'field1', 'field2', 'etc.' ])` before accessing 
+	 * `$page->field1`, `$page->field2`, etc.
+	 *
+	 * The more fields you give this method, the more performance improvement it can offer.
+	 * As a result, don't bother if with only a few fields, as it's less likely to make 
+	 * a difference at small scale. You will also see a more measurable benefit if preloading
+	 * fields for lots of pages at once. 
+	 * 
+	 * Preload works with some Fieldtypes and not others. For details on what it is doing,
+	 * specify `true` for the `debug` option which will make it return array of what it
+	 * loaded and what it didn't. Have a look at this array with TracyDebugger or output
+	 * a print_r() call on it, and the result is self explanatory. 
+	 * 
+	 * NOTE: This function is currently experimental, recommended for testing only. 
+	 * 
+	 * ~~~~~
+	 * // Example usage
+	 * $page->preload([ 'headline', 'body', 'sidebar', 'intro', 'summary' ]);
+	 * echo "
+	 *   <h1 id='headline'>$page->headline</h1>"; 
+	 *   <div id='intro'>$page->intro</div>
+	 *   <div id='body'>$page->body</div>
+	 *   <aside id='sidebar' pw-append>$page->sidebar</aside>
+	 *   <meta id='meta-description'>$page->summary</meta>
+	 * ";
+	 * ~~~~~
+	 *
+	 * @param array $fieldNames Names of fields to preload or omit (or blank array) 
+	 *   to preload all supported fields. 
+	 * @param array $options Options to modify default behavior:
+	 * - `debug` (bool): Specify true to return additional info in returned array (default=false). 
+	 * - See the `PagesLoader::preloadFields()` method for additional options.
+	 * @return array Array of details 
+	 * @since 3.0.243
+	 *
+	 */
+	public function preload(array $fieldNames = array(), $options = array()) {
+		if(empty($fieldNames)) {
+			return $this->wire()->pages->loader()->preloadAllFields($this, $options);
+		} else {
+			return $this->wire()->pages->loader()->preloadFields($this, $fieldNames, $options);
+		}
+	}
+
 	/**
 	 * Hookable method called when a request to a field was made that didn't match anything
 	 *
@@ -1819,6 +1890,8 @@ class Page extends WireData implements \Countable, WireMatchable {
 	 * - When a string or array, a selector is assumed and quantity will be counted based on selector.
 	 * - When boolean true, number includes only visible children (excludes unpublished, hidden, no-access, etc.)
 	 * - When boolean false, number includes all children without conditions, including unpublished, hidden, no-access, etc.
+	 * - When integer 1 number includes “viewable” children (as opposed to “visible” children, viewable children includes 
+	 *   hidden pages and also includes unpublished pages if user has page-edit permission).
 	 * @return int Number of children
 	 * @see Page::hasChildren(), Page::children(), Page::child()
 	 *
@@ -2122,7 +2195,7 @@ class Page extends WireData implements \Countable, WireMatchable {
 	 * @return Page|NullPage Returns the next sibling page, or a NullPage if none found. 
 	 *
 	 */
-	public function next($selector = '', PageArray $siblings = null) {
+	public function next($selector = '', ?PageArray $siblings = null) {
 		if($selector instanceof PageArray) {
 			$siblings = $selector;
 			$selector = '';
@@ -2179,7 +2252,7 @@ class Page extends WireData implements \Countable, WireMatchable {
 	 * @return PageArray
 	 *
 	 */
-	public function nextUntil($selector = '', $filter = '', PageArray $siblings = null) {
+	public function nextUntil($selector = '', $filter = '', ?PageArray $siblings = null) {
 		if($siblings === null && $this->traversalPages) $siblings = $this->traversalPages;
 		if($siblings) return $this->traversal()->nextUntilSiblings($this, $selector, $filter, $siblings); 
 		return $this->traversal()->nextUntil($this, $selector, $filter); 
@@ -2203,7 +2276,7 @@ class Page extends WireData implements \Countable, WireMatchable {
 	 * @return Page|NullPage Returns the previous sibling page, or a NullPage if none found. 
 	 *
 	 */
-	public function prev($selector = '', PageArray $siblings = null) {
+	public function prev($selector = '', ?PageArray $siblings = null) {
 		if($selector instanceof PageArray) {
 			$siblings = $selector;
 			$selector = '';
@@ -2242,7 +2315,7 @@ class Page extends WireData implements \Countable, WireMatchable {
 	 * @return PageArray
 	 *
 	 */
-	public function prevUntil($selector = '', $filter = '', PageArray $siblings = null) {
+	public function prevUntil($selector = '', $filter = '', ?PageArray $siblings = null) {
 		if($siblings === null && $this->traversalPages) $siblings = $this->traversalPages;
 		if($siblings) return $this->traversal()->prevUntilSiblings($this, $selector, $filter, $siblings);
 		return $this->traversal()->prevUntil($this, $selector, $filter); 
@@ -2329,7 +2402,7 @@ class Page extends WireData implements \Countable, WireMatchable {
 	 * @param array $options See Pages::save() documentation for options. You may also specify $options as the first argument if no $field is needed.
 	 * @return bool Returns true on success false on fail
 	 * @throws WireException on database error
-	 * @see Pages::save(), Pages::saveField(), Pages::saveReady(), Pages::saveFieldReady(), Pages::saved(), Pages::fieldSaved()
+	 * @see Pages::save(), Page::saveFields(), Pages::saveField(), Pages::saveReady(), Pages::saveFieldReady(), Pages::saved(), Pages::fieldSaved()
 	 *
 	 */
 	public function save($field = null, array $options = array()) {
@@ -2355,6 +2428,21 @@ class Page extends WireData implements \Countable, WireMatchable {
 		
 		return $pages->save($this, $options);
 	}
+
+	/**
+	 * Save only the given named fields for this page
+	 * 
+	 * @param array|string $fields Array of field name(s) or string (CSV or space separated)
+	 * @param array $options See Pages::save() documentation for options.
+	 * @return array Names of fields that were saved
+	 * @throws WireException on database error
+	 * @see Page::save()
+	 * @since 3.0.242
+	 * 
+	 */
+	public function saveFields($fields, array $options = array()) {
+		return $this->wire()->pages->saveFields($this, $fields, $options);
+	}
 	
 	/**
 	 * Quickly set field value(s) and save to database 
@@ -2406,6 +2494,7 @@ class Page extends WireData implements \Countable, WireMatchable {
 		if($of) $this->of(false);
 		foreach($values as $k => $v) {
 			$this->set($k, $v);
+			if(!$property) $this->trackChange($k);
 		}
 		if($property) {
 			$result = $this->save($property, $options);
@@ -2843,6 +2932,7 @@ class Page extends WireData implements \Countable, WireMatchable {
 	 *  - `http` (bool): True to force scheme and hostname in URL (default=auto detect).
 	 *  - `language` (Language|bool): Optionally specify Language to start editor in, or boolean true to force current user language.
 	 *  - `find` (string): Name of field to find in the editor (3.0.151+)
+	 *  - `vars` (array): Additional variables to include in query string (3.0.239+)
 	 * @return string URL for editing this page
 	 * 
 	 */
@@ -3000,6 +3090,23 @@ class Page extends WireData implements \Countable, WireMatchable {
 	 *
 	 */
 	public function getInputfields($fieldName = '') {
+		if($this->wire()->hooks->isMethodHooked($this, 'getInputfields')) {
+			return $this->__call('getInputfields', array($fieldName));
+		} else {
+			return $this->___getInputfields($fieldName);
+		}
+	}
+
+	/**
+	 * Hookable version of getInputfields() method. 
+	 * 
+	 * See the getInputfields() method above for documentation details. 
+	 * 
+	 * @param string|array $fieldName
+	 * @return null|InputfieldWrapper Returns an InputfieldWrapper array of Inputfield objects, or NULL on failure.
+	 * 
+	 */
+	protected function ___getInputfields($fieldName = '') {
 		return $this->values()->getInputfields($this, $fieldName);
 	}
 
@@ -3188,7 +3295,7 @@ class Page extends WireData implements \Countable, WireMatchable {
 	}
 	
 	/**
-	 * Given a selector, return whether or not this Page matches it
+	 * Given a selector, return whether or not this Page matches using runtime/memory comparison
 	 *
 	 * ~~~~~
 	 * if($page->matches("created>=" . strtotime("today"))) {
@@ -3196,6 +3303,8 @@ class Page extends WireData implements \Countable, WireMatchable {
 	 * }
 	 * ~~~~~
 	 * 
+	 * #pw-group-traversal
+	 * 
 	 * @param string|Selectors|array $s Selector to compare against (string, Selectors object, or array).
 	 * @return bool Returns true if this page matches, or false if it doesn't. 
 	 *
@@ -3204,6 +3313,26 @@ class Page extends WireData implements \Countable, WireMatchable {
 		// This method implements the WireMatchable interface
 		return $this->comparison()->matches($this, $s);
 	}
+	
+	/**
+	 * Given a selector, return whether or not this Page matches by querying the database
+	 *
+	 * ~~~~~
+	 * if($page->matchesDatabase("created>=today")) {
+	 *   echo "This page was created today";
+	 * }
+	 * ~~~~~
+	 * 
+	 * #pw-group-traversal
+	 *
+	 * @param string|Selectors|array $s Selector to compare against (string, Selectors object, or array).
+	 * @return bool Returns true if this page matches, or false if it doesn't.
+	 * @since 3.0.225
+	 *
+	 */
+	public function matchesDatabase($s) {
+		return $this->comparison()->matches($this, $s, array('useDatabase' => true));
+	}
 
 	/**
 	 * Does this page have the specified status number or template name?
@@ -3211,7 +3340,7 @@ class Page extends WireData implements \Countable, WireMatchable {
 	 * See status flag constants at top of Page class.
 	 * You may also use status names: hidden, locked, unpublished, system, systemID
 	 * 
-	 * #pw-internal
+	 * #pw-group-status
 	 *
 	 * @param int|string|Selectors $status Status number, status name, or Template name or selector string/object
 	 * @return bool
@@ -4018,6 +4147,8 @@ class Page extends WireData implements \Countable, WireMatchable {
 				$this->namePrevious = $old;
 			} else if($what === 'status' && $old !== null) {
 				$this->statusPrevious = (int) $old;
+			} else if($what === 'sort' && $old !== null && $this->sortPrevious === null) {
+				$this->sortPrevious = (int) $old;
 			}
 		}
 		return parent::trackChange($what, $old, $new);
@@ -4178,4 +4309,3 @@ class Page extends WireData implements \Countable, WireMatchable {
 	}
 
 }
-

wire/core/PageAccess.php

@@ -5,7 +5,7 @@
  *
  * Provides implementation for Page access functions.
  *
- * ProcessWire 3.x, Copyright 2016 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  *
  */
@@ -85,7 +85,7 @@ class PageAccess {
 		
 		$parent = null;
 
-		if($type === 'edit' && $page->isTrash() && $page->id != $page->wire('config')->trashPageID) {
+		if($type === 'edit' && $page->isTrash() && $page->id != $page->wire()->config->trashPageID) {
 			// pages in trash have an edit access parent as whatever it was prior to being trashed
 			$info = $pages->trasher()->parseTrashPageName($page->name);
 			if(!empty($info['parent_id'])) $parent = $pages->get((int) $info['parent_id']);
@@ -160,9 +160,13 @@ class PageAccess {
 	 *
 	 */
 	public function wire($name = '', $value = null, $lock = false) {
-		if(!is_null($value)) return $this->wire->wire($name, $value, $lock);
-			else if($name instanceof WireFuelable && $this->wire) $name->setWire($this->wire);
-			else if($name) return $this->wire->wire($name); 
+		if(!is_null($value)) {
+			return $this->wire->wire($name, $value, $lock);
+		} else if($name instanceof WireFuelable && $this->wire) {
+			$name->setWire($this->wire);
+		} else if($name) {
+			return $this->wire->wire($name);
+		}
 		return $this->wire; 
 	}
 

wire/core/PageArray.php

@@ -28,7 +28,7 @@
  * ~~~~~
  * #pw-body
  * 
- * ProcessWire 3.x, Copyright 2021 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2024 by Ryan Cramer
  * https://processwire.com
  * 
  * @method string getMarkup($key = null) Render a simple/default markup value for each item #pw-internal
@@ -74,6 +74,16 @@ class PageArray extends PaginatedArray implements WirePaginatable {
 	 */
 	protected $keyIndex = array();
 
+	/**
+	 * Construct
+	 *
+	 */
+	public function __construct() {
+		parent::__construct();
+		$this->indexedByName = false;
+		$this->usesNumericKeys = true;
+	}
+
 	/**
 	 * Template method that descendant classes may use to validate items added to this WireArray
 	 * 
@@ -142,18 +152,6 @@ class PageArray extends PaginatedArray implements WirePaginatable {
 		}
 	}
 
-	/**
-	 * Does this PageArray use numeric keys only? (yes it does)
-	 * 
-	 * Defined here to override the slower check in WireArray
-	 * 
-	 * @return bool
-	 *
-	 */
-	protected function usesNumericKeys() {
-		return true;
-	}
-
 	/**
 	 * Per WireArray interface, return a blank Page
 	 * 
@@ -621,10 +619,16 @@ class PageArray extends PaginatedArray implements WirePaginatable {
 	 *
 	 */
 	public function __toString() {
-		$s = '';
-		foreach($this as $page) $s .= "$page|";
-		$s = rtrim($s, "|"); 
-		return $s; 
+		$ids = array();
+		if($this->lazyLoad) {
+			$items = $this;
+		} else {
+			$items = &$this->data;
+		}
+		foreach($items as $page) {
+			if(!$page instanceof NullPage) $ids[] = $page->id;
+		}
+		return implode('|', $ids);
 	}
 
 	/**
@@ -649,7 +653,8 @@ class PageArray extends PaginatedArray implements WirePaginatable {
 			if($out) {
 				$out = "<ul>$out</ul>";
 				if($this->getLimit() && $this->getTotal() > $this->getLimit()) {
-					$pager = $this->wire('modules')->get('MarkupPagerNav');
+					/** @var MarkupPagerNav $pager */
+					$pager = $this->wire()->modules->get('MarkupPagerNav');
 					$out .= $pager->render($this);
 				}
 			}
@@ -729,5 +734,3 @@ class PageArray extends PaginatedArray implements WirePaginatable {
 		}
 	}
 }
-
-

wire/core/PageComparison.php

@@ -5,13 +5,21 @@
  *
  * Provides implementation for Page comparison functions.
  *
- * ProcessWire 3.x, Copyright 2020 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  *
  */
 
 class PageComparison {
 
+	/**
+	 * Selector properties that the matches() method ignores
+	 * 
+	 * @var string[] 
+	 * 
+	 */
+	protected $matchesIgnores = array('limit', 'start', 'sort', 'include');
+
 	/** 
 	 * Is this page of the given type? (status, template, etc.)
  	 *
@@ -186,12 +194,14 @@ class PageComparison {
 	 * Given a Selectors object or a selector string, return whether this Page matches it
 	 *
 	 * @param Page $page
-	 * @param string|Selectors $s
+	 * @param string|array|Selectors $s
+	 * @param array $options Options to modify behavior (3.0.225+ only):
+	 *  - `useDatabase` (bool|null): Use database for matching rather than in-memory? (default=false)
 	 * @return bool
 	 *
 	 */
-	public function matches(Page $page, $s) {
-		
+	public function matches(Page $page, $s, array $options = array()) {
+	
 		$selectors = array();
 
 		if(is_string($s) || is_int($s)) {
@@ -204,7 +214,7 @@ class PageComparison {
 					// exit early for simple path comparison
 					return true;
 				} else if($page->name === $s) {
-					// early exit for simple name atch
+					// early exit for simple name match
 					return true;
 				} else if(Selectors::stringHasOperator($s)) {
 					// selectors string
@@ -220,47 +230,155 @@ class PageComparison {
 			}
 
 		} else if($s instanceof Selectors) {
-			$selectors = $s; 
+			$selectors = $s;
+
+		} else if(is_array($s)) {
+			$selectors = $page->wire(new Selectors($s));
 
 		} else { 
 			// unknown data type to match
 			return false;
 		}
+		
+		if(!empty($options['useDatabase'])) {
+			$selectors->add(new SelectorEqual('id', $page->id))->add(new SelectorEqual('include', 'all'));
+			return $page->wire()->pages->count($selectors) > 0;
+		}
 
-		$matches = false;
-		$ignores = array('limit', 'start', 'sort', 'include');
+		$matchFail = false;
+		$groupSelectors = array(); // same (1) item match group selectors
+		$orGroupSelectors = array(); // OR-group selectors
 
 		foreach($selectors as $selector) {
 			
-			$property = $selector->field;
-			$subproperty = '';
-			
-			if(is_array($property)) $property = reset($property);
-			if(strpos($property, '.')) list($property, $subproperty) = explode('.', $property, 2);
-			if(in_array($property, $ignores)) continue;
-			
-			$matches = true; 
-			$value = $page->getUnformatted($property); 
-		
-			if(is_object($value)) {
-				// convert object to array value(s)
-				$value = $this->getObjectValueArray($value, $subproperty);
-			} else if(is_array($value)) {
-				// ok: selector matches will accept an array
-			} else {
-				// convert to a string value, whatever it may be
-				$value = "$value";
+			if($selector->quote === '(') {
+				// OR-groups are handled below this loop
+				$orGroup = $selector->field() . '.';
+				if(!isset($orGroupSelectors[$orGroup])) $orGroupSelectors[$orGroup] = array();
+				$orGroupSelectors[$orGroup][] = $selector;
+				continue;
 			}
 			
-			if(!$selector->matches($value)) {
-				$matches = false; 
+			if(!$this->selectorMatches($page, $selector)) {
+				$matchFail = true;
 				break;
 			}
+			
+			if($selector->group !== null) {
+				// validate that same (1) item matches from these later
+				$groupName = $selector->group;
+				if(!isset($groupSelectors[$groupName])) $groupSelectors[$groupName] = array();
+				$groupSelectors[$groupName][] = $selector;
+			}
 		}
-
-		return $matches; 
+		
+		// OR-groups
+		if(!$matchFail && count($orGroupSelectors)) {
+			foreach($orGroupSelectors as /* $orGroupName => */ $selectors) {
+				$orGroupMatches = false;
+				foreach($selectors as $selector) {
+					if($this->matches($page, $selector->value)) {
+						// OR-group selector matches
+						$orGroupMatches = true;
+						break;
+					}
+				}
+				if(!$orGroupMatches) {
+					$matchFail = true;
+					break;
+				}
+			}
+		}
+	
+		// same (1) item match groups
+		if(!$matchFail && count($groupSelectors)) {
+			foreach($groupSelectors as /* $groupName => */ $selectors) {
+				$matchGroupKeys = null;
+				foreach($selectors as $selector) {
+					$keys = $selector->get('_matchGroupKeys'); // populated by selectorMatchesProperty
+					if($matchGroupKeys === null) {
+						$matchGroupKeys = $keys;
+					} else {
+						$matchGroupKeys = array_intersect($matchGroupKeys, $keys);
+					}
+				}
+				if(empty($matchGroupKeys)) {
+					$matchFail = true;
+					break;
+				}
+			}
+		}
+		
+		return !$matchFail;
 	}
 
+	/**
+	 * Return whether individual Selector object matches Page
+	 * 
+	 * @param Page $page
+	 * @param Selector $selector
+	 * @return bool
+	 * @since 3.0.231
+	 * 
+	 */
+	protected function selectorMatches(Page $page, Selector $selector) {
+		$match = false;
+		$properties = $selector->fields();
+		foreach($properties as $property) {
+			$match = $this->selectorMatchesProperty($page, $selector, $property);
+			if($match) break;
+		}
+		return $match;
+	}
+
+	/**
+	 * Return whether single property from individual Selector matches Page
+	 *
+	 * @param Page $page
+	 * @param Selector $selector
+	 * @param string $property
+	 * @return bool
+	 * @since 3.0.231
+	 *
+	 */
+	protected function selectorMatchesProperty(Page $page, Selector $selector, $property) {
+		
+		$subproperty = '';
+		if(strpos($property, '.')) list($property, $subproperty) = explode('.', $property, 2);
+		if(in_array($property, $this->matchesIgnores)) return true;
+
+		if($selector->quote === '[' && Selectors::stringHasOperator($selector->value())) {
+			$selector->value = $page->wire()->pages->findIDs($selector->value());
+		}
+		
+		$value = $page->getUnformatted($property);
+
+		if(is_object($value)) {
+			// convert object to array value(s)
+			$value = $this->getObjectValueArray($value, $subproperty);
+
+		} else if(is_array($value)) {
+			// ok: selector matches will accept an array
+
+		} else {
+			// convert to a string value, whatever it may be
+			$value = "$value";
+		}
+		
+		if(!$selector->matches($value)) return false;
+		
+		if($selector->group !== null && is_array($value)) {
+			// see which individual values match and record their keys for later comparison
+			$matchGroupKeys = array();
+			foreach($value as $key => $val) {
+				if($selector->matches($val)) $matchGroupKeys[] = $key;
+			}
+			$selector->setQuietly('_matchGroupKeys', $matchGroupKeys); // used by matches() method
+		}
+		
+		return true;
+	}
+	
 	/**
 	 * Given an object, return the value(s) it represents (optionally from a property in the object)
 	 * 
@@ -397,4 +515,3 @@ class PageComparison {
 
 
 }
-

wire/core/PageFinder.php

@@ -5,7 +5,7 @@
  *
  * Matches selector strings to pages
  * 
- * ProcessWire 3.x, Copyright 2021 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2025 by Ryan Cramer
  * https://processwire.com
  *
  * Hookable methods: 
@@ -1817,6 +1817,7 @@ class PageFinder extends Wire {
 				$tableAlias = $database->escapeTable($tableAlias);
 
 				$join = '';
+				$joinType = '';
 				$numEmptyValues = 0; 
 				$valueArray = $selector->values(true); 
 				$fieldtype = $field->type; 
@@ -1828,7 +1829,8 @@ class PageFinder extends Wire {
 					// shortcut for blank value condition: this ensures that NULL/non-existence is considered blank
 					// without this section the query would still work, but a blank value must actually be present in the field
 					$isEmptyValue = $fieldtype->isEmptyValue($field, $value);
-					$useEmpty = $isEmptyValue || $operator[0] === '<' || ((int) $value < 0 && $operator[0] === '>');	
+					$useEmpty = $isEmptyValue || $operator[0] === '<' || ((int) $value < 0 && $operator[0] === '>') 
+						|| ($operator === '!=' && $isEmptyValue === false);	
 					if($useEmpty && strpos($subfield, 'data') === 0) { // && !$fieldtype instanceof FieldtypeMulti) {
 						if($isEmptyValue) $numEmptyValues++;
 						if(in_array($operator, array('=', '!=', '<', '<=', '>', '>='))) {
@@ -1845,6 +1847,7 @@ class PageFinder extends Wire {
 						$q = $subqueries[$tableAlias];
 					} else {
 						$q = $this->wire(new DatabaseQuerySelect());
+						// $subqueries[$tableAlias] = $q;
 					}
 
 					/** @var PageFinderDatabaseQuerySelect $q */
@@ -1854,12 +1857,25 @@ class PageFinder extends Wire {
 					$q->set('selectors', $selectors); // original selectors (all) if required by the fieldtype
 					$q->set('parentQuery', $query);
 					$q->set('pageFinder', $this);
+					$q->set('joinType', $joinType);
 					$q->bindOption('global', true); // ensures bound value key are globally unique
 					$q->bindOption('prefix', 'pf'); // pf=PageFinder
-					
+			
+					/*	@todo To be implemented after 3.0.245
+					if(strpos($subfields, 'JSON.') === 0) {
+						if($this->getMatchQueryJSON($q, $tableAlias, $subfields, $selector->operator, $value)) {
+							continue;
+						}
+					}
+					*/
+						
 					$q = $fieldtype->getMatchQuery($q, $tableAlias, $subfield, $selector->operator, $value);
 					$q->copyTo($query, array('select', 'join', 'leftjoin', 'orderby', 'groupby')); 
 					$q->copyBindValuesTo($query);
+					
+					if($q->joinType && $q->joinType != $joinType) {
+						$joinType = strtolower((string) $q->joinType);
+					}
 
 					if(count($q->where)) { 
 						// $and = $selector->not ? "AND NOT" : "AND";
@@ -1882,9 +1898,8 @@ class PageFinder extends Wire {
 				}
 
 				if($join) {
-					$joinType = 'join';
-
-					if(count($fields) > 1 
+					if($joinType === 'leftjoin' 
+						|| count($fields) > 1 
 						|| !empty($options['startAfterID']) || !empty($options['stopBeforeID'])
 						|| (count($valueArray) > 1 && $numEmptyValues > 0)
 						|| ($subfield == 'count' && !$this->isRepeaterFieldtype($field->type))
@@ -1892,7 +1907,7 @@ class PageFinder extends Wire {
 						|| $selector->operator == '!=') {
 						// join should instead be a leftjoin
 
-						$joinType = "leftjoin";
+						$joinType = 'leftjoin';
 
 						if($where) {
 							$whereType = $lastSelector->str == $selector->str ? "OR" : ") AND (";
@@ -1904,6 +1919,8 @@ class PageFinder extends Wire {
 							// removes condition from join, but ensures we still have a $join
 							$join = '1=1'; 
 						}
+					} else {
+						$joinType = 'join';
 					}
 
 					// we compile the joins after going through all the selectors, so that we can 
@@ -1972,6 +1989,22 @@ class PageFinder extends Wire {
 		return $query; 
 	}
 
+	/**
+	 * Get match query when data is stored in a JSON DB column (future use)
+	 * 
+	 * @param PageFinderDatabaseQuerySelect DatabaseQuerySelect $q
+	 * @param string $tableAlias
+	 * @param string $subfields
+	 * @param string $operator
+	 * @param string|int|array $value
+	 * @return bool
+	 * 
+	 */
+	protected function getMatchQueryJSON(DatabaseQuerySelect $q, $tableAlias, $subfields, $operator, $value) {
+		// @todo to be implemented after 3.0.245
+		return false;
+	}
+
 	/**
 	 * Post process a DatabaseQuerySelect for page finder 
 	 * 
@@ -2137,23 +2170,55 @@ class PageFinder extends Wire {
 			
 		} else if($operator === '!=' || $operator === '<>') {
 			// not equals
-			// $whereType = 'AND';
-			if($value === "0" && !$ft->isEmptyValue($field, "0")) {
-				// may match rows with no value present
+			$whereType = count($selector->fields()) > 1 && $ft->isEmptyValue($field, $value) ? 'OR' : 'AND';
+			// alternate and technically more consistent behavior, but doesn't seem useful:
+			// $whereType = count($selector->fields()) > 1 ? 'OR' : 'AND'; 
+			$zeroIsEmpty = $ft->isEmptyValue($field, "0"); 
+			$zeroIsNotEmpty = !$zeroIsEmpty;
+			$value = (string) $value;
+			$blankValue = (string) $blankValue;
+			if($value === '') {
+				// match present rows that do not contain a blank string (or 0, when applicable)
+				$sql = "$tableAlias.$col IS NOT NULL AND ($tableAlias.$col!=''";
+				if($zeroIsEmpty) {
+					$sql .= " AND $tableAlias.$col!='0'";
+				} else {
+					$sql .= " OR $tableAlias.$col='0'";
+				}
+				$sql .= ')';
+				
+			} else if($value === "0" && $zeroIsNotEmpty) {
+				// may match non-rows (no value present) or row with value=0
 				$sql = "$tableAlias.$col IS NULL OR $tableAlias.$col!='0'";
+
+			} else if($value !== "0" && $zeroIsEmpty) {
+				// match all rows except empty and those having specific non-empty value
+				$bindKey = $query->bindValueGetKey($value);
+				$sql = "$tableAlias.$col IS NULL OR $tableAlias.$col!=$bindKey";
 				
 			} else if($blankIsObject) {
+				// match all present rows
 				$sql = "$tableAlias.$col IS NOT NULL";
 				
 			} else {
-				$bindKey = $query->bindValueGetKey($blankValue);
-				$sql = "$tableAlias.$col IS NOT NULL AND ($tableAlias.$col!=$bindKey";
-				if($blankValue !== "0" && !$ft->isEmptyValue($field, "0")) {
+				// match all present rows that are not blankValue and not given blank value...
+				$bindKeyBlank = $query->bindValueGetKey($blankValue);
+				$bindKeyValue = $query->bindValueGetKey($value);
+				$sql = "$tableAlias.$col IS NOT NULL AND $tableAlias.$col!=$bindKeyValue AND ($tableAlias.$col!=$bindKeyBlank";
+				if($zeroIsNotEmpty && $blankValue !== "0" && $value !== "0") {
+					// ...allow for 0 to match also if 0 is not considered empty value
 					$sql .= " OR $tableAlias.$col='0'";
 				}
 				$sql .= ")";
 			}
-			
+			if($ft instanceof FieldtypeMulti && !$ft->isEmptyValue($field, $value)) {
+				// when a multi-row field is in use, exclude match when any of the rows contain $value
+				$tableMulti = $table . "__multi$tableCnt";
+				$bindKey = $query->bindValueGetKey($value);
+				$query->leftjoin("$table AS $tableMulti ON $tableMulti.pages_id=pages.id AND $tableMulti.$col=$bindKey");
+				$query->where("$tableMulti.$col IS NULL");
+			}
+
 		} else if($operator == '<' || $operator == '<=') {
 			// less than 
 			if($value > 0 && $ft->isEmptyValue($field, "0")) {
@@ -2413,6 +2478,24 @@ class PageFinder extends Wire {
 				} else {
 					$value = "pages." . $database->escapeCol($value);
 				}
+				
+			} else if(($value === 'path' || $value === 'url') && $this->wire()->modules->isInstalled('PagePaths')) {
+				static $pathN = 0;
+				$pathN++;
+				$pathsTable = "_sort_pages_paths$pathN";
+				if($language && !$language->isDefault() && $this->supportsLanguagePageNames()) {
+					$query->leftjoin("pages_paths AS $pathsTable ON $pathsTable.pages_id=pages.id AND $pathsTable.language_id=0");
+					$lid = (int) $language->id;
+					$asc = $descending ? 'DESC' : 'ASC';
+					$pathsLangTable = $pathsTable . "_$lid";
+					$s = "pages_paths AS $pathsLangTable ON $pathsLangTable.pages_id=pages.id AND $pathsLangTable.language_id=$lid";
+					$query->leftjoin($s);
+					$query->orderby("if($pathsLangTable.pages_id IS NULL, $pathsTable.path, $pathsLangTable.path) $asc");
+					$value = false;
+				} else {
+					$query->leftjoin("pages_paths AS $pathsTable ON $pathsTable.pages_id=pages.id");
+					$value = "$pathsTable.path";
+				}
 
 			} else {
 				// sort by custom field, or parent w/custom field
@@ -2667,6 +2750,7 @@ class PageFinder extends Wire {
 			// the following fields are defined in each iteration here because they may be modified in the loop
 			$table = "pages";
 			$operator = $selector->operator;
+			$not = $selector->not;
 			$compareType = $selectors::getSelectorByOperator($operator, 'compareType');
 			$isPartialOperator = ($compareType & Selector::compareTypeFind); 
 
@@ -2757,8 +2841,14 @@ class PageFinder extends Wire {
 						$field = $subfield;
 					}
 				}
-			} else if($field === 'id' && count($values) > 1 && $operator === '=' && !$selector->not) {
-				$IDs = $values;
+			} else if($field === 'id' && count($values) > 1) { 
+				if($operator === '=') {
+					$IDs = $values;
+				} else if($operator === '!=' && !$not) {
+					$not = true;
+					$operator = '=';
+					$IDs = $values;
+				}
 				
 			} else {
 				// primary field is not 'parent', 'children' or 'pages'
@@ -2766,10 +2856,10 @@ class PageFinder extends Wire {
 
 			if(count($IDs)) {
 				// parentIDs or IDs found via another query, and we don't need to match anything other than the parent ID
-				$in = $selector->not ? "NOT IN" : "IN"; 
+				$in = $not ? "NOT IN" : "IN";
 				$sql .= in_array($field, array('parent', 'parent_id')) ? "$table.parent_id " : "$table.id ";
-				$IDs = $sanitizer->intArray($IDs);
-				$strIDs = implode(',', $IDs);
+				$IDs = $sanitizer->intArray($IDs, array('strict' => true));
+				$strIDs = count($IDs) ? implode(',', $IDs) : '-1';
 				$sql .= "$in($strIDs)";
 				if($subfield === 'sort') $query->orderby("FIELD($table.id, $strIDs)");
 				unset($strIDs);
@@ -3521,10 +3611,11 @@ class PageFinder extends Wire {
 		if(count($fields) > 1) {
 			// OR fields present
 			array_shift($fields);
-			$subfields = array($subfields);
+			$subfields = array($subfields); // 1. subfields is definitely an array…
 			foreach($fields as $name) {
 				if(strpos($name, "$fieldName.") === 0) {
-					list(,$name) = explode('__owner.', $name); 	
+					list(,$name) = explode('__owner.', $name);
+					/** @var array $subfields 2. …but PhpStorm in PHP8 mode can't tell it's an array without this */
 					$subfields[] = $name;
 				} else {
 					$this->syntaxError(
@@ -3596,7 +3687,7 @@ class PageFinder extends Wire {
 	 * @return array
 	 * 
 	 */
-	public function getPageArrayData(PageArray $pageArray = null) {
+	public function getPageArrayData(?PageArray $pageArray = null) {
 		if($pageArray !== null && count($this->pageArrayData)) {
 			$pageArray->data($this->pageArrayData); 
 		}
@@ -3687,6 +3778,6 @@ class PageFinder extends Wire {
  * @property Selectors $selectors Original Selectors object
  * @property DatabaseQuerySelect $parentQuery Parent database query
  * @property PageFinder $pageFinder PageFinder instance that initiated the query
+ * @property string $joinType Value 'join', 'leftjoin', or '' (if not yet known), can be overridden (3.0.237+)
  */
 abstract class PageFinderDatabaseQuerySelect extends DatabaseQuerySelect { }
-

wire/core/PageProperties.php

@@ -9,7 +9,7 @@
  * Except where indicated, please treat these properties as private to the 
  * Page class. 
  *
- * ProcessWire 3.x, Copyright 2021 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2024 by Ryan Cramer
  * https://processwire.com
  *
  */
@@ -75,6 +75,7 @@ abstract class PageProperties {
 		'addable' => 'm',
 		'child' => 'm',
 		'children' => 'm',
+		'cloneable' => 'm',
 		'created' => 's',
 		'createdStr' => '',
 		'createdUser' => '',
@@ -137,6 +138,7 @@ abstract class PageProperties {
 		'rootParent' => 'm',
 		'siblings' => 'm',
 		'sort' => 's',
+		'sortPrevious' => 'p',
 		'sortable' => 'm',
 		'sortfield' => 's',
 		'status' => 's',

wire/core/PageTraversal.php

@@ -624,7 +624,7 @@ class PageTraversal {
 			'host' => '', 
 			'pageNum' => is_int($options) || (is_string($options) && in_array($options, array('+', '-'))) ? $options : 1,
 			'data' => array(),
-			'urlSegmentStr' => is_string($options) ? $options : '',
+			'urlSegmentStr' => (is_string($options) && !in_array($options, array('+', '-'))) ? $options : '',
 			'urlSegments' => array(),
 			'language' => is_object($options) && wireInstanceOf($options, 'Language') ? $options : null,
 		);
@@ -650,13 +650,14 @@ class PageTraversal {
 			$options['pageNum'] = $input->pageNum();
 		}
 
-		if(count($options['urlSegments'])) {
+		if(is_array($options['urlSegments']) && count($options['urlSegments'])) {
 			$str = '';
-			if(is_string($options['urlSegments'][0])) {
+			reset($options['urlSegments']); 
+			if(is_string(key($options['urlSegments']))) {
 				// associative array converts to key/value style URL segments
 				foreach($options['urlSegments'] as $key => $value) {
 					$str .= "$key/$value/";
-					if(is_int($key)) $str = '';
+					if(is_int($key)) $str = ''; // abort assoc array option if any int key found
 					if($str === '') break;
 				}
 			}
@@ -706,7 +707,7 @@ class PageTraversal {
 				}
 				if(!strlen($prefix)) $prefix = $config->pageNumUrlPrefix;
 				$url = rtrim($url, '/') . '/' . $prefix . ((int) $options['pageNum']);
-				if($template->slashPageNum) $url .= '/';
+				if(((int) $template->slashPageNum) === 1) $url .= '/';
 			}
 		}
 
@@ -851,6 +852,7 @@ class PageTraversal {
 	 *  - `http` (bool): True to force scheme and hostname in URL (default=auto detect).
 	 *  - `language` (Language|bool): Optionally specify Language to start editor in, or boolean true to force current user language.
 	 *  - `find` (string): Name of field to find in the editor (3.0.151+)
+	 *  - `vars` (array): Additional variables to include in query string (3.0.239+)
 	 * @return string URL for editing this page
 	 *
 	 */
@@ -861,6 +863,7 @@ class PageTraversal {
 		$https = $adminTemplate && ($adminTemplate->https > 0) && !$config->noHTTPS;
 		$url = ($https && !$config->https) ? 'https://' . $config->httpHost : '';
 		$url .= $config->urls->admin . "page/edit/?id=$page->id";
+		$optionsArray = is_array($options) ? $options : array();
 
 		if($options === true || (is_array($options) && !empty($options['http']))) {
 			if(strpos($url, '://') === false) {
@@ -871,15 +874,22 @@ class PageTraversal {
 		$languages = $page->wire()->languages;
 		if($languages) {
 			$language = $page->wire()->user->language;
-			if(empty($options['language'])) {
+			if(empty($optionsArray['language'])) {
 				if($page->wire()->page->template->id == $adminTemplate->id) $language = null;
-			} else if($options['language'] instanceof Page) {
-				$language = $options['language'];
-			} else if($options['language'] !== true) {
-				$language = $languages->get($options['language']);
+			} else if($optionsArray['language'] instanceof Page) {
+				$language = $optionsArray['language'];
+			} else if($optionsArray['language'] !== true) {
+				$language = $languages->get($optionsArray['language']);
 			}
 			if($language && $language->id) $url .= "&language=$language->id";
 		}
+		
+		$version = (int) ((string) $page->get('_version|_repeater_version'));
+		if($version) $url .= "&version=$version";
+		
+		if(!empty($optionsArray['vars'])) {
+			$url .= '&' . http_build_query($optionsArray['vars']); 
+		}
 
 		$append = $page->wire()->session->getFor($page, 'appendEditUrl');
 
@@ -1137,11 +1147,11 @@ class PageTraversal {
 	 *
 	 * @param Page $page
 	 * @param string|array $selector Optional selector. When specified, will find nearest next sibling that matches.
-	 * @param PageArray $siblings Optional siblings to use instead of the default. May also be specified as first argument when no selector needed.
+	 * @param PageArray|null $siblings Optional siblings to use instead of the default. May also be specified as first argument when no selector needed.
 	 * @return Page|NullPage Returns the next sibling page, or a NullPage if none found.
 	 *
 	 */
-	public function nextSibling(Page $page, $selector = '', PageArray $siblings = null) {
+	public function nextSibling(Page $page, $selector = '', ?PageArray $siblings = null) {
 		if($selector instanceof PageArray) {
 			// backwards compatible to when $siblings was first argument
 			$siblings = $selector;
@@ -1181,11 +1191,11 @@ class PageTraversal {
 	 *
 	 * @param Page $page
 	 * @param string|array $selector Optional selector. When specified, will find nearest previous sibling that matches. 
-	 * @param PageArray $siblings Optional siblings to use instead of the default. May also be specified as first argument when no selector needed.
+	 * @param PageArray|null $siblings Optional siblings to use instead of the default. May also be specified as first argument when no selector needed.
 	 * @return Page|NullPage Returns the previous sibling page, or a NullPage if none found. 
 	 *
 	 */
-	public function prevSibling(Page $page, $selector = '', PageArray $siblings = null) {
+	public function prevSibling(Page $page, $selector = '', ?PageArray $siblings = null) {
 		if($selector instanceof PageArray) {
 			// backwards compatible to when $siblings was first argument
 			$siblings = $selector;
@@ -1212,11 +1222,11 @@ class PageTraversal {
 	 *
 	 * @param Page $page
 	 * @param string|array $selector Optional selector. When specified, will filter the found siblings.
-	 * @param PageArray $siblings Optional siblings to use instead of the default. 
+	 * @param PageArray|null $siblings Optional siblings to use instead of the default. 
 	 * @return PageArray Returns all matching pages after this one.
 	 *
 	 */
-	public function nextAllSiblings(Page $page, $selector = '', PageArray $siblings = null) {
+	public function nextAllSiblings(Page $page, $selector = '', ?PageArray $siblings = null) {
 
 		if(is_null($siblings)) {
 			$siblings = $page->parent()->children();
@@ -1246,11 +1256,11 @@ class PageTraversal {
 	 *
 	 * @param Page $page
 	 * @param string|array $selector Optional selector. When specified, will filter the found siblings.
-	 * @param PageArray $siblings Optional siblings to use instead of the default. 
+	 * @param PageArray|null $siblings Optional siblings to use instead of the default. 
 	 * @return PageArray
 	 *
 	 */
-	public function prevAllSiblings(Page $page, $selector = '', PageArray $siblings = null) {
+	public function prevAllSiblings(Page $page, $selector = '', ?PageArray $siblings = null) {
 
 		if(is_null($siblings)) {
 			$siblings = $page->parent()->children();
@@ -1281,7 +1291,7 @@ class PageTraversal {
 	 * @return PageArray
 	 *
 	 */
-	public function nextUntilSiblings(Page $page, $selector = '', $filter = '', PageArray $siblings = null) {
+	public function nextUntilSiblings(Page $page, $selector = '', $filter = '', ?PageArray $siblings = null) {
 
 		if(is_null($siblings)) {
 			$siblings = $page->parent()->children();
@@ -1333,7 +1343,7 @@ class PageTraversal {
 	 * @return PageArray
 	 *
 	 */
-	public function prevUntilSiblings(Page $page, $selector = '', $filter = '', PageArray $siblings = null) {
+	public function prevUntilSiblings(Page $page, $selector = '', $filter = '', ?PageArray $siblings = null) {
 
 		if(is_null($siblings)) {
 			$siblings = $page->parent()->children();

wire/core/PageValues.php

@@ -48,7 +48,7 @@ class PageValues extends Wire {
 				$index = rtrim($index, ']');
 				if(ctype_digit($index)) $index = (int) $index;
 			}
-			if($value instanceof Page) {
+			if($value instanceof Page && !in_array($key, $wireArrayProperties)) {
 				// value is a Page
 				if(isset(PageProperties::$traversalReturnTypes[$k])) {
 					// traversal property: Page or PageArray
@@ -585,7 +585,7 @@ class PageValues extends Wire {
 			
 		} else {
 			// name being set while page is loading
-			if($charset === 'UTF8' && strpos($value, 'xn-') === 0) {
+			if($charset === 'UTF8' && strpos("$value", 'xn-') === 0) {
 				// allow decode of UTF8 name while page is loading
 				$value = $sanitizer->pageName($value, Sanitizer::toUTF8);
 			} else {
@@ -879,7 +879,7 @@ class PageValues extends Wire {
 		$template = $page->template();
 		if(!$template) return $page->_parentGet($key);
 
-		$field = $this->getField($page, $key);
+		$field = $page->getField($key);
 		$value = $page->_parentGet($key);
 
 		if(!$field) return $value;  // likely a runtime field, not part of our data
@@ -1021,7 +1021,16 @@ class PageValues extends Wire {
 	public function setFieldValue(Page $page, $key, $value, $load = true) {
 
 		if(!$page->template()) {
-			throw new WireException("You must assign a template to the page before setting field values ($key)");
+			$config = $page->wire()->config;
+			$name = strpos($key, '__') ? substr($key, 0, strpos($key, '__')) : $key;
+			$error = "You must assign a template to page $page before setting '$name' field.";
+			if($config->debug) {
+				// allow page to proceed in debug mode so that it's possible to delete it if needed
+				$page->error($error);
+				$page->template($page->wire()->pages->get($config->http404PageID)->template);
+			} else {
+				throw new WireException($error);
+			}
 		}
 		
 		$isLoaded = $page->isLoaded();
@@ -1038,7 +1047,7 @@ class PageValues extends Wire {
 		}
 
 		// check if the given key resolves to a Field or not
-		$field = $this->getField($page, $key);
+		$field = $page->getField($key);
 		if(!$field) {
 			// not a known/saveable field, let them use it for runtime storage
 			$valPrevious = $page->_parentGet($key);

wire/core/Pagefile.php

@@ -12,7 +12,7 @@
  * Pagefile objects are contained by a `Pagefiles` object. 
  * #pw-body
  * 
- * ProcessWire 3.x, Copyright 2022 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  *
  * @property-read string $url URL to the file on the server.
@@ -45,6 +45,7 @@
  * @property User|NullPage $createdUser User that added/uploaded the file or NullPage if not known (3.0.154)+. #pw-group-other
  * @property User|NullPage $modifiedUser User that last modified the file or NullPage if not known (3.0.154)+. #pw-group-other
  * @property bool $formatted True when value has had Textformatters applied. #pw-internal
+ * @property string $uploadName Original unsanitized filename at upload, see notes for uploadName() method (3.0.212+). #pw-group-other
  * 
  * @method void install($filename)
  * @method string httpUrl()
@@ -356,7 +357,7 @@ class Pagefile extends WireData implements WireArrayItem {
 		$key = $type === 'created' ? '_createdUser' : '_modifiedUser';
 		if(!$this->$key) {
 			$id = (int) parent::get($type . '_users_id');
-			$this->$key = $id ? $this->wire('users')->get($id) : new NullPage(); 
+			$this->$key = ($id ? $this->wire()->users->get($id) : new NullPage()); 
 		}
 		return $this->$key;
 	}
@@ -420,11 +421,11 @@ class Pagefile extends WireData implements WireArrayItem {
 	 * Set a description, optionally parsing JSON language-specific descriptions to separate properties
 	 *
 	 * @param string|array $value
-	 * @param Page|Language Langage to set it for. Omit to determine automatically. 
+	 * @param Language|null Langage to set it for. Omit to determine automatically. 
 	 * @return $this
 	 *
 	 */
-	protected function setDescription($value, Page $language = null) {
+	protected function setDescription($value, ?Page $language = null) {
 		
 		$languages = $this->wire()->languages;
 		
@@ -576,7 +577,7 @@ class Pagefile extends WireData implements WireArrayItem {
 
 		if(is_null($language)) {	
 			// return description for current user language, or inherit from default if not available
-			$user = $this->wire('user'); 
+			$user = $this->wire()->user; 
 			$value = null;
 			if($user->language && $user->language->id) {
 				$value = parent::get("description{$user->language}");
@@ -702,7 +703,11 @@ class Pagefile extends WireData implements WireArrayItem {
 			case 'fieldValues':	
 				$value = $this->fieldValues;
 				break;
+			case 'uploadName': 	
+				$value = $this->uploadName();
+				break;
 			default:
+				if(strpos($key, '|')) return parent::get($key);
 				$value = $this->getFieldValue($key);
 		}
 		
@@ -933,6 +938,24 @@ class Pagefile extends WireData implements WireArrayItem {
 		return $basename;
 	}
 
+	/**
+	 * Original and unsanitized filename at the time it was uploaded
+	 *
+	 * Returned value is also entity encoded if $page’s output formatting state is ON.
+	 * For files uploaded in ProcessWire 3.0.212 or newer. Falls back to current file
+	 * basename for files that were uploaded prior to 3.0.212. 
+	 * 
+	 * @return string
+	 * @since 3.0.212
+	 * 
+	 */
+	public function uploadName() {
+		$uploadName = (string) $this->filedata('uploadName');
+		if(!strlen($uploadName)) $uploadName = $this->basename();
+		if($this->page && $this->page->of()) $uploadName = $this->wire()->sanitizer->entities($uploadName);
+		return $uploadName;
+	}
+
 	/**
 	 * Get or set the "tags" property, when in use. 
 	 * 
@@ -1364,12 +1387,12 @@ class Pagefile extends WireData implements WireArrayItem {
 	 * #pw-internal
 	 * 
 	 * @param string $name
-	 * @param PagefileExtra $value
+	 * @param PagefileExtra|null $value
 	 * @return PagefileExtra[]|PagefileExtra|null
 	 * @since 3.0.132
 	 * 
 	 */
-	public function extras($name = null, PagefileExtra $value = null) {
+	public function extras($name = null, ?PagefileExtra $value = null) {
 		if($name === null) return $this->extras;
 		if($value instanceof PagefileExtra) {
 			$this->extras[$name] = $value;
@@ -1437,6 +1460,45 @@ class Pagefile extends WireData implements WireArrayItem {
 		
 		return true;
 	}
+	
+	/**
+	 * Get all filenames associated with this file
+	 *
+	 * @return array
+	 *  @since 3.0.233
+	 *
+	 */
+	public function getFiles() {
+		$filename = $this->filename();
+		$filenames = array($filename);
+		foreach($this->extras() as $extra) {
+			if($extra->exists()) $filenames[] = $extra->filename();
+		}
+		return $filenames;
+	}
+
+	/**
+	 * Get or set hidden state of this file
+	 * 
+	 * Files that are hidden do not appear in the formatted field value,
+	 * but do appear in the unformatted value. 
+	 * 
+	 * @param bool|null $set
+	 * @since 3.0.237
+	 * 
+	 */
+	public function hidden($set = null) {
+		$value = (bool) $this->filedata('_hide');
+		if($set === null || $set === $value) return $value;
+		if($set === false) {
+			$this->filedata(false, '_hide');
+		} else if($set === true) {
+			$this->filedata('_hide', true);
+		} else {
+			throw new WireException('Invalid arg for Pagefile::hidden(arg)');
+		}
+		return $set;
+	}
 
 	/**
 	 * Ensures that isset() and empty() work for dynamic class properties
@@ -1489,4 +1551,3 @@ class Pagefile extends WireData implements WireArrayItem {
 		return $info;
 	}
 }
-

wire/core/Pagefiles.php

@@ -38,7 +38,7 @@
  * Typically a Pagefiles object will be associated with a specific field attached to a Page. 
  * There may be multiple instances of Pagefiles attached to a given Page (depending on what fields are in it's fieldgroup).
  * 
- * ProcessWire 3.x, Copyright 2018 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  *
  *
@@ -124,6 +124,8 @@ class Pagefiles extends WireArray implements PageFieldValueInterface {
 	public function __construct(Page $page) {
 		$this->setPage($page); 
 		parent::__construct();
+		$this->usesNumericKeys = false;
+		$this->indexedByName = true;
 	}
 
 	/**
@@ -304,13 +306,13 @@ class Pagefiles extends WireArray implements PageFieldValueInterface {
 	/**
 	 * Get for direct access to properties
 	 * 
-	 * @param int|string $property
+	 * @param int|string $name
 	 * @return bool|mixed|Page|Wire|WireData
 	 * 
 	 */
-	public function __get($property) {
-		if(in_array($property, array('page', 'field', 'url', 'path'))) return $this->get($property); 
-		return parent::__get($property); 
+	public function __get($name) {
+		if(in_array($name, array('page', 'field', 'url', 'path'))) return $this->get($name); 
+		return parent::__get($name); 
 	}
 
 	/**
@@ -375,7 +377,9 @@ class Pagefiles extends WireArray implements PageFieldValueInterface {
 	 */
 	public function hookPageSave() {
 		
-		if($this->page && $this->field && !$this->page->isChanged($this->field->name)) return $this;
+		if($this->page && $this->field) {
+			if(!$this->page->isChanged($this->field->name)) return $this;
+		}
 		
 		$this->page->filesManager()->uncache();
 		
@@ -595,6 +599,7 @@ class Pagefiles extends WireArray implements PageFieldValueInterface {
 			}
 		}
 		
+		$basename = strtolower($basename);
 		if(!ctype_alnum(ltrim($ext, '.'))) $ext = preg_replace('/[^a-z0-9.]/', '_', $ext); 
 		if(!$allowDots && strpos($basename, '.') !== false) $basename = str_replace('.', '_', $basename); 
 		$basename .= $ext;
@@ -780,12 +785,13 @@ class Pagefiles extends WireArray implements PageFieldValueInterface {
 		if(!is_bool($set)) { 
 			// temp status is not being set
 			if(!$isTemp) return false; // if not a temp file, we can exit now
-			if(!$checkDeletable) return $isTemp; // if not checking deletable, we can exit now
+			if(!$checkDeletable) return true; // if not checking deletable, we can exit now
 		}
 
-		$user = $this->wire('user');
+		$user = $this->wire()->user;
+		$session = $this->wire()->session;
+		
 		$now = time();
-		$session = $this->wire('session');
 		$pageID = $this->page ? $this->page->id : 0;
 		$fieldID = $this->field ? $this->field->id : 0;
 		$sessionKey = "tempFiles_{$pageID}_{$fieldID}";
@@ -806,8 +812,11 @@ class Pagefiles extends WireArray implements PageFieldValueInterface {
 				unset($tempFiles[$pagefile->basename]); 	
 				// remove file from session - note that this means a 'deletable' check can only be used once, for newly uploaded files
 				// as it is assumed you will be removing the file as a result of this method call
-				if(count($tempFiles)) $session->set($this, $sessionKey, $tempFiles); 
-					else $session->remove($this, $sessionKey); 
+				if(count($tempFiles)) {
+					$session->set($this, $sessionKey, $tempFiles);
+				} else {
+					$session->remove($this, $sessionKey);
+				}
 			}
 		}
 
@@ -867,7 +876,11 @@ class Pagefiles extends WireArray implements PageFieldValueInterface {
 		}
 		if(count($removed) && $this->page && $this->field) {
 			$this->page->save($this->field->name, array('quiet' => true)); 
-			$this->message("Removed '{$this->field->name}' temp file(s) for page {$this->page->path} - " . implode(', ', $removed), Notice::debug | Notice::log); 
+			$this->message(
+				"Removed '{$this->field->name}' temp file(s) for page {$this->page->path} - " . 
+				implode(', ', $removed), 
+				Notice::debug | Notice::log
+			); 
 		}
 		return count($removed); 
 	}
@@ -979,6 +992,22 @@ class Pagefiles extends WireArray implements PageFieldValueInterface {
 		return $fieldtype->getFieldsPage($field);
 	}
 
+	/**
+	 * Get all filenames associated with this Pagefiles object
+	 *
+	 * @return array
+	 * @since 3.0.233
+	 *
+	 */
+	public function getFiles() {
+		$filenames = array();
+		foreach($this as $pagefile) {
+			/** @var Pagefile $pagefile */
+			$filenames = array_merge($filenames, $pagefile->getFiles());
+		}
+		return $filenames;
+	}
+
 	/**
 	 * Debug info
 	 * 

wire/core/Pageimage.php

@@ -154,7 +154,7 @@ class Pageimage extends Pagefile {
 	 * $pageimage = new Pageimage($page->images, '/path/to/file.png');
 	 * ~~~~~
 	 *
-	 * @param Pageimages|Pagefiles $pagefiles 
+	 * @param Pagefiles $pagefiles 
 	 * @param string $filename Full path and filename to this pagefile
 	 * @throws WireException
 	 *
@@ -543,10 +543,17 @@ class Pageimage extends Pagefile {
 		if(!$filename) $filename = $this->filename;
 		$xml = @file_get_contents($filename);
 		
-		if($xml) {
-			$a = @simplexml_load_string($xml)->attributes();
+		if($xml && false !== ($a = @simplexml_load_string($xml))) {
+			$a = $a->attributes();
 			if((int) $a->width > 0) $width = (int) $a->width;
 			if((int) $a->height > 0) $height = (int) $a->height;
+			if((!$width || !$height) && $a->viewBox) {
+				$values = explode(' ', $a->viewBox);
+				if(count($values) === 4) {
+					$width = (int) round($values[2]);
+					$height = (int) round($values[3]);
+				}
+			}
 		}
 		
 		if((!$width || !$height) && (extension_loaded('imagick') || class_exists('\IMagick'))) {
@@ -1321,16 +1328,17 @@ class Pageimage extends Pagefile {
 	/**
 	 * Get ratio of width divided by height
 	 * 
+	 * @param int $precision Optionally specify a value >2 for custom precision (default=2) 3.0.211+
 	 * @return float
 	 * @since 3.0.154
 	 * 
 	 */
-	public function ratio() {
+	public function ratio($precision = 2) {
 		$width = $this->width();
 		$height = $this->height();
 		if($width === $height) return 1.0;
 		$ratio = $width / $height;
-		$ratio = round($ratio, 2);
+		$ratio = round($ratio, max(2, (int) $precision));
 		if($ratio > 99.99) $ratio = 99.99; // max allowed width>height ratio
 		if($ratio < 0.01) $ratio = 0.01; // min allowed height>width ratio
 		return $ratio;
@@ -1628,8 +1636,7 @@ class Pageimage extends Pagefile {
 			}
 		}
 
-		/** @var Sanitizer $sanitizer */
-		$sanitizer = $this->wire('sanitizer');
+		$sanitizer = $this->wire()->sanitizer;
 		$image = $this;
 		$original = null;
 		$replacements = array();
@@ -1662,7 +1669,7 @@ class Pageimage extends Pagefile {
 		}
 		
 		if(strpos($markup, '{class}')) {
-			$class = isset($options['class']) ? $this->wire('sanitizer')->entities($options['class']) : 'pw-pageimage';
+			$class = isset($options['class']) ? $sanitizer->entities($options['class']) : 'pw-pageimage';
 			$replacements["{class}"] = $class; 
 		}
 		
@@ -1702,17 +1709,26 @@ class Pageimage extends Pagefile {
 	/**
 	 * Get WebP "extra" version of this Pageimage
 	 *
+	 * @param array $webpOptions Optionally override certain defaults from `$config->webpOptions` (requires 3.0.229+):
+	 *  - `useSrcUrlOnSize` (bool): Fallback to source file URL when webp file is larger than source? (default=true)
+	 *  - `useSrcUrlOnFail` (bool): Fallback to source file URL when webp file fails for some reason? (default=true)
+	 *  - `quality' (int): Quality setting of 1-100 where higher is better but larger in file size (default=90)
+	 *     Note that his quality setting is only used if the .webp file does not already exist. 
 	 * @return PagefileExtra
 	 * @since 3.0.132
 	 *
 	 */
-	public function webp() {
+	public function webp(array $webpOptions = array()) {
 		$webp = $this->extras('webp');
 		if(!$webp) {
 			$webp = new PagefileExtra($this, 'webp');
-			$webp->setArray($this->wire('config')->webpOptions);
+			$webpOptions = array_merge($this->wire()->config->webpOptions, $webpOptions);
+			$webp->setArray($webpOptions);
 			$this->extras('webp', $webp);
 			$webp->addHookAfter('create', $this, 'hookWebpCreate'); 
+		} else if(count($webpOptions)) {
+			/** @var PagefileExtra $webp */
+			$webp->setArray($webpOptions);
 		}
 		return $webp;
 	}
@@ -1747,6 +1763,8 @@ class Pageimage extends Pagefile {
 			$width = $this->width;
 			$height = 0;
 		}
+		$quality = (int) $webp->get('quality');
+		if($quality > 0) $options['webpQuality'] = $quality;
 		$options['webpAdd'] = true;
 		try {
 			$original->size($width, $height, $options);
@@ -1764,12 +1782,12 @@ class Pageimage extends Pagefile {
 	 * #pw-internal
 	 *
 	 * @param string $name
-	 * @param PagefileExtra $value
+	 * @param PagefileExtra|null $value
 	 * @return PagefileExtra[]
 	 * @since 3.0.132
 	 *
 	 */
-	public function extras($name = null, PagefileExtra $value = null) {
+	public function extras($name = null, ?PagefileExtra $value = null) {
 		if($name) return parent::extras($name, $value); 
 		$extras = parent::extras();
 		$extras['webp'] = $this->webp();
@@ -1834,6 +1852,28 @@ class Pageimage extends Pagefile {
 		return parent::__isset($key);
 	}
 
+	/**
+	 * Get all filenames associated with this image
+	 * 
+	 * @return array
+	 * @since 3.0.233
+	 * 
+	 */
+	public function getFiles() {
+		$filenames = parent::getFiles();
+		foreach($this->extras() as $extra) {
+			if($extra->exists()) $filenames[] = $extra->filename();
+		}
+		foreach($this->getVariations() as $pagefile) {
+			/** @var Pagefile $pagefile */
+			$filenames[] = $pagefile->filename();
+			foreach($pagefile->extras() as $extra) {
+				if($extra->exists()) $filenames[] = $extra->filename();
+			}
+		}
+		return $filenames;
+	}
+
 	/**
 	 * Basic debug info
 	 * 
@@ -1873,4 +1913,3 @@ class Pageimage extends Pagefile {
 	}
 
 }
-

wire/core/Pages.php

@@ -8,7 +8,7 @@
  *
  * This is the most used object in the ProcessWire API. 
  *
- * ProcessWire 3.x, Copyright 2022 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2024 by Ryan Cramer
  * https://processwire.com
  *
  * @link http://processwire.com/api/variables/pages/ Offical $pages Documentation
@@ -39,8 +39,9 @@
  * HOOKABLE METHODS
  * ================
  * @method PageArray find($selectorString, array $options = array()) Find and return all pages matching the given selector string. Returns a PageArray. #pw-group-retrieval
- * @method bool save(Page $page, $options = array()) Save any changes made to the given $page. Same as : $page->save() Returns true on success. #pw-group-manipulation
+ * @method bool save(Page $page, $options = array()) Save any changes made to the given $page. Same as $page->save(); Returns true on success. #pw-group-manipulation
  * @method bool saveField(Page $page, $field, array $options = array()) Save just the named field from $page. Same as: $page->save('field') #pw-group-manipulation
+ * @method array saveFields(Page $page, $fields, array $options = array()) Saved multiple named fields for $page. @since 3.0.242 #pw-group-manipulation
  * @method bool trash(Page $page, $save = true) Move a page to the trash. If you have already set the parent to somewhere in the trash, then this method won't attempt to set it again. #pw-group-manipulation
  * @method bool restore(Page $page, $save = true) Restore a trashed page to its original location. #pw-group-manipulation
  * @method int|array emptyTrash(array $options = array()) Empty the trash and return number of pages deleted. #pw-group-manipulation
@@ -62,10 +63,12 @@
  * @method saveReady(Page $page) Hook called just before a page is saved. 
  * @method saved(Page $page, array $changes = array(), $values = array()) Hook called after a page is successfully saved. 
  * @method added(Page $page) Hook called when a new page has been added. 
+ * @method moveReady(Page $page) Hook called when a page is about to be moved to another parent. 
  * @method moved(Page $page) Hook called when a page has been moved from one parent to another. 
  * @method templateChanged(Page $page) Hook called when a page template has been changed. 
  * @method trashReady(Page $page) Hook called when a page is about to be moved to the trash.
  * @method trashed(Page $page) Hook called when a page has been moved to the trash. 
+ * @method restoreReady(Page $page) Hook called when a page is about to be restored out of the trash.
  * @method restored(Page $page) Hook called when a page has been moved OUT of the trash. 
  * @method deleteReady(Page $page, array $options) Hook called just before a page is deleted. 
  * @method deleted(Page $page, array $options) Hook called after a page has been deleted. 
@@ -73,6 +76,7 @@
  * @method deletedBranch(Page $page, array $options, $numDeleted) Hook called after branch of pages deleted, on initiating page only.
  * @method cloneReady(Page $page, Page $copy) Hook called just before a page is cloned. 
  * @method cloned(Page $page, Page $copy) Hook called after a page has been successfully cloned. 
+ * @method renameReady(Page $page) Hook called when a page is about to be renamed. 
  * @method renamed(Page $page) Hook called after a page has been successfully renamed. 
  * @method sorted(Page $page, $children = false, $total = 0) Hook called after $page has been sorted.
  * @method statusChangeReady(Page $page) Hook called when a page's status has changed and is about to be saved.
@@ -87,9 +91,6 @@
  * @method savedPageOrField(Page $page, array $changes) Hook inclusive of both saved() and savedField().
  * @method found(PageArray $pages, array $details) Hook called at the end of a $pages->find().
  *
- * TO-DO
- * =====
- * @todo Update saveField to accept array of field names as an option. 
  *
  */
 
@@ -756,8 +757,8 @@ class Pages extends Wire {
 		}
 	
 		if(!empty($options['parent_id'])) {
-			unset($options['parent_id']);
 			$parent_id = (int) $options['parent_id'];
+			unset($options['parent_id']);
 		} else if($parent) {
 			unset($options['parent']);
 			if($parent instanceof Page) {
@@ -826,7 +827,7 @@ class Pages extends Wire {
 	 * - `uncacheAll` (boolean): Whether the memory cache should be cleared (default=true).
 	 * - `resetTrackChanges` (boolean): Whether the page's change tracking should be reset (default=true).
 	 * - `quiet` (boolean): When true, modified date and modified_users_id won't be updated (default=false).
-	 * - `adjustName` (boolean): Adjust page name to ensure it is unique within its parent (default=false).
+	 * - `adjustName` (boolean): Adjust page name to ensure it is unique within its parent (default=true).
 	 * - `forceID` (integer): Use this ID instead of an auto-assigned one (new page) or current ID (existing page).
 	 * - `ignoreFamily` (boolean): Bypass check of allowed family/parent settings when saving (default=false).
 	 * - `noHooks` (boolean): Prevent before/after save hooks (default=false), please also use $pages->___save() for call.
@@ -867,6 +868,36 @@ class Pages extends Wire {
 		return $this->editor()->saveField($page, $field, $options);
 	}
 
+	/**
+	 * Save multiple named fields from given page
+	 *
+	 * ~~~~~
+	 * // you can specify field names as array…
+	 * $a = $pages->saveFields($page, [ 'title', 'body', 'summary' ]);
+	 *
+	 * // …or a CSV string of field names:
+	 * $a = $pages->saveFields($page, 'title, body, summary');
+	 *
+	 * // return value is array of saved field/property names
+	 * print_r($a); // outputs: array( 'title', 'body', 'summary' )
+	 * ~~~~~
+	 *
+	 * @param Page $page Page to save
+	 * @param array|string|string[]|Field[] $fields Array of field names to save or CSV/space separated field names to save.
+	 *   These should only be Field names and not native page property names.
+	 * @param array|string $options Optionally specify one or more of the following to modify default behavior:
+	 *  - `quiet` (boolean): Specify true to bypass updating of modified user and time (default=false).
+	 *  - `noHooks` (boolean): Prevent before/after save hooks (default=false), please also use $pages->___saveField() for call.
+	 *  - See $options argument for Pages::save() for additional options
+	 * @return array Array of saved field names (may also include property names if they were modified)
+	 * @throws WireException
+	 * @since 3.0.242
+	 *
+	 */
+	public function ___saveFields(Page $page, $fields, array $options = array()) {
+		return $this->editor()->saveFields($page, $fields, $options); 
+	}
+
 	/**
 	 * Add a new page using the given template and parent
 	 *
@@ -1013,7 +1044,7 @@ class Pages extends Wire {
 	 * @throws WireException|\Exception on fatal error
 	 *
 	 */
-	public function ___clone(Page $page, Page $parent = null, $recursive = true, $options = array()) {
+	public function ___clone(Page $page, ?Page $parent = null, $recursive = true, $options = array()) {
 		return $this->editor()->_clone($page, $parent, $recursive, $options);
 	}
 
@@ -1655,13 +1686,13 @@ class Pages extends Wire {
 	 * 
 	 * #pw-group-cache
 	 * 
-	 * @param Page $page Optional Page that initiated the uncacheAll
+	 * @param Page|null $page Optional Page that initiated the uncacheAll
 	 * @param array $options Options to modify default behavior: 
 	 *   - `shallow` (bool): By default, this method also calls $page->uncache(). To prevent that call, set this to true.
 	 * @return int Number of pages uncached
 	 *
 	 */
-	public function uncacheAll(Page $page = null, array $options = array()) {
+	public function uncacheAll(?Page $page = null, array $options = array()) {
 		return $this->cacher->uncacheAll($page, $options);
 	}
 
@@ -2198,6 +2229,20 @@ class Pages extends Wire {
 		$page->setQuietly('_added', true);
 	}
 
+	/**
+	 * Hook called when a page is about to be moved to another parent
+	 *
+	 * Note the previous parent is accessible in the `$page->parentPrevious` property.
+	 *
+	 * #pw-hooker
+	 *
+	 * @param Page $page Page that is about to be moved. 
+	 * @since 3.0.235
+	 *
+	 */
+	public function ___moveReady(Page $page) {
+	}
+
 	/**
 	 * Hook called when a page has been moved from one parent to another
 	 *
@@ -2258,6 +2303,18 @@ class Pages extends Wire {
 	public function ___trashed(Page $page) { 
 		$this->log("Trashed page", $page);
 	}
+	
+	/**
+	 * Hook called when a page is about to be moved OUT of the trash (restored)
+	 *
+	 * #pw-hooker
+	 *
+	 * @param Page $page Page that is about to be restored
+	 * @since 3.0.235
+	 *
+	 */
+	public function ___restoreReady(Page $page) {
+	}
 
 	/**
 	 * Hook called when a page has been moved OUT of the trash (restored)
@@ -2387,6 +2444,29 @@ class Pages extends Wire {
 	public function ___cloned(Page $page, Page $copy) { 
 		$this->log("Cloned page to $copy->path", $page); 
 	}
+	
+	/**
+	 * Hook called when a page is about to be renamed i.e. had its name field change)
+	 *
+	 * The previous name can be accessed at `$page->namePrevious`.
+	 * The new name can be accessed at `$page->name`.
+	 *
+	 * This hook is only called when a page's name changes. It is not called when
+	 * a page is moved unless the name was changed at the same time.
+	 *
+	 * **Multi-language note:**
+	 * Also note this hook may be called if a page's multi-language name changes.
+	 * In those cases the language-specific name is stored in "name123" while the
+	 * previous value is stored in "-name123" (where 123 is the language ID).
+	 *
+	 * #pw-hooker
+	 *
+	 * @param Page $page The $page that was renamed
+	 * @since 3.0.235
+	 *
+	 */
+	public function ___renameReady(Page $page) {
+	}
 
 	/**
 	 * Hook called when a page has been renamed (i.e. had its name field change)
@@ -2594,5 +2674,3 @@ class Pages extends Wire {
 	public function ___savedPageOrField(Page $page, array $changes = array()) { }
 
 }
-
-

wire/core/PagesAccess.php

@@ -17,7 +17,7 @@
  * Pages using templates that already define their access (determined by $template->useRoles) 
  * are omitted from the pages_access table, as they aren't necessary. 
  *
- * ProcessWire 3.x, Copyright 2022 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  *
  *
@@ -194,8 +194,6 @@ class PagesAccess extends Wire {
 		if(!$accessParent->id || $accessParent->id == $page->id) {
 			// page is the same as the one that defines access, so it doesn't need to be here
 			$query = $database->prepare("DELETE FROM pages_access WHERE pages_id=:page_id"); 	
-			$query->bindValue(":page_id", $page_id, \PDO::PARAM_INT);
-			$query->execute();
 
 		} else {
 			$template_id = (int) $accessParent->template->id; 
@@ -205,11 +203,12 @@ class PagesAccess extends Wire {
 					"ON DUPLICATE KEY UPDATE templates_id=VALUES(templates_id) ";
 			
 			$query = $database->prepare($sql);
-			$query->bindValue(":page_id", $page_id, \PDO::PARAM_INT);
 			$query->bindValue(":template_id", $template_id, \PDO::PARAM_INT);
-			$query->execute();
 		}
 
+		$query->bindValue(":page_id", $page_id, \PDO::PARAM_INT);
+		$query->execute();
+
 		if($page->numChildren > 0) { 
 
 			if($page->parentPrevious && $accessParent->id != $page->id) {

wire/core/PagesEditor.php

@@ -5,7 +5,7 @@
  * 
  * Implements page manipulation methods of the $pages API variable
  *
- * ProcessWire 3.x, Copyright 2021 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2024 by Ryan Cramer
  * https://processwire.com
  * 
  */ 
@@ -27,7 +27,7 @@ class PagesEditor extends Wire {
 	 * 
 	 */
 	protected $pages;
-
+	
 	/**
 	 * Construct
 	 * 
@@ -39,7 +39,7 @@ class PagesEditor extends Wire {
 		$this->pages = $pages;
 
 		$config = $pages->wire()->config;
-		if($config->dbStripMB4 && strtolower($config->dbEngine) != 'utf8mb4') {
+		if($config->dbStripMB4 && strtolower($config->dbCharset) != 'utf8mb4') {
 			$this->addHookAfter('Fieldtype::sleepValue', $this, 'hookFieldtypeSleepValueStripMB4');
 		}
 	}
@@ -353,7 +353,7 @@ class PagesEditor extends Wire {
 				if(!$parent->id) $parent = $this->pages->get("include=all, template=$idStr");
 			}
 
-			if($parent->id) $page->parent = $parent;
+			if($parent && $parent->id) $page->parent = $parent;
 		}
 
 		// assign page name
@@ -363,7 +363,7 @@ class PagesEditor extends Wire {
 
 		// assign sort order
 		if($page->sort < 0) {
-			$page->sort = $page->parent->numChildren();
+			$page->sort = ($parent->id ? $parent->numChildren() : 0);
 		}
 
 		// assign any default values for fields
@@ -419,11 +419,14 @@ class PagesEditor extends Wire {
 	 * 	- `uncacheAll` (boolean): Whether the memory cache should be cleared (default=true)
 	 * 	- `resetTrackChanges` (boolean): Whether the page's change tracking should be reset (default=true)
 	 * 	- `quiet` (boolean): When true, created/modified time+user will use values from $page rather than current user+time (default=false)
-	 *	- `adjustName` (boolean): Adjust page name to ensure it is unique within its parent (default=false)
+	 *	- `adjustName` (boolean): Adjust page name to ensure it is unique within its parent (default=true)
 	 * 	- `forceID` (integer): Use this ID instead of an auto-assigned on (new page) or current ID (existing page)
 	 * 	- `ignoreFamily` (boolean): Bypass check of allowed family/parent settings when saving (default=false)
 	 *  - `noHooks` (boolean): Prevent before/after save hooks from being called (default=false)
 	 *  - `noFields` (boolean): Bypass saving of custom fields (default=false)
+	 *  - `caller` (string): Optional name of calling function (i.e. 'pages.trash'), for internal use (default='') 3.0.235+
+	 *  - `callback` (string|callable): Hook method name from $pages or callable to trigger after save. 
+	 *     It receives a single $page argument. For internal use. (default='') 3.0.235+
 	 * @return bool True on success, false on failure
 	 * @throws WireException
 	 *
@@ -433,11 +436,13 @@ class PagesEditor extends Wire {
 		$defaultOptions = array(
 			'uncacheAll' => true,
 			'resetTrackChanges' => true,
-			'adjustName' => false,
+			'adjustName' => true,
 			'forceID' => 0,
 			'ignoreFamily' => false,
 			'noHooks' => false, 
 			'noFields' => false, 
+			'caller' => '', 
+			'callback' => '',
 		);
 
 		if(is_string($options)) $options = Selectors::keyValueStringToArray($options);
@@ -445,11 +450,15 @@ class PagesEditor extends Wire {
 		$user = $this->wire()->user;
 		$languages = $this->wire()->languages;
 		$language = null;
+		$parentPrevious = $page->parentPrevious;
+		$caller = $options['caller'];
+		$callback = $options['callback'];
+		$useHooks = empty($options['noHooks']);
 
 		// if language support active, switch to default language so that saved fields and hooks don't need to be aware of language
-		if($languages && $page->id != $user->id) {
-			$language = $user->language && $user->language->id ? $user->language : null;
-			if($language) $user->language = $languages->getDefault();
+		if($languages && $page->id != $user->id && "$user->language") {
+			$language = $user->language;
+			$user->setLanguage($languages->getDefault());
 		}
 
 		$reason = '';
@@ -457,26 +466,42 @@ class PagesEditor extends Wire {
 		if($isNew) $this->pages->setupNew($page);
 
 		if(!$this->isSaveable($page, $reason, '', $options)) {
-			if($language) $user->language = $language;
-			throw new WireException("Can’t save page {$page->id}: {$page->path}: $reason");
+			if($language) $user->setLanguage($language);
+			throw new WireException(rtrim("Can’t save page (id=$page->id): $page->path", ": ") . ": $reason");
 		}
 
 		if($page->hasStatus(Page::statusUnpublished) && $page->template->noUnpublish) {
 			$page->removeStatus(Page::statusUnpublished);
 		}
 
-		if($page->parentPrevious && !$isNew) {
-			if($page->isTrash() && !$page->parentPrevious->isTrash()) {
-				$this->pages->trash($page, false);
-			} else if($page->parentPrevious->isTrash() && !$page->parent->isTrash()) {
-				$this->pages->restore($page, false);
+		if($parentPrevious && !$isNew) {
+			if($useHooks) $this->pages->moveReady($page);
+			if($caller !== 'pages.trash' && $caller !== 'pages.restore') {
+				if($page->isTrash() && !$parentPrevious->isTrash()) {
+					if($this->pages->trash($page, false)) $callback = 'trashed';
+				} else if($parentPrevious->isTrash() && !$page->parent->isTrash()) {
+					if($this->pages->restore($page, false)) $callback = 'restored';
+				}
 			}
 		}
 
-		$this->pages->names()->checkNameConflicts($page);
-		if(!$this->savePageQuery($page, $options)) return false;
-		$result = $this->savePageFinish($page, $isNew, $options);
-		if($language) $user->language = $language; // restore language
+		if($options['adjustName']) $this->pages->names()->checkNameConflicts($page);
+		
+		if($page->namePrevious && !$isNew && $page->namePrevious != $page->name) {
+			if($useHooks) $this->pages->renameReady($page);
+		}
+
+		$result = $this->savePageQuery($page, $options);
+		if($result) $result = $this->savePageFinish($page, $isNew, $options);
+		if($language) $user->setLanguage($language); // restore language
+		
+		if($result && !empty($callback) && $useHooks) {
+			if(is_string($callback) && ctype_alnum($callback)) {
+				$this->pages->$callback($page); // hook method name in $pages
+			} else if(is_callable($callback)) {
+				$callback($page); // user defined callback
+			}
+		}
 		
 		return $result;
 	}
@@ -790,6 +815,11 @@ class PagesEditor extends Wire {
 			if($page->templatePrevious) $this->pages->templateChanged($page);
 			if(in_array('status', $changes)) $this->pages->statusChanged($page);
 		}
+		
+		if($triggerAddedPage && $page->rootParent()->id === $this->wire()->config->trashPageID) {
+			// new page created directly in trash, not a great way to start but that's how it is
+			$this->savePageStatus($page, Page::statusTrash);
+		}
 
 		$this->pages->debugLog('save', $page, true);
 
@@ -912,6 +942,90 @@ class PagesEditor extends Wire {
 		return $return;
 	}
 
+	/**
+	 * Save multiple named fields from given page 
+	 * 
+	 * ~~~~~
+	 * // you can specify field names as array…
+	 * $a = $pages->saveFields($page, [ 'title', 'body', 'summary' ]);
+	 * 
+	 * // …or a CSV string of field names:
+	 * $a = $pages->saveFields($page, 'title, body, summary');
+	 *
+	 * // return value is array of saved field/property names 
+	 * print_r($a); // outputs: array( 'title', 'body', 'summary' )
+	 * ~~~~~
+	 * 
+	 * @param Page $page Page to save
+	 * @param array|string|string[]|Field[] $fields Array of field names to save or CSV/space separated field names to save.
+	 *   These should only be Field names and not native page property names.
+	 * @param array|string $options Optionally specify one or more of the following to modify default behavior:
+	 *  - `quiet` (boolean): Specify true to bypass updating of modified user and time (default=false).
+	 *  - `noHooks` (boolean): Prevent before/after save hooks (default=false), please also use $pages->___saveField() for call.
+	 *  - See $options argument for Pages::save() for additional options
+	 * @return array Array of saved field names (may also include property names if they were modified)
+	 * @throws WireException
+	 * @since 3.0.242
+	 * 
+	 */
+	public function saveFields(Page $page, $fields, array $options = array()) {
+
+		$saved = array();
+		$quiet = !empty($options['quiet']);
+		$noHooks = !empty($options['noHooks']);
+
+		// do not update modified user/time until last save
+		if(!$quiet) $options['quiet'] = true;
+
+		if(!is_array($fields)) {
+			$fields = explode(' ', str_replace(',', ' ', "$fields"));
+		}
+
+		foreach($fields as $key => $field) {
+			$field = trim("$field");
+			if(empty($field) || !$page->hasField($field)) unset($fields[$key]);
+		}
+
+		// save each field
+		foreach($fields as $field) {
+			if($noHooks) {
+				$success = $this->saveField($page, $field, $options);
+			} else {
+				$success = $this->pages->saveField($page, $field, $options);
+			}
+			if($success) {
+				$saved[$field] = $field;
+				$page->untrackChange($field);
+			}
+		}
+
+		if($quiet) {
+			// do not save native properties or update page modified-user/modified
+			
+		} else {
+			// finish by saving the page without fields
+			$options['quiet'] = false;
+		
+			foreach($page->getChanges() as $name) {
+				if($page->hasField($name)) continue;
+				// add only changed native properties to saved list
+				$saved[$name] = $name; 
+			}
+			
+			$options['noFields'] = true;
+			
+			if($noHooks) {
+				$this->save($page, $options);
+			} else {
+				$this->pages->save($page, $options);
+			}
+		}
+		
+		$this->pages->debugLog('saveFields', "$page:" . implode(',', $fields), $saved);
+
+		return $saved;
+	}
+
 	/**
 	 * Silently add status flag to a Page and save
 	 * 
@@ -959,7 +1073,7 @@ class PagesEditor extends Wire {
 	 * 
 	 */
 	public function saveStatus(Page $page) {
-		return $this->savePageStatus($page, $page->status) > 0;
+		return $this->savePageStatus($page, $page->status, false, 2) > 0;
 	}
 
 	/**
@@ -985,29 +1099,34 @@ class PagesEditor extends Wire {
 		$database = $this->wire()->database;
 		$rowCount = 0;
 		$multi = is_array($pageID) || $pageID instanceof PageArray;
+		$page = $pageID instanceof Page ? $pageID : null;
 		$status = (int) $status;
 		
 		if($status < 0 || $status > Page::statusMax) {
 			throw new WireException("status must be between 0 and " . Page::statusMax);
 		}
 
-		$sql = "UPDATE pages SET status=";
+		$sqlUpdate = "UPDATE pages SET status=";
 	
 		if($remove === 2) {
 			// overwrite status (internal/undocumented)
-			$sql .= "status=$status";
+			$sqlUpdate .= "status=$status";
+			if($page instanceof Page) $page->status = $status;
 		} else if($remove) {
 			// remove status
-			$sql .= "status & ~$status";
+			$sqlUpdate .= "status & ~$status";
+			if($page instanceof Page) $page->removeStatus($status);
 		} else {
 			// add status
-			$sql .= "status|$status";
+			$sqlUpdate .= "status|$status";
+			if($page instanceof Page) $page->addStatus($status);
 		}
 		
 		if($multi && $recursive) {
 			// multiple page IDs combined with recursive option, must be handled individually
 			foreach($pageID as $id) {
-				$rowCount += $this->savePageStatus((int) "$id", $status, $recursive, $remove);
+				$id = $id instanceof Page ? $id : (int) "$id";
+				$rowCount += $this->savePageStatus($id, $status, $recursive, $remove);
 			}
 			// exit early in this case
 			return $rowCount; 
@@ -1019,15 +1138,17 @@ class PagesEditor extends Wire {
 				$id = (int) "$id";
 				if($id > 0) $ids[$id] = $id;
 			}
-			if(!count($ids)) $ids[] = 0;
-			$query = $database->prepare("$sql WHERE id IN(" . implode(',', $ids) . ")");
-			$database->execute($query);
-			return $query->rowCount();
+			if(count($ids)) {
+				$query = $database->prepare("$sqlUpdate WHERE id IN(" . implode(',', $ids) . ")");
+				$database->execute($query);
+				$rowCount = $query->rowCount();
+			}
+			return $rowCount;
 			
 		} else {
 			// single page ID or Page object
 			$pageID = (int) "$pageID";
-			$query = $database->prepare("$sql WHERE id=:page_id");
+			$query = $database->prepare("$sqlUpdate WHERE id=:page_id");
 			$query->bindValue(":page_id", $pageID, \PDO::PARAM_INT);
 			$database->execute($query);
 			$rowCount = $query->rowCount();
@@ -1037,12 +1158,13 @@ class PagesEditor extends Wire {
 		
 		// recursive mode assumed from this point forward
 		$parentIDs = array($pageID);
+		$ids = [];
 
 		do {
 			$parentID = array_shift($parentIDs);
 
 			// update all children to have the same status
-			$query = $database->prepare("$sql WHERE parent_id=:parent_id");
+			$query = $database->prepare("$sqlUpdate WHERE parent_id=:parent_id");
 			$query->bindValue(":parent_id", $parentID, \PDO::PARAM_INT);
 			$database->execute($query);
 			$rowCount += $query->rowCount();
@@ -1062,18 +1184,24 @@ class PagesEditor extends Wire {
 			
 			/** @noinspection PhpAssignmentInConditionInspection */
 			while($row = $query->fetch(\PDO::FETCH_ASSOC)) {
-				$parentIDs[] = (int) $row['id'];
+				$id = (int) $row['id'];
+				$parentIDs[$id] = $id;
+				$ids[$id] = $id;
 			}
 			
 			$query->closeCursor();
 			
 		} while(count($parentIDs));
 		
+		if(count($ids)) {
+			$rowCount += $this->savePageStatus($ids, $status, false, $remove);
+		}
+
 		return $rowCount;
 	}
 	
 	/**
-	 * Permanently delete a page and it's fields.
+	 * Permanently delete a page and its fields.
 	 *
 	 * Unlike trash(), pages deleted here are not restorable.
 	 *
@@ -1096,19 +1224,35 @@ class PagesEditor extends Wire {
 			'uncacheAll' => false, 
 			'recursive' => is_bool($recursive) ? $recursive : false,
 			// internal use properties:
-			'_level' => 0,
+			// internal recursion level: incremented only by delete operations initiated by this method
+			'_level' => 0, 
+			// internal delete branch: Page object when deleting a branch
 			'_deleteBranch' => false,
 		);
 
+		// page IDs for all delete operations, cleared out once no longer recursive
+		static $deleted = array(); 
+		
+		// external recursion level: all recursive delete operations including those initiated from hooks
+		static $level = 0; 
+
 		if(is_array($recursive)) $options = $recursive; 	
 		$options = array_merge($defaults, $options);
 
+		// check if page already deleted in a recursive call 
+		if(isset($deleted[$page->id])) {
+			// page already deleted, return result from that call
+			return $options['recursive'] ? $deleted[$page->id] : true;
+		}
+
 		$this->isDeleteable($page, true); // throws WireException
+		
 		$numDeleted = 0;
 		$numChildren = $page->numChildren;
 		$deleteBranch = false;
+		$level++;
 
-		if($numChildren) {
+		if($numChildren) try {
 			if(!$options['recursive']) {
 				throw new WireException("Can't delete Page $page because it has one or more children.");
 			}
@@ -1119,17 +1263,21 @@ class PagesEditor extends Wire {
 			}
 			foreach($page->children('include=all') as $child) {
 				/** @var Page $child */
+				if(isset($deleted[$child->id])) continue;
 				$options['_level']++;
 				$result = $this->pages->delete($child, true, $options);
 				$options['_level']--;
 				if(!$result) throw new WireException("Error doing recursive page delete, stopped by page $child");
 				$numDeleted += $result;
 			}
+		} catch(\Exception $e) {
+			$level = 0;
+			$deleted = array();
+			throw $e;
 		}
 
 		// trigger a hook to indicate delete is ready and WILL occur
 		$this->pages->deleteReady($page, $options);
-
 		$this->clear($page);
 		
 		$database = $this->wire()->database;
@@ -1140,10 +1288,20 @@ class PagesEditor extends Wire {
 		$this->pages->sortfields()->delete($page);
 		$page->setTrackChanges(false);
 		$page->status = Page::statusDeleted; // no need for bitwise addition here, as this page is no longer relevant
-		$this->pages->deleted($page, $options);
 		$numDeleted++;
+		$deleted[$page->id] = $numDeleted;
+		$this->pages->deleted($page, $options);
+		
 		if($deleteBranch) $this->pages->deletedBranch($page, $options, $numDeleted);
 		if($options['uncacheAll']) $this->pages->uncacheAll($page);
+		
+		if($level > 0) $level--;
+		if($level < 1) {
+			// back at root call, reset all tracking
+			$deleted = array();
+			$level = 0;
+		}
+		
 		$this->pages->debugLog('delete', $page, true);
 
 		return $options['recursive'] ? $numDeleted : true;
@@ -1153,7 +1311,7 @@ class PagesEditor extends Wire {
 	 * Clone an entire page (including fields, file assets, and optionally children) and return it.
 	 *
 	 * @param Page $page Page that you want to clone
-	 * @param Page $parent New parent, if different (default=same parent)
+	 * @param Page|null $parent New parent, if different (default=same parent)
 	 * @param bool $recursive Clone the children too? (default=true)
 	 * @param array|string $options Optional options that can be passed to clone or save
 	 * 	- forceID (int): force a specific ID
@@ -1163,7 +1321,7 @@ class PagesEditor extends Wire {
 	 * @throws WireException|\Exception on fatal error
 	 *
 	 */
-	public function _clone(Page $page, Page $parent = null, $recursive = true, $options = array()) {
+	public function _clone(Page $page, ?Page $parent = null, $recursive = true, $options = array()) {
 		
 		$defaults = array(
 			'forceID' => 0, 
@@ -1280,11 +1438,13 @@ class PagesEditor extends Wire {
 
 		if($options['recursionLevel'] === 0) {
 			// update pages_parents table, only when at recursionLevel 0 since parents()->rebuild() already descends 
+			/*
 			if($copy->numChildren) {
 				$copy->setIsNew(true);
 				$this->pages->parents()->rebuild($copy);
 				$copy->setIsNew(false);
 			}
+			*/
 			// update sort
 			if($copy->parent()->sortfield() == 'sort') {
 				$this->sortPage($copy, $copy->sort, true);

wire/core/PagesExportImport.php

@@ -18,7 +18,7 @@
  * 
  * Note: all the "change" prefix options require update=true. 
  * 
- * ProcessWire 3.x, Copyright 2017 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2024 by Ryan Cramer
  * https://processwire.com
  *
  */
@@ -35,9 +35,9 @@ class PagesExportImport extends Wire {
 	 */
 	public function getExportPath($subdir = '') {
 	
-		/** @var WireFileTools $files */
-		$files = $this->wire('files');
-		$path = $this->wire('config')->paths->assets . 'backups/' . $this->className() . '/';
+		$files = $this->wire()->files;
+		$config = $this->wire()->config;
+		$path = $config->paths->assets . 'backups/' . $this->className() . '/';
 		
 		$readmeText = "When this file is present, files and directories in here are auto-deleted after a short period of time.";
 		$readmeFile = $this->className() . '.txt';
@@ -75,8 +75,7 @@ class PagesExportImport extends Wire {
 	 */
 	public function cleanupFiles($maxAge = 3600) {
 
-		/** @var WireFileTools $files */
-		$files = $this->wire('files');
+		$files = $this->wire()->files;
 		$path = $this->getExportPath();
 		$qty = 0;
 		
@@ -111,13 +110,12 @@ class PagesExportImport extends Wire {
 	 * 
 	 * @param PageArray $items
 	 * @param array $options
-	 * @return string|bool Path+filename to ZIP file or boolean false on failure
+	 * @return string Path+filename to ZIP file 
 	 * 
 	 */
 	public function exportZIP(PageArray $items, array $options = array()) {
 		
-		/** @var WireFileTools $files */
-		$files = $this->wire('files');
+		$files = $this->wire()->files;
 		
 		$options['exportTarget'] = 'zip';
 		$zipPath = $this->getExportPath();
@@ -173,7 +171,7 @@ class PagesExportImport extends Wire {
 		$path = $tempDir->get();
 		$options['filesPath'] = $path; 
 		
-		$zipFileItems = $this->wire('files')->unzip($filename, $path); 
+		$zipFileItems = $this->wire()->files->unzip($filename, $path); 
 		
 		if(empty($zipFileItems)) return false;
 		
@@ -192,7 +190,7 @@ class PagesExportImport extends Wire {
 	 * 
 	 * @param PageArray $items
 	 * @param array $options
-	 * @return string|bool JSON string of pages or boolean false on error
+	 * @return string JSON string of pages 
 	 * 
 	 */
 	public function exportJSON(PageArray $items, array $options = array()) {
@@ -232,8 +230,9 @@ class PagesExportImport extends Wire {
 	 */
 	public function pagesToArray(PageArray $items, array $options = array()) {
 	
-		/** @var Config $config */
-		$config = $this->wire('config');
+		$config = $this->wire()->config;
+		$modules = $this->wire()->modules;
+		$fields = $this->wire()->fields;
 
 		$defaults = array(
 			'verbose' => false,
@@ -247,7 +246,7 @@ class PagesExportImport extends Wire {
 			'type' => 'ProcessWire:PageArray',
 			'created' => date('Y-m-d H:i:s'), 
 			'version' => $config->version,
-			'user' => $this->wire('user')->name,
+			'user' => $this->wire()->user->name,
 			'host' => $config->httpHost,
 			'pages' => array(),
 			'fields' => array(),
@@ -260,7 +259,7 @@ class PagesExportImport extends Wire {
 		);
 		
 		if($items->getLimit()) {
-			$pageNum = $this->wire('input')->pageNum;
+			$pageNum = $this->wire()->input->pageNum;
 			$a['pagination'] = array(
 				'start' => $items->getStart(),
 				'limit' => $items->getLimit(),
@@ -273,8 +272,7 @@ class PagesExportImport extends Wire {
 			unset($a['pagination']);
 		}
 
-		/** @var Languages $languages */
-		$languages = $this->wire('languages');
+		$languages = $this->wire()->languages;
 		if($languages) $languages->setDefault();
 		$templates = array();
 
@@ -293,9 +291,9 @@ class PagesExportImport extends Wire {
 				}
 				foreach($fieldNames as $fieldName) {
 					if(isset($a['fields'][$fieldName])) continue;
-					$field = $this->wire('fields')->get($fieldName);
+					$field = $fields->get($fieldName);
 					if(!$field || !$field->type) continue;
-					$moduleInfo = $this->wire('modules')->getModuleInfoVerbose($field->type);
+					$moduleInfo = $modules->getModuleInfoVerbose($field->type);
 					if($options['verbose']) {
 						$fieldData = $field->getExportData();
 						unset($fieldData['name']);
@@ -363,8 +361,8 @@ class PagesExportImport extends Wire {
 		$of = $page->of();
 		$page->of(false);
 
-		/** @var Languages $languages */
-		$languages = $this->wire('languages');
+		/** @var Languages|Language[] $languages */
+		$languages = $this->wire()->languages;
 		if($languages) $languages->setDefault();
 		$numFiles = 0;
 	
@@ -457,7 +455,7 @@ class PagesExportImport extends Wire {
 	 *
 	 * @param array $a
 	 * @param array $options
-	 * @return PageArray|bool
+	 * @return PageArray|int
 	 * @throws WireException
 	 *
 	 */
@@ -476,7 +474,7 @@ class PagesExportImport extends Wire {
 		if(!empty($options['pageArray']) && $options['pageArray'] instanceof PageArray) {
 			$pageArray = $options['pageArray'];
 		} else {
-			$pageArray = $this->wire('pages')->newPageArray();
+			$pageArray = $this->wire()->pages->newPageArray();
 		}
 		$count = 0;
 		
@@ -494,7 +492,7 @@ class PagesExportImport extends Wire {
 		foreach($a['pages'] as $item) {
 			$page = $this->arrayToPage($item, $options);
 			$id = $item['settings']['id'];
-			$this->wire('notices')->move($page, $pageArray, array('prefix' => "Page $id: ")); 
+			$this->wire()->notices->move($page, $pageArray, array('prefix' => "Page $id: ")); 
 			if(!$options['count']) $pageArray->add($page);
 			$count++;
 		}
@@ -680,8 +678,7 @@ class PagesExportImport extends Wire {
 	 */
 	protected function importGetPage(array &$a, array &$options, array &$errors) {
 		
-		/** @var Pages $pages */
-		$pages = $this->wire('pages');
+		$pages = $this->wire()->pages;
 		$path = $a['path'];
 		
 		/** @var Page|NullPage $page */
@@ -738,7 +735,7 @@ class PagesExportImport extends Wire {
 		if(is_object($template)) {
 			// ok
 		} else {
-			$template = $this->wire('templates')->get($template);
+			$template = $this->wire()->templates->get($template);
 		}
 		if($template) {
 			$options['template'] = $template;
@@ -762,12 +759,12 @@ class PagesExportImport extends Wire {
 		// determine parent
 		static $previousPaths = array();
 		$usePrevious = true;
-		$pages = $this->wire('pages'); 
+		$pages = $this->wire()->pages; 
 		$path = $a['path'];
 		
 		if($options['parent']) {
 			// parent specified in options
-			if(is_object($options['parent']) && $options['parent'] instanceof Page) {
+			if($options['parent'] instanceof Page) {
 				$parent = $options['parent'];
 			} else if(ctype_digit("$options[parent]")) {
 				$parent = $pages->get((int) $options['parent']);
@@ -841,7 +838,7 @@ class PagesExportImport extends Wire {
 		if(!$isNew) $options['changeTemplate'] = false;
 		$template = $options['template'];
 		$parent = $options['parent'];
-		$languages = $this->wire('languages');
+		$languages = $this->wire()->languages;
 		$langProperties = array();
 
 		// populate page base settings
@@ -970,14 +967,19 @@ class PagesExportImport extends Wire {
 			}
 			if(!$commitException) {
 				if($pageValue !== null && $fieldtypeImportOptions['returnsPageValue']) {
-					$page->set($field->name, $pageValue);
+					// @todo debug why FieldtypeTextLanguage requires a setAndSave() at this point.
+					//if($field->type == 'FieldtypePageTitleLanguage' || $field->type == 'FieldtypeTextLanguage') {
+					//	$page->setAndSave($field->name, $pageValue);
+					// } else {
+						$page->set($field->name, $pageValue);
+					// }
 				} else if(!$fieldtypeImportOptions['returnsPageValue']) {
 					$page->trackChange("{$field->name}__");
 				}
 			}
-			if(is_object($pageValue) && $pageValue instanceof Wire) {
+			if($pageValue instanceof Wire) {
 				// movie notices from the pageValue to the page
-				$this->wire('notices')->move($pageValue, $page); 
+				$this->wire()->notices->move($pageValue, $page); 
 			}
 		} else {
 			// test import on existing page, avoids actually setting value to the page
@@ -1015,9 +1017,8 @@ class PagesExportImport extends Wire {
 		//      'file3.gif' => [ ... see above ... ],
 		// ];
 
-		/** @var Pagefiles $pagefiles */
 		$pagefiles = $page->get($field->name); 
-		if(!$pagefiles || !$pagefiles instanceof Pagefiles) {
+		if(!$pagefiles instanceof Pagefiles) {
 			$page->warning("Unable to import files to field '$field->name' because it is not a files field"); 
 			return;
 		}
@@ -1028,7 +1029,7 @@ class PagesExportImport extends Wire {
 		$variationsAdded = array();
 		
 		$maxFiles = (int) $field->get('maxFiles'); 
-		$languages = $this->wire('languages'); 
+		$languages = $this->wire()->languages; 
 		$filesPath = $pagefiles->path();
 		/** @var null|WireHttp $http */
 		$http = null; 
@@ -1132,7 +1133,7 @@ class PagesExportImport extends Wire {
 				
 				if($sourceExists) {
 					// copy variation from options[filesPath]
-					if($this->wire('files')->copy($sourceFile, $targetFile)) {
+					if($this->wire()->files->copy($sourceFile, $targetFile)) {
 						$variationsAdded[] = $name;
 					} else {
 						$page->warning("Unable to copy file (image variation): $sourceFile");
@@ -1238,13 +1239,9 @@ class PagesExportImport extends Wire {
 		$numExisting = 0;
 		$numNew = 0;
 
-		/** @var Pages $pages */
-		$pages = $this->wire('pages');
-		/** @var Fields $fields */
-		$fields = $this->wire('fields');
-		/** @var Sanitizer $sanitizer */
-		$sanitizer = $this->wire('sanitizer');
-		/** @var PageFinder $pageFinder */
+		$pages = $this->wire()->pages;
+		$fields = $this->wire()->fields;
+		$sanitizer = $this->wire()->sanitizer;
 		$pageFinder = $this->wire(new PageFinder());
 		
 		// Identify missing fields
@@ -1295,7 +1292,7 @@ class PagesExportImport extends Wire {
 
 		// determine which templates are missing, and which fields are missing from templates
 		foreach($templateNames as $templateName => $fieldNames) {
-			$template = $this->wire('templates')->get($templateName);
+			$template = $this->wire()->templates->get($templateName);
 			if($template) {
 				// template exists
 				$missingTemplateFields[$templateName] = array();
@@ -1311,7 +1308,7 @@ class PagesExportImport extends Wire {
 		}
 
 		// determine which parents are missing
-		foreach($parentPaths as $key => $path) {
+		foreach($parentPaths as /* $key => */ $path) {
 			if(isset($pagePaths[$path])) {
 				// this parent already exists or will be created during import
 			} else {

wire/core/PagesLoader.php

@@ -698,7 +698,8 @@ class PagesLoader extends Wire {
 			foreach($row as $key => $value) {
 				if(strpos($key, '__')) {
 					if($value === null) {
-						$row[$key] = 'null'; // ensure detected by later isset in foreach($joinFields)
+						// $row[$key] = 'null'; // ensure detected by later isset in foreach($joinFields)
+						$row[$key] = new NullField();
 					} else {
 						$page->setFieldValue($key, $value, false);
 					}
@@ -712,7 +713,10 @@ class PagesLoader extends Wire {
 				if(!$template->fieldgroup->hasField($joinField)) continue;
 				$field = $page->getField($joinField);
 				if(!$field || !$field->type) continue;
-				if(isset($row["{$joinField}__data"])) {
+				$v = isset($row["{$joinField}__data"]) ? $row["{$joinField}__data"] : null;
+				if($v instanceof NullField) $v = null;
+				// if(isset($row["{$joinField}__data"])) {
+				if($v !== null) {
 					if(!$field->hasFlag(Field::flagAutojoin)) {
 						$field->addFlag(Field::flagAutojoin);
 						$tmpAutojoinFields[$field->id] = $field;
@@ -785,25 +789,31 @@ class PagesLoader extends Wire {
 		$options = array_merge($defaults, $options);
 		$items = $this->pages->find($selector, $options);
 		$page = $items->first();
-		
-		if($page && !$page->viewable(false)) {
+
+		if(isset($options['findAll']) && $options['findAll'] === true) {
+			// page is always allowed through when findAll=true
+		} else if(isset($options['include']) && $options['include'] === 'all') {
+			// page is always allowed through when include=all
+		} else if($page && !$page->viewable(false)) {
 			// page found but is not viewable, check if include mode was specified and would allow the page
+			$include = isset($options['include']) ? strtolower($options['include']) : null;
+			$checkAccess = true;
 			$selectors = $items->getSelectors();
 			if($selectors) {
-				$include = $selectors->getSelectorByField('include');
+				if($include === null) {
+					$include = $selectors->getSelectorByField('include');
+					if($include) $include = strtolower($include->value());
+				}
 				$checkAccess = $selectors->getSelectorByField('check_access');
 				if(!$checkAccess) $checkAccess = $selectors->getSelectorByField('checkAccess');
 				$checkAccess = $checkAccess ? (bool) $checkAccess->value() : true;
-			} else {
-				$include = null;
-				$checkAccess = true;
 			}
 			if(!$include) {
 				// there was no “include=” selector present
 				if($checkAccess === true) $page = null;
-			} else if($include->value() === 'all') {
+			} else if($include === 'all') {
 				// allow $page to pass through with include=all mode
-			} else if($include->value() === 'unpublished' && $page->hasStatus(Page::statusUnpublished) && $checkAccess) {
+			} else if($include === 'unpublished' && $page->isUnpublished() && $checkAccess) {
 				// check if user would have access without unpublished status
 				$status = $page->status;
 				$page->setQuietly('status', $status & ~Page::statusUnpublished);
@@ -818,6 +828,109 @@ class PagesLoader extends Wire {
 		return $page && $page->id ? $page : $this->pages->newNullPage();
 	}
 	
+	/**
+	 * Find pages and cache the result for specified period of time
+	 *
+	 * Use this when you want to cache a slow or complex page finding operation so that it doesn’t
+	 * have to be repated for every web request. Note that this only caches the find operation
+	 * and not the loading of the found pages.
+	 *
+	 * ~~~~~
+	 * $items = $pages->findCache("title%=foo"); // 60 seconds (default)
+	 * $items = $pages->findCache("title%=foo", 3600); // 1 hour
+	 * $items = $pages->findCache("title%=foo", "+1 HOUR");  // same as above
+	 * ~~~~~
+	 *
+	 * @param string|array|Selectors $selector
+	 * @param int|string|bool|null $expire When the cache should expire, one of the following:
+	 *  - Max age integer (in seconds).
+	 *  - Any string accepted by PHP’s `strtotime()` that specifies when the cache should be expired.
+	 *  - Any `WireCache::expire…` constant or anything accepted by the `WireCache::get()` $expire argument.
+	 * @param array $options Options to pass to `$pages->getByIDs()`, or:
+	 *  - `findIDs` (bool): Return just the page IDs rather then the actual pages? (default=false)
+	 * @return PageArray|array
+	 * @since 3.0.218
+	 *
+	 */
+	public function findCache($selector, $expire = 60, $options = array()) {
+
+		$user = $this->wire()->user;
+		$cache = $this->wire()->cache;
+		$ns = 'pages.findCache';
+		$items = null;
+
+		if(is_string($selector)) {
+			$selectorStr = $selector;
+			$selectors = $selector;
+		} else {
+			$selectors = $this->wire(new Selectors($selector));
+			$selectorStr = (string) $selectors;
+		}
+
+		$rolesStr = (string) $user->roles;
+		if(strpos($rolesStr, '|')) {
+			$rolesArray = explode('|', $rolesStr);
+			sort($rolesArray);
+			$rolesStr = implode('|', $rolesArray);
+		}
+
+		$optionsStr = '';
+		foreach($options as $key => $value) {
+			if(!is_string($value)) {
+				if(is_array($value)) $value = print_r($value, true);
+				$value = (string) $value;
+			}
+			$optionsStr .= "$key==$value,";
+		}
+
+		$cacheName = "$rolesStr\r$selectorStr\r$optionsStr";
+		$pageNum = $this->wire()->input->pageNum();
+		if($pageNum > 1 && Selectors::selectorHasField($selectors, 'limit')) {
+			if(!Selectors::selectorHasField($selectors, 'start')) $cacheName .= "\r$pageNum";
+		}
+		$cacheName = md5($cacheName);
+		$data = $cache->getFor($ns, $cacheName, $expire);
+		
+		if(!empty($data) && $data['selector'] === $selectorStr && $data['roles'] === $rolesStr) {
+			$ids = $data['pages'];
+		} else {
+			$ids = null;
+			if(strpos($selectorStr, 'template') !== false && empty($options['template'])) {
+				$info = Selectors::selectorHasField($selectors, array('template', 'templates_id'), array('verbose' => true));
+				if($info['result']) $options['template'] = $this->wire()->templates->get($info['value']);
+				echo "template=$options[template]\n";
+			}
+		}
+
+		if($ids === null) {
+			if(empty($options['findIDs'])) {
+				$items = $this->find($selectors, $options);
+				$ids = $items->explode('id');
+			} else {
+				$ids = $this->pages->findIDs($selectors, $options);
+			}
+			$data = array(
+				'selector' => $selectorStr,
+				'roles' => $rolesStr,
+				'pages' => $ids
+			);
+			$cache->saveFor($ns, $cacheName, $data, $expire);
+			
+		} else if(empty($options['findIDs'])) {
+			$items = $this->pages->getByIDs($ids, $options);
+		}
+		
+		if(!empty($options['findIDs'])) return $ids;
+
+		foreach($items as $item) {
+			if($item instanceof NullPage || $item->status & Page::statusTrash) {
+				$items->remove($item);
+			}
+		}
+
+		return $items;
+	}
+
 	/**
 	 * Returns the first page matching the given selector with no exclusions
 	 *
@@ -1249,7 +1362,7 @@ class PagesLoader extends Wire {
 				}
 			} catch(\Exception $e) {
 				$error = $e->getMessage() . " [pageClass=$class, template=$template]";
-				$user = $this->wire('user');
+				$user = $this->wire()->user;
 				if($user && $user->isSuperuser()) $this->error($error);
 				$this->wire()->log->error($error);
 				$this->trackException($e, false);
@@ -1885,7 +1998,7 @@ class PagesLoader extends Wire {
 	/**
 	 * Count and return how many pages will match the given selector string
 	 *
-	 * @param string|array $selector Specify selector, or omit to retrieve a site-wide count.
+	 * @param string|array|Selectors $selector Specify selector, or omit to retrieve a site-wide count.
 	 * @param array|string $options See $options in Pages::find
 	 * @return int
 	 *
@@ -1913,10 +2026,338 @@ class PagesLoader extends Wire {
 			$selector .= ", limit=1";
 		} else if(is_array($selector)) {
 			$selector['limit'] = 1;
+		} else if($selector instanceof Selectors) {
+			$selector->add(new SelectorEqual('limit', 1));
 		}
 		return $this->pages->find($selector, $options)->getTotal();
 	}
 
+
+	/**
+	 * Preload/Prefetch fields for page together as a group (experimental)
+	 * 
+	 * This is an optimization that enables you to load the values for multiple fields into
+	 * a page at once, and often in a single query. This is similar to the `joinFields` option
+	 * when loading a page, or the `autojoin` option configured with a field, except that it 
+	 * can be used after a page is already loaded. It provides a performance improvement
+	 * relative lazy-loading of fields individually as they are accessed. 
+	 * 
+	 * Preload works only with Fieldtypes that do not override the core’s loading methods. 
+	 * Preload also does not work with FieldtypeMulti types at present, except for the Page
+	 * Fieldtype when configured to load a single page. Though it can be enabled for testing 
+	 * purposes using the `useFieldtypeMulti` $options argument. 
+	 * 
+	 * NOTE: This function is currently experimental, recommended for testing only.
+	 * 
+	 * @param Page $page Page to preload fields for
+	 * @param array $fieldNames Names of fields to preload
+	 * @param array $options 
+	 *  - `debug` (bool): Specify true to include additional debug info in return value (default=false). 
+	 *  - `useFieldtypeMulti` (bool): Enable FieldtypeMulti for testing purposes (default=false).
+	 *  - `loadPageRefs` (bool): Optimization to early load pages in page reference fields? (default=true)
+	 * @return array Array containing what was loaded and skipped
+	 * @since 3.0.243
+	 * 
+	 */
+	public function preloadFields(Page $page, array $fieldNames, $options = array()) {
+		
+		$defaults = [
+			'debug' => is_bool($options) ? $options : false, 
+			'useFieldtypeMulti' => false, 
+			'loadPageRefs' => true, 
+		];
+		
+		static $level = 0;
+
+		$options = is_array($options) ? array_merge($defaults, $options) : $defaults;
+		$debug = $options['debug'];
+		$database = $this->wire()->database;
+		$fieldNames = array_unique($fieldNames);
+		$fields = $page->wire()->fields;
+		$loadFields = [];
+		$loadedFields = [];
+		$selects = [];
+		$joins = [];
+		$numJoins = 0;
+		$maxJoins = 60;
+		
+		$log = [
+			'loaded' => [], 
+			'skipped' => [], 
+			'blank' => [], 
+			'queries' => 1, 
+		];
+		
+		if(!$page->id || !$page->template) return $log;
+	
+		foreach($fieldNames as $fieldKey => $fieldName) {
+
+			// identify which fields to load and which to skip
+			$field = $fields->get($fieldName);
+			$fieldName = $field ? $field->name : '';
+			$fieldNames[$fieldKey] = $fieldName; 
+			$error = $field ? $this->skipPreloadField($page, $field, $options) : 'Field not found';
+
+			if($error) {
+				unset($fieldNames[$fieldKey]);
+				if($fieldName) $log['skipped'][] = "$fieldName ($error)";
+				continue;
+			}
+
+			$fieldtype = $field->type;
+			$schema = $fieldtype->trimDatabaseSchema($fieldtype->getDatabaseSchema($field));
+			$numJoins += count($schema);
+			
+			if($numJoins >= $maxJoins) break;
+			
+			$loadFields[$fieldName] = $field;
+			$table = $field->getTable();
+		
+			// build selects and joins
+			foreach(array_keys($schema) as $colName) {
+				if($options['useFieldtypeMulti'] && $fieldtype instanceof FieldtypeMulti) {
+					$sep = FieldtypeMulti::multiValueSeparator;
+					$orderBy = "ORDER BY $table.sort";
+					$selects[] = "GROUP_CONCAT($table.$colName $orderBy SEPARATOR '$sep') AS `{$table}__$colName`";
+				} else {
+					$selects[] = "$table.$colName AS {$table}__$colName";
+				}
+				$joins[$table] = "LEFT JOIN $table ON $table.pages_id=pages.id";
+			}
+			
+			unset($fieldNames[$fieldKey]);
+		}
+		
+		if(!count($selects)) return $log;
+
+		$trackChanges = $level ? null : $page->trackChanges();
+		if($trackChanges) $page->setTrackChanges(false);
+		
+		$level++;
+		$timer = $debug ? Debug::timer() : false;
+
+		// build and execute the query
+		$sql = 
+			'SELECT ' . implode(",\n", $selects) . ' ' .
+			"\nFROM pages " .
+			"\n" . implode(" \n", $joins) . ' ' .
+			"\nWHERE pages.id=:pid";
+	
+		$query = $database->prepare($sql);
+		$query->bindValue(':pid', $page->id, \PDO::PARAM_INT);
+		$query->execute();
+		
+		$data = [];
+		$row = $query->fetch(\PDO::FETCH_ASSOC);
+		$query->closeCursor();
+		
+		// combine data from DB into column groups by field name
+		if($row) {
+			foreach($row as $key => $value) {
+				list($table, $colName) = explode('__', $key, 2);
+				list(, $fieldName) = explode('_', $table, 2);
+				if(!isset($data[$fieldName])) $data[$fieldName] = [];
+				$data[$fieldName][$colName] = $value;
+			}
+		}
+
+		// wake up loaded values and populate to $page
+		$pageIds = [];
+		
+		foreach($data as $fieldName => $sleepValue) {
+			if(!isset($loadFields[$fieldName])) {
+				unset($data[$fieldName]);
+				continue;
+			}
+			$field = $loadFields[$fieldName];
+			$fieldtype = $field->type;
+			$cols = array_keys($sleepValue);
+			if(count($cols) === 1 && array_key_exists('data', $sleepValue)) {
+				$sleepValue = $sleepValue['data'];
+			}	
+			if($sleepValue === null) {
+				unset($data[$fieldName]); 
+				continue; // force to getBlankValue in loop below this
+			}
+			if($options['useFieldtypeMulti'] && $fieldtype instanceof FieldtypeMulti) { 
+				if(strrpos($sleepValue, FieldtypeMulti::multiValueSeparator)) {
+					$sleepValue = explode(FieldtypeMulti::multiValueSeparator, $sleepValue);
+				}
+			}
+			if($fieldtype instanceof FieldtypePage && $sleepValue && $options['loadPageRefs']) {
+				if(!is_array($sleepValue)) $sleepValue = [ $sleepValue ];
+				foreach($sleepValue as $pageId) {
+					$pageId = (int) $pageId;
+					if(!$pageId) continue;
+					if($this->pages->cacher()->hasCache($pageId)) continue;
+					$parentId = $field->get('parent_id');
+					$templateId = FieldtypePage::getTemplateIDs($field, true);
+					if(!ctype_digit("$parentId")) $parentId = 0;
+					if(!ctype_digit("$templateId")) $templateId = 0;
+					$groupKey = "$parentId,$templateId";
+					if(!isset($pageIds[$groupKey])) $pageIds[$groupKey] = [];
+					$pageIds[$groupKey][$pageId] = $pageId; 
+				}
+			}
+			
+			$data[$fieldName] = $sleepValue;
+		}
+	
+		// preload all pages in template or parent groups
+		if(count($pageIds)) {
+			foreach($pageIds as $groupKey => $ids) {
+				list($parentId, $templateId) = explode(',', $groupKey);
+				$this->pages->getByID($ids, [ 'template' => $templateId, 'parent_id' => $parentId ]); 
+			}
+		}
+		
+		foreach($data as $fieldName => $sleepValue) {
+			$field = $loadFields[$fieldName];
+			$fieldtype = $field->type;
+			$value = $fieldtype->wakeupValue($page, $field, $sleepValue);
+			$page->_parentSet($field->name, $value);
+			$loadedFields[$field->name] = $fieldName;
+			unset($loadFields[$field->name]);
+			$log['loaded'][] = $fieldName;
+		}
+	
+		// any remaining loadFields not present in DB should get blank value
+		foreach($loadFields as $field) {
+			$value = $field->type->getBlankValue($page, $field); 
+			$fieldName = $field->name;
+			$page->_parentSet($fieldName, $value);
+			$log['blank'][] = $fieldName;
+		}
+	
+		// go recursive for any remaining fields
+		if(count($fieldNames)) {
+			$result = $this->preloadFields($page, $fieldNames, $options);
+			foreach($log as $key => $value) {
+				if(is_array($value)) {
+					$log[$key] = array_merge($value, $result[$key]);
+				} else if(is_int($value)) {
+					$log[$key] += $result[$key];
+				}
+			}
+		}
+	
+		$level--;
+		
+		if($debug && $timer && !$level) $log['timer'] = Debug::timer($timer);
+		
+		if($trackChanges) $page->setTrackChanges($trackChanges);
+		
+		return $log;
+	}
+
+	/**
+	 * Preload all supported fields for given page (experimental)
+	 * 
+	 * NOTE: This function is currently experimental, recommended for testing only.
+	 * 
+	 * @param Page $page Page to preload fields for
+	 * @param array $options 
+	 *  - `debug` (bool): Specify true to return array of debug info (default=false).
+	 *  - `skipFieldNames` (array): Optional names of fields to skip over (default=[]). 
+	 *  - See the `PagesLoader::preloadFields()` method for additional options. 
+	 * @return array Array of details 
+	 * @since 3.0.243
+	 * 
+	 */
+	public function preloadAllFields(Page $page, $options = array()) {
+		$fieldNames = [];
+		$skipFieldNames = isset($options['skipFieldNames']) ? $options['skipFieldNames'] : false;
+		foreach($page->template->fieldgroup as $field) {
+			if($skipFieldNames && in_array($field->name, $skipFieldNames)) continue;
+			$fieldNames[] = $field->name;
+		}
+		return $this->preloadFields($page, $fieldNames, $options);
+	}
+
+	/**
+	 * Skip preloading of this field or fieldtype?
+	 * 
+	 * Returns populated string with reason if yes, or blank string if no. 
+	 * 
+	 * @param Page $page
+	 * @param Field $field
+	 * @param array $options
+	 * @return string
+	 * 
+	 */
+	protected function skipPreloadField(Page $page, Field $field, array $options) {
+		
+		static $fieldtypeErrors = [];
+
+		$useFieldtypeMulti = isset($options['useFieldtypeMulti']) ? $options['useFieldtypeMulti'] : false;
+		$error = '';
+
+		if($page->_parentGet($field->name) !== null) {
+			$error = 'Already loaded';
+		} else if(!$page->template->fieldgroup->hasField($field)) {
+			$error = "Template '$page->template' does not have field";
+		} else if(!$field->getTable()) {
+			$error = 'Field has no table';
+		}
+		
+		if($error) return $error;
+
+		$fieldtype = $field->type;
+		$shortName = $fieldtype->shortName;
+		$cacheName = $shortName;
+		
+		if($fieldtype instanceof FieldtypePage) {
+			$cacheName .= $field->get('derefAsPage');
+		}
+		
+		if(isset($fieldtypeErrors[$cacheName])) {
+			return $fieldtypeErrors[$cacheName];
+		}
+		
+		// fieldtype status not yet known
+		$schema = $fieldtype->getDatabaseSchema($field);
+		$xtra = isset($schema['xtra']) ? $schema['xtra'] : [];
+
+		if($fieldtype instanceof FieldtypeMulti) {
+			if($useFieldtypeMulti) {
+				// allow group_concat for FieldtypeMulti
+			} else if($fieldtype instanceof FieldtypePage && $field->get('derefAsPage') > 0) {
+				// allow single-page matches
+			} else {
+				$error = "$shortName: Unsupported without useFieldtypeMulti=true";
+			}
+		} else if($fieldtype instanceof FieldtypeFieldsetOpen) {
+			$error = 'Fieldset: Unsupported';
+		}
+
+		if(!$error && isset($xtra['all']) && $xtra['all'] === false) {
+			if($shortName !== 'Repeater' && $shortName !== 'RepeaterMatrix') {
+				$error = "$shortName: External storage";
+			}
+		}
+		
+		if(!$error) {
+			$ref = new \ReflectionClass($fieldtype);
+			// identify parent class that implements loadPageField method
+			$info = $ref->getMethod('___loadPageField'); 
+			$class = wireClassName($info->class); 
+			// whitelist of classes with custom loadPageField methods we support
+			$rootClasses = [ 
+				'Fieldtype', 
+				'FieldtypeMulti', 
+				'FieldtypeTextarea', 
+				'FieldtypeTextareaLanguage' 
+			];
+			if(!in_array($class, $rootClasses)) {
+				$error = "$shortName: Has custom loader";
+			}
+		}
+
+		$fieldtypeErrors[$cacheName] = $error;
+		
+		return $error;
+	}
+
 	/**
 	 * Remove pages from already-loaded PageArray aren't visible or accessible
 	 *

wire/core/PagesLoaderCache.php

@@ -84,12 +84,25 @@ class PagesLoaderCache extends Wire {
 		if(!ctype_digit("$id")) $id = str_replace('id=', '', $id);
 		if(ctype_digit("$id")) $id = (int) $id;
 		if(!isset($this->pageIdCache[$id])) return null;
-		/** @var Page $page */
-		$page = $this->pageIdCache[$id];
-		$page->setOutputFormatting($this->pages->outputFormatting);
+		$page = $this->pageIdCache[$id]; /** @var Page $page */
+		$of = $this->pages->loader()->getOutputFormatting();
+		if(!$of && $page === $this->wire()->page) return $page; // skip of() adjustment
+		$page->of($of);
 		return $page;
 	}
 
+	/**
+	 * Is given page ID in the cache?
+	 * 
+	 * @param int page ID
+	 * @return bool
+	 * @since 3.0.243
+	 * 
+	 */
+	public function hasCache($id) {
+		return isset($this->pageIdCache[$id]);
+	}
+
 	/**
 	 * Cache the given page.
 	 *
@@ -148,13 +161,13 @@ class PagesLoaderCache extends Wire {
 	/**
 	 * Remove all pages from the cache
 	 *
-	 * @param Page $page Optional Page that initiated the uncacheAll
+	 * @param Page|null $page Optional Page that initiated the uncacheAll
 	 * @param array $options Additional options to modify behavior:
 	 *   - `shallow` (bool): By default, this method also calls $page->uncache(). To prevent call to $page->uncache(), set 'shallow' => true.
 	 * @return int Number of pages uncached
 	 *
 	 */
-	public function uncacheAll(Page $page = null, array $options = array()) {
+	public function uncacheAll(?Page $page = null, array $options = array()) {
 
 		if($page) {} // to ignore unused parameter inspection
 		$user = $this->wire()->user;

wire/core/PagesParents.php

@@ -490,18 +490,21 @@ class PagesParents extends Wire {
 		
 		// homepage not maintained in pages_parents table
 		// pages being cloned are not maintained till clone operation finishes
-		if($page->id < 2 || $page->_cloning || !$page->parent) return 0;
+		if($page->id < 2 || !$page->parent) return 0;
+		// if($page->_cloning) return 0;
 		
 		// first check if page parents need any updates
 		if($page->isNew()) {
 			// newly added page
 			if($page->parent->numChildren === 1) {
 				// first time parent gets added to pages_parents
-				$numRows += $this->rebuild($page->parent);
+				$numRows += $this->addParent($page->parent);
+				// $numRows += $this->rebuild($page->parent);
 			}
 		} else if($page->parentPrevious && $page->parentPrevious->id != $page->parent->id) {
 			// existing page with parent changed
-			$this->rebuildAll();
+			$numRows += $this->movePage($page, $page->parentPrevious, $page->parent); 
+			// $this->rebuildAll();
 			/*
 			if($page->parentPrevious->numChildren === 0) {
 				// parent no longer has children and doesn’t need entry
@@ -560,6 +563,165 @@ class PagesParents extends Wire {
 		return $rowCount;
 	}
 
+	/**
+	 * Rebuild pages_parents table for given page (experimental faster alternative/rewrite of rebuild method)
+	 * 
+	 * #pw-internal
+	 * 
+	 * @param Page $page
+	 * @param Page $oldParent
+	 * @param Page $newParent
+	 * @return int
+	 * @throws WireException
+	 * @since 3.0.212
+	 * 
+	 */
+	public function movePage(Page $page, Page $oldParent, Page $newParent) {
+		
+		$key = "$page,$oldParent,$newParent";
+		if($key === $this->movePageLast) return 0;
+		$this->movePageLast = $key;
+	
+		$database = $this->wire()->database;
+		$numChildren = $page->numChildren();
+		$numRows = 0;
+	
+		$oldParentIds = $oldParent->parents()->explode('id');
+		array_shift($oldParentIds); // shift off id=1 
+		$oldParentIds[] = $oldParent->id;
+		
+		$newParentIds = $newParent->parents()->explode('id');
+		array_shift($newParentIds); // shift off id=1 
+		$newParentIds[] = $newParent->id;
+
+		// update the one page that moved
+		$sql = 'UPDATE pages_parents SET parents_id=:new_parent_id WHERE pages_id=:pages_id AND parents_id=:old_parent_id';
+		$query = $database->prepare($sql);
+		$query->bindValue(':new_parent_id', $newParent->id, \PDO::PARAM_INT);
+		$query->bindValue(':pages_id', $page->id, \PDO::PARAM_INT);
+		$query->bindValue(':old_parent_id', $oldParent->id, \PDO::PARAM_INT);
+		try {
+			$query->execute();
+		} catch(\Exception $e) {
+			if($e->getCode() != 23000) throw $e;
+		}
+		$numRows += $query->rowCount();
+
+		// find children and descendents of the page that moved
+		$sql = 'SELECT pages_id FROM pages_parents WHERE parents_id=:pages_id';
+		$query = $database->prepare($sql);
+		$query->bindValue(':pages_id', $page->id, \PDO::PARAM_INT);
+		$query->execute();
+	
+		$ids = array($page->id => $page->id);
+		while($row = $query->fetch(\PDO::FETCH_NUM)) {
+			$id = (int) $row[0];
+			$ids[$id] = $id;
+		}
+		
+		$query->closeCursor();
+		
+		$inserts = array();
+
+		foreach($ids as $id) {
+			foreach($newParentIds as $parentId) {
+				if($id === $parentId) continue;
+				$inserts[] = "$id,$parentId";
+			}
+		}
+		
+		// redundancy to capture specific missing parent situations
+		foreach($newParent->parents() as $parent) {
+			if($parent->id < 2) continue;
+			$inserts[] = "$newParent->id,$parent->id";
+			if($parent->parent_id > 1) {
+				$grandParent = $parent->parent();
+				$inserts[] = "$parent->id,$grandParent->id";
+			}
+		}
+
+		// if page has children also add it to the inserts list
+		if($numChildren) $inserts[] = "$page->id,$newParent->id";
+
+		// delete old parent IDs
+		if(count($oldParentIds) && count($ids)) {
+			$idStr = implode(',', $ids);
+			$oldParentIds = $this->wire()->sanitizer->intArray($oldParentIds);
+			$oldParentIdStr = implode(',', $oldParentIds);
+			$sql = "DELETE FROM pages_parents WHERE pages_id IN($idStr) AND parents_id IN($oldParentIdStr)";
+			$database->exec($sql);
+		}
+
+		if(!count($inserts)) return $numRows;
+		
+		$sql = "INSERT INTO pages_parents SET pages_id=:pages_id, parents_id=:parents_id";
+		$query = $database->prepare($sql);
+		
+		foreach($inserts as $insert) {
+			list($id, $parentId) = explode(',', $insert, 2);
+			$query->bindValue(':pages_id', $id, \PDO::PARAM_INT);
+			$query->bindValue(':parents_id', $parentId, \PDO::PARAM_INT); 
+			try {
+				if($query->execute()) $numRows++;
+			} catch(\Exception $e) {
+				if($e->getCode() != 23000) $this->error($e->getMessage());
+			}
+		}
+		
+		return $numRows;
+	}
+
+	/**
+	 * @var string
+	 *
+	 */
+	protected $movePageLast = '';
+
+	/**
+	 * Add rows for a new parent in the pages_parents table
+	 * 
+	 * #pw-internal
+	 * 
+	 * @param Page $page
+	 * @return int
+	 * @since 3.0.212
+	 * 
+	 */
+	protected function addParent(Page $page) {
+		
+		// if page has no children it does not need pages_parents entries
+		if(!$page->numChildren) return 0;
+	
+		$database = $this->wire()->database;
+		$numRows = 0;
+		$pageId = (int) $page->id;
+		$inserts = array();
+		
+		// identify parents to store for $page
+		foreach($page->parents() as $parent) {
+			$parentId = (int) $parent->id;
+			if($parentId < 2) continue;
+			$inserts[] = array('pages_id' => $pageId, 'parents_id' => $parentId); 
+		}
+		
+		if(!count($inserts)) return 0;
+	
+		$sql = "INSERT INTO pages_parents SET pages_id=:pages_id, parents_id=:parents_id";
+		$query = $database->prepare($sql);
+		
+		foreach($inserts as $insert) {
+			$query->bindValue(':pages_id', $insert['pages_id'], \PDO::PARAM_INT);
+			$query->bindValue(':parents_id', $insert['parents_id'], \PDO::PARAM_INT);
+			try {
+				if($query->execute()) $numRows++;
+			} catch(\Exception $e) {
+				// ok
+			}
+		}
+		
+		return $numRows;
+	}
+
 	/**
 	 * Rebuild pages_parents branch starting at $fromParent and into all descendents
 	 * 
@@ -587,7 +749,7 @@ class PagesParents extends Wire {
 		$rowCount = 0; 
 	
 		foreach($parents as $pages_id => $parents_id) {
-			if(isset($this->excludeIDs[$parents_id])) continue;
+			// if(isset($this->excludeIDs[$parents_id])) continue;
 			$inserts[] = "$pages_id,$parents_id";
 			while(isset($parents[$parents_id])) {
 				$parents_id = $parents[$parents_id];

wire/core/PagesPathFinder.php

@@ -15,7 +15,7 @@
  * afterwards when appropriate.
  * #pw-body
  * 
- * ProcessWire 3.x, Copyright 2022 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2024 by Ryan Cramer
  * https://processwire.com
  * 
  * @todo:
@@ -131,9 +131,9 @@ class PagesPathFinder extends Wire {
 	protected function init($path, array $options) {
 		
 		$this->options = array_merge($this->defaults, $options);
-		$this->verbose = $this->options['verbose'];
 		$this->methods = array();
 		$this->useLanguages = $this->options['useLanguages'] ? $this->languages(true) : array();
+		$this->verbose = $this->options['verbose'] || !empty($this->useLanguages);
 		$this->result = $this->getBlankResult(array('request' => $path));
 		$this->template = null;
 		$this->admin = null;
@@ -380,8 +380,10 @@ class PagesPathFinder extends Wire {
 	 * 
 	 */
 	protected function applyPagesRow(array $parts, $row) {
-		
-		$maxUrlSegmentLength = $this->wire()->config->maxUrlSegmentLength;
+	
+		$config = $this->wire()->config;
+		$maxUrlSegmentLength = $config->maxUrlSegmentLength;
+		$maxUrlSegments = $config->maxUrlSegments;
 		$result = &$this->result;
 		
 		// array of [language name] => [ 'a', 'b', 'c' ] (from /a/b/c/)
@@ -396,14 +398,28 @@ class PagesPathFinder extends Wire {
 
 			if(!$id) {
 				// if it didn’t resolve to DB page name then it is a URL segment
-				if(strlen($name) > $maxUrlSegmentLength) $name = substr($name, 0, $maxUrlSegmentLength);
-				$result['urlSegments'][] = $name;
-				if($this->verbose) {
-					$result['parts'][] = array(
-						'type' => 'urlSegment',
-						'value' => $name,
-						'language' => ''
-					);
+				if(strlen($name) > $maxUrlSegmentLength) {
+					$name = substr($name, 0, $maxUrlSegmentLength);
+					if($config->longUrlResponse >= 300) {
+						$result['response'] = $config->longUrlResponse;
+						$this->addResultError('urlSegmentLength', 'URL segment length > config.maxUrlSegmentLength');
+					}
+				}
+				if(count($result['urlSegments']) + 1 > $maxUrlSegments) {
+					if($config->longUrlResponse >= 300) {
+						$this->addResultError('urlSegmentMAX', 'Number of URL segments exceeds config.maxUrlSegments');
+						$result['response'] = $config->longUrlResponse;
+						break;
+					}
+				} else {
+					$result['urlSegments'][] = $name;
+					if($this->verbose) {
+						$result['parts'][] = array(
+							'type' => 'urlSegment',
+							'value' => $name,
+							'language' => ''
+						);
+					}
 				}
 				continue;
 			}
@@ -480,7 +496,7 @@ class PagesPathFinder extends Wire {
 	 * If language segment detected then remove it and populate language to result
 	 * 
 	 * @param string $path
-	 * @return array|bool
+	 * @return array
 	 * 
 	 */
 	protected function getPathParts($path) {
@@ -497,7 +513,7 @@ class PagesPathFinder extends Wire {
 		$lastPart = '';
 		
 		if($this->strlen($path) > $maxPathLength) {
-			$result['response'] = 414; // 414=URI too long
+			$result['response'] = $config->longUrlResponse; // 414=URI too long
 			$this->addResultError('pathLengthMAX', "Path length exceeds max allowed $maxPathLength");
 			$path = substr($path, 0, $maxPathLength);
 		}
@@ -506,7 +522,7 @@ class PagesPathFinder extends Wire {
 
 		if(count($parts) > $maxDepth) {
 			$parts = array_slice($parts, 0, $maxDepth);
-			$result['response'] = 414;
+			$result['response'] = $config->longUrlResponse;
 			$this->addResultError('pathDepthMAX', 'Path depth exceeds config.maxUrlDepth');
 		} else if($path === '/' || $path === '' || !count($parts)) {
 			return array();
@@ -721,7 +737,7 @@ class PagesPathFinder extends Wire {
 		$_path = $path;
 		if(strlen($appendPath)) $path = rtrim($path, '/') . $appendPath;
 		
-		if($fail || $_path !== $path) {
+		if($fail || $_path !== $path || ($hadTrailingSlash && $useTrailingSlash < 0)) {
 			if($fail && isset($result['errors']['indexFile']) && count($result['urlSegments']) === 1) {
 				// allow for an /index.php or /index.html type urlSegmentStr to redirect rather than fail
 				$fail = false;
@@ -789,7 +805,7 @@ class PagesPathFinder extends Wire {
 		
 		// if there were any non-default language segments, let that dictate the language
 		if(empty($result['language']['segment'])) {
-			$useLangName = 'default';
+			$useLangName = count($result['parts']) ? 'default' : $result['language']['name'];
 			foreach($result['parts'] as $part) {
 				$langName = $part['language'];
 				if(empty($langName) || $langName === 'default') continue;
@@ -934,7 +950,7 @@ class PagesPathFinder extends Wire {
 
 		$result['methods'] = $this->methods;
 
-		if(!$this->verbose) unset($result['parts'], $result['methods']);
+		if(!$this->options['verbose']) unset($result['parts'], $result['methods']);
 
 		if(empty($errors)) {
 			// force errors placeholder to end if there aren’t any
@@ -1422,9 +1438,8 @@ class PagesPathFinder extends Wire {
 			$this->admin = true;
 		} else {
 			$template = $this->getResultTemplate();
-			if(!$template) {
-				return false; // may need to detect later
-			} if(in_array($template->name, $config->adminTemplates, true)) {
+			if(!$template) return false; // may need to detect later
+			if(in_array($template->name, $config->adminTemplates, true)) {
 				$this->admin = true;
 			} else if(in_array($template->name, array('user', 'role', 'permission', 'language'))) {
 				$this->admin = true;
@@ -1485,7 +1500,7 @@ class PagesPathFinder extends Wire {
 	 * 
 	 */
 	protected function addResultError($name, $message, $force = false) {
-		if(!$this->verbose && !$force) return;
+		//if(!$this->verbose && !$force) return;
 		$this->result['errors'][$name] = $message;
 	}
 

wire/core/PagesRaw.php

@@ -781,6 +781,8 @@ class PagesRawFinder extends Wire {
 		$templatesById = array();
 		$getPaths = $this->getPaths;
 		
+		if(empty($this->selector)) return;
+		
 		foreach($this->findIDs($this->selector, '*') as $row) {
 			$id = (int) $row['id'];
 			$this->ids[$id] = $id;
@@ -835,7 +837,7 @@ class PagesRawFinder extends Wire {
 					if(!isset($templatesById[$templateId])) $templatesById[$templateId] = $templates->get($templateId);
 					$template = $templatesById[$templateId]; /** @var Template $template */
 					$slash = $template->slashUrls ? '/' : '';
-					$path = strlen($value) && $value !== '/' ? "$value$slash" : '';
+					$path = strlen("$value") && $value !== '/' ? "$value$slash" : '';
 					if(isset($this->runtimeFields['url'])) {
 						$this->values[$id]['url'] = $rootUrl . $path;
 					}
@@ -859,11 +861,11 @@ class PagesRawFinder extends Wire {
 	protected function findCustom() {
 		if(count($this->customFields)) {
 			// one or more custom fields requested
-			if($this->ids === null) {
+			if($this->ids === null && !empty($this->selector)) {
 				// only find IDs if we didn’t already in the nativeFields section
 				$this->setIds($this->findIDs($this->selector, false));
 			}
-			if(!count($this->ids)) return;
+			if(empty($this->ids)) return;
 			foreach($this->customFields as $fieldName => $field) {
 				/** @var Field $field */
 				$cols = isset($this->customCols[$fieldName]) ? $this->customCols[$fieldName] : array();
@@ -1142,11 +1144,12 @@ class PagesRawFinder extends Wire {
 		$this->wire($finder);
 		$options = $this->options;
 		$options['indexed'] = true;
-		$pageRefRows = $finder->find($pageRefIds, $pageRefCols, $options);
+		$pageRefRows = count($pageRefIds) ? $finder->find($pageRefIds, $pageRefCols, $options) : array();
 
 		foreach($this->values as $pageId => $pageRow) {
 			if(!isset($pageRow[$fieldName])) continue;
 			foreach($pageRow[$fieldName] as $pageRefId) {
+				if(!isset($pageRefRows[$pageRefId])) continue;
 				$this->values[$pageId][$fieldName][$pageRefId] = $pageRefRows[$pageRefId];
 			}
 			if(!$this->getMultiple && $field->get('derefAsPage') > 0) {

wire/core/PagesRequest.php

@@ -11,7 +11,7 @@
  * ~~~~~
  * #pw-body
  *
- * ProcessWire 3.x, Copyright 2022 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  * 
  * @method Page|NullPage getPage()
@@ -301,11 +301,16 @@ class PagesRequest extends Wire {
 		
 		// populate request path to class as other methods will now use it
 		$this->setRequestPath($path);
-	
-		// determine if index.php is referenced in URL
-		if(stripos($this->dirtyUrl, 'index.php') !== false && stripos($path, 'index.php') === false) {
-			// this will force pathFinder to detect a redirect condition
-			$path = rtrim($path, '/') . '/index.php';
+
+		// determine if original URL had anything filtered out of path that will suggest a redirect
+		list($dirtyUrl,) = explode('?', "$this->dirtyUrl?", 2); // exclude query string
+		if(stripos($dirtyUrl, 'index.php') !== false && stripos($path, 'index.php') === false) {
+			// force pathFinder to detect a redirect condition without index.php
+			$dirtyUrl = strtolower(rtrim($dirtyUrl, '/'));
+			if(substr("/$dirtyUrl", -10) === '/index.php') $path = rtrim($path, '/') . '/index.php';
+		} else if(strpos($dirtyUrl, '//') !== false) {
+			// force pathFinder to detect redirect sans double slashes, /page/path// => /page/path/
+			$path = rtrim($path, '/') . '//';
 		}
 		
 		// get info about requested path
@@ -398,6 +403,25 @@ class PagesRequest extends Wire {
 	
 		return $page;
 	}
+
+	/**
+	 * Get array of page info (as provided by PagePathFinder)
+	 * 
+	 * See the PagesPathFinder::get() method return value for a description of 
+	 * what this method returns.
+	 * 
+	 * If this method returns a blank array, it means that the getPage()
+	 * method has not yet been called or that it did not match a page. 
+	 * 
+	 * #pw-advanced
+	 * 
+	 * @return array
+	 * @since 3.0.242
+	 * 
+	 */
+	public function getPageInfo() {
+		return $this->pageInfo;
+	}
 	
 	/**
 	 * Update/get page for given user
@@ -569,9 +593,15 @@ class PagesRequest extends Wire {
 		}
 
 		$maxUrlDepth = $config->maxUrlDepth;
-		if($maxUrlDepth > 0 && substr_count($it, '/') > $config->maxUrlDepth) {
-			$this->setResponseCode(414, 'Request URL exceeds max depth set in $config->maxUrlDepth');
-			return false;
+		if($maxUrlDepth > 0 && substr_count($it, '/') > $maxUrlDepth) {
+			if(in_array($config->longUrlResponse, [ 302, 301 ])) {
+				$parts = array_slice(explode('/', $it), 0, $maxUrlDepth);
+				$it = '/' . trim(implode('/', $parts), '/') . '/';
+				$this->setRedirectPath($it, $config->longUrlResponse);
+			} else {
+				$this->setResponseCode($config->longUrlResponse, 'Request URL exceeds max depth set in $config->maxUrlDepth');
+				return false;
+			}
 		}
 
 		if(!isset($it[0]) || $it[0] != '/') $it = "/$it";
@@ -705,7 +735,7 @@ class PagesRequest extends Wire {
 	 * @return string|Page|null Login page object or string w/redirect URL, null if 404
 	 * 
 	 */
-	public function ___getLoginPageOrUrl(Page $page = null) {
+	public function ___getLoginPageOrUrl(?Page $page = null) {
 		
 		$config = $this->wire()->config;
 

wire/core/PagesTrash.php

@@ -5,7 +5,7 @@
  *
  * Implements page trash/restore/empty methods of the $pages API variable
  *
- * ProcessWire 3.x, Copyright 2020 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2024 by Ryan Cramer
  * https://processwire.com
  *
  */
@@ -18,6 +18,14 @@ class PagesTrash extends Wire {
 	 */
 	protected $pages;
 
+	/**
+	 * Last action, i.e. "restore:1234"
+	 * 
+	 * @var int 
+	 * 
+	 */
+	protected $lastAction = '';
+
 	/**
 	 * Construct
 	 *
@@ -25,6 +33,7 @@ class PagesTrash extends Wire {
 	 * 
 	 */
 	public function __construct(Pages $pages) {
+		parent::__construct();
 		$this->pages = $pages;
 	}
 	
@@ -40,17 +49,18 @@ class PagesTrash extends Wire {
 	 *
 	 */
 	public function trash(Page $page, $save = true) {
-		
+
 		if(!$this->pages->isDeleteable($page) || $page->template->noTrash) {
 			throw new WireException("This page (id=$page->id) may not be placed in the trash");
 		}
 		
-		$trash = $this->pages->get($this->config->trashPageID);
+		$trash = $this->pages->get($this->wire()->config->trashPageID);
+		
 		if(!$trash->id) {
 			throw new WireException("Unable to load trash page defined by config::trashPageID");
 		}
 		
-		$this->pages->trashReady($page);
+		if($this->lastAction != "trash:$page") $this->pages->trashReady($page);
 		
 		$page->addStatus(Page::statusTrash);
 		
@@ -69,10 +79,10 @@ class PagesTrash extends Wire {
 			// make the name unique when in trash, to avoid namespace collision and maintain parent restore info
 			$name = $page->id;
 			if($parentPrevious && $parentPrevious->id) {
-				$name .= "." . $parentPrevious->id;
-				$name .= "." . $page->sort;
+				$sort = $page->get('sortPrevious|sort');
+				$name .= ".$parentPrevious->id.$sort";
 			}
-			$page->name = ($name . "_" . $page->name);
+			$page->name = ($name . '_' . $page->name);
 		
 			// do the same for other languages, if present
 			$languages = $this->wire()->languages;
@@ -86,9 +96,13 @@ class PagesTrash extends Wire {
 			}
 		}
 		
-		if($save) $this->pages->save($page);
+		$this->lastAction = "trash:$page";
+		
+		if($save) {
+			$this->pages->save($page, array('caller' => 'pages.trash', 'callback' => 'trashed'));
+		}
+		
 		$this->pages->editor()->savePageStatus($page->id, Page::statusTrash, true, false);
-		if($save) $this->pages->trashed($page);
 		$this->pages->debugLog('trash', $page, true);
 		
 		return true;
@@ -106,18 +120,29 @@ class PagesTrash extends Wire {
 	 *
 	 */
 	public function restore(Page $page, $save = true) {
-
+	
 		$info = $this->getRestoreInfo($page, true);
-		if(!$info['restorable']) return false;
-		
-		if($page->parent->isTrash()) {
-			if($save) $page->save();
-		} else {
-			$page->removeStatus(Page::statusTrash);
-			if($save) $page->save();
+
+		if($info['restorable']) {
+			// we detected original parent
+			if($this->lastAction !== "restore:$page") $this->pages->restoreReady($page);
+			$this->pages->editor()->savePageStatus($page->id, Page::statusTrash, true, true);
+			
+		} else if(!$page->parent->isTrash()) {
+			// page has had new parent already set
+			if($this->lastAction !== "restore:$page") $this->pages->restoreReady($page);
+			$page->removeStatus(Page::statusTrash);
 			$this->pages->editor()->savePageStatus($page->id, Page::statusTrash, true, true);
-			if($save) $this->pages->restored($page);
 			$this->pages->debugLog('restore', $page, true);
+		} else {
+			// page is in trash and we cannot detect new parent
+			return false;
+		}
+		
+		$this->lastAction = "restore:$page";
+		
+		if($save) {
+			$this->pages->save($page, array('caller' => 'pages.restore', 'callback' => 'restored'));
 		}
 		
 		return true;
@@ -171,7 +196,7 @@ class PagesTrash extends Wire {
 	
 		$name = $result['name'];
 		$trashPrefix = $result['prefix']; // pageID.parentID.sort_ prefix for testing other language names later
-		$newParent = null;
+		$newParent = null; // auto-detected new parent, or null if new parent already on $page
 		$parentID = $result['parent_id'];
 		$sort = $result['sort'];
 
@@ -184,7 +209,7 @@ class PagesTrash extends Wire {
 					$info['notes'][] = 'Original parent no longer exists';
 				}
 			} else {
-				$info['notes'][] = 'Page root parent is not trash';
+				$info['notes'][] = 'Page root parent is not trash or page already has new parent';
 			}
 			
 		} else if($parentID) {
@@ -198,47 +223,50 @@ class PagesTrash extends Wire {
 		$info['parent'] = $newParent ? $newParent : $this->pages->newNullPage();
 		$info['parent_id'] = $parentID;
 		$info['sort'] = $sort;
-	
-		// if we have no new parent available we can exit now
-		if(!$newParent) {
-			$info['notes'][] = 'Unable to determine parent to restore to';
-			return $info;
-		}	
-
-		// check if there is already a page at the restore location with the same name
-		$namePrevious = $name;
-		$name = $this->pages->names()->uniquePageName($name, $page, array('parent' => $newParent));
 		
-		if($name !== $namePrevious) {
-			$info['notes'][] = "Name changed from '$namePrevious' to '$name' to be unique in new parent";
-			$info['namePrevious'] = $namePrevious;
+		$namePrevious = $name;
+		$nameParent = $newParent ? $newParent : $page->parent;
+
+		if($newParent || $this->pages->count("parent=$nameParent, name=$name, id!=$page->id, include=all")) {
+			// check if there is already a page at the restore location with the same name
+			$name = $this->pages->names()->uniquePageName($name, $page, array('parent' => $nameParent));
+			if($name !== $namePrevious) {
+				$info['notes'][] = "Name changed from '$namePrevious' to '$name' to be unique in new parent";
+				$info['namePrevious'] = $namePrevious;
+			}
 		}
 		
 		$info['name'] = $name;
-		$info['restorable'] = true;
+		$info['restorable'] = $newParent !== null;
 		
 		if($populateToPage) {
 			$page->name = $name;
-			$page->parent = $newParent; 
-			$page->sort = $sort;
+			$page->removeStatus(Page::statusTrash);
+			if($newParent) {
+				$page->sort = $sort;
+				$page->parent = $newParent;
+			}
 		}
 
 		// do the same for other languages, when applicable
 		foreach($languages as $language) {
 			/** @var Language $language */
 			if($language->isDefault()) continue;
-			$langName = (string) $page->get("name$language->id");
+			$langKey = "name$language->id";
+			$langName = (string) $page->get($langKey);
 			if(!strlen($langName)) continue;
 			if(strpos($langName, $trashPrefix) === 0) {
 				list(,$langName) = explode('_', $langName);
 			}
 			$langNamePrevious = $langName;
-			$langName = $this->pages->names()->uniquePageName($langName, $page, array(
-				'parent' => $newParent, 
-				'language' => $language
-			));
-			if($populateToPage) $page->set("name$language->id", $langName);
-			$info["name$language->id"] = $langName;
+			if($this->pages->count("parent=$nameParent, $langKey=$langName, id!=$page->id, include=all")) {
+				$langName = $this->pages->names()->uniquePageName($langName, $page, array(
+					'parent' => $nameParent,
+					'language' => $language
+				));
+				if($populateToPage) $page->set($langKey, $langName);
+			}
+			$info[$langKey] = $langName;
 			if($langName !== $langNamePrevious) {
 				$info['notes'][] = $language->get('title|name') . ' ' . 
 					"name changed from '$langNamePrevious' to '$langName' to be unique in new parent";
@@ -333,7 +361,7 @@ class PagesTrash extends Wire {
 		$startTime = time();
 		$stopTime = $options['timeLimit'] ? $startTime + $options['timeLimit'] : false;
 		$stopNow = false;
-		$database = $this->wire('database');
+		$database = $this->wire()->database;
 		$useTransaction = $database->supportsTransaction();
 		$options['stopTime'] = $stopTime; // for pass2
 		$timeExpired = false;
@@ -449,7 +477,7 @@ class PagesTrash extends Wire {
 		}
 			
 		if($totalDeleted || $options['verbose']) {
-			$numTrashChildren = $this->wire('pages')->trasher()->getTrashTotal();
+			$numTrashChildren = $this->pages->trasher()->getTrashTotal();
 			// return a negative number if pages still remain in trash
 			if($numTrashChildren && !$options['verbose']) $totalDeleted = $totalDeleted * -1;
 		} else {
@@ -540,7 +568,7 @@ class PagesTrash extends Wire {
 	 * 
 	 */
 	public function getTrashPage() {
-		$trashPageID = $this->wire('config')->trashPageID;
+		$trashPageID = $this->wire()->config->trashPageID;
 		$trashPage = $this->pages->get((int) $trashPageID);
 		if(!$trashPage->id || $trashPage->id != $trashPageID) {
 			throw new WireException("Cannot find trash page $trashPageID");
@@ -548,4 +576,4 @@ class PagesTrash extends Wire {
 		return $trashPage;
 	}
 
-}
+}

wire/core/PagesType.php

@@ -13,7 +13,7 @@
  * #pw-body
  * #pw-use-constructor
  *
- * ProcessWire 3.x, Copyright 2016 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  *
  * @method Page add($name)
@@ -333,8 +333,7 @@ class PagesType extends Wire implements \IteratorAggregate, \Countable {
 		if(!isset($options['loadOptions'])) $options['loadOptions'] = array();
 		$options['loadOptions'] = $this->getLoadOptions($options['loadOptions']); 
 		if(empty($options['caller'])) $options['caller'] = $this->className() . ".find($selectorString)";
-		$pages = $this->wire('pages')->find($this->selectorString($selectorString), $options);
-		/** @var PageArray $pages */
+		$pages = $this->wire()->pages->find($this->selectorString($selectorString), $options);
 		foreach($pages as $page) {
 			if(!$this->isValid($page)) {
 				$pages->remove($page);
@@ -358,7 +357,7 @@ class PagesType extends Wire implements \IteratorAggregate, \Countable {
 	public function findIDs($selectorString, $options = array()) {
 		if(!isset($options['findAll'])) $options['findAll'] = true;
 		if(empty($options['caller'])) $options['caller'] = $this->className() . ".findIDs($selectorString)";
-		$ids = $this->wire('pages')->findIDs($this->selectorString($selectorString), $options);
+		$ids = $this->wire()->pages->findIDs($this->selectorString($selectorString), $options);
 		return $ids;
 	}
 
@@ -435,6 +434,11 @@ class PagesType extends Wire implements \IteratorAggregate, \Countable {
 	 * - This is the same as calling $page->save()
 	 * - If the page is new, it will be inserted. If existing, it will be updated. 
 	 * - If you want to just save a particular field in a Page, use `$page->save($fieldName)` instead. 
+	 * 
+	 * Hook note:  
+	 * If you want to hook this method, please hook the `saveReady`, `saved`, or one of 
+	 * the `Pages::save*` methods instead, as hooking this method will not hook relevant pages 
+	 * saved directly through $pages->save(). 
 	 *
 	 * @param Page $page
 	 * @return bool True on success
@@ -443,7 +447,7 @@ class PagesType extends Wire implements \IteratorAggregate, \Countable {
 	 */
 	public function ___save(Page $page) {
 		if(!$this->isValid($page)) throw new WireException($this->errors('first'));
-		return $this->wire('pages')->save($page);
+		return $this->wire()->pages->save($page, array('adjustName' => false));
 	}
 	
 	/**
@@ -453,6 +457,10 @@ class PagesType extends Wire implements \IteratorAggregate, \Countable {
 	 *
 	 * If you attempt to delete a page with children, and don’t specifically set the `$recursive` argument to `true`, then 
 	 * this method will throw an exception. If a recursive delete fails for any reason, an exception will be thrown.
+	 * 
+	 * Hook note:  
+	 * If you want to hook this method, please hook the `deleteReady`, `deleted`, or `Pages::delete` method
+	 * instead, as hooking this method will not hook relevant pages deleted directly through $pages->delete().
 	 *
 	 * @param Page $page
 	 * @param bool $recursive If set to true, then this will attempt to delete all children too. 
@@ -471,6 +479,10 @@ class PagesType extends Wire implements \IteratorAggregate, \Countable {
 	 * - If the page has any other fields, they will not be populated, only the name will.
 	 * - Returns a `NullPage` on error, such as when a page of this type already exists with the same name/parent.
 	 *
+	 * Hook note:
+	 * If you want to hook this method, please hook the `addReady`, `Pages::add`, or `Pages::addReady` method
+	 * instead, as hooking this method will not hook relevant pages added directly through $pages->add().
+	 * 
 	 * @param string $name Name to use for the new page
 	 * @return Page|NullPage
 	 *
@@ -479,7 +491,7 @@ class PagesType extends Wire implements \IteratorAggregate, \Countable {
 		
 		$parent = $this->getParent();
 
-		$page = $this->wire('pages')->newPage(array(
+		$page = $this->wire()->pages->newPage(array(
 			'pageClass' => $this->getPageClass(),
 			'template' => $this->template
 		)); 
@@ -492,7 +504,7 @@ class PagesType extends Wire implements \IteratorAggregate, \Countable {
 
 		} catch(\Exception $e) {
 			$this->trackException($e, false);
-			$page = $this->wire('pages')->newNullPage();
+			$page = $this->wire()->pages->newNullPage();
 		}
 
 		return $page; 
@@ -570,7 +582,7 @@ class PagesType extends Wire implements \IteratorAggregate, \Countable {
 	 * 
 	 */
 	public function getParent() {
-		return $this->wire('pages')->get($this->parent_id);
+		return $this->wire()->pages->get($this->parent_id);
 	}
 
 	/**
@@ -583,10 +595,10 @@ class PagesType extends Wire implements \IteratorAggregate, \Countable {
 	 */
 	public function getParents() {
 		if(count($this->parents)) {
-			return $this->wire('pages')->getById($this->parents);
+			return $this->wire()->pages->getById($this->parents);
 		} else {
 			$parent = $this->getParent();
-			$parents = $this->wire('pages')->newPageArray();
+			$parents = $this->wire()->pages->newPageArray();
 			$parents->add($parent);
 			return $parents; 
 		}
@@ -642,7 +654,7 @@ class PagesType extends Wire implements \IteratorAggregate, \Countable {
 		$selectorString = $this->selectorString($selectorString); 
 		$defaults = array('findAll' => true); 
 		$options = array_merge($defaults, $options); 
-		return $this->wire('pages')->count($selectorString, $options); 
+		return $this->wire()->pages->count($selectorString, $options); 
 	}
 
 	/**
@@ -671,7 +683,6 @@ class PagesType extends Wire implements \IteratorAggregate, \Countable {
 	 *
 	 */
 	public function ___saveReady(Page $page) { 
-		if($page) {}
 		return array(); 
 	}
 

wire/core/PaginatedArray.php

@@ -13,7 +13,7 @@
  * #pw-body
  * #pw-summary-manipulation In most cases you will not need these manipulation methods as core API calls already take care of this. 
  *
- * ProcessWire 3.x, Copyright 2016 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  * 
  * @method string renderPager(array $options = array()) Renders pagination, when MarkupPageArray module installed
@@ -79,7 +79,9 @@ class PaginatedArray extends WireArray implements WirePaginatable {
 	 *
 	 */
 	public function getTotal() {
-		return $this->numTotal;
+		$total = $this->numTotal;
+		if(!$total) $total = $this->count();
+		return $total;
 	}
 
 	/**
@@ -327,4 +329,4 @@ class PaginatedArray extends WireArray implements WirePaginatable {
 		}
 		return $info;
 	}
-}
+}

wire/core/Password.php

@@ -56,8 +56,12 @@ class Password extends Wire {
 		}
 
 		if(strlen($hash) < 29) return false;
-
-		$matches = ($hash === $this->data['hash']);
+		
+		if(function_exists("\\hash_equals")) {
+			$matches = hash_equals($this->data['hash'], $hash);
+		} else {
+			$matches = ($hash === $this->data['hash']);
+		}
 
 		if($matches && $updateNotify) {
 			$this->message($this->_('The password system has recently been updated. Please change your password to complete the update for your account.'));
@@ -71,13 +75,13 @@ class Password extends Wire {
 	 * 
 	 * #pw-group-internal
 	 * 
-	 * @param string $key
+	 * @param string $name
 	 * @return mixed
 	 *
 	 */
-	public function __get($key) {
-		if($key == 'salt' && !$this->data['salt']) $this->data['salt'] = $this->salt();
-		return isset($this->data[$key]) ? $this->data[$key] : null;
+	public function __get($name) {
+		if($name === 'salt' && empty($this->data['salt'])) $this->data['salt'] = $this->salt();
+		return isset($this->data[$name]) ? $this->data[$name] : null;
 	}
 
 	/**
@@ -91,7 +95,7 @@ class Password extends Wire {
 	 */
 	public function __set($key, $value) {
 
-		if($key == 'pass') {
+		if($key === 'pass') {
 			// setting the password
 			$this->setPass($value);
 
@@ -358,4 +362,3 @@ class Password extends Wire {
 	}
 
 }
-

wire/core/Paths.php

@@ -54,7 +54,7 @@
  * 
  * #pw-body
  * 
- * ProcessWire 3.x, Copyright 2022 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2024 by Ryan Cramer
  * https://processwire.com
  * 
  * This file is licensed under the MIT license
@@ -108,6 +108,14 @@ class Paths extends WireData {
 	 */
 	protected $_root = '';
 
+	/**
+	 * As used by get() method
+	 * 
+	 * @var null 
+	 * 
+	 */
+	protected $_http = null;
+
 	/**
 	 * Construct the Paths
 	 *
@@ -117,6 +125,7 @@ class Paths extends WireData {
 	public function __construct($root) {
 		$this->_root = $root;
 		$this->useFuel(false);
+		parent::__construct();
 	}
 
 	/**
@@ -165,20 +174,19 @@ class Paths extends WireData {
 	 *
 	 */
 	public function get($key) {
-		static $_http = null;
 		if($key === 'root') return $this->_root;
 		$http = '';
 		$altKey = '';
 		if(is_object($key)) {
 			$key = "$key";
 		} else if(strpos($key, 'http') === 0) {
-			if(is_null($_http)) {
+			if($this->_http === null) {
 				$scheme = $this->wire()->input->scheme;
 				if(!$scheme) $scheme = 'http';
 				$httpHost = $this->wire()->config->httpHost; 
-				if($httpHost) $_http = "$scheme://$httpHost";
+				if($httpHost) $this->_http = "$scheme://$httpHost";
 			}
-			$http = $_http;
+			$http = $this->_http;
 			$key = substr($key, 4); // httpTemplates => Templates
 			$altKey = $key; // no lowercase conversion (useful for keys like module names, i.e. 'ProcessPageEdit')
 			$key[0] = strtolower($key[0]);  // first character lowercase: Templates => templates

wire/core/Permission.php

@@ -47,10 +47,10 @@ class Permission extends Page {
 	/**
 	 * Create a new Permission page in memory. 
 	 *
-	 * @param Template $tpl Template object this page should use. 
+	 * @param Template|null $tpl Template object this page should use. 
 	 *
 	 */
-	public function __construct(Template $tpl = null) {
+	public function __construct(?Template $tpl = null) {
 		parent::__construct($tpl); 
 		if(!$tpl) $this->template = $this->wire()->templates->get('permission'); 
 		$this->_parent_id = $this->wire()->config->permissionsPageID; 
@@ -145,5 +145,3 @@ class Permission extends Page {
 		return $this->wire()->permissions;
 	}
 }
-
-

wire/core/Permissions.php

@@ -5,7 +5,7 @@
  * 
  * #pw-summary Provides management of all Permission pages independent of users, for access control.
  * 
- * ProcessWire 3.x, Copyright 2022 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
  * https://processwire.com
  * 
  * @method PageArray find($selector) Return the permissions(s) matching the the given selector query.
@@ -83,11 +83,27 @@ class Permissions extends PagesType {
 	 * 
 	 */
 	public function has($name) {
-		
 		if($name == 'page-add' || $name == 'page-create') return true; // runtime only permissions
-		
-		if(empty($this->permissionNames)) {
+		$a = $this->getPermissionNameIds();
+		return isset($a[$name]);
+	}
 
+	/**
+	 * Get all installed permission names and IDs
+	 * 
+	 * #pw-internal
+	 *
+	 * @param string $namePrefix Optional name prefix to match
+	 * @return array Array of [ permission name => permission ID ]
+	 * @since 3.0.223
+	 * 
+	 */
+	public function getPermissionNameIds($namePrefix = '') {
+		
+		if(count($this->permissionNames)) {
+			$names = $this->permissionNames;
+			
+		} else {
 			$cache = $this->wire()->cache;
 			$names = $cache->get(self::cacheName);
 
@@ -101,10 +117,15 @@ class Permissions extends PagesType {
 
 			$this->permissionNames = $names;
 		}
-			
-		return isset($this->permissionNames[$name]);
-	}
 
+		if($namePrefix !== '') {
+			foreach($names as $name => $id) {
+				if(strpos($name, $namePrefix) !== 0) unset($names[$name]);
+			}
+		}
+		
+		return $names;
+	}
 
 	/**
 	 * Save a Permission
@@ -145,7 +166,9 @@ class Permissions extends PagesType {
 	 *
 	 */
 	public function ___add($name) {
-		return parent::___add($name);
+		/** @var Permission|NullPage $value */
+		$value = parent::___add($name);
+		return $value;
 	}
 
 
@@ -180,6 +203,10 @@ class Permissions extends PagesType {
 			if($role->name === 'superuser') continue;
 			$a["user-admin-$role->name"] = sprintf($this->_('Administer users in role: %s'), $role->name);
 		}
+
+		if($this->wire()->modules->isInstalled('PagePathHistory')) {
+			$a['page-edit-redirects'] = $this->_('User can add/edit/delete redirect URLs in the page editor');
+		}
 		
 		$languages = $this->wire()->languages;
 		if($languages) {
@@ -225,7 +252,7 @@ class Permissions extends PagesType {
 				$a[] = "page-edit-lang-$language->name";
 			}
 		}
-		foreach($this->wire('roles') as $role) {
+		foreach($this->wire()->roles as $role) {
 			$a[] = "user-admin-$role->name";
 		}
 		$a = array_flip($a);
@@ -246,6 +273,48 @@ class Permissions extends PagesType {
 		return $this->delegatedPermissions;
 	}
 
+	/**
+	 * Return permission name that given one delegates to when permission $name is not installed
+	 * 
+	 * Returns blank string if given permission $name is already installed 
+	 * or does not have a delegate.
+	 * 
+	 * #pw-internal
+	 * 
+	 * @param string $name Permission name
+	 * @return string Delegate permission name or blank string 
+	 * @since 3.0.223
+	 * 
+	 */
+	public function getDelegatedPermission($name) {
+		if($this->has($name)) return '';
+		return isset($this->delegatedPermissions[$name]) ? $this->delegatedPermissions[$name] : ''; 
+	}
+
+	/**
+	 * Get method on given $context object to delegate permission $name to
+	 * 
+	 * If given permission already exists, this method returns blank string. 
+	 * If there is no method to delegate to, this method returns blank string. 
+	 * 
+	 * #pw-internal
+	 * 
+	 * @param string $name Permission name
+	 * @param Page|Template $context
+	 * @return string Method name or blank string
+	 * @since 3.0.223
+	 * 
+	 */
+	public function getDelegatedMethod($name, $context) {
+		if($this->has($name)) return '';
+		if($context instanceof Page) {
+			// page-edit-images needs to delegate to $page->editable() method
+			// so that hooks can apply, such as when user editing images on other user
+			if($name === 'page-edit-images') return 'editable';
+		}
+		return '';
+	}
+
 	/**
 	 * Returns all installed Permission pages and enables foreach() iteration of $permissions
 	 * 

wire/core/Process.php

@@ -251,6 +251,8 @@ abstract class Process extends WireData implements Module {
 	 *
 	 */
 	public function ___breadcrumb($href, $label) {
+		if(is_array($label)) return $this;
+		$label = (string) $label;
 		$pos = strpos($label, '/'); 
 		if($pos !== false && strpos($href, '/') === false) {
 			// arguments got reversed, we'll work with it anyway...
@@ -364,6 +366,7 @@ abstract class Process extends WireData implements Module {
 		$config = $this->wire()->config;
 		$modules = $this->wire()->modules;
 		$sanitizer = $this->wire()->sanitizer;
+		$languages = $this->wire()->languages;
 		
 		$info = $modules->getModuleInfoVerbose($this);
 		$name = $sanitizer->pageName($name);
@@ -375,21 +378,23 @@ abstract class Process extends WireData implements Module {
 			// already have what we  need
 		} else if(ctype_digit("$parent")) {
 			$parent = $pages->get((int) $parent);
-		} else if(strpos($parent, '/') !== false) {
+		} else if(strpos("$parent", '/') !== false) {
 			$parent = $pages->get($parent);
 		} else if($parent) {
 			$parent = $sanitizer->pageName($parent);
-			$parent = $adminPage->child("include=all, name=$parent");
+			if(strlen($parent)) $parent = $adminPage->child("include=all, name=$parent");
 		}
 		if(!$parent || !$parent->id) $parent = $adminPage; // default
 		$page = $parent->child("include=all, name=$name"); // does it already exist?
 		if($page->id && "$page->process" == "$this") return $page; // return existing copy
+		if($languages) $languages->setDefault();
 		$page = $pages->newPage($template ? $template : 'admin');
 		$page->name = $name; 
 		$page->parent = $parent; 
 		$page->process = $this;
 		$page->title = $title ? $title : $info['title'];
 		foreach($extras as $key => $value) $page->set($key, $value); 
+		if($languages) $languages->unsetDefault();
 		$pages->save($page, array('adjustName' => true)); 
 		if(!$page->id) throw new WireException("Unable to create page: $parent->path$name"); 
 		$this->message(sprintf($this->_('Created Page: %s'), $page->path)); 

wire/core/ProcessController.php

@@ -343,7 +343,18 @@ class ProcessController extends Wire {
 		if(!$method) {
 			throw new ProcessController404Exception("Unrecognized path");
 		}
-	
+		
+		if($method === 'executeNavJSON' && !$this->wire()->config->ajax && !$debug) {
+			// disallow navJSON output when not ajax and not debug mode
+			if(!$this->wire()->user->isLoggedin()) wire404();
+			$navJSON = substr($this->wire()->input->url(), -8); 
+			if($navJSON === 'navJSON/') {
+				$this->wire()->session->location('../');
+			} else if($navJSON === '/navJSON') {
+				$this->wire()->session->location('./');
+			}
+		}
+
 		// call method from Process (and time it if debug mode enabled)
 		$className = $process->className();
 		if($debug) Debug::timer("$className.$method()"); 
@@ -475,18 +486,22 @@ class ProcessController extends Wire {
 	/**
 	 * Generate a message in JSON format, for use with AJAX output
 	 * 
-	 * @param string $msg
-	 * @param bool $error
-	 * @param bool $allowMarkup
+	 * @param string|array $msg Message string or in 3.0.246+ also accepts an array of extra data
+	 *   When using an array, please include a 'message' index with text about the error or non-error.
+	 * @param bool $error Is this in error message? Default is true, or specify false if not. 
+	 * @param bool $allowMarkup Allow markup in message? Applies only to $msg string or 'message' index of array (default=false)
 	 * @return string JSON encoded string
 	 *
 	 */
 	public function jsonMessage($msg, $error = false, $allowMarkup = false) {
-		if(!$allowMarkup) $msg = $this->wire()->sanitizer->entities($msg);
-		return json_encode(array(
-			'error' => (bool) $error, 
-			'message' => (string) $msg
-		)); 
+		$a = array('error' => (bool) $error, 'message' => '');
+		if(is_array($msg)) {
+			$a = array_merge($a, $msg);
+		} else {
+			$a['message'] = (string) $msg;
+		}
+		if(!$allowMarkup) $a['message'] = $this->wire()->sanitizer->entities($a['message']);
+		return json_encode($a); 
 	}
 
 	/**
@@ -500,6 +515,3 @@ class ProcessController extends Wire {
 	}
 
 }	
-
-
-

wire/core/ProcessWire.php

@@ -17,7 +17,7 @@ require_once(__DIR__ . '/boot.php');
  * ~~~~~
  * #pw-body
  * 
- * ProcessWire 3.x, Copyright 2023 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2025 by Ryan Cramer
  * https://processwire.com
  *
  * Default API vars (A-Z) 
@@ -54,6 +54,7 @@ require_once(__DIR__ . '/boot.php');
  * @property Users $users
  * @property ProcessWire $wire
  * @property WireShutdown $shutdown
+ * @property PagesVersions|null $pagesVersions
  * 
  * @method init()
  * @method ready()
@@ -79,7 +80,7 @@ class ProcessWire extends Wire {
 	 * Reversion revision number
 	 * 
 	 */
-	const versionRevision = 210;
+	const versionRevision = 246;
 
 	/**
 	 * Version suffix string (when applicable)
@@ -287,11 +288,11 @@ class ProcessWire extends Wire {
 		
 		// this is reset in the $this->setConfig() method based on current debug mode
 		ini_set('display_errors', true);
-		error_reporting(E_ALL | E_STRICT);
+		error_reporting(E_ALL);
 
 		$config->setWire($this);
 		
-		$this->debug = $config->debug; 
+		$this->debug = $this->setConfigDebug($config);
 		if($this->debug) Debug::timer('all');
 		$this->instanceID = self::addInstance($this);
 		$this->setWire($this);
@@ -357,15 +358,6 @@ class ProcessWire extends Wire {
 		$this->wire($config->paths);
 		$this->wire($config->urls);
 		
-		// If debug mode is on then echo all errors, if not then disable all error reporting
-		if($config->debug) {
-			error_reporting(E_ALL | E_STRICT);
-			ini_set('display_errors', 1);
-		} else {
-			error_reporting(0);
-			ini_set('display_errors', 0);
-		}
-
 		ini_set('date.timezone', $config->timezone);
 		ini_set('default_charset','utf-8');
 
@@ -388,24 +380,6 @@ class ProcessWire extends Wire {
 		$config->versionName = trim($version . " " . self::versionSuffix);
 		$config->moduleServiceKey .= str_replace('.', '', $version);
 		
-		// $config->debugIf: optional setting to determine if debug mode should be on or off
-		if($config->debugIf && is_string($config->debugIf)) {
-			$debugIf = trim($config->debugIf);
-			$ip = $config->sessionForceIP;
-			if(empty($ip)) $ip = isset($_SERVER['REMOTE_ADDR']) ? $_SERVER['REMOTE_ADDR'] : null;
-			if(strpos($debugIf, '/') === 0 && !empty($ip)) {
-				$debugIf = (bool) @preg_match($debugIf, $ip); // regex IPs
-			} else if(is_callable($debugIf)) {
-				$debugIf = $debugIf(); // callable function to determine debug mode for us 
-			} else if(!empty($ip)) {
-				$debugIf = $debugIf === $ip; // exact IP match
-			} else {
-				$debugIf = false;
-			}
-			unset($ip);
-			$config->debug = $debugIf;
-		}
-
 		if($config->useFunctionsAPI && !function_exists("\\ProcessWire\\pages")) {
 			$file = $config->paths->core . 'FunctionsAPI.php';
 			/** @noinspection PhpIncludeInspection */
@@ -435,6 +409,57 @@ class ProcessWire extends Wire {
 		}
 	}
 
+	/**
+	 * Determine whether debug mode should be enabled
+	 * 
+	 * @param Config $config
+	 * @return bool|int Returns determined debug mode value
+	 * @since 3.0.212
+	 * 
+	 */
+	protected function setConfigDebug(Config $config) {
+		$debug = $config->debug;
+		if($debug) {
+			// use as-is
+		} else {
+			$debugIf = $config->debugIf;
+			if(empty($debugIf)) {
+				// no processing needed
+			} else if(is_callable($debugIf)) {
+				// callable function
+				$debug = $debugIf();
+			} else {
+				$ip = $config->sessionForceIP;
+				if(empty($ip)) $ip = isset($_SERVER['REMOTE_ADDR']) ? $_SERVER['REMOTE_ADDR'] : null;
+				if(is_string($debugIf) && strlen($debugIf) && !empty($ip)) {
+					// match exact IP address or regex matching IP address(es)
+					$debugIf = trim($debugIf);
+					if(strpos($debugIf, '/') === 0) {
+						$debug = (bool) @preg_match($debugIf, $ip); // regex IPs
+					} else {
+						$debug = $debugIf === $ip; // exact IP match
+					}
+				} else if(is_array($debugIf) && !empty($ip)) {
+					// match IP address in array
+					$debug = in_array($ip, $debugIf);
+				}
+			}
+			if($debug) $config->debug = $debug;
+		}
+		
+		if($debug) {
+			// If debug mode is on then echo all errors
+			error_reporting(E_ALL);
+			ini_set('display_errors', 1);
+		} else {
+			// disable all error reporting
+			error_reporting(0);
+			ini_set('display_errors', 0);
+		}
+		
+		return $debug;
+	}
+
 	/**
 	 * Safely determine the HTTP host
 	 * 
@@ -522,11 +547,7 @@ class ProcessWire extends Wire {
 			throw new WireDatabaseException($e->getMessage()); 
 		}
 	
-		/** @var WireCache $cache */
-		$cache = $this->wire('cache', new WireCache(), true); 
-		$cacheNames = $config->preloadCacheNames;
-		if($database->getEngine() === 'innodb') $cacheNames[] = 'InnoDB.stopwords';
-		$cache->preload($cacheNames); 
+		$this->wire('cache', new WireCache(), true); 
 		
 		$modules = null;
 		try { 		
@@ -543,7 +564,7 @@ class ProcessWire extends Wire {
 		}
 		$this->updater = $modules->get('SystemUpdater'); 
 		if(!$this->updater) {
-			$modules->resetCache();
+			$modules->refresh();
 			$this->updater = $modules->get('SystemUpdater');
 		}
 
@@ -580,7 +601,9 @@ class ProcessWire extends Wire {
 		// the current user can only be determined after the session has been initiated
 		$session = $this->wire('session', new Session($this), true); 
 		$this->initVar('session', $session);
-		$this->wire('user', $users->getCurrentUser());
+		$user = $users->getCurrentUser();
+		if($config->userOutputFormatting) $user->of(true);
+		$this->wire('user', $user);
 		
 		$input = $this->wire('input', new WireInput(), true); 
 		if($config->wireInputLazy) $input->setLazy(true);
@@ -833,17 +856,17 @@ class ProcessWire extends Wire {
 	/**
 	 * Get API var directly
 	 * 
-	 * @param string $key
+	 * @param string $name
 	 * @return mixed
 	 * 
 	 */
-	public function __get($key) {
-		if($key === 'fuel') return $this->fuel;
-		if($key === 'shutdown') return $this->shutdown;
-		if($key === 'instanceID') return $this->instanceID;
-		$value = $this->fuel->get($key);
+	public function __get($name) {
+		if($name === 'fuel') return $this->fuel;
+		if($name === 'shutdown') return $this->shutdown;
+		if($name === 'instanceID') return $this->instanceID;
+		$value = $this->fuel->get($name);
 		if($value !== null) return $value;
-		return parent::__get($key);
+		return parent::__get($name);
 	}
 
 	/**
@@ -1261,5 +1284,3 @@ class ProcessWire extends Wire {
 	}
 
 }
-
-

wire/core/Punycode.php

@@ -71,6 +71,14 @@ class Punycode {
 	 */
 	protected $encoding;
 
+	/**
+	 * PHP mb string functions supported?
+	 * 
+	 * @var bool 
+	 * 
+	 */
+	protected $mb = false;
+
 	/**
 	 * Constructor
 	 *
@@ -78,7 +86,12 @@ class Punycode {
 	 */
 	public function __construct($encoding = 'UTF-8') {
 		$this->encoding = $encoding;
+		$this->mb = function_exists("mb_internal_encoding");
 	}
+	
+	public function strtolower($str) { return $this->mb ? mb_strtolower($str, $this->encoding) : strtolower($str); }
+	public function strlen($str) { return $this->mb ? mb_strlen($str, $this->encoding) : strlen($str); }
+	public function substr($str, $a, $b) { return $this->mb ? mb_substr($str, $a, $b, $this->encoding) : substr($str, $a, $b); }
 
 	/**
 	 * Encode a domain to its Punycode version
@@ -88,7 +101,7 @@ class Punycode {
 	 * @return string Punycode representation in ASCII
 	 */
 	public function encode($input) {
-		$input = mb_strtolower($input, $this->encoding);
+		$input = $this->strtolower($input);
 		$parts = explode('.', $input);
 		foreach($parts as &$part) {
 			$part = $this->encodePart($part);
@@ -122,7 +135,7 @@ class Punycode {
 		$codePoints['nonBasic'] = array_unique($codePoints['nonBasic']);
 		sort($codePoints['nonBasic']);
 		$i = 0;
-		$length = mb_strlen($input, $this->encoding);
+		$length = $this->strlen($input);
 		while($h < $length) {
 			$m = $codePoints['nonBasic'][$i++];
 			$delta = $delta + ($m - $n) * ($h + 1);
@@ -138,11 +151,11 @@ class Punycode {
 						if($q < $t) {
 							break;
 						}
-						$code = $t + (($q - $t) % (static::BASE - $t));
+						$code = $t + ((floor($q) - $t) % (static::BASE - $t));
 						$output .= static::$encodeTable[$code];
 						$q = ($q - $t) / (static::BASE - $t);
 					}
-					$output .= static::$encodeTable[$q];
+					$output .= static::$encodeTable[floor($q)];
 					$bias = $this->adapt($delta, $h + 1, ($h === $b));
 					$delta = 0;
 					$h++;
@@ -209,9 +222,9 @@ class Punycode {
 			$bias = $this->adapt($i - $oldi, ++$outputLength, ($oldi === 0));
 			$n = $n + (int) ($i / $outputLength);
 			$i = $i % ($outputLength);
-			$output = mb_substr($output, 0, $i, $this->encoding) . 
+			$output = $this->substr($output, 0, $i) . 
 				$this->codePointToChar($n) . 
-				mb_substr($output, $i, $outputLength - 1, $this->encoding);
+				$this->substr($output, $i, $outputLength - 1);
 			$i++;
 		}
 		return $output;
@@ -272,9 +285,9 @@ class Punycode {
 			'basic' => array(),
 			'nonBasic' => array(),
 		);
-		$length = mb_strlen($input, $this->encoding);
+		$length = $this->strlen($input);
 		for($i = 0; $i < $length; $i++) {
-			$char = mb_substr($input, $i, 1, $this->encoding);
+			$char = $this->substr($input, $i, 1);
 			$code = $this->charToCodePoint($char);
 			if($code < 128) {
 				$codePoints['all'][] = $codePoints['basic'][] = $code;
@@ -323,4 +336,4 @@ class Punycode {
 			return chr(($code >> 18) + 240) . chr((($code >> 12) & 63) + 128) . chr((($code >> 6) & 63) + 128) . chr(($code & 63) + 128);
 		}
 	}
-}
+}

wire/core/Role.php

@@ -25,10 +25,10 @@ class Role extends Page {
 	/**
 	 * Create a new Role page in memory. 
 	 * 
-	 * @param Template $tpl
+	 * @param Template|null $tpl
 	 *
 	 */
-	public function __construct(Template $tpl = null) {
+	public function __construct(?Template $tpl = null) {
 		parent::__construct($tpl); 
 	}
 
@@ -108,6 +108,13 @@ class Role extends Page {
 				if(!ctype_alnum(str_replace('-', '', $name))) {
 					$name = $this->wire()->sanitizer->pageName($name);
 				}
+				if($context) {
+					$method = $permissions->getDelegatedMethod($name, $context);
+					if($method) {
+						// non-installed permission delegates to a method call such as $page->editable()
+						return $context->$method();
+					}
+				}
 				$delegated = $permissions->getDelegatedPermissions();
 				if(isset($delegated[$name])) $name = $delegated[$name];
 			}
@@ -243,4 +250,3 @@ class Role extends Page {
 	}
 
 }
-

wire/core/Sanitizer.php

@@ -90,7 +90,7 @@
  * 
  * #pw-body
  * 
- * ProcessWire 3.x, Copyright 2022 by Ryan Cramer
+ * ProcessWire 3.x, Copyright 2024 by Ryan Cramer
  * https://processwire.com
  *
  * @link https://processwire.com/api/variables/sanitizer/ Offical $sanitizer API variable Documentation
@@ -164,6 +164,20 @@ class Sanitizer extends Wire {
 	 * 
 	 */
 	protected $textTools = null;
+	
+	/**
+	 * @var null|WireNumberTools
+	 *
+	 */
+	protected $numberTools = null;
+
+	/**
+	 * Runtime caches
+	 * 
+	 * @var array 
+	 * 
+	 */
+	protected $caches = array();
 
 	/**
 	 * UTF-8 whitespace hex codes
@@ -224,6 +238,17 @@ class Sanitizer extends Wire {
 		'‍', // zero width join
 	);
 
+	/**
+	 * Characters blacklisted from UTF-8 page names
+	 * 
+	 * @var string[] 
+	 * 
+	 */
+	protected $pageNameBlacklist = array(
+		'/', '\\', '%', '"', "'", '<', '>', '?', '!', '#', '@', ':', ';', ',', 
+		'+', '=', '*', '^', '$', '(', ')', '[', ']', '{', '}', '|', '&',
+	);
+
 	/**
 	 * Sanitizer method names (A-Z) and type(s) they return 
 	 * 
@@ -263,6 +288,8 @@ class Sanitizer extends Wire {
 		'filename' => 's',
 		'flatArray' => 'a',
 		'float' => 'f',
+		'htmlClass' => 's', 
+		'htmlClasses' => 's',
 		'httpUrl' => 's',
 		'hyphenCase' => 's',
 		'int' => 'i',
@@ -350,8 +377,6 @@ class Sanitizer extends Wire {
 	 */
 	public function nameFilter($value, array $allowedExtras, $replacementChar, $beautify = false, $maxLength = 128) {
 		
-		static $replacements = array();
-
 		if(!is_string($value)) $value = $this->string($value);
 		$allowed = array_merge($this->allowedASCII, $allowedExtras); 
 		$needsWork = strlen(str_replace($allowed, '', $value));
@@ -360,24 +385,30 @@ class Sanitizer extends Wire {
 		if($beautify && $needsWork) {
 			if($beautify === self::translate && $this->multibyteSupport) {
 				$value = mb_strtolower($value);
+				$replacements = array();
 
-				if(empty($replacements)) {
-					$configData = $this->wire()->modules->getModuleConfigData('InputfieldPageName');
-					$replacements = empty($configData['replacements']) ? InputfieldPageName::$defaultReplacements : $configData['replacements'];
-				}
-
-				foreach($replacements as $from => $to) {
-					if(mb_strpos($value, $from) !== false) {
-						$value = mb_eregi_replace($from, $to, $value);
+				if(empty($this->caches['nameFilterReplace'])) {
+					$modules = $this->wire()->modules;
+					if($modules) {
+						$replacements = $this->wire()->modules->getConfig('InputfieldPageName', 'replacements');
+						if(empty($replacements)) $replacements = InputfieldPageName::$defaultReplacements;
+						$this->caches['nameFilterReplace'] = $replacements;
 					}
+				} else {
+					$replacements = $this->caches['nameFilterReplace']; 
+				}
+			
+				if(count($replacements)) {
+					$value = str_replace(array_keys($replacements), array_values($replacements), $value);
+					$needsWork = strlen(str_replace($allowed, '', $value));
 				}
 			}
 
-			if(function_exists("\\iconv")) {
+			if($needsWork && function_exists("\\iconv")) {
 				$v = iconv("UTF-8", "ASCII//TRANSLIT//IGNORE", $value);
 				if($v) $value = $v;
+				$needsWork = strlen(str_replace($allowed, '', $value));
 			}
-			$needsWork = strlen(str_replace($allowed, '', $value)); 
 		}
 
 		if(strlen($value) > $maxLength) $value = substr($value, 0, $maxLength); 
@@ -591,6 +622,54 @@ class Sanitizer extends Wire {
 		return $value;
 	}
 
+	/**
+	 * Sanitize string to ASCII-only HTML class attribute value
+	 * 
+	 * Note that this does not support all possible characters in an HTML class attribute 
+	 * and instead focuses on the most commonly used ones. Characters allowed in HTML class
+	 * attributes from this method include: `-_:@a-zA-Z0-9`. This method does not allow
+	 * values that have no letters or digits.
+	 * 
+	 * @param string $value
+	 * @return string 
+	 * @since 3.0.212
+	 * 
+	 */
+	public function htmlClass($value) {
+		$value = trim("$value");
+		if(empty($value)) return '';
+		$extras = array('-', '_', ':', '@');
+		$value = $this->nameFilter($value, $extras, '-');
+		$value = ltrim($value, '0123456789'); // cannot begin with digit
+		if(trim($value, implode('', $extras)) === '') $value = ''; // do not allow extras-only class
+		return $value;
+	}
+
+	/**
+	 * Sanitize string to ASCII-only space-separated HTML class attribute values with no duplicates
+	 * 
+	 * See additional notes in `Sanitizer::htmlClass()` method. 
+	 *
+	 * @param string|array $value
+	 * @param bool $getArray Get array rather than string? (default=false)
+	 * @return string|array
+	 * @since 3.0.212
+	 *
+	 */
+	public function htmlClasses($value, $getArray = false) {
+		if(is_array($value)) $value = implode(' ', $value);
+		$value = str_replace(array("\n", "\r", "\t", ",", "."), ' ', $value);
+		$value = trim("$value");
+		if(empty($value)) return $getArray ? array() : '';
+		$a = array();
+		foreach(explode(' ', $value) as $c) {
+			$c = $this->htmlClass($c);
+			if(!empty($c)) $a[$c] = $c;
+		}
+		if($getArray) return array_values($a);
+		return count($a) ? implode(' ', $a) : '';
+	}
+
 	/**
 	 * Sanitize consistent with names used by ProcessWire fields and/or PHP variables
 	 *
@@ -709,7 +788,8 @@ class Sanitizer extends Wire {
 	 *  - `Sanitizer::okUTF8` (constant): Allow UTF-8 characters to appear in path (implied if $config->pageNameCharset is 'UTF8'). 
 	 * @param int|array $maxLength Maximum number of characters allowed in the name.
 	 *  You may also specify the $options array for this argument instead. 
-	 * @param array $options Array of options to modify default behavior. See Sanitizer::name() method for available options. 
+	 * @param array $options Array of options to modify default behavior. See Sanitizer::name() method for available options, plus:
+	 *  - `punycodeVersion` (int): Punycode version to use with UTF-8 page names, see Sanitizer::getPunycodeVersion() method for details.
 	 * @return string
 	 * @see Sanitizer::name()
 	 *
@@ -720,7 +800,8 @@ class Sanitizer extends Wire {
 		if(!strlen($value)) return '';
 		
 		$defaults = array(
-			'charset' => $this->wire()->config->pageNameCharset
+			'charset' => $this->wire()->config->pageNameCharset,
+			'punycodeVersion' => 0, 
 		);
 		
 		if(is_array($beautify)) {
@@ -752,19 +833,26 @@ class Sanitizer extends Wire {
 				&& !ctype_alnum(str_replace(array('-', '_', '.'), '', $value)) 
 				&& strpos($value, 'xn-') !== 0) {
 				
+				$tt = $this->getTextTools();
+				$max = $maxLength;
+				
 				do {
 					// encode value
-					$value = $this->punyEncodeName($_value);
+					$value = $this->punyEncodeName($_value, $options['punycodeVersion']);
 					// if result stayed within our allowed character limit, then good, we're done
 					if(strlen($value) <= $maxLength) break;
 					// continue loop until encoded value is equal or less than allowed max length
-					$_value = substr($_value, 0, strlen($_value) - 1);
+					$_value = $tt->substr($_value, 0, $max--);
 				} while(true);
 				
 				// if encode was necessary and successful, return with no further processing
 				if(strpos($value, 'xn-') === 0) {
 					return $value;
 				} else {
+					if(strlen($value) && ctype_alnum(str_replace(array('-', '_', '.'), '', $value))) {
+						if($this->getPunycodeVersion($options['punycodeVersion']) > 1) return $value;
+					}
+						
 					// can't be encoded, send to regular name sanitizer
 					$value = $_value;
 				}
@@ -775,7 +863,7 @@ class Sanitizer extends Wire {
 			$beautify = self::okUTF8;
 			if(strpos($value, 'xn-') === 0) {
 				// found something to convert
-				$value = $this->punyDecodeName($value);
+				$value = $this->punyDecodeName($value, $options['punycodeVersion']);
 				// now it will run through okUTF8
 			}
 		}
@@ -826,6 +914,7 @@ class Sanitizer extends Wire {
 		if(!strlen($value)) return '';
 		
 		$config = $this->wire()->config;
+		$keepGoing = true;
 		
 		// if UTF8 module is not enabled then delegate this call to regular pageName sanitizer
 		if($config->pageNameCharset != 'UTF8') return $this->pageName($value, false, $maxLength);
@@ -841,7 +930,8 @@ class Sanitizer extends Wire {
 		// whitelist of allowed characters and blacklist of disallowed characters
 		$whitelist = $config->pageNameWhitelist;
 		if(!strlen($whitelist)) $whitelist = false;
-		$blacklist = '/\\%"\'<>?#@:;,+=*^$()[]{}|&';
+		
+		$value = str_replace($this->pageNameBlacklist, '-', $value);
 		
 		// we let regular pageName handle chars like these, if they appear without other UTF-8
 		$extras = array('.', '-', '_', ',', ';', ':', '(', ')', '!', '?', '&', '%', '$', '#', '@');
@@ -849,43 +939,55 @@ class Sanitizer extends Wire {
 
 		// proceed only if value has some non-ascii characters
 		if(ctype_alnum(str_replace($extras, '', $value))) {
-			// let regular pageName sanitizer handle this
-			return $this->pageName($value, false, $maxLength);
-		}
-
-		// validate that all characters are in our whitelist
-		$replacements = array();
-
-		for($n = 0; $n < $tt->strlen($value); $n++) {
-			$c = $tt->substr($value, $n, 1);
-			$inBlacklist = $tt->strpos($blacklist, $c) !== false || strpos($blacklist, $c) !== false;
-			$inWhitelist = !$inBlacklist && $whitelist !== false && $tt->strpos($whitelist, $c) !== false;
-			if($inWhitelist && !$inBlacklist) {
-				// in whitelist
-			} else if($inBlacklist || !strlen(trim($c)) || ctype_cntrl($c)) {
-				// character does not resolve to something visible or is in blacklist
-				$replacements[] = $c;
-			} else if($whitelist === false) {
-				// whitelist disabled: allow everything that is not blacklisted
-			} else {
-				// character that is not in whitelist, double check case variants
-				$cLower = $tt->strtolower($c);
-				$cUpper = $tt->strtoupper($c);
-				if($cLower !== $c && $tt->strpos($whitelist, $cLower) !== false) {
-					// allow character and convert to lowercase variant
-					$value = $tt->substr($value, 0, $n) . $cLower . $tt->substr($value, $n+1);
-				} else if($cUpper !== $c && $tt->strpos($whitelist, $cUpper) !== false) {
-					// allow character and convert to uppercase varient
-					$value = $tt->substr($value, 0, $n) . $cUpper . $tt->substr($value, $n+1);
-				} else {
-					// queue character to be replaced
-					$replacements[] = $c;
-				}
+			$k = 'pageNameUTF8.whitelistIsLowercase';
+			if(!isset($this->caches[$k])) {
+				$this->caches[$k] = $whitelist !== false && $tt->strtolower($whitelist) === $whitelist;
+			}
+			if($this->caches[$k] || $tt->strtolower($value) === $value) {
+				// whitelist supports only lowercase OR value is all lowercase 
+				// let regular pageName sanitizer handle this
+				$value = $this->pageName($value, false, $maxLength);
+				// maintain old behavior for existing installations
+				if($this->getPunycodeVersion() < 2) return $value; 
+				$keepGoing = false;
 			}
 		}
 
-		// replace disallowed characters with "-"
-		if(count($replacements)) $value = str_replace($replacements, '-', $value);
+		if($keepGoing) {
+			// validate that all characters are in our whitelist
+			$replacements = array();
+
+			for($n = 0; $n < $tt->strlen($value); $n++) {
+				$c = $tt->substr($value, $n, 1);
+				if($c === '-') continue;
+				$inWhitelist = $whitelist !== false && $tt->strpos($whitelist, $c) !== false;
+				if($inWhitelist) {
+					// in whitelist
+				} else if(!strlen(trim($c)) || ctype_cntrl($c)) {
+					// character does not resolve to something visible 
+					$replacements[] = $c;
+				} else if($whitelist === false) {
+					// whitelist disabled: allow everything that is not blacklisted
+				} else {
+					// character that is not in whitelist, double check case variants
+					$cLower = $tt->strtolower($c);
+					$cUpper = $tt->strtoupper($c);
+					if($cLower !== $c && $tt->strpos($whitelist, $cLower) !== false) {
+						// allow character and convert to lowercase variant
+						$value = $tt->substr($value, 0, $n) . $cLower . $tt->substr($value, $n + 1);
+					} else if($cUpper !== $c && $tt->strpos($whitelist, $cUpper) !== false) {
+						// allow character and convert to uppercase variant
+						$value = $tt->substr($value, 0, $n) . $cUpper . $tt->substr($value, $n + 1);
+					} else {
+						// queue character to be replaced
+						$replacements[] = $c;
+					}
+				}
+			}
+
+			// replace disallowed characters with "-"
+			if(count($replacements)) $value = str_replace($replacements, '-', $value);
+		}
 		
 		// replace doubled word separators
 		foreach($separators as $c) {
@@ -906,36 +1008,51 @@ class Sanitizer extends Wire {
 	 * Decode a PW-punycode'd name value
 	 * 
 	 * @param string $value
+	 * @param int $version 0=auto-detect, 1=original/buggy, 2=punycode library, 3=php idn function
 	 * @return string
 	 * 
 	 */
-	protected function punyDecodeName($value) {
+	protected function punyDecodeName($value, $version = 0) {
 		// exclude values that we know can't be converted
 		if(strlen($value) < 4 || strpos($value, 'xn-') !== 0) return $value;
+		$version = $this->getPunycodeVersion($version);
 		
 		if(strpos($value, '__')) {
+			// as used by punycode version 1 to split long strings
 			$_value = $value;
 			$parts = explode('__', $_value);
 			foreach($parts as $n => $part) {
-				$parts[$n] = $this->punyDecodeName($part);
+				$parts[$n] = $this->punyDecodeName($part, $version);
 			}
 			$value = implode('', $parts);
 			return $value; 
 		}
 		
 		$_value = $value; 
+		
 		// convert "xn-" single hyphen to recognized punycode "xn--" double hyphen
 		if(strpos($value, 'xn--') !== 0) $value = 'xn--' . substr($value, 3);
-		if(function_exists('idn_to_utf8')) {
-			// use native php function if available
-			$value = @idn_to_utf8($value);
-		} else {
-			// otherwise use Punycode class
+		
+		if($version >= 3) {
+			// PHP IDN function
+			// 32=IDNA_NONTRANSITIONAL_TO_UNICODE
+			$info = array();
+			$value = idn_to_utf8($value, 32, INTL_IDNA_VARIANT_UTS46, $info); 
+			if(empty($value)) $value = $info['result'];
+			
+		} else if($version === 2) {
+			// Punycode library
 			$pc = new Punycode();
 			$value = $pc->decode($value);
+			
+		} else {
+			// PHP IDN with old/buggy behavior post PHP 7.4
+			$value = @idn_to_utf8($value);
 		}
+		
 		// if utf8 conversion failed, restore original value
 		if($value === false || !strlen($value)) $value = $_value;
+		
 		return $value;
 	}
 
@@ -943,41 +1060,92 @@ class Sanitizer extends Wire {
 	 * Encode a name value to PW-punycode
 	 * 
 	 * @param string $value
+	 * @param int $version 0=auto-detect, 1=original/buggy, 2=punycode library, 3=php idn function
 	 * @return string
 	 * 
 	 */
-	protected function punyEncodeName($value) {
-		// exclude values that don't need to be converted
-		if(strpos($value, 'xn-') === 0) return $value;
-		if(ctype_alnum(str_replace(array('.', '-', '_'), '', $value))) return $value;
+	protected function punyEncodeName($value, $version = 0) {
+		
 		$tt = $this->getTextTools();
+		$version = $this->getPunycodeVersion($version);
+		
+		if(strpos($value, 'xn-') === 0) {
+			if(ctype_alnum(str_replace(array('.', '-', '_'), '', $value))) {
+				return $value;
+			}
+		}
+
+		if($version > 1) {
+			$whitelist = $this->wire()->config->pageNameWhitelist;
+			$value = str_replace($this->pageNameBlacklist, '-', $value);
+			$v = '';
+			for($n = 0; $n < $tt->strlen($value); $n++) {
+				$c = $tt->substr($value, $n, 1);
+				if($tt->stripos($whitelist, $c) === false) {
+					$c = $this->pageName($c, self::translate);
+					if(empty($c) || $tt->stripos($whitelist, $c) === false) {
+						$c = '-';
+					}
+				}
+				$v .= $c;
+			}
+			while(strpos($v, '--') !== false) $v = str_replace('--', '-', $v);
+			$value = $tt->trim($v, '-');
+		}
+		
+		if(ctype_alnum(str_replace(array('.', '-', '_'), '', $value))) {
+			$value = $this->pageName(trim($value), true);
+			return $value;
+		}
 
 		while(strpos($value, '__') !== false) {
 			$value = str_replace('__', '_', $value);
 		}
-		
-		if(strlen($value) >= 50) {
+
+		if($version > 1) {
+			// version 2, 3
+			while(strpos($value, '--') !== false) {
+				$value = str_replace('--', '-', $value);
+			}
+			$value = trim($value, '-');
+			
+		} else if(strlen($value) >= 50) {
+			// version 1
 			$_value = $value;
 			$parts = array();
 			while(strlen($_value)) {
 				$part = $tt->substr($_value, 0, 12);
 				$_value = $tt->substr($_value, 12);
-				$parts[] = $this->punyEncodeName($part);
+				$parts[] = $this->punyEncodeName($part, $version);
 			}
 			$value = implode('__', $parts);
-			return $value; 
+			return $value;
 		}
-		
+
 		$_value = $value;
-		
-		if(function_exists("idn_to_ascii")) {
-			// use native php function if available
-			$value = substr(@idn_to_ascii($value), 3);
-		} else {
-			// otherwise use Punycode class
+
+		if($version >= 3) {
+			// PHP 7.4+ idn_to_ascii
+			$info = array();
+			// 16=IDNA_NONTRANSITIONAL_TO_ASCII
+			idn_to_ascii($value, 16, INTL_IDNA_VARIANT_UTS46, $info); 
+			// IDN return value fails on longer strings, but populates result correctly
+			$value = $info['result'];
+			
+		} else if($version === 2) {
+			// Punycode library
 			$pc = new Punycode();
-			$value = substr($pc->encode($value), 3);
+			$value = $pc->encode($value);
+			
+		} else {
+			// buggy behavior in PHP 7.4+ but pages may already be present with it
+			// INTL_IDNA_VARIANT_2003 is default prior to PHP 7.4
+			// substr() is also not right here but kept for v1 compatibility
+			$value = substr(@idn_to_ascii($value), 3);
 		}
+		
+		if(strpos($value, 'xn-') === 0) $value = substr($value, 3);
+		
 		if(strlen($value) && $value !== '-') {
 			// in PW the xn- prefix has one fewer hyphen than in native Punycode
 			// for compatibility with pageName sanitization and beautification
@@ -987,8 +1155,45 @@ class Sanitizer extends Wire {
 			// return value is always ascii
 			$value = $this->name($_value);
 		}
+		
 		return $value;
 	}
+	
+	/**
+	 * Get internal Punycode version to use
+	 *
+	 * 0: Auto-detect from current environment.
+	 * 1: PHP IDN function used by all PW versions prior to 3.0.244, but buggy PHP 7.4+.
+	 * 2: Dedicated Punycode PHP library (no known issues at present).
+	 * 3: PHP IDN function call updated for PHP 7.4+ (default in new installations after January 2025).
+	 *
+	 * @param int $version
+	 * @return int 1=PHP DN but buggy after PHP 7.4+, 2=Punycode library, 3=PHP IDN function PHP 7.4+
+	 * @since 3.0.244
+	 *
+	 */
+	protected function getPunycodeVersion($version = 0) {
+		$config = $this->wire()->config;
+		if(!$version) {
+			$whitelist = $config->pageNameWhitelist;
+			for($n = 3; $n > 0; $n--) {
+				if(strpos($whitelist, "v$n") !== false) $version = $n;
+				if($version) break;
+			}
+		}
+		if(!$version) $version = $config->installedAfter('2025-01-10') ? 3 : 1;
+		if(!function_exists('idn_to_utf8')) $version = 2;
+		if($version >= 3 && version_compare(phpversion(), '7.4.0', '<')) $version = 2;
+		return $version;
+	}
+
+	/**
+	 * @return Punycode
+	 * 
+	 */
+	protected function punycode() {
+		return new Punycode();
+	}
 
 	/**
 	 * Format required by ProcessWire user names
@@ -1008,7 +1213,17 @@ class Sanitizer extends Wire {
 	 * Name filter for ProcessWire filenames (basenames only, not paths)
 	 * 
 	 * This sanitizes a filename to be consistent with the name format in ProcessWire, 
-	 * ASCII-alphanumeric, hyphens, underscores and periods.
+	 * ASCII-alphanumeric (a-z A-Z 0-9), hyphens, underscores and periods. Note that 
+	 * filenames may contain mixed case (a-z A-Z) so if you require lowercase then
+	 * run the return value through a `strtolower()` function. 
+	 * 
+	 * ~~~~~
+	 * // outputs: FileName.jpg
+	 * echo $sanitizer->filename('©®™FileName.jpg');
+	 * 
+	 * // outputs: c_r_tmfilename.jpg
+	 * echo strtolower($sanitizer->filename('©®™filename.jpg', Sanitizer::translate));
+	 * ~~~~~
 	 * 
 	 * #pw-group-strings
 	 * #pw-group-files
@@ -1028,9 +1243,10 @@ class Sanitizer extends Wire {
 		
 		if(strlen($value) > $maxLength) {
 			// truncate, while keeping extension in tact
+			$tt = $this->getTextTools();
 			$pathinfo = pathinfo($value);
-			$extLen = strlen($pathinfo['extension']) + 1; // +1 includes period
-			$basename = substr($pathinfo['filename'], 0, $maxLength - $extLen);
+			$extLen = $tt->strlen($pathinfo['extension']) + 1; // +1 includes period
+			$basename = $tt->substr($pathinfo['filename'], 0, $maxLength - $extLen);
 			$value = "$basename.$pathinfo[extension]";
 		}
 		
@@ -1597,7 +1813,7 @@ class Sanitizer extends Wire {
 			'outCharset' => 'UTF-8',  // output charset
 			'truncateTail' => true, // if truncate necessary for maxLength, remove chars from tail? False to truncate from head.
 			'trim' => true, // trim whitespace from beginning/end, or specify character(s) to trim, or false to disable
-			);
+		);
 		
 		static $alwaysReplace = null;
 		$truncated = false;
@@ -1608,13 +1824,9 @@ class Sanitizer extends Wire {
 		if($options['maxBytes'] < 0) $options['maxBytes'] = 0;
 		
 		if($alwaysReplace === null) {
-			if($this->multibyteSupport) {
-				$alwaysReplace = array(
-					mb_convert_encoding('&#8232;', 'UTF-8', 'HTML-ENTITIES') => '', // line-seperator that is sometimes copy/pasted
-				);
-			} else {
-				$alwaysReplace = array();
-			}
+			$alwaysReplace = array(
+				html_entity_decode('&#8232;', ENT_QUOTES, 'UTF-8') => '', // line-seperator that is sometimes copy/pasted
+			);
 		}
 		
 		if($options['reduceSpace'] !== false && $options['stripSpace'] === false) {
@@ -1668,7 +1880,7 @@ class Sanitizer extends Wire {
 		}
 		
 		if($options['stripQuotes']) {
-			$value = str_replace(array('"', "'"), (is_string($options['stripQuotes']) ? $options['strip_quotes'] : ''), $value);
+			$value = str_replace(array('"', "'"), (is_string($options['stripQuotes']) ? $options['stripQuotes'] : ''), $value);
 		}
 		
 		if($options['trim']) {
@@ -1896,18 +2108,31 @@ class Sanitizer extends Wire {
 
 		if(strpos($value, '<') !== false) {
 			// tag replacements before strip_tags()
-			$regex =
-				'!<(?:' .
-					'/?(?:ul|ol|p|h\d|div)(?:>|\s[^><]*)' .
-					'|' . 
-					'(?:br[\s/]*)' .
-				')>!is';
-			$value = preg_replace($regex, $newline, $value);
+			if(stripos($value, '</ul>') || stripos($value, '</ol>')) {
+				$regex = '!<(?:/?(?:ul|ol)(?:>|\s[^><]*))>!i';
+				$value = preg_replace($regex, '', $value);
+			}
+			if(stripos($value, '</p>') || stripos($value, '</h') || stripos($value, '</div>')) {
+				$regex =
+					'!<(?:' .
+						'/?(?:p|h\d|div)(?:>|\s[^><]*)' .
+						'|' .
+						'(?:br[\s/]*)' .
+					')>!is';
+				$value = preg_replace($regex, $newline, $value);
+			}
 			if(stripos($value, '</li>')) {
 				$value = preg_replace('!</li>\s*<li!is', "$options[separator]<li", $value);
 			}
 		}
-	
+
+		// replace single less than sign that's not accompanied with a greater than sign
+		// to something that looks like it, but that strip_tags() won’t strip.
+		// this is to prevent something like "5<10" from getting converted to "5"
+		if(strpos($value, '<') !== false && strpos($value, '>') === false) {
+			$value = preg_replace('/<([\w\d])/', '≺$1', $value);
+		}
+		
 		// remove tags
 		$value = trim(strip_tags($value));
 
@@ -2287,7 +2512,7 @@ class Sanitizer extends Wire {
 
 		} else {
 			// domain contains utf8
-			$pc = function_exists("idn_to_ascii") ? false : new Punycode();
+			$pc = function_exists("idn_to_ascii") ? false : $this->punycode();
 			$domain = $pc ? $pc->encode($domain) : @idn_to_ascii($domain);
 			if($domain === false || !strlen($domain)) return '';
 			$url = $scheme . $domain . $rest;
@@ -3914,7 +4139,7 @@ class Sanitizer extends Wire {
 		$datetime = $this->wire()->datetime;
 		$iso8601 = 'Y-m-d H:i:s';
 		$_value = trim($this->string($value)); // original value string
-		if(empty($value)) return $options['default'];
+		if(empty($value) && !is_int($value) && !strlen("$value")) return $options['default'];
 		if(!is_string($value) && !is_int($value)) $value = $this->string($value);
 		if(ctype_digit("$value")) {
 			// value is in unix timestamp format
@@ -3925,7 +4150,7 @@ class Sanitizer extends Wire {
 			$value = $datetime->stringToTimestamp($value, $format); 
 		}
 		// value is now a unix timestamp
-		if(empty($value)) return null;
+		if($value === false) return null;
 		// if format is provided and in strict mode, validate for the format and bounds
 		if($format && $options['strict']) {
 			$test = $datetime->date($format, $value);
@@ -3942,7 +4167,7 @@ class Sanitizer extends Wire {
 			if($value > $max) return null;
 		}
 		if(!empty($options['returnFormat'])) $value = wireDate($options['returnFormat'], $value);
-		return empty($value) ? null : $value;
+		return ($value === null || $value === false) ? null : $value;
 	}
 
 	/**
@@ -4355,6 +4580,7 @@ class Sanitizer extends Wire {
 	 * 	- `delimiter` (string): Single delimiter to use to identify CSV strings. Overrides the 'delimiters' option when specified (default=null)
 	 * 	- `delimiters` (array): Delimiters to identify CSV strings. First found delimiter will be used, default=array("|", ",")
 	 * 	- `enclosure` (string): Enclosure to use for CSV strings (default=double quote, i.e. `"`)
+	 * 	- `escape` (string): Escape to use for CSV strings (default=backslash, i.e. "\\")
 	 * @return array
 	 * @throws WireException if an unknown $sanitizer method is given
 	 *
@@ -4370,6 +4596,7 @@ class Sanitizer extends Wire {
 			'delimiter' => null, 
 			'delimiters' => array('|', ','),
 			'enclosure' => '"',
+			'escape' => "\\", 
 			'trim' => true, 
 			'sanitizer' => null, 
 			'keySanitizer' => null,
@@ -4408,7 +4635,7 @@ class Sanitizer extends Wire {
 						}
 					}
 					if($hasDelimiter !== null) {
-						$value = str_getcsv($value, $hasDelimiter, $options['enclosure']);
+						$value = str_getcsv($value, $hasDelimiter, $options['enclosure'], $options['escape']);
 					} else {
 						$value = array($value);
 					}
@@ -5101,7 +5328,7 @@ class Sanitizer extends Wire {
 	 * @param string|int|array|float $value
 	 * @param int $maxLength Maximum length (default=128)
 	 * @param null|int $maxBytes Maximum allowed bytes (used for string types only)
-	 * @return array|bool|float|int|string
+	 * @return array|float|int|string
 	 * @since 3.0.125
 	 * @see Sanitizer::minLength()
 	 * 
@@ -5272,6 +5499,24 @@ class Sanitizer extends Wire {
 		}
 		return $this->textTools;
 	}
+	
+	/**
+	 * Get instance of WireNumberTools
+	 *
+	 * #pw-group-numbers
+	 * #pw-group-other
+	 *
+	 * @return WireNumberTools
+	 * @since 3.0.214
+	 *
+	 */
+	public function getNumberTools() {
+		if(!$this->numberTools) {
+			$this->numberTools = new WireNumberTools();
+			$this->wire($this->numberTools);
+		}
+		return $this->numberTools;
+	}
 
 	/**********************************************************************************************************************
 	 * FILE VALIDATORS
@@ -5699,4 +5944,3 @@ class Sanitizer extends Wire {
 	}
 
 }
-

wire/core/Selectors.php

@@ -109,6 +109,8 @@ class Selectors extends WireArray {
 	 */
 	public function __construct($selector = null) {
 		parent::__construct();
+		$this->usesNumericKeys = false;
+		$this->indexedByName = false;
 		if(!is_null($selector)) $this->init($selector);
 	}
 
@@ -771,38 +773,99 @@ class Selectors extends WireArray {
 	 * @param Wire $item
 	 * @return bool
 	 * 
-	 */
+	 */ 
 	public function matches(Wire $item) {
-		
-		// if item provides it's own matches function, then let it have control
+
+		// if item provides it's own matches function (like Page), then let it have control
 		if($item instanceof WireMatchable) return $item->matches($this);
-	
+
+		$orGroups = array();
 		$matches = true;
+
 		foreach($this as $selector) {
-			$value = array();
-			foreach($selector->fields as $property) {
-				if(strpos($property, '.') && $item instanceof WireData) {
-					$value[] =  $item->getDot($property);
-				} else {
-					$value[] = (string) $item->$property;
-				}
-			}
-			if(!$selector->matches($value)) {
-				$matches = false;
-				// attempt any alternate operators, if present
-				foreach($selector->altOperators as $altOperator) {
-					$altSelector = self::getSelectorByOperator($altOperator); 
-					if(!$altSelector) continue;
-					$this->wire($altSelector);
-					$selector->copyTo($altSelector);
-					$matches = $altSelector->matches($value);
-					if($matches) break;
-				}
-				// if neither selector nor altSelectors match then stop
+			if($selector->quote === '(' && self::stringHasOperator($selector->value())) {
+				$name = $selector->field();
+				if(!isset($orGroups[$name])) $orGroups[$name] = array();
+				$orGroups[$name][] = $selector->value;
+			} else {
+				$matches = $this->matchesSelector($selector, $item);
 				if(!$matches) break;
 			}
 		}
+
+		if($matches && count($orGroups)) {
+			$matches = $this->matchesOrGroups($orGroups, $item);
+		}
+
+		return $matches;
+	}
+
+	/**
+	 * Does the given Wire match these Selector (single)?
+	 *
+	 * @param Selector $selector
+	 * @param Wire $item
+	 * @return bool
+	 * @since 3.0.330
+	 *
+	 */
+	protected function matchesSelector(Selector $selector, Wire $item) {
+		$value = array();
 		
+		foreach($selector->fields as $property) {
+			if(strpos($property, '.') && $item instanceof WireData) {
+				$v = $item->getDot($property);
+			} else {
+				$v = $item->$property;
+			}
+			if(is_array($v)) {
+				$value = array_merge($value, $v);
+			} else {
+				$value[] = (string) $v;
+			}
+		}
+	
+		$matches = $selector->matches($value);
+		if($matches) return true;
+		
+		// attempt any alternate operators, if present
+		foreach($selector->altOperators as $altOperator) {
+			$altSelector = self::getSelectorByOperator($altOperator);
+			if(!$altSelector) continue;
+			$this->wire($altSelector);
+			$selector->copyTo($altSelector);
+			$matches = $altSelector->matches($value);
+			if($matches) break;
+		}
+
+		return $matches;
+	}
+	
+	/**
+	 * Do the given OR-groups match the given Wire?
+	 *
+	 * @param array|string[]|array[] $orGroups
+	 * @param Wire $item
+	 * @return bool
+	 * @since 3.0.330
+	 *
+	 */
+	protected function matchesOrGroups(array $orGroups, Wire $item) {
+		$matches = true;
+		foreach($orGroups as $selectorStrings) {
+			$orGroupMatches = false;
+			foreach($selectorStrings as $s) {
+				/** @var Selectors $orGroupSelectors */
+				$orGroupSelectors = $this->wire(new Selectors($s));
+				if(!$orGroupSelectors->matches($item)) continue;
+				$orGroupMatches = true;
+				break;
+			}
+			if(!$orGroupMatches) {
+				$matches = false;
+				break;
+			}
+		}
 		return $matches;
 	}
 
@@ -1276,8 +1339,8 @@ class Selectors extends WireArray {
 	 *  - `getIndexType` (string): Index type to use in returned array: 'operator', 'className', 'class', or 'none' (default='class')
 	 *  - `getValueType` (string): Value type to use in returned array: 'operator', 'class', 'className', 'label', 'description', 'compareType', 'verbose' (default='operator').
 	 *     If 'verbose' option used then assoc array returned for each operator containing 'class', 'className', 'operator', 'compareType', 'label', 'description'.
-	 * @return array|string|int Returned array where both keys and values are operators (or values are requested 'valueType' option)
-	 *   If 'operator' option specified, return value is string, int or array (requested 'valueType'), and there is no indexType.
+	 * @return array|string|int Returned array where values are operators and keys are class names (or requested 'getIndexType or 'getValueType' options)
+	 *   If 'operator' option specified, return value is string, int or array (of requested 'getValueType'), and there is no index.
 	 * @since 3.0.154
 	 *
 	 */
@@ -1620,7 +1683,7 @@ class Selectors extends WireArray {
 	 *  - `operator` (string): Require this operator (default='' for any) 
 	 *  - `value` (string|int): Require this value (default=null for any)
 	 *  - `remove` (bool): Remove matched Selector from Selectors returned in verbose result? (default=false)
-	 * @return array|bool True of has field, false if not, or array with the following if 'verbose' option requested:
+	 * @return array|bool True if has field, false if not, or array with the following, if 'verbose' option requested:
 	 *  - `result` (bool): Did it match (true or false)
 	 *  - `selector` (Selector|null): Selector object that matched (only if result is true)
 	 *  - `selectors` (Selectors|null): Selectors object that was analyzed or null if not needed

wire/core/Session.php

@@ -311,6 +311,9 @@ class Session extends Wire implements \IteratorAggregate {
 			} else {
 				ini_set("session.save_path", rtrim($this->config->paths->sessions, '/'));
 			}
+		} else {
+			if(!ini_get('session.gc_probability')) ini_set('session.gc_probability', 1);
+			if(!ini_get('session.gc_divisor')) ini_set('session.gc_divisor', 100);
 		}
 		
 		$options = array();
@@ -378,7 +381,7 @@ class Session extends Wire implements \IteratorAggregate {
 			// if valid, update last request time
 			$this->set('_user', 'ts', time());
 			
-		} else if($reason && $userID && $userID != $this->wire('config')->guestUserPageID) {
+		} else if($reason && $userID && $userID != $this->config->guestUserPageID) {
 			// otherwise log the invalid session
 			$user = $this->wire()->users->get((int) $userID);
 			if($user && $user->id) $reason = "User '$user->name' - $reason";
@@ -1428,7 +1431,11 @@ class Session extends Wire implements \IteratorAggregate {
 	/**
 	 * Manually close the session, before program execution is done
 	 * 
-	 * #pw-internal
+	 * A user session is limited to rendering one page at a time, unless the session is closed
+	 * early. Use this when you have a request that may take awhile to render (like a request 
+	 * rendering a sitemap, etc.) and you don't need to get/save session data. By closing the session 
+	 * before starting a render, you can release the session to be available for the user to view
+	 * other pages while the slower page render continues. 
 	 * 
 	 */
 	public function close() {
@@ -1699,7 +1706,7 @@ class Session extends Wire implements \IteratorAggregate {
 	 * @since 3.0.166
 	 *
 	 */
-	public function sessionHandler(WireSessionHandler $sessionHandler = null) {
+	public function sessionHandler(?WireSessionHandler $sessionHandler = null) {
 		if($sessionHandler) $this->sessionHandler = $sessionHandler;
 		return $this->sessionHandler;
 	}

wire/core/Template.php

@@ -59,8 +59,8 @@
  * @property string $sortfield Field that children of templates using this page should sort by (leave blank to let page decide, or specify "sort" for manual drag-n-drop). #pw-group-family
  * @property int $noChildren Set to 1 to cancel use of childTemplates. #pw-group-family
  * @property int $noParents Set to 1 to cancel use of parentTemplates, set to -1 to only allow one page using this template to exist. #pw-group-family
- * @property array $childTemplates Array of template IDs that are allowed for children. Blank array indicates "any".  #pw-group-family
- * @property array $parentTemplates Array of template IDs that are allowed for parents. Blank array indicates "any". #pw-group-family
+ * @property int[] $childTemplates Array of template IDs that are allowed for children. Blank array indicates "any".  #pw-group-family
+ * @property int[] $parentTemplates Array of template IDs that are allowed for parents. Blank array indicates "any". #pw-group-family
  * @property string $childNameFormat Name format for child pages. when specified, the page-add UI step can be skipped when adding children. Counter appended till unique. Date format assumed if any non-pageName chars present. Use 'title' to pull from title field. #pw-group-family
  * 
  * URLs
@@ -759,7 +759,7 @@ class Template extends WireData implements Saveable, Exportable {
 			$fieldgroup = $this->wire()->fieldgroups->get($value);
 			if($fieldgroup) {
 				$this->setFieldgroup($fieldgroup);
-			} else {
+			} else if($this->id) {
 				$this->error("Unable to load fieldgroup '$value' for template $this->name");
 			}
 			return;
@@ -1171,7 +1171,6 @@ class Template extends WireData implements Saveable, Exportable {
 	 * Given an array of export data, import it
 	 * 
 	 * @param array $data
-	 * @return bool True if successful, false if not
 	 * @return array Returns array(
 	 * 	[property_name] => array(
 	 * 		'old' => 'old value', // old value (in string comparison format)
@@ -1222,7 +1221,7 @@ class Template extends WireData implements Saveable, Exportable {
 	 * #pw-group-family
 	 *
 	 * @param array|TemplatesArray|null $setValue Specify only when setting, an iterable value containing Template objects, IDs or names
-	 * @return TemplatesArray
+	 * @return TemplatesArray|Template[]
 	 * @since 3.0.153
 	 *
 	 */
@@ -1237,7 +1236,7 @@ class Template extends WireData implements Saveable, Exportable {
 	 * 
 	 * @param string $property Specify either 'childTemplates' or 'parentTemplates'
 	 * @param array|TemplatesArray|null $setValue Iterable value containing Template objects, IDs or names
-	 * @return TemplatesArray
+	 * @return TemplatesArray|Template[]
 	 * @since 3.0.153
 	 * 
 	 */
@@ -1267,6 +1266,7 @@ class Template extends WireData implements Saveable, Exportable {
 				if($template) $value->add($template);
 			}
 		}
+		/** @var TemplatesArray|Template[] $value */
 		
 		return $value; 
 	}
@@ -1299,8 +1299,8 @@ class Template extends WireData implements Saveable, Exportable {
 	 * This is based on family settings, when applicable. 
 	 * It also takes into account user access, if requested (see arg 1). 
 	 *
-	 * If there is no shortcut parent, NULL is returned. 
-	 * If there are multiple possible shortcut parents, a NullPage is returned.
+	 * If there is no defined parent, NULL is returned. 
+	 * If there are multiple defined parents, a NullPage is returned.
 	 * 
 	 * #pw-group-family
 	 *
@@ -1313,7 +1313,7 @@ class Template extends WireData implements Saveable, Exportable {
 	}
 
 	/**
-	 * Return all possible parent pages for this template
+	 * Return all defined parent pages for this template
 	 * 
 	 * #pw-group-family
 	 * 
@@ -1617,5 +1617,3 @@ class Template extends WireData implements Saveable, Exportable {
 	}
 
 }
-
-

wire/core/TemplateFile.php

@@ -609,14 +609,20 @@ class TemplateFile extends WireData {
 	 * 
 	 * USAGE from template file is: return $this->halt();
 	 * 
-	 * @param bool $halt
+	 * @param bool|string $halt
+	 *  If given boolean, it will set the halt status.
+	 *  If given string, it will be output (3.0.239+)
 	 * @return $this
 	 * 
 	 */
-	protected function halt($halt = true) {
-		$this->halt = $halt ? true : false;
+	public function halt($halt = true) {
+		if(is_bool($halt)) {
+			$this->halt = $halt ? true : false;
+		} else if(is_string($halt)) {
+			$this->halt = true;
+			echo $halt;
+		}
 		return $this;
 	}
 	
 }
-