Title: Trilobita DocVault
Author: trilobita
Published: <strong>2026 年 3 月 13 日</strong>
Last modified: 2026 年 4 月 3 日

---

搜索插件

![](https://ps.w.org/trilobita-docvault/assets/banner-772x250.png?rev=3494322)

![](https://ps.w.org/trilobita-docvault/assets/icon-256x256.png?rev=3494322)

# Trilobita DocVault

 作者：[trilobita](https://profiles.wordpress.org/trilobita/)

[下载](https://downloads.wordpress.org/plugin/trilobita-docvault.1.3.9.zip)

 * [详情](https://cn.wordpress.org/plugins/trilobita-docvault/#description)
 * [评价](https://cn.wordpress.org/plugins/trilobita-docvault/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/trilobita-docvault/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/trilobita-docvault/#developers)

 [支持](https://wordpress.org/support/plugin/trilobita-docvault/)

## 描述

Trilobita DocVault is a WordPress document management plugin with version control
and a searchable document library. Upload and organise files in the admin, then 
share them with your team or site visitors — with a searchable, sortable document
table, Gutenberg block support, full version history, download tracking, and access
control.

**Key Features:**

 * **Version History** – Full version history with rollback, download, and delete
   for every document.
 * **Drag & Drop Upload** – Intuitive drag-and-drop file upload interface in the
   admin.
 * **Download Tracking** – Track download counts for all documents.
 * **Access Control** – Restrict documents to logged-in users only.
 * **Frontend Display** – Responsive shortcode-powered document table with AJAX 
   search, sortable columns, and pagination.
 * **Gutenberg Block** – Native block editor support for embedding documents.
 * **File Type Support** – PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, ODT, ODS, ODP, 
   RTF, CSV, TXT.
 * **Document Categories** – Hierarchical taxonomy for organizing documents.

#### Go further with Trilobita DocVault Pro

[Trilobita DocVault Pro](https://trilobita.co.uk/plugins/trilobita-docvault/pro/)
adds enterprise-grade features for teams that need more control:

 * **Unlimited Version History** – Remove the 5-version limit and keep complete 
   history for every document.
 * **Per-Document Access Control** – Restrict individual documents to specific user
   roles.
 * **Audit Trail** – Full activity log with CSV export for compliance and accountability.
 * **Email Notifications** – Configurable alerts for uploads, updates, and approvals.
 * **Document Approval Workflow** – Require documents to be reviewed before publishing.
 * **Bulk Upload** – Upload multiple documents at once with duplicate detection.
 * **Download Analytics** – Detailed per-version download statistics.
 * **Duplicate Detection** – Find and merge duplicate documents to save storage.
 * **Storage Management** – Advanced tools for monitoring and cleaning up storage.

### Privacy

Trilobita DocVault stores the following user data:

 * **Uploader user ID** – Stored as post meta (`_trdv_uploaded_by`) to track who
   uploaded each document version.
 * **Download logs** – When download tracking is enabled, the plugin records the
   downloader’s IP address, user ID (if logged in), and timestamp in a custom database
   table (`trdv_download_log`).

This data is handled in compliance with GDPR and CCPA:

 * The plugin registers with the WordPress privacy tools for data export and erasure
   requests.
 * A suggested privacy policy text is provided under Settings > Privacy.
 * IP addresses and download logs can be deleted via the WordPress personal data
   erasure tool.

### Usage

**Document Block (Gutenberg):**

Add a single document with a download button directly in the block editor:

 1. Click the + button to add a block
 2. Search for “DocVault Document”
 3. Select a document from the dropdown

Block options:

 * Layout: Full (with icon and download button) or Minimal (compact inline link)
 * Show/hide file type icon
 * Show/hide file info (type and size)
 * Alignment (left, center, right, wide)

**`[trdv_list]` — Document Table Shortcode:**

Display a searchable, sortable table of documents on any page or post:

    ```
    [trdv_list]
    ```

Parameters:

 * `category` – Filter by document category slug
 * `type` – Filter by file type (pdf, docx, etc.)
 * `orderby` – Sort by: date, title, size (default: date)
 * `order` – ASC or DESC (default: DESC)
 * `show_search` – Show search box: true/false (default: true)
 * `show_download` – Show download button: true/false (default: true)
 * `columns` – Columns to display: title, type, size, date (default: title,type,
   size,date)
 * `per_page` – Documents per page (default: 20)

Examples:

    ```
    [trdv_list type="pdf" orderby="title" order="ASC"]
    [trdv_list category="reports" show_search="false" columns="title,date"]
    ```

**Document Link Toolbar Button:**

Link any selected text to a document download without leaving the block editor:

 1. Select the text you want to turn into a download link
 2. Click the document icon in the formatting toolbar (“Trilobita DocVault Link”)
 3. Choose a document from the dropdown and click Apply

**`[trdv_link]` — Inline Document Link Shortcode:**

Insert a download link within any text:

    ```
    [trdv_link id="123"]Download the report[/trdv_link]
    ```

Parameters:

 * `id` (required) – The document ID
 * `new_tab` – Open in new tab: true/false (default: false)
 * `class` – Add custom CSS class

Examples:

    ```
    [trdv_link id="123"] - Uses document title as link text
    [trdv_link id="123"]Click here[/trdv_link] - Custom link text
    [trdv_link id="123" new_tab="true"]Download[/trdv_link] - Opens in new tab
    ```

## 屏幕截图

 * [[
 * Document list in admin showing file type, version count, size, and download stats.
 * [[
 * Add new document screen with drag-and-drop upload, access control, and categories.
 * [[
 * Version history metabox with restore and delete options.
 * [[
 * Frontend display with document blocks, shortcodes, and searchable table.
 * [[
 * Gutenberg block editor with Trilobita DocVault block settings.
 * [[
 * Document link toolbar button for linking selected text to a document download.

## 区块

该插件提供了 1 个区块.

 *   DocVault Document

## 安装

**From the WordPress plugin directory (recommended):**

 1. Go to Plugins > Add New in your WordPress admin.
 2. Search for “Trilobita DocVault”.
 3. Click Install Now, then Activate.
 4. Go to the new **Documents** menu in the admin sidebar and start uploading documents.

**Manual installation:**

 1. Upload the `trilobita-docvault` folder to `/wp-content/plugins/`.
 2. Activate the plugin through the ‘Plugins’ menu in WordPress.
 3. Go to the new **Documents** menu in the admin sidebar and start uploading documents.

## 常见问题

### What file types are supported?

Trilobita DocVault supports PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, ODT, ODS, ODP,
RTF, CSV, and TXT files.

### How does version control work?

From the Edit Document screen, you can upload new versions of a file. The plugin
keeps a full version history with the ability to download, restore, or delete any
previous version. By default, up to 5 versions per document are kept.

### How do I display documents on the frontend?

There are three ways:

 1. **DocVault Document block** — add a single document with a download button directly
    in the Gutenberg block editor.
 2. **`[trdv_list]` shortcode** — displays a searchable, sortable table of documents
    on any page or post.
 3. **`[trdv_link]` shortcode** — inserts an inline download link within any text. 
    You can also use the Trilobita DocVault Link toolbar button in the block editor
    to link selected text to a document without using a shortcode.

### Are download links secure?

Yes. Download links use the format `/trdv/download/{id}/` rather than a direct path
to the file. Every download request is handled by WordPress, which checks access
permissions before serving the file. The actual file location on the server is never
exposed. Restricted documents cannot be accessed by guessing a URL, and files are
always forced to download rather than opened inline in the browser.

### Can I restrict document access?

Yes, you can restrict documents to logged-in users only via the Settings page.

### Where are uploaded files stored?

Files are stored in `/wp-content/uploads/trdv-documents/` organized by year and 
month folders.

### How many versions are kept?

By default, up to 5 versions per document are kept. Older versions are automatically
removed when the limit is reached.

### Is the plugin translation-ready?

Yes, Trilobita DocVault is fully translatable. A `.pot` template file is included
in the plugin’s `languages/` folder to help you get started. Translation files should
be named `trilobita-docvault-{locale}.mo` (e.g. `trilobita-docvault-fr_FR.mo`) and
can be placed either in the plugin’s own `languages/` folder or in `/wp-content/
languages/plugins/`.

## 评价

此插件暂无评价。

## 贡献者及开发者

「Trilobita DocVault」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ trilobita ](https://profiles.wordpress.org/trilobita/)

[帮助将「Trilobita DocVault」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/trilobita-docvault)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/trilobita-docvault/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/trilobita-docvault/)，或通过[RSS](https://plugins.trac.wordpress.org/log/trilobita-docvault/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/trilobita-docvault/)。

## 更新日志

#### 1.3.9

 * Fixed download button text being hidden when the theme link colour matches the
   button background colour

#### 1.3.8

 * Fixed drag-and-drop upload not attaching the file on Publish/Update (title was
   pre-filled but file was silently discarded)
 * Fixed drag-and-drop: cancelling the version-limit confirmation dialog no longer
   silently queues the dropped file for upload

#### 1.3.7

 * Settings page redesigned with card layout matching Pro (File Storage, Categories,
   Access Control cards)
 * Block title corrected to “DocVault Document” in both PHP and JS registrations
 * Added support for ODT, ODS, ODP, RTF, CSV, and TXT file types
 * readme.txt: usage section reorganised, block and toolbar button documented, Pro
   section added, FAQ expanded

#### 1.3.6

 * Fixed version history upload dates stored in local time instead of UTC
 * Fixed version history dates displaying raw UTC string instead of converting to
   site timezone

#### 1.3.5

 * Improved folder structure locked-state warning to explain impact and what would
   be required to change it
 * Global “Specific roles” access option now shows an upgrade prompt for free users;
   existing saved configurations continue to be honoured
 * Help page: version limit note now hidden when Pro is active; Pro features section
   appended when Pro is active
 * Added trdv_help_page_after_content action hook for extensibility

#### 1.3.4

 * Fixed flat folder structure filename prefix going out of sync after version pruning
 * Fixed download log timestamps stored in local time instead of UTC
 * Added admin notice when uploads directory is not writable on activation

#### 1.3.3

 * Initial release on WordPress.org

#### 1.3.2

 * Fixed remaining WordPress Plugin Check warnings: corrected phpcs:ignore comment
   placement

#### 1.3.1

 * Fixed WordPress Plugin Check warnings: phpcs:ignore for unavoidable direct DB
   queries and slow query args
 * Fixed unprefixed variables in admin view templates (WordPress.NamingConventions.
   PrefixAllGlobals)
 * Applied wp_check_filetype_and_ext MIME type validation to non-AJAX upload path

#### 1.3.0

 * **Breaking change:** Renamed shortcode `[trdv_documents]` to `[trdv_list]` — 
   update any pages using the old shortcode
 * **Breaking change:** Renamed shortcode `[docvault_link]` to `[trdv_link]` — update
   any content using the old shortcode
 * Renamed plugin from Smart Document Manager to Trilobita DocVault
 * Fixed null dereference on get_post_status_object() in privacy exporter
 * Fixed incorrect log prefix in download tracker
 * Fixed custom upload directory filter firing without a valid document context
 * Improved MIME type handling: validates detected type against allowlist before
   sending Content-Type header
 * Validates file MIME type from actual file content rather than browser-supplied
   value on upload

#### 1.2.3

 * Added explicit file upload validation before processing
 * Added phpcs ignore comments for intentional code patterns
 * Addresses all three common WordPress.org rejection reasons

#### 1.2.2

 * Fixed all WordPress Plugin Check errors
 * Added translators comments for all placeholder strings
 * Fixed ordered placeholders for i18n compliance
 * Fixed unescaped output in frontend display
 * Fixed %i placeholder for WP 5.8 compatibility
 * Removed deprecated load_plugin_textdomain call
 * Updated Tested up to WordPress 6.9
 * Added phpcs ignore comments for intentional code patterns

#### 1.2.1

 * Added index.php to all directories for security
 * Added LICENSE.txt file
 * Added privacy disclosure section for IP logging
 * Moved inline styles and scripts to enqueued files
 * Generated translation template (.pot file)
 * Fixed wp_unslash() usage on POST data
 * Fixed $wpdb->prepare() in uninstall.php
 * Added upload directory protection (index.php, .htaccess)
 * Updated Tested up to 6.7.1

#### 1.2.0

 * Refactored plugin architecture for extensibility
 * Version history limited to 5 versions per document by default
 * Added E2E test suite with Playwright
 * Code cleanup and stability improvements

#### 1.1.0

 * Added role-based access control for documents
 * Added download tracking with statistics
 * Added Document block for Gutenberg editor
 * Added [trdv_link] shortcode for inline document links
 * Added Settings page with access control options
 * Added option to use WordPress categories or separate document categories
 * Improved security for file downloads
 * Fixed HTTP header injection vulnerability in downloads
 * Fixed path traversal protection using realpath validation

#### 1.0.0

 * Initial release
 * Custom post type for documents
 * File upload with drag-and-drop
 * Version history with rollback
 * Frontend shortcode display with AJAX search
 * Document categories taxonomy

## 额外信息

 *  版本 **1.3.9**
 *  最后更新：**3 天前**
 *  活跃安装数量 **80+**
 *  WordPress 版本 ** 5.8 或更高版本 **
 *  已测试的最高版本为 **6.9.4**
 *  PHP 版本 ** 7.4 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/trilobita-docvault/)
 * 标签
 * [document library](https://cn.wordpress.org/plugins/tags/document-library/)[document management](https://cn.wordpress.org/plugins/tags/document-management/)
   [document manager](https://cn.wordpress.org/plugins/tags/document-manager/)[file management](https://cn.wordpress.org/plugins/tags/file-management/)
   [version control](https://cn.wordpress.org/plugins/tags/version-control/)
 *  [高级视图](https://cn.wordpress.org/plugins/trilobita-docvault/advanced/)

## 评级

尚未提交反馈。

[添加我的评价](https://wordpress.org/support/plugin/trilobita-docvault/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/trilobita-docvault/reviews/)

## 贡献者

 *   [ trilobita ](https://profiles.wordpress.org/trilobita/)

## 支持

最近两个月解决的问题：

     总计 2，已解决 1

 [查看支持论坛](https://wordpress.org/support/plugin/trilobita-docvault/)