CH CSV Lister

Info

• Version: 1.4.0
• Autor: Conny Henn
• Lizenz: GPL v2 or later
• WordPress-Version: 5.0 oder höher
• PHP-Version: 7.4 oder höher
• komplett kostenlos

Beschreibung

Das CH CSV Lister Plugin für WordPress verwandelt CSV-Dateien in professionelle, durchsuchbare und responsive HTML-Tabellen mit erweiterten Funktionen wie Sortierung, Filterung, Paginierung und PDF-Export. Ideal für Datenbanken, Preislisten, Inventar, Mitgliederlisten und jede Art von tabellarischen Daten.

Hauptfunktionen

• Einfache Integration: CSV-Dateien per Shortcode in jede Seite oder jeden Beitrag einbinden
• Responsive Design: Automatische Anpassung an alle Bildschirmgrößen
• Erweiterte Suche: Spaltenbasierte Filter und globale Suchfunktion
• PDF-Export: Professionelle PDF-Generierung mit Logo und Branding
• CSV-Editor: Integrierter CodeMirror-Editor für Administratoren
• Anpassbare Darstellung: Flexible Spaltenauswahl und Zeilenoptionen
• HTML-Unterstützung: Automatische Link-Erkennung und HTML-Rendering

Verwendung

Basis-Shortcode

[csv_lister datei="pfad/zur/datei.csv"]

Erweiterte Parameter

[ csv_lister
datei="pfad/zur/datei.csv"
delimiter=";"
encoding="UTF-8"
headers="Name,E-Mail,Telefon"
showcol="1,3,5"
start="2"
rowpage="10,25,50"
title="Meine Tabelle"
orientation="q"
pdflogo="pfad/zum/logo.png"
]

Parameter-Beschreibung

• datei (erforderlich): Pfad oder URL zur CSV-Datei
• delimiter: Trennzeichen (Standard: „;“)
• encoding: Zeichenkodierung (automatische Erkennung wenn leer)
• headers: Benutzerdefinierte Spaltenüberschriften
• showcol: Anzuzeigende Spalten (z.B. „1,3,5“)
• start: Startzeile für Daten (Standard: 1)
• rowpage: Optionen für Zeilen pro Seite
• title: Tabellen-Titel für PDF-Export
• orientation: PDF-Ausrichtung (H=Hochformat, Q=Querformat)
• pdflogo: Logo für PDF-Export

Technische Features

Frontend-Features

• DataTables.js Integration
• Responsive Tabellen-Design
• Spaltenbasierte Filterung
• Sortierung nach allen Spalten
• Paginierung mit konfigurierbaren Optionen
• PDF-Export mit Logo und Branding
• Automatische URL-zu-Link Konvertierung
• HTML-Unterstützung in Zellen

Backend-Features

• Intuitive Einstellungsseite
• Asset-Management (CDN/Lokal)
• Integrierter CSV-Editor
• Benutzerrolle-basierte PDF-Berechtigung
• Automatische Asset-Downloads
• Intelligente Admin-Benachrichtigungen
• Kompatibilitäts-Prüfungen
• Performance-Monitoring

Asset-Management

Das Plugin bietet flexible Asset-Verwaltung:

CDN-Modus (Standard)

• Automatisches Laden von Content Delivery Networks
• Optimierte Ladezeiten durch globale Verteilung
• Automatische Browser-Cache-Nutzung
• Kein lokaler Speicherplatzbedarf

Lokaler Modus

• Ein-Klick-Download aller erforderlichen Assets (~2.5 MB)
• Offline-Funktionalität
• Vollständige Datenschutz-Compliance
• Unabhängigkeit von externen Servern

CSV-Editor

Für Administratoren steht ein integrierter CSV-Editor zur Verfügung:

• CodeMirror-basierter Editor mit Syntax-Highlighting
• Such- und Ersetzungsfunktionen (Ctrl+F, Ctrl+H)
• Verschiedene Syntax-Modi (CSV, Mathematica)
• Drag & Drop Modal-Fenster
• Automatische Dateisicherung
• Sichere Dateipfad-Validierung

PDF-Export

Professionelle PDF-Generierung mit folgenden Features:

• Automatisches Logo-Branding
• Wählbare Orientierung (Hoch-/Querformat)
• Anpassbare Titel und Header
• Berücksichtigung aktiver Filter
• Datum und Seitennummerierung
• Optimierte Tabellen-Formatierung

Benutzerberechtigungen

Flexible Rechteverwaltung für verschiedene Funktionen:

• PDF-Export: Konfigurierbar von „Alle“ bis „Nur Administratoren“
• CSV-Editor: Nur für Administratoren
• Asset-Management: Nur für Administratoren
• Plugin-Einstellungen: Nur für Administratoren

Unterstützte Datenformate

CSV-Kompatibilität

• Trennzeichen: Semikolon, Komma, Tabulator, Pipe
• Kodierung: UTF-8, ISO-8859-1, Windows-1252
• Dateiquellen: Lokale Dateien, externe URLs
• Zelleninhalt: Text, HTML, URLs, E-Mail-Adressen
• Kommentare: Zeilen beginnend mit /* werden ignoriert

Installation

1. Plugin-Zip-Datei über WordPress-Admin hochladen
2. Plugin aktivieren
3. Zu „CSV Lister“ → „Einstellungen“ navigieren
4. Asset-Quelle wählen (CDN empfohlen)
5. Bei lokalem Modus: Assets herunterladen
6. CSV-Dateien per Shortcode einbinden

Häufige Anwendungsfälle

• E-Commerce: Produktkataloge und Preislisten
• Immobilien: Objektlisten mit Filterfunktionen
• Vereinswesen: Mitgliederlisten und Turniere
• Bildung: Kurslisten und Stundenpläne
• Unternehmen: Mitarbeiterverzeichnisse und Inventar
• Events: Teilnehmerlisten und Zeitpläne
• Forschung: Datenpräsentation und Statistiken

Sicherheitsfeatures

• CSRF-Schutz durch WordPress-Nonces
• Sichere Dateipfad-Validierung
• XSS-Schutz bei HTML-Zelleninhalten
• Benutzerberechtigungs-Prüfungen
• Sichere AJAX-Implementierung

Performance-Optimierungen

• Lazy Loading für große Tabellen
• Optimierte DataTables-Konfiguration
• Minimale Script-/Style-Einbindung
• Browser-Cache-Unterstützung
• Responsive Lazy-Rendering

Mehrsprachigkeit

Das Plugin ist vollständig übersetzungsbereit:

• Textdomain: ‚ch-csv-lister‘
• Deutsche Übersetzung inkludiert
• Bereit für weitere Sprachen
• WordPress-Übersetzungsstandards

DEMO

Entwickler-APIs

// Hooks für Entwickler
add_filter('csv_lister_default_options', 'my_csv_defaults');
add_action('csv_lister_before_table', 'my_custom_header'); 
add_action('csv_lister_after_table', 'my_custom_footer');
// Asset-Management API
CSV_Lister_Asset_Manager::get_asset_urls(); 
CSV_Lister_Asset_Manager::check_local_assets();

Changelog

Version 1.4.0

• Neues Asset-Management-System
• Erweiterte Admin-Benachrichtigungen
• Verbesserte Plugin-Links in Übersicht
• Performance-Optimierungen

Version 1.3.0

• Integrierter CSV-Editor mit CodeMirror
• Verbesserte Fehlerbehandlung
• PHP 8.2+ Kompatibilität
• Erweiterte Sicherheitsfeatures

Version 1.2.0

• PDF-Export mit Logo-Branding
• Benutzerrolle-basierte Berechtigungen
• HTML-Unterstützung in CSV-Zellen
• Automatische URL-Erkennung

Hinweis: Bei der Verwendung externer CSV-URLs stellen Sie sicher, dass diese von vertrauenswürdigen Quellen stammen. Das Plugin validiert Dateipfade zur Sicherheit.

Lizenz

Dieses Plugin steht unter der GPL v2 (oder höher) Lizenz. Sie können es frei verwenden, modifizieren und verteilen gemäß den Bedingungen der General Public License.

Externe Bibliotheken:

• DataTables.js – MIT Lizenz
• CodeMirror – MIT Lizenz
• PDFMake – MIT Lizenz
• JSZip – MIT/GPL Dual-Lizenz

---

CH CSV Lister – Transformieren Sie Ihre CSV-Daten in professionelle, interaktive Tabellen mit nur wenigen Klicks.

Download