Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion 17/umbraco-cms/extending/packages/creating-a-package.md
Original file line number Diff line number Diff line change
Expand Up @@ -112,7 +112,7 @@ Additionally, the `.csproj` file is configured to support NuGet packaging, allow
Since the `umbraco-extension` template does not generate an `App_Plugins` folder by default, you will need to manually create it.

1. Create an `App_Plugins` folder in the downloaded package folder.
2. Go to the `welcome-dashboard` folder created in the [Creating a Custom Dashboard Tutorial](../../tutorials/creating-a-custom-dashboard/#setting-up-a-package).
2. Go to the `welcome-dashboard` folder created in the [Creating a Custom Dashboard Tutorial](../../tutorials/creating-a-custom-dashboard/README.md#setting-up-a-package).
3. Transfer or copy the `welcome-dashboard` folder in the `App_Plugins` folder.

![App\_Plugins with dashboard files](images/app-plugins-content.png)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ The Data Type editor allows you to configure the following properties:

## Setup Block Types

Block Types are based on [**Element Types**](../../../../data/defining-content/#element-types). These can be created beforehand or while setting up your Block Types.
Block Types are based on [**Element Types**](../../../../data/defining-content/default-document-types.md#element-type). These can be created beforehand or while setting up your Block Types.

Once you have added an Element Type as a Block Type on your Block Grid Data Type you have the option to configure it.

Expand Down Expand Up @@ -197,8 +197,8 @@ The Block is resized using a click-and-drag feature. Moving the mouse will chang

Rendering the stored value of your **Block Grid** property editor can be done in two ways:

1. [Default rendering](block-grid-editor.md#1-default-rendering)
2. [Build your own rendering](block-grid-editor.md#2-build-your-own-rendering)
1. [Default rendering](#1-default-rendering)
2. [Build your own rendering](#2-build-custom-rendering)

### 1. Default rendering

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
This article is a work in progress and may undergo further revisions, updates, or amendments. The information contained herein is subject to change without notice.
{% endhint %}

**Block List** is a list editing property editor, using [Element Types](../../../../data/defining-content/#element-types) to define the list item schema.
**Block List** is a list editing property editor, using [Element Types](../../../../data/defining-content/default-document-types.md#element-type) to define the list item schema.

{% hint style="info" %}
The _Block List_ replaces the obsolete _Nested Content_ editor.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,6 @@ For general information on working with stylesheets and JavaScript in Umbraco, c

If you wanted to target a specific Rich Text Editor, you can set the [stylesheet directly in the configuration](configuration.md#stylesheets).


## Custom CSS properties reference

The following CSS properties are available for customization:
Expand All @@ -30,6 +29,5 @@ The following CSS properties are available for customization:
| `--umb-rte-min-height` | The minimum height of the rich-text-editor | `100%` |
| `--umb-rte-max-height` | The maximum height of the rich-text-editor | `100%` |


The CSS custom properties may change in future versions of Umbraco. You can always find the latest values in the [Rich Text Editor component base class](https://github.com/umbraco/Umbraco-CMS/blob/main/src/Umbraco.Web.UI.Client/src/packages/rte/components/rte-base.element.ts) in the Umbraco CMS GitHub repository.

Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ The feature can be configured in the `appSettings.json`:
}
```

For sites with stricter requirements, it is possible to opt-out of both options globally, see [ContentSettings](../../reference/configuration/contentsettings.md#contentversioncleanuppolicy) and by Document Type.
For sites with stricter requirements, it is possible to opt-out of both options globally, see [ContentSettings](../../reference/configuration/contentsettings.md#content-version-cleanup-policy) and by Document Type.

Additionally, it is possible to keep the feature enabled but mark specific versions to keep forever.

Expand Down
6 changes: 3 additions & 3 deletions 17/umbraco-cms/fundamentals/data/creating-media/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,15 +19,15 @@ Media in Umbraco CMS is handled the same way as content. You define **Media Type
The default Media Types aim to cover most needs for media on a website. You do not need to define your Media Types to start using the Media section. The tools for organizing and uploading the media are already in place.

{% hint style="info" %}
If you have upgraded from an older version than 8.14 the Media Types listed above are not added automatically. You can add those types manually yourselves by following the steps below ['Creating a new Media Type'](./#creating-a-media-type). On the [default media types page](default-media-types.md), you will find a detailed overview of all Media Types.
If you have upgraded from an older version than 8.14 the Media Types listed above are not added automatically. You can add those types manually yourselves by following the steps below ['Creating a new Media Type'](#creating-a-media-type). On the [default media types page](default-media-types.md), you will find a detailed overview of all Media Types.
{% endhint %}

## Uploading Media

You can upload media in two different ways:

* [Through the Media section](./#add-media-through-the-media-section) and
* [Through the Content section](./#add-media-through-the-content-section)
* [Through the Media section](#add-media-through-the-media-section) and
* [Through the Content section](#add-media-through-the-content-section)

### Add media through the Media section

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ On this page, you will find the default Document Types in Umbraco. If you want t

## Document Type

A Document Type defines the content structure and fields that can be used across different content items. When creating a Document Type without a template, you focus solely on structured content without tying it to a specific design or layout. This is ideal for content that doesn’t require direct front-end rendering, such as reusable blocks or items managed within a headless CMS setup.
A Document Type defines the content structure and fields that can be used across different content items. When creating a Document Type without a template, you focus solely on structured content without tying it to a specific design or layout. This is ideal for content that doesn’t require direct front-end rendering, such as reusable blocks or items managed within a headless CMS setup.

Use a Document Type without a template for structured, reusable content like metadata schemas, settings, or components such as product details and author profiles.

Expand All @@ -28,7 +28,7 @@ An Element Type is a Document Type *without a template* designed for reusable an

Element Types are not part of the Content tree and cannot render directly on the front end. When created, the **Is an Element Type** flag in the **Permissions** tab is automatically set to **True**.

![Element type](../images/Element-Type.png))
![Element type](../images/Element-Type.png)

Use an Element Type when defining building blocks for complex page layouts, such as grid blocks or call-to-action sections. They are an essential part of modular content design.

Expand Down
2 changes: 1 addition & 1 deletion 17/umbraco-cms/fundamentals/data/dictionary-items.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ To edit a dictionary item, follow these steps:
{% hint style="info" %}
It will only be possible to edit the language(s) that the given user has access to. The value of the remaining languages will be _read-only_.

Which language a user has access to is determined by the "Language permissions" set on the User Group. Learn more about this feature in the [Users](users/#creating-a-user-group) article.
Which language a user has access to is determined by the "Language permissions" set on the User Group. Learn more about this feature in the [Users](users/README.md#creating-a-user-group) article.
{% endhint %}

## Fetching Dictionary Values in the Template
Expand Down
2 changes: 1 addition & 1 deletion 17/umbraco-cms/fundamentals/design/rendering-content.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ _The primary task of any template is to render the values of the current page or

## Display a value in your template view

Each property in your [Document Type](../data/defining-content/#what-is-a-document-type) has an alias, this is used to specify where in the template view to display the value.
Each property in your [Document Type](../data/defining-content/README.md#what-is-a-document-type) has an alias, this is used to specify where in the template view to display the value.

```html
<h1>@Model.Value("pageTitle")</h1>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ or

With the stylesheet referenced, you will be able to style the template file with the rules and classes defined in the stylesheet.

Your stylesheets can be used in Rich Text Editors (datatype) as well - please see the [Rich Text Editor](../backoffice/property-editors/built-in-umbraco-property-editors/rich-text-editor/#rte-styles) documentation for more information.
Your stylesheets can be used in Rich Text Editors (datatype) as well. See the [Rich Text Editor](../backoffice/property-editors/built-in-umbraco-property-editors/rich-text-editor/css-properties.md) documentation for more information.

{% hint style="info" %}
If your RTE is styled differently on the frontend of the site, the backoffice styling might be getting overwritten by other stylesheets you have included.
Expand Down
7 changes: 4 additions & 3 deletions 17/umbraco-cms/fundamentals/setup/install/visual-studio.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ description: A guide to install Umbraco CMS using Visual Studio.

## Quick Start

This is an abbreviated version of the installation steps. Jump to the [Create a new project](visual-studio.md#new-project) section for a more thorough guide.
This is an abbreviated version of the installation steps. Jump to the [Create a new project](#create-a-new-umbraco-project) section for a more thorough guide.

* Open Visual Studio.
* Go to `File` > `New` > `Project`, search for **Umbraco**.
Expand All @@ -29,9 +29,10 @@ How to install Umbraco using NuGet and Visual Studio

## Create a new Umbraco project

To install Umbraco we first need to install Umbraco's dotnet new templates.
To install Umbraco, follow these steps:

For more information check the first 2 steps of [Install Umbraco with .NET CLI](install-umbraco-with-templates.md#install-the-template).
1. Install the latest [.NET SDK](https://dotnet.microsoft.com/download).
2. Run `dotnet new install Umbraco.Templates` to install the project templates.

### Create the Visual Studio project

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -133,7 +133,7 @@ Ensure to analyze logs from all servers and check for any warnings and errors.

When upgrading it is possible to run the upgrades unattended.

Find steps on how to enable the feature for a load balanced setup in the [General Upgrades](../../upgrading/#unattended-upgrades-in-a-load-balanced-setup) article.
Find steps on how to enable the feature for a load balanced setup in the [General Upgrades](../../upgrading/upgrade-unattended.md#unattended-upgrades-in-a-load-balanced-setup) article.

## FAQs

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ The upgrade will run through all the files and make sure you have the latest cha

### Upgrades to versions lower than 7.2.0

If you're not upgrading to 7.2.0 or higher then you should follow these extra instructions. If you are upgrading to 7.2.0+ then you can skip this and go to [Merge UI.xml and language](minor-upgrades-for-umbraco-7.md#merge-ui-xml-and-language).
If you're not upgrading to 7.2.0 or higher then you should follow these extra instructions. If you are upgrading to 7.2.0+ then you can skip this and go to [Merge UI.xml and language](#merge-uixml-and-language).

You will be asked to overwrite your web.config file and the files in /config, make sure to answer **No** to those questions.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,7 @@ Below you will find the steps you need to take in order to upgrade your project
{% hint style="info" %}
Are you running a load balanced setup with multiple servers and environments?

Check out the section about [Unattended upgrades in a load balanced setup](#unattended-upgrades-in-a-load-balanced-setup).
Check out the section about [Unattended upgrades in a load balanced setup](../upgrade-unattended.md#unattended-upgrades-in-a-load-balanced-setup).
{% endhint %}

### Enable the feature
Expand Down
2 changes: 1 addition & 1 deletion 17/umbraco-cms/reference/configuration/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ Now it's possible to store the connection string with this command:

`dotnet user-secrets set "ConnectionStrings:umbracoDbDSN" "CONNECTION_STRING_IN_HERE"`

The name of the key is created in the same way as in the [Command Line](./#using-command-line-arguments-configuration) example above, and thus corresponds to this JSON chunk:
The name of the key is created in the same way as in the [Command Line](#using-command-line-arguments-configuration) example above, and thus corresponds to this JSON chunk:

```json
"ConnectionStrings": {
Expand Down
2 changes: 1 addition & 1 deletion 17/umbraco-cms/release-candidate-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,7 @@ Here is a list of all the new or updated articles in this version.
* [Backoffice Signs](customizing/back-office-signs.md)
* [Flag Providers](extending/flag-providers.md)
* [Added `ComposeAfter` attribute to the composer used in the Examine sample](reference/searching/examine/indexing.md#creating-a-configureoptions-class)
* [Displaying the MiniProfiler](fundamentals/code/debugging/#displaying-the-miniprofiler)
* [Displaying the MiniProfiler](fundamentals/code/debugging/README.md#displaying-the-miniprofiler)
* [Load Balancing the Backoffice](fundamentals/setup/server-setup/load-balancing/load-balancing-backoffice.md)
* [SignalR in a Backoffice Load Balanced Environment](fundamentals/setup/server-setup/load-balancing/signalR-in-backoffice-load-balanced-environment.md)
* [Distributed jobs settings](reference/configuration/distributedjobssettings.md)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -247,4 +247,4 @@ export default ExampleBlockCustomView;

## Rendering the Block List Content

To render the stored value of your Block List editor on the frontend, see the [Rendering Block List Content](../fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/block-editor/#block-list) section.
To render the stored value of your Block List editor on the frontend, see the [Rendering Block List Content](../fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/block-editor/README.md#block-list) section.
6 changes: 3 additions & 3 deletions 17/umbraco-cms/tutorials/custom-error-page.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,9 +16,9 @@ In Umbraco, in-code error page handling refers to managing and displaying custom

This article contains guides on how to create custom error pages for the most common scenarios:

* [404 Errors ("Page not found")](custom-error-page.md#id-404-errors)
* [500 Errors ("Internal Server Error")](custom-error-page.md#id-500-errors)
* [Boot Failed Errors](custom-error-page.md#boot-failed-errors)
* [404 Errors ("Page not found")](#404-errors)
* [500 Errors ("Internal Server Error")](#500-errors)
* [Boot Failed Errors](#boot-failed-errors)

{% hint style="info" %}
**Are you looking for a guide to create a custom maintenance page?**
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ If your system administrator has set up cropping for your images, you will see a

The circle in the middle of the image is the default focal point. The focal point defines the primary area or focus of the image which will be the center point of any image re-sizing. You can move the focal point by clicking and dragging it to the desired part of the image.

Next to the image, you may see specific crops of the image depending on your setup. In the above example, you can see that 2 crops have been set-up. To add or update the image crops, see [Adding properties](../../../fundamentals/data/creating-media/#adding-properties) section in the [Creating media](../../../fundamentals/data/creating-media/) article.
Next to the image, you may see specific crops of the image depending on your setup. In the above example, you can see that 2 crops have been set-up. To add or update the image crops, see [Adding properties](../../../fundamentals/data/creating-media/README.md#adding-properties) section in the [Creating media](../../../fundamentals/data/creating-media/) article.

To manually alter the pre-defined crops:

Expand Down