Skip to content

Commit 2ca1c4b

Browse files
committed
Sync with Kendo UI Professional
1 parent 8658f24 commit 2ca1c4b

File tree

12 files changed

+495
-33
lines changed

12 files changed

+495
-33
lines changed
37.7 KB
Loading
226 KB
Loading
117 KB
Loading
70.6 KB
Loading
105 KB
Loading
40.7 KB
Loading

docs-aspnet/installation/upgrading/upgrade-troubleshooting.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,8 @@ This document describes how to troubleshoot your application and what to be wary
1717
The issues listed below are common when upgrading to {{ site.product }} versions released in 2025. Follow the link next to each problem to find the solution.
1818

1919
* You have a commercial license, but a license-related warning message appears in the browser's console, as a banner, and as a watermark for the components—The solution for {{ site.product }} version `2025.1.211` or newer is to [update your license key]({%slug installation_license_key_aspnetcore%}#license-key-updates). The solution for {{ site.product }} version `2024.4.1112` or older is [to generate, add, and reference a license file]({% slug remove-license-warning-message %}).
20+
* Starting with version Q2 2025, the Trial packages are removed and they contain no `Trial` identifier in their name. If you attempt to upgrade a trial NuGet package to a Q2 2025 version, change the name of the referenced NuGet package name.
21+
* An attempt to use the obsolete Telerik NuGet v2 feed will now result in an error. The solution is to use the [Telerik NuGet v3 feed](https://www.telerik.com/{{ site.platform }}/documentation/installation/installation-options/nuget-install).
2022

2123
## 2023 Yearly Releases
2224

docs-aspnet/installation/upgrading/upgrade.md

Lines changed: 52 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -9,17 +9,21 @@ position: 1
99

1010
# Upgrading {{ site.product }}
1111

12-
This document describes how to upgrade the version of the {{ site.product }} helpers and how to switch from a trial to a developer (commercial) license.
12+
This document describes how to upgrade the version of the {{ site.product }} helpers.
1313

1414
## Upgrading to New Versions
1515

1616
To update {{ site.product }} to a new version, either:
1717

1818
{% if site.core %}
19-
2019
* [Upgrade with NuGet or Bower](#using-nuget-or-bower).
20+
{% else %}
21+
* [Use the Upgrade Project Wizard](#using-the-upgrade-project-wizard).
22+
{% endif %}
2123
* [Manually replace the references and files](#upgrading-manually).
2224

25+
{% if site.core %}
26+
2327
### Using NuGet or Bower
2428

2529
To upgrade the version with NuGet or Bower:
@@ -42,6 +46,37 @@ To upgrade the version with NuGet or Bower:
4246

4347
> To properly load the Telerik and Kendo UI packages, both [NuGet]({% slug nuget_install_aspnetmvc6_aspnetmvc %}) and [Bower](https://docs.telerik.com/kendo-ui/intro/installation/bower-install#kendo-ui-professional) require authentication.
4448

49+
{% else %}
50+
51+
### Using the Upgrade Project Wizard
52+
53+
To upgrade your project by using the **Upgrade Project Wizard**, follow these steps:
54+
55+
1. Open the **Extensions->Telerik Menu** or click the **Update Now** button as in the screenshot below to start the upgrading process.
56+
57+
![Upgrade Step 1](../images/upgrade-step-0.png)
58+
1. Select the files that must be included in the update process and click **Next**.
59+
60+
![Upgrade Step 2](../images/upgrade-step-1.png)
61+
1. Choose the project or projects you want to upgrade.
62+
63+
![Upgrade Step 3](../images/upgrade-step-2.png)
64+
1. Pick an option for the **EditorTemplates** folder.
65+
66+
![Upgrade Step 4](../images/upgrade-step-3.png)
67+
1. Create a backup.
68+
69+
![Upgrade Step 5](../images/upgrade-step-4.png)
70+
1. Be careful not to overwrite any existing customized editor templates.
71+
72+
![Upgrade Step 6](../images/upgrade-step-5.png)
73+
74+
The project will be upgraded to the latest {{ site.product }} version.
75+
76+
{% endif %}
77+
78+
{% if site.core %}
79+
4580
### Upgrading Manually
4681

4782
1. [Download]({% slug downloadinstall_aspnetcore %}#getting-the-binaries) the desired version from the **Download** section of your account.
@@ -61,31 +96,16 @@ To upgrade the version with NuGet or Bower:
6196

6297
> The `NuGet package` and the required [`client-side resources`]({% slug copyclientresources_aspnetmvc6_aspnetmvc %}) must have identical versions.
6398

64-
## Switching to a Developer License
65-
66-
1. After the purchase of a Developer License, follow the [Update your license key]({%slug installation_license_key_aspnetcore%}#license-key-updates) guidelines.
67-
68-
If you still see the Trial message after you switch to a developer (commercial) license, check the [troubleshooting knowledge base article]({% slug troubleshooting_trial_message %}).
6999

70100
{% else %}
71101

72-
* Use the [Upgrade Project Wizard](#using-the-upgrade-project-wizard)
73-
* [Manually replace the scripts and the style files](#upgrading-manually).
74-
75-
### Using the Upgrade Project Wizard
76-
77-
To upgrade your project with the Upgrade Project Wizard, refer to the following articles:
78-
79-
1. [Download the new Telerik UI version]({% slug latestversionretrieval_visualstudio_aspnetcore %}).
80-
1. [Start the **Upgrade Wizard**]({% slug projectwizardupgrade_visualstudio_aspnetmvc %}).
81-
82102
### Upgrading Manually
83103

84104
1. Replace all scripts, styles, and images that are related to Telerik UI for ASP.NET MVC with the desired version of the framework.
85-
1. Download the desired version from the **Download** section of your account.
86-
1. In the application, manually replace any references which point to the old Kendo UI [scripts and styles]({% slug copyclientresources_aspnetmvc6_aspnetmvc %}).
105+
1. Download the desired version from the [UI for ASP.NET MVC download page](https://www.telerik.com/account/product-download?product=KENDOUIMVC).
106+
1. In the application, manually replace any references that point to the old Kendo UI [scripts and styles]({% slug copyclientresources_aspnetmvc6_aspnetmvc %}).
87107

88-
* If the scripts and styles are referenced through the Kendo CDN service, update the links with the new version.
108+
* If the scripts and styles are referenced through the Kendo UI CDN service, update the links with the new version.
89109

90110
```HTML _Layout.cshtml
91111
<link rel="stylesheet" href="https://kendo.cdn.telerik.com/themes/{{ site.themesCdnVersion }}/default/default-main.css" />
@@ -97,22 +117,25 @@ To upgrade your project with the Upgrade Project Wizard, refer to the following
97117
* If the scripts and styles are referenced locally, download the JavaScript and CSS files from the Telerik website and then copying them in your project. For the detailed step-by-step procedure, refer to the [Using Local Files]({% slug using_local_client_side_resources%}) article.
98118

99119
> The `Kendo.Mvc.dll` and the required [`client-side resources`]({% slug copyclientresources_aspnetmvc6_aspnetmvc %}) must have identical versions.
120+
{% endif %}
100121

101-
## Switching to a Developer License
102-
103-
1. After the purchase of a Developer License, follow the [Update your license key]({%slug installation_license_key_aspnetcore%}#license-key-updates) guidelines.
104-
1. To upgrade to the latest product version, follow the steps for [updating the Telerik UI for ASP.NET MVC version](#upgrading-to-new-versions).
122+
## Switching to a Developer License [Deprecated]
105123

106-
## See Also
124+
> Starting with version 2025 Q3, the Trial package is deprecated, and the toolset is available only with a Developer License.
107125

108-
* [Upgrade Troubleshooting]({% slug upgrade_aspnetcore_troubleshooting %})
109-
* [Telerik UI for ASP.NET MVC Download and Installation]({% slug downloadinstall_aspnetcore %})
110-
* [Telerik UI for ASP.NET MVC Fundamentals]({% slug fundamentals_aspnetmvc %})
126+
1. After the purchase of a Developer License, follow the [Update your license key]({%slug installation_license_key_aspnetcore%}#license-key-updates) guidelines.
127+
1. To upgrade to the latest product version, follow the steps for [updating the {{ site.product }} version](#upgrading-to-new-versions).
111128

129+
{% if site.core %}
130+
If you still see the Trial message after you switch to a developer (commercial) license, check the [troubleshooting knowledge base article]({% slug troubleshooting_trial_message %}).
112131
{% endif %}
113132

114-
115133
## See Also
116134

117135
* [Upgrade Troubleshooting]({% slug upgrade_aspnetcore_troubleshooting %})
136+
{% if site.core %}
118137
* [Telerik UI for ASP.NET Core Download and Installation]({% slug downloadinstall_aspnetcore %})
138+
* [Downloading New Versions of Telerik UI for ASP.NET Core](https://www.telerik.com/aspnet-core-ui/documentation/vs-integration/latest-version-retrieval).
139+
{% else %}
140+
* [Upgrading Telerik UI for ASP.NET MVC Projects](https://www.telerik.com/aspnet-mvc/documentation/vs-integration/upgrade-wizard).
141+
{% endif %}

docs-aspnet/vs-integration/upgrade-wizard.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ To open the wizard, click **Telerik** > **Telerik UI for ASP.NET MVC** > **Upgra
2323

2424
The **Information Page** of the Upgrade Project Wizard describes the files and assemblies that are going to be upgraded.
2525

26-
![{{ site.product_short }} Upgrade Wizard Information page](../vs-integration/images/images-mvc/upgrade_warning.png)
26+
![{{ site.product_short }} Upgrade Wizard Information page](../installation/images/upgrade-step-1.png)
2727

2828
## Projects for Upgrade
2929

@@ -33,13 +33,13 @@ It is recommended to upgrade all projects to the selected version. The Compatibi
3333

3434
> The listed projects target all MVC versions that are supported. When you complete the Wizard, all selected projects will be updated.
3535
36-
![{{ site.product_short }} Choosing projects and distribution version](../vs-integration/images/images-mvc/upgrade_version.png)
36+
![{{ site.product_short }} Choosing projects and distribution version](../installation/images/upgrade-step-2.png)
3737

3838
## Project Resources for Upgrade
3939

4040
The **Upgrade Project Resources** page allows you to update the editor templates in `~/Views/Shared/EditorTemplates` by choosing **Update Editor Templates**.
4141

42-
![{{ site.product_short }} Updating project resources](../vs-integration/images/images-mvc/upgrade_settings.png)
42+
![{{ site.product_short }} Updating project resources](../installation/images/upgrade-step-3.png)
4343

4444
## Backup Creation
4545

@@ -49,7 +49,7 @@ The **Create Backup** page provides the following options:
4949
- **Don't create a backup**&mdash;Upgrades without creating a backup of your application.
5050
- **Show upgrade log when the Upgrade wizard finishes the upgrade**&mdash;Displays the upgrade log after the **Upgrade Wizard** finishes the upgrade.
5151

52-
![{{ site.product_short }} Creating backup](../vs-integration/images/images-mvc/upgrade_backup.png)
52+
![{{ site.product_short }} Creating backup](../installation/images/upgrade-step-4.png)
5353

5454
## See Also
5555

0 commit comments

Comments
 (0)