Přístup k datům jednoduchého seznamu souborů

by

NÁVRH

Jednoduchý seznam souborů ukládá data související se seznamem souborů na dvou místech; pole seznamu souborů pole nastavení seznamu souborů. Pole nastavení obsahuje informace, které definují, jak se seznam souborů zobrazí a chová, zatímco pole seznamu souborů obsahuje informace o každém souboru a složce.

Tento článek by vám měl pomoci pochopit struktury polí a jak získat přístup k datům v nich. Poté můžete vytvořit vlastní funkce v souboru functions.php vašeho motivu, abyste mohli funkce rozšířit.

Nastavení seznamu souborů

Zde je příklad pro začátek. K nastavení seznamu souborů se dostanete načtením správné možnosti 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');

Tím se vrátí pole nastavení seznamu souborů pro seznam ID 1. Každý klíč v poli představuje určité nastavení a hodnota spojená s klíčem definuje chování nebo hodnotu tohoto nastavení.

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

Zde je podrobné vysvětlení každého páru klíč–hodnota v poli:

  • AdminRole: Role, která má přístup k nabídce back-end. 5 označuje roli správce, zatímco 1 znamená roli předplatitele.
  • AllowBulkFileDownload: Příznak označující, zda lze stáhnout více položek jako soubor ZIP. Hodnoty mohou být buď YES or NO.
  • AllowFolderDownload: Příznak, který povoluje nebo zakazuje stahování celých složek jako souboru ZIP.
  • AllowFrontManage: Umožňuje uživatelům front-end spravovat položky seznamu, pokud je nastaveno YES.
  • AllowOverwrite: Je-li nastaveno na YES, umožňuje nahraným souborům přepsat stávající.
  • AllowUploads: Definuje, kdo může nahrávat soubory. Možné hodnoty jsou ADMIN, USER, ALLnebo NO.
  • FileFormats: Čárkami oddělený seznam přípon souborů, které je povoleno nahrávat.
  • FileListDir: Adresář, kde je umístěn seznam souborů.
  • FileListURL: Adresa URL pro přístup k seznamu souborů.
  • FoldersFirst: Je-li nastaveno na YES, složky jsou uvedeny před soubory.
  • GenerateImgThumbs: Je-li nastaveno na YES, vytvoří soubory miniatur pro soubory obrázků.
  • GeneratePDFThumbs: Je-li nastaveno na YES, vytváří soubory miniatur pro soubory PDF.
  • GenerateVideoThumbs: Je-li nastaveno na YES, vytvoří soubory miniatur pro video soubory.
  • GetUploaderDesc: Je-li nastaveno na YES, zobrazí pole s popisem ve formuláři pro nahrávání.
  • GetUploaderInfo: Je-li nastaveno na YES, zobrazuje vstupy zadavatele ve formuláři pro nahrávání.
  • LabelDate: Textový řetězec použitý pro označení data.
  • LabelDesc: Textový řetězec použitý pro popisný štítek.
  • LabelName: Textový řetězec použitý pro jmenný štítek.
  • LabelOwner: Textový řetězec použitý pro štítek zadavatele.
  • LabelSize: Textový řetězec použitý pro štítek velikosti.
  • LabelThumb: Textový řetězec použitý pro označení miniatury.
  • ListTitle: Název seznamu.
  • MaxSize: Maximální velikost (v megabajtech) souboru, který lze nahrát.
  • Notify: Je-li nastaveno na YES, odešle e-mail s upozorněním na nahrání souboru.
  • NotifyBcc: Čárkami oddělený seznam e-mailových adres, na které má být odeslána skrytá kopie.
  • NotifyCc: Čárkami oddělený seznam e-mailových adres, na které má být kopie odeslána oznámení o nahrání.
  • NotifyFrom: E-mailová adresa, ze které se odesílá oznámení o nahrání.
  • NotifyFromName: Jméno odesílatele v e-mailu s oznámením o nahrání.
  • NotifyMessage: Tělo e-mailu s oznámením o nahrání.
  • NotifySubject: Předmět e-mailu s oznámením o nahrání.
  • NotifyTo: Čárkami oddělený seznam e-mailových adres, na které se má odeslat oznámení o nahrání.
  • PreserveName: Je-li nastaveno na YES, zachová a zobrazí původní název souboru.
  • PreserveSpaces: Je-li nastaveno na YES, převede pomlčky v názvech souborů na mezery.
  • ShowBreadCrumb: Je-li nastaveno na YES, zobrazuje drobečkovou stopu nad seznamem souborů.
  • ShowFileActions: Je-li nastaveno na YES, zobrazuje akce souboru jako Otevřít, Stáhnout atd.
  • ShowFileCopyLink: Je-li nastaveno na YES, ukazuje akci kopírování souboru.
  • ShowFileDate: Je-li nastaveno na YES, zobrazuje datum souboru.
  • ShowFileDateAs: Určuje, zda se má zobrazit datum přidání souboru nebo datum poslední změny.
  • ShowFileDesc: Je-li nastaveno na YES, zobrazí popis souboru.
  • ShowFileDownload: Je-li nastaveno na YES, zobrazí akci stahování souboru.
  • ShowFileExtension: Je-li nastaveno na YES, zobrazí příponu souboru.
  • ShowFileOpen: Je-li nastaveno na YES, ukazuje akci otevření souboru.
  • ShowFileSize: Je-li nastaveno na YES, ukazuje velikost souboru.
  • ShowFileThumb: Je-li nastaveno na YES, zobrazí miniaturu souboru.
  • ShowFolderSize: Je-li nastaveno na YES, ukazuje velikost složky.
  • ShowHeader: Je-li nastaveno na YES, zobrazí záhlaví tabulky seznamu souborů.
  • ShowList: Definuje, kdo může zobrazit seznam. Možnosti jsou ADMIN, USER, ALLnebo NO.
  • ShowListStyle: Definuje styl seznamu. Možná hodnota je TABLE.
  • ShowListTheme: Definuje barevné téma seznamu. Příklad hodnoty je Dark.
  • ShowSubmitterInfo: Je-li nastaveno na YES, zobrazuje informace o zadavateli.
  • ShowUploadLimits: Je-li nastaveno na YES, zobrazí ve formuláři informace o limitech nahrávání.
  • SmoothScroll: Je-li nastaveno na YES, umožňuje efekt hladkého posouvání po načtení stránky.
  • SortBy: Určuje kritéria řazení pro soubory. Možnosti jsou Name, Added, Changed, Sizenebo Random.
  • SortOrder: Určuje pořadí řazení. Možnosti jsou Descending or Ascending.
  • UploadConfirm: Je-li nastaveno na YES, zobrazí po nahrání stránku s výsledky. Li NO, vrátí se do seznamu.
  • UploadLimit: Počet souborů, které lze nahrát najednou.
  • UploadMaxFileSize: Maximální velikost souboru, který lze nahrát.
  • UploadPosition: Určuje, kde se má formulář zobrazit Above or Below seznam.
  • UseCache: Určuje, kdy se mají soubory znovu skenovat. Možnosti jsou EACH, DAY, HOUR, OFF.
  • UseCacheCron: Je-li nastaveno na YES, používá systém WordPress wp_cron.

Poznámka – Pro booleovské možnosti YES obvykle povolí funkci nebo možnost, zatímco NO zakáže to. U ostatních možností je hodnotou buď konkrétní řetězec, nebo číslo.

Přístup k datům nastavení

Pro přístup k jednotlivým datovým položkám se podívejte na jejich klíče:

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

Nastavení rozšíření

Pluginy rozšíření mohou přidat další možnosti nastavení.

Možnost vyhledávání a stránkování

Možnost přístupu k souboru

Možnosti odesílání souborů

Možnosti přehrávače médií

Zanechat komentář

Tyto stránky používají Akismet k omezení spamu. Zjistěte, jak jsou vaše údaje komentářů zpracovávány.