Chapter 6: Media Manager & Central Asset Hub

Centralized Visual Asset Management, High-Efficiency Batch Uploading, Image SEO Metadata Optimization, and Universal In-Form Media Picker Integration.

Single Repository Store-Wide Asset Reuse
Batch Uploader Drag & Drop Multi-Files
Image SEO & Alt Google SERP Indexing
Universal Modal Zero-Disruption Form Flow

6.1 All Media Gallery & Asset Workspace

High-converting e-commerce relies heavily on rich visual imagery. In MartX, media assets are not scattered across disconnected folders. Instead, the Media Manager serves as the central operational hub for all product photography, category icons, brand logos, hero banners, and brand storytelling visuals.

Admin Panel — Media Manager: All Media Gallery Grid
Media Library
All Media Gallery Grid (images/media/admin_media_gallery.png)
Live view of registered assets showing file thumbnails, exact file sizes in KB, Select All checkbox, and Bulk Delete controls. MartX v1.0.0
Admin Access Route

Navigate to: Admin Dashboard → Media Manager → All Media. To add new assets, click the + Add New Media button located in the top-right toolbar.

Gallery Toolbar & Display Capabilities
Select All & Bulk Delete

Admins can check Select All to highlight multiple obsolete files across the repository, followed by initiating an instant bulk deletion to free up server disk capacity.

Dual View Switching

Toggle between high-resolution Grid View (large visual image cards with file size indicators) and a compact List View for high-density catalog inspections.

Native WebP Thumbnails

Every uploaded file automatically displays its storage footprint (e.g. 20.01 KB, 60.18 KB), enabling administrators to identify oversized assets before publishing.

6.2 Batch Asset Upload Engine

Adding catalog items in bulk requires an ultra-fast asset ingestion pipeline. The Add New Media canvas allows administrators to batch upload dozens of product images, banners, or icons simultaneously through an asynchronous drag-and-drop dropzone.

Admin Panel — Media Manager: Upload New Media Canvas
Batch Uploader
Add New Media Screen (images/media/admin_media_add.png)
Intuitive dashed dropzone supporting multi-file selection, live image preview strip, and batch "Upload All" execution. MartX v1.0.0
Admin Access Route

Navigate to: Admin Dashboard → Media Manager → Add Media. Click the dashed upload box or drag multiple files directly from your desktop file explorer into the browser.

Ingestion Engine Technical Specifications
Feature / Parameter Supported Standard Operational Behavior Storefront Benefit
File Formats WebP, SVG, PNG, JPG, JPEG, AVIF, GIF, BMP Accepts modern web graphic standards including vector SVGs for crisp high-DPI brand logos. Guarantees crisp graphics across retina smartphones, tablets, and ultra-wide desktops.
Batch Uploading Multi-File Concurrency Admins can drag up to 50 files simultaneously. Files are queued and processed asynchronously. Speeds up new catalog and collection launches by up to 10x.
Upload Execution Upload All Action Button Validates file mime types and sanitizes file names on the server before database registration. Prevents corrupted or unsafe binaries from entering the store storage disk.
Quick Return ← Back to Media Gallery Instantly navigates back to the central repository to inspect newly generated thumbnails. Seamless operational loop without browser refresh lag.

6.3 Asset Metadata & Image SEO Optimization

Image search accounts for over 20% of organic e-commerce discovery on Google. In MartX, administrators can inspect any asset's file metadata, verify its exact byte footprint, and configure descriptive Alt Text and contextual descriptions to boost SEO indexing and meet WCAG accessibility criteria.

Admin Panel — Media Manager: Asset Information & SEO Metadata
Asset Inspector
Edit Media Workspace (images/media/admin_media_edit.png)
Dual-pane workspace: Left pane displays visual image preview, file size, and upload timestamp; right pane contains Name, Alt Text, and Description. MartX v1.0.0
Admin Access Route

Navigate to: Admin Dashboard → Media Manager → All Media → Click on any image card or its edit action to open the Edit Media workspace.

Media Information Field Anatomy & Validation
Attribute / Field Type & Constraints Functional Description Storefront & SEO Impact
Media Preview Visual Canvas Displays the actual rendered asset with exact aspect ratio containment and background contrast. Ensures correct orientation and visual clarity before linking to products.
File Size & Date Read-Only Telemetry Shows the exact file size (e.g. 22.19 KB) and timestamped upload date (e.g. 08 Sep, 2026). Helps store managers audit and maintain high website page load speeds.
Name * string (required)
Unique Identifier
The unique human-readable system label and physical storage filename. Referenced in direct storage permalinks and CDN cache URLs.
Alt Text * string (required)
SEO Keyword String
Alternative description of the visual subject (e.g., "prod-28-tote-beige", "waterproof-smartwatch-black"). Injected into the HTML alt="" tag for Google Image search ranking and screen reader accessibility.
Description text (optional)
Free Textarea
Internal administrative notes, photoshoot details, licensing source, or campaign season references. Administrative reference only; not exposed publicly.

6.4 Universal Media Picker Modal — Gallery Workspace

The most powerful feature of the MartX asset system is the Universal Media Picker Modal. Instead of navigating back and forth between different administrative screens, whenever an admin edits a Product, Slider, Banner, Category, Brand, or Team Member, clicking "Select Image" triggers this responsive modal instantly.

Admin Panel — Universal Media Picker: Gallery Tab Selection
In-Form Modal
Universal Media Picker Modal (images/media/admin_media_modal_select.png)
Selected image highlights with an active purple border; right column renders real-time Selection Preview with green "Insert Media" confirmation. MartX v1.0.0
3-Step Modal Selection Workflow
1. Click to Select Browse the paginated AJAX gallery (showing 96 assets per page) and click the target image. An active purple border instantly locks the selection.
2. Inspect Selection Preview The right-hand column dynamically displays the full asset preview, confirming you have chosen the exact color variant or photo.
3. 1-Click Insert Click Insert Media. The modal closes automatically, binding the asset to your active form without page reloading!

6.5 Universal Media Picker Modal — In-Form Direct Upload

What happens if an administrator is halfway through writing a complex product description or configuring a promotional banner and discovers the required image has not yet been uploaded? In legacy platforms, users lose their work by navigating away. In MartX, the Upload New tab allows direct uploading inside the modal without losing a single character of unsaved form data.

Admin Panel — Universal Media Picker: Direct In-Form Upload Tab
In-Modal Upload
Modal Upload Tab (images/media/admin_media_modal_upload.png)
Dropzone embedded directly inside the modal with dedicated "Upload Media" action for zero-friction asset ingestion. MartX v1.0.0
Zero-Disruption Workflow Principle

When you drop an image into the Upload New tab and click Upload Media, MartX securely uploads the file via background AJAX, automatically adds it to the central library, and switches back to the Gallery tab with the newly uploaded image pre-selected. You can click Insert Media immediately!

6.6 Enterprise Asset Guidelines & Performance Hygiene

To ensure blazing-fast storefront page loads (under 1.2s on mobile devices) and top Core Web Vitals scores, adhere to these production asset standards when uploading media to MartX:

Modern WebP Adoption

Utilize WebP format for all catalog photography. WebP reduces file weights by 60% to 80% compared to legacy PNG/JPG while retaining 100% visual fidelity.

1:1 Aspect Ratio

Format product main images and team headshots in square ratios (e.g. 600x600 px or 800x800 px) to prevent irregular masonry jumps in storefront grids.

Descriptive Alt Text

Always provide meaningful Alt Text containing product colors, brand, and type (e.g. "women-leather-tote-bag-beige") to capture free Google Image traffic.

Periodic Bulk Hygiene

Every quarter, review the All Media gallery. Use Select All and Bulk Delete to purge expired seasonal banners and test uploads.

6.7 Enterprise Storage & CLI Maintenance Suite

For high-volume production stores managing tens of thousands of catalog assets, MartX includes a dedicated suite of headless Artisan CLI commands for server maintenance and scheduled automation:

Artisan CLI Command Execution Scope Operational Purpose & Safety Flags
php artisan media:clean Storage Disk Cleanup Scans the physical public/storage/media directory and purges orphaned files that no longer have corresponding records in the media database table.
Dry-Run Mode: Run php artisan media:clean --dry-run to audit orphaned files without making disk changes.
php artisan media:vacuum Database Vacuum Purges dangling database rows in the media table whose physical asset files are missing from storage, restoring 100% database integrity.
php artisan media:optimize WebP Compression Batch scans catalog images and generates modern WebP compressed variants to slash mobile page load times and improve Google Core Web Vitals.
Recommended VPS Server Crontab

Server administrators can safely schedule automated weekly disk hygiene via standard crontab:
0 3 * * 0 cd /path-to-martx && php artisan media:clean --force >> /dev/null 2>&1

Documentation
⚡ 3-Minute Quick Start 1. Introduction & Overview 2. Server Requirements 3. Installation Guide 4. License Activation 5. Dashboard Telemetry 6. Media Manager 7. Catalog Management 8. Products Management 9. Orders & Fulfillment 10. Couriers & Shipping Costs 11. Coupons & Marketing 12. Payment Gateways 13. Theme Layouts Hub 14. Navigation & Mega Menus 15. Sliders & Banners 16. Pages, FAQ & About 17. Blogs & Editorial 18. Reviews & Messages 19. Team Members & Staff Roles 20. Locations & Coverage 21. System Settings Hub 22. Web Cron & FAQs 23. Extra Security & Speed Boost