Update documentation content

2026-03-15 05:32:05 +01:00
parent 7d10f030f3
commit c0b92596ec
30 changed files with 1840 additions and 29 deletions
@@ -0,0 +1,40 @@
+---
+title: Media GUI Reference | Datasquirel docs
+description: Upload and manage media files using the Datasquirel web GUI
+page_title: Media
+page_description: Upload, organize, and manage media files from the Datasquirel admin panel.
+---
+
+## Overview
+
+Datasquirel includes a built-in media storage system. Files are organized into folders, served by a dedicated static file server, and can be made public or private per folder.
+
+<div className="w-full grid grid-cols-1 gap-4 items-stretch">
+    <DocsCard
+        title="Upload Media"
+        description="Upload images and files to your media storage."
+        href="/docs/gui-reference/media/upload-media"
+    />
+</div>
+
+## Navigating to Media
+
+In the admin panel sidebar, click **Media** to open the media management page. From here you can:
+
+- Browse your media folders and files
+- Create new folders
+- Toggle a folder between **public** and **private** mode
+- Upload new files
+- Delete existing files
+
+<DocsImg
+    alt="Media List"
+    srcLight="/images/screenshots/media-list-white.webp"
+    srcDark="/images/screenshots/media-list-dark.webp"
+/>
+
+## Public vs Private Folders
+
+**Public folders** — files are accessible to anyone with the direct URL. Use this for profile images, product photos, and other assets that should be freely accessible.
+
+**Private folders** — files require a valid, time-limited access key to download. Use this for documents, premium content, or any file that should only be accessible to specific users. See [Private Media](/features/private-media) for details.
@@ -0,0 +1,51 @@
+---
+title: Upload Media | Datasquirel docs
+description: Upload images and files to Datasquirel media storage
+page_title: Upload Media
+page_description: Upload images and other files to your Datasquirel media storage folders.
+---
+
+## Overview
+
+You can upload any file type to Datasquirel media storage through the admin panel. Uploaded images are automatically given a thumbnail. All uploaded files are served by a dedicated static file server.
+
+## Steps
+
+### 1. Open the Media Page
+
+Click **Media** in the admin panel sidebar to open the media management page.
+
+### 2. Select or Create a Folder
+
+Choose an existing folder from the list or create a new one by clicking **Add Folder**. Folders keep your files organized and control public/private access at the folder level.
+
+### 3. Open a Folder
+
+Click on a folder to open it and see its files.
+
+<DocsImg
+    alt="Media Storage"
+    srcLight="/images/screenshots/media-storage-2-light.webp"
+    srcDark="/images/screenshots/media-storage-2-dark.webp"
+/>
+
+### 4. Upload a File
+
+Click **Upload** (or drag and drop a file into the folder view). You can upload multiple files at once.
+
+Supported file types include images (JPEG, PNG, WebP, GIF, SVG), documents (PDF), and any other file type.
+
+### 5. Copy the File URL
+
+Once uploaded, the file appears in the folder. Click on a file to copy its URL. For public folders, this URL can be used directly in your application.
+
+## Uploading via the API
+
+You can also upload files programmatically using the media API. See [API Reference → Media → POST](/docs/api-reference/media/post) for details.
+
+## Notes
+
+- Image thumbnails are generated automatically on upload.
+- File names are stored as uploaded. Avoid special characters in file names.
+- To move a file to a different folder, delete it and re-upload it to the target folder.
+- Deleting a folder deletes all files inside it permanently.