LUONNOS

Yksinkertainen tiedostoluettelo tallentaa tiedostoluetteloon liittyvät tiedot kahteen paikkaan; tiedostoluettelotaulukko tiedostoluettelon asetustaulukko. Asetustaulukko sisältää tietoja, jotka määrittävät tiedostoluettelon ulkoasun ja toiminnan, kun taas tiedostoluettelotaulukko sisältää tietoja jokaisesta tiedostosta ja kansiosta.

Tämän artikkelin pitäisi auttaa sinua ymmärtämään taulukkorakenteita ja niiden sisältämien tietojen käyttöä. Voit sitten luoda mukautettuja toimintoja teemasi functions.php-tiedostoon, jotta voit laajentaa toimintoja.

Tiedostoluettelon asetukset

Tässä on esimerkki, jolla pääset alkuun. Pääset tiedostoluettelon asetuksiin hakemalla oikean WordPress-vaihtoehdon:

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ä palauttaa tiedostoluettelon asetustaulukon listalle ID 1. Jokainen taulukon avain edustaa tiettyä asetusta, ja avaimeen liittyvä arvo määrittää kyseisen asetuksen käyttäytymisen tai arvon.

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

Tässä on yksityiskohtainen selitys kustakin taulukon avainarvoparista:

• AdminRole: Rooli, joka voi käyttää taustavalikkoa. 5 tarkoittaa järjestelmänvalvojan roolia, kun taas 1 tarkoittaa Tilaajan roolia.
• AllowBulkFileDownload: Lippu, joka ilmaisee, voidaanko useita kohteita ladata ZIP-tiedostona. Arvot voivat olla joko YES or NO.
• AllowFolderDownload: Lippu, joka ottaa käyttöön tai poistaa käytöstä kokonaisten kansioiden lataamisen ZIP-tiedostona.
• AllowFrontManage: Antaa käyttöliittymän käyttäjien hallita luettelokohteita, jos se on asetettu YES.
• AllowOverwrite: Jos asetettu arvoon YES, sallii ladattujen tiedostojen korvata olemassa olevat tiedostot.
• AllowUploads: määrittää, kuka voi lähettää tiedostoja. Mahdollisia arvoja ovat ADMIN, USER, ALLtai NO.
• FileFormats: Pilkuilla eroteltu luettelo tiedostopäätteistä, jotka voidaan ladata.
• FileListDir: Hakemisto, jossa tiedostoluettelo sijaitsee.
• FileListURL: URL-osoite tiedostoluettelon avaamiseksi.
• FoldersFirst: Jos asetettu arvoon YES, kansiot luetellaan ennen tiedostoja.
• GenerateImgThumbs: Jos asetettu arvoon YES, luo pikkukuvatiedostoja kuvatiedostoille.
• GeneratePDFThumbs: Jos asetettu arvoon YES, luo pikkukuvatiedostoja PDF-tiedostoille.
• GenerateVideoThumbs: Jos asetettu arvoon YES, luo pikkukuvatiedostoja videotiedostoille.
• GetUploaderDesc: Jos asetettu arvoon YES, näyttää kuvausruudun latauslomakkeessa.
• GetUploaderInfo: Jos asetettu arvoon YES, näyttää lähettäjän syötteet latauslomakkeessa.
• LabelDate: Päivämäärätunnisteessa käytetty tekstimerkkijono.
• LabelDesc: Kuvaustunnisteessa käytetty tekstimerkkijono.
• LabelName: Nimitunnisteessa käytetty tekstimerkkijono.
• LabelOwner: Lähettäjätunnisteessa käytetty tekstimerkkijono.
• LabelSize: Kokotarrassa käytetty tekstimerkkijono.
• LabelThumb: Pikkukuvatunnisteessa käytetty tekstimerkkijono.
• ListTitle: Luettelon otsikko.
• MaxSize: Ladattavan tiedoston enimmäiskoko (megatavuina).
• Notify: Jos asetettu arvoon YES, lähettää tiedoston latausilmoituksen sähköpostitse.
• NotifyBcc: Pilkuilla eroteltu luettelo sähköpostiosoitteista, joille lähetysilmoitus on piilotettu.
• NotifyCc: Pilkuilla eroteltu luettelo sähköpostiosoitteista, joihin lähetysilmoitus lähetetään.
• NotifyFrom: Sähköpostiosoite, josta lähetysilmoitus lähetetään.
• NotifyFromName: Lähettäjän nimi latausilmoitussähköpostissa.
• NotifyMessage: Lähetysilmoituksen tekstiosa.
• NotifySubject: latausilmoituksen aiherivi.
• NotifyTo: Pilkuilla eroteltu luettelo sähköpostiosoitteista, joihin latausilmoitus lähetetään.
• PreserveName: Jos asetettu arvoon YES, säilyttää ja näyttää alkuperäisen tiedostonimen.
• PreserveSpaces: Jos asetettu arvoon YES, muuntaa tiedostonimien viivat välilyönneiksi.
• ShowBreadCrumb: Jos asetettu arvoon YES, näyttää navigointipolun tiedostoluettelon yläpuolella.
• ShowFileActions: Jos asetettu arvoon YES, näyttää tiedostotoiminnot, kuten Avaa, Lataa jne.
• ShowFileCopyLink: Jos asetettu arvoon YES, näyttää tiedoston kopiointitoiminnon.
• ShowFileDate: Jos asetettu arvoon YES, näyttää tiedoston päivämäärän.
• ShowFileDateAs: Määrittää, näytetäänkö tiedoston lisäyspäivä vai päivämäärä, jolloin sitä viimeksi muutettiin.
• ShowFileDesc: Jos asetettu arvoon YES, näyttää tiedoston kuvauksen.
• ShowFileDownload: Jos asetettu arvoon YES, näyttää tiedoston lataustoiminnon.
• ShowFileExtension: Jos asetettu arvoon YES, näyttää tiedoston tunnisteen.
• ShowFileOpen: Jos asetettu arvoon YES, näyttää tiedoston avaamisen.
• ShowFileSize: Jos asetettu arvoon YES, näyttää tiedoston koon.
• ShowFileThumb: Jos asetettu arvoon YES, näyttää tiedoston pikkukuvan.
• ShowFolderSize: Jos asetettu arvoon YES, näyttää kansion koon.
• ShowHeader: Jos asetettu arvoon YES, näyttää tiedostoluettelotaulukon otsikon.
• ShowList: Määrittää, ketkä voivat nähdä luettelon. Vaihtoehdot ovat ADMIN, USER, ALLtai NO.
• ShowListStyle: Määrittää luettelon tyylin. Mahdollinen arvo on TABLE.
• ShowListTheme: Määrittää luettelon väriteeman. Esimerkkiarvo on Dark.
• ShowSubmitterInfo: Jos asetettu arvoon YES, näyttää lähettäjän tiedot.
• ShowUploadLimits: Jos asetettu arvoon YES, näyttää lomakkeen latausrajoitukset.
• SmoothScroll: Jos asetettu arvoon YES, mahdollistaa tasaisen vieritystehosteen sivun latauksen jälkeen.
• SortBy: Määrittää tiedostojen lajittelukriteerit. Vaihtoehdot ovat Name, Added, Changed, Sizetai Random.
• SortOrder: Määrittää lajittelujärjestyksen. Vaihtoehdot ovat Descending or Ascending.
• UploadConfirm: Jos asetettu arvoon YES, näyttää tulossivun latauksen jälkeen. Jos NO, se palaa luetteloon.
• UploadLimit: Kerralla ladattavien tiedostojen määrä.
• UploadMaxFileSize: Ladattavan tiedoston enimmäiskoko.
• UploadPosition: määrittää, missä lomake näytetään joko Above or Below lista.
• UseCache: Määrittää, milloin tiedostot skannataan uudelleen. Vaihtoehdot ovat EACH, DAY, HOUR, OFF.
• UseCacheCron: Jos asetettu arvoon YES, käyttää WordPress wp_cron -järjestelmää.

Huomautus – Boolen vaihtoehdot YES yleensä ottaa ominaisuuden tai vaihtoehdon käyttöön, kun taas NO poistaa sen käytöstä. Muissa vaihtoehdoissa arvo on joko tietty merkkijono tai numero.

Asetustietojen käyttäminen

Pääset yksittäiseen tietokohteeseen katsomalla niiden avaimia:

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

Laajennusasetukset

Laajennuslaajennukset voivat lisätä asetusvaihtoehtoja.

Haku- ja sivutusvaihtoehto

Tiedoston käyttöoikeus

Lähetä tiedostot -asetukset

Mediasoittimen asetukset