WordPress - VXP

The WordPress VXP plugin: All-in-One Digital Asset Management and Cloudimage Acceleration.

Overview

The WordPress VXP plugin is a powerful WordPress addition designed to help businesses efficiently manage and optimize their digital assets. Integrating Scaleflex two key products in one - Digital Asset Management (DAM) and Cloudimage (Digital Media Optimization) - it enables you to store, organize, deliver, and optimize images, videos, and other digital resources directly from within WordPress.

  • DAM (Digital Asset Management): Seamlessly organize, search, and control all your digital assets, ensuring brand consistency and boosting team collaboration.

  • Cloudimage (Digital Media Optimization): Automatically optimize images and videos for size and loading speed, enhancing user experience and improving website performance.

Prerequisites

To use this plugin, ensure you have a Scaleflex DAM account (register for a demo if not already) or a Cloudimage account (register to get direct access if not already).

Installation

For installation instructions related to the Cloudimage version, please refer to that documentation instead.

  • Log in to your WordPress admin panel.

  • On the Admin sidebar, navigate to Plugins > Add New

  • Enter "Scaleflex VXP" in the search field and then install the plugin

  • Once installed, click Activate.

  • Navigate to the settings page.

  • Select "Digital Asset Management (DAM)".

  • Fill in the plugin settings page with the required authentication details

    • Token: Your token from the DAM

    • Security Template: A key for obtaining time-limited access tokens (used for API interaction). See: Security templates. Behind the scenes, the code would use the Security Template Identifier to obtain a SASS (the “limited-time password”). The SASS would then be used in the auth header for interacting with the Filerobot API (https://developers.scaleflex.com/)

    • Base folder in the DAM to synchronise assets to / from: Choose the folder where uploaded assets should be stored in the DAM platform.

Setup

With Scaleflex DAM, we have two modes of visualization:

  • DAM-Native: Compatibility with every version of WordPress and easy to use with other plugins

  • DAM-Widget: Supports Gutenberg (with classic blocks), Classic Editor, Yoast SEO, WooCommerce, and Advanced Custom Fields. Any other Editor or plugin using media should be validated before use.

Advanced Settings

Storage location: Where assets will be stored. In any case, WordPress will use optimized asset links from the DAM to display and accelerate assets in WordPress.

  • DAM Only: activating the plugin uploads existing WordPress assets to the DAM; new assets are stored only in the DAM and require manual syncing after deactivation.

  • DAM and WordPress: assets are duplicated between WordPress and the DAM; deactivating the plugin relinks URLs to local WordPress storage.

  • Maximum asset weight: in order to prevent timeouts or save space on the WordPress server, you can limit the weight of assets that will be also saved to the WordPress server. Limiting the size will also make larger files unavailable in your posts or pages if you remove the Scaleflex plugin.

Synchronize all assets from DAM to WordPress:

Once enabled, the feature pulls DAM assets directly from the Scaleflex DAM into WordPress (without DAM metadata), simply making assets available and searchable by their name.

Still, a DAM metadata needs mandatorily to be selected to synchronize the attachment ID from WordPress to DAM in order to maintain unicity in WordPress database.

If you don't have any, please create one at: https://hub.scaleflex.com/settings/dam/metadata/assets

This custom metadata should be of type number and should not be edited by DAM users. The selector will pre-filter the available metadata for that purpose.

Metadata and Webhook Configuration

You can enable this option if you want to use metadata in your project or synchronize the asset when you have a new upload from DAM.

Once enabled, the feature pulls DAM metadata directly from the Scaleflex DAM into WordPress (both default and custom metadata), also enabling advanced search and description capabilities.

New assets uploaded to the DAM (from the specified base folder) will be automatically synced to WordPress via Webhook, this time regardless of whether they are used in pages or posts.

You can select to synchronize the relevant DAM metadata you want with Title, Description, Caption, and Alternative Text (ALT) as standard WordPress metadata.

For this to happen, the only metadata needed for the WordPress to pull each and all of the DAM Asset's metadata is the file UUID .

Example for Webhook URL:

https://yourdomain.com/wp-json/sfxvxp/dam/v1/webhook/listen-data

🔐 IMPORTANT — Application Password Required

To ensure that the webhook works correctly, you must use a WordPress Application Password for authentication.

Application Passwords allow secure REST API access without exposing your main account password and prevent unauthorized webhook calls.

How to Create an Application Password in WordPress

  • Step 1: Go to Users > Profile (or “Your Profile”).

  • Step 2: Scroll down to the Application Passwords section.

  • Step 3: Enter a name for the new password, for example:

SFXVXP Webhook
  • Step 4: Click Add Application Password. WordPress will generate a password — copy and store it safely, as you will need it when configuring the webhook in the DAM settings.

  • Step 5: Make sure your "Permalink" setting is of the correct type

If the webhook request returns 404 Not Found, this could be the root cause

Go to WordPress → Settings → Permalinks → select any other than "Plain" and save

What this plugin brings

For example, before DAM is installed and activated, you have these 2 images on your WordPress CMS and these 2 images on your DAM platform:

At this point, the images' URLs still have WordPress CMS URLs

After you install, activate, and configure DAM, you can see the notification at the top to confirm if you entered the correct credentials.

Then the synchronization will run in the background and upload your current asset into Scaleflex DAM.

You can check the progress synchronization at the "Report" page

Now you can see that all the images' URLs have become DAM URLs

The next major feature that Scaleflex DAM brings is the Media Asset Widget as Media Library

Here you can upload your media assets to the DAM platform (instead of WordPress local library)

Note: This feature supports natively Gutenberg, Classic Editor, Yoast SEO, WooCommerce, and Advanced Custom Fields (with others to be added soon).

Anywhere the Media Asset Manager is called by an editor, a Scaleflex DAM media tab will be visible.

Deactivation

When you deactivate the plugin, all media assets that have been synchronized to the DAM will not be available anymore as "CDN links".

You have two options when deactivating the plugin, and what happens next will be depending on the one chosen:

  1. Delete all plugin data

  • this option revoves all configuration parameters and CDN links from the Wordpress database

  • if you selected for storage "DAM only":

    • all articles (and other posts) will then have broken images unless they are manually replaced

  • if you selected for storage "DAM and Wordpress":

    • a background process will map and assign all available local media to articles (and other posts)

  1. Keep all plugin data

  • this option simply removes the plugin from the active ones, and does not modify the articles links

Please note: When using the "Storage location" with the option "DAM only", you need to manually synchronize back to WordPress each of your DAM asset after deactivation.

Last updated