From 8e31a38c053bb97a0fee574acdb3da3bd72b4fa4 Mon Sep 17 00:00:00 2001
From: "Hagen, Kody J" <Kody.Hagen@bemidjistate.edu>
Date: Thu, 21 May 2026 11:20:34 -0500
Subject: [PATCH] feat(ruleset): enforce bsu_ / BSU_ prefix on global functions
 and classes

---
 ruleset.xml | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

diff --git a/ruleset.xml b/ruleset.xml
index c3bcc29..2e2cf1f 100644
--- a/ruleset.xml
+++ b/ruleset.xml
@@ -13,4 +13,40 @@
 	<rule ref="./Sniffs/Commenting"/>
 	<rule ref="./Sniffs/Functions"/>
 	<rule ref="./Sniffs/Spacing"/>
+
+	<!--
+		Enforce BSU_ prefix on all global PHP symbols to prevent naming collisions
+		with WordPress core and plugins, and to make theme code instantly identifiable
+		in stack traces.
+
+		Covers: functions (bsu_), classes (BSU_), constants (BSU_).
+
+		Hook names and global variables are excluded:
+		- Hook names: WordPress core hooks (the_content, gallery_style, etc.) cannot be
+		  renamed. We hook into them via add_filter/apply_filters — not defining new ones.
+		- Global variables: WordPress core globals ($post, $wpdb, $wp_query) are accessed
+		  with the global keyword inside methods. The rule cannot distinguish accessing an
+		  existing global from declaring a new one.
+	-->
+	<rule ref="WordPress.NamingConventions.PrefixAllGlobals">
+		<properties>
+			<property name="prefixes" type="array">
+				<element value="bsu_"/>
+				<element value="BSU_"/>
+			</property>
+		</properties>
+		<!--
+			Exclude template files (view layer — unprefixed local variables by design),
+			the BSU facade (named exactly "BSU" with no slug suffix), and any vendor or
+			Sniff directories that belong to the standard itself rather than project code.
+		-->
+		<exclude-pattern>*/template-parts/*\.php$</exclude-pattern>
+		<exclude-pattern>*/template-*\.php$</exclude-pattern>
+		<exclude-pattern>*/templateincludes-*\.php$</exclude-pattern>
+		<exclude-pattern>*/functions/class-bsu\.php$</exclude-pattern>
+		<exclude-pattern>*/Sniffs/*\.php$</exclude-pattern>
+		<exclude-pattern>*/vendor/*\.php$</exclude-pattern>
+		<exclude name="WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedHooknameFound"/>
+		<exclude name="WordPress.NamingConventions.PrefixAllGlobals.NonPrefixedVariableFound"/>
+	</rule>
 </ruleset>