Zugriff auf einfache Dateilistendaten

ENTWURF

Simple File List speichert Daten, die sich auf eine Dateiliste beziehen, an zwei Orten; das Dateilisten-Array das Dateilisten-Einstellungs-Array. Das Einstellungsarray enthält Informationen, die definieren, wie die Dateiliste angezeigt wird und sich verhält, während das Dateilistenarray Informationen zu jeder Datei und jedem Ordner enthält.

Dieser Artikel soll Ihnen helfen, die Array-Strukturen und den Zugriff auf die darin enthaltenen Daten zu verstehen. Anschließend können Sie benutzerdefinierte Funktionen in der Datei „functions.php“ Ihres Themes erstellen, um die Funktionalität zu erweitern.

Dateilisteneinstellungen

Hier ist ein Beispiel für den Einstieg. Sie können auf die Dateilisteneinstellungen zugreifen, indem Sie die richtige WordPress-Option abrufen:

function SimpleFileList_GetSettings () {
     
    $myListSettings = get_option('eeSFL_Settings_1'); //  1 = The List ID

    // Look at the Array Output
    echo '<pre>'; print_r($myListSettings); echo '</pre>';
     
    exit;  // Stop
}
add_action('wp_loaded', 'SimpleFileList_GetSettings');

Dadurch wird das Array mit den Dateilisteneinstellungen für die Listen-ID 1 zurückgegeben. Jeder Schlüssel im Array stellt eine bestimmte Einstellung dar, und der mit dem Schlüssel verknüpfte Wert definiert das Verhalten oder den Wert dieser Einstellung.

$myListSettings = array(
    "AdminRole" => "5",
    "AllowBulkFileDownload" => "NO",
    "AllowFolderDownload" => "NO",
    "AllowFrontManage" => "YES",
    "AllowOverwrite" => "YES",
    "AllowUploads" => "USER",
    "FileFormats" => "jpg,jpeg,png,tif,pdf,mov,mp4,mp3,zip",
    "FileListDir" => "wp-content/uploads/simple-file-list/",
    "FileListURL" => "https://mywebsite.com/wp-content/uploads/simple-file-list/",
    "FoldersFirst" => "NO",
    "GenerateImgThumbs" => "NO",
    "GeneratePDFThumbs" => "NO",
    "GenerateVideoThumbs" => "NO",
    "GetUploaderDesc" => "NO",
    "GetUploaderInfo" => "NO",
    "LabelDate" => "Date",
    "LabelDesc" => "Description",
    "LabelName" => "",
    "LabelOwner" => "Submitter",
    "LabelSize" => "Size",
    "LabelThumb" => "Thumb",
    "ListTitle" => "Simple File List",
    "MaxSize" => "131072",
    "Notify" => "NO",
    "NotifyBcc" => "",
    "NotifyCc" => "",
    "NotifyFrom" => "",
    "NotifyFromName" => "Simple File List",
    "NotifyMessage" => "",
    "NotifySubject" => "File Upload Notice",
    "NotifyTo" => "",
    "PreserveName" => "YES",
    "PreserveSpaces" => "NO",
    "ShowBreadCrumb" => "YES",
    "ShowFileActions" => "YES",
    "ShowFileCopyLink" => "YES",
    "ShowFileDate" => "YES",
    "ShowFileDateAs" => "Changed",
    "ShowFileDesc" => "YES",
    "ShowFileDownload" => "YES",
    "ShowFileExtension" => "YES",
    "ShowFileOpen" => "YES",
    "ShowFileSize" => "YES",
    "ShowFileThumb" => "YES",
    "ShowFolderSize" => "YES",
    "ShowHeader" => "YES",
    "ShowList" => "USER",
    "ShowListStyle" => "Tiles",
    "ShowListTheme" => "Dark",
    "ShowSubmitterInfo" => "YES",
    "ShowUploadLimits" => "YES",
    "SmoothScroll" => "YES",
    "SortBy" => "DateChanged",
    "SortOrder" => "Descending",
    "UploadConfirm" => "NO",
    "UploadLimit" => "1",
    "UploadMaxFileSize" => "1",
    "UploadPosition" => "Above",
    "UseCache" => "HOUR",
    "UseCacheCron" => "YES"
);

Hier ist eine detaillierte Erklärung jedes Schlüssel-Wert-Paares im Array:

AdminRole: Die Rolle, die auf das Back-End-Menü zugreifen kann. 5 bezeichnet eine Admin-Rolle, während 1 bezeichnet eine Abonnentenrolle.
AllowBulkFileDownload: Ein Flag, das angibt, ob mehrere Elemente als ZIP-Datei heruntergeladen werden können. Die Werte können entweder sein YES or NO.
AllowFolderDownload: Ein Flag, das den Download ganzer Ordner als ZIP-Datei aktiviert oder deaktiviert.
AllowFrontManage: Ermöglicht Frontend-Benutzern die Verwaltung von Listenelementen, wenn diese Option aktiviert ist YES.
AllowOverwrite: Wenn eingestellt auf YES, ermöglicht hochgeladenen Dateien, vorhandene zu überschreiben.
AllowUploads: Definiert, wer Dateien hochladen kann. Mögliche Werte sind ADMIN, USER, ALL, oder NO.
FileFormats: Eine durch Kommas getrennte Liste von Dateierweiterungen, die hochgeladen werden dürfen.
FileListDir: Das Verzeichnis, in dem sich die Dateiliste befindet.
FileListURL: Die URL für den Zugriff auf die Dateiliste.
FoldersFirst: Wenn eingestellt auf YES, Ordner werden vor Dateien aufgelistet.
GenerateImgThumbs: Wenn eingestellt auf YES, erstellt Miniaturbilddateien für Bilddateien.
GeneratePDFThumbs: Wenn eingestellt auf YES, erstellt Miniaturansichten für PDF-Dateien.
GenerateVideoThumbs: Wenn eingestellt auf YES, erstellt Miniaturbilddateien für Videodateien.
GetUploaderDesc: Wenn eingestellt auf YES, zeigt das Beschreibungsfeld im Upload-Formular an.
GetUploaderInfo: Wenn eingestellt auf YES, zeigt die Eingaben des Absenders im Upload-Formular an.
LabelDate: Die Textzeichenfolge, die für die Datumsbeschriftung verwendet wird.
LabelDesc: Die Textzeichenfolge, die für die Beschreibungsbezeichnung verwendet wird.
LabelName: Die für die Namensbeschriftung verwendete Textzeichenfolge.
LabelOwner: Die Textzeichenfolge, die für die Einsenderbezeichnung verwendet wird.
LabelSize: Die für die Größenbeschriftung verwendete Textzeichenfolge.
LabelThumb: Die Textzeichenfolge, die für die Miniaturbildbeschriftung verwendet wird.
ListTitle: Der Titel der Liste.
MaxSize: Die maximale Größe (in Megabyte) einer Datei, die hochgeladen werden kann.
Notify: Wenn eingestellt auf YES, sendet eine Benachrichtigungs-E-Mail zum Datei-Upload.
NotifyBcc: Durch Kommas getrennte Liste von E-Mail-Adressen, an die die Upload-Benachrichtigung per BCC gesendet werden soll.
NotifyCc: Durch Kommas getrennte Liste der E-Mail-Adressen, an die die Upload-Benachrichtigung gesendet werden soll.
NotifyFrom: Die E-Mail-Adresse, von der die Upload-Benachrichtigung gesendet wird.
NotifyFromName: Der Name des Absenders in der Upload-Benachrichtigungs-E-Mail.
NotifyMessage: Der Text der Upload-Benachrichtigungs-E-Mail.
NotifySubject: Die Betreffzeile der Upload-Benachrichtigungs-E-Mail.
NotifyTo: Durch Kommas getrennte Liste der E-Mail-Adressen, an die die Upload-Benachrichtigung gesendet werden soll.
PreserveName: Wenn eingestellt auf YES, behält den ursprünglichen Dateinamen bei und zeigt ihn an.
PreserveSpaces: Wenn eingestellt auf YES, wandelt Bindestriche in Dateinamen in Leerzeichen um.
ShowBreadCrumb: Wenn eingestellt auf YES, zeigt den Breadcrumb-Trail über der Dateiliste an.
ShowFileActions: Wenn eingestellt auf YES, zeigt Dateiaktionen wie Öffnen, Herunterladen usw. an.
ShowFileCopyLink: Wenn eingestellt auf YES, zeigt die Aktion zum Kopieren der Datei.
ShowFileDate: Wenn eingestellt auf YES, zeigt das Datum der Datei an.
ShowFileDateAs: Legt fest, ob das Datum angezeigt werden soll, an dem die Datei hinzugefügt wurde, oder das Datum, an dem sie zuletzt geändert wurde.
ShowFileDesc: Wenn eingestellt auf YES, zeigt die Beschreibung der Datei an.
ShowFileDownload: Wenn eingestellt auf YES, zeigt die Aktion zum Herunterladen der Datei an.
ShowFileExtension: Wenn eingestellt auf YES, zeigt die Erweiterung der Datei an.
ShowFileOpen: Wenn eingestellt auf YES, zeigt die Aktion „Datei öffnen“.
ShowFileSize: Wenn eingestellt auf YES, zeigt die Größe der Datei an.
ShowFileThumb: Wenn eingestellt auf YES, zeigt das Miniaturbild der Datei an.
ShowFolderSize: Wenn eingestellt auf YES, zeigt die Größe des Ordners an.
ShowHeader: Wenn eingestellt auf YES, zeigt die Kopfzeile der Dateilistentabelle an.
ShowList: Definiert, wer die Liste sehen kann. Optionen sind ADMIN, USER, ALL, oder NO.
ShowListStyle: Definiert den Stil der Liste. Möglicher Wert ist TABLE.
ShowListTheme: Definiert das Farbthema der Liste. Ein Beispielwert ist Dark.
ShowSubmitterInfo: Wenn eingestellt auf YES, zeigt die Informationen des Absenders an.
ShowUploadLimits: Wenn eingestellt auf YES, zeigt die Informationen zu den Upload-Limits im Formular an.
SmoothScroll: Wenn eingestellt auf YES, aktiviert den Smooth-Scroll-Effekt nach dem Laden einer Seite.
SortBy: Legt die Sortierkriterien für die Dateien fest. Optionen sind Name, Added, Changed, Size, oder Random.
SortOrder: Bestimmt die Sortierreihenfolge. Optionen sind Descending or Ascending.
UploadConfirm: Wenn eingestellt auf YES, zeigt nach dem Upload eine Ergebnisseite an. Wenn NO, es kehrt zur Liste zurück.
UploadLimit: Die Anzahl der Dateien, die gleichzeitig hochgeladen werden können.
UploadMaxFileSize: Die maximale Größe einer Datei, die hochgeladen werden kann.
UploadPosition: Legt fest, wo das Formular angezeigt werden soll Above or Below Die Liste.
UseCache: Legt fest, wann die Dateien erneut gescannt werden sollen. Optionen sind EACH, DAY, HOUR, OFF.
UseCacheCron: Wenn eingestellt auf YES, verwendet das WordPress wp_cron-System.

Hinweis – Für die booleschen Optionen gilt: YES Aktiviert normalerweise die Funktion oder Option, while NO deaktiviert es. Bei anderen Optionen ist der Wert entweder eine bestimmte Zeichenfolge oder eine Zahl.

Zugriff auf die Einstellungsdaten

Um auf einzelne Datenelemente zuzugreifen, beziehen Sie sich einfach auf deren Schlüssel:

echo $myListSettings['ListTitle'];  // Display the List Title

Erweiterungseinstellungen

Erweiterungs-Plugins können zusätzliche Einstellungsoptionen hinzufügen.

Such- und Paginierungsoption

Dateizugriffsoption

Optionen zum Senden von Dateien

Media Player-Optionen