How navidnasro/upon-word works
UponWord is a WordPress theme-development framework, with a bundled theme engine providing storefront and admin features. The principal workflow is theme startup, request-aware service injection, then WordPress-facing services and theme output; separate branches cover settings, database access, security, and WooCommerce. The README documents theme setup, reusable helpers, and demo templates. The graph uses the supplied excerpts and source index; unsampled subsystems are represented conservatively, without assuming undocumented wiring.
Main entry points: ServiceInjector.php Service Injector · WpWidgetServiceInjector.php Widget Injector · Request.php Request Utilities · services.php Theme Services
Components 24
Theme Runtime
- Framework Bootstrap
UponWord/Bootstrap.php - Theme Initializer
engine/ThemeInitializer.php
Framework Services
- Request Scope
UponWord/Scope.php - Service Injector
UponWord/services/runners/ServiceInjector.php - Widget Injector
UponWord/services/injectors/WpWidgetServiceInjector.php - Theme Helpers
UponWord/utils/Theme.php - Request Utilities
UponWord/utils/Request.php - User Utilities
UponWord/utils/User.php - Commerce Utilities
UponWord/utils/Woocommerce.php
Theme Features
- Service Registry
engine/services/services.php - Theme Services
engine/services/services.php - Live Search
engine/services/ajax/LiveSearch.php - WooCommerce Features
engine/woocommerce/Hooks.php - Admin AJAX
engine/admin/AjaxHandler.php - Demo Templates
UponWord/template/DemoFactory.php
Data and Security
- Input Sanitization
UponWord/security/Sanitize.php - Output Escaping
UponWord/security/Escape.php - JSON Storage
UponWord/storage/Json.php - Query Builder
UponWord/database/QueryBuilder.php - Table Manager
UponWord/database/TableManager.php - WordPress Database
Configuration
- Theme Settings
engine/settings/Loader.php - Codestar Options
codestar/classes/setup.class.php
Other components
- WordPress
Connections 21
- WordPress → Theme Initializer: initializes theme
- Framework Bootstrap → Service Injector: starts services
- Theme Initializer → Service Injector: configures runtime
- Service Injector → Request Utilities: reads request
UponWord/services/runners/ServiceInjector.php - Service Injector → Request Scope: checks scope
UponWord/services/runners/ServiceInjector.php - Service Injector → Widget Injector: dispatches widgets
UponWord/services/runners/ServiceInjector.php - Widget Injector → Theme Helpers: checks widgets
UponWord/services/injectors/WpWidgetServiceInjector.php - Widget Injector → Theme Services: injects handlers
- Service Registry → Live Search: registers service
engine/services/services.php - Service Registry → Theme Services: declares handlers
engine/services/services.php - Request Utilities → Input Sanitization: sanitizes input
UponWord/utils/Request.php - Admin AJAX → Request Utilities: reads request
engine/admin/AjaxHandler.php - Admin AJAX → JSON Storage: reads location data
engine/admin/AjaxHandler.php - WooCommerce Features → User Utilities: loads favorites
engine/woocommerce/Hooks.php - WooCommerce Features → Commerce Utilities: uses commerce helpers
engine/woocommerce/Hooks.php - Theme Services → Output Escaping: escapes labels
engine/services/services.php - Table Manager → Query Builder: queries tables
UponWord/database/TableManager.php - Query Builder → WordPress Database: executes queries
UponWord/database/QueryBuilder.php - Theme Settings → Codestar Options: uses options framework
- WordPress → Demo Templates: renders theme parts
- WordPress → Theme Settings: configures theme