PROJECTO
Lista de arquivos simples armazena dados relacionados a uma lista de arquivos em dois lugares; a matriz da lista de arquivos a matriz de configurações da lista de arquivos. A matriz de configurações contém informações que definem como a lista de arquivos aparece e se comporta, enquanto a matriz de lista de arquivos contém informações sobre cada arquivo e pasta.
Este artigo deve ajudá-lo a entender as estruturas de array e como acessar os dados dentro delas. Você pode então criar funções personalizadas no arquivo functions.php do seu tema para permitir que você expanda a funcionalidade.
Configurações da lista de arquivos
Aqui está um exemplo para começar. Você pode acessar as configurações da lista de arquivos recuperando a opção correta do 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');
Isso retornará a matriz de configurações da lista de arquivos para ID de lista 1. Cada chave na matriz representa uma configuração específica e o valor associado à chave define o comportamento ou valor dessa configuração.
$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"
);
Aqui está uma explicação detalhada de cada par chave-valor na matriz:
AdminRole
: a função que pode acessar o menu de back-end.5
significa uma função de administrador, enquanto1
significa uma função de Assinante.AllowBulkFileDownload
: Um sinalizador para indicar se vários itens podem ser baixados como um arquivo ZIP. Os valores podem ser tantoYES
orNO
.AllowFolderDownload
: Um sinalizador que ativa ou desativa o download de pastas inteiras como um arquivo ZIP.AllowFrontManage
: permite que usuários front-end gerenciem itens de lista se definido comoYES
.AllowOverwrite
: Se definido paraYES
, permite que os arquivos enviados substituam os existentes.AllowUploads
: define quem pode fazer upload de arquivos. Os valores possíveis sãoADMIN
,USER
,ALL
ouNO
.FileFormats
: uma lista separada por vírgulas de extensões de arquivo que podem ser carregadas.FileListDir
: O diretório onde a lista de arquivos está localizada.FileListURL
: a URL para acessar a lista de arquivos.FoldersFirst
: Se definido paraYES
, as pastas são listadas antes dos arquivos.GenerateImgThumbs
: Se definido paraYES
, cria arquivos de miniatura para arquivos de imagem.GeneratePDFThumbs
: Se definido paraYES
, cria arquivos de miniaturas para arquivos PDF.GenerateVideoThumbs
: Se definido paraYES
, cria arquivos de miniaturas para arquivos de vídeo.GetUploaderDesc
: Se definido paraYES
, mostra a caixa de descrição no formulário de upload.GetUploaderInfo
: Se definido paraYES
, mostra as entradas do remetente no formulário de upload.LabelDate
: a string de texto usada para o rótulo de data.LabelDesc
: a string de texto usada para o rótulo de descrição.LabelName
: a string de texto usada para o rótulo do nome.LabelOwner
: a sequência de texto usada para o rótulo do remetente.LabelSize
: a string de texto usada para o rótulo de tamanho.LabelThumb
: a sequência de texto usada para o rótulo da miniatura.ListTitle
: O título da lista.MaxSize
: O tamanho máximo (em megabytes) de um arquivo que pode ser carregado.Notify
: Se definido paraYES
, envia um e-mail de notificação de upload de arquivo.NotifyBcc
: lista separada por vírgulas de endereços de e-mail para BCC a notificação de upload.NotifyCc
: lista separada por vírgulas de endereços de e-mail para enviar em CC a notificação de upload.NotifyFrom
: o endereço de e-mail do qual a notificação de upload é enviada.NotifyFromName
: o nome do remetente no e-mail de notificação de upload.NotifyMessage
: o corpo do e-mail de notificação de upload.NotifySubject
: a linha de assunto do e-mail de notificação de upload.NotifyTo
: lista separada por vírgulas de endereços de e-mail para enviar a notificação de upload.PreserveName
: Se definido paraYES
, preserva e exibe o nome do arquivo original.PreserveSpaces
: Se definido paraYES
, converte traços em nomes de arquivo em espaços.ShowBreadCrumb
: Se definido paraYES
, mostra a trilha de navegação acima da lista de arquivos.ShowFileActions
: Se definido paraYES
, mostra ações de arquivo como Abrir, Baixar, etc.ShowFileCopyLink
: Se definido paraYES
, mostra a ação de copiar arquivo.ShowFileDate
: Se definido paraYES
, mostra a data do arquivo.ShowFileDateAs
: Determina se deve exibir a data em que o arquivo foi adicionado ou a data em que foi alterado pela última vez.ShowFileDesc
: Se definido paraYES
, mostra a descrição do arquivo.ShowFileDownload
: Se definido paraYES
, mostra a ação de download do arquivo.ShowFileExtension
: Se definido paraYES
, mostra a extensão do arquivo.ShowFileOpen
: Se definido paraYES
, mostra a ação de abrir arquivo.ShowFileSize
: Se definido paraYES
, mostra o tamanho do arquivo.ShowFileThumb
: Se definido paraYES
, mostra a imagem em miniatura do arquivo.ShowFolderSize
: Se definido paraYES
, mostra o tamanho da pasta.ShowHeader
: Se definido paraYES
, mostra o cabeçalho da tabela da lista de arquivos.ShowList
: Define quem pode ver a lista. As opções sãoADMIN
,USER
,ALL
ouNO
.ShowListStyle
: Define o estilo da lista. O valor possível éTABLE
.ShowListTheme
: define o tema de cores da lista. Um exemplo de valor éDark
.ShowSubmitterInfo
: Se definido paraYES
, mostra as informações do remetente.ShowUploadLimits
: Se definido paraYES
, mostra as informações de limites de upload no formulário.SmoothScroll
: Se definido paraYES
, ativa o efeito de rolagem suave após o carregamento da página.SortBy
: determina os critérios de classificação dos arquivos. As opções sãoName
,Added
,Changed
,Size
ouRandom
.SortOrder
: Determina a ordem de classificação. As opções sãoDescending
orAscending
.UploadConfirm
: Se definido paraYES
, mostra uma página de resultados após o upload. SeNO
, ele retorna à lista.UploadLimit
: O número de arquivos que podem ser carregados de uma só vez.UploadMaxFileSize
: o tamanho máximo de um arquivo que pode ser carregado.UploadPosition
: Determina onde mostrar o formulário, sejaAbove
orBelow
a lista.UseCache
: Determina quando verificar novamente os arquivos. As opções sãoEACH
,DAY
,HOUR
,OFF
.UseCacheCron
: Se definido paraYES
, usa o sistema WordPress wp_cron.
Nota – Para as opções booleanas, YES
normalmente habilita o recurso ou opção, enquanto NO
o desativa. Para outras opções, o valor é uma string específica ou um número.
Acessando os dados de configuração
Para acessar itens de dados individuais, basta consultar suas chaves:
echo $myListSettings['ListTitle']; // Display the List Title
Configurações de extensão
Plugins de extensão podem adicionar opções de configurações adicionais.
Opção de Pesquisa e Paginação
Opção de acesso a arquivos
Opções de envio de arquivos
Opções do reprodutor de mídia