Skip to main content

WP Media Folder Addon: Wasabi Integration

Note: We wanted to inform you that starting from March 13, 2023, Wasabi will alter its default security settings for customers who desire to create public buckets and objects. For newly created accounts, any buckets created after this date cannot be enabled for public access by the user via the console or CLI. Please go here for further information.

1. How to create a Wasabi User and a new API key?

Log in to the Wasabi Management and navigate to the Users section on the left menu and then click on Create User button.

 

create-user-wasabi

 

Step 1: Input your Username, select "Type of Access: Programmatic (create API key)", then click on Next button.

 

username-newuser

 

Step 2: If you wish to use user groups in Wasabi you can select or create one, for the sake of brevity we’re going to skip this optional step and click the Next button.

 

group-newuser

 

Step 3: Select "AmazonS3FullAccess" policy then scroll down and click on Next button.

 

policy-newuser

 

Step 4: Click on Create User button to finish. 

 

review-newuser

 

A popup including the Access key and Secret key appears. You can download, copy keys to clipboard or keep them somewhere for the next step.

 

new-access-key-wasabi

 

Create a new bucket

A new bucket can be created on Wasabi platform or WP Media Folder plugin.

The first way is to create on the Wasabi site, navigate to Buckets section, and click on Create Bucket button in the upper-right corner of the dashboard. After that, input the bucket name and click on Create bucket button. Finally, you will see the new bucket on the list.

 

create-bucket-wasabi-platform

 

The second way is to create on WP Media Folder settings. Navigate to menu Settings > WP Media Folder > Cloud > Offload Media > Wasabi, click on Bucket settings and selection button. At the bottom of the popup, input the bucket name and click on Create button.

 

create-bucket-wp

 

2. Login to Wasabi from WP Media Folder

Return to the WordPress dashboard and click on the menu Settings > WP Media Folder > Cloud > Offload Media > Wasabi. Paste the following into the form fields:

  • Access Key ID
  • Secret Access Key

 

fill-key-wasabi

 

After that, save the settings and the connection should be a success. Please go to the next step to discover Wasabi features.

 

3. How does it work? What can I do with Wasabi?

How does it work?

Once you've connected WP Media Folder with Wasabi, please select a bucket or create a new one where all your data will be stored.

 

select-bucket-wasabi

 

And you can enable Copy to Wasabi option, all your new media uploaded will be sent to Wasabi.

 

copy-to-wasabi

 

And if you want to sync your uploaded media before using Wasabi integration, click on Synchronize with Wasabi button. Then it will send all your existing media library to your Wasabi bucket.

Note: When you do this action the URL of your media will be replaced by the Wasabi URL. Please see the example below.
From https://joomunited.com/wp-content/uploads/2019/02/image.jpg to >> https://s3.eu-central-1.wasabisys.com/{bucket}/wp-media-folder-joomunited/wp-content/uploads/2019/02/image.jpg

 

In order to offload the media on your site, you should enable Remove after upload option, your media library will be completely stored on Wasabi instead of your server.

 

remove-after-upload-wasabi

 

By enabling Attachment label option, the information on each media will be displayed when you hover on the Wasabi label on the top right.

 

label-wasabi

 

When you want to change your media location or remove the plugin, click on Retrieve Wasabi Media button, then all your media will be copied from Wasabi to you media library. All former links added to your content will remain in place (no broken link).

 

retrieve-media-wasabi

 

Note: You can only sync files from Wasabi to Media library if they are uploaded through our plugin.

How to connect CDN?

Our plugin is integrated with CDN. If you're unfamiliar with setting it up, please refer to the How to connect CloudFront? section under S3 for detailed guidance.

After obtaining your custom domain, navigate to the Wasabi settings in WP Media Folder and enter it into the 'Custom Domain (CNAME)' field.

 

copy-distribution

 

Please wait for a few minutes for the image to load fully when the Last modified field change from "Deploying" to the current date time.

Finally, you can see the changes in File URL field in each image.

 

file-url-cdn-wasabi

 

Advanced settings and actions

You can select a bucket to import folders and files from Wasabi server to your Media library. Or copy all files from one bucket to another one.

 

copy-buckets-wasabi