Configure domain cross-selling

Certain products may require a domain name that purchasers need to choose at the time they purchase the product. The Plaza theme offers a feature that lets you configure domain cross-selling, such that purchasers are directed to a domain cross-selling page when they decide to buy a product that requires it. This feature is enabled by default.

To use this feature, you must be set up to sell domains. See Sell domains for a general discussion of this topic, and Set up domain providers for specific instructions on how to set up a connection with a domain integration service.

The domain cross-selling feature is configured in two stages:

• First, you must configure the theme's cross-selling page—or add it, if it does not already exist.
• Once the page is available, it can be enabled for individual products by enabling Domain Management in the product definition and re-publishing the product.

Adding a cross-selling page

By default, a theme based on the Plaza theme should already offer a domain cross-selling page. This profile-cross-sell-management.html file is located in the themes/_themeName_/content/pages/profile/ folder.

If this page is not already included in your theme—for example, if you are working with a theme based on an older version of the Plaza theme—you must add the page by creating it in a text editor:

1. Create a new page as described in Create the pages.

2. Save this new page. Name it profile-cross-sell-management.html, and save it in the themes/_themeName_/content/pages/profile/ folder.

3. Enter the following code in the file as the basis for the page:

   {% extends "/layout/profile.html" %}
   
   {% block data %}
   <data type="navigator" />  
   <data type="application-additional-content" value="addonProducts,questions" />
   {% endblock %}
   
   {% block profileContentHeader %}{% endblock %}
   
   {% block profileContent %}
   <component name="ProductAssociatedDomain" id="ProductAssociatedDomain1"></component> 
   {% endblock %}

4. Customize the page layout as you see fit. You must keep the <component> tag unchanged, to ensure that the domain cross-selling user interface is rendered correctly.

5. When you have finished your customization, save the page.

The new page will be available when the theme is next packaged, uploaded, and published.

Enabling the feature for a product

To enable the feature for a specific product, you must edit the product's integration by activating Domain Management for the product and entering the information needed for the domain integration.

📝 Note: If the AppDirect logo appears in the upper-left corner of the page, when Manage > Marketplace appears in this topic, click the grid icon > Switch to | Store, instead.

1. Go to Manage > Marketplace > Products > Catalog | Production Catalog.
   The catalog opens.
2. Navigate to the product for which you want to enable for domain cross-selling, and click the gear icon that appears beside it.
3. Choose Edit Product from the drop-down list.
   The Product Dashboard for the product appears.
4. In the left menu, click Integration | Edit Integration.
   The Edit Integration page appears.
5. Scroll down to the Domain Management section and enable it (near the bottom).
   Fields appear in the Domain Management section. You must fill these out as described in the Edit Integration topic of the online help.
6. When you are finished, click Save to save the change.

The product must be re-published to make the feature available.

Disabling the feature in the theme

The domain cross-selling feature is enabled by default, meaning that you have the option of setting Domain Management for any product you offer on your marketplace. However, it is possible to disable the feature.

To disable the feature available to all products in the marketplace, add the crossSellingEnabled flag to the theme's settings-schema.json file in the top theme directory, and set it to false:

{
	"useComponents": true
	**"crossSellingEnabled": false**
}

Save the change. When the theme is next packaged, uploaded, and published, the domain cross-selling feature will be disabled. Product definitions may still have Domain Management settings, but they will have no effect: the domain cross-selling page will not appear during checkout for any product.