You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: 15/umbraco-cms/fundamentals/setup/install/README.md
+8-2Lines changed: 8 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,9 +4,15 @@ description: Instructions on installing Umbraco on various platforms using vario
4
4
5
5
# Installation
6
6
7
+
## Install the latest .NET SDK
8
+
9
+
Before you install Umbraco, you must ensure that you can run it on your machine.
10
+
11
+
* Identify and install the latest [.NET SDK](https://dotnet.microsoft.com/download).
12
+
7
13
## Install Umbraco using CLI
8
14
9
-
The fastest way to get the latest version of Umbraco up and running is using the command line (CLI).
15
+
The fastest way to get the latest version of Umbraco up and running is by using the command line (CLI).
10
16
11
17
1. Open your command line.
12
18
2. Install the Umbraco templates:
@@ -52,7 +58,7 @@ Members of the Umbraco Community have created a website that makes the installat
52
58
53
59
## Alternative Methods for Installing Umbraco
54
60
55
-
There are numerous ways to install Umbraco. Below, you can find links to different installation methods that will help you easily install and set up Umbraco projects. 
61
+
There are numerous ways to install Umbraco. Below, you can find links to different installation methods that will help you easily install and set up Umbraco projects.
Copy file name to clipboardExpand all lines: 15/umbraco-cms/tutorials/creating-a-basic-website/creating-master-template-part-2.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ We will now create a page to display our contact details. For added functionalit
6
6
7
7
Here are some potential solutions:
8
8
9
-
***Use Umbraco Forms (for non-developers):** Umbraco offers an add-on called Umbraco Forms. This tool is ideal for users who aren’t programmers, as it allows editors to create custom forms. You can find more information and purchase the product on [Umbraco.com](https://umbraco.com/products/umbraco-forms/).
9
+
***Use Umbraco Forms (for non-developers):** Umbraco offers an add-on called Umbraco Forms. This tool is ideal for users who aren’t programmers, as it allows editors to create custom forms. You can find more information and purchase the product on [Umbraco.com](https://umbraco.com/products/add-ons/forms/).
10
10
***Build Your Own Contact Form (for developers):** If you prefer a custom solution, you can build your own contact form using [Surface Controllers](../../fundamentals/code/creating-forms.md) in Umbraco.
Copy file name to clipboardExpand all lines: 15/umbraco-cms/tutorials/creating-a-property-editor/custom-value-conversion-for-rendering.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -75,4 +75,4 @@ public class MySuggestionsModel
75
75
We have used the property type editor UI alias from `umbraco-package.json` in the implementation of `IsConverter()`.
76
76
{% endhint %}
77
77
78
-
For more advanced Property Value Converter techniques (for example, controlling caching), see the [Property Value Converters](https://docs.umbraco.com/umbraco-cms/extending/property-editors/property-value-converters) article.
78
+
For more advanced Property Value Converter techniques (for example, controlling caching), see the [Property Value Converters](../../customizing/property-editors/property-value-converters.md) article.
Copy file name to clipboardExpand all lines: 15/umbraco-cms/tutorials/getting-started-with-entity-framework-core.md
+2-7Lines changed: 2 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -39,7 +39,7 @@ You need to be aware of some things if you are using EF Core, and have installed
39
39
40
40
* This package has a transient dependency to `Microsoft.CodeAnalysis.Common` which clashes with the same transient dependency from `Umbraco.Cms 13.0.0`. This happens because `Microsoft.EntityFrameworkCore.Design 8.0.0` requires `Microsoft.CodeAnalysis.CSharp.Workspaces` in v4.5.0 or higher.
41
41
* If there are no other dependencies that need that package then it installs it in the lowest allowed version (4.5.0). That package then has a strict dependency on `Microsoft.CodeAnalysis.Common` version 4.5.0. The problem is `Umbraco.Cms` through its own transient dependencies that require the version of `Microsoft.CodeAnalysis.Common` to be >= 4.8.0.
42
-
* This can be fixed by installing `Microsoft.CodeAnalysis.CSharp.Workspaces` version 4.8.0 as a specific package instead of leaving it as a transient dependency. This is because it will then have a strict transient dependency on `Microsoft.CodeAnalysis.Common` version 4.8.0, which is the same that Umbraco has.
42
+
* This can be fixed by installing `Microsoft.CodeAnalysis.CSharp.Workspaces` version 4.10.0 as a specific package instead of leaving it as a transient dependency. This is because it will then have a strict transient dependency on `Microsoft.CodeAnalysis.Common` version 4.8.0, which is the same that Umbraco has.
We can then access the database via the `BlogContext.` First, we need to migrate the database to add our tables. With EFCore, we can autogenerate the migrations with the terminal.
137
137
138
138
{% hint style="info" %}
139
-
140
139
For package developers and not only, but in general as well, it's recommended to use the `UseUmbracoDatabaseProvider` logic. This is because it will then figure out what the correct database is used:
2. Open your terminal and navigate to your project folder.
152
-
3. Generate the migration by running: 
150
+
3. Generate the migration by running:
153
151
154
152
```bash
155
153
dotnet ef migrations add InitialCreate --context BlogContext
@@ -164,7 +162,6 @@ If you use another class library in your project to store models and DBContext c
164
162
```bash
165
163
dotnet ef migrations add initialCreate -s ../Project.Web/ --context BlogContext
166
164
```
167
-
168
165
{% endhint %}
169
166
170
167
In this example, we have named the migration `InitialCreate`. However, you can choose the name you like.
@@ -243,9 +240,7 @@ To create, read, update, or delete data from your custom database tables, use th
243
240
The example below creates a `UmbracoApiController` to be able to fetch and insert blog comments in a custom database table.
244
241
245
242
{% hint style="warning" %}
246
-
247
243
* This example uses the `BlogComment` class, which is a database model. The recommended approach would be to map these over to a ViewModel instead, that way your database & UI layers are not coupled. Be aware that things like error handling and data validation have been omitted for brevity.
0 commit comments