WP Media Folder documentation

Introduction

WP Media Folder is a WordPress plugin that enhances the WordPress media manager by adding a folder manager inside.

 

WP-media-folder

 

Main advantages:

  • Multi-level folders
  • Move media with drag'n drop controls
  • Multiple media selection and move
  • Create galleries from folders
  • 4 gallery themes
  • NextGEN gallery importer
  • Import post categories as a folder
  • Breadcrumb and folder tree navigation
  • Bulk upload in a particular folder
  • Nothing lost on uninstall
  • WooCommerce support

 

I. WP MEDIA FOLDER INSTALL

1.1 Install

In order to install our plugin you should use the standard WordPress installer or unzip and put the whole folder in /wp-content/plugin.

 

install-wp-media-folder

 

Then click on activate plugin to see WP Media Folder menu appear on the WordPress left menu.

WP Media Folder is accessible from the media menu and the media button above your editor. You also have the parameters under the "Settings" menu.

1.2 Update the plugin

In order to update the WP Media Folder, you can use the WordPress default updater. You can also remove and install the new version from a .zip file downloaded from www.joomunited.com. In any case you won’t lose any content because everything is stored in a database.

 

 

Be sure to always have the latest version to avoid security and stability problems.

To update the paid version, you need to login to your JoomUnited account from the WordPress settings: Settings > General

 

link-account

 

Then use your JoomUnited account login and password. After a successful login the button turns to blue with a text Disconnect my JoomUnited account.

 

image9

 

Finally, you can update all the JoomUnited commercial plugins from the WordPress standard updater.

 

image10

 

1.3 Notifications after installation

After installing the plugin you will get 2 notifications

  • Do you want to import the post categories as media folders?
  • Do you want to import NextGEN galleries as media folders?

Hit Yes to proceed or Dismiss to ignore.

II. WP MEDIA FOLDER COMMON USE

The main idea of WP Media Folder is to classify media directly from the media manager. WP Media Folder works on the native media manager, both from the public and admin side. For example you can use it in posts and pages.

2.1 Manage folders from posts or pages

To use WP Media Folder just click on the Add Media button. 

 

image11

 

Click on it to open the main media view with the folder management.

 

create-media-folder

 

There's a button to create a folder and directories are listed below. When you click on Create folder you have to type a name and validate the creation.

 

folder-name

 

If you want to create a sub-folder you just need to enter in a folder and repeat the operation. You can then use the breadcrumb or folder tree so not to lose yourself in folder levels :)

 

folder-navigation

 

A single media can belong to several folders. When you click on a file look for the Media Folders selection setting in the the right side column and click on it.

 

media-multiple-folders

 

You can also use the WordPress media manager to batch apply multiple folders to multiple media. First, click Bulk Select, pick media files and then press the Media folders selection button.

 

bulk-media-folders

 

2.2 Manage media

In order to move one or several media in a folder, click on the media and drag it into the folder you want. 

 

drag-madia

 

You also have the possibility to drag multiple images into folders or into the folder tree. First select media.

 

media-selection

 

Then drag media into folders.

 

move-some-media

 

A notification will then be displayed with the possibility to UNDO the last media move you've just made.

 

notification-media-move

 

2.3 Remove and edit folders

The folder can be renamed by double clicking on the folder on the left panel or right clicking on the folder and choose Edit Folder.

 

edit-folder

 

In order to remove media, right click on the folder and click Delete button.

 

remove-folder

 

If you remove a folder with media inside, by default all media inside will go back the root of the media manager.

You also have a parameter to remove folder and the media inside the folder - use with caution!

 

remove-folder-setting

You can also change the color of folder from the Change color menu.

 

change-folder-color

 

2.4 Media view

The media and folders can also be managed from the WordPress media manager view.

 

media-library-folder-view

 

You'll also see existing folders from the media view. Note that article categories are automatically added as folder.

To upload media in particular folders, select one and click on Add media. From the folder tree you can ensure that you're in the right folder.

 

image22

 

In order to filter media, you can click Sorting / Filtering button. Media can be arranged by media type, category, dates, minimum and maximum size (in px), weight ranges.

 

filter-size

 

2.5 WordPress media searching and filtering

WP Media Folder adds some new features to the default media manager. You'll find all the settings in the plugin configuration General > Media Filtering. You can use default ones, remove some filters and add you own.

 

media-filtering-options

 

From the configuration you can setup the weight and size filters ranges.

 

media-view-ranges

 

The sorting dropdown lists can sort images and folders based on:

  • Media upload date
  • Titles of the media
  • Size (in pixels)
  • File type (image, zip, pdf...)

 

sort-media-and-folders

 

Note: when you apply an ordering it will be automatically saved in your session using cookies. It means that next time you'll open your media manager, the media ordering will remain the same. 

2.6 Add remote Youtube video

In order to add a Youtube video, you can click the Add New button or Media icon as the image below.

 

add-remote-video

 

Next, a text box will be displayed on the screen where you can paste the YouTube link. Then you will see a YouTube file among your media.

 

remote-video

 

III. MANAGE GALLERIES

WordPress has a native inbuilt gallery function. We've chosen to offer a enhancement of this feature based on the folders. You will be able to create galleries from folders or from a selection of images.

 

image23

 

If you open a folder or select an image you will see a button called Create a gallery from folder. Once your gallery is created you have several new options in addition to the WordPress default ones such as:

  • Gallery theme: layout for the gallery
  • Gallery image thumbnail size: a choice from WordPress default image resizing
  • Gallery image lightbox (large) size
  • The action on click on an image: open a lightbox, load a separated page or do nothing (a link can also be chosen by clicking on a single image)
  • Auto insert image: when you add an image in this folder, it can be automatically added to the gallery

If you experience bad quality images in case of a big thumbnail display, for example a big width gallery on 2 columns, we recommend that you load medium or large image.

 

gallery-parameters

 

The default gallery will override the WordPress default gallery theme. If your theme already has a styling option for the WordPress gallery, you can disable this feature.

You can define custom links per image in the gallery, which can be very useful if you need to create a homepage layout based on a gallery that redirects to pages or posts.

While editing galleries, click on an image and look at the right column options.

 

image31

 

You can define an internal or external link to this image using the WordPress default link manager. You will also be able to define the target where the link will open as the same window, or a new window (new tab).

 

image30

 

The first gallery option is the theme choice.  The default theme is an enhancement of the WordPress default theme, bringing you lightboxes to images.

 

image25

 

Masonry will display a wall of images with fixed width and fluid height.

 

image26

 

Portfolio theme is a stylish gallery with hover effects, titles and captions.

 

image27

 

The slider theme is a horizontal slider with title and captions.

3.4 Image options

Each image has some options in a gallery. Click on an image to see them.

  • Title and caption can be displayed in the gallery depending of the theme you've chosen
  • Link to allow you to add, for example, lightboxes to images or add custom links to individual images in a gallery - the WordPress link manager will help you to do that
  • Link target can define if the link will be loaded in the same window or in a new one

In each gallery you can order your images by:

  • Custom order
  • Random order
  • Title
  • Date

WP Media Folder has a NextGEN gallery importer. Once the plugin is installed, WP Media Folder will detect the NextGEN gallery installation and you'll get a notice to import galleries.

Each gallery will be imported as a single folder with the name of the gallery as the folder name.

 

image32

 

IV. WP MEDIA FOLDER SETTINGS

Global settings are available through the menu Settings > WP Media Folder > Main Settings tab.

 

general-settings

 

4.1 General settings

  • Folder Design: Select the design of the folder listing: material design with color (by default) or classic, the legacy design with folder covers
  • Activate WP Media Folder on frontend: If you're using a page builder that is available on the frontend, you can activate this option to use WP Media folder. If not, keep it disabled - you'll get better performance without it
  • Folder tree: Load a left folder tree on the left part of the media manager for a faster folder navigation
  • Enable remote video feature: Include and manage remote video from Youtube Vimeo or Dailymotion
  • Media count: Display the number of media available in each folder in the folder tree
  • Import categories: Import or re-import your existing post or media categories as a folder
  • Search through all media folders: The media search engine (in the media manager) can search in the whole library or only on the current folder (default parameter)
  • Override file: Replace an existing file with another without generating broken links (same format allowed, for example from .jpg to .jpg)
  • Duplicate file: Add a button to duplicate a media from the media manager
  • Hover image: On mouse hover on an image, a large preview is displayed
  • Enable the filter and order feature: Additional filters will be added in the media views
  • Load GIF file on page load: Automatically play the GIF animation on page load. By default it’s a static image in WordPress
  • Remove a folder with its media: When you remove a folder all medias inside will also be removed if this option is activated. Use with caution

Image and media replace feature

 

  • Duplicate file: Duplicate a media file

 

duplicate

 

  • Hover image: Display a hover effect that displays the image in a medium size on mouse hover in the administration panel

 

media-hover

 

  • Filter and order feature: Order and filter media activation

 

media-filters

 

  • Media size filter and weigh filters: Add, remove or define filtering range

 

custom-filters

 

You can go to Settings > WP Media Folder > Wordpress gallery > Gallery Features tab

Enable the gallery feature: Enable or disable gallery functions (create gallery by folder, gallery themes...)

Lightbox in galleries: Add a lightbox to images in WordPress default galleries

Enable the single image lightbox feature: Add a lightbox option on each image of your WordPress content

gallery-options

 

Gallery image size and settings: Choose which image sizes will be available to be chosen in galleries. WordPress has 6 sizes of images defined by default in the media settings. Once you install new plugins, a new size can be added. For example WooCommerce is adding a custom size for its products. You can choose which size to load in the image galleries here.

 

gallery-parameters

 

Sync/import NextGEN galleries: Only displayed if the plugin is installed - import or make a new sync of the NextGEN galleries available on the website

4.3 Media access

You can go to Settings > WP Media Folder > Wordpress gallery > Media Access tab.

WP Media Folder has an option to limit media display and management to the user's own media only. When a new user is created, a root media folder is generated for them, with their name and all their media inside. They can create subfolders inside. As an administrator you have an option to display or hide your own media right inside the media manager.

You can limit media access by:

  • User (a folder per user)
  • User role (a folder per user role)
  • Define a root folder where all your users media/folders will be created

 

access-media-settings

 

4.4 Server file importer & sync

A tool is included to import a massive amount of media from a server folder in the native WordPress media manager from the plugin Settings > Server Import. 
Select a folder and/or subfolder, click on import, and it’s done! All the folder structure and media are now available in your native WordPress media manager.

It imports the folder structure and all media inside.

 

folder-import

 

A sync tool is also available from the plugin settings named "Server Folder Sync". From there you can sync a folder from the server where your WordPress website is currently installed with a WP Media folder. 3 main settings are available: 

  • Synchronization methods: from server to WP Media Folder and vice versa
  • The folder source and the destination: local server folder to WP Media Folder directory
  • The sync delay: delay to run a sync between those folders

First, you select the folder synchronization options:

sync-external-media

 

And it’s very flexible, select the server folder (the source) and the WP Media folder (the destination), the synchronization delay and you’re done! Of course you can do that with several folders (folder list is at the bottom).

folder-synchronization-list

 

Then just click Add and Save Changes button and wait for the next sync.

That's 2 way synchronization: the media synchronization can also be done in the other way, from WordPress media manager to an external folder. This is pretty useful to share media with another plugin or CMS that is using a folder outside the default WordPress one: “/uploads”

two-way-synchronization

 

4.5 Single file design

The WordPress media manager handles not only images, but also documents and other file formats (like PDF, zip files). We’ve included a function to add you design on files. You can define a button and font colors, and instead of a basic link to a PDF file, for example, you'll get a real download button.

 

single-file-design

 

4.6 Media Rename

You have an option to automatically rename your media on upload, respecting a pattern you’ve defined, which is useful for SEO. 
You can find at WP Media Folder configuration > Rename & Watermark > Rename On Upload tab

Tag avaiable: {sitename} - {foldername} - {date} - {original name}
Note: # will be replaced by increasing numbers

 

files-folders

 

Remove characters: 

  • Hyphen (-)
  • Tilde (~)
  • Period (.)
  • Hash/pound (#)
  • Plus (+)
  • All numbers (0-9)
  • Ampersand (@)
  • Round brackets (())
  • Square brackets ([])
  • Curly brackets ({})
  • Underscore (_)
  • Copy title to 'Alternative Text' Field? (-)
  • Copy title to 'Description' Field? (.)
  • Copy title to 'Caption' Field? (_)

image-rename-upload2

 

Automatic capitalization: 

  • Capitalize All Words
  • Capitalize First Word Only
  • All Words Lower Case
  • All Words Upper Case
  • Don't Alter (title text isn't modified in any way)

4.7 Image watermark

You can apply image watermarks to your media - a non-removable watermark visible by your end-users.

First, you need to enable the Images watermark feature at WP Media Folder configuration > Rename & Watermark > Watermark tab.
 
enable-watermark
 
 
Then select an image that you want to set as watermark. 
 
image-watermark
 
 
Next, you can set the adjust the scale of the image or set the margin for it.
 
watermark-position
 
After that, you can select which image sizes can be applied on and tick on the folders to exclude the watermark.
 
watermark-apply
 
Finally, clicking the Thumbnail regeneration button and save the settings - all the images in your media library will be regenerated with a new watermark. 
 
thumbnail-generation
 
 

JUST IN TIME, WP MEDIA FOLDER 4TH ANNIVERSARY SUPER SALE!
25% OFF on WP Media Folder and WordPress Bundle - 18 Sept. to 25 Sept.
COUPON: WPMF4TH

WPMF 4th Anniversary NL

4 years ago we've launched WP Media Folder, our WordPress media manager plugin.
What a success, 17000 users and 90 versions later, we would like to share this with you.