SamJUK_FetchPriority

This module adds options to set the fetch priority & lazy loading attribute on images added via the admin area.

It also provides a simple API to add preload & prefetch link tags to the header from other modules.

Features

• Automatic <link rel="preload"> for the product page main image, so the browser fetches it before it discovers the <img> tag.
• Automatic preload for the first 4 product images in a category grid (above-the-fold products).
• fetch-priority / loading / preload controls for PageBuilder image content type (desktop & mobile images).
• Public API (LinkStore + Preload/Prefetch factories) to add your own preload/prefetch links from any module.
• Every feature above can be toggled independently, or disabled globally, via admin config.

Requirements

• Magento 2.4.6 - 2.4.8 (see CI matrix badge above)
• PHP 8.1+

Installation

composer require samjuk/m2-module-fetch-priority
php bin/magento setup:upgrade && php bin/magento cache:flush

Configuration

Settings are available at Stores > Configuration > SamJUK > Fetch Priority.

Scope: default / website / store view.

Link Tag Usage

To use this module to add preload/prefetch link tags

Example Preload Usage

class MyClassToAddPreloads
{
     public function __construct(
          private readonly \SamJUK\FetchPriority\Model\LinkStore $linkStore,
          private readonly \SamJUK\FetchPriority\Model\Links\PreloadFactory $preloadFactory
     ) { }

     public function execute()
     {
          // Do Stuff
          $preload = $this->preloadFactory->create([
               'href' => 'https://app.magento2.test/media/my_custom_entity/image1.jpg',
               'mimeType' => \SamJUK\FetchPriority\Enum\Preload\MimeType::ImageJPEG,
               'asType' => \SamJUK\FetchPriority\Enum\Preload\AsType::Image,
               'fetchPriority' => \SamJUK\FetchPriority\Enum\FetchPriority::High
          ]);
          $this->linkStore->add($preload);
     }
}

Example Prefetch Usage

class MyClassToAddPrefetches
{
     public function __construct(
          private readonly \SamJUK\FetchPriority\Model\LinkStore $linkStore,
          private readonly \SamJUK\FetchPriority\Model\Links\PrefetchFactory $preloadFactory
     ) { }

     public function execute()
     {
          // Do Stuff
          $prefetch = $this->preloadFactory->create([
               'href' => 'https://app.magento2.test/media/my_custom_entity/image1.jpg',
          ]);
          $this->linkStore->add($prefetch);
     }
}

Contributing

Bug reports and PRs welcome — see CONTRIBUTING.md.

Security

See SECURITY.md for reporting vulnerabilities.

License

MIT