Application Packaging Standard

Last updated 18-Mar-2019

Skin Deployment

First of all, let us consider the implementation of an existing package. If you have an APS 1 package containing a custom skin you can deploy and test it as explained here.

Import Skin Package

To import the skin into the platform:

  1. In the provider control panel, navigate to System > Settings and then click Skins in the Branding group.
  2. Click Add Skin to import the downloaded skin into the platform.
  3. Choose to upload the package from a local file and specify the path to the uploaded skin.
  4. Click Submit to start the import.
../../../_images/test-skin-imported.png

Once the skin is imported, you should apply it to the website (brand) where you can test the skin while editing it.

Apply Skin to Platform Frontend

You can assign the skin to an existing brand used as a platform frontend access point or create a new brand for it.

Note

If you imported an updated version of a skin package that is already installed on your websites, you should reapply it to your websites after the import - it cannot be applied automatically even if the name has not changed.

To apply the skin to a new brand:

  1. Go to System > Settings and click Brands in the Branding group.

  2. Click Add New Brand.

  3. Choose New domain and follow the on-screen instructions. This way, you create a new domain name to access the control panels with the assigned new skin.

  4. When configuring the brand parameters, browse to the Skin settings and select the required skin.

    ../../../_images/test-skin-new-brand.png
  5. Click Finish.

To apply the skin to an existing brand:

  1. In the Operations Automation provider control panel, navigate to System > Settings and click Brands in the Branding group.

  2. Click the brand where you want to install the skin.

  3. Click Edit.

  4. Choose the required skin from the Skin menu.

    Note

    You can select any skin, except the default skin which cannot be modified.

  5. Click Submit to install the skin.

After that, if your customers visit the control panel using the branded domain name, cp.a.isv1.apsdemo.org in the example above, they will look and feel the skin assigned to that brand.

Logo Customization

In Odin Automation, the main logo is a branded element. In the scope of a certain brand, the logo is the same on all types of control panels, either CP or UX1. You can configure and apply it along with all other skin elements explained above or separately as explained here.

When designing a logo image, follow these recommendations on the aspect ratio:

  • If a logo image form is close to a square, we recommend the sizes not less than 500x250 px and centering of contents.

    ../../../_images/logo-aspect-ratio-500-250.png
  • For other forms, the height should be not less than 250 px with the full filling of the area.

    ../../../_images/logo-aspect-ratio-h250.png

To upload a custom logo to a brand, follow the Apply Skin to Platform Frontend procedure where you can upload your file for the custom logo.