Edwin Noorlander 9c5a43c5ce Fix guide template variable replacement and enhance documentation
- Fix template variable replacement in guide pages by removing {{}} brackets
- Escape code blocks in guide markdown to prevent template processing
- Completely rewrite guide documentation with comprehensive CMS features
- Add bilingual guide support (English/Dutch) with detailed examples
- Enhance CodePressCMS core with improved guide page handling
- Update template system with better layout and footer components
- Improve language files with additional translations
- Update configuration with enhanced theme and language settings

Resolves issue where guide pages were showing replaced template variables
instead of displaying them as documentation examples.
2025-11-26 16:50:49 +01:00
..

MQTT Tracker Plugin

Deze plugin tracked pagina bezoeken en gebruikersinteracties via MQTT voor Business Intelligence en statistieken.

Functies

  • Real-time tracking: Track elke pagina bezoeker
  • Session management: Unieke sessies per gebruiker
  • MQTT integratie: Verstuurt data naar MQTT broker
  • BI data: Geschikt voor analyse en dashboards
  • Privacy aware: IP tracking en user agent data

Installatie

  1. Kopieer de MQTTTracker map naar plugins/
  2. Configureer de MQTT broker in config.json
  3. De plugin wordt automatisch geladen

Configuratie

{
    "enabled": true,
    "broker_host": "localhost",
    "broker_port": 1883,
    "client_id": "codepress_cms",
    "username": "",
    "password": "",
    "topic_prefix": "codepress",
    "track_visitors": true,
    "track_pages": true,
    "track_performance": true,
    "session_timeout": 1800
}

MQTT Topics

De plugin publiceert naar de volgende topics:

  • codepress/page_visit - Elke pagina bezoeker
  • codepress/session_start - Nieuwe sessie start
  • codepress/custom_event - Custom interacties

Data Formaat

Page Visit

{
    "timestamp": "2025-11-26T15:30:00+00:00",
    "session_id": "cms_1234567890abcdef",
    "page_url": "?page=demo/sidebar-content&lang=nl",
    "page_title": "Sidebar-Content Layout",
    "referrer": "https://google.com",
    "user_agent": "Mozilla/5.0...",
    "ip_address": "192.168.1.100",
    "language": "nl",
    "layout": "sidebar-content"
}

BI Integration

De data kan worden gebruikt voor:

  • Google Data Studio: Real-time dashboards
  • Grafana: Visualisatie en monitoring
  • Power BI: Business analytics
  • Custom dashboards: Eigen analytics tools

Privacy

  • Sessies timeout na 30 minuten
  • IP addresses worden geanonimiseerd
  • Geen persoonlijke data opslag
  • GDPR compliant

Development

De plugin gebruikt een simpele logging methode als fallback wanneer MQTT niet beschikbaar is. Voor productie gebruik wordt een echte MQTT client library aanbevolen.

Log File

Tracking data wordt gelogd in plugins/MQTTTracker/mqtt_tracker.log voor debugging en fallback.