WordPress Plugin · Premium · v1.0.0

 Deterministic parsing + optional AI narrative.

Modbus · CAN Bus · Profibus DP · Drive Faults · Siemens SINAMICS · SEW · Danfoss · Rexroth · Lenze · OpenAI Narrative

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
WHAT IS THIS PLUGIN?
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

XC Industrial Log Analyzer is a premium WordPress plugin developed by Xania Code, designed for industrial service websites, system integrators, and maintenance departments. It allows visitors to upload log files from industrial protocols and immediately receive a structured preliminary diagnostic report — no coding, no complex configuration required.

🔍 Deterministic analysis
Precise, rule-based parsing with no ambiguity — every identified error is backed by concrete evidence extracted directly from the file.

🤖 Optional AI narrative
OpenAI integration that generates a human-readable explanation of the technical report — admin-enabled, with explicit user consent.

📦 Extensible Profile Packs
JSON packages with vendor-specific fingerprints and fault code dictionaries. 6 demo packs included: Siemens, SEW, Danfoss, Rexroth, Lenze.

🛡️ Industrial-grade security
Hardened upload pipeline: real MIME detection, PHP payload rejection, per-IP rate limiting, ZIP bomb and path traversal protection.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SUPPORTED PROTOCOLS AND FORMATS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Seven built-in parsers, each optimized for the specific structure of its format.

PROTOCOL │ Modbus
│ Text gateway export — timeout, CRC, exception detection

PROTOCOL │ CAN Bus — .asc
│ Vector format; bus-off, error-passive detection

PROTOCOL │ Profibus DP
│ Text diagnostic buffer (beta) — station failure, config error

DRIVE FAULTS │ Text log
│ SINAMICS, SEW, Danfoss, Rexroth, Lenze

DRIVE FAULTS │ CSV log
│ Tabular format with fault codes and timestamps

GENERIC │ Universal CSV
│ timestamp, node, error, message — auto-mapped

💡 Smart auto-detection
If the user doesn't know the format, they can select Auto-detect and the plugin applies fingerprint scoring across all active profiles — reporting the identification confidence level as well.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SUPPORTED VENDORS (PROFILE PACKS)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

The plugin ships with 6 demo packs and supports uploading custom packs. Each pack contains identification fingerprints, fault code dictionaries, and vendor-specific enrichment rules.

🟦 Siemens SINAMICS
🟦 Siemens Profibus DP
🟩 SEW-EURODRIVE
🟧 Danfoss VLT
🟥 Bosch Rexroth IndraDrive
🟨 Lenze Drive

✓ Automatic identification with scoring and confidence output
✓ Fault code decoding from the pack dictionary (title, severity, occurrence count)
✓ Enrichment with vendor-specific recommendations
✓ Upload custom JSON packs (max 512 KB) — test detection without a real job
✓ Decode coverage estimate (decode coverage %) — clearly shows what is missing for 100%

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
WHAT DOES THE GENERATED REPORT CONTAIN?
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

The analysis engine (XCILA_Rules) produces a structured report with everything a technician needs to prioritize remediation actions.

--- Quantitative data ---

✓ Health Score (0–100) — communication health score
✓ Total event count: errors, timeouts, CRC failures, retries, exceptions
✓ Error rate (error_rate)
✓ Capture duration (first and last timestamp)
✓ Top 5 nodes/stations with the most errors
✓ Top 10 fault codes (with frequency and decoded description)

--- Qualitative conclusions ---

✓ Findings with severity (high / medium / low) and confidence level (%)
✓ Concrete evidence: file lines, affected nodes, message examples
✓ Actionable technical recommendations (physical checks, configurations, parameters)
✓ Detected device identity (vendor, family, model)
✓ Decoded fault code with title and severity from the pack
✓ Decode coverage estimate

✨ AI Narrative (optional)
When the admin enables OpenAI integration and the user gives consent, the plugin sends the deterministic data (not the raw file!) to OpenAI and generates a block with: Summary · Findings (max 5) · Recommended next steps (max 6). Output is constrained via strict JSON schema — the model cannot invent new data, only reformulate what the deterministic parser found.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FRONT-END INTERFACE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

The plugin is activated via a simple shortcode and delivers a fully responsive, complete interface.

Shortcodes:
[xc_industrial_log_analyzer]
[xc_industrial_log_analyzer theme="dark"]
[xc_log_analyzer] ← short alias

4 visual themes:
○ Inherit — follows the active WP theme
○ Light — fixed light palette
○ Dark — fixed dark palette
○ Professional — XaniaCode indigo

✓ Live progress bar + status polling (no manual refresh needed)
✓ Tables collapse into stacked cards on mobile
✓ Optional email field — notification when the report is ready
✓ Asynchronous processing via WP-Cron — no HTTP blocking
✓ Neutral message if the license is inactive (no technical details exposed)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SECURITY
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

The upload pipeline is one of the most hardened in the WordPress ecosystem for industrial file handling.

🔐 Real MIME sniffing
Validation via extension + finfo MIME + content sniff — PHP payloads hidden inside .txt or .csv files are rejected.

🚫 ZIP bomb protection
Limit of 200 entries, 25 MB decompressed, 200:1 compression ratio — no malicious archive gets through.

🛤️ Anti path traversal
Rejects "..", absolute paths, Windows drive letters, null bytes, and symlinks inside archives.

⏱️ Per-IP rate limiting
Maximum 10 uploads/hour per IP. Honeypot field on the public form to block bots.

🔒 Private directory
Files are stored in xcila-private/, blocked via .htaccess. Permissions set to 0640.

🔑 Secured API key
XCILA_OPENAI_API_KEY can be defined in wp-config.php — never stored in the database.

✅ Nonce on all AJAX calls
Every AJAX endpoint verifies the nonce and the license before any processing begins.

🧹 Clean uninstall
On uninstall: tables dropped, all options and transients removed, private directory deleted.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
LICENSING SYSTEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

XaniaCode License Manager v2.1 — the most advanced licensing system for premium WordPress plugins.

🎯 14-day trial
Starts automatically on first activation. No credit card required — test everything before purchasing.

🔐 Encrypted license key
The license key is stored with envelope enc1: — never plaintext in wp_options. Automatic migration of legacy keys.

🔄 WP-Cron verification
Real check twice a day, not on every request. Revocations apply even on low-traffic sites.

⚡ Remote kill-switch
XaniaCode administrators can revoke activations remotely. On the next cron check, front-end processing is blocked.

✓ License key verification is done via POST — the key never appears in web server logs or browser history
✓ Deactivation is confirmed server-side before local deletion — prevents stranded activations
✓ 6-hour cache for update info responses — does not overload the vendor API
✓ XC_LICENSE_ENC_KEY constant ensures key survival through WP salt rotations

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
INSTALLATION AND SETUP
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. Upload the plugin
Upload the xc-industrial-log-analyzer folder to /wp-content/plugins/ or install the ZIP directly from the WordPress admin.

2. Activate the plugin
The 14-day trial starts automatically. Database tables are created on activation.

3. Activate your license
Go to Log Analyzer → License and enter your XaniaCode key. Verification is done via secure POST.

4. Create a page with the shortcode
Add [xc_industrial_log_analyzer] to any WordPress page or post.

5. Optional AI configuration
Enable AI narrative in Log Analyzer → Settings and enter your OpenAI key (or define XCILA_OPENAI_API_KEY in wp-config.php).

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SYSTEM REQUIREMENTS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

WordPress │ 6.0 or higher (tested up to 6.6)
PHP │ 7.4 or higher
PHP Extension │ finfo (for real MIME sniffing)
Web Server │ Apache (with .htaccess) or Nginx (with manual config for the private directory)
WP-Cron │ Enabled (or a real system cron for low-traffic sites)
External dependencies│ None — no vendor folder, no third-party PHP libraries
OpenAI (optional) │ OpenAI API key; default model is gpt-4o-mini

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
WHY USE XC INDUSTRIAL LOG ANALYZER?
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚡ Instant report, no expertise required
Anyone can upload a log and receive a structured technical report — without needing to know the underlying industrial protocol.

🏭 Built for industrial domains
This is not a generic analyzer. It knows the exact structure of each protocol: Modbus, CAN, Profibus, drive faults.

📊 Visible Health Score
A single number (0–100) that instantly communicates communication status — useful for both technicians and management.

🔧 Actionable recommendations
It doesn't stop at "you have errors." It provides concrete steps: cable check, termination, power supply, register configuration.

🤖 AI without hallucinations
The AI narrative is constrained via JSON schema — it cannot invent new data, only reformulate what the deterministic parser found.

🔌 Extensible via profile packs
You can add support for any new vendor through a JSON file — no additional PHP code required.

🚀 Ideal for...

✓ Industrial automation service companies and integrators who want to offer clients an online preliminary diagnostic
✓ Maintenance departments receiving field logs who need a quick pre-analysis
✓ Equipment distributors (drives, PLCs) who want to offer a technical support tool on their own website
✓ Industrial SaaS platforms looking to integrate log analysis into their support workflow

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
XC Industrial Log Analyzer · v1.0.0 · Developed by Xania Code
Plugin URI: xaniacode.com/product/xc-industrial-log-analyzer/
GPLv2 or later License
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━