Skip to content

Branding

Branding refers to customizing the appearance of the product to meet the corporate requirements of customers. To this end, pSeven Enterprise enables them to make the following branding-related customizations:

  • Set a custom logo on the pSeven Enterprise sign-in screen.
  • Set a custom logo on the top navigation bar of the pSeven Enterprise web interface.
  • Set a custom favicon to be displayed in the browser address bar for pSeven Enterprise users.
  • Set a custom pSeven Enterprise page title to be displayed as the title of the browser tab where a user opens pSeven Enterprise, and also as the title on top of the AppsHub main page.
  • Implement a custom start page to be displayed by clicking the Getting started button on the Start tab.

These customizations require write access to the pSeven Enterprise shared data storage. Its location is specified by the storage.shareddata.* parameters in the pSeven Enterprise deployment configuration file (values.yaml). The root of this data storage will be denoted <shared data>.

For branding purposes, the following folders are provided in the shared data storage:

  • <shared data>/branding/pseven/ - folder to contain branding customizations (logo files, favicon, page title).
  • <shared data>/branding/pseven/getting-started/ - folder to contain the custom Getting started page files.

If you do not need branding, do not delete or replace files in the above folders.

To set your brand logos, replace the following files with your logo image files:

  • <shared data>/branding/pseven/block-logo-200x530.png - logo for the user sign-in screen. For best results, the logo image should be 200×530 pixels.
  • <shared data>/branding/pseven/header-logo-32x198.png - logo for the pSeven Enterprise navigation bar. For best results, this logo image should be 32×198 pixels.
  • <shared data>/branding/pseven/header-logo-64x64.png - logo for the user profile navigation bar. For best results, this logo image should be 64×64 pixels.

To set a brand favicon, replace the <shared data>/branding/pseven/favicon.ico file with your custom icon.

To set a brand page title, edit <shared data>/branding/pseven/title.txt, replacing the default title ("pSeven Enterprise") with your custom title. The title.txt file must be saved with the UTF⁠-⁠8 encoding.

Your custom Getting started page must be implemented as a static set of HTML files and folders including an index.html file. Copy your files to the <shared data>/branding/pseven/getting-started/ folder, replacing the default index.html file.

Your new page opens when you click the Getting started button located on the Start tab of the pSeven Enterprise interface. This also passes the URL of the default Getting started page as the original_url query string parameter, which you can use to add a link from your custom page to the default page. For example:

<!-- The link to the default Getting started page. -->
<a href="" id="default_getting_started">Getting started.</a>

<!-- Set the destination URL for the link. -->
<script>
    const search = new URLSearchParams(window.location.search);
    document.getElementById("default_getting_started").href = search.get(
        "original_url",
    );
</script>