How To Add or Edit a Custom Product List
To add or edit a Custom Product List, follow these steps:
- Go to Interface & Design > Custom Product Lists in the IRP Admin left navigation menu.
- To add a new list, click the Add New List button at the of the screen.
- Select the New Custom Product List option.
- To edit an existing Custom Product List click the Edit button to the right of the list that you want to edit.
- Fill in the required details below:
Setting | Description |
Custom Product List ID |
The unique IRP identifier for this Custom Product List, added automatically by the IRP. |
Title |
Enter a title for the Custom Product List, to be used for reference within administration. |
Shipping Country |
Select the shipping country this Custom Product List should display for, or select ‘All Countries’. |
- Once all the details above have been completed, click the Insert Custom Product List button or the Update Custom Product List button.
- Now click the Add Models tab. You will see details of the models in your system, including: ID, Image, Brand, Model Name, Category, Price, RRP, Discount, Active/Inactive, In Stock and Sales Rank.
- Select the models you want to add to the list (or check the 'select all' box at the top of the page) and click the Add Selected Models button. The models that you add will then appear on the tab called Selected Models. All the model details described previously are also shown on this tab. If you subsequently want to remove any of the models shown on this tab, check the relevant Remove boxes (or check the 'select all' box at the top of the page) and then click the Remove Selected Models button. Note that you can define the specific Position of each model by entering a number in the 'Position' box. You can see the effect of the ordering when you preview the Custom Product List on a Custom Content Page. If you want to update the position of any of the models, make the change in the Position box and then click the Update All Models button.
- On the Page Settings tab, complete the following settings:
Setting | Description |
General Page Settings |
Page Title |
Enter the title that will appear at the top of the listing page for this Custom Product List. This will also be used in URLs for the page that are generated using the Link Generator and, if the SEO Title is left blank, this value will be used there. Click the 'Translate' link to translate the content into any active language in your system. |
Include In Sitemap |
Check this box if you want the listing page for this Custom Product List to appear in the XML sitemap of your website. |
URL Text |
This will be used in the URL, if present, to override any other URL text. The order is: Language-specific URL Text > Language-specific Page Title > English URL Text > English Page Title > List Title. Click the 'Translate' link to change language. |
Page Content |
Top HTML Content |
Enter the HTML content that will appear above the products on the desktop listing page. Use the language drop-down list to select an alternative language for the content. |
Bottom HTML Content |
Enter the HTML content that will appear below the products on the desktop listing page. Use the language drop-down list to select an alternative language for the content. |
Page SEO Values |
SEO Title |
Enter the SEO Title for the desktop listing page; if left blank the Page Title will be used. Use the language drop-down list to select an alternative language for the content. |
SEO Description |
Enter the SEO Description for the desktop listing page. Use the language drop-down list to select an alternative language for the Description. |
SEO Keywords |
Enter the SEO Keywords for the desktop listing page. Use the language drop-down list to select an alternative language for the content. |
Mobile Page Content |
Top HTML Content |
Enter the HTML content that will appear above the products on the mobile listing page. Use the language drop-down list to select an alternative language for the content. |
Bottom HTML Content |
Enter the HTML content that will appear below the products on the mobile listing page. Use the language drop-down list to select an alternative language for the content. |
Mobile Page SEO Values |
SEO Title |
Enter the SEO Title for the mobile listing page; if left blank the Page Title will be used. Use the language drop-down list to select an alternative language for the content. |
SEO Description |
Enter the SEO Description for the mobile listing page. Use the language drop-down list to select an alternative language for the Description. |
SEO Keywords |
Enter the SEO Keywords for the mobile listing page. Use the language drop-down list to select an alternative language for the content. |
- Click the Update Page Settings button to save the details.
Previewing and Viewing Custom Product Lists
At the top of the page you can use the following buttons:
- Preview Listing Page: Click this button at any time to see a preview of what the front-end listing page looks like to make sure that it is the way you want it to be. When you click the button, you will then see the following options:
You can see that you can choose to view either the desktop or mobile version of the Listing Page and in any language you have configured in your system. Notice that the 'Sort By' drop-down list is set initially to 'Default' (the products appear sorted simply by their position value in the Custom Product List) but that you (and customers) can select any of the other sorting options in the list.
- View Listing Page: Click this button to view the completed listing page on the front-end of your website. When you click the button, you will then see the following options:
You can see that you can choose to view either the desktop or mobile version of the Listing Page and in any language you have configured in your system. Notice that the 'Sort By' drop-down list is set initially to 'Default' (the products appear sorted simply by their position value in the Custom Product List) but that you (and customers) can select any of the other sorting options in the list.
- View All Custom Product Lists: Click this button to go to the CustomProductLists.aspx page where you can view all the Custom Product Lists in a grid. This page is described in the main 'Custom Product Lists' section at the top of this help topic.
Adding Custom Product Lists to Custom Content Pages
Once you have created Custom Product Lists you can add them to Custom Content Pages. To do this, you simply need to either 1) click the 'Add Product List' button on the Custom Content Page and follow the instructions or, 2) copy the placeholder on the main CustomProductLists.aspx page (for example, $$ProductList1$$
) and paste it into the Custom Content Page. (Note that, when customers view a Custom Content Page that includes a Custom Product List containing inactive Models, the inactive Models will not be displayed.) See the Custom Content Pages help topic for more information.
https://www.irpcommerce.com/en/gb/IRPSupport/Custom-Product-Lists/kb-303.aspx?HowTo=312#HowToGuide312
How To Add or Edit a Custom Criteria List
To add or edit a Custom Criteria List, follow these steps:
- Go to Interface & Design > Custom Product Lists in the IRP Admin left navigation menu.
- To add a new list, click the Add New List button at the of the screen.
- Select the New Custom Criteria List option.
- To edit an existing Custom Criteria List click the Edit button to the right of the list that you want to edit.
- Fill in the required details below:
Setting | Description |
Custom Product List Details |
Criteria ID |
The unique IRP identifier for this Custom Product List, added automatically by the IRP. |
Custom Product List Title |
Enter a title for the Custom Product List, to be used for reference within administration. |
Shipping Country |
Select the shipping country this Custom Product List should display for, or select ‘All Countries’. |
Products Currently Returned |
This shows the number of products that are currently returned for this custom product list criteria. |
Criteria Specification |
Max Products To Show |
Select the maximum number of products to display in the custom product listing. You can also select 'All'. |
Ignore 'Max Products To Show' On Listing Page |
Having this setting enabled will let the listing page for this product list show all of the models that apply to the criteria while still being able to restrict the list when it's used elsewhere. If disabled, the listing page for this list will adhere to the Max Products To Show setting. |
Must Have An Image |
Determines if the models in this listing must have an image. |
In Stock Only |
When selected only models that are in stock will be used. |
Include Kits |
Specify whether to include kits in this custom product list. |
Sort Results By |
Specify how models within this custom product listing should be sorted. |
Min Price |
The minimum price for products displayed on this custom product listing. |
Max Price |
The maximum price of products displayed in this custom product listing. |
Min Discount |
Specify the minimum discount between the RRP and min price for products displayed in this custom product listing. |
Max Discount |
Specify the maximum discount amount between the RRP and the min price for models in this custom product listing. |
Advanced Options |
Search String |
Enter any terms that must be included within the names of models returned for this custom product list. |
Excluded Model IDs |
Enter a comma-separated list of modelIDs to exclude from this custom product list. |
Product Gender |
The gender, if applicable, for this custom product list. |
Year |
The year, if any, for models returned in this custom product list. |
Season |
The season, if any, for models returned in this custom product list. |
Ordered Within Last |
Specify whether the models to be returned have been ordered within this number of days. |
Only Products Sold To |
If specified the returned models must have been sold to this country. |
Offer Type |
Specify the offer types that returned models must have. Select from: Not On Offer, Sale, Clearance, Sale And Clearance, Back in Stock, New, Custom Offer Type 1, Custom Offer Type 2, Custom Offer Type 3 or Custom Offer Type 4. |
- Once all the details above have been completed, click the Insert Custom Product List Criteria button or the Update Custom Product List Criteria button.
- Now click the Brand/Category/Attribute Restrictions tab.
- Use the Brand Restrictions, Category Restrictions and Attribute Restrictions sections to restrict brands, categories or attributes using the 'Add' and 'Remove' buttons to move selections between the 'Available' and 'Selected' boxes.
- Click the Update Custom Product List Criteria button to save your changes.
- On the Page Settings tab, complete the following settings:
Setting | Description |
General Page Settings |
Page Title |
Enter the title that will appear at the top of the listing page for this Custom Product List. This will also be used in URLs for the page that are generated using the Link Generator and, if the SEO Title is left blank, this value will be used there. Click the 'Translate' link to translate the content into any active language in your system. |
Include In Sitemap |
Check this box if you want the listing page for this Custom Product List to appear in the XML sitemap of your website. |
URL Text |
This will be used in the URL, if present, to override any other URL text. The order is: Language-specific URL Text > Language-specific Page Title > English URL Text > English Page Title > List Title. Click the 'Translate' link to change language. |
Page Content |
Top HTML Content |
Enter the HTML content that will appear above the products on the desktop listing page. Use the language drop-down list to select an alternative language for the content. |
Bottom HTML Content |
Enter the HTML content that will appear below the products on the desktop listing page. Use the language drop-down list to select an alternative language for the content. |
Page SEO Values |
SEO Title |
Enter the SEO Title for the desktop listing page; if left blank the Page Title will be used. Use the language drop-down list to select an alternative language for the content. |
SEO Description |
Enter the SEO Description for the desktop listing page. Use the language drop-down list to select an alternative language for the Description. |
SEO Keywords |
Enter the SEO Keywords for the desktop listing page. Use the language drop-down list to select an alternative language for the content. |
Mobile Page Content |
Top HTML Content |
Enter the HTML content that will appear above the products on the mobile listing page. Use the language drop-down list to select an alternative language for the content. |
Bottom HTML Content |
Enter the HTML content that will appear below the products on the mobile listing page. Use the language drop-down list to select an alternative language for the content. |
Mobile Page SEO Values |
SEO Title |
Enter the SEO Title for the mobile listing page; if left blank the Page Title will be used. Use the language drop-down list to select an alternative language for the content. |
SEO Description |
Enter the SEO Description for the mobile listing page. Use the language drop-down list to select an alternative language for the Description. |
SEO Keywords |
Enter the SEO Keywords for the mobile listing page. Use the language drop-down list to select an alternative language for the content. |
- Click the Update Page Settings button to save the details.
Previewing and Viewing Custom Product Lists
At the top of the page you can use the following buttons:
- Preview Listing Page: Click this button at any time to see a preview of what the front-end listing page looks like to make sure that it is the way you want it to be. When you click the button, you will then see the following options:
You can see that you can choose to view either the desktop or mobile version of the Listing Page and in any language you have configured in your system.
- View Listing Page: Click this button to view the completed listing page on the front-end of your website. When you click the button, you will then see the following options:
You can see that you can choose to view either the desktop or mobile version of the Listing Page and in any language you have configured in your system.
- View All Custom Product Lists: Click this button to go to the CustomProductLists.aspx page where you can view all the Custom Product Lists in a grid. This page is described in the main 'Custom Product Lists' section at the top of this help topic.
Adding Custom Product Lists to Custom Content Pages
Once you have created Custom Product Lists you can add them to Custom Content Pages. To do this, you simply need to either 1) click the 'Add Product List' button on the Custom Content Page and follow the instructions or, 2) copy the placeholder on the main CustomProductLists.aspx page (for example, $$ProductList1$$
) and paste it into the Custom Content Page. See the How To Add or Edit a Custom Content Page help topic for more information.
https://www.irpcommerce.com/en/gb/IRPSupport/Custom-Product-Lists/kb-303.aspx?HowTo=313#HowToGuide313