Migrating away from the legacy File Away plugin is one of the most critical steps WordPress site administrators must take to ensure compatibility with PHP 8.x and WordPress 6.x+.
This step-by-step migration guide walks you through safely auditing legacy files, transferring document libraries into Simple File Vault, replacing deprecated shortcodes with modern Gutenberg blocks, and configuring advanced client portal security.
📋 Migration Overview
Migrating from File Away to Simple File Vault requires zero database schema conversions. Because Simple File Vault utilizes native directory storage, physical files can simply be moved into the secure vault location and indexed instantly.
[Audit File Away Shortcodes] ➔ [Install Simple File Vault] ➔ [Move Files to /safe-vault/] ➔ [Embed New Blocks/Shortcodes] ➔ [Deactivate File Away]
Step 1: Pre-Migration Audit
Before deactivating File Away, identify your active file directories and shortcode usage:
- Locate Shortcodes: Search your pages and templates for legacy shortcodes:
[fileaway][fileup][fileaway-values]
- Note Target Directories: Check what subdirectories File Away was reading from (commonly
wp-content/uploads/or custom root folders like/client-files/). - Identify User Restrictions: Note if any directories were restricted to specific WordPress user roles or user IDs.
Step 2: Install Simple File Vault
- Free Version: Navigate to Plugins > Add New in your WordPress dashboard, search for Simple File Vault, and click Install Now and Activate.
- Pro Version (For Subfolders & User Isolation): If your File Away setup used subdirectories, user directories, or bulk downloads, install and activate Simple File Vault Pro to unlock unlimited nested folders, user isolation, and AJAX search.
Step 3: Relocate Files to the Secure Vault Directory
Simple File Vault stores all files in an isolated, secure directory located outside the standard WordPress media library:
wp-content/uploads/safe-vault/
File Transfer Methods:
- Via FTP / SFTP / File Manager: Move your legacy files and subdirectories directly into
/wp-content/uploads/safe-vault/. - Flat Vaults (Free): Place all documents directly into
/safe-vault/. - Nested Subfolders (Pro): Recreate your folder hierarchy (e.g.,
/safe-vault/contracts/,/safe-vault/invoices/). - Auto-Syncing: In Simple File Vault Pro, navigate to the Housekeeping & Sync dashboard to instantly scan and register external FTP files into the performance transient cache.
Step 4: Replace Shortcodes with Gutenberg Blocks or Simple Shortcodes
Replace legacy [fileaway] shortcodes with native Gutenberg blocks or Simple File Vault shortcodes:
Option A: Gutenberg Block Editor (Recommended)
- Open your portal page in the WordPress block editor.
- Remove the legacy shortcode block.
- Click (+) Add Block and insert the Safe File Vault block (includes both uploader and file table) or individual File Uploader / File Table blocks.
- In the right-hand Block Settings Sidebar, configure your preferences:
- Toggle Uploader Metadata (Name, Email, Comments).
- Set Max Files to Display (limit constraints).
- Choose Layout Modes (List Table, Tiles Grid, or Flex Mobile in Pro).
Option B: Shortcode Replacement
If you are using classic editors, page builders (Elementor, Divi, Beaver Builder), or PHP templates, replace legacy shortcodes:
<!-- Full Portal (Upload Form + File List) --> sfvlt_safe_file_vault <!-- Dedicated File List Table --> sfvlt_file_table orderby="date" order="desc"
Step 5: Replicate User Directories (User Isolation Mode)
In File Away, user-specific directories were typically created using custom directory path rules. In Simple File Vault Pro, this is completely automated:
- Edit your client portal page in the block editor.
- Select the Safe File Vault block.
- In the sidebar, enable User Isolation Mode.
- How It Works: When a client uploads a document, the plugin automatically associates and isolates the file to their WordPress user ID. When logged-in users visit the portal, they only see their own uploaded files, while administrators retain full global visibility.
Step 6: Enable Modern Enhancements
Take advantage of modern capabilities not available in legacy File Away:
- Interactive Live Previews: Clients can now inspect PDFs, images, and stream audio/video (
mp4,mp3,webm) in an instant browser lightbox without forced downloads. - Automated Upload Notifications: Go to Simple File Vault > Settings and configure instant HTML email alerts for administrators and clients upon successful upload.
- Real-Time Webhooks: Connect your file vault to Slack, Discord, Microsoft Teams, or Zapier to notify your team when new client files arrive.
- Download Countdown Gatehouse: Enforce a custom countdown timer before file downloads initiate.
Step 7: Deactivate & Decommission File Away
Once your pages are tested and files are displaying properly:
- Navigate to Plugins > Installed Plugins in your WordPress dashboard.
- Deactivate and Delete the legacy File Away plugin.
- Confirm that your error logs are now free of PHP 8 deprecation warnings.
🔗 Useful Links & Resources
- 🌐 Live Demo: Experience the Simple File Vault Live Demo
- 📦 Free Plugin on WordPress.org: Download Simple File Vault Free
- ⚡ Upgrade to Pro: Get Simple File Vault Pro Bundle
