README

A high-performance, cyberpunk-themed Livewire 3 comment telemetry and tracking system integrated directly with the Statamic CMS core.

StatComm replaces heavy external comment frameworks with an integrated, repository-optimized array matrix. It handles validation constraints directly through your native Control Panel Form Blueprints, isolates assets dynamically, and ships with an integrated, pitch-black management interface right inside your Statamic sidebar menu layout.

Features Matrix

• Zero-Config Validation Sync: Automatically parses your Statamic form blueprints (blog_comments) to dynamically match input constraints, validation rules, and requirement markers.
• Decoupled Repository Query Streaming: Leverages database-level pagination blocks instead of loading whole submission collections into active memory.
• Invisible Spam Interceptors: Equipped with automated un-validated honeypot properties and parent tracing matrix tags to intercept algorithmic bot runs silently.
• Telemetry Widgets: Includes responsive terminal feed components designed to loop source nodes, timestamp deltas, and origin entries onto public dashboards.
• Control Panel Control Console: A fully responsive audit matrix dashboard utilizing inline color maps, volumetric indicators, character density meters, and full data-purging (trace scrubbing) capabilities.

System Requirements

• PHP: ^8.2
• Statamic CMS: ^5.0 or ^6.0
• Laravel Livewire: ^3.0

Installation Blueprint

1. Fetch Package Track

Initialize the uplink and download the package dependency via Composer:

composer require huement/statcomm

2. Publish Configuration & Blueprints

To initialize the backend form storage arrays, publish the baseline form blueprints directly to your project configuration directory:

php artisan vendor:publish --tag=statcomm-config

This creates a blog_comments.yaml engine map inside your resources/forms/ folder directory.

3. Publish Visual Canvas Layouts (Optional)

If you wish to modify the blade template html structures or customize the front-end style vectors to match your site layout profiles, publish the view assets:

php artisan vendor:publish --tag=statcomm-views
This copies your raw template blocks over to resources/views/vendor/statcomm/.

4. Publish Core Telemetry Styles (Optional)

To export the bundled administrative asset arrays directly into the application's public web root, call the asset tag:

php artisan vendor:publish --tag=statcomm-assets
This streams compiled CSS styles into public/vendor/statcomm/css/.

Frontend Integration Uplink

Component 1: The Interactive Comment Subsystem

To render the core comment intake form block along with its corresponding historical listing tree, place the livewire tag node inside your primary Blade or Antlers blog entry single post view layouts:

{{-- Modern Livewire Tag Element Syntax --}}
<livewire:statcomm :articleId="$entry->id()" />

{{-- Alternative Blade Directive Syntax --}}
@livewire('statcomm', ['articleId' => $entry->id()])

Custom Density Overrides

By default, the comment stream chunks items inside batches of 10. To alter the default list density dynamically on the fly per template section, pass an optional explicit :perPage parameter attribute:

<livewire:statcomm :articleId="$entry->id()" :perPage="5" />

Component 2: Recent Comments Telemetry Widget

To capture data updates globally and loop the latest transmission packets onto sidebars, headers, or separate control panels, mount the autonomous widget block:

<livewire:statcomm-widget :limit="5" heading="Recent Comments" :showDate="true" />

Available Parameters Matrix

Control Panel Administration Dashboard

The package automatically extends your native Statamic navigation array, generating an autonomous StatComm item inside the Tools group block menu. Clicking the link navigates to a secure dashboard that calculates total logged submissions, charts character averages, tracks current timespan windows, features algorithmic initials generators, and allows you to audit user entries, execute structural content overrides, or permanently purge invalid entries.

License & Sponsorship

Distributed freely under the open-source MIT License. Maintained, optimized, and engineered under code flags sponsored by HUEMENT.