[Skip to main content](#vessel-content)

#  MP3 Preview plugin

Details    Written by: Administrator    Category: [Pther extensions](/support/documentation/hikashop/other-extensions)     Published: 10 November 2026     Hits: 4

## Installation

1. Install the plugin with the HikaShop or Joomla installer, then publish it in the plugin manager (Hikashop - MP3 Preview).
2. Add your MP3 files to the products, in the "Files" area of the product, with the "free download" option turned off.
3. Open the settings of the plugin to choose where the player appears and how long the preview is.

A preview player is then displayed on the product page for each MP3 file of the product. The preview is a short extract of the file, cut by the plugin the first time it is needed, so customers can listen before they buy. Only MP3 files are handled, and a new preview is cut again when you change the start time or the duration.

## Configuration

![The MP3 Preview settings](/images/doc/plugins/mp3-preview/plg_hikashop_mp3_preview_settings.png)

- **Start time**: the number of seconds after which the preview starts. 0 (default) starts the preview at the beginning of the file, 10 skips the first ten seconds.
- **Duration**: the length of the preview, in seconds. 30 by default.
- **Frontend position**: where the player is placed on the product page: Top begin, Top end, Left begin, Left end, Right begin, Right middle (default), Right end, Bottom begin, Bottom middle or Bottom end.
- **Frontend listing position**: where the player is placed in the product listings: Top, After product name or Bottom. None (default) shows no player in the listings.

When a customer starts a preview, the one that was playing stops.

## Troubleshooting

- **No player on the product page**: check that the plugin is published, that the file is an MP3 attached to the product with "free download" turned off, and that the file can be found on the server.
- **No player in the listings**: set "Frontend listing position" to something else than None.
- **The preview does not change after a setting is modified**: reload the page, the extract is cut again for each new start time and duration.
- **The previews cannot be created**: the extracts are saved in a "previews" folder of the HikaShop images folder, which must be writable by the web server.