Update

Author: PDowney

.github/copilot-instructions.md

@@ -17,12 +17,14 @@ applyTo: '**'
 ## 📋 Essential Requirements
 
 ### WordPress Compatibility
+
 - **WordPress:** 6.5+ minimum
 - **PHP:** 7.4+ minimum  
 - **WooCommerce:** 5.0+ (when applicable)
 - Follow [WordPress Coding Standards](https://developer.wordpress.org/coding-standards/) for PHP, JS, CSS, HTML, and accessibility
 
 ### Code Quality Standards
+
 1. **Security First:** Always sanitize input (`sanitize_*()`) and escape output (`esc_*()`)
 2. **WordPress APIs:** Use WP functions instead of raw PHP/SQL
 3. **Hook System:** Proper use of `add_action()` and `add_filter()`
@@ -55,8 +57,7 @@ applyTo: '**'
 
 **Version Release Process (only when instructed):**
 - Follow semantic versioning (MAJOR.MINOR.PATCH)
-- Update version in: plugin header, README.md, readme.txt, CHANGELOG.md
-- Update version in: constants section, .pot files, package.json, composer.json
+- Update version in: plugin header, README.md, readme.txt, CHANGELOG.md, GEMINI.md, and `.pot` language files, constants section, package.json, and composer.json
 - Move "Unreleased" changes to new version section in both changelogs
 - **Never auto-update versions** - wait for explicit instruction
 
@@ -65,6 +66,11 @@ applyTo: '**'
 - Write clear function/class descriptions
 - Document security considerations and hooks used
 
+**Internationalization (i18n):**
+- Update `.pot` language files when adding or modifying translatable strings
+- Always use the correct text domain when dealing with translation functions
+- Mark all user-facing strings with `__()`, `_e()`, `esc_html__()`, `esc_attr__()`, etc.
+
 ## ⚡ Performance & Quality
 
 **Performance Optimization:**

GEMINI.md

@@ -1,13 +1,11 @@
-# Project-specific instructions for Gemini AI
-# This file provides context about the Optimizations ACE MC WordPress plugin
-# to help Gemini understand the codebase and provide better analysis
-
 # Optimizations ACE MC - WordPress Plugin
 
 ## Project Overview
+
 This is a lightweight WordPress optimization plugin designed specifically for a single-site deployment with guaranteed WooCommerce and WP Store Locator plugin availability.
 
 ## Plugin Details
+
 - **Name:** Optimizations ACE MC
 - **Version:** Latest
 - **WordPress Compatibility:** 6.5+
@@ -18,7 +16,9 @@ This is a lightweight WordPress optimization plugin designed specifically for a
 ## Architecture & Design Patterns
 
 ### Singleton Pattern
+
 The main plugin class uses the singleton pattern to ensure only one instance exists:
+
 ```php
 protected static $instance = null;
 public static function instance() {
@@ -30,6 +30,7 @@ public static function instance() {
 ```
 
 ### File Structure
+
 - `optimizations-ace-mc.php` - Main plugin bootstrap file
 - `class-optimizations-ace-mc.php` - Core plugin functionality
 - `languages/` - Translation files
@@ -38,20 +39,23 @@ public static function instance() {
 ## WordPress Coding Standards
 
 ### Naming Conventions
+
 - **Functions:** `snake_case` (WordPress standard)
 - **Classes:** `PascalCase_With_Underscores` (WordPress standard)
 - **Variables:** `$snake_case`
 - **Constants:** `UPPER_SNAKE_CASE`
 - **Files:** `lowercase-with-hyphens.php`
 
 ### Security Requirements
+
 - Always use `esc_html()`, `esc_attr()`, `esc_url()` for output
 - Sanitize input with `sanitize_text_field()`, `absint()`, etc.
 - Use `current_user_can()` for capability checks
 - Implement proper nonce verification for forms
 - Use WordPress database functions, never raw SQL
 
 ### WordPress Integration
+
 - **Hooks:** Prefer actions and filters over direct function calls
 - **Database:** Use WordPress functions (`get_option`, `get_post_meta`, etc.)
 - **Internationalization:** All strings must use `__()` or `esc_html__()`
@@ -60,7 +64,9 @@ public static function instance() {
 ## Plugin-Specific Context
 
 ### Single-Site Deployment
+
 This plugin is designed for a dedicated environment where:
+
 - WooCommerce is guaranteed to be active (no activation checks needed)
 - WP Store Locator is guaranteed to be active (no activation checks needed)
 - Performance optimizations can be more aggressive
@@ -69,29 +75,34 @@ This plugin is designed for a dedicated environment where:
 ### Core Functionality
 
 #### WooCommerce Optimizations
+
 - Show empty product categories
 - Hide category product counts
 - Add order count column to admin users list
 - Admin-only functionality with proper capability checks
 
-#### WP Store Locator Optimizations  
+#### WP Store Locator Optimizations
+
 - Add store categories to location metadata
 - Customize info window templates
 - Disable REST API for store post types
 - Category display in map popups
 
 #### WordPress Admin Enhancements
+
 - Registration date column in users list
 - Sortable custom columns
 - Admin-only features with security checks
 
 ### Performance Considerations
+
 - Database queries should be cached where possible
 - WooCommerce order count queries run per user (consider caching)
 - Store category queries run per location (consider caching)
 - All admin features properly scoped to admin area only
 
 ### Security Focus Areas
+
 - Input sanitization for all user data
 - Output escaping for all dynamic content
 - Proper capability checks for admin functionality
@@ -100,18 +111,21 @@ This plugin is designed for a dedicated environment where:
 ## Development Standards
 
 ### Error Handling
+
 - Graceful degradation when dependencies missing
 - Proper validation of function parameters
 - No PHP errors or warnings in production
 - Meaningful error messages for debugging
 
 ### Documentation
+
 - Complete PHPDoc blocks for all methods
 - Inline comments for complex logic
 - README files for repository information
 - Changelog maintenance with semantic versioning
 
 ### Testing & Quality Assurance
+
 - PHPStan static analysis (Level 5)
 - PHPCS WordPress coding standards
 - PHPMD mess detection
@@ -121,20 +135,23 @@ This plugin is designed for a dedicated environment where:
 ## When Reviewing Code
 
 ### Critical Issues to Flag
+
 1. **Security vulnerabilities** (SQL injection, XSS, CSRF)
 2. **WordPress standard violations**
 3. **Performance bottlenecks** (uncached database queries)
 4. **Missing input validation or output escaping**
 5. **Capability check bypasses**
 
 ### Positive Patterns to Recognize
+
 1. Proper use of WordPress APIs
 2. Consistent error handling
 3. Performance optimizations
 4. Security best practices
 5. Clear documentation
 
 ### Suggestions to Provide
+
 1. WordPress-specific solutions over generic PHP
 2. Performance improvements through caching
 3. Security enhancements