Trilobita

Troubleshooting

Solutions to common issues with DocVault.

File Upload Issues

“File type not allowed” error

DocVault only accepts these file types: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, ODT, ODS, ODP, RTF, CSV, TXT.

If your file is one of these types but still rejected, check that the file extension matches the actual file type. Renaming a file (e.g., renaming a .txt to .pdf) won’t work—the plugin validates the actual file content.

“File too large” error

The maximum upload size is controlled by your server’s PHP settings, not the plugin. Check these values in your php.ini or contact your host:

  • upload_max_filesize — Maximum size of a single upload
  • post_max_size — Should be larger than upload_max_filesize
  • memory_limit — Should be larger than post_max_size

You can see your current limit at Media → Add New — WordPress displays “Maximum upload file size” at the bottom.

Upload appears to hang or times out

Large files may exceed your server’s execution time limit. Ask your host to increase max_execution_time in php.ini, or upload smaller files.

Download Issues

404 error when clicking download link

The plugin uses custom URL rewrite rules. Try these fixes:

  1. Go to Settings → Permalinks
  2. Click “Save Changes” (you don’t need to change anything)
  3. This flushes the rewrite rules

If that doesn’t work, deactivate and reactivate the plugin to re-register the rules.

“You do not have permission to access this document”

The document has access restrictions. Check:

  • Edit the document and check the Access Control settings
  • Verify the user is logged in (if set to “Logged-in users”)
  • Verify the user has the required role (Pro: if set to specific roles)
  • Check the global default access at Documents → Settings

Download starts but file is corrupted or empty

Usually caused by PHP output before the file download. Check for:

  • Blank lines or spaces before <?php in theme or plugin files
  • PHP errors being output (enable WP_DEBUG to check)
  • Caching plugins interfering—try excluding /trdv/download/ from cache

Shortcode Issues

Shortcode displays as plain text

The shortcode

Title Type Size Date Download
Valuation Report PDF 133.87 KB 1st April 2026 Download
Staff Handbook 2024 PDF 4.65 KB 1st April 2026 Download
Service Level Agreement 2024 PDF 4.25 KB 1st April 2026 Download
Employee Onboarding Policy V2 DOCX 8.17 KB 30th March 2026 Download
Employee Onboarding Policy DOCX 8.17 KB 1st April 2026 Download
Q4 2024 Business Review — — 24th February 2026 —
Employee Onboarding Policy — — 24th February 2026 —
Q3 2024 Board Meeting Minutes — — 24th February 2026 —
Project Timeline Tracker — — 24th February 2026 —
Service Level Agreement — — 24th February 2026 —
New Product Launch Strategy — — 24th February 2026 —
Staff Handbook — — 21st March 2024 —
Annual Budget 2024 — — 7th January 2024 —
appears as text instead of rendering the document table.

  • Verify the plugin is activated
  • Check for typos in the shortcode
  • Ensure you’re not inside a code block or preformatted text

Document table appears but no documents shown

  • Verify documents are published (not draft or pending)
  • Check if you’re filtering by category that has no documents:
    Title Type Size Date Download
    No documents found.
  • Verify documents have files attached (a document without an uploaded file won’t display)
  • Check access control—the current user may not have permission to view any documents

AJAX search not working

The search box appears but searching doesn’t filter results or shows an error.

  • Check browser console for JavaScript errors
  • Verify jQuery is loading (required by WordPress)
  • Check for plugin conflicts—try deactivating other plugins temporarily
  • Ensure your theme calls wp_footer() before </body>

Version History Issues

Old versions not appearing

In the free plugin, version history is limited to 5 versions. Older versions are automatically removed when you upload new ones. Upgrade to Pro for unlimited version history.

Restore not working

When clicking “Restore” on a previous version:

  • Check that the original file still exists in /wp-content/uploads/trdv-documents/
  • Verify you have permission to edit the document
  • Check browser console for AJAX errors

Pro-Specific Issues

Audit log is empty

The audit log only records events that happen after Pro is installed and activated. Historical events aren’t retroactively logged.

If new events aren’t appearing:

  1. Go to Documents → Settings
  2. Verify “Enable audit logging” is checked in Pro Features
  3. If logging downloads, verify “Log downloads in audit trail” is checked
  4. Deactivate and reactivate Pro to ensure the database table is created

Download statistics not showing detailed data

Download statistics appear in the document edit screen. If you only see “Total Downloads” without the detailed breakdown:

  • Detailed stats (downloads by version, recent downloads) require Pro
  • Data is only shown for documents with at least one download
  • Verify Pro is activated

Approval workflow not appearing

  • Go to Documents → Settings and enable “Enable approval workflow”
  • Select at least one approver role
  • Save settings

Email notifications not sending

  • Verify email notifications are enabled in settings
  • Check that recipient email addresses are correct
  • Test that WordPress can send email (try the password reset function)
  • Consider using an SMTP plugin if emails aren’t being delivered

Migration and Backup

Documents missing after site migration

When migrating to a new server or domain:

  1. Ensure /wp-content/uploads/trdv-documents/ was included in the migration
  2. Verify file permissions (755 for directories, 644 for files)
  3. Go to Settings → Permalinks and save to flush rewrite rules
  4. If URLs changed, run a search-replace on the database for old URLs

Restoring from backup

To fully restore DocVault:

  • Restore the database (includes document posts and metadata)
  • Restore /wp-content/uploads/trdv-documents/ (the actual files)
  • Restore /wp-content/uploads/ attachment entries if using WordPress media library references

Performance Issues

Document list loading slowly

With hundreds of documents:

Still Need Help?

Free plugin: Post on the WordPress.org support forum.

Pro plugin: Contact support with your license key.

When reporting issues, please include:

  • WordPress version
  • Plugin version (free and Pro if applicable)
  • PHP version
  • Steps to reproduce the issue
  • Any error messages (check browser console and PHP error log)