PHPackages                             drunomics/amazon\_product\_widget - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. drunomics/amazon\_product\_widget

AbandonedArchivedDrupal-module[Utility & Helpers](/categories/utility)

drunomics/amazon\_product\_widget
=================================

A field widget to render amazon products.

1.5.3(4y ago)118.6k3[1 issues](https://github.com/drunomics/amazon-product-widget/issues)[1 PRs](https://github.com/drunomics/amazon-product-widget/pulls)GPL-2.0+PHP

Since Mar 20Pushed 3y ago1 watchersCompare

[ Source](https://github.com/drunomics/amazon-product-widget)[ Packagist](https://packagist.org/packages/drunomics/amazon_product_widget)[ RSS](/packages/drunomics-amazon-product-widget/feed)WikiDiscussions 1.x Synced 4d ago

READMEChangelogDependencies (1)Versions (51)Used By (0)

**Deprecated:** moved to [https://www.drupal.org/project/amazon\_product\_widget](https://www.drupal.org/project/amazon_product_widget)

Amazon product widget
=====================

[](#amazon-product-widget)

Provides a field widget to render amazon products given ASINs.

The product data will be fetched from Amazon using the [Product Advertising API](https://docs.aws.amazon.com/AWSECommerceService/latest/DG/Welcome.html). Once the data is fetched it will be cached locally to stay withins Amazons request limit.

On top of that the widget itself will be loaded via Ajax which will be cached in the response. This way an article or page can be cached indefinitely but the amazon products will be updated regularly disregarding the sites overall caching strategy.

Table of content
----------------

[](#table-of-content)

- [Amazon product widget](#amazon-product-widget)
    - [Table of content](#table-of-content)
    - [Features](#features)
    - [Requirements](#requirements)
    - [Installation](#installation)
    - [Configuration](#configuration)
        - [Amazon settings configuration](#amazon-settings-configuration)
        - [Amazon product widget configuration](#amazon-product-widget-configuration)
        - [Deals configuration](#deals-configuration)
        - [Caching and request limits](#caching-and-request-limits)
        - [Permissions](#permissions)
    - [Usage](#usage)
    - [Overrides](#overrides)
    - [Commands](#commands)
        - [Basic commands](#basic-commands)
        - [Override commands](#override-commands)
        - [Deals commands](#deals-commands)
        - [Usage commands](#usage-commands)
    - [Hooks](#hooks)
    - [Maintainers](#maintainers)

Features
--------

[](#features)

- Fetch & render amazon products within a field widget
- Fetches the field via Ajax to get cached product data
- Generic styling for Desktop & Mobile
- Fallback to amazon search results when products are unavailable
- Can download and parse deal information and display correct price if deal is available

Requirements
------------

[](#requirements)

You will need an Amazon Associates account and register it for the Product Advertising API to get the credentials needed.

Installation
------------

[](#installation)

- `composer require drunomics/amazon_product_widget`
- Install this module as you would a normal Drupal module

Configuration
-------------

[](#configuration)

### Amazon settings configuration

[](#amazon-settings-configuration)

Enable & configure the amazon\_paapi module, which was install with composer, see README of the module.

### Amazon product widget configuration

[](#amazon-product-widget-configuration)

Set the following `amazon_product_widget.settings` configuration:

- `max_requests_per_day` - Amazons own request per day limit (default 8640) (see [Caching and request limits](#caching-and-request-limits))
- `max_requests_per_second` - Amazons own request per second limit (default 1) (see [Caching and request limits](#caching-and-request-limits))
- `render_max_age` - Render cache for the widget in seconds
- `call_to_action_text` - Link text for the product which leads to amazon page
- `price_decimal_separator` - Decimal separator used for the price
- `price_thousand_separator` - Thousand separator used for the price
- `fill_up_with_fallback` - Search terms will always fill up to 3 products even if only one ASIN was entered into the widget
- `amazon_api_disabled` - Use this to disable api calls, e.g. on ci or any non production environments to prevent using up requests.

Add the `Amazon product widget` field to a node or paragraph and configure form & display.

### Deals configuration

[](#deals-configuration)

Set the following `amazon_product_widget.deal_settings` configuration:

- `max_csv_processing_time` - maximum processing time (in seconds) that a chunk of the Deals CSV will be processed. (default: 30)
- `deal_feed_url` - Deal Feed URL: this must point to the Deal file that Amazon provides.
- `deal_feed_username` - Deal Feed username that Amazon provided.
- `deal_feed_password` - Deal Feed password that Amazon provided.
- `deal_feed_activated` - Whether the Deal Feed is active i.e. prices are taken from deals if available. (default: false)
- `deal_cron_interval` - Interval at which the deals will be updated in minutes. (default: 1440)

### Caching and request limits

[](#caching-and-request-limits)

Amazon has very specific requirements regarding request limits (see [Efficiency Guidelines](https://docs.aws.amazon.com/AWSECommerceService/latest/DG/TroubleshootingApplications.html#efficiency-guidelines).) so it is necessary to cache the data locally and update it on a regular basis via cronjob. At least there is a base limit per day (8640) and one per second, these can be overriden if needed.

When the data is saved it will set a renewal date (which is 48 hours by default) for when the cronjob will try to update the data form amazon again. The next renewal can be overridden in the setting (in hours):

`amazon_product_widget.products.renewal_time``amazon_product_widget.search_results.renewal_time`

The number of items which will be renewed per cron run is by default 100, and can be set in this setting:

`amazon_product_widget.products.renewal_limit``amazon_product_widget.search_results.renewal_limit`

### Permissions

[](#permissions)

- `Renew amazon product data` - for being able to manually refresh the product data via `/admin/config/services/amazon/product-renewal`

Usage
-----

[](#usage)

In the form widget, enter one or more ASINs for the products which should be displayed by default. Amazon Standard Identification Numbers (ASINs) are unique blocks of 10 letters and/or numbers that identify items. You can find the ASIN on the item's product information page at Amazon.

Optionally enter search terms which will be used when the products are unavailable to list the search results in place of the entered products.

Overrides
---------

[](#overrides)

The module allows for overrides to be set for each individual product. This is useful if you want to set any custom data to be stored along with product information, like override images, title, etc. To set an override, simply use the `'amazon_product_widget.product_service'` service and call the method `setOverrides()`. The argument is an array. Each key should be the product ASIN you are setting the overrides for. The value can be any type.

An example:

```
$productService = \Drupal::service('amazon_product_widget.product_service');
$productService->setOverrides([
    'B00318CA92' => [
        'additional_info' => 'This is some additional information',
    ],
]);
```

The overrides are now set. You can get them back by calling `getProductData(['B00318CA92'])`which will return:

```
[
    'B00318CA92' => [
        'ASIN' => 'B00318CA92',
        // All other fields filled by Amazon...
        'overrides' => [
            'additional_info' => 'This is some additional information',
        ],
    ],
]
```

Commands
--------

[](#commands)

### Basic commands

[](#basic-commands)

The module comes with a set of commands which you can use to interact with the modules functionality.

- `apw:queue-product-renewal`

Queues all products for renewal, this will be done in the next cron run.

- `apw:run-product-renewal`

Runs the product renewal immediately without waiting for cron. When the request limit is reached, this command will stop and show the number of products still waiting for renewal. You can run it multiple times to update all products.

- `apw:stale`

Shows the number of stale products (needing updating) that are currently in the database.

### Override commands

[](#override-commands)

- `apw:overrides `

Shows the overrides stored for the product with the provided ASIN.

- `apw:reset-all-renewals`

Resets all renewals so that all the products in the database will be considered stale and updated on the next cron run.

### Deals commands

[](#deals-commands)

The following commands are available related to the Deals Feed API.

- `apw:deals:active-deals`

Gets the total number of active deals currently in the Deal store.

- `apw:deals:update `

Updates the Deals store with the deals provided in CSV file. If no path is provided, the file will be downloaded from the Amazon API (if configured).

- `apw:deals:info `

Gets Deal information for a particular ASIN.

### Usage commands

[](#usage-commands)

The following commands are available to get information about product usage.

- `apw:entity-products  `

Returns products that are contained in the given entity. `` is optional and defaults to 'node'.

- `apw:product-entities `

Returns the entity ID and type that contain the given product (ASIN).

Hooks
-----

[](#hooks)

The module provides the following hooks:

`hook_amazon_product_widget_alter_product_data(array &$products_container, AmazonProductField $product_field, NodeInterface $node = NULL)`

It allows modification of product data passed to the product widget template. You would modify the product data in the product container. Also passed is the Amazon product field, and lastly the node on which the field is being displayed on. This can also be NULL in the case where the field is attached to a taxonomy term.

`hook_amazon_product_widget_alter_validate_product_data(AmazonProductField $product_field, array $product_data)`

Allows you to validate if the product is valid. This allows you to show the amazon product widget even though the product is not available, then you can, for example, show your own custom message instead of the product box being absent altogether.

`hook_amazon_product_widget_get_custom_asin_map(FieldableEntityInterface $entity)`

Whenever an entity is saved, an ASIN map in the database gets updated, so we always know which entity contains which products (ASINs) and which product belongs to which entities.

If you have products (ASINs) stored in a custom field in an entity, you can extract and return them here, they will be added to the ASIN map for that entity.

Maintainers
-----------

[](#maintainers)

- Mathias (mbm80) -

Supporting organizations:

- drunomics -

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 53.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~20 days

Recently: every ~26 days

Total

50

Last Release

1605d ago

Major Versions

0.x-dev → 1.0.02019-04-09

### Community

Maintainers

![](https://www.gravatar.com/avatar/eeeeebd20b7521af69522a34b9ea485911ceb2a95f4d8616de37c05e60a4d2a9?d=identicon)[mbm80](/maintainers/mbm80)

---

Top Contributors

[![mihawagner](https://avatars.githubusercontent.com/u/60344344?v=4)](https://github.com/mihawagner "mihawagner (91 commits)")[![mbm80](https://avatars.githubusercontent.com/u/19147241?v=4)](https://github.com/mbm80 "mbm80 (74 commits)")[![maximilianmikus](https://avatars.githubusercontent.com/u/1254146?v=4)](https://github.com/maximilianmikus "maximilianmikus (3 commits)")[![michaellenahan](https://avatars.githubusercontent.com/u/219397?v=4)](https://github.com/michaellenahan "michaellenahan (2 commits)")

### Embed Badge

![Health badge](/badges/drunomics-amazon-product-widget/health.svg)

```
[![Health](https://phpackages.com/badges/drunomics-amazon-product-widget/health.svg)](https://phpackages.com/packages/drunomics-amazon-product-widget)
```

###  Alternatives

[oittaa/uuid

A small PHP class for generating RFC 9562 universally unique identifiers (UUID) from version 3 to version 8.

50302.7k5](/packages/oittaa-uuid)[mbezhanov/ethereum-converter

A simple library for performing conversion between various Ethereum units

1836.7k](/packages/mbezhanov-ethereum-converter)[wbraganca/yii2-nested-set-behavior

This extension allows you to get functional for nested set trees.

229.4k](/packages/wbraganca-yii2-nested-set-behavior)[x-wp/di

The dependency injection container for WordPress

301.1k10](/packages/x-wp-di)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)