Preparing Pets - Core
Core WordPress plugin providing unified anonymous identity tracking, robust manual migration SDK, structured logging, and customizable theme/CSS utilities for all Preparing Pets plugins.
by Preparing Pets · github.com/delphian/preparing-pets-core · website
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/delphian/preparing-pets-core/archive/refs/heads/main.zipPreparing Pets Core Plugin
Overview
Core plugin required by all other Preparing Pets plugins. Features integrated identity management for unified user tracking, comprehensive database migration SDK, and advanced logging SDK for WordPress development.
Features
Core Features
- Master enable/disable switch for all plugin functionality
- Standardized admin interface with tab navigation
CSS Injection
- Provides two editable CSS sections: one for the live site and one for the WordPress admin interface
- Optional CSS minification for performance optimization
Theme Color Management
- 14 predefined CSS variables for comprehensive theme customization
- Real-time color picker interface with live preview
- Dynamic CSS variable injection into frontend
- Variables include: backgrounds, text colors, borders, accents, and status colors
Identity Management
- Anonymous visitor tracking with centralized site wide UUID generation
- Automatic user linking when anonymous visitors register or login
- Event tracking and trait recording for behavioral analytics
- REST API endpoints for frontend JavaScript integration
- Comprehensive admin interface for identity search and management
- Technical capabilities detection (device, browser, connection data)
Documentation
SDK Components
Database Migration SDK: See SDK_DATABASE.md - Comprehensive database migration system with version tracking, multisite support, and manual-only execution control for safe schema upgrades.
Identity Management SDK: See SDK_IDENTITY.md - Privacy-first anonymous visitor tracking with automatic user linking, event tracking, trait recording, and GDPR compliance.
Logger SDK: See SDK_LOGGER.md - Advanced logging system with PSR-3 compliance, configurable severity levels, and automatic log rotation for debugging and monitoring.
Change Log
Version History: See CHANGELOG.md - Complete version history with detailed changes, bug fixes, and feature additions for each release.
Contact
- Developer: Preparing Pets
- Project Manager: Bryan Hazelbaker
- Last Updated: 2025-07-21
Project Structure
├── preparing-pets-core.php # Main plugin file
├── build.sh # Build script for packaging the plugin
├── deploy.sh # Deployment script
├── composer.json # PSR-4 autoloader configuration
├── uninstall.php # Plugin uninstall cleanup
├── CHANGELOG.md # Version history and changes
├── SDK_DATABASE.md # Database Migration SDK documentation
├── SDK_IDENTITY.md # Identity Management SDK documentation
├── SDK_LOGGER.md # Logger SDK documentation
├── vendor/ # Composer dependencies
├── src/ # PSR-4 source directory
│ └── Core/ # Core functionality namespace
│ ├── Core.php # Core feature implementation
│ ├── CssInjection/
│ │ └── CssInjection.php # CSS injection feature
│ ├── Colors/
│ │ ├── Colors.php # Theme color management
│ │ └── assets/
│ │ ├── css/ # Color admin & frontend CSS
│ │ └── js/ # Color picker JavaScript
│ ├── Identity/ # Identity Management SDK
│ │ ├── Identity.php # Main identity class
│ │ ├── AnonIdentity.php # Anonymous visitor tracking
│ │ ├── Admin/ # Admin interface components
│ │ ├── Rest/ # REST API endpoints
│ │ ├── Services/ # Core services & repositories
│ │ └── assets/ # Identity admin & frontend assets
│ ├── DB/ # Database Migration SDK
│ │ ├── BaseMigration.php # Base migration class
│ │ ├── Bootstrap.php # SDK bootstrap
│ │ ├── CoreDBManager.php # Core database management
│ │ ├── Logger.php # Migration logging
│ │ ├── Migration.php # Migration interface
│ │ ├── PluginMigrationManager.php # Plugin registration
│ │ ├── SchemaInspector.php # Database inspection utilities
│ │ ├── SchemaManager.php # Schema management
│ │ ├── Migrations/ # Core plugin migrations
│ │ └── assets/css/ # Database admin styling
│ └── SDK/ # Additional SDK components
│ ├── SDK.php # Main SDK class
│ ├── Shortcodes.php # SDK shortcode system
│ └── UserContext.php # User context utilities
// ...existing code...