Skip to content

Commit 591141f

Browse files
committed
Sync with Kendo UI Professional
1 parent 1597880 commit 591141f

File tree

14 files changed

+77
-65
lines changed

14 files changed

+77
-65
lines changed

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

Lines changed: 52 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -35,8 +35,8 @@ You'll learn how to:
3535
<ul class="toc-ul">
3636
<li><span class="k-icon k-i-check"></span>Download and install the Telerik UI extensions.</li>
3737
<li><span class="k-icon k-i-check"></span>Create an ASP.NET Core MVC (Model-View-Controller) project.</li>
38-
<li><span class="k-icon k-i-check"></span>Initialize a DatePicker and a Grid.</li>
39-
<li><span class="k-icon k-i-check"></span>Bind data to Telerik UI widgets.</li>
38+
<li><span class="k-icon k-i-check"></span>Bind data to Telerik UI components like the Grid.</li>
39+
<li><span class="k-icon k-i-check"></span>Enhance the project with additional components like the DatePicker.</li>
4040
<li><span class="k-icon k-i-check"></span>Use the Telerik UI Themes.</li>
4141
<li><span class="k-icon k-i-check"></span>Add your license file.</li>
4242
</ul>
@@ -47,7 +47,7 @@ You'll learn how to:
4747

4848
* [Visual Studio 2017 or later](https://visualstudio.microsoft.com/downloads)
4949

50-
>For .NET Core 3.1 version or later, Visual Studio 2019 is required.
50+
>For newer .NET Core versions, a recent matching Visual Studio might be required.
5151
5252
* Windows 10 or higher
5353

@@ -80,11 +80,13 @@ Once you install the Telerik UI Extensions, you can open Visual Studio and start
8080

8181
Using this name guarantees that the `namespace` from the code snippets in this tutorial will match your project.
8282

83-
![{{ site.product_short }} New project configuration](../getting-started-core/images/new-project-configuration.png)
83+
![{{ site.product_short }} New project configuration](../getting-started-core/images/naming.png)
8484

85-
1. From the drop-down boxes, select the **.NET CORE** framework and **ASP.NET Core** version **5.0**.
85+
1. From the drop-down box, select the latest **ASP.NET Core** version for .NET target framework.
8686

87-
Telerik UI supports all ASP.NET Core versions, including 3.x, 5.0, and newer. The default is .NET 5.0.
87+
Telerik UI supports all newer ASP.NET Core versions.
88+
89+
![{{ site.product_short }} New Project Wizard](../vs-integration/images/essentials.png)
8890

8991
1. Select HTML or Tag Helpers.
9092

@@ -93,58 +95,37 @@ Once you install the Telerik UI Extensions, you can open Visual Studio and start
9395

9496
>tip In Razor files, Tag Helpers come with predefined strongly-typed attributes that enable server-side code to participate in the creation and rendering of HTML elements. The resulting markup is cleaner and easier to read than with traditional HTML Helpers, which are invoked as methods that are mixed with HTML inside your Razor views.
9597
96-
![{{ site.product_short }} New Project Wizard](../getting-started-core/images/telerik-app-wizard.png)
97-
98-
1. From the **VERSION** drop-down, select the latest Telerik UI version.
98+
1. From the **Select Version** list, select the latest Telerik UI version, and then select **Next**.
9999

100100
* If you use the Telerik UI extensions for the first time, you will see a login window. Enter the credentials for your [Telerik account](https://www.telerik.com/account) to download the controls.
101101
* If you haven't purchased a license, download the trial version of the Telerik UI controls.
102102

103103

104-
1. Select **STANDARD**, and then select **Next**.
104+
1. From the available options Select **Grid and Menu**, and then select **Next**.
105105

106-
The wizard offers [various templates]({% slug newprojectwizards_visualstudio_aspnetcore %}#available-templates) for projects with pre-configured Grid and Menu controls and for projects using Razor Pages. This tutorial uses the **STANDARD** MVC version.
106+
The wizard offers [various templates]({% slug newprojectwizards_visualstudio_aspnetcore %}#available-templates) for projects with pre-configured Grid and Menu controls and for projects using Razor Pages. This tutorial uses the **Grid and Menu** MVC version.
107107

108-
1. Select the default Boostrap-v4 theme, and then select **Finish**.
108+
![{{ site.product_short }} New Project Wizard](../vs-integration/images/available-templates.png)
109+
110+
1. Select the default theme and then select **Finish**.
109111

110112
The selected theme defines the appearance of the Telerik UI components. You can [change the theme](#changing-the-app-theme) at any time.
113+
114+
![{{ site.product_short }} New Project Wizard](../vs-integration/images/themes.png)
111115

112116
Congratulations! The created project:
113117

114118
* Is a working app.
115119

116120
* Has all resources required by Telerik UI, and you can start adding components immediately.
117121

118-
## Initializing a DatePicker
119-
120-
Next, you will add the first Telerik UI component to the project&mdash;the [Telerik UI DatePicker]({% slug htmlhelpers_datepicker_aspnetcore %}). The Telerik UI extensions have already configured the project with all required Telerik UI resources, and all you need now is to add the DatePicker HTML or Tag Helper. Whether you select the HTML or Tag Helper syntax depends on what you have configured when you have [created the project](#creating-the-project).
121-
122-
Utilize the [Telerik UI DatePicker]({% slug htmlhelpers_datepicker_aspnetcore %}) component by adding the snippet from the following example to `~/Views/Home/Index.cshtml`.
123-
124-
```HtmlHelper
125-
<div class="text-center">
126-
<h2>Telerik UI DatePicker for ASP.NET Core</h2>
127-
@(Html.Kendo().DatePicker()
128-
.Name("my-picker")
129-
)
130-
</div>
131-
```
132-
```TagHelper
133-
<div class="text-center">
134-
<h2>Telerik UI DatePicker for ASP.NET Core</h2>
135-
<kendo-datepicker name="my-picker"/>
136-
</div>
137-
```
138-
139-
Run the project. The following page is visualized in the browser:
140-
141-
![{{ site.product_short }} Sample page](../getting-started-core/images/sample-page.png)
122+
## The Grid and Data Binding
142123

143-
## Initializing a Grid and Binding Data
124+
The next step is to examine the Telerik UI Grid which the template wizard added to your project. The Grid is the richest component in the entire toolset, but this sample will only demonstrate a basic implementation.
144125

145-
The next step is to add the more complex Telerik UI Grid to your project. You will bind the Grid to data, and this requires adding a model and controller.
126+
Binding the Grid requires adding a model and controller. The Wizard has done the following automatically:
146127

147-
1. Add a `Models` folder to the project. Create an `OrderViewModel` class and add it to the `Models` folder.
128+
1. Added a `Models` folder to the project. Created an `OrderViewModel` class and added it to the `Models` folder.
148129

149130
The model represents the shape of the data that the Grid will display.
150131

@@ -185,13 +166,11 @@ The next step is to add the more complex Telerik UI Grid to your project. You wi
185166

186167
>When the Grid is bound to a strongly-typed model such as the OrderViewModel, it automatically detects the data types of the fields.
187168

188-
1. Right-click the `Controllers` folder. Select **Add** > **Controller...**, and then select **Add**.
169+
1. Created a new Controller and named the file `GridController`.
189170

190171
The controller handles the incoming requests, retrieves the model data, and then returns the requested data.
191172

192-
1. Name the file `GridController`.
193-
194-
1. In `GridController.cs`, add the following declarations at the top. They enable the data processing by the Telerik UI extensions:
173+
1. In `GridController.cs`, added the following declarations at the top. They enable the data processing by the Telerik UI extensions:
195174

196175
```
197176
using Kendo.Mvc.Extensions;
@@ -202,7 +181,7 @@ The next step is to add the more complex Telerik UI Grid to your project. You wi
202181
using TelerikAspNetCoreApp.Models;
203182
```
204183

205-
1. In `GridController.cs`, add an ActionMethod that will return the data for the Grid.
184+
1. In `GridController.cs`, added an ActionMethod that will return the data for the Grid.
206185

207186
```
208187
public class GridController : Controller
@@ -224,7 +203,7 @@ The next step is to add the more complex Telerik UI Grid to your project. You wi
224203
}
225204
```
226205

227-
1. In the `~/Views/Home/Index.cshtml` file, add the Grid:
206+
1. In the `~/Views/Home/Index.cshtml` file, added the Grid:
228207

229208
```HtmlHelper
230209
@(Html.Kendo().Grid <TelerikAspNetCoreApp.Models.OrderViewModel>()
@@ -272,12 +251,39 @@ The next step is to add the more complex Telerik UI Grid to your project. You wi
272251
</kendo-grid>
273252
```
274253

275-
1. Run the project.
254+
1. Now you can run the project and enjoy the neat result:
255+
256+
![{{ site.product_short }} Sample page](../getting-started-core/images/grid.png)
276257

277258
>tip For more information on data processing and data binding, see the following articles:
278259
>* [Binding the Grid to a database]({%slug htmlhelpers_grid_aspnetcore_ajaxbinding%})
279260
>* [CRUD operations](https://demos.telerik.com/aspnet-core/grid/editing)
280261
262+
## Adding a DatePicker
263+
264+
Next, you will add another Telerik UI component to the project&mdash;the [Telerik UI DatePicker]({% slug htmlhelpers_datepicker_aspnetcore %}). You can add the DatePicker as an HTML or Tag Helper. Whether you select the HTML or Tag Helper syntax depends on what you have configured when you have [created the project](#creating-the-project).
265+
266+
Utilize the [Telerik UI DatePicker]({% slug htmlhelpers_datepicker_aspnetcore %}) component by adding the snippet from the following example to `~/Views/Home/Index.cshtml`.
267+
268+
```HtmlHelper
269+
<div class="text-center">
270+
<h2>Telerik UI DatePicker for ASP.NET Core</h2>
271+
@(Html.Kendo().DatePicker()
272+
.Name("my-picker")
273+
)
274+
</div>
275+
```
276+
```TagHelper
277+
<div class="text-center">
278+
<h2>Telerik UI DatePicker for ASP.NET Core</h2>
279+
<kendo-datepicker name="my-picker"/>
280+
</div>
281+
```
282+
283+
Run the project. The following result is visualized in the browser:
284+
285+
![{{ site.product_short }} Sample page](../getting-started-core/images/sample-page.png)
286+
281287
Next, you can [change the look and feel](#changing-the-app-theme) of your application by selecting another visual theme.
282288

283289
## Changing the App Theme
78.6 KB
Loading
58.1 KB
Loading

docs-aspnet/vs-integration/configure-project-wizard.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ The configuration wizard handles the following tasks:
3030
The **Theme Selection** page enables you to change the [visual theme](https://docs.telerik.com/kendo-ui/styles-and-layout/appearance-styling#getting-started) of your {{ site.product }} application.
3131

3232
{% if site.core %}
33-
![{{ site.product_short }} Visual theme configuration page of the Project Configuration Wizard](../vs-integration/images/configure_theme.png)
33+
![{{ site.product_short }} Visual theme configuration page of the Project Configuration Wizard](../vs-integration/images/configure-project.png)
3434
{% else %}
3535
![{{ site.product_short }} Visual theme configuration page of the Project Configuration Wizard](../vs-integration/images/images-mvc/configure_theme.png)
3636
{% endif %}
@@ -46,7 +46,7 @@ The **Project Settings** page allows you to modify the project settings by confi
4646
- **Use CDN Support**&mdash;Enables or disables the [Kendo UI CDN support](https://docs.telerik.com/kendo-ui/intro/installation/cdn-service).
4747

4848
{% if site.core %}
49-
![{{ site.product_short }} Project settings configuration page of the Project Configuration Wizard](../vs-integration/images/configure_settings.png)
49+
![{{ site.product_short }} Project settings configuration page of the Project Configuration Wizard](../vs-integration/images/settings.png)
5050
{% else %}
5151
![{{ site.product_short }} Project settings configuration page of the Project Configuration Wizard](../vs-integration/images/images-mvc/configure_settings.png)
5252
{% endif %}

docs-aspnet/vs-integration/convert-project-wizard.md

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@ The conversion wizard provides the following steps:
5858
The version selection allows you to choose which version of {{ site.product }} to use in your application.
5959
6060
{% if site.core %}
61-
![{{ site.product_short }} Version selection](../vs-integration/images/convert-wizard-version.png)
61+
![{{ site.product_short }} Version selection](../vs-integration/images/convert-project.png)
6262
{% else %}
6363
![{{ site.product_short }} Version selection](../vs-integration/images/images-mvc/convert_distribution.png)
6464
{% endif %}
@@ -68,11 +68,20 @@ The version selection allows you to choose which version of {{ site.product }} t
6868
The theme selection allows you to choose from a large list of professionally styled built-in themes for your {{ site.product }} application.
6969
7070
{% if site.core %}
71-
![{{ site.product_short }} Theme selection](../vs-integration/images/theme-selection.png)
71+
![{{ site.product_short }} Theme selection](../vs-integration/images/convert-theme.png)
7272
{% else %}
7373
![{{ site.product_short }} Theme selection](../vs-integration/images/images-mvc/convert_theme.png)
7474
{% endif %}
7575
76+
{% if site.core %}
77+
## Back Up
78+
79+
You can create a back up for the project in the state they were before the update.
80+
81+
![{{ site.product_short }} Theme selection](../vs-integration/images/backup.png)
82+
{% endif %}
83+
84+
{% if site.mvc %}
7685
## Project Settings
7786
7887
The **Project Settings** page enables you to modify the project settings by configuring the following options:
@@ -82,12 +91,11 @@ The **Project Settings** page enables you to modify the project settings by conf
8291
- **Copy Global Resources**&mdash;Copies the localization files to {% if site.core %}`~/wwwroot/lib/kendo-ui/js/messages`{% else %}`~/Scripts/kendo/{version}/cultures`{% endif %}.
8392
- **Use CDN Support**&mdash;Enables or disables the [Kendo UI CDN support](https://docs.telerik.com/kendo-ui/intro/installation/cdn-service).
8493
85-
{% if site.core %}
86-
![{{ site.product_short }} Project settings](../vs-integration/images/project-settings.png)
87-
{% else %}
8894
![{{ site.product_short }} Project settings](../vs-integration/images/images-mvc/convert_settings.png)
8995
{% endif %}
9096
97+
## Manual Alternative
98+
9199
The wizard automates several steps that are crucial for the project configuration. If you decide to perform these steps manually, follow the links below:
92100
93101
- [Adding the NuGet Package]{% if site.core %}({% slug gettingstarted_aspnetmvc6_aspnetmvc %}#adding-the-nuget-package){% else %}({% slug setupwithnuget_aspnetmvc %}#installing-the-nuget-package){% endif %}
130 KB
Loading
68.1 KB
Loading
140 KB
Loading
79.1 KB
Loading
138 KB
Loading

0 commit comments

Comments
 (0)