Skip to main content

​
Overview

Planningboard viewport with the board area (swimlanes, cards, Plans) and the License Panel anchored to the bottom-right corner showing a warning icon, message text, and a Contact us link
The panel renders as a custom web component with shadow DOM encapsulation, which means its internal styles are isolated from the host Polarion page and cannot be overridden via external CSS.

​
Variants

The panel behavior and visual style are controlled by the variant attribute. There are four possible values:
When the variant is ok, the panel is automatically hidden. Users with a valid Planningboard license will never see the panel. If the panel is not visible, that is expected behavior — it is not a bug.
The error and invalid variants use identical visual styling (red palette). The distinction is in the license condition they represent: error indicates an expired or absent license, while invalid indicates a license that fails validation checks.

​
Attributes

The panel contains a Contact us link that opens in a new tab. This link is intended to help users or administrators reach Nextedy to request an evaluation license or resolve a licensing issue. The link target URL is set via the linkHref attribute. If linkHref is not configured, the link defaults to # and does not navigate anywhere.
Planningboard can be used for 30 days without a production license. The license panel communicates this state and provides the path to obtain a full license. See License Installation for the full installation procedure.

​
License Status in the Administration View

The administration view (viewLicense) displays full license details for administrators. It is separate from the user-facing License Panel but reflects the same license states.

​
License states

​
Administration view features

​
License-Based Access Control

Planningboard enforces license-based access control at the board level. Unlicensed users retain read-only visibility of the board but cannot perform editing actions.

​
Capability comparison by license state

Unlicensed users can physically drag a card, but the operation is not persisted — the card returns to its original swimlane. There is no error message. If users report that cards are not saving after drag-and-drop, verify that their Planningboard license is active.

​
Positioning and Layout

The License Panel is anchored to the bottom-right of the Planningboard viewport. It is rendered as a fixed-position overlay and does not interfere with board layout, card interaction, or swimlane scrolling. The panel uses shadow DOM encapsulation:
  • Its internal structure (markup, styles) is isolated from the Polarion host page.
  • External CSS selectors cannot target elements inside the panel.
  • Custom styling of the panel via page-level CSS is not supported.

​
Developer Notes

The following information is relevant when integrating or extending the License Panel component.

​
Component registration

The initLicensePanel function registers the component with the browser’s custom element registry. It accepts an optional custom tag name parameter. This function must be called before the component is used in the DOM.

​
Slotted content

The panel supports slotted HTML content via the default slot mechanism. Custom message text can be inserted into the panel by placing content inside the component’s slot.
The exact tag name used by the component in the shipped Planningboard build and the specific slot usage pattern are internal implementation details. Consult the Planningboard administration page or contact Nextedy support for integration guidance.
  • License Installation — step-by-step instructions for installing a production license
  • Toolbar Controls — reference for the board toolbar, including controls affected by license state
  • UI Elements — index of all UI element reference pages
  • Reference — top-level reference index
KB Articles
  • Planningboard interface & basic interactions
Source Code
  • license-panel.js
  • widget.vm
  • licenseReadonly.cy.ts
  • viewLicense.vm
  • viewSetup.vm
Last modified on July 9, 2026