MINIMALIST Uploads for WPVibe

By mariancapota

10+ active installationsVersion 1.0.5

Upload documents to the WordPress Media Library with authenticated REST requests. Resume interrupted uploads and verify files with SHA-256.

Description

MINIMALIST Uploads for WPVibe lets WordPress administrators upload documents to the Media Library over HTTPS. Use WPVibe’s REST API tool or another authenticated REST client. This plugin is an independent extension and works without WPVibe.

  • Upload PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX, ODT, ODS, ODP, RTF, TXT, CSV and ZIP files, subject to your site’s allowed file types.
  • Send files up to 2 MiB in one request. For larger files, upload in resumable chunks up to your site’s WordPress upload limit. That limit also applies to single requests.
  • Verify files with SHA-256. If an existing Media Library file has matching contents and MIME type, the plugin can reuse it even if the filename has changed.

Privacy and external services

The plugin sends no telemetry and makes no outbound requests. Your REST client sends the file to your WordPress site. If you use WPVibe or another external service, its own privacy policy and terms apply.

Temporary files are stored in a private directory. Sessions are tied to the user who started the upload and expire after one hour of inactivity. WordPress clears expired sessions hourly through WP-Cron and before starting new uploads. Session records include the user ID, filename, title, file size, checksum, expiry time and, after import, the attachment ID.

Files imported into the Media Library are usually publicly accessible.

REST API

Send JSON to /wp-json/wpvibe-documents/v1 using your site’s REST authentication over HTTPS. The authenticated user must have both manage_options and upload_files.

  • POST /upload imports a file in one request. Send filename, sha256 and content_base64.
  • POST /start starts a resumable upload. Send filename, size in bytes and sha256. You can include the first chunk_base64 and set auto_finish to true.
  • POST /chunk appends data. Send upload_id, offset in bytes and chunk_base64. Use the chunk_bytes limit from the server response (currently 1 MiB before encoding). You can retry an identical chunk. Set auto_finish to true on the final chunk to import the file in the same request.
  • GET /status?upload_id=... returns the current offset or the completed attachment.
  • POST /finish verifies and imports the file. Send upload_id after all chunks have arrived.
  • POST /cancel cancels an unfinished upload. Send upload_id.

Use a plain filename, standard padded base64 and a 64-character lowercase hexadecimal SHA-256 checksum. A completed upload returns complete: true and an attachment with its ID, URL, title and MIME type.

Installation

  1. In WordPress, go to Plugins > Add New Plugin and search for MINIMALIST Uploads for WPVibe.
  2. Click Install Now, then Activate.
  3. Connect your REST client over HTTPS using an administrator account with upload permission.

The plugin has no settings screen. WordPress needs a writable temporary directory outside all public web paths and a working WP-Cron schedule for cleanup.

FAQ

What is the maximum file size?

Resumable uploads use your site’s WordPress upload limit, which depends on PHP and any site or multisite restrictions. A single request is limited to 2 MiB or your site’s lower limit. A proxy may impose a lower request limit.

What happens when I deactivate or uninstall the plugin?

Deactivation clears the cleanup schedule and temporary sessions for the current site. Uninstall also removes the plugin’s session records and checksum metadata across the site’s blogs. Completed Media Library uploads and published posts are retained.

Changelog

1.0.5

  • Check existing files by SHA-256 first so newer files with the same name cannot hide an identical upload.

1.0.4

  • Upload files up to 2 MiB in a single request.
  • Resume larger uploads in 1 MiB chunks. Send the first chunk when opening a session and finish on the last chunk to save requests.
  • Reuse matching Media Library files after a filename change.