An introduction to support on the Marketplaces
- Envato staff look over every item before it can be sold on the Marketplaces.
- Technical items contain help files to introduce you to the item and its components.
- Authors can choose to support their items but this is optional and may vary.
Hands-on support for this item is provided by P_Enrique
Frequently Asked Questions
Why are my files are not renamed when I upload them to the Media Library?
Renaming by post or page title will not work if you are uploading the files directly to the Media Library. Since there is no way of knowing to which post your files might be attached to in the future, so this behaviour is normal. The prepend string will be added, however, and other filtering (such as stripping accents from the filename) will take place.
I’m uploading to a post or a page, but the file shows the old name, why?
The original file name will be shown during the upload. The new one will appear when it’s completed.
Why wasn’t my file renamed after the upload completed?
Did you choose to rename files using the post/page title and/or set a prepend string? If you didn’t, there was nothing for the plugin to do! Set your options at the WordPress
Settings > Media screen.
I get a message telling me to set a title, but I already did!
Sometimes the post or page title isn’t updated on the server immediately, click on
Save Draft to update it.
I changed the title but the files are not renamed, why?
If you upload files and then change the post or page title, the uploaded files will not be renamed. This plugin only renames files as they are uploaded.
Why are my files appearing in another order?
If you are uploading several files at once, the order in which the files will appear is beyond our control as it depends on the browser used. Different browsers send the files in different order, and WordPress processes them as they come in. If you need the files to be in a certain order, you need to upload them one by one.
What happens with Non-Latin characters, such as Cyrillic, in post titles?
Non-Latin characters mean letters that are not based on the A-Z alphabet, such as Chinese, Arabic, Thai, Cyrillic, Greek, Hebrew, to name just a few.
Short answer: The plugin handles these scripts just as WordPress does, with a little bit of extra care.
Long answer: Let’s assume you write your post titles in Russian or Arabic. When you upload something to your post, the process goes like this:
- The plugin tries to rename your files using the title you wrote. Everything that can be converted to basic Latin characters will be converted, such as “à” (Latin letter a with grave) to “a”. All symbols, punctuation etc. will be converted to dashes (minus-signs).
- If you are on a Windows-based server, the next step is removing all non-ASCII letters from the filename. This means all letters that are not the A-Z Latin alphabet. (Otherwise WordPress won’t be able to show your file or link to it. This is an incompatibility between PHP – the scripting language behind WordPress – and Windows.)
- If after stripping punctuation, and, in case of Windows, stripping letters that could not be converted to simple Latin letters, there are less than 5 alphabetical letters left, the plugin will try rename your file using the post “permalink” instead. Unfortunately, this step only works for posts that are published.
- If there is no useful permalink either, the plugin will use your original filename instead (as it was on your computer).
- If the original filename cannot be used, you get an error
message. (This should only happen when you are using the “ASCII”
filter; unfortunately, it is the only one available on a Windows
NOTE: This plugin will not make files work if they didn’t work before. It does add an error notice when this happens; see the question `Why do I get an error that says “Could not rename the file”?` below. Before asking for support because of a broken file upload, please disable the plugin and try to upload the SAME file again. If a file doesn’t work without the plugin, we cannot magically make it work.
- If you are on a Unix-based server (most common!), the Non-Latin characters will stay as they were, provided that you have not chosen the “ASCII” filter and are using the “UTF-8” filter.
Will my transliteration plugin work with this plugin?
If you have installed a plugin that transliterates a Non-Latin script to ASCII characters, it should work with the Easy Upload Renamer, provided that the plugin works as a filter for the WordPress hook
sanitize_file_name. (If your filenames are transliterated when you upload them without this plugin disabled, they should be transliterated in the same way with this plugin active.)
Can I choose not to have my filenames in lowercase?
To enable compatibility with the advanced filtering of accented characters and punctuation, all filenames are always converted to lower case. This is also the current consensus for SEO (Search Engine Optimization) purposes.
Why do I get an error that says “Could not give a usable name for the uploaded file”?
This is an error message that appears when there are no valid characters to use in the filename. The plugin tries to rename your file using the post title, the permalink (slug), and finally the original filename.
- When using the “UTF-8” filter, the post title and the original filename contain only numbers renaming using the post title, the title contains only punctuation characters, symbols etc. The plugin detects this and tries to use the post permalink instead (for published posts). If this fails as well, the plugin uses the original filename (the name of the file on your computer) instead. But if there are not enough usable characters in the original filename either, you get this error message.
- You are using the “ASCII” filter (which is the only one available on Windows-based systems) and both the post title and the original filename contain less than 5 ASCII letters (Latin A-Z letters).
NOTE: Please note that this error message is a courtesy from the plugin. The plugin goes to extra lengths to try to make your files work. Without the plugin, WordPress would let you upload whatever, and you’d just get a broken image file (and broken thumbnails in your uploads folder). The error message is advising you about this situation so you can avoid it.
What is the maximum length of a filename?
When using title renaming, you can limit the characters used from the
title in the plugin settings, with
0 meaning “unlimited”.
But there are fixed maximums, of course, since a filename cannot be indeterminately long.
There are two kinds of limits here: characters and bytes. When filenames contain Non-Latin characters, each character may take up to 5 bytes of storage space in the UTF-8 encoding. (Latin A-Z characters take 1 byte per character, accented characters take 2, other scripts take more.)
The prepend string is capped at 32 characters and 50 bytes, whichever is less.
The base filename string is capped at 192 bytes. (The number and extension may take up to 8 bytes more.)
The separator symbol is capped at 1 character and 5 bytes. In fact, you can only choose a dash (a minus-sign) or an underscore (both take only 1 byte), but there’s some slack for a future update.
So that’s a total of 255 bytes. However, the plugin will truncate the filename string automatically depending on the maximum path length on the current system. (Windows has a limit of 255 characters per path and some of these characters are used in the path of the uploads directory.)
When to contact Envato Support
Authors are experts on their own items, but if you're having trouble using the Marketplaces you should come straight to Envato Support.