草稿
简单文件列表在两个地方存储与文件列表相关的数据; 文件列表数组 文件列表设置数组。 设置数组包含定义文件列表如何显示和行为的信息,而文件列表数组包含有关每个文件和文件夹的信息。
本文应该可以帮助您了解数组结构以及如何访问其中的数据。 然后,您可以在主题的 functions.php 文件中创建自定义函数,以扩展功能。
文件列表设置
这是一个入门示例。 您可以通过检索正确的 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');
这将返回列表 ID 1 的文件列表设置数组。数组中的每个键代表一个特定的设置,与键关联的值定义该设置的行为或值。
$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"
);
下面是对数组中每个键值对的详细解释:
AdminRole
:可以访问后台菜单的角色。5
表示管理员角色,而1
表示订阅者角色。AllowBulkFileDownload
:一个标志,表示是否可以将多个项目下载为 ZIP 文件。 这些值可以是YES
orNO
.AllowFolderDownload
:启用或禁用将整个文件夹下载为 ZIP 文件的标志。AllowFrontManage
: 如果设置为允许前端用户管理列表项YES
.AllowOverwrite
:如果设置为YES
, 允许上传的文件覆盖现有文件。AllowUploads
:定义谁可以上传文件。 可能的值是ADMIN
,USER
,ALL
或NO
.FileFormats
: 允许上传的文件扩展名的逗号分隔列表。FileListDir
:文件列表所在目录。FileListURL
: 访问文件列表的URL。FoldersFirst
:如果设置为YES
, 文件夹列在文件之前。GenerateImgThumbs
:如果设置为YES
, 为图像文件创建缩略图文件。GeneratePDFThumbs
:如果设置为YES
, 为 PDF 文件创建缩略图文件。GenerateVideoThumbs
:如果设置为YES
, 为视频文件创建缩略图文件。GetUploaderDesc
:如果设置为YES
, 显示上传表单上的描述框。GetUploaderInfo
:如果设置为YES
, 显示提交者在上传表单上的输入。LabelDate
:用于日期标签的文本字符串。LabelDesc
:用于描述标签的文本字符串。LabelName
:用于名称标签的文本字符串。LabelOwner
:用于提交者标签的文本字符串。LabelSize
:用于尺寸标签的文本字符串。LabelThumb
:用于缩略图标签的文本字符串。ListTitle
: 列表的标题。MaxSize
:可以上传的文件的最大大小(以兆字节为单位)。Notify
:如果设置为YES
, 发送文件上传通知邮件。NotifyBcc
: 以逗号分隔的电子邮件地址列表,用于密件抄送上传通知。NotifyCc
: 以逗号分隔的电子邮件地址列表,用于抄送上传通知。NotifyFrom
:发送上传通知的电子邮件地址。NotifyFromName
:上传通知邮件中的发件人姓名。NotifyMessage
:上传通知邮件的正文。NotifySubject
:上传通知电子邮件的主题行。NotifyTo
: 以逗号分隔的电子邮件地址列表,用于发送上传通知。PreserveName
:如果设置为YES
, 保留并显示原始文件名。PreserveSpaces
:如果设置为YES
, 将文件名中的破折号转换为空格。ShowBreadCrumb
:如果设置为YES
, 在文件列表上方显示痕迹。ShowFileActions
:如果设置为YES
, 显示文件操作,如打开、下载等。ShowFileCopyLink
:如果设置为YES
, 显示复制文件操作。ShowFileDate
:如果设置为YES
, 显示文件的日期。ShowFileDateAs
:确定是显示文件的添加日期还是上次更改的日期。ShowFileDesc
:如果设置为YES
, 显示文件的描述。ShowFileDownload
:如果设置为YES
, 显示下载文件操作。ShowFileExtension
:如果设置为YES
, 显示文件的扩展名。ShowFileOpen
:如果设置为YES
, 显示打开文件操作。ShowFileSize
:如果设置为YES
, 显示文件的大小。ShowFileThumb
:如果设置为YES
, 显示文件的缩略图。ShowFolderSize
:如果设置为YES
, 显示文件夹的大小。ShowHeader
:如果设置为YES
, 显示文件列表表头。ShowList
:定义谁可以看到列表。 选项是ADMIN
,USER
,ALL
或NO
.ShowListStyle
: 定义列表的样式。 可能的价值是TABLE
.ShowListTheme
:定义列表的颜色主题。 一个示例值是Dark
.ShowSubmitterInfo
:如果设置为YES
, 显示提交者的信息。ShowUploadLimits
:如果设置为YES
, 在表单上显示上传限制信息。SmoothScroll
:如果设置为YES
, 在页面加载后启用平滑滚动效果。SortBy
:确定文件的排序标准。 选项是Name
,Added
,Changed
,Size
或Random
.SortOrder
:确定排序的顺序。 选项是Descending
orAscending
.UploadConfirm
:如果设置为YES
, 显示上传后的结果页面。 如果NO
,它返回到列表。UploadLimit
:一次可以上传的文件数。UploadMaxFileSize
:可以上传的文件的最大大小。UploadPosition
: 确定在哪里显示表单,要么Above
orBelow
列表。UseCache
:确定何时重新扫描文件。 选项是EACH
,DAY
,HOUR
,OFF
.UseCacheCron
:如果设置为YES
, 使用 WordPress wp_cron 系统。
注意 – 对于布尔选项, YES
通常启用功能或选项,而 NO
禁用它。 对于其他选项,该值是特定字符串或数字。
访问设置数据
要访问单个数据项,只需参考它们的键:
echo $myListSettings['ListTitle']; // Display the List Title
扩展设置
扩展插件可能会添加额外的设置选项。
搜索和分页选项
文件访问选项
发送文件选项
媒体播放器选项