Skip to content

Commit fdfee4c

Browse files
authored
docs(licensing): adjust article (#692)
1 parent 3a65a21 commit fdfee4c

File tree

1 file changed

+18
-25
lines changed

1 file changed

+18
-25
lines changed

licensing/license-key.md

Lines changed: 18 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -15,42 +15,35 @@ This article describes how to download your personal license key and use it to a
1515

1616
A missing or invalid license results in [errors and warnings]({%slug licensing/license-errors-warnings%}) during build and run-time indicators such as watermarks and banners.
1717

18-
## Downloading the License Key
18+
## Setup your License Key
1919

20-
>warning The license key file is personal and confidential. Do not commit this file to source control and do not save it to a publicly accessible location!
20+
Due to the differences between `Web Application Project` and `Web Site Project`, the steps to activate the license will differ. One of the easiest ways to distinguish them is by checking if the project has a project file (`.csproj`/`.vbproj`) or not.
2121

22-
To download a license key for Telerik UI for ASP.NET AJAX, you must have either a developer license or a trial license. If you are new to Telerik UI for ASP.NET AJAX, [sign up for a free trial](https://www.telerik.com/aspnet-ajax) first, and then follow the steps below:
22+
- `Web Application Projects` > have a Project file.
23+
- `Web Site Projects` > do not have a Project file.
2324

24-
1. Go to the [License Keys](https://www.telerik.com/account/your-licenses/license-keys?_gl=1*cgbz4c*_gcl_au*MTIyNTMyNzI1My4xNzMyMDI2NzU3*_ga*MjAyMTI5MTQ4MS4xNzMyMDI2NzU1*_ga_9JSNBCSF54*MTczOTM0ODI2NS4xNi4xLjE3MzkzNTkxMTcuNTMuMC4w) page in your Telerik account.
25-
2. Click the **Download License Key** button.
26-
!["Download License Key"](images/download-license-key.png "Download License Key")
27-
3. Next, [Activate your Telerik UI for ASP.NET AJAX components](#activating-the-telerik-ui-for-asp-net-ajax-components).
28-
29-
The [Progress Control Panel](https://docs.telerik.com/controlpanel/introduction), [automated installers]({%slug getting-started/installation/install-using-msi%}), and the [Visual Studio Extensions]({%slug introduction/radcontrols-for-asp.net-ajax-fundamentals/integration-with-visual-studio/visual-studio-extensions/overview%}) will automatically download and store your license key in your home directory. This makes it available for all projects that you develop on your local machine.
25+
For more details about the differences you can check out the following Microsoft documentation article: [Web Application Projects versus Web Site Projects in Visual Studio](https://learn.microsoft.com/en-us/previous-versions/aspnet/dd547590(v=vs.110)?redirectedfrom=MSDN).
3026

31-
## Activating the Telerik UI for ASP.NET AJAX Components
27+
### Web Application
3228

33-
>important If your project doesn’t use NuGet packages, or you have a Web Site project, follow the instructions from the [Installing a License Key in Projects without NuGet References](#installing-a-license-key-in-projects-without-nuget-references) section.
29+
To download and install your Telerik license key file:
3430

35-
To activate the Telerik UI for ASP.NET AJAX controls:
31+
1. Go to the [License Keys](https://www.telerik.com/account/your-licenses/license-keys) page in your Telerik account.
32+
2. Click the **Download License Key** button.
33+
3. Save the `telerik-license.txt` file to your user profile directory `%AppData%\Telerik\telerik-license.txt`, for example, `C:\Users\...\AppData\Roaming\Telerik\telerik-license.txt`
3634

37-
- Copy the downloaded `telerik-license.txt` license key file to your home directory. This makes the license key available to all projects that you develop on your computer:
38-
- For Windows: `%AppData%\Telerik\telerik-license.txt`
39-
- Alternatively, copy the `telerik-license.txt` license key file to the root folder of your project. This makes the license key available only to this project. Do not commit the file to source control as this is your personal license key.
35+
This will make the license key available to all Telerik applications that you develop on your local machine. If you need to activate Telerik UI for ASP.NET AJAX only in a specific application, save the `telerik-license.txt` to the root folder of this project or solution.
4036

41-
When you build the project, the `Telerik.Licensing` NuGet package automatically locates the license file and uses it to activate the WebForms controls.
37+
### Web Site
4238

43-
## Installing a License Key in Projects without NuGet References
39+
The license for Web Sites projects can be activated by adding a license Script key:
4440

45-
Telerik strongly recommends the use of NuGet packages whenever possible. Only include the license key as a code snippet when NuGet packages are not an option.
41+
1. Go to the [License Keys](https://www.telerik.com/account/your-licenses/license-keys) page in your Telerik account.
42+
1. On the Telerik UI for ASP.NET AJAX row, click the `View key` link.
43+
1. Select the language (`C# KEY` or `VB KEY`) and click the `Copy and close` button to copy the Script Key to your clipboard.
44+
1. Add a C#/VB Class file to the `App_Code` directory of your project, e.g. `App_Code\TelerikLicense.cs` and paste the Script Key from your clipboard.
4645

47-
1. If you cannot use NuGet packages in your project, add the license as a code snippet:
48-
2. Go to the [License Keys](https://www.telerik.com/account/your-licenses/license-keys) page in your Telerik account.
49-
3. On the Telerik UI for ASP.NET AJAX row, click the **View key** link in the **SCRIPT KEY** column.
50-
!["Alt Text"](images/view-script-key.png "Alt Text")
51-
4. Copy the C# code snippet into a new file, for example, `TelerikLicense.cs`.
52-
5. Add the `TelerikLicense.cs` file to your project.
53-
- In case of Web Site project, add the file to the `App_Code` folder.
46+
To activate the license in other Web Site projects, repeat these steps.
5447

5548
## See Also
5649

0 commit comments

Comments
 (0)