Cause

The existing approach to the menu customization, implemented for the CCP v1, is not suitable for the CCP v2.

Resolution

The CCP v2 is based on APS technology and requires a different approach to the menu customization. You should create an APS application to add an additional item in the menu in the CCP v2. For detailed information how to create an APS application please refer to APS Standard website.

If you are not planning some complicated customizations, for example, you need to create an additional item in the menu, showing screen with some static or dynamic content, like links to documentation or video, you can use a sample APS application (support.app.zip).

To install an APS application package in Odin Automation, do the following:

  1. In the PCP, go to Services > Applications.
  2. Click Import Package.
  3. Select the sample APS application package and click Submit.

To create an APS instance, do the following:

  1. In the PCP, go to Services > Applications.
  2. Find the newly installed sample package, named Support, and click on its name.
  3. Switch to the Instances tab and click Add Instance.
  4. For UI-only applications (like the sample app above) you should define https://127.0.0.1:8081/pa/rest/fake/ in the Application API end-point URI field. If your APS application has a backend, specify appropriate Application API end-point URI and follow the wizard steps.

Now your customers will see a new menu item in the CCP v2, named Support. By clicking the Support item, they will see the screen with some sample text.

Customization

To change the label and icon of the menu item, do the following:

  1. Open APP-META.xml file and find the following block:

    <navigation icon="fa-question-circle" id="item-support" label="Support">
    <plugs-to id="http://www.parallels.com/ccp/2"/>
    <view id="view-support" label="Support" src="ui/support.js">
        <var collection="true" name="services" type-id="http://aps-standard.org/types/core/subscription/service/1.0"/>
    </view>
</navigation>
  2. In the navigation tag change icon attribute's value on your own icon file name. Change label attribute's value on your own.
  3. In the view tag specify src attribute's value. It defines script processing the view shown in the CCP.

To create more complicated custom page in the CCP v2, refer to APS documenation portal.

Limitation

Your custom menu item will be shown to all the customers. You can't define per customer or per vendor configuration of displaying the new item.

Internal content