Initial checkin

inc/FileHelpers.php

@@ -0,0 +1,110 @@
+<?php
+
+
+/// Perform a move by copy, and if successful then delete the prior version
+///
+function MoveFiles($src, $dst) {
+	TraceProgram(__FILE__, __FUNCTION__, __LINE__, "move($src, $dst)", TR_ENTRY);
+
+	// Source - https://stackoverflow.com/q/9835492
+	// Posted by Sara, modified by community. See post 'Timeline' for change history
+	// Retrieved 2026-10-18, License - CC BY-SA 3.0
+
+	// Get array of all source files
+	$files = scandir($src);
+	// Identify directories
+	// Cycle through all source files
+	$delete = array();
+	foreach ($files as $file) {
+		if (in_array($file, array(".",".."))) continue;
+		// If we copied this successfully, mark it for deletion
+		TraceProgram(__FILE__, __FUNCTION__, __LINE__, "copy($src.$file, $dst.$file)");
+		if (copy($src.$file, $dst.$file)) {
+			$delete[] = $src.$file;
+		}
+	}
+	// Delete all successfully-copied files
+	foreach ($delete as $file) {
+		TraceProgram(__FILE__, __FUNCTION__, __LINE__, "unlink($file)");
+		unlink($file);
+	}
+	TraceProgram(__FILE__, __FUNCTION__, __LINE__, "", TR_EXIT);
+}
+
+
+function MakeValidFolderName($input, $replacement = '_') {
+	// Ensure input is not empty
+    if (trim($input) === '') {
+        return 'untitled';
+    }
+	$input = mb_convert_encoding($input, 'UTF-8', 'UTF-8');
+	$input = preg_replace('/\s+/', $replacement, $input);
+	$input = preg_replace('~[\\/:*?"<>|\x00-\x1F]~', '', $input);
+	$input = preg_replace('/[^A-Za-z0-9._-]/', $replacement, $input);
+	$input = preg_replace('/' . preg_quote($replacement, '/') . '+/', $replacement, $input);
+	$input = trim($input, $replacement);
+	if ($input === '') {
+        return 'untitled';
+    }
+	return $input;
+}
+
+
+function ReadTableData($path, $formFields, &$userData) {
+	$success = false;
+	TraceProgram(__FILE__, __FUNCTION__, __LINE__, "", TR_ENTRY);
+	$path = @rtrim($path, "/");
+	$fqfnData = $path . '/' . 'data.txt';
+	if (file_exists($fqfnData)) {
+		TraceProgram(__FILE__, __FUNCTION__, __LINE__, $fqfnData);
+		$fh = fopen($fqfnData, "r");
+		while (!feof($fh)) {
+			$line = trim(fgets($fh));
+			if ($line != "") {
+				TraceProgram(__FILE__, __FUNCTION__, __LINE__, "$line");
+				$array = explode("=", $line, 2);
+				$userData[$array[0]] = $array[1];
+				$success = true;
+			}
+		}
+		fclose($fh);
+		foreach ($formFields as $key => $value) {
+			if ($value['FieldType'] == "pix") {
+				if (isset($userData[$key])) {
+					$fqfnPix = sprintf("%s/%s", $path, $userData[$key]);
+					if ($userData[$key] == '') {	// but maybe the file exists
+						TraceProgram(__FILE__, __FUNCTION__, __LINE__, "fqfnPix: $fqfnPix, key: $key");
+						$candidates = glob($fqfnPix . $key . ".*");
+						TraceProgram(__FILE__, __FUNCTION__, __LINE__, print_r($candidates, true));
+						foreach ($candidates as $candidate) {
+							TraceProgram(__FILE__, __FUNCTION__, __LINE__, $candidate);
+							$userData[$key] = basename($candidate);
+						}
+					}
+					$userData[$key] = (file_exists($fqfnPix)) ? $userData[$key] : '';
+					$success = true;
+				}
+			}
+		}
+	} else {
+		TraceProgram(__FILE__, __FUNCTION__, __LINE__, "file '$fqfnData' does not exist.");
+	}
+	TraceProgram(__FILE__, __FUNCTION__, __LINE__, "", TR_EXIT);
+	return $success;
+}
+
+function SaveTableData($path, $formFields, $formData) {
+	TraceProgram(__FILE__, __FUNCTION__, __LINE__, "\nSaveTableData: " . print_r($formData, true), TR_ENTRY);
+	$dataFile = $path . "/data.txt";
+	$fh = fopen($dataFile, "wt");
+	if ($fh) {
+		foreach ($formFields as $key => $value) {
+			fprintf($fh, "%s=%s\n", $key, isset($formData[$key]) ? $formData[$key] : $value['Default']);
+		}
+		fclose($fh);
+	}
+	TraceProgram(__FILE__, __FUNCTION__, __LINE__, "", TR_EXIT);
+}
+
+
+?>