=== APlug Medienbibliothek Plus ===
Contributors: aplug
Tags: media library, folders, attachments, duplicate media, media management
Requires at least: 6.4
Tested up to: 6.8
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Organisiert WordPress-Medien mit virtuellen Ordnern, Sammlungen, Metadaten, Nutzungsanalyse, Dublettenprüfung und sicherer Dateiersetzung.

== Description ==

APlug Medienbibliothek Plus erweitert die vorhandene WordPress-Medienverwaltung. Die eigentlichen Anhänge und Datei-URLs bleiben unverändert. Virtuelle Ordner, Sammlungen, Schlagwörter und rollenabhängige Medienbereiche werden als zusätzliche Organisationsschicht gespeichert.

Kernfunktionen:

* hierarchische virtuelle Medienordner ohne Änderung von Datei-URLs,
* Sammlungen und Medienschlagwörter,
* rollenabhängige Medienbereiche,
* Urheber-, Lizenz- und Quellenfelder,
* Anzeige von Dateigröße, Abmessungen, Typ, Alternativtext, Beschriftung und Upload-Benutzer,
* kontrollierter Index bekannter Verwendungsorte,
* Hinweise auf fehlende Alternativtexte, ungenutzte und ungewöhnlich große Dateien,
* SHA-256-Dublettenprüfung,
* optionale visuelle Bildähnlichkeitsprüfung mit lokalem GD,
* Massenbearbeitung bis zu 200 ausgewählten Medien je Vorgang,
* sichere Dateiersetzung unter Beibehaltung von Anhangs-ID und Datei-URL,
* Sicherung und Wiederherstellung ersetzter Dateien,
* Download-Sammlungen mit Größen- und Dateigrenzen,
* dokumentierte Übergabe von Bildoptimierung und Formatumwandlung an APlug BildWerkstatt,
* versionierte APlug-Dienste, Ereignisse und REST-Endpunkte,
* WordPress-Datenschutzexport und manuelle Löschprüfung.

Das Plugin lädt keine externen Skripte, Schriftarten oder Trackingdienste. Es sendet keine Medien an externe Dienste. Ein optionaler BildWerkstatt-Adapter wird lokal über eine dokumentierte WordPress-Schnittstelle angesprochen.

= Wichtige Grenzen =

Die Nutzungsanalyse kann nur bekannte und technisch erkennbare Verwendungen indexieren. Ein als „ungenutzt“ gekennzeichnetes Medium darf deshalb nicht ungeprüft gelöscht werden. Inhalte aus proprietären Page-Buildern, dynamischen CSS-Dateien, externen Datenquellen oder nicht dokumentierten Pluginstrukturen können unerkannt bleiben.

Visuelle Ähnlichkeit ist ein technischer Prüfhinweis und kein Beweis für eine echte Dublette. Die sichere Dateiersetzung verlangt dieselbe Dateiendung und dieselbe MIME-Hauptgruppe. Vor produktivem Einsatz ist eine vollständige Website-Sicherung erforderlich.

== Installation ==

1. Die ZIP-Datei unter „Plugins > Installieren > Plugin hochladen“ auswählen.
2. Plugin aktivieren.
3. Unter „Medien > Medienbibliothek Plus“ Ordner, Sammlungen und Medienbereiche konfigurieren.
4. Unter „Medien > Medienanalyse“ Nutzungs- und Fingerabdruckanalyse schrittweise ausführen.
5. Rollen und Fähigkeiten vor dem Einsatz eingeschränkter Medienbereiche prüfen.
6. Vor der ersten Dateiersetzung eine vollständige Website-Sicherung erstellen.

== Frequently Asked Questions ==

= Ändern virtuelle Ordner die Datei-URL? =

Nein. Ordner sind WordPress-Taxonomiezuordnungen. Physischer Speicherort, Anhangs-ID und URL werden dadurch nicht geändert.

= Darf ich alle als ungenutzt markierten Medien löschen? =

Nein. Die Kennzeichnung bedeutet nur, dass der lokale Index keinen bekannten Verwendungsort gefunden hat. Nicht erkennbare Verwendungen müssen manuell geprüft werden.

= Wie werden Dubletten erkannt? =

Exakte Dubletten werden über SHA-256-Dateifingerabdrücke erkannt. Bilder können zusätzlich über einen lokal berechneten 64-Bit-Durchschnittshash als sehr ähnlich gekennzeichnet werden, sofern GD verfügbar ist.

= Bleibt die URL bei einer Dateiersetzung erhalten? =

Ja, sofern die neue Datei dieselbe Dateiendung und eine kompatible MIME-Hauptgruppe besitzt. Originaldatei und erzeugte Bildgrößen werden vorher gesichert.

= Komprimiert das Plugin Bilder? =

Nein. Um doppelte Fachlogik zu vermeiden, delegiert es Optimierung und Formatumwandlung an APlug BildWerkstatt oder einen kompatiblen Adapter.

= Werden Daten an externe Dienste übertragen? =

Nein. Das Plugin selbst baut keine externen Verbindungen auf.

= Funktionieren Download-Sammlungen ohne ZipArchive? =

Nein. Für ZIP-Sammlungspakete muss die PHP-Erweiterung ZipArchive verfügbar sein.

= Unterstützt der Prototyp Multisite-Netzwerkaktivierung? =

Nein. Er wird pro Website aktiviert. Eine Netzwerkaktivierung wird kontrolliert abgelehnt.

== Screenshots ==

1. Medienbibliothek-Plus-Übersicht mit Suche, Filtern und Massenbearbeitung.
2. Vollständige Plus-Detailansicht einer Mediendatei.
3. Virtuelle Ordner, Sammlungen und Schlagwörter.
4. Rollenabhängige Medienbereiche.
5. Diagnose- und Analysebereich.
6. Dubletten- und Ähnlichkeitshinweise.
7. Sichere Dateiersetzung mit Ersetzungshistorie.
8. Einstellungen für Grenzwerte, Zugriffe und Deinstallation.

== Changelog ==

= 1.0.0 =

* Erster installierbarer Prototyp.
* Virtuelle Ordner, Sammlungen, Medienschlagwörter und Rollenbereiche.
* Erweiterte Medienmetadaten und Plus-Detailansicht.
* Nutzungsindex und kontrollierte Stapelanalyse.
* Exakte und visuelle Fingerabdrücke.
* Hinweise auf fehlende Alternativtexte, ungenutzte, große, doppelte und ähnliche Medien.
* Massenbearbeitung.
* Sichere Dateiersetzung mit Sicherung und Wiederherstellung.
* Download-Sammlungen.
* Dokumentierte BildWerkstatt-Schnittstelle.
* REST-, APlug-, Datenschutz-, Sicherheits- und Deinstallationsdokumentation.

== Upgrade Notice ==

= 1.0.0 =

Erster Prototyp. Vor produktivem Einsatz auf einer Staging-Website testen und vollständig sichern.
