Strapi Plugin Media Upload

A plugin that help you upload media to a specific folder using api in strapi.

---

Features

• Upload files to a specific folder structure.
• Manage folders and files through API.
• Easy integration with Strapi projects.

Installation

npm i strapi-plugin-media-upload

Configuration

After installation, the plugin will be automatically enabled.

Usage

Upload media files to a specific folder using the provided API endpoints.

Folders Manager

1.Query Folders

• GET /<strapiprefix>/media/folders
• Query Params:
  • parentId (optional): ID of the parent folder, return root folders if not fill.
  • sort[] (optional): e.g.sort[0]=createdAt:asc&sort[1]=updatedAt:desc

2.Create Folder

• POST /<strapiprefix>/media/folder
• Request Body:

  {
      "name": "New Folder", // Required, folder name
      "parentId": 1         // Optional, ID of the parent folder
  }
  

3.Update Folder

• PUT /<strapiprefix>/media/folder
• Request Body:

  {
      "id": 1,              // Required, ID of the folder to update,
      "name": "New Folder", // Required, folder name
      "parentId": 1         // Optional, new parent folder ID
  }
  

4.Delete Folder

• DELETE /<strapiprefix>/media/folder
• Query Params:
  • id: the id of folder should be deleted (attention: folders and files under this folder would be deleted by the way)

5.Folder Structure

• GET /<strapiprefix>/media/folder-structure

6.Query Folder By ID

• GET /<strapiprefix>/media/folder
• Query Params:
  • id (optional): ID of the folder

7.Delete Folders and Files

• POST /<strapiprefix>/media/bulk-delete
• Request Body:

  {
    "fileIds": [27],    // Required, ID of the files to delete
    "folderIds": [20]   // Required, ID of the folders to delete
  }
  

8.Move Folders and Files

• POST /<strapiprefix>/media/bulk-move
• Request Body:

  {
    "targetFolderId": 21, // Required, ID of the target folder, if not provided, the items would be move to the root folder.
    "fileIds": [27],      // Required, ID of the files to delete
    "folderIds": [20]     // Required, ID of the folders to delete
  }
  

Media Uploader

1.Upload Media

• POST /<strapiprefix>/media/upload
• Request Body:
  • file (multipart/form-data): The file to upload.
  • folderId (optional): ID of the folder where the file should be uploaded.

2.Update Media

• PUT /<strapiprefix>/media/update
• Request Body:

  {
      "id": 1,    // Required, ID of the file to move,
      "name": "New Name", // Optional, new file name
      "alternativeText": "New Alternative Text", // Optional, new alternative text,
      "caption": "New Caption", // Optional, new caption,
      "folderId": 1,  // Optional, folder id
  }
  

Compatibility

This plugin is compatible with Strapi 5.0.0 and above.

Issues

If you encounter any issues, please report them here.

---

License

This project is licensed under the MIT License. See the LICENSE file for details.

---

Author

Eli Liu
Email: [e-mail]
GitHub: Littlexiaoxiaojian