STM Product Attachments

 Product pages today carry far more weight than a description and an image. Customers expect data sheets, user manuals, certificates of conformity, safety instructions, drivers, firmware, ingredient lists, CAD drawings, demo videos — downloadable directly from the product page, in the right language, on any device. The cost of getting this wrong is real: support tickets for missing documentation, returns from misinformed buyers, audits where the certificate is locked in a shared drive nobody can find, and compliance gaps where the safety data sheet was not actually published with the product. 

 STM Product Attachments is the attachment engine that finally models this correctly. It adds a dedicated, scope-aware attachment system to every product on your Magento Open Source / Adobe Commerce store: a full-featured admin module with bulk-import, mass-assign and rule-based auto-assignment for catalogues of any size, a deterministic server-side inline preview for the entire mainstream office stack (PDF, Word, Excel, PowerPoint, plain text, CSV, images, YouTube and direct video), color-coded file-type badges, customer-group access control with a separate guest toggle, and a download counter so you can see which documents your customers actually use. 

Why STM Product Attachments stands out

 Most Marketplace attachment extensions still attach a single file at a time through the admin, render Office files via the Microsoft Office Online Viewer (which means every preview leaves your server, leaks the file URL to a third party and pulls a CSP host whitelist with it), and forward access control entirely to the file system. STM Product Attachments combines three capabilities that no other extension on the Marketplace bundles in one place: 

• Server-side inline preview for the full mainstream office stack — PDF, Word (.doc / .docx), Excel (.xls / .xlsx), PowerPoint (.pptx), plain text, CSV, images, YouTube and direct video render inside your own Magento environment via the MIT-licensed PhpOffice library family; no Microsoft Office Online Viewer dependency, no third-party CDN call, no extra CSP host whitelist, no file URL leaked to a third party.
• A condition-based auto-assign rule engine — define rules with AND/OR combinations on category, attribute set or any product attribute, run them on save or via the optional nightly cron, watch Magento attach files automatically as new SKUs flow into matching conditions; the catalogue stays in sync without manual binding.
• Customer-group access control with a separate guest toggle and per-extension custom badges — show certain documents only to dealers, registered customers or specific B2B groups; upload your own icon (PNG / SVG) and pick the badge colour per file extension via an admin grid, so niche formats (CAD, schematic, firmware) render as cleanly as the standard ones.

Features

•  Dedicated Product Attachments tab on the product edit page with drag-and-drop file upload, attachment title, YouTube URL, attachment category and sort order — managed via a Magento native admin form, with inline preview of the uploaded file directly in the admin so the back-office and the storefront see the same rendering.
• Central admin grid under Catalog → Product Attachments → Manage Attachments with full CRUD, column filters, full-text search, persistent bookmarks, pagination, and mass-actions (mass delete, mass category assign) for catalog-wide attachment management without leaving Magento.
• Mass-assign mass action in the standard Catalog → Products grid — Assign Attachment picks the file once, ticks the selected products, applies; one file gets attached to N products in a single index-friendly operation, safe on huge catalogues, no row-by-row product save.
• CSV bulk import under Catalog → Product Attachments → Import Attachments — required columns sku, title, file_path; optional columns category and sort_order; line-by-line validation with detailed per-row error reporting (row, field, reason) and a downloadable example CSV right on the import page.
• Auto-assign rule engine under Catalog → Product Attachments → Auto-Assign Rules — attach files automatically to products matching conditions on product category, attribute set or any product attribute, with AND / OR combinations of multiple conditions for complex rule logic (for example "Category = Electronics AND Manufacturer = Samsung").
• Apply-on-Save toggle per auto-assign rule — rules can be applied immediately when saved, or queued for the nightly cron run, or both; perfect for both ad-hoc rebinds and ongoing automation.
• Optional nightly cron run for all active auto-assign rules with configurable schedule (default 02:00, default disabled) — keeps the catalogue in sync as new SKUs are added by product import, ERP feed or supplier sync.
• Automatic Full Page Cache flush after rule application — the frontend reflects new attachment bindings instantly without a manual cache flush, even on Varnish-backed installations.
• Inline preview modal that opens server-side for PDF (embedded iframe), Word .doc and .docx (rendered to HTML via PhpWord with original headings, lists, tables and inline images preserved), Excel .xls and .xlsx (rendered to a styled HTML table via PhpSpreadsheet with cell styles, fonts, colours and borders), PowerPoint .pptx (rendered as a stack of 16:9 slide-cards via PhpPresentation with automatic heading detection and bullet-indent levels), plain text .txt (styled monospace block with UTF-8 / Windows-1252 / ISO-8859 auto-detection), CSV (rendered as a clean HTML table with auto-detected delimiter , ; tab | and BOM stripping), images (native browser rendering), YouTube videos (auto-embedded with thumbnail and player) and direct video files (HTML5 video element).
• Server-side Office rendering — no Microsoft Office Online Viewer dependency, no extra Content-Security-Policy host whitelist, no third-party CDN call; everything renders inside your own Magento environment with the MIT-licensed PhpOffice library family (phpoffice/phpspreadsheet, phpoffice/phpword, phpoffice/phppresentation) pulled automatically as Composer dependencies.
• Legacy binary .ppt (PowerPoint 1997-2003) detection — shows a friendly "save as .pptx and re-upload" notice instead of a broken preview, so authors get a helpful next step rather than a silent failure.
• Robust Content-Type derivation — the preview controller derives the HTTP Content-Type from the actual file extension via a whitelisted map, not from the stored file_type column; preview stays correct even if a file is replaced on disk and the stored MIME drifts.
• Color-coded file-type badges on the frontend (PDF red, Word blue, Excel green, …) — auto-generated from the file extension; immediate visual recognition for customers scanning a long attachment list.
• Custom file-type badge admin grid — upload your own icon (PNG or SVG), set a custom label and badge colour per file extension; perfect for niche file formats (CAD drawing, schematic, firmware, .stl, .gcode) that ship with technical products.
• Auto-generated image thumbnails — image attachments render as thumbnails on the product page without a manual thumbnail upload.
• YouTube video attachments — paste a YouTube URL, the module auto-detects the video ID, pulls the official thumbnail from img.youtube.com and embeds the YouTube player on the product page; CSP whitelist entry for YouTube shipped by default, nothing to configure.
• Direct video file attachments — MP4 / WebM uploaded as a normal attachment plays inline via the HTML5 video element, no external player.
• Attachment categories admin grid under Catalog → Product Attachments → Categories — organise files into Manuals, Data Sheets, Certificates, Safety Information and any custom category you need; per-category sort order and optional frontend grouping render attachments grouped by category on the product detail page.
• Customer-group access control — show attachments only to specific customer groups (Retail, B2B Wholesale, Trade, Resellers, …) with a separate toggle for guest downloads; perfect for shops with public marketing material plus dealer-only data sheets and certificates.
• Download counter per attachment with optional display on the product page — see which documents matter to your customers and feed that signal back into product-page priority and category structure.
• Store-view aware configuration — every section setting can be overridden per website or per store view, so different markets can run different attachment configurations (different language documents, different category labels, different access rules) without installing the module twice.
• Filterable and searchable admin grid columns across all listing pages — Magento-native UiComponent grids with persistent filters, customisable columns, bookmarks and pagination.
• Full ACL coverage — separate permissions for attachment CRUD, category management, rule management, mass-assign and CSV import — restrict each capability to specific admin roles for safe delegation to content teams.
• Internationalisation — complete German translation (de_DE) ships with the module; every user-facing string is translatable via the standard Magento i18n CSV format. Additional languages can be added without code changes.
• Content-Security-Policy ready — csp_whitelist.xml ships with the necessary YouTube and PhpOffice asset entries; the module works on Magento's strict CSP mode out of the box.
• Adobe EQP-compliant codebase — PHPCS Magento2 standard 0 errors / 0 warnings; PSR-4 autoloading under the STM\ProductAttachments\ namespace, declare(strict_types=1) throughout, service contracts via AttachmentRepositoryInterface, CategoryRepositoryInterface, FileExtensionRepositoryInterface and RuleRepositoryInterface, declarative schema only, no core rewrites, no third-party CDN calls, no license-server callout at runtime.

The attachment workflow in five clicks

1. Open a product in Catalog → Products, switch to the Product Attachments tab, drag-and-drop the file (PDF / Office document / image / video / archive) or paste a YouTube URL.
2. Optionally pick an attachment category (Manuals, Data Sheets, Certificates, Safety Information, …) and a sort order, then click Save.
3. Alternatively skip the per-product upload entirely — use CSV import for bulk-creation across hundreds of SKUs, mass-assign from the catalog product grid for one file across many products, or let an auto-assign rule attach the file automatically based on category, attribute set or attribute conditions.
4. The customer opens the product detail page and sees the file in the Attachments tab with its category, thumbnail or color-coded badge, file size and (optionally) download counter.
5. The customer clicks Preview for an inline server-side modal — the document renders without leaving the page — or Download for the file itself; the download counter increments automatically and feeds straight into a sortable column in the admin attachment grid.

Built for shops that ship documentation with every order

• Manufacturers and industrial suppliers — user manuals, data sheets, CAD drawings, safety documents and certificates of conformity, categorised per document type, with B2B-only certificates restricted to the Wholesale customer group.
• B2B wholesalers — technical specifications, certificates of conformity, bulk-order forms and price lists per product; per-customer-group access keeps reseller pricing sheets out of the public view while public marketing PDFs stay visible to guests.
• Electronics and appliance retailers — firmware downloads, drivers, quick-start guides, warranty documents, with custom file-type badges for .bin, .hex and firmware archives so customers recognise the technical files at a glance.
• Food, cosmetics and chemical retailers — ingredient lists, allergen information, nutritional declarations and Safety Data Sheets (SDS) attached to each product, organised in dedicated categories for regulatory clarity.
• Auto, marine and machinery parts — fit guides, exploded views, installation videos via YouTube, and PDF service manuals; the inline preview lets customers verify the part is right without downloading anything.
• Furniture, lighting and home goods — assembly instructions, care guides, dimension sheets and demo videos; the download counter surfaces which manuals are actually used by buyers and which can be retired.
• Multi-tier stores — different documents for different audiences: public marketing flyers visible to guests, technical data sheets visible to registered customers, dealer net-price lists visible only to the Wholesale group — all managed by the same module, all from the same product page.

Section configuration at a glance

 All section settings live under Stores → Configuration → STM → Product Attachments and are scope-aware down to the store-view level. Seven logical groups: General (module on / off toggle, frontend tab title, tab sort order on the product page); File Upload (allowed extensions globally plus per-extension customisation, maximum file size, storage path); Display (show or hide file icon, file size, download count, category grouping, sort criterion); Preview (enable or disable the inline preview modal, modal width, modal close behaviour); Download (open downloads in a new window, update download counter, custom Content-Disposition); Customer Access (allowed customer groups multiselect, separate allow-guest-downloads toggle); Auto-Assign Rules (nightly cron toggle and schedule, default Apply-on-Save behaviour). Category, file-extension and rule management each have their own dedicated admin grid under Catalog → Product Attachments with full CRUD, mass-actions and column filters, separated from system configuration so non-technical admins can manage content without touching infrastructure settings. 

What's new in 2.1.0

 Version 2.1.0 is the inline-Office-preview release and consolidates everything previously distributed as the internal Storetown_ProductAttachments module under the new STM_ProductAttachments namespace, audited for Adobe EQP compliance. Highlights compared to earlier 2.0 lines: 

• The full module source under app/code/STM/ProductAttachments/.
• Installation Guide (PDF) — requirements, Composer and manual install paths, verification, troubleshooting, uninstall procedure.
• User Guide (PDF) — end-to-end walkthrough of every feature with annotated screenshots covering the product-edit tab, the central attachment grid, mass-assign, CSV import, auto-assign rules, attachment categories, file-extension badges, customer access control and the inline preview modal.
• Reference Manual (PDF) — technical reference for developers: admin routes, configuration paths, EAV attributes, database schema, ACL resources, repository interfaces, the preview controller pipeline and CSV import format specification.
• LICENSE.txt at the module root — the Storetown Media Software License (English adaptation, with reference to the canonical German version).
• i18n CSVs for English (en_US) and German (de_DE) with full coverage of every user-facing string.

Licensing

 STM Product Attachments is distributed as a commercial extension under the Storetown Media Software License (EULA). The licence grants a perpetual, non-exclusive, non-transferable right to install and use the software on one (1) production domain plus an unlimited number of staging, development and test environments associated with that production domain. Source-code modification for the licensee's own use within the licensed installation is permitted; redistribution, sublicensing and use on a second production domain are not. 

 Every licence purchase includes a 12-month maintenance period from the purchase date covering all software updates and technical support. After the maintenance period the perpetual right of use remains intact — the most recently received version may continue to be used without time limit; new updates and continued support require a renewal. A 30-day money-back guarantee applies to first-time purchases. The full licence terms are published at https://www.storetown-media.de/licence/. 

Support and updates

 Support is provided by Storetown Media through the Adobe Commerce Marketplace support link on this listing. Expected response time is within two business days. Documentation — installation guide, user guide and reference manual — ships with the extension as PDF and is kept in sync with each release. Questions or pre-sales enquiries: write to info@storetown-media.de or visit https://www.storetown-media.de.