| Table of Contents |
|---|
...
Ensure that the Linked Products Plugin is installed by going to Admin > Configuration > Local Plugins and search for “Linked Products”. Check that it is installed and, if not, install it. This plugin is required for linked products.
Create the' IsRenewal' Specification Attribute if it doesn’t already exist.
Go to Catalog > Attributes > Specification attributes and click Add New to create a new attribute if it doesn’t already exist.
Name it ‘IsRenewal’
Add a new option and input 'True' as the name.
Save it
Product Shells for renewal product(s) should be created according to the configuration guide.
...
Confirm that the following product classification(s) are created.
The ‘Is Renewal Product’ Product Classification must be added as a classification if not already set up as a product classification.
To set the ‘Is Renewal Product’ Product Classification up as a new classification go to Aspenware Commerce>Product Classifications and select Add Classification and define the following fields as follows
Name: Is Renewal Product
Description: Assign this classification to renewal products.
Select the checkbox for Is Renewal
Click Add.
The ‘Renewal Lock’ Product Classification must be added as a classification if not already set up as a product classification.
To set the ‘Renewal Lock’ Product Classification up as a new classification go to Aspenware Commerce>Product Classifications and select Add Classification and define the following fields as follows
Name: Renewal Lock
Description: Assign this classification to renewal products.
Select the checkbox for Renewal Lock
Click Add.
Language Strings
Go to Configuration > Languages > English > String Resources to set specific language strings that apply to the renewal page. Use the following language strings to edit what customers see in the following scenarios.
If a customer does not have any eligible products, they will see configurable messaging on the renewals or linked product page.
If they are not logged in, they will not see any products and will be shown configurable messaging on the page.
...
An HTML widget can be enabled that displays below the category bar and shows configurable messaging that links to the renewal or linked products page for logged in customers and to the login page for users who are not signed in. From Nop Templates > Plugins > HTML Widgets > Manage HTML Widgets, select to edit, or create a new widget for, ‘Renewal Homepage Banner’ widget. From Tools > source code, you can paste in or edit the HTML. The HTML that is configurable is in blue below.
...
This task assumes that the prerequisite task of configuring the product shell for the renewal products has been configured according to this Configuration Guide.
Go to Catalog > Products and choose to Edit the product.
Assign the product to a category that has been set up to be hidden. (Instructions on hiding a category here)
These products are set up as very simple products, so define the SKU and Price in the Product info section, unless they are going to be leveraging Aspenware Payment Plan functionality.
| Info |
|---|
NOTE: IF a product is a renewal product and is going to leverage Aspenware Payment Plan functionality, the following setup is recommended because these products cannot have the product defined on the product info tab and must have the SKU and price defined in the attribute combination table.
|
Go to the Attributes section and click Add a new attribute to add the AssignedTo attribute. This will lock down the assigned customer so that guests cannot change these options.
From the Attribute drop-down, select ‘AssignedTo’.
Enter ‘{ "lock": true } [Assigned To]’ in Text Prompt field.
Set Control Type to 'Text'.
Click Save and Continue Edit
From here, add desired add-on products to the product. A renewal product cannot have a core attribute added to it but can have add on attributes. Follow the configuration guide for simple add-on products to add standard add-ons to the renewal product.
Attributes used to associate add-on products to renewal products must use the Control type of ‘CHECKBOXES’. Using the CHECKBOXES control type enables the add-on to be selected or deselected on the PDP during the purchase flow.
| Note |
|---|
IMPORTANT: For renewal products, something needs to be typed in the Text prompt field for EVERY attribute, though this will not show for customers. |
Next, open the Specification attributes section and select Add attribute to add the ‘IsRenewal’ specification attribute. This will ensure that if someone does somehow locate the standard PDP for this renewal product they will not able to add it to the cart, and this product can only be added to the cart through the gated renewal page.
Choose ‘Custom text’ from the Attribute type drop-down.
Select the ‘IsRenewal’ attribute.
Type ‘Yes’ in the Value field.
Check Show on product details page.
Save it.
Save the overall renewals product.
2. Add Product Classifications to Renewal Product.
Go to Aspenware Commerce > Product Classifications > Add Assignment, and select the hidden Category where the renewal product lives, and the renewal Product requiring assignment.
In the Classification table, click the Assign checkbox next to the following classifications
'Requires Assignment''
‘Is Renewal Product’
'Renewal lock'
Click Add.
HINT: Products flagged with the renewal classifications will only be available on the (store URL)/renewal or (store URL)/linked products pages if the logged-in customer has previously purchased an RTP|One product component that links to this current product via product component link configuration.
...