Media & Files

Luminal CMS provides comprehensive media management through the File Manager, Background Manager, and Font Manager modules.

File Manager

File Manager is a dual-pane file browser with role-based access control.

Access Levels

• Admin — Full access to the entire site filesystem (wildcard root).
• Staff — Restricted to the /media directory by default.

Access configuration is stored in admin/data/FileManager/config.json. If this file is missing, sensible defaults apply automatically.

Operations

• Upload — Drag and drop or click to upload files to the current directory.
• Create Folder — Create new directories for organizing media.
• Rename — Rename files and folders.
• Move — Move files between directories.
• Delete — Remove files (permanent, no recycle bin).
• Download — Download files from the server.

Media Directory Structure

The standard media directory layout:

media/
  images/       Images (JPEG, PNG, GIF, WebP)
  videos/       Video files (MP4, WebM)
  pdfs/         PDF documents
  backgrounds/  Background images and videos
  store/        Product images (MyStore)
  notebooklm/   NotebookLM podcast audio

Each directory can have subdirectories for further organization. Thumbnail caches are stored in .cache/ subdirectories.

Uploading Media

Media can be uploaded through multiple interfaces:

• File Manager — General-purpose file upload to any directory.
• Media Browser (in Gallery Manager) — Upload directly to media directories while building galleries.
• Background Manager — Upload background images and videos.

Background Manager

The Background Manager handles site-wide background images and videos:

• Upload and manage background media files.
• Set active backgrounds for the site.
• Configure opacity and layering.
• Individual pages can override the background with the include_bg option.

Font Manager

Font Manager lets you upload and configure custom web fonts:

• Upload font files (WOFF, WOFF2, TTF, OTF).
• Register fonts with descriptive names.
• Select fonts for headers, body text, and menus via Site Settings.
• Fonts are served locally — no external CDN calls that track visitors.

Supported File Types

• Images: JPEG, PNG, GIF, WebP, SVG
• Videos: MP4, WebM, OGV
• Documents: PDF
• Fonts: WOFF, WOFF2, TTF, OTF
• Audio: MP3, WAV, OGG