Accès aux données de la liste de fichiers simple

PROJET

La liste de fichiers simple stocke les données relatives à une liste de fichiers à deux endroits ; le tableau de la liste des fichiers le tableau des paramètres de la liste des fichiers. Le tableau des paramètres contient des informations qui définissent l'apparence et le comportement de la liste de fichiers, tandis que le tableau de la liste des fichiers contient des informations sur chaque fichier et dossier.

Cet article devrait vous aider à comprendre les structures de tableau et comment accéder aux données qu'elles contiennent. Vous pouvez ensuite créer des fonctions personnalisées dans le fichier functions.php de votre thème pour vous permettre d'étendre les fonctionnalités.

Paramètres de la liste des fichiers

Voici un exemple pour commencer. Vous pouvez accéder aux paramètres de la liste de fichiers en récupérant la bonne option WordPress :

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');

Cela renverra le tableau des paramètres de la liste de fichiers pour l'ID de liste 1. Chaque clé du tableau représente un paramètre spécifique et la valeur associée à la clé définit le comportement ou la valeur de ce paramètre.

$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"
);

Voici une explication détaillée de chaque paire clé-valeur du tableau :

AdminRole: Le rôle qui peut accéder au menu principal. 5 signifie un rôle d'administrateur, tandis que 1 signifie un rôle d'abonné.
AllowBulkFileDownload: Un indicateur pour indiquer si plusieurs éléments peuvent être téléchargés sous forme de fichier ZIP. Les valeurs peuvent être soit YES or NO.
AllowFolderDownload: Un indicateur qui active ou désactive le téléchargement de dossiers entiers sous forme de fichier ZIP.
AllowFrontManage: permet aux utilisateurs frontaux de gérer les éléments de la liste s'ils sont définis sur YES.
AllowOverwrite: Si défini sur YES, permet aux fichiers téléchargés d'écraser ceux qui existent déjà.
AllowUploads: Définit qui peut télécharger des fichiers. Les valeurs possibles sont ADMIN, USER, ALLou NO.
FileFormats: une liste d'extensions de fichiers séparées par des virgules qui sont autorisées à être téléchargées.
FileListDir: Le répertoire où se trouve la liste des fichiers.
FileListURL: L'URL pour accéder à la liste des fichiers.
FoldersFirst: Si défini sur YES, les dossiers sont répertoriés avant les fichiers.
GenerateImgThumbs: Si défini sur YES, crée des fichiers miniatures pour les fichiers image.
GeneratePDFThumbs: Si défini sur YES, crée des fichiers miniatures pour les fichiers PDF.
GenerateVideoThumbs: Si défini sur YES, crée des fichiers miniatures pour les fichiers vidéo.
GetUploaderDesc: Si défini sur YES, affiche la zone de description sur le formulaire de téléchargement.
GetUploaderInfo: Si défini sur YES, affiche les entrées de l'émetteur sur le formulaire de téléchargement.
LabelDate: La chaîne de texte utilisée pour l'étiquette de date.
LabelDesc: La chaîne de texte utilisée pour l'étiquette de description.
LabelName: La chaîne de texte utilisée pour l'étiquette de nom.
LabelOwner: La chaîne de texte utilisée pour l'étiquette de l'émetteur.
LabelSize: La chaîne de texte utilisée pour l'étiquette de taille.
LabelThumb: La chaîne de texte utilisée pour l'étiquette de vignette.
ListTitle: Le titre de la liste.
MaxSize: La taille maximale (en mégaoctets) d'un fichier pouvant être téléchargé.
Notify: Si défini sur YES, envoie un e-mail de notification de téléchargement de fichier.
NotifyBcc: Liste d'adresses e-mail séparées par des virgules à BCC pour la notification de téléchargement.
NotifyCc: liste d'adresses e-mail séparées par des virgules à envoyer en CC à la notification de téléchargement.
NotifyFrom: L'adresse e-mail à partir de laquelle la notification de téléchargement est envoyée.
NotifyFromName: nom de l'expéditeur dans l'e-mail de notification de téléchargement.
NotifyMessage: le corps de l'e-mail de notification de chargement.
NotifySubject: la ligne d'objet de l'e-mail de notification de téléchargement.
NotifyTo: liste d'adresses e-mail séparées par des virgules auxquelles envoyer la notification de téléchargement.
PreserveName: Si défini sur YES, conserve et affiche le nom de fichier d'origine.
PreserveSpaces: Si défini sur YES, convertit les tirets des noms de fichiers en espaces.
ShowBreadCrumb: Si défini sur YES, affiche le fil d'Ariane au-dessus de la liste des fichiers.
ShowFileActions: Si défini sur YES, affiche les actions de fichiers comme Ouvrir, Télécharger, etc.
ShowFileCopyLink: Si défini sur YES, affiche l'action de copie de fichier.
ShowFileDate: Si défini sur YES, indique la date du fichier.
ShowFileDateAs: détermine s'il faut afficher la date à laquelle le fichier a été ajouté ou la date à laquelle il a été modifié pour la dernière fois.
ShowFileDesc: Si défini sur YES, affiche la description du fichier.
ShowFileDownload: Si défini sur YES, affiche l'action de téléchargement du fichier.
ShowFileExtension: Si défini sur YES, affiche l'extension du fichier.
ShowFileOpen: Si défini sur YES, affiche l'action d'ouverture de fichier.
ShowFileSize: Si défini sur YES, indique la taille du fichier.
ShowFileThumb: Si défini sur YES, affiche l'image miniature du fichier.
ShowFolderSize: Si défini sur YES, indique la taille du dossier.
ShowHeader: Si défini sur YES, affiche l'en-tête du tableau de la liste des fichiers.
ShowList: Définit qui peut voir la liste. Les options sont ADMIN, USER, ALLou NO.
ShowListStyle: Définit le style de la liste. La valeur possible est TABLE.
ShowListTheme: Définit le thème de couleur de la liste. Un exemple de valeur est Dark.
ShowSubmitterInfo: Si défini sur YES, affiche les informations de l'émetteur.
ShowUploadLimits: Si défini sur YES, affiche les informations sur les limites de téléchargement sur le formulaire.
SmoothScroll: Si défini sur YES, active l'effet de défilement fluide après le chargement d'une page.
SortBy: détermine les critères de tri des fichiers. Les options sont Name, Added, Changed, Sizeou Random.
SortOrder: détermine l'ordre de tri. Les options sont Descending or Ascending.
UploadConfirm: Si défini sur YES, affiche une page de résultats après le téléchargement. Si NO, il revient à la liste.
UploadLimit: Le nombre de fichiers pouvant être téléchargés simultanément.
UploadMaxFileSize: La taille maximale d'un fichier qui peut être téléchargé.
UploadPosition: Détermine où afficher le formulaire, soit Above or Below la liste.
UseCache: Détermine quand re-scanner les fichiers. Les options sont EACH, DAY, HOUR, OFF.
UseCacheCron: Si défini sur YES, utilise le système WordPress wp_cron.

Remarque – Pour les options booléennes, YES active généralement la fonctionnalité ou l'option, tandis que NO le désactive. Pour les autres options, la valeur est soit une chaîne spécifique, soit un nombre.

Accéder aux données de paramétrage

Pour accéder aux éléments de données individuels, il suffit de se référer à leurs clés :

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

Paramètres d'extension

Les plugins d'extension peuvent ajouter des options de paramètres supplémentaires.

Option de recherche et de pagination

Option d'accès aux fichiers

Options d'envoi de fichiers

Options du lecteur multimédia