From 5c448c05a9840ae12b907f8a0ec03489e9925275 Mon Sep 17 00:00:00 2001
From: johnnyq <johnny@pittpc.com>
Date: Mon, 22 Sep 2025 19:33:40 -0400
Subject: [PATCH] Update .gitignore and add custom directories to /admin
 /client /guest /user Example Documentation coming soon

---
 .gitignore                           | 10 ++++++-
 admin/custom/readme.php              |  8 ++++++
 {custom => client/custom}/readme.php |  5 ++--
 custom/post.php                      | 40 ----------------------------
 custom/post/readme.php               | 13 ---------
 custom/test.php                      | 18 -------------
 guest/custom/readme.php              |  9 +++++++
 user/custom/readme.php               |  9 +++++++
 8 files changed, 38 insertions(+), 74 deletions(-)
 create mode 100644 admin/custom/readme.php
 rename {custom => client/custom}/readme.php (72%)
 delete mode 100644 custom/post.php
 delete mode 100644 custom/post/readme.php
 delete mode 100644 custom/test.php
 create mode 100644 guest/custom/readme.php
 create mode 100644 user/custom/readme.php

diff --git a/.gitignore b/.gitignore
index f60657bd..6680ff1e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -25,6 +25,14 @@ plugins/htmlpurifier/standalone/HTMLPurifier/DefinitionCache/Serializer/CSS/*
 xcustom/*
 !xcustom/readme.php
 post/xcustom
-custom/*
 !post/xcustom/readme.php
+admin/custom/*
+!admin/custom/readme.php
+client/custom/*
+!client/custom/readme.php
+guest/custom/*
+!guest/custom/readme.php
+user/custom/*
+!user/custom/readme.php
 .zed
+
diff --git a/admin/custom/readme.php b/admin/custom/readme.php
new file mode 100644
index 00000000..498c1b53
--- /dev/null
+++ b/admin/custom/readme.php
@@ -0,0 +1,8 @@
+<?php
+
+/*
+
+- Custom Pages -
+     If you wish to add custom pages to ITFlow, add them to this directory"
+     Link to Documentation for File Directory Structure and examples
+*/
diff --git a/custom/readme.php b/client/custom/readme.php
similarity index 72%
rename from custom/readme.php
rename to client/custom/readme.php
index fe9adc48..6f3cf5d6 100644
--- a/custom/readme.php
+++ b/client/custom/readme.php
@@ -4,6 +4,7 @@
 
 - Custom Pages -
 
-    If you wish to add custom pages to ITFlow, add them to this directory with the prefix "custom_"
-
+    If you wish to add custom pages to ITFlow, add them to this directory"
+    
 */
+
diff --git a/custom/post.php b/custom/post.php
deleted file mode 100644
index 9737b77a..00000000
--- a/custom/post.php
+++ /dev/null
@@ -1,40 +0,0 @@
-<?php
-
-/*
- * ITFlow - Custom GET/POST request handler
- */
-
-require_once "../config.php";
-require_once "../functions.php";
-require_once "../includes/check_login.php";
-
-// Define a variable that we can use to only allow running post files via inclusion (prevents people/bots poking them)
-define('FROM_POST_HANDLER', true);
-
-
-// Determine which files we should load
-
-// Parse URL & get the path
-$path = parse_url($_SERVER['HTTP_REFERER'], PHP_URL_PATH);
-
-// Get the base name (the page name)
-$module = explode(".", basename($path))[0];
-
-// Strip off any _details bits
-$module = str_ireplace('_details', '', $module);
-
-// Dynamically load admin-related module POST logic
-if (str_contains($module, 'custom')) {
-    // Dynamically load any custom POST logic
-
-    include_once "post/$module.php";
-
-}
-
-// Logout is the same for user and admin
-require_once "../post/logout.php";
-
-// TODO: Find a home for these
-
-require_once "../post/ai.php";
-require_once "../post/misc.php";
diff --git a/custom/post/readme.php b/custom/post/readme.php
deleted file mode 100644
index bbfca6b4..00000000
--- a/custom/post/readme.php
+++ /dev/null
@@ -1,13 +0,0 @@
-<?php
-
-/*
-    - Custom Pages -
-
-    If you wish to add custom pages to ITFlow, add them to the xcustom folder in the root directory with the prefix "xcustom_"
-        e.g. If your page was called my_page_one, name it "xcustom/xcustom_my_page_one.php"
-    Note: If required, you can use the Custom Links module to have the page show on the user sidebar.
-
-    To process POST data via your custom pages, create a file in this directory (post/xcustom) named after your page (e.g. xcustom_my_page_one.php).
-    The relevant file will be automatically loaded upon a POST request based on the referer - your form just needs to target the standard root/post.php.
-
- */
diff --git a/custom/test.php b/custom/test.php
deleted file mode 100644
index 22e056ed..00000000
--- a/custom/test.php
+++ /dev/null
@@ -1,18 +0,0 @@
-<?php
-require_once "../includes/inc_xcustom.php";
-?>
-
-    <!-- Breadcrumbs-->
-    <ol class="breadcrumb">
-        <li class="breadcrumb-item">
-            <a href="index.html">Dashboard</a>
-        </li>
-        <li class="breadcrumb-item active">Blank Page</li>
-    </ol>
-
-    <!-- Page Content -->
-    <h1>Blank Page</h1>
-    <hr>
-    <p>This is a great starting point for new custom pages.</p>
-
-<?php require_once "../includes/footer.php";
diff --git a/guest/custom/readme.php b/guest/custom/readme.php
new file mode 100644
index 00000000..3919d43c
--- /dev/null
+++ b/guest/custom/readme.php
@@ -0,0 +1,9 @@
+<?php
+
+/*
+
+- Custom Pages -
+
+    If you wish to add custom pages to ITFlow, add them to this directory"
+
+*/
diff --git a/user/custom/readme.php b/user/custom/readme.php
new file mode 100644
index 00000000..3919d43c
--- /dev/null
+++ b/user/custom/readme.php
@@ -0,0 +1,9 @@
+<?php
+
+/*
+
+- Custom Pages -
+
+    If you wish to add custom pages to ITFlow, add them to this directory"
+
+*/