PHPackages offsite-solutions/tholos - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. offsite-solutions/tholos ActiveLibrary[Framework](/categories/framework) offsite-solutions/tholos ======================== Tholos Framework 1.0.18(1mo ago)0183JavaScriptPHP >=8.4 Since Oct 6Pushed 1mo ago3 watchersCompare [ Source](https://github.com/offsite-solutions/Tholos)[ Packagist](https://packagist.org/packages/offsite-solutions/tholos)[ RSS](/packages/offsite-solutions-tholos/feed)WikiDiscussions main Synced 3w ago READMEChangelog (10)Dependencies (8)Versions (21)Used By (0) Tholos Framework ================ [](#tholos-framework) Tholos is a PHP component-based GUI framework built on top of the [Eisodos](https://github.com/offsite-solutions/eisodos) framework. It provides a server-rendered, database-driven component architecture for building HTML applications with AJAX capabilities, PDF generation, role-based access control, and data caching. Applications are designed visually using **TholosBuilder** (a companion web app) and compiled into `.tcd` (Tholos Component Definition) cache files that the Tholos runtime loads and renders. Requirements ------------ [](#requirements) - PHP >= 8.4 - Eisodos framework (`offsite-solutions/eisodos`) - Database: Oracle or PostgreSQL (via Eisodos connectors) - Redis (optional, for caching) - Extensions: json, mbstring, bcmath, pcntl, simplexml, zip, openssl, curl, redis Installation ------------ [](#installation) ``` # Production composer install --no-interaction --prefer-dist --no-dev --no-ansi --optimize-autoloader # Development (symlinks Eisodos from ../../_eisodos/Base) COMPOSER=composer.dev.json composer update --no-interaction --prefer-dist --no-dev --no-ansi --optimize-autoloader ``` --- Architecture Overview --------------------- [](#architecture-overview) ### Bootstrap Chain [](#bootstrap-chain) ``` Tholos::init() +-- TholosLogger::init() +-- TholosApplication::init() +-- Load _tholos.init (component types, type index, component index) +-- Load .tcd files (component definitions for current route) +-- Instantiate TApplication (mandatory root) +-- Instantiate TRoleManager (optional) +-- Resolve TRoute from tholos_route parameter +-- Resolve TAction from tholos_action parameter (default: 'index') +-- Instantiate all components in creation order +-- initComponents() -- calls init() on every component +-- autoOpen() -- runs TDataProviders with AutoOpenAllowed=true +-- render() -- walks the component tree, returns HTML +-- Finalize response (HTML, JSON, PDF, XML, etc.) ``` Access singletons via `Tholos::$app` (TholosApplication) and `Tholos::$logger` (TholosLogger). ### Application Structure [](#application-structure) Every Tholos application follows this component hierarchy: ``` TApplication +-- TRoleManager (optional, access control) +-- TPage / TPDFPage (layout templates) +-- TDataProxy (optional, remote server calls) +-- TPAdES (optional, digital signatures) +-- TRoute (one per logical route) +-- TAction (one or more per route) | +-- TTemplate / TContainer / TForm / TModal / ... | +-- TConfirmDialog | +-- TFileProcessor +-- TStoredProcedure / TQuery / TQueryGroup +-- TExternalDataProvider / TAPIPost ``` ### Request Flow [](#request-flow) 1. **Route Resolution** -- `tholos_route` parameter selects the `TRoute` component 2. **Action Resolution** -- `tholos_action` parameter selects the `TAction` (default: `index`) 3. **Initialization** -- all components' `init()` is called; TRoute optionally runs `InitSessionProvider` 4. **Auto-Open** -- TDataProviders with `AutoOpenAllowed=true` execute their queries/procedures 5. **Rendering** -- recursive tree walk: each component's `render()` returns HTML; children are rendered first, their output passed as `$content` to the parent 6. **Response** -- output finalized based on TAction's `ResponseType` property --- Component System ---------------- [](#component-system) All components extend `TComponent`. Components are defined in TholosBuilder and compiled into `.tcd` files. At runtime, TholosApplication loads these definitions, instantiates the PHP classes, and calls their lifecycle methods. ### Component Lifecycle [](#component-lifecycle) ``` Constructor (properties and events loaded from .tcd) | v init() +-- Set runtime properties +-- Fire onAfterInit event | v render(sender, content) +-- checkRole() -- verify FunctionCode access +-- Fire onBeforeRender event +-- generateProps() -- populate prop_* template parameters +-- generateEvents() -- populate event_* parameters, fire PHP events +-- Eisodos template engine renders the component template +-- Fire onAfterRender event +-- Return HTML string ``` ### Properties [](#properties) Each component has typed properties defined in TholosBuilder: TypeDescription`STRING`Plain string value`NUMBER`Numeric value`BOOLEAN`true/false (configurable via `Tholos.BoolTrue` / `Tholos.BoolFalse`)`TEXT`Multi-line text`JSON`JSON structure`ARRAY`Array value`TEMPLATE`Eisodos template name`PARAMETER`Reference to an Eisodos parameter (resolved via `$parameterHandler->getParam()`)`COMPONENT`Reference to another component by IDProperties are accessed via `$component->getProperty('Name', $default)` which automatically parses dynamic expressions. ### Property Expression Language [](#property-expression-language) Property values support a dynamic expression syntax that is resolved at runtime: **Reference expressions (`@`)** SyntaxResolves to`@this.PropertyName`This component's own property`@parent.PropertyName`Parent component's property`@route.PropertyName`Current route's property`@ComponentName.PropertyName`Named sibling component's property`@(ComponentType).PropertyName`First parent of the given type`@(>ComponentType).PropertyName`First child of the given type`@(parameter).ParamName`Eisodos parameter value**Defaults (`|`)** -- cascading fallback chain: ``` @(parameter).Tholos.TGrid.Scrollable|false ``` If the parameter doesn't exist, the value `false` is used. Multiple defaults can be chained: `@comp.prop|@other.prop|literal`. **Concatenation (`++`)** -- joins multiple expressions: ``` @this.Name++_++@(parameter).Suffix ``` **Chained property access (`.`)** -- navigate through COMPONENT-type properties: ``` @MyDataProvider.DBField.Value ``` If `DBField` is a COMPONENT property, it resolves to that component, then reads `Value` from it. **Callback (`%`)** -- calls a template callback function: ``` %callback_function_name ``` ### Events [](#events) Components define two types of events: **PHP Events** (`type=PHP`) -- server-side, called during rendering: - Referenced as `Application\EventClass::methodName` - Called via `Tholos::$app->eventHandler($component, 'eventName')` - The handler receives the sender component and can modify properties/response - Common: `onBeforeRender`, `onAfterRender`, `onAfterInit`, `onBeforeCreate` **GUI Events** (`type=GUI`) -- client-side JavaScript: - Value is a JavaScript function call or component method reference - Rendered into the HTML template as `event_eventname` parameters - Client-side dispatch: `Tholos.eventHandler(senderID, targetID, componentType, methodName, routePath, eventData, userParameters)` ### Role-Based Access Control [](#role-based-access-control) `TRoleManager` (optional child of TApplication) controls access: - Each component can set a `FunctionCode` property - At render time, `checkRole()` verifies the current user has that function code - Use `#` as FunctionCode to require login without a specific role - CSRF protection: enabled via `CSRFEnabled`, token in `csrf_token_value` parameter, header name in `csrf_header_name` --- Component Reference ------------------- [](#component-reference) For the full, detailed component type reference (all properties, events, methods, inheritance, and parent constraints), see: **[docs/Tholos\_Component\_Types.md](docs/Tholos_Component_Types.md)** Below is a functional overview of each component category. ### Layout & Structure [](#layout--structure) ComponentDescription`TAction`Defines an action within a route. `ResponseType` controls output format: `HTML`, `JSON`, `JSONDATA`, `PLAINTEXT`, `XML`, `PDF`, `NONE`. References a `TPage` for layout.`TPage`HTML page layout wrapper. Renders its `Template` property via Eisodos template engine.`TTemplate`Renders an Eisodos template by name (from `Template` property).`TContainer`Generic HTML container. `ContainerType` property sets the tag (`div`, `span`, `section`, etc.).`TCell`Table cell container.`TColumn`Column-based layout container.`TFormContainer`Groups form controls visually.`TWidget`Panel/card container with optional header.`TModal`Bootstrap modal dialog.`TPartial`Renders content and stores it in a named parameter (`ParameterName`) instead of outputting HTML. Supports `Cacheable` mode.`TDocumentTitle`Sets the HTML ``.`TJSLib`Includes JavaScript/CSS files via head or foot items.### Navigation & Routing [](#navigation--routing) ComponentDescription`TRoute`Represents a route. Matched by `tholos_route` parameter. Can run `InitSessionProvider` on init. `PersistentSession` controls session persistence.`TAction`Action within a route. Matched by `tholos_action` parameter (default: `index`). `HTTPMethod` constrains allowed methods (GET, POST, etc.).`TConfirmDialog`Confirmation dialog with configurable buttons (OK, Cancel, Yes, No, Custom).`TConfirmButton`Button within a TConfirmDialog.### Form Controls [](#form-controls) All form controls extend `TFormControl` which extends `TControl`. Common properties: `DBField` (data binding), `Value`, `Label`, `LabelSize`, `ControlSize`, `Placeholder`, `Readonly`, `Required`, `Visible`, `Enabled`. ComponentDescription`TForm`HTML `` wrapper. Properties: `URL`, `Method`, `Target`, `Validator`, `ValidateOnInit`. Events: `onBeforeSubmit`, `onSubmitSuccess`, `onSubmitError`, `onValidateSuccess`, `onValidateError`, `onSuccessAlert`, `onErrorAlert`, `onCancel`.`TEdit`Text input (``). Properties: `HTMLInputType` (text, password, email, etc.), `MaxLength`, `Autocomplete`. Event: `onEnterKeyPressed`.`TCheckbox`Checkbox control. Properties: `CheckedValue`, `UncheckedValue`.`TRadio`Radio button group. Child `TRadio.item` entries define options.`TDateTimePicker`Date/time picker (Tempus Dominus). Properties: `DateFormat`, `DateFormatParameter`.`TLOV`List of Values -- dropdown/autocomplete. Properties: `LOVSource` (data provider), `AjaxURL` for remote search, `Multiple`. Child `TLOVParameter` for parameters.`TFileUpload`File upload control.`TText`Multi-line textarea.`THTMLEdit`Rich text editor (RichTextEditor).`TStatic`Read-only display value.`TLabel`Label element.`THidden`Hidden input field.`TImage`Image display.`TLink`Hyperlink.`TButton`Button with click event.`TButtonDropdown`Dropdown button with menu items.### Data Layer [](#data-layer) ComponentDescription`TDataProvider`Abstract base for all data sources. Properties: `AutoOpenAllowed`, `Result`, `RowCount`, `TotalRowCount`, `Success`, `DatabaseIndex`, `DataProxy`, `Caching`.`TQuery`SQL SELECT query. Properties: `sql` (with `:columns`, `:orderby`, `:filter` placeholders), `Filter`, `orderby`, `Offset`, `RowsPerPage`, `CountTotalRows`, `CacheValidity`, `PartitionedBy`.`TStoredProcedure`Database stored procedure call. Properties: `Procedure`, `TransactionMode`, `GenerateDataResult`, `ErrorCodeParameter`, `ErrorMessageParameter`, `CallbackParameter`.`TQueryGroup`Groups multiple queries to execute together.`TExternalDataProvider`Fetches data from an external HTTP endpoint.`TJSONDataProvider`Parses JSON data sources.`TAPIPost`Extends TStoredProcedure for HTTP API calls. Properties: `URL`, `URLPath`, `HTTPRequestMethod`. TDBParam children serialized to JSON body.`TDBField`Maps a database field to a component value. Properties: `FieldName`, `Value`, `DBValue`, `DataType` (string, integer, float, date, datetime, time, bool, JSON), `NullResultParameter`, `ParseValue`. Event: `onSetValue` (can modify value).`TDBParam`Stored procedure parameter binding. Properties: `ParameterName`, `ParameterMode` (IN/OUT/INOUT), `MDB2DataType`, `Value`, `DefaultValue`, `ParameterNameTransformation`.`TDataProxy`Proxies data calls to a remote server via HTTP. Properties: `URL`, `HTTPRequestMethod`, `AJAXMode`, `TimeOut`. Child `TDataProxyParameter` components define request parameters.`TQueryFilter`Adds WHERE conditions to a TQuery. Properties: `FieldName`, `Relation` (=, <>, <, >, LIKE, IN, BETWEEN), `Value`, `FilterGroupParameter`.`TQueryFilterGroup`Groups TQueryFilters with AND/OR logic.`TDPOpen`Triggers opening of a referenced data provider.### Grid System [](#grid-system) `TGrid` renders tabular data with filtering, sorting, pagination, transposing, and Excel/chart export. **Key TGrid Properties:** PropertyDescription`ListSource`Component reference to TDataProvider`RowsPerPage`Rows per page (0 = no pagination)`ActivePage`Current page (1-based)`SortedBy`Component reference to the currently sorted TGridColumn`SortingDirection``ASC` or `DESC``Scrollable`Horizontal scrolling (boolean)`ScrollableY`Vertical scrolling (boolean)`Selectable`Row selection enabled (boolean)`Transposed`Transpose rows/columns (boolean)`GridHTMLType``table` or `div` rendering mode`UUID`Unique ID for persistent state`Persistent`Session key for saving grid state`MasterValue`Filter value for master-detail relationships`ViewMode``GRID` or `CHART``ShowRefreshButton`Show refresh button (boolean)`ShowScrollCheckbox`Show scroll toggle (boolean)`ShowTransposeCheckbox`Show transpose toggle (boolean)**Grid Child Components:** ComponentDescription`TGridColumn`Column definition. Properties: `DBField`, `Header`, `Sortable`, `SortingDirection`, `GridFilter`, `MarkChanges`.`TGridFilter`Column filter definition. Properties: `DefaultRelation`, `Value`, `Name`.`TGridRow`Row template definition.`TGridRowActions`Row-level action buttons container.`TGridParameter`Additional grid parameters.**Grid Filtering (client-side):** Filters are submitted as parameters in the format `gridname_f_N=columnname:relation:value` (slots 1-99). Relations: `=`, ``, ``, `=`, `LIKE`, `IN`, `BETWEEN`. **Grid AJAX Refresh:** `TGrid_submit(sender, target, urldata)` posts form data to the action URL, receives `{html: "..."}` JSON, and replaces the grid DOM. Emits `masterDataChange` for detail grids. ### Composite Components [](#composite-components) ComponentDescription`TWizard`Multi-step wizard. Property: `ActiveStep`. Child `TWizardStep` components define steps with `StepNumber`, `Title`. Events: `onBeforeStep`, `onAfterStep`.`TTabs`Tabbed interface. Property: `DefaultTabPane`. Child `TTabPane` components with `Name` and `Title`. Event: `onTabChange`.`TIterator`Loop component. Properties: `ListSource`, `JSONSource`. For each row in the data source, renders all children with propagated field values. Event: `onZeroResult`. `selfRenderer=true`.`TLinkedComponent`Delegates rendering to a referenced `Component`.`TTimer`Client-side timer.`TWorkflow` / `TWorkflowStep`Workflow state machine.### Map Components [](#map-components) ComponentDescription`TMap`Google Maps integration. Properties: `APIKey`, `Latitude`, `Longitude`, `Zoom`, `Width`, `Height`.`TMapSource`Map data marker. Properties: `Latitude`, `Longitude`, `Title`, `InfoWindow`.### PDF & Signatures [](#pdf--signatures) ComponentDescription`TPDFPage`PDF rendering via mPDF. Properties: `Template`, `HeaderContainerName`, `FooterContainerName`, `BodyContainerName`, `CSSFile`, `Watermark`, `PDFConfig` (JSON mPDF config). Uses `%%PARAMETER` token syntax for substitution.`TPAdES`PAdES digital signatures. Properties: `CertificatePath`, `CertificatePassword`, `Reason`, `Location`, `ContactInfo`. Method: `signPDF()`.### Parameters [](#parameters) ComponentDescription`TParameter`Base parameter component.`TGlobalParameter`Sets a global Eisodos parameter.`TDataParameter`Data-bound parameter.`TDataProxyParameter`Parameter for TDataProxy requests.`TAPIParameter`Parameter for TExternalDataProvider.`TLOVParameter`Parameter for TLOV data source.--- Template System --------------- [](#template-system) Templates are located in `assets/templates/tholos/` and processed by the Eisodos template engine. ### Naming Convention [](#naming-convention) PatternPurpose`ComponentType.main.template`Default render template`ComponentType.partial.ID.template`Partial render (head, foot, row, etc.)`ComponentType.init.head.template`HTML head items (CSS, JS includes)`ComponentType.init.foot.template`HTML foot items (scripts)### Template Variables [](#template-variables) Every component's `generateProps()` makes these available to templates: - `$prop_*` -- all component properties (lowercased name) - `$prop_ID` -- full element ID: `{renderID}_{Name}` (e.g., `TRI8a3f_btnSave`) - `$prop_name` -- component name - `$prop_componenttype` -- component type name - `$prop_datavalues` -- generated `data-*` HTML attributes - `$prop_route` -- route/action path - `$prop_parent_name` / `$prop_parent_id` -- parent info - `$content` -- rendered child content - `$sender` -- sender component name - `$Tholos_renderID` -- current render ID - `$Tholos_nonce` -- CSP nonce for inline scripts ### Template Syntax [](#template-syntax) ``` ## Comment line (stripped from output) $variable_name $variable~='default'; $templateabs_path__name [%_function_name=Tholos\TholosCallback::_eqs;param=prop_visible;value=true;false=hidden;true=%] ``` ### Built-in Callback Functions (TholosCallback) [](#built-in-callback-functions-tholoscallback) FunctionParametersDescription`_eq`param, value, true, falseIf parameter equals value, render `true` template; else `false` template`_eqs`param, value, true, falseSame as `_eq` but returns strings instead of rendering templates`_neq`param, value, true, falseNot-equals version of `_eq``_neqs`param, value, true, falseNot-equals version of `_eqs``_case`param, case1..N, elseSwitch/case rendering templates`_cases`param, case1..N, elseSwitch/case returning strings`_safehtml`paramHTML-safe output with `` wrapping for newlines`_trim`valueTrim whitespace`_param2`paramDouble parameter resolution`_listToOptions`separator, options, selectedGenerates `` tags from delimited list`_generateListValues`component\_idGenerates TLOV/TRadio option markup### Base Template Fragments [](#base-template-fragments) These fragments are included by most component templates: - `TComponent.properties` -- renders `` for component data - `TComponent.basedata` -- generates `style` and `data-*` attributes (handles visibility) - `TComponent.labelicon` -- renders label with optional icon - `TFormControl.labelsize` / `TFormControl.controlsize` -- Bootstrap column classes - `TControl.baseevents` -- standard control event scripts - `TControl.customevents` -- custom event binding scripts - `TControl.helpblock` -- validation/help text block - `TContainer.baseevents` -- container event scripts --- Client-Side JavaScript API -------------------------- [](#client-side-javascript-api) ### TholosApplication.js [](#tholosapplicationjs) The global `Tholos` object provides the client-side framework: **Core Methods:** ``` // Event dispatch -- the central client-side mechanism Tholos.eventHandler(senderID, targetID, componentType, methodName, routePath, eventData, userParameters) // Post-submission handler (called after AJAX form submit) Tholos.action(success, sender, target) // Data access Tholos.getData(target) // Get jQuery data object Tholos.setData(target, key, value) Tholos.getObject(target) // Get jQuery element Tholos.getComponentType(target) // UI Tholos.pageLoader(show, animate) // Loading indicator Tholos.showHelp(helpIndex) // Context help popup // Utilities Tholos.EncodeQueryData(data) // URL-encode object Tholos.trace(msg, sender, target, eventData) Tholos.debug(msg, sender, target, eventData) ``` **Component Methods (called via eventHandler):** MethodDescription`TAction_navigate(sender, target, route, eventData)`Navigate to a route. Middle-click opens new window.`TControl_getValue(sender, target)`Get control's current value`TControl_setLabel(sender, target, eventData)`Update label text`TControl_setRequired(sender, target, eventData)`Set required attribute`TControl_setVisible(sender, target, eventData)`Show/hide control`TControl_getVisible(sender, target)`Get visibility state`TFormControl_setVisible(sender, target, eventData)`Show/hide form row`TForm_setEnabled(sender, target, eventData)`Enable/disable entire form`TComponent_setEnabled(sender, target, eventData)`Enable/disable component`TComponent_setDataParameters(sender, target, route, eventData)`Update data-\* attributes`TLOV_getValue(sender, target)`Get LOV selected value(s)`TCheckbox_getValue(sender, target)`Get checkbox state`TRadio_getValue(sender, target)`Get selected radio value`TRadio_setEnabled(sender, target, eventData)`Enable/disable radio group`TGrid_submit(sender, target, urldata)`AJAX grid refresh`TGrid_getValue(sender, target)`Get selected row value`TGrid_getFilterSQL(sender, target)`Get current filter SQL`TGrid_setVisible(sender, target, eventData)`Show/hide grid`TGrid_changeViewMode(formId, viewMode)`Switch GRID/CHART### TGrid.js [](#tgridjs) Grid-specific functions: ``` TGrid_submit(sender, target, urldata) // AJAX refresh, updates DOM, emits masterDataChange TGrid_parseChartData(formId, data) // Convert grid data to Chart.js format TGrid_reloadPreviousState(formId) // Restore saved grid state ``` **Grid Events (jQuery custom events):** - `masterDataChange` -- emitted when master grid selection changes (for detail grids) - `masterRefresh` -- emitted when master grid refreshes - `onAfterRefresh` -- triggered after grid AJAX refresh completes - `leavingChartTab` -- triggered when switching from chart to grid view ### Client-Side Libraries [](#client-side-libraries) - jQuery + jQuery UI - Bootstrap 5 - Select2 (dropdown/autocomplete) - Tempus Dominus (date/time picker) - Chart.js (grid chart view) - jQuery Resizable Columns (grid column resize) - jQuery AJAXQ (request queuing) - RichTextEditor (THTMLEdit) --- Response Types -------------- [](#response-types) TAction's `ResponseType` property determines how the rendered output is delivered: TypeContent-TypeDescription`HTML`text/htmlFull HTML5 page`HTMLSnippet`text/htmlPartial HTML (for AJAX loaders)`JSON`application/json`{success, errormsg, errorcode, html, callback, data}``JSONDATA`application/jsonRaw JSON data`XML`application/xmlXML output`PLAINTEXT`text/plainPlain text`PDF`application/pdfPDF via mPDF (requires TPDFPage)`BINARY`variesFile download`PROXY`variesProxied response from TDataProxy`CUSTOM`variesCustom response handling`NONE`--No output (side-effects only)--- Caching System -------------- [](#caching-system) Tholos supports three caching backends configured via `Tholos.CacheMethod`: BackendSettingDescriptionFile`file`JSON cache files in `Tholos.CacheDir`Redis`redis`Redis server at `Tholos.CacheServer`:`Tholos.CachePort`Memory`memory`PHP session-scoped parameters### Cache Scope [](#cache-scope) - **Private** -- scoped to the current session (file prefix: `{sessionID}_{cacheID}`) - **Global** -- shared across sessions ### TQuery Caching [](#tquery-caching) Set on TQuery via `Caching` property: ModeDescription`Disabled`No caching`Enabled`Cache entire result set`Partitioned`Cache by `PartitionedBy` field value`CacheValidity` sets lifetime in minutes. `CacheSQLConflict` controls behavior when cached SQL doesn't match current query: `ReadCache`, `RewriteCache`, or `DisableCaching`. ### Cache File Structure [](#cache-file-structure) - `{prefix}_{cacheID}.cache` -- cached data (JSON) - `{prefix}_{cacheID}.index` -- metadata (partition, validity, SQL hash, item count) - `{prefix}_{cacheID}@{partition}.cache` -- partitioned cache segment --- Configuration Parameters ------------------------ [](#configuration-parameters) Key Eisodos parameters used by Tholos (typically set in application config): ### Application [](#application) ParameterDescription`Tholos.ApplicationCacheDir`Directory for compiled .tcd files`Tholos.AccessLog`Access log file path`Tholos.AccessLog.Format`Log format (use `%` as variable prefix)### Caching [](#caching) ParameterDefaultDescription`Tholos.CacheDir`Cache files directory`Tholos.CacheMethod``file``file`, `redis`, or `memory``Tholos.CacheServer``localhost`Redis host`Tholos.CachePort``6379`Redis port`Tholos.CacheTimeout``0.0`Redis connection timeout`Tholos.CacheLockWait``100`File lock wait (microseconds)`Tholos.CacheLockLoop``20`Max lock retry attempts### Boolean Handling [](#boolean-handling) ParameterDefaultDescription`Tholos.BoolFalse``false,f,n,0`Comma-separated values treated as false`Tholos.BoolTrue``true,t,y,1,*`Comma-separated values treated as true### PDF [](#pdf) ParameterDescription`Tholos.mPDF`JSON mPDF configuration### Security [](#security) ParameterDescription`Tholos.CSPEnabled`Enable Content Security Policy headers`Tholos.CSPJavascriptHosts`CSP script-src allowed hosts`Tholos.CSPFontHosts`CSP font-src allowed hosts`Tholos.nonce`CSP nonce (auto-generated if empty)### Debugging [](#debugging) ParameterDescription`Tholos.debugLevel`Server-side debug verbosity`Tholos.debugToFile`Debug log path (tokens: `SESSIONID`, `TIME`)`Tholos.debugToUrl`Remote debug endpoint`Tholos.JSDebugLevel`Client-side JavaScript debug level### Grid Defaults [](#grid-defaults) ParameterDescription`Tholos.TGrid.Scrollable`Default horizontal scroll for all grids`Tholos.TGrid.RowsPerPage`Default rows per page--- TholosBuilder ------------- [](#tholosbuilder) TholosBuilder is a companion web application used to visually design Tholos applications. It provides: - **Visual Component Tree** -- JSTree-based hierarchy editor for building component structures - **Property Editor** -- type-aware property editing with validation - **Event Editor** -- configure PHP and GUI event handlers with method references - **Wizards** -- auto-generate common patterns: - **Query Wizard** -- creates TQuery + TDBFields from a SELECT statement - **Stored Procedure Wizard** -- creates TStoredProcedure + TDBParams from procedure signature - **Grid Wizard** -- creates TGrid + TGridColumns from a data source - **Edit Form Wizard** -- creates TForm + form controls from field definitions - **Compilation** -- compiles the component tree into `.tcd` cache files and `_tholos.init` - **Version Control** -- task-based change tracking with user assignment ### Compilation Output [](#compilation-output) The compiler (`compile2()`) generates: 1. **`_tholos.init`** -- PHP file containing: - `$this->componentTypes[]` -- type definitions with inheritance - `$this->componentTypeIndex[]` -- type ID to class path mapping - `$this->componentIndex[]` -- component ID to metadata mapping 2. **`{RouteName}.tcd`** -- PHP file per route containing: - `$this->componentDefinitions[]` -- array keyed by component ID with: - `pid` -- parent ID - `h` -- type hierarchy path (e.g., `TStoredProcedure.TDataProvider.TComponent`) - `o` -- component name - `p` -- JSON-encoded properties (`{n, t, v, c, d}`) - `e` -- JSON-encoded events (`{n, t, v, m, p, c, i, a}`) 3. **`{RouteName}.tcs`** -- human-readable source representation (for version control) --- Naming Conventions ------------------ [](#naming-conventions) - All PHP component classes are prefixed with `T` (e.g., `TComponent`, `TGrid`, `TAction`) - Constructor parameters use trailing underscore: `$componentType_`, `$id_`, `$parent_id_` - Component property and event keys are **lowercased** internally - Element IDs in rendered HTML: `{renderID}_{ComponentName}` (e.g., `TRI8a3f_btnSave`) - Component definitions use compact JSON keys: `n` (name), `t` (type), `v` (value), `c` (component\_id), `d` (nodata) - Template files follow: `ComponentType.purpose.template` pattern - Grid filter parameters: `gridname_f_N` (N = 1-99) - Grid state parameters: `TGrid_PropertyName_` prefix ### Health Score 47 — FairBetter than 93% of packages Maintenance92 Actively maintained with recent releases Popularity13 Limited adoption so far Community8 Small or concentrated contributor base Maturity62 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~12 days Recently: every ~41 days Total 19 Last Release 43d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/8bc6a2c7c4c548677094667632562471dc59dcb319bdda8a05369d2561b16106?d=identicon)[LaszloB](/maintainers/LaszloB) --- Top Contributors [![LBanfalvi](https://avatars.githubusercontent.com/u/12492420?v=4)](https://github.com/LBanfalvi "LBanfalvi (25 commits)") ### Embed Badge ![Health badge](/badges/offsite-solutions-tholos/health.svg) ``` [![Health](https://phpackages.com/badges/offsite-solutions-tholos/health.svg)](https://phpackages.com/packages/offsite-solutions-tholos) ``` ### Alternatives [bagisto/bagisto Bagisto Laravel E-Commerce 27.4k169.0k9](/packages/bagisto-bagisto)[krayin/laravel-crm Krayin CRM 22.6k33.4k1](/packages/krayin-laravel-crm)[kimai/kimai Kimai - Time Tracking 4.7k8.7k1](/packages/kimai-kimai)[craftcms/cms Craft CMS 3.6k3.6M2.9k](/packages/craftcms-cms)[prestashop/prestashop PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers. 9.1k16.8k](/packages/prestashop-prestashop)[2lenet/crudit-bundle The easy like Crud'it Bundle. 1615.6k12](/packages/2lenet-crudit-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)