Installation and setup

The add-on stores product price change history and displays it on the product page as a chart. It also calculates the average price from the saved history and allows administrators to clear accumulated data from the admin panel.

Installation

1. Upload the add-on files to the addons directory of your store.
2. Open Add-ons → Manage add-ons.
3. Find the “Product Price History Chart” add-on and click Install.
4. Make sure the add-on is enabled.

During installation, the add-on runs migrations and creates a dedicated table for price history storage.

Where the settings are located

Open Add-ons → Manage add-ons → Product Price History Chart → Settings.

The add-on has two main controls.

• How many price records to keep in history: defines the maximum number of history records per product. Despite the internal parameter name, this setting limits the number of saved records, not the number of calendar days.
• Clear price history table: a service button used for complete cleanup of accumulated price history for all products.

How history collection works

1. When an administrator changes the product price, the add-on compares the new price with the last saved record.
2. If the price changed, the add-on adds a new history record.
3. If the price did not change, no new record is created.
4. If the number of records for a product exceeds the configured limit, the oldest records are removed automatically.

This means the history starts accumulating from the moment the add-on is installed and from subsequent price changes. The add-on does not reconstruct past prices retroactively.

How to display the chart on the storefront

1. Go to Design → Layouts.
2. Open the product page layout.
3. Add the Price History block.
4. Place the block in the required section of the product page and save the layout.

After that, the product page can display the chart and statistics based on saved history.

What the customer sees

• Price change chart: shows how the product price changed according to saved history points.
• Average price: calculated from saved values.
• Minimum and maximum price: displayed based on accumulated price history.

How to clear price history

1. Open the add-on settings.
2. Click Clear price history table.
3. Confirm the action if your interface requests confirmation.

After cleanup, accumulated history is removed from the storage table and charts start building again only after the next price changes.

How to test

1. Install the add-on and add the “Price History” block to the product page.
2. Open any product in the admin panel and change its price several times.
3. Save the product after each change.
4. Open the product page on the storefront and verify that the chart appears and updates.
5. Check that the block correctly displays average, minimum, and maximum price.
6. If needed, test the cleanup function and verify that the history is removed.

Good to know

• If product prices have not changed since installation, the chart may be empty because no history has accumulated yet.
• The smaller the record limit, the shorter the visible history for each product.
• Clearing the history table affects all products at once, not a single selected product.