包简介

Export folders as ZIP archives with optional CSV manifests. Add-on for Virtual Media Folders.

README 文档

README

Add-on for Virtual Media Folders that lets you export folders (or subtrees) as ZIP archives with optional CSV manifests.

Features

ZIP export — export any folder as a downloadable ZIP archive with the original folder hierarchy preserved.
Include subfolders — optionally include all descendent folders in the export.
CSV manifest — generate a manifest with ID, filename, URL, alt text, caption, description, MIME type, file size, dimensions, date uploaded, and folder path.
Background processing — powered by Action Scheduler for large folders.
Automatic cleanup — expired exports are automatically removed after 24 hours.
Admin dashboard — React-based UI with folder picker, export options, progress tracking, and export history.
WP-CLI support — export, list, and clean up from the command line.

Requirements

Requirement	Version
WordPress	6.8+
PHP	8.3+
Virtual Media Folders	active

Installation

Recommended: Use the Add-On Manager to install the add-on.

Manual installation:

Download vmfa-folder-exporter.zip
Upload via Plugins → Add New → Upload Plugin
Activate via WordPress Admin → Plugins

Plugin updates are handled automatically via GitHub. No need to manually download and install updates.

Usage

Admin Dashboard

Navigate to Media → Virtual Folders → Folder Exporter. The dashboard provides:

Section	Purpose
Stats	Total available folders
Export Folder	Select a folder, choose options, start export
Progress	Real-time progress bar and download button
Recent Exports	History table with download/delete actions

Export Options

Option	Default	Description
Include subfolders	✅	Include all descendent folders in the ZIP
Include CSV manifest	✅	Add a `manifest.csv` file at the ZIP root

CSV Manifest Columns

Column	Description
ID	Attachment post ID
filename	Original filename
url	Full attachment URL
alt_text	Image alt text
caption	Attachment caption
description	Attachment description
mime_type	MIME type (e.g., `image/jpeg`)
file_size_bytes	File size in bytes
width	Image width in pixels (if applicable)
height	Image height in pixels (if applicable)
date_uploaded	Upload date
folder_path	Virtual folder path (e.g., `Photos/2025/Summer`)

WP-CLI

wp vmfa-export folders                # List folders with IDs
wp vmfa-export folders --format=json
wp vmfa-export folder 42              # Export folder ID 42 as ZIP
wp vmfa-export folder 42 --output=/tmp/photos.zip
wp vmfa-export folder 42 --no-children
wp vmfa-export folder 42 --no-manifest
wp vmfa-export list                   # List recent exports
wp vmfa-export list --format=json
wp vmfa-export clean                  # Remove expired exports
wp vmfa-export clean --all            # Remove all exports

Use wp vmfa-export folders to find the folder ID needed by wp vmfa-export folder <id>. The ID is also visible in the admin folder picker.

Developer Documentation

See docs/DEVELOPER.md for filters, REST API reference with examples, WP-CLI details, and build/test instructions.

License

GPL-2.0-or-later

soderlind/vmfa-folder-exporter 适用场景与选型建议

soderlind/vmfa-folder-exporter 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 0 次下载、GitHub Stars 达 1，最近一次更新时间为 2026 年 04 月 20 日，在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 soderlind/vmfa-folder-exporter 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 soderlind/vmfa-folder-exporter 我们能提供哪些服务？

定制开发 / 二次开发

基于 soderlind/vmfa-folder-exporter 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

soderlind/vmfa-folder-exporter

包简介