UDKAST
Simple File List gemmer data relateret til en filliste to steder; the file list array the file list settings array. Indstillingsarrayet indeholder information, der definerer, hvordan fillisten vises og opfører sig, mens fillistearrayet indeholder oplysninger om hver fil og mappe.
Denne artikel skal hjælpe dig med at forstå matrixstrukturerne og hvordan du får adgang til dataene i dem. Du kan derefter oprette brugerdefinerede funktioner i dit temas functions.php-fil for at give dig mulighed for at udvide funktionaliteten.
Indstillinger for filliste
Her er et eksempel for at komme i gang. Du kan få adgang til fillisteindstillingerne ved at hente den korrekte WordPress-indstilling:
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');
Dette returnerer arrayet med fillisteindstillinger for liste-id 1. Hver nøgle i arrayet repræsenterer en specifik indstilling, og den værdi, der er knyttet til nøglen, definerer adfærden eller værdien af denne indstilling.
$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"
);
Her er en detaljeret forklaring af hvert nøgleværdi-par i arrayet:
AdminRole
: Rollen, der kan få adgang til backend-menuen.5
betyder en administratorrolle, mens1
betyder en abonnentrolle.AllowBulkFileDownload
: Et flag for at angive, om flere elementer kan downloades som en ZIP-fil. Værdierne kan være entenYES
orNO
.AllowFolderDownload
: Et flag, der aktiverer eller deaktiverer download af hele mapper som en ZIP-fil.AllowFrontManage
: Giver frontend-brugere mulighed for at administrere listeelementer, hvis den er indstillet tilYES
.AllowOverwrite
: Hvis indstillet tilYES
, tillader uploadede filer at overskrive eksisterende.AllowUploads
: Definerer, hvem der kan uploade filer. Mulige værdier erADMIN
,USER
,ALL
ellerNO
.FileFormats
: En kommasepareret liste over filtypenavne, der må uploades.FileListDir
: Det bibliotek, hvor fillisten er placeret.FileListURL
: URL'en til at få adgang til fillisten.FoldersFirst
: Hvis indstillet tilYES
, mapper vises før filer.GenerateImgThumbs
: Hvis indstillet tilYES
, opretter thumbnail-filer til billedfiler.GeneratePDFThumbs
: Hvis indstillet tilYES
, opretter thumbnail-filer til PDF-filer.GenerateVideoThumbs
: Hvis indstillet tilYES
, opretter thumbnail-filer til videofiler.GetUploaderDesc
: Hvis indstillet tilYES
, viser beskrivelsesboksen på uploadformularen.GetUploaderInfo
: Hvis indstillet tilYES
, viser indsenderens input på uploadformularen.LabelDate
: Tekststrengen, der bruges til datoetiketten.LabelDesc
: Tekststrengen, der bruges til beskrivelsesetiketten.LabelName
: Tekststrengen, der bruges til navneetiketten.LabelOwner
: Tekststrengen, der bruges til afsenderetiketten.LabelSize
: Tekststrengen, der bruges til størrelsesetiketten.LabelThumb
: Tekststrengen, der bruges til miniatureetiketten.ListTitle
: Listens titel.MaxSize
: Den maksimale størrelse (i megabyte) af en fil, der kan uploades.Notify
: Hvis indstillet tilYES
, sender en e-mail med besked om filupload.NotifyBcc
: Kommasepareret liste over e-mailadresser, som uploadmeddelelsen skal BCC til.NotifyCc
: Kommasepareret liste over e-mailadresser, som uploadmeddelelsen skal CC til.NotifyFrom
: E-mailadressen, hvorfra uploadmeddelelsen sendes.NotifyFromName
: Afsenderens navn i uploadmeddelelses-e-mailen.NotifyMessage
: Brødteksten i uploadmeddelelses-e-mailen.NotifySubject
: Emnelinjen i e-mailen med uploadmeddelelse.NotifyTo
: Kommasepareret liste over e-mailadresser, som uploadmeddelelsen skal sendes til.PreserveName
: Hvis indstillet tilYES
, bevarer og viser det originale filnavn.PreserveSpaces
: Hvis indstillet tilYES
, konverterer bindestreger i filnavne til mellemrum.ShowBreadCrumb
: Hvis indstillet tilYES
, viser brødkrummesporet over fillisten.ShowFileActions
: Hvis indstillet tilYES
, viser filhandlinger som Åbn, Download osv.ShowFileCopyLink
: Hvis indstillet tilYES
, viser handlingen for kopiering af fil.ShowFileDate
: Hvis indstillet tilYES
, viser datoen for filen.ShowFileDateAs
: Bestemmer, om der skal vises datoen, hvor filen blev tilføjet, eller datoen, hvor den sidst blev ændret.ShowFileDesc
: Hvis indstillet tilYES
, viser filens beskrivelse.ShowFileDownload
: Hvis indstillet tilYES
, viser handlingen for download af fil.ShowFileExtension
: Hvis indstillet tilYES
, viser filens filtypenavn.ShowFileOpen
: Hvis indstillet tilYES
, viser handlingen for åben fil.ShowFileSize
: Hvis indstillet tilYES
, viser størrelsen på filen.ShowFileThumb
: Hvis indstillet tilYES
, viser filens miniaturebillede.ShowFolderSize
: Hvis indstillet tilYES
, viser størrelsen på mappen.ShowHeader
: Hvis indstillet tilYES
, viser fillistens tabeloverskrift.ShowList
: Definerer, hvem der kan se listen. Valgmuligheder erADMIN
,USER
,ALL
ellerNO
.ShowListStyle
: Definerer listens stil. Mulig værdi erTABLE
.ShowListTheme
: Definerer farvetemaet for listen. Et eksempel på værdi erDark
.ShowSubmitterInfo
: Hvis indstillet tilYES
, viser afsenderens oplysninger.ShowUploadLimits
: Hvis indstillet tilYES
, viser oplysninger om uploadgrænser på formularen.SmoothScroll
: Hvis indstillet tilYES
, aktiverer glat rulle-effekt efter en sideindlæsning.SortBy
: Bestemmer sorteringskriterierne for filerne. Valgmuligheder erName
,Added
,Changed
,Size
ellerRandom
.SortOrder
: Bestemmer sorteringsrækkefølgen. Valgmuligheder erDescending
orAscending
.UploadConfirm
: Hvis indstillet tilYES
, viser en resultatside efter upload. HvisNO
, vender den tilbage til listen.UploadLimit
: Antallet af filer, der kan uploades på én gang.UploadMaxFileSize
: Den maksimale størrelse af en fil, der kan uploades.UploadPosition
: Bestemmer, hvor formularen skal visesAbove
orBelow
listen.UseCache
: Bestemmer, hvornår filerne skal scannes igen. Valgmuligheder erEACH
,DAY
,HOUR
,OFF
.UseCacheCron
: Hvis indstillet tilYES
, bruger WordPress wp_cron-systemet.
Bemærk – For de booleske muligheder, YES
aktiverer typisk funktionen eller muligheden, mens NO
deaktiverer den. For andre muligheder er værdien enten en bestemt streng eller et tal.
Adgang til indstillingsdata
For at få adgang til individuelle dataelementer skal du blot henvise til deres nøgler:
echo $myListSettings['ListTitle']; // Display the List Title
Udvidelsesindstillinger
Udvidelsesplugins kan tilføje yderligere indstillingsmuligheder.
Søge- og sideindstillingsmulighed
Mulighed for filadgang
Indstillinger for Send filer
Indstillinger for medieafspiller