Product Attachments for Magento 2

What you get

Key Features

Attach Anywhere

• Products — attach unlimited files or links to any simple, configurable, bundle, grouped, virtual, or downloadable product
• Categories — add category-level attachments (brochures, lookbooks, size charts) inherited by child products optionally
• CMS Pages — enrich About, FAQ, Policy, or Landing pages with downloadable resources
• Multi-entity — one attachment can be linked to many products/categories/pages at once (no duplication)

Centralized File Manager

• Upload once, reuse everywhere — single-source file library for all attachments
• Versioning — upload a new version while preserving old download URLs and history
• File replacement — swap a file in place without editing every product
• Bulk assign/unassign — mass-attach files to multiple products from the grid
• Drag-and-drop uploads — modern admin UI with progress bars

Download Analytics

• Per-file download counter — see exactly how many times each file has been downloaded
• Per-customer log — track which customer/guest downloaded what, when, and from which product
• Date-range reports — filter downloads by day, week, month, or custom range
• Top-downloaded grid — identify the most popular assets at a glance
• CSV export — export download logs for BI or compliance

Attachment Types

• Built-in types — PDF, DOC, XLS, PPT, ZIP, Image, Video, Audio, External Link
• Custom types — define your own (e.g., "Spec Sheet", "Warranty", "User Manual", "Safety Data Sheet")
• Type-specific icons — auto-detected file-type icons with customization
• Filter frontend listing by type — customers can toggle "Manuals", "Videos", "Specs" etc.

Customer Group Access Control

• Per-attachment visibility — restrict files to Retail, Wholesale, VIP, or custom customer groups
• Guest vs logged-in — require login to download sensitive documents
• Login-gated downloads — optional prompt before download triggers
• B2B-ready — ideal for dealer portals, price lists, contracts

Frontend Display

• Dedicated product tab — files list rendered in a native Magento product tab
• Inline block — or display below short description / above add-to-cart
• Icon + title + size + type — professional table layout with sort & filter
• Responsive — mobile-first layout, tested on all breakpoints
• Download counter display — optional "Downloaded X times" badge for social proof

Widget

• Drag-and-drop widget — place an attachments block on any CMS page, block, or layout position
• Configurable source — specific product, category, or file IDs
• Filter by type — show only PDFs, only videos, etc.
• Layout options — grid, list, or compact views

Hyva & Luma Storefront

• Hyva-native templates — Alpine.js + Tailwind CSS, no jQuery/KnockoutJS, lightning-fast
• Luma compatibility — native Magento Luma theme templates, fully responsive
• Auto theme detection — via Panth_Core helper, no manual config needed
• No layout conflicts — isolated CSS class prefixes

Security & Quality

• Secure file delivery — files served through signed controller, direct filesystem paths hidden
• File type whitelist — admin-configurable allowed extensions, MIME validation
• Max file size enforcement — server-side check
• Rate limiting — optional per-IP download throttling
• MEQP compliant — passes Adobe's Magento Extension Quality Program
• Zero third-party JS libs — vanilla JS + Alpine on Hyva, jQuery on Luma

Use Cases

• Electronics & Appliances — user manuals, spec sheets, firmware, warranty PDFs, CAD files
• Fashion & Apparel — size guides, care instructions, sustainability reports, lookbooks
• Food & Beverage — nutrition sheets, allergen info, recipe cards, certificates
• Health & Beauty — ingredient lists, safety data sheets (SDS), clinical studies
• B2B / Wholesale — price lists, contracts, NDAs, catalog PDFs, dealer-only docs
• Home & Garden — assembly guides, care manuals, dimension drawings
• Software / Digital — license agreements, release notes, installer downloads
• Automotive — compatibility charts, installation videos, parts diagrams

How It Works

1. Upload files via Panth Infotech → Product Attachments → Manage Files
2. Assign files to one or more products, categories, or CMS pages via the attachments grid
3. Configure per-attachment visibility, customer group restrictions, and type
4. Customers see attachments in the product page tab, category page, or CMS page
5. Downloads are tracked in real time; view analytics in Panth Infotech → Product Attachments → Download Log
6. Upload new versions any time without breaking existing URLs

Widget Usage

1. Go to Content → Elements → Widgets → Add Widget
2. Select Type: Product Attachments and your theme
3. Configure the storefront properties and widget options:

• Source: specific product IDs, category IDs, or all
• Filter by attachment type
• Layout: grid, list, or compact
• Items per row / limit

4. Place the widget on any CMS page, block, or layout position

Inline CMS usage:

{{widget type="Panth\ProductAttachments\Block\Widget\Attachments" product_id="123" layout="grid"}}

Hyva & Luma Support

This module ships with two parallel template sets:

• Hyva — view/frontend/templates/hyva/ using Alpine.js + Tailwind CSS utility classes. No jQuery, no KnockoutJS, no RequireJS on the frontend.
• Luma — view/frontend/templates/ using standard Magento KnockoutJS + jQuery widgets.

Theme detection is fully automatic via Panth\Core\Helper\Theme::isHyva(). No manual configuration is required. You can install this module on a mixed Hyva + Luma multi-store setup and each storefront will render the correct template.

Compatibility

Tested on:

• Magento 2.4.8-p4 with PHP 8.4 (Hyva 1.3 + Luma)
• Magento 2.4.7 with PHP 8.3
• Magento 2.4.6 with PHP 8.2

Installation

Composer Installation (Recommended)

composer require mage2kishan/module-product-attachments
bin/magento module:enable Panth_Core Panth_ProductAttachments
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy -f
bin/magento cache:flush

Manual Installation via ZIP

1. Download the latest release ZIP from Packagist or the Adobe Commerce Marketplace
2. Extract the contents to app/code/Panth/ProductAttachments/ in your Magento installation
3. Also install Panth_Core (free dependency) from github.com/mage2sk/module-core
4. Run the same commands as above starting from bin/magento module:enable

Verify Installation

bin/magento module:status Panth_ProductAttachments
# Expected output: Module is enabled

After installation, navigate to:

Admin → Panth Infotech → Product Attachments → Manage Attachments
Admin → Stores → Configuration → Panth Extensions → Product Attachments

Configuration

Navigate to Stores → Configuration → Panth Extensions → Product Attachments.