Skip to content

Commit 97d93c3

Browse files
committed
Sync with Kendo UI Professional
1 parent 9b2726e commit 97d93c3

14 files changed

+454
-136
lines changed

docs-aspnet/getting-started-core/first-steps-cli.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@ To get up and running with the project:
2222
1. [Meet the requirements](#meeting-the-requirements)
2323
1. [Create the ASP.NET Core application](#creating-the-application)
2424
1. [Integrate UI for ASP.NET Core in the project](#integrating-ui-for-aspnet-core)
25+
1. [Add a license file to your app](#adding-your-license-file)
2526

2627
## Meeting the Requirements
2728

@@ -148,6 +149,12 @@ Install the appropriate [.Net Core SDK 2.0 or later](https://www.microsoft.com/n
148149
149150
@[template](/_contentTemplates/core/json-serialization-note.md#json-serialization-note)
150151
152+
## Adding Your License File
153+
154+
Using any client-side assets from the [Kendo UI CDN]({% slug cdnservices_core %}) or the [@progress/kendo-ui NPM package](https://www.npmjs.com/package/@progress/kendo-ui) requires you to add a Kendo UI for jQuery license file to your application. A missing license file triggers [a banner, a watermark, and causes a warning message](https://docs.telerik.com/kendo-ui/knowledge-base/invalid-license) in the browser's console.
155+
156+
To generate your license file and add it to your application, follow the instructions in the [Adding a License File]({% slug using_license_code %}) article.
157+
151158
## Next Steps
152159
153160
* [Use data-bound widgets]({% slug jsonserialization_core %})

docs-aspnet/getting-started-core/first-steps-vs-extensions.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -38,6 +38,7 @@ You'll learn how to:
3838
<li><span class="k-icon k-i-check"></span>Initialize a DatePicker and a Grid.</li>
3939
<li><span class="k-icon k-i-check"></span>Bind data to Telerik UI widgets.</li>
4040
<li><span class="k-icon k-i-check"></span>Use the Telerik UI Themes.</li>
41+
<li><span class="k-icon k-i-check"></span>Add your license file.</li>
4142
</ul>
4243

4344
## Prerequisites
@@ -306,6 +307,12 @@ Since both the Bootstrap and Default themes are Sass-based themes, no additional
306307

307308
@[template](/_contentTemplates/core/json-serialization-note.md#json-serialization-note)
308309

310+
## Adding Your License File
311+
312+
Using any client-side assets from the [Kendo UI CDN]({% slug cdnservices_core %}) or the [@progress/kendo-ui NPM package](https://www.npmjs.com/package/@progress/kendo-ui) requires you to add a Kendo UI for jQuery license file to your application. A missing license file triggers [a banner, a watermark, and causes a warning message](https://docs.telerik.com/kendo-ui/knowledge-base/invalid-license) in the browser's console.
313+
314+
To generate your license file and add it to your application, follow the instructions in the [Adding a License File]({% slug using_license_code %}) article.
315+
309316
## Next Steps
310317

311318
* [Check out the free Telerik UI onboarding course]({%slug virtualclass_uiforcore%})

docs-aspnet/getting-started-core/first-steps-vs-mac.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,7 @@ To get up and running with the project:
2121
1. [Meet the requirements](#meeting-the-requirements)
2222
1. [Create the ASP.NET Core application](#creating-the-application)
2323
1. [Add the UI for ASP.NET Core NuGet package](#adding-the-nuget-package)
24+
1. [Add a license file to your app](#adding-your-license-file)
2425

2526
## Meeting the Requirements
2627

@@ -114,6 +115,12 @@ If you prefer to include the client-side resources from a local source instead o
114115

115116
@[template](/_contentTemplates/core/json-serialization-note.md#json-serialization-note)
116117

118+
## Adding Your License File
119+
120+
Using any client-side assets from the [Kendo UI CDN]({% slug cdnservices_core %}) or the [@progress/kendo-ui NPM package](https://www.npmjs.com/package/@progress/kendo-ui) requires you to add a Kendo UI for jQuery license file to your application. A missing license file triggers [a banner, a watermark, and causes a warning message](https://docs.telerik.com/kendo-ui/knowledge-base/invalid-license) in the browser's console.
121+
122+
To generate your license file and add it to your application, follow the instructions in the [Adding a License File]({% slug using_license_code %}) article.
123+
117124
## Next Steps
118125

119126
* [Use data-bound widgets]({% slug jsonserialization_core %})

docs-aspnet/getting-started-core/first-steps.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,8 @@ In this tutorial, you will:
3434

3535
1. [Add a Telerik UI component](#adding-a-telerik-ui-component).
3636

37+
1. [Add a license file to your app](#adding-your-license-file).
38+
3739
>tip How about a free Telerik UI onboarding course? Check out the [Video Onboarding]({%slug virtualclass_uiforcore%}) article and learn how to take advantage of the <a href="https://learn.telerik.com/learn" target="_blank">Telerik Virtual Classroom</a>.
3840
3941
## Prerequisites
@@ -234,6 +236,12 @@ Congratulations! You created a page that uses the [Telerik UI DatePicker]({% slu
234236

235237
@[template](/_contentTemplates/core/json-serialization-note.md#json-serialization-note)
236238

239+
## Adding Your License File
240+
241+
Using any client-side assets from the [Kendo UI CDN]({% slug cdnservices_core %}) or the [@progress/kendo-ui NPM package](https://www.npmjs.com/package/@progress/kendo-ui) requires you to add a Kendo UI for jQuery license file to your application. A missing license file triggers [a banner, a watermark, and causes a warning message](https://docs.telerik.com/kendo-ui/knowledge-base/invalid-license) in the browser's console.
242+
243+
To generate your license file and add it to your application, follow the instructions in the [Adding a License File]({% slug using_license_code %}) article.
244+
237245
## Next Steps
238246

239247
* [Overview of the UI for ASP.NET Core installation methods]({% slug downloadinstall_aspnetcore %})

docs-aspnet/getting-started-mvc/first-steps.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -85,9 +85,7 @@ You can now start adding components.
8585

8686
## Adding Components to the Application
8787

88-
As a result of selecting the **GRID AND MENU** template, a Grid component has been added to the `Index.cshtml` view, and a Menu to the `_Layout.cshtml`. The Grid is configured and bound remotely to sample data returned by the `GridController`.
89-
90-
[This article is giving additional information about the Initialization of the Grid HtmlHelper](https://docs.telerik.com/aspnet-mvc/getting-started/manual-setup#initializing-the-grid-htmlhelper)
88+
As a result of selecting the **GRID AND MENU** template, a Grid component has been added to the `Index.cshtml` view, and a Menu to the `_Layout.cshtml`. The Grid is configured and bound remotely to sample data returned by the `GridController`. The next step is to add an additional component to the application.
9189

9290
Add a DatePicker to the `Index.cshtml` view:
9391

@@ -106,6 +104,12 @@ Press `CTRL+F5` to build and run the application. You have a Grid and a DatePick
106104

107105
![{{ site.product_short }} Sample page showing a Grid and a DatePicker](../getting-started-mvc/images/grid-and-datepicker-mvc.png)
108106

107+
## Adding Your License File
108+
109+
Using any client-side assets from the [Kendo UI CDN]({% slug cdnservices_core %}) or the [@progress/kendo-ui NPM package](https://www.npmjs.com/package/@progress/kendo-ui) requires you to add a Kendo UI for jQuery license file to your application. A missing license file triggers [a banner, a watermark, and causes a warning message](https://docs.telerik.com/kendo-ui/knowledge-base/invalid-license) in the browser's console.
110+
111+
To generate your license file and add it to your application, follow the instructions in the [Adding a License File]({% slug using_license_code %}) article.
112+
109113
## Next Steps
110114

111115
* [Explore the Telerik UI for ASP.NET MVC fundamentals]({% slug fundamentals_aspnetmvc %})

docs-aspnet/getting-started-mvc/manual-setup.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -124,12 +124,18 @@ Perform the steps below to add a Grid to the project:
124124
return Json(data.ToDataSourceResult(request), JsonRequestBehavior.AllowGet);
125125
}
126126
127-
## Build and Run the Application
127+
## Building and Running the Application
128128
129129
Press `CTRL+F5` to build and run the application. As a result, the following sample page is created.
130130
131131
![{{ site.product_short }} Sample page](../getting-started-mvc/images/sample-page.png)
132132
133+
## Adding Your License File
134+
135+
Using any client-side assets from the [Kendo UI CDN]({% slug cdnservices_core %}) or the [@progress/kendo-ui NPM package](https://www.npmjs.com/package/@progress/kendo-ui) requires you to add a Kendo UI for jQuery license file to your application. A missing license file triggers [a banner, a watermark, and causes a warning message](https://docs.telerik.com/kendo-ui/knowledge-base/invalid-license) in the browser's console.
136+
137+
To generate your license file and add it to your application, follow the instructions in the [Adding a License File]({% slug using_license_code %}) article.
138+
133139
## Next Steps
134140
135141
* [Explore the Telerik UI for ASP.NET MVC fundamentals]({% slug fundamentals_aspnetmvc %})

docs-aspnet/getting-started-mvc/setup-with-nuget.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ To get up and running with the project:
2020
1. [Include the Telerik UI for ASP.NET MVC client-side resources](#including-the-client-side-resources)
2121
1. [Initialize the HtmlHelper](#initializing-the-htmlhelper)
2222
1. [Build and run the application](#building-and-running-the-application)
23+
1. [Add a license file to your app](#adding-your-license-file)
2324

2425
## Prerequisites
2526

@@ -166,6 +167,12 @@ Press `CTRL+F5` to build and run the application. As a result, the following sam
166167
167168
![{{ site.product_short }} Sample page](../getting-started-mvc/images/sample-page.png)
168169
170+
## Adding Your License File
171+
172+
Using any client-side assets from the [Kendo UI CDN]({% slug cdnservices_core %}) or the [@progress/kendo-ui NPM package](https://www.npmjs.com/package/@progress/kendo-ui) requires you to add a Kendo UI for jQuery license file to your application. A missing license file triggers [a banner, a watermark, and causes a warning message](https://docs.telerik.com/kendo-ui/knowledge-base/invalid-license) in the browser's console.
173+
174+
To generate your license file and add it to your application, follow the instructions in the [Adding a License File]({% slug using_license_code %}) article.
175+
169176
## Next Steps
170177
171178
* [Explore the Telerik UI for ASP.NET MVC fundamentals]({% slug fundamentals_aspnetmvc %})
Lines changed: 43 additions & 88 deletions
Original file line numberDiff line numberDiff line change
@@ -1,32 +1,31 @@
11
---
2-
title: Using Script License File
3-
page_title: Using Script License File - Download and Installation
2+
title: Adding a License File
3+
page_title: Adding a Script License File
44
description: "Get started with {{ site.product }} and learn how to register the script license file required for the client-side scripts from the CDN and NPM distribution."
55
slug: using_license_code
66
position: 2
77
---
88

9-
# Setting Up the License File
9+
# Adding a License File
1010

11-
This article describes how to activate the required client-side scripts from the CDN and NPM distribution by generating a personal license file.
11+
Using any [Kendo UI client-side assets]({% slug copyclientresources_aspnetmvc6_aspnetmvc %}) that are [installed through NPM](https://www.npmjs.com/package/@progress/kendo-ui) or imported through the [Kendo UI CDN]({% slug cdnservices_core %}) requires you to provide a license file. Follow the steps in this article to download a license file, add it to your application, and then reference it.
1212

13-
As of the following releases, using any {{ site.product }} components from the Kendo CDN service and from the NPM distribution channel requires a license registration:
13+
Providing a license file is not required when using locally downloaded client-side assets that come with the commercial [MSI installer]({% slug msi_install_aspnetmvc6_aspnetmvc %}) or [commercial ZIP and 7Z asset archives]({% slug using_local_client_side_resources %}#adding-the-resources).
1414

15-
* R3 2022 for the [Kendo CDN service]({% slug cdnservices_core %})
16-
* R2 2022 for the NPM distribution channel
15+
A missing license file triggers [a banner, a watermark, and causes a message](https://docs.telerik.com/kendo-ui/knowledge-base/invalid-license) similar to this one to appear in the browser's console:
1716

18-
Depending on the license you own, you can register an active trial license key or a commercial license key.
19-
20-
If you are experiencing any issues related to the license file, inform the team through the [available support channels]({% slug overview_aspnetmvc6_aspnetmvc %}#support-options).
21-
22-
>* The script license registration is required only for the CDN distribution and the commercial NPM package (`@progress/kendo-ui`). For locally downloaded client-side scripts, you do not need a license registration.
23-
>* The license key will be distributed along with the scripts, which can not be avoided. However, Progress recommends that you do not announce it publicly.
17+
```console
18+
License activation failed for
19+
@progress/kendo-ui v{{ site.cdnVersion }}
20+
No license found.
21+
See https://docs.telerik.com/kendo-ui/intro/installation/using-license-code for more information.
22+
```
2423

25-
The license key installation process involves the following steps:
24+
To add a client-side assets license file to your application:
2625

2726
1. [Download a license file](#step-1-get-the-license-file)
2827
2. [Add the license file in your application](#step-2-add-the-license-file)
29-
3. [Add a Reference to the License File](#step-3-add-a-reference-to-the-license-file)
28+
3. [Add a reference to the license file](#step-3-add-a-reference-to-the-license-file)
3029

3130
## Step 1: Get the License File
3231

@@ -57,7 +56,9 @@ download-code-url="https://docs.telerik.com/kendo-ui/my-license/download">
5756

5857
## Step 2: Add the License File
5958

60-
To register the Kendo UI product, add the `kendo-ui-license.js` file in the root of the application or the main scripts folder. The following table shows the most common location where you can include it in your application.
59+
Place the `kendo-ui-license.js` file in the root of the application or in the main scripts folder.
60+
61+
The following table shows the most common location where you can include the license file in your application.
6162

6263
{% if site.core %}
6364
|Type of Application|Common Locations
@@ -71,87 +72,41 @@ To register the Kendo UI product, add the `kendo-ui-license.js` file in the root
7172

7273
## Step 3: Add a Reference to the License File
7374

74-
Add the `kendo-ui-license.js` file as a script reference right after the `kendo.aspnetmvc.min.js` reference or the Kendo scripts you are using.
75-
76-
**An example of using a CDN reference with `kendo.all.min.js` and `kendo.aspnetmvc.min.js`**
77-
```html
78-
<script src="https://kendo.cdn.telerik.com/***/kendo.all.min.js"></script>
79-
<script src="https://kendo.cdn.telerik.com/***/kendo.aspnetmvc.min.js"></script>
80-
<script src="./kendo-ui-license.js"></script>
81-
82-
<!-- Rest of the HTML -->
83-
```
84-
85-
**An example of using a CDN reference with a predefined list of scripts**
86-
```html
87-
<script src="https://kendo.cdn.telerik.com/***/kendo.core.min.js"></script>
88-
<script src="https://kendo.cdn.telerik.com/***/kendo.userevents.min.js"></script>
89-
<script src="https://kendo.cdn.telerik.com/***/kendo.draganddrop.min.js"></script>
90-
<script src="https://kendo.cdn.telerik.com/***/kendo.popup.min.js "></script>
91-
<script src="https://kendo.cdn.telerik.com/***/kendo.fx.min.js"></script>
92-
<script src="https://kendo.cdn.telerik.com/***/kendo.window.min.js"></script>
93-
<script src="https://kendo.cdn.telerik.com/***/kendo.aspnetmvc.min.js"></script>
94-
<script src="./kendo-ui-license.js"></script>
95-
96-
<!-- Rest of the HTML -->
97-
```
98-
99-
## Frequently Asked Questions
100-
101-
This section lists the answers to the most frequently asked questions (FAQs) about working with the {{ site.product }} license key.
102-
103-
### Do I need to generate a new license file if I have renewed my license?
104-
Yes, but only If you upgrade the version of our product in your application with the new version.
105-
106-
### What happens if a developer leaves?
107-
It does not affect your licensing key. The license key is generated against a specific range of versions. It will be valid as long as the license code is valid for the product version used (for example, the license file should be changed only when you upgrade the {{ site.product }}).
108-
109-
### Which versions of {{ site.product }} does this affect?
110-
111-
For CDN usage: Starting from R3 2022
112-
113-
For NPM: Starting from R2 2022
75+
Add the `kendo-ui-license.js` file as a script reference right after the `kendo.aspnetmvc.min.js` reference or the Kendo scripts you are using. For example:
11476

115-
### Will projects stop working if we do not renew?
116-
No, the licensing mechanism does not control the components behavior. Also, the licensing mechanism performs a check if the user (who authenticated in the docs to generate the license file) has a license for the version of our product used in the application. Note that our licenses are perpetual (see EULA).
77+
* Adding the license file after a CDN reference to `kendo.all.min.js` and `kendo.aspnetmvc.min.js`
78+
```html
79+
<script src="https://kendo.cdn.telerik.com/***/kendo.all.min.js"></script>
80+
<script src="https://kendo.cdn.telerik.com/***/kendo.aspnetmvc.min.js"></script>
81+
<script src="./kendo-ui-license.js"></script>
11782

118-
### Will the product function without a license key?
119-
Yes, the product will continue to function normally without a license key. However, a warning message will appear in the browser console if a valid license key is not present.
83+
<!-- Rest of the HTML -->
84+
```
12085

121-
### Does the license key expire?
122-
Yes, the license key expires at the end of your support subscription:
123-
124-
For trial users, this is at the end of your 30-day trial.
125-
126-
For licensed developers, this is when your subscription expires.
127-
128-
You will need to obtain and install a new license key after starting a trial, renewing a license, or upgrading a license.
129-
130-
> NOTE: An expired license key is valid for all Product versions published before its expiration date.
131-
132-
### I renewed my license key, but the warning message still appears in the console. What should I do?
133-
Make sure that the [script license is present in your project](#step-2-add-the-license-file) and you [have correct references to it](#step-3-add-a-reference-to-the-license-file).
134-
135-
### Do I need an Internet connection to activate the license?
136-
No, the license activation and validation are performed entirely offline.
137-
138-
No network requests are made at any point of the project lifecycle.
139-
140-
### My team has more than one licensed developer. Which key do we have to use?
141-
To activate {{ site.product }}, you can use any of the keys associated with your subscriptions.
142-
143-
### Are earlier versions of {{ site.product }} affected?
144-
No, if you use the CDN service and a version released prior to R3 2022, or NPM with a version released prior to R2 2022, you do not have to set up the licensing.
86+
* Adding the license file after a CDN reference to a predefined list of scripts
87+
```html
88+
<script src="https://kendo.cdn.telerik.com/***/kendo.core.min.js"></script>
89+
<script src="https://kendo.cdn.telerik.com/***/kendo.userevents.min.js"></script>
90+
<script src="https://kendo.cdn.telerik.com/***/kendo.draganddrop.min.js"></script>
91+
<script src="https://kendo.cdn.telerik.com/***/kendo.popup.min.js "></script>
92+
<script src="https://kendo.cdn.telerik.com/***/kendo.fx.min.js"></script>
93+
<script src="https://kendo.cdn.telerik.com/***/kendo.window.min.js"></script>
94+
<script src="https://kendo.cdn.telerik.com/***/kendo.aspnetmvc.min.js"></script>
95+
<script src="./kendo-ui-license.js"></script>
14596

97+
<!-- Rest of the HTML -->
98+
```
14699

147100
## Next Steps
148101

149-
* [Using CDN to Add Client-Side Resources]({% slug cdnservices_core %})
150-
* [Creating Your Own Custom Script Bundles with Client-Side Resources]({% slug custombundles_core %})
102+
* [License File Frequently Asked Questions (Kendo UI for jQuery Documentation)](https://docs.telerik.com/kendo-ui/intro/installation/license-code-faq)
103+
* [Troubleshooting a Failed Client-Side Assets License Activation (Kendo UI for jQuery Knowledge Base)](https://docs.telerik.com/kendo-ui/knowledge-base/invalid-license)
151104

152105
## See Also
153106

107+
* [Using CDN to Add Client-Side Resources]({% slug cdnservices_core %})
108+
* [Using Local Files to Add Client-Side Resources]({% slug using_local_client_side_resources %})
109+
* [Creating Your Own Custom Script Bundles with Client-Side Resources]({% slug custombundles_core %})
154110
{% if site.core %}
155111
* [Using LibMan to Add Client-Side Resources]({% slug using_libman %})
156-
{% endif %}
157-
* [Using Local Files to Add Client-Side Resources]({% slug using_local_client_side_resources %})
112+
{% endif %}

0 commit comments

Comments
 (0)