Recently Viewed Items Documentation

The  Recently Viewed Items extension allows you to show your visitors the items they've viewed while browsing your site, offering you an opportunity to increase your sales by showing them the items they've already shown interest in. Getting started is easy. Just install and activate the extension and you're ready to go. Out of the box, recently viewed items will be shown on single download pages and on the checkout page. There's also a widget for displaying them in your sidebar or other widget areas your theme supports.

Single Download Pages

Screenshot of single download page

By default, recently viewed items are displayed on single download pages. This can be changed using the extension's settings. These settings can be found by navigating to Downloads → Settings → Extensions tab.


Screenshot of single settings

There are two settings related to single download pages:

Disable Display on Single Download Pages - this turns off the automatic display of recently viewed items on single product pages. This is useful if you want to do things manually, use the widget instead, or just show them only on the checkout page.

Single Download Heading Text - allows you to supply a custom heading above the recently viewed items.

Checkout Page

Screenshot of the checkout page

By default, recently viewed items are displayed on the checkout page and include an Add to Cart button so that customers can easily add an item to the cart without leaving the checkout page. This display can be disabled in the extension's settings.
Screenshot of checkout page settings

There are two settings related to the checkout page:

Disable Display on Checkout - this turns off the automatic display of recently viewed items on the checkout page. This is useful if you want to minimize distractions on your checkout page, or if you'd prefer to implement an alternative display manually.

Checkout Heading Text - allows you to supply a custom heading above the recently viewed items.

CSS / Styles

Screenshot of styles setting

The extension includes some basic styles for making sure the recently viewed items are displayed with adequate spacing and such, but this may not look exactly the way you want on all themes. In these cases, you can disable the built-in styles and let your theme style them or provide your own custom styles. Check the Default Styles box to disable the extension's styles.

Widget

Screenshot of widget admin

The extension includes a handy widget for displaying recently viewed items in any widget area your theme supports. Simply add it to the desired widget area, adjust the settings to your liking, and profit.
Screenshot of widget on front end

Customization and Developer Information

The extension defaults to showing 3 recently viewed items on single download pages and on the checkout page. This is to keep things clean and less distracting. If you want to change that number, or otherwise make customizations to the layout, you can override the templates used by the extension.

Customizing Templates - To customize the templates, make a folder in your active theme called edd_templates. Copy the appropriate template from the templates folder of the extension into your edd_templates folder. Make your customizations there.

There are two templates included:
edd-rvi-single.php - used for displaying recently viewed items on single download pages. edd-rvi-checkout.php - used for displaying recently viewed items on the checkout page.

Customizing Image Sizes - There are two ways to customize the size of the images shown. 

1. Customize the template using the Customizing Templates section above.

2. Filter the size using the filters available inside the templates. Available image size filters are:
edd_rvi_single_image_size, edd_rvi_checkout_image_size, and edd_rvi_widget_image_size.

Example code for filtering the checkout image size:
https://gist.github.com/mindctrl/b15cb5dd123eab8c2d6a