WP Manifestindependent plugin directory
manifest / developer / preparing-pets-core

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

0stars
0forks

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.zip

Preparing 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...