STM Product Attachment Pro Extension for Magento 2

Version 1.3.0 — 2026-04-26

• Inline preview now supports plain-text files (.txt), CSV (.csv), Word (.doc/.docx), Excel (.xls/.xlsx) and PowerPoint (.pptx) in addition to PDF, images and video. Office documents are rendered server-side to clean HTML by [PhpSpreadsheet](https://phpspreadsheet.readthedocs.io/), [PhpWord](https://phpoffice.github.io/PHPWord/) and [PhpPresentation](https://phpoffice.github.io/PHPPresentation/) — no third-party viewer (eg Microsoft Office Online Viewer) and no extra Content-Security-Policy host whitelist required. CSV files are parsed with auto-detected delimiter and rendered as a styled table; PPTX slides are rendered as 16:9 slide cards with heading detection and bullet indent levels.
• Legacy binary .ppt files surface a friendly "save as .pptx and re-upload" message inside the preview iframe rather than failing silently.

• Three new Composer dependencies: phpoffice/phpspreadsheet, phpoffice/phpword, phpoffice/phppresentation (each MIT-licensed, all maintained by the [PhpOffice](https://github.com/PHPOffice) organization).
• Database schema: column file_type extended from VARCHAR(50) to VARCHAR(100) on storetown_product_attachments and storetown_attachment_rules. The 50-char limit silently truncated Office-XML MIME types (application/vnd.openxmlformats-officedocument.* is 74-78 chars), causing INSERT failures in MySQL strict mode and stored-MIME drift in non-strict mode. Affected columns are now wide enough to hold the full MIME for .docx, .xlsx and .pptx.

Version 1.2.5 — 2026-04-26

• Inline preview now works reliably after a file is replaced on the product edit page. The attachment's file_type is now derived server-side from the actual file on disk via finfo with an extension-based fallback, instead of trusting the client-sent MIME header. The previous behavior could leave a stale MIME on the database row when the dynamic-rows file uploader carried over the previous file's type, causing the preview controller to return 404 for any whose attachment stored MIME did not match the file extension. Affected Controller/Adminhtml/Manage/Save.php, Controller/Adminhtml/Attachment/MassAssignPost.php and the CSV importer.

• New FileProcessor::detectMimeType(string $relativePath): ?string consolidates MIME detection in one place. The duplicate extension map in Model/Import/AttachmentImporter::guessMimeType() was removed in favor of the shared helper.

Version 1.2.4 — 2026-03-19

• YouTube attachments are no longer deleted when saving a product.
• Product Form Modifier: Added a video_url field so that YouTube attachments are visible and editable in the admin panel.
• File uploader validation (required-entry) removed, as attachments can also have only a YouTube URL.

Version 1.2.3 — 2026-03-19

• The category order in the frontend now correctly follows the Category Sort Order from the admin.
• Frontend table: Column widths optimized for the product tab container (no more truncation)
• Removed the old external CSS file (attachments.css) that was causing conflicts with the inline styles.

• More compact table design: smaller buttons, thumbnails and padding for better display.
• YouTube videos now show a play icon instead of an eye icon in the watch button.
• CSS completely rewritten: theme-independent, works with Hyva, Luma and custom themes
• All CSS classes renamed (sta-badge, sta-btn) to avoid conflicts with Magento core classes.
• Mobile view: Flexbox-based card layout instead of float-based hack

Version 1.2.2 — 2026-03-19

• Extension Info Block in the backend with company logo, contact details and support information on all module pages
• Storetown Media Branding in the system configuration with complete extension description and feature overview
• Preparation for Composer distribution via packages.storetown-media.de

• Final code quality and stabilization for the public release
• All admin pages (grids, forms, import, mass assign) now uniformly display the info block.

Version 1.2.1 — 2026-03-14

• Correction of grid collection sorting when filters are empty in the attachment grid
• Missing translations in the German localization (i18n/de_DE.csv) have been added.
• CSS rendering of file-type badges in the Hyva theme has been corrected.

• Performance optimization when loading the attachment list on product pages with many attachments
• Improved error handling during file uploads when the maximum file size is exceeded.

Version 1.2.0 — 2026-03-10

• Auto-Assign Rules — automatic assignment of attachments to products based on flexible conditions
• Condition engine with support for product category, attribute set and any product attributes
• AND/OR combination of multiple conditions for complex rule logic (e.g. "Category = Electronics AND Manufacturer = Samsung")
• Apply on Save Toggle — Rules can optionally be applied directly to all matching products when saving.
• Nightly cron execution of all active rules (configurable in System Config, default: 02:00, disabled by default)
• Automatic full page cache flush after rule application to ensure immediate frontend update.
• Dedicated admin grid for auto-assign rules with status filter, search, and mass delete action.
• Rule form with file upload, video URL, category assignment and sorting.

• Grid architecture for all listing grids fundamentally revised and stabilized.
• Unified DataProvider structure for Attachment, Category, Extension and Rule Grids

Version 1.1.2 — 2026-02-28

• Fixed YouTube embed URL generation issue for URLs with additional query parameters.
• The modal overlay did not close correctly when clicking outside the preview window.
• The preview button was still displayed in the frontend even when the preview option was disabled.

• Alpine.js Modal Transition for smoother animation when opening and closing.
• Thumbnail quality for YouTube videos increased to maxresdefault

Version 1.1.1 — 2026-02-20

• CSV import failed with SKUs containing special characters (umlauts, hyphens).
• The mass assignment form displayed a timeout error with large product quantities (>500).

• Import validation now displays line numbers for erroneous CSV entries.
• Batch processing in Mass Assign for better performance with large datasets

Version 1.1.0 — 2026-02-10

• Inline document preview for PDF files (embedded iframe), images (img tag) and YouTube videos (embed)
• Alpine.js modal for interactive preview directly on the product page without page reloading
• Automatic YouTube detection for video URLs with thumbnail generation and correct embed URL
• Video URL field in the attachment form for YouTube links and direct video files
• Configurable preview function — can be enabled/disabled per store view in the system configuration
• CSV import for bulk import of attachments — supports SKU-based product mapping, category, title, and sorting.
• Dedicated import page in the admin panel under Catalog > Product Attachments > Import Attachments
• Mass Assign function — assign multiple attachments to selected products simultaneously
• Extended Mass Actions in the Attachment Grid: Mass Delete and Mass Category Assign

• Form validation during CSV import with detailed error reporting (row, field, reason for error)
• Upload progress indicator for file uploads in the attachment form

Version 1.0.2 — 2026-01-30

• Customer Group Restriction was not correctly evaluated for cached pages.
• Guest Access settings were not saved persistently when saving the configuration.

• Cache tag integration for correct invalidation when access rights are changed.

Version 1.0.1 — 2026-01-20

• File extension icons were not correctly reset after deleting an icon.
• Badge colors with invalid hex values ​​led to a frontend rendering error.
• Sorting by Sort Order in the frontend did not work for attachments without an explicit sort value.

• Fallback to standard icons if no custom icon is specified.
• Validation of hex color values ​​in the file extension form

Version 1.0.0 — 2026-01-13

• File Extension Management with its own Admin Grid — individual icons, labels and badge colors definable for each file type
• Icon upload function for custom file type icons (PNG, SVG supported)
• Configurable Custom File Extensions in the System Configuration with Dynamic Rows
• Customer Group Access Restrictions — Make attachments visible only to specific customer groups
• Guest Download Control — Allow or block downloads separately for visitors who are not logged in.
• Store View-specific configuration for all access rights

• Frontend display with colored file-type badges that are automatically generated based on the file extension.
• Responsive badge display optimized for mobile devices

Version 0.9.0 — 2025-12-16

• Attachment categories for organizing attachments (e.g., manuals, datasheets, certificates, security information)
• Category management in the admin area with its own grid, form, and mass delete action.
• Grouping by category on the product page — configurable in System Config (Group by Category)
• Sorting within categories via the Sort Order field
• Download counter with automatic counting and optional display on the product page
• Configurable sorting of attachments (by name, creation date, file size or manual sort order)
• Option to open downloads in a new browser window/tab
• Display of file size (human-readable: KB, MB) and file type next to each attachment
• All display options can be individually enabled/disabled in the system configuration.

• System Configuration has been expanded to include dedicated areas for category management and display options.
• Frontend template with improved accessibility (ARIA labels for download links)

Version 0.8.0 — 2025-11-11

• Attachment tab in the product editing section of the admin panel — Attachments can be managed directly on the product.
• File upload with server-side validation (allowed file types configurable, maximum file size adjustable)
• Admin grid for centralized attachment management with column filters, full-text search, and pagination.
• ACL integration for granular permissions (Manage Attachments, Import, Rules, Configuration)
• Admin menu under Catalog > Product Attachments with sub-items for Manage, Rules and Import
• Quick Action Buttons on the configuration page for quick access to Manage and Import.

• Form UX with automatic file type detection and size calculation during upload

Version 0.7.0 — 2025-10-14

• Initial module structure for Magento 2.4.x with complete repository pattern
• Database schema (declarative schema) for attachments, categories, file extensions, and auto-assign rules.
• API interfaces (AttachmentRepositoryInterface, CategoryRepositoryInterface, FileExtensionRepositoryInterface)
• Data interfaces for type-safe data models
• Frontend block for displaying attachments as a separate tab on the product page
• Compatibility with Hyva Theme (Alpine.js), Luma Theme and common third-party themes such as Porto
• Basic system configuration is found under its own Storetown tab, with sections for General, File, and Display Settings.
• CSP Whitelist Configuration for YouTube Embeds and External Resources
• German and English translation files (i18n)