Skip to main content

Suma Patches

WordPress core customizations and performance optimizations to meet Rhino Group standards.

Overview​

Suma Patches is a must-use plugin that applies targeted modifications to WordPress core functionality, admin interface, WooCommerce, and Algolia search. It enables/disables specific WordPress features and implements custom behaviors that improve performance, security, and user experience across Rhino Group client sites.

Current Version: 1.5.21
Type: Must-Use Plugin (mu-plugin)
Text Domain: suma-patches

Key Features​

System-Level Patches​

  • Performance Optimization — Disable unnecessary WordPress features
  • Security Hardening — Remove version numbers and meta generators
  • Admin Interface — Customize WordPress admin for clients
  • Core Modifications — Adjust WordPress behavior without theme changes

WooCommerce Enhancements​

  • Checkout Customizations — Modify checkout flow and fields
  • Product Display — Adjust product templates and layouts
  • Cart Modifications — Custom cart behavior and calculations
  • Order Processing — Custom order handling logic

Frontend Modifications​

  • Script Management — Control JavaScript loading and dependencies
  • Style Overrides — Custom CSS injections
  • Template Adjustments — Modify WordPress template output
  • Content Filtering — Adjust post and page content display

Admin Customizations​

  • Dashboard Widgets — Remove or add custom dashboard widgets
  • Menu Modifications — Adjust admin menu structure
  • Editor Enhancements — Custom Gutenberg blocks or classic editor tweaks
  • User Interface — Streamline admin experience for clients

Image Handling​

  • Image Optimization — Custom image processing rules
  • Thumbnail Generation — Control WordPress image sizes
  • Lazy Loading — Custom lazy load implementations
  • Srcset Management — Optimize responsive images

Algolia Integration Patches​

  • Search Configuration — Custom Algolia search settings
  • Index Management — Control what gets indexed
  • Query Modifications — Adjust search queries
  • Faceting Adjustments — Custom faceted search behavior

How It Works​

WordPress Core Load
    ↓
Suma Patches Initialization
    ↓
Load Patch Classes
    ↓
Hook into WordPress
    ↓
Apply Modifications
    ↓
Modified WordPress Behavior

Architecture Overview​

The plugin uses a modular class-based architecture:

  • System — Core WordPress modifications
  • Admin — Admin interface customizations
  • Frontend — Public-facing changes
  • Images — Image handling and optimization
  • WooCommerce — WooCommerce-specific patches
  • Algolia — Algolia search modifications

Each class contains focused modifications for its domain.

Use Cases​

  • Performance — Disable unnecessary WordPress features (emoji scripts, embeds, etc.)
  • Security — Hide WordPress version and generator tags
  • Branding — Customize admin interface for white-label clients
  • Functionality — Add missing features or modify existing behavior
  • E-commerce — WooCommerce customizations that apply site-wide
  • Search — Algolia search enhancements

Common Patches​

System Patches​

  • Disable XML-RPC
  • Remove WordPress version meta tags
  • Disable emoji scripts
  • Control REST API access
  • Adjust memory limits
  • Custom upload file types

Admin Patches​

  • Hide admin notices
  • Custom admin footer text
  • Remove dashboard widgets
  • Modify admin menu items
  • Custom admin CSS
  • Login page branding

Frontend Patches​

  • Remove query strings from static resources
  • Defer JavaScript loading
  • Custom excerpt lengths
  • Modify search behavior
  • Control comment display

WooCommerce Patches​

  • Custom checkout fields
  • Modify product templates
  • Adjust cart calculations
  • Custom order statuses
  • Email template modifications

Image Patches​

  • Disable specific image sizes
  • Custom thumbnail dimensions
  • Optimize image quality
  • WebP support
  • Lazy loading configuration

Technical Requirements​

  • WordPress 6.4 or higher
  • PHP 8.0 or higher
  • WooCommerce (if using WooCommerce patches)
  • WP Search with Algolia (if using Algolia patches)

Installation​

As a must-use plugin, Suma Patches should be installed in:

wp-content/mu-plugins/suma-patches/

Or as a regular plugin in:

wp-content/plugins/suma-patches/

Activation: Automatic (mu-plugin) or manual (regular plugin)

Configuration​

Most patches are applied automatically. Some features can be configured via:

  • WordPress constants in wp-config.php
  • WordPress options in database
  • Theme function overrides
  • Custom filter hooks

Safety Considerations​

Before Activation:

  • Test in staging environment
  • Review patches for conflicts
  • Backup site before deployment
  • Document active patches

Compatibility:

  • May conflict with other customization plugins
  • Test after WordPress/WooCommerce updates
  • Monitor site after activation