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 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.

FAQ

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 DocVault” توهان جي ٻولي ۾.

ڊولپمينٽ ۾ دلچسپي؟

ڪوڊ براؤز ڪريو، چيڪ ڪريو SVN مخزن، يا رڪنيت حاصل ڪريو ڊولپمينٽ لاگ پاران RSS.

لاگ تبدیل ڪريو

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