Update Trial Panel texts (#28407) (#28505)

Co-authored-by: Mikhail Preyskurantov <[email protected]>

Author: AlisherAmonulloev

packages/devextreme-angular/src/core/component.ts

@@ -38,6 +38,7 @@ import {
 
 config({
   buyNowLink: 'https://go.devexpress.com/Licensing_Installer_Watermark_DevExtremeAngular.aspx',
+  licensingDocLink: 'https://go.devexpress.com/Licensing_Documentation_DevExtremeAngular.aspx',
 });
 
 let serverStateKey;

packages/devextreme-angular/tests/src/core/component.spec.ts

@@ -147,6 +147,10 @@ describe('DevExtreme Angular widget', () => {
         expect(config().buyNowLink).toBe('https://go.devexpress.com/Licensing_Installer_Watermark_DevExtremeAngular.aspx');
     });
 
+    it('correctly sets the help link', () => {
+        expect(config().licensingDocLink).toBe('https://go.devexpress.com/Licensing_Documentation_DevExtremeAngular.aspx');
+    });
+
     it('should be disposed', () => {
         let testSpy = spyOn(TestContainerComponent.prototype, 'testMethod');
 

packages/devextreme-react/src/core/__tests__/component.test.tsx

@@ -124,6 +124,10 @@ describe('rendering', () => {
     it('correctly sets the buy now link', () => {
       expect(config().buyNowLink).toBe('https://go.devexpress.com/Licensing_Installer_Watermark_DevExtremeReact.aspx');
     });
+
+    it('correctly sets the help link', () => {
+      expect(config().licensingDocLink).toBe('https://go.devexpress.com/Licensing_Documentation_DevExtremeReact.aspx');
+    });
   });
 
   describe('nested full components', () => {

packages/devextreme-react/src/core/component-base.tsx

@@ -30,6 +30,7 @@ const DX_REMOVE_EVENT = 'dxremove';
 
 config({
   buyNowLink: 'https://go.devexpress.com/Licensing_Installer_Watermark_DevExtremeReact.aspx',
+  licensingDocLink: 'https://go.devexpress.com/Licensing_Documentation_DevExtremeReact.aspx',
 });
 
 type ComponentBaseProps = ComponentProps & {

packages/devextreme-vue/src/core/__tests__/component.test.ts

@@ -161,6 +161,10 @@ describe('component rendering', () => {
     expect(config().buyNowLink).toBe('https://go.devexpress.com/Licensing_Installer_Watermark_DevExtremeVue.aspx');
   });
 
+  it('correctly sets the help link', () => {
+    expect(config().licensingDocLink).toBe('https://go.devexpress.com/Licensing_Documentation_DevExtremeVue.aspx');
+  });
+
   describe('options', () => {
     it('watch prop changing to undefined', (done) => {
       const wrapper = mount(TestComponent, {

packages/devextreme-vue/src/core/component.ts

@@ -47,6 +47,7 @@ const includeAttrs = ['id', 'class', 'style'];
 
 config({
   buyNowLink: 'https://go.devexpress.com/Licensing_Installer_Watermark_DevExtremeVue.aspx',
+  licensingDocLink: 'https://go.devexpress.com/Licensing_Documentation_DevExtremeVue.aspx',
 });
 
 function getAttrs(attrs, dxClasses: string[]) {

packages/devextreme/js/__internal/core/license/license_validation.ts

@@ -31,6 +31,7 @@ const RTM_MIN_PATCH_VERSION = 3;
 const KEY_SPLITTER = '.';
 
 const BUY_NOW_LINK = 'https://go.devexpress.com/Licensing_Installer_Watermark_DevExtremeJQuery.aspx';
+const LICENSING_DOC_LINK = 'https://go.devexpress.com/Licensing_Documentation_DevExtremeJQuery.aspx';
 
 const GENERAL_ERROR: Token = { kind: TokenKind.corrupted, error: 'general' };
 const VERIFICATION_ERROR: Token = { kind: TokenKind.corrupted, error: 'verification' };
@@ -177,7 +178,9 @@ export function validateLicense(licenseKey: string, versionStr: string = fullVer
   }
 
   if (error && !internal) {
-    showTrialPanel(config().buyNowLink ?? BUY_NOW_LINK, fullVersion);
+    const buyNowLink = config().buyNowLink ?? BUY_NOW_LINK;
+    const licensingDocLink = config().licensingDocLink ?? LICENSING_DOC_LINK;
+    showTrialPanel(buyNowLink, licensingDocLink, fullVersion);
   }
 
   const preview = isPreview(version.patch);

packages/devextreme/js/__internal/core/license/trial_panel.client.ts

@@ -29,6 +29,7 @@ const componentNames = {
 };
 const attributeNames = {
   buyNow: 'buy-now',
+  licensingDoc: 'licensing-doc',
   version: 'version',
 };
 const commonStyles = {
@@ -186,7 +187,9 @@ class DxLicense extends SafeHTMLElement {
     contentContainer.style.cssText = this._contentStyles;
     contentContainer.append(
       this._createSpan('For evaluation purposes only. Redistribution prohibited. Please '),
-      this._createLink('purchase a license', this.getAttribute(attributeNames.buyNow) as string),
+      this._createLink('register', this.getAttribute(attributeNames.licensingDoc) as string),
+      this._createSpan(' an existing license or '),
+      this._createLink('purchase a new license', this.getAttribute(attributeNames.buyNow) as string),
       this._createSpan(` to continue use of DevExpress product libraries (v${this.getAttribute(attributeNames.version)}).`),
     );
     return contentContainer;
@@ -254,6 +257,11 @@ class DxLicenseTrigger extends SafeHTMLElement {
         this.getAttribute(attributeNames.buyNow) as string,
       );
 
+      license.setAttribute(
+        attributeNames.licensingDoc,
+        this.getAttribute(attributeNames.licensingDoc) as string,
+      );
+
       license.setAttribute(DATA_PERMANENT_ATTRIBUTE, 'true');
 
       document.body.prepend(license);
@@ -277,6 +285,7 @@ export function registerCustomComponents(customStyles?: CustomTrialPanelStyles):
 
 export function renderTrialPanel(
   buyNowUrl: string,
+  licensingDocUrl: string,
   version: string,
   customStyles?: CustomTrialPanelStyles,
 ): void {
@@ -285,6 +294,7 @@ export function renderTrialPanel(
   const trialPanelTrigger = document.createElement(componentNames.trigger);
 
   trialPanelTrigger.setAttribute(attributeNames.buyNow, buyNowUrl);
+  trialPanelTrigger.setAttribute(attributeNames.licensingDoc, licensingDocUrl);
   trialPanelTrigger.setAttribute(attributeNames.version, version);
 
   document.body.appendChild(trialPanelTrigger);

packages/devextreme/js/__internal/core/license/trial_panel.ts

@@ -7,11 +7,12 @@ import {
 
 export function showTrialPanel(
   buyNowUrl: string,
+  licensingDocUrl: string,
   version: string,
   customStyles?: CustomTrialPanelStyles,
 ): void {
   if (isClient()) {
-    renderTrialPanel(buyNowUrl, version, customStyles);
+    renderTrialPanel(buyNowUrl, licensingDocUrl, version, customStyles);
   }
 }
 

packages/devextreme/js/common.d.ts

@@ -388,6 +388,7 @@ export type GlobalConfig = {
    */
   licenseKey?: string;
   buyNowLink?: string;
+  licensingDocLink?: string;
 };
 
 /**