README

Common utilities and building blocks for LindemannRock Craft CMS plugins.

Features

• Edition Support — standardized Lite/Standard/Pro edition tiers for the Plugin Store
• Settings Traits — database persistence, config file overrides, custom display names
• DateFormatHelper — centralized date/time formatting with timezone-aware SQL expressions
• DateRangeHelper — standardized date range selection, bounds, and query filtering
• ColorHelper — 18-color palette and 16 built-in color sets for consistent styling
• ExportHelper — CSV, JSON, and Excel export with configurable format availability
• GeoHelper — ISO 3166-1 country lookups, dial codes, and phone validation
• DbHelper — DB-agnostic JSON extraction and GROUP_CONCAT
• GqlHelper — schema permission checks and site argument resolution for plugin-owned GraphQL queries
• BooleanHelper — normalize boolean-like config, env, POST, and HTML attribute values
• ExperimentalFeatureHelper — env-flag gating for internal or launch-deferred features
• CsvImportHelper — CSV upload parsing with configurable options
• CpNavHelper — CP subnav building with permission checks
• LabelHelper — strip numbering and truncate long field labels for compact UI contexts (|lrShortLabel Twig filter)
• Device Detection — standardized UA parsing via Matomo DeviceDetector
• GeoLookup — IP geolocation via configurable providers (ip-api.com, ipapi.co, ipinfo.io)
• CP Table Layout — reusable table pages with filters, search, pagination, and AJAX refresh
• CP Analytics Layout — analytics dashboards with tabs, charts, stat boxes, and date filters
• Twig Extensions — 30+ filters and functions for dates, colors, exports, geo, and plugin detection
• 19 Twig Components — badge, stat-box, dashboard-widget helpers, info-box, export-menu, row-actions, filters, and more
• Testing Utilities — IntegrationTestCase abstract base with component swap/restore, generic DB helpers, marker cleanup, fixture lifecycle helpers for elements/temp paths, queue drain, and an external-state cleanup hook; plus a bootstrap() function and phpunit.xml.dist template for quick test-suite setup in consumer plugins

Requirements

• PHP 8.2+
• Craft CMS 5.10+

Installation

composer require lindemannrock/craft-plugin-base

Documentation

Full documentation is available in the docs folder.

Support

• Issues: GitHub Issues
• Email: support@lindemannrock.com

License

This plugin is licensed under the MIT License. See LICENSE.md for details.

Developed by LindemannRock