- b2evolution CMS User Manual
- Back-office Reference
- Collections
- Settings
- Advanced
- Media Directory Location Panel
Media Directory Location Panel
This panel lets the administrators decide where to place the media directory for each collection.
By default, the media folder is created in a special directory inside the b2evolution’s file structure. This special directory is located in /media/[coll_slug]
, where coll_slug is the value of the URL "filename" parameter of the current collection (more information about this parameter could be found here: Collection General Parameters).
You can preview the URL of the media folder in the URL preview field.
Media Directory Options
None: you will disable the media directory for this collection. It is important to know that the current media directory must be empty, otherwise, the system will throw an error message to warn you that it is not and will abort the requested change. You will need to manually delete those files using the File Manager before selecting this option.
Important: we discourage the use of any external tool to delete files from the media folder (FTP, hosting file manager, etc.), to keep the health and cleanness of your meta-data database.- Default: the media directory is located in
/media/blogs/[Collection URL "filename"]
. - Subdirectory of media folder: a new subdirectory will be created and named as you set it in the text field next to this radio button. Please, note that by performing this action all the files will be moved from the old directory to the new one. It is important to remember that the new folder will be located in
/media/
and not in/media/blogs
as the old one probably was. - Custom location: you can set a completely different location for the media folder of the current collection. In this case, you will need to provide the following information (please note that both values are required):
- Directory: full path of the new media folder. (i.e.:
/home/mydomain/custom_media_folder
) - URL: the URL that points to the directory set above (i.e.:
http://mediafolder.mydomain.com
).
- Directory: full path of the new media folder. (i.e.:
Considerations when using "Custom location":
- Make sure that PHP has write permissions on the new path that you are about to set.
- The URL[ field must be directly pointed to the directory, otherwise, the file manager will not work properly.
- Validations about the new folder:
- It must not exist, because it will be automatically created by b2evolution.
- It must not be already assigned to any other collection. Even subfolders of another media folder are also avoided.
- It must not be named as any of the reserved default media folders i.e.:
media/shared
,media/users
, etc.