{"id":391957,"date":"2026-11-05T09:43:32","date_gmt":"2026-11-05T09:43:32","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/trilobita-docvault-migrator\/"},"modified":"2026-11-05T09:42:59","modified_gmt":"2026-11-05T09:42:59","slug":"trilobita-docvault-migrator","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/trilobita-docvault-migrator\/","author":237694,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.11.2","stable_tag":"1.11.2","tested":"7.1.4","requires":"6.5","requires_php":"7.4","requires_plugins":null,"header_name":"Trilobita DocVault Migrator","header_author":"Trilobita","header_description":"Migrates documents from WordPress Download Manager to Trilobita DocVault and keeps old download links and shortcodes working. Requires Trilobita DocVault; DocVault Pro adds support for more file types.","assets_banners_color":"3c3159","last_updated":"2026-11-05 09:42:59","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/trilobita.co.uk\/trilobita-docvault","header_author_uri":"https:\/\/trilobita.co.uk","rating":0,"author_block_rating":0,"active_installs":0,"downloads":124,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.11.2":{"tag":"1.11.2","author":"trilobita","date":"2026-11-05 09:42:59","revision":3785648}},"upgrade_notice":{"1.11.0":"<p>Security hardening for migrations from another WordPress install. Requires WordPress 6.5 or later.<\/p>","1.10.2":"<p>Security hardening for migrations from another WordPress install.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3785706,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3785706,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3785706,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3785706,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.11.2"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[9054,4721,8848,87,4155],"plugin_category":[59],"plugin_contributors":[257688],"plugin_business_model":[],"class_list":["post-391957","plugin","type-plugin","status-publish","hentry","plugin_tags-documents","plugin_tags-download-manager","plugin_tags-file-manager","plugin_tags-import","plugin_tags-migration","plugin_category-utilities-and-tools","plugin_contributors-trilobita","plugin_committers-trilobita"],"banners":{"banner":"https:\/\/ps.w.org\/trilobita-docvault-migrator\/assets\/banner-772x250.png?rev=3785706","banner_2x":"https:\/\/ps.w.org\/trilobita-docvault-migrator\/assets\/banner-1544x500.png?rev=3785706","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/trilobita-docvault-migrator\/assets\/icon-128x128.png?rev=3785706","icon_2x":"https:\/\/ps.w.org\/trilobita-docvault-migrator\/assets\/icon-256x256.png?rev=3785706","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Trilobita DocVault Migrator moves your downloads from another download plugin into <a href=\"https:\/\/wordpress.org\/plugins\/trilobita-docvault\/\">Trilobita DocVault<\/a>. It copies the files, titles, descriptions, categories, download counts, expiry dates and access settings, and records where each document came from so your old links can keep working.<\/p>\n\n<p>WordPress Download Manager is a third-party plugin. This plugin is not affiliated with or endorsed by its developers; Trilobita DocVault and this migrator are developed by Trilobita.<\/p>\n\n<p>Your existing plugin's data and files are never changed: everything is copied, so you can check the result before you switch the old plugin off.<\/p>\n\n<p><strong>Supported sources:<\/strong><\/p>\n\n<ul>\n<li><strong>WordPress Download Manager<\/strong> - on the same site, or on another WordPress install on the same server.<\/li>\n<\/ul>\n\n<p><strong>How it works:<\/strong><\/p>\n\n<ol>\n<li><strong>Configure<\/strong> - choose the source plugin and where it is installed.<\/li>\n<li><strong>Preview<\/strong> - a dry run checks every package and file and shows what will be imported, what will be skipped and why. Nothing is written.<\/li>\n<li><strong>Migrate<\/strong> - documents are created in batches, with a progress bar. Afterwards you can download a CSV log, or roll the migration back.<\/li>\n<\/ol>\n\n<p><strong>What is migrated:<\/strong><\/p>\n\n<ul>\n<li>Title, description and excerpt<\/li>\n<li>Files, copied into DocVault and registered as the first version<\/li>\n<li>Tags (WordPress Download Manager)<\/li>\n<li>Categories, with one level of parent category. An existing category with the same slug is reused only if it holds nothing but documents; otherwise a separate \"(documents)\" category is created, so documents are never mixed into your blog categories.<\/li>\n<li>Download counts<\/li>\n<li>Expiry dates (WordPress Download Manager)<\/li>\n<li>Access settings: public, logged-in users only, or specific user roles<\/li>\n<\/ul>\n\n<p><strong>Keep old links working:<\/strong> with Trilobita DocVault 1.6.0 or later, old WordPress Download Manager download links, package, category and tag shortcodes, and package, download, category and tag URLs keep working after migration, without editing your pages. With earlier DocVault versions the documents still migrate, and the old links start working once DocVault is updated, without migrating again.<\/p>\n\n<p><strong>Multi-file packages:<\/strong> WordPress Download Manager packages can hold several files. Choose one DocVault document per file (recommended), or the first file only.<\/p>\n\n<p><strong>File types:<\/strong> free DocVault accepts PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, ODT, ODS, ODP, RTF, CSV and TXT. The dry run lists any files of other types and says which ones Trilobita DocVault Pro can add (images, ZIP, AI and EPS). DocVault Pro is not required.<\/p>\n\n<p><strong>Not migrated:<\/strong> email, password, social and form locks, payment, quota and download limit settings, and per-download history (the total count is kept). Packages that use these are noted in the log.<\/p>\n\n<h3>Privacy<\/h3>\n\n<p>The migrator does not send any data to external services. It stores a migration log (document titles, IDs and notes) in your WordPress database, which is removed when you delete the plugin. It does not collect or store personal data about visitors.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate <a href=\"https:\/\/wordpress.org\/plugins\/trilobita-docvault\/\">Trilobita DocVault<\/a> 1.4.4 or later.<\/li>\n<li>Install and activate Trilobita DocVault Migrator from <strong>Plugins &gt; Add New<\/strong>, or upload the <code>trilobita-docvault-migrator<\/code> folder to <code>\/wp-content\/plugins\/<\/code>.<\/li>\n<li>Go to <strong>Documents &gt; Migrate to DocVault<\/strong>.<\/li>\n<li>Choose your source, click <strong>Connect &amp; Preview<\/strong>, review the dry run, then click <strong>Run Migration<\/strong>.<\/li>\n<\/ol>\n\n<p>Back up your site before migrating.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20the%20migrator%20change%20my%20existing%20download%20plugin%3F\"><h3>Does the migrator change my existing download plugin?<\/h3><\/dt>\n<dd><p>No. It only reads from the source plugin and copies its files. Its data, files and pages are left as they are.<\/p><\/dd>\n<dt id=\"will%20my%20old%20download%20links%20still%20work%3F\"><h3>Will my old download links still work?<\/h3><\/dt>\n<dd><p>Yes, with Trilobita DocVault 1.6.0 or later: DocVault uses the information the migrator records to point old links, shortcodes and URLs at the migrated documents. Your pages are not edited.<\/p>\n\n<p>With an earlier DocVault version, the migration still works and the information is recorded, but old links only start working after you update DocVault to 1.6.0 or later. You do not need to migrate again. The migrator page shows a notice while DocVault is older than 1.6.0.<\/p><\/dd>\n<dt id=\"wordpress%20download%20manager%20is%20on%20another%20site.%20can%20i%20still%20migrate%3F\"><h3>WordPress Download Manager is on another site. Can I still migrate?<\/h3><\/dt>\n<dd><p>Yes, if both sites are on the same server. Choose \"Another WordPress install on this server\" and enter the path to that site's WordPress folder (the one containing <code>wp-config.php<\/code>). The migrator reads that site's database connection details from <code>wp-config.php<\/code>, connects to its database to read packages only, and copies the files. The connection details are used only during the request and are never stored, logged or sent to the browser.<\/p><\/dd>\n<dt id=\"some%20files%20were%20skipped.%20why%3F\"><h3>Some files were skipped. Why?<\/h3><\/dt>\n<dd><p>The dry run gives a reason for every skipped file: usually the file is missing from disk, or its type is not allowed in DocVault. Files that DocVault Pro could accept are listed separately.<\/p><\/dd>\n<dt id=\"my%20site%20has%20very%20large%20files.%20will%20the%20migration%20time%20out%3F\"><h3>My site has very large files. Will the migration time out?<\/h3><\/dt>\n<dd><p>The migrator works in small batches and ends each batch early once it has run for 20 seconds (less if your server's PHP time limit is lower), then continues in the next request. A single file still has to be copied in one request, so a very large file on a server with a very short time limit can still time out; in that case, ask your host to raise the PHP time limit for the migration.<\/p><\/dd>\n<dt id=\"can%20i%20try%20it%20on%20a%20few%20items%20first%3F\"><h3>Can I try it on a few items first?<\/h3><\/dt>\n<dd><p>Yes. On the Configure step, enter a number under <strong>Test run<\/strong> to migrate only the first files that are ready to migrate (oldest first; files that cannot be migrated are skipped and do not count). Check the result, then roll the test back before migrating everything, otherwise those files are migrated twice.<\/p><\/dd>\n<dt id=\"can%20i%20undo%20a%20migration%3F\"><h3>Can I undo a migration?<\/h3><\/dt>\n<dd><p>Yes. The final step has a rollback button that deletes the documents and files the migration created. Once no migrated documents of a source plugin are left, it also deletes the empty categories the migration created and the information DocVault used to keep that plugin's old links working. Categories that already existed are kept. Rollback uses the migration log, so keep the migrator installed until you are happy with the result.<\/p><\/dd>\n<dt id=\"what%20happens%20if%20i%20run%20the%20migration%20twice%3F\"><h3>What happens if I run the migration twice?<\/h3><\/dt>\n<dd><p>Each run creates new documents, so running it twice creates duplicates. Roll back the first run before running it again.<\/p><\/dd>\n<dt id=\"are%20access%20restrictions%20kept%3F\"><h3>Are access restrictions kept?<\/h3><\/dt>\n<dd><p>Yes. Public and logged-in-only settings are kept. Role restrictions are kept and enforced by free DocVault; viewing or changing the roles in the document editor needs DocVault Pro.<\/p><\/dd>\n<dt id=\"can%20i%20delete%20the%20migrator%20afterwards%3F\"><h3>Can I delete the migrator afterwards?<\/h3><\/dt>\n<dd><p>Yes. Deleting it removes its own settings and log. The documents stay, and so does the source information DocVault uses to keep old links working.<\/p><\/dd>\n<dt id=\"who%20can%20run%20a%20migration%3F\"><h3>Who can run a migration?<\/h3><\/dt>\n<dd><p>Administrators only (the <code>manage_options<\/code> capability).<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.11.2<\/h4>\n\n<ul>\n<li>Change: the notices shown when Trilobita DocVault is missing or too old now appear only on the Plugins screen, and the one-time access-repair notice can be dismissed.<\/li>\n<\/ul>\n\n<h4>1.11.1<\/h4>\n\n<ul>\n<li>Change: \"Tested up to\" is declared in the readme only, as WordPress.org requires.<\/li>\n<\/ul>\n\n<h4>1.11.0<\/h4>\n\n<ul>\n<li>New: a notice on the migrator page when Trilobita DocVault is older than 1.6.0, explaining that old links start working once DocVault is updated.<\/li>\n<li>Security: source file paths can no longer point outside the WordPress Download Manager upload folder.<\/li>\n<li>Security: the table prefix read from another site's wp-config.php is validated before use.<\/li>\n<li>Fix: malformed data in the source database can no longer stop a preview or migration.<\/li>\n<li>New: records the rules Trilobita DocVault 1.6.0 needs to keep old WordPress Download Manager shortcodes and URLs working. Sites migrated with 1.10.0 to 1.10.2 get them automatically on update.<\/li>\n<li>New: asks for confirmation before migrating from a second site of the same plugin, because old links from two sites can collide.<\/li>\n<li>New: WordPress Download Manager tags are migrated, and old tag shortcodes and tag pages keep working.<\/li>\n<li>New: test run. Migrate only the first few files that are ready to migrate, check the result, roll it back, then migrate everything.<\/li>\n<li>New: rollback also removes the categories the migration created (if empty) and the information DocVault used to keep the old links working, so the site is back to how it was before the migration.<\/li>\n<li>Change: batches end early when a package has very large files, so a migration no longer risks a PHP timeout on shared hosting.<\/li>\n<li>Change: documents are no longer added to an existing category that holds other content, such as blog posts. A separate \"(documents)\" category is created instead, and the preview tells you which.<\/li>\n<li>Change: requires WordPress 6.5 or later.<\/li>\n<li>Removed: WP Filebase support and the Filebase References page. WP Filebase has not been maintained for years.<\/li>\n<li>Change: code tidy-ups for WordPress.org.<\/li>\n<li>Fix: all admin messages can now be translated.<\/li>\n<\/ul>\n\n<h4>1.10.2<\/h4>\n\n<ul>\n<li>Security: package data read from the source database can no longer create PHP objects.<\/li>\n<\/ul>\n\n<h4>1.10.1<\/h4>\n\n<ul>\n<li>New: categories record their original slug, so DocVault can redirect old category URLs.<\/li>\n<\/ul>\n\n<h4>1.10.0<\/h4>\n\n<ul>\n<li>New: every migrated document and category records its source, so Trilobita DocVault can keep old links, shortcodes and URLs working.<\/li>\n<li>Fix: categories were not migrated on sites where DocVault uses the standard post categories.<\/li>\n<li>Fix: \"first file only\" migrations recorded incomplete log entries.<\/li>\n<li>Fix: Filebase References could match documents migrated from WordPress Download Manager.<\/li>\n<li>Change: DocVault Pro is no longer required. The dry run shows which skipped file types Pro can add.<\/li>\n<\/ul>\n\n<h4>1.9.11<\/h4>\n\n<ul>\n<li>Fix: role restrictions from WordPress Download Manager are now saved correctly. Documents migrated with earlier versions are repaired automatically.<\/li>\n<\/ul>","raw_excerpt":"Import documents from WordPress Download Manager into Trilobita DocVault and keep old links working. Preview everything in a dry run first.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/391957","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=391957"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/trilobita"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=391957"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=391957"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=391957"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=391957"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=391957"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=391957"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}