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
In Umbraco we use the underlying logging framework of [Serilog](https://serilog.net/).
8
8
9
-
Out of the box we write a JSON log file that contains a more rich logfile, that allows tools to perform searches & correlation on log patterns a lot easier.
9
+
Out of the box, we write a JSON log file that contains a more detailed logfile. This allows tools to perform searches and correlations on log patterns more efficiently.
10
10
11
11
The default location of this file is written to `umbraco/Logs` and contains the Machine name, along with the date too:
12
12
@@ -20,7 +20,7 @@ Serilog is a logging framework that allows us to do structured logging or write
Here is an example of the same log message represented as JSON, you can see here we have much more information that would allow us to search & filter logs based on these properties with an appropriate logging system.
23
+
Here is an example of the same log message represented as JSON. More information is available and allows you to search and filter logs based on these properties with an appropriate logging system.
24
24
25
25
```json
26
26
{
@@ -46,13 +46,13 @@ Here is an example of the same log message represented as JSON, you can see here
46
46
}
47
47
```
48
48
49
-
To learn more about structured logging and message templates you can read more about it over on the [https://messagetemplates.org](https://messagetemplates.org) website or alternatively watch this video from the Serilog creator - [https://www.youtube.com/watch?v=OhmNp8UPEEg](https://www.youtube.com/watch?v=OhmNp8UPEEg)
49
+
To learn more about structured logging and message templates you can read more about it over on the [https://messagetemplates.org](https://messagetemplates.org) website. Alternatively watch this video from the Serilog creator - [https://www.youtube.com/watch?v=OhmNp8UPEEg](https://www.youtube.com/watch?v=OhmNp8UPEEg)
50
50
51
51
## Writing to the log
52
52
53
-
Umbraco writes log messages, but you are also able to use the Umbraco logger to write the log file as needed, so you can get further insights and details about your implementation.
53
+
Umbraco writes log messages, but you are also able to use the Umbraco logger to write the log file as needed. This allows you to gain further insights and details about your implementation.
54
54
55
-
Here is an example of using the logger to write an Information message to the log which will contain one property of **Name** which will output the name variable that is passed into the method
55
+
Here is an example of using the logger to write an Information message to the log. It will contain one property, **Name**, which will output the name variable that is passed into the method.
Copy file name to clipboardExpand all lines: 10/umbraco-cms/reference/cache/examples/tags.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
@@ -18,7 +18,7 @@ For this example we're working with tags. On my site I have two tag properties:
18
18
19
19
We're going to expose an endpoint that allows us to get the tags from each group.
20
20
21
-
The tags from the `default` should be cached for a minute and the`blog` tags will be cached until site restart or if you publish a blog post node in the Backoffice.
21
+
The tags from the `default` should be cached for a minute. The`blog` tags will be cached until site restart or if you publish a blog post node in the Backoffice.
Copy file name to clipboardExpand all lines: 10/umbraco-cms/reference/querying/itagquery.md
+7-7Lines changed: 7 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,7 +7,7 @@ description: "Working with tags in Umbraco"
7
7
8
8
# ITagQuery
9
9
10
-
The `ITagQuery` interface is your primary way to work with tags in Umbraco, the interface allows you to get the various tags like content tags and media tags, as well as getting content by tag, for instance getting all content nodes with the "Umbraco" tag.
10
+
The `ITagQuery` interface is your primary way to work with tags in Umbraco. This interface allows you to get different tags, such as content tags and media tags. It also lets you retrieve content by tag, for instance, getting all content nodes with the "Umbraco" tag.
`ITagQuery` is a scoped service, meaning that it should only be injected into scoped or transient services, for more information see the official [Microsoft Documentation](https://docs.microsoft.com/en-us/dotnet/core/extensions/dependency-injection#scoped)
52
+
`ITagQuery` is a scoped service, meaning that it should only be injected into scoped or transient services. For more information see the official [Microsoft Documentation](https://docs.microsoft.com/en-us/dotnet/core/extensions/dependency-injection#scoped)
53
53
{% endhint %}
54
54
55
55
## Examples
@@ -58,7 +58,7 @@ All examples are from a view using the injection shown above, but working with t
58
58
59
59
### GetAllContentTags([string tagGroup])
60
60
61
-
Get a collection of tags used by content items on the site, you can optionally pass in a group name to only list tags belonging to a specific tag group
61
+
Get a collection of tags used by content items on the site. Optionally, you can pass in a group name to only list tags belonging to a specific tag group
62
62
63
63
```csharp
64
64
@{
@@ -69,7 +69,7 @@ Get a collection of tags used by content items on the site, you can optionally p
69
69
70
70
### GetAllMediaTags([string tagGroup])
71
71
72
-
Get a collection of tags used by media items on the site, you can optionally pass in a group name to only list tags belonging to a specific tag group
72
+
Get a collection of tags used by media items on the site. Optionally, you can pass in a group name to only list tags belonging to a specific tag group
73
73
74
74
```csharp
75
75
@{
@@ -80,7 +80,7 @@ Get a collection of tags used by media items on the site, you can optionally pas
80
80
81
81
### GetAllMemberTags([string tagGroup])
82
82
83
-
Get a collection of tags used by members on the site, you can optionally pass in a group name to only list tags belonging to a specific tag group
83
+
Get a collection of tags used by members on the site. Optionally, you can pass in a group name to only list tags belonging to a specific tag group
84
84
85
85
```csharp
86
86
@{
@@ -91,7 +91,7 @@ Get a collection of tags used by members on the site, you can optionally pass in
91
91
92
92
### GetAllTags([string tagGroup])
93
93
94
-
Get a collection of tags used on the site, you can optionally pass in a group name to only list tags belonging to a specific tag group
94
+
Get a collection of tags used on the site. Optionally, you can pass in a group name to only list tags belonging to a specific tag group
95
95
96
96
```csharp
97
97
@{
@@ -152,7 +152,7 @@ Get a collection of tags by entity id (queries content, media and members), and
Returns all records with the state set to approved from the Form with the id = `formId` on the Umbraco page with the id = `pageId` as a `PagedResult<IRecord>`.
* Null checks on setting prevalue captions handling issues with upgraded form definitions [#1148](https://github.com/umbraco/Umbraco.Forms.Issues/issues/1148).
Copy file name to clipboardExpand all lines: 13/umbraco-cms/extending/packages/README.md
+3-7Lines changed: 3 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,7 +13,7 @@ An Umbraco Package can be many things, but is generally characterized by:
13
13
- Adding or extending functionality in the Umbraco CMS
14
14
- Empowering people to do more and/or do things more efficiently
15
15
- Engaging community members in collaboration and sharing
16
-
- Solving reallife problems
16
+
- Solving real-life problems
17
17
- Inspiring people on what Umbraco can be made capable of
18
18
19
19
### Categories of packages
@@ -32,11 +32,11 @@ A package that can be categorized as a Schema Extension will extend the default
32
32
33
33
#### Management Extensions
34
34
35
-
A Management Extension package helps you manage your site, and provides information to the users. Management extensions typically contain custom sections or dashboards to facilitate site management. [Diplo God Mode](https://marketplace.umbraco.com/package/diplo.godmode) is an example of a comprehensive management extension package with additional tools and information.
35
+
A Management Extension package helps you manage your site and provides information to the users. Management extensions typically contain custom sections or dashboards to facilitate site management. [Diplo God Mode](https://marketplace.umbraco.com/package/diplo.godmode) is an example of a comprehensive management extension package with additional tools and information.
36
36
37
37
#### Starter Kits
38
38
39
-
Starter kits are, as the name suggests, a package that helps you set up a starter version of whatever you want to build. Most starter kit packages are for starting a website, and include schema like Document Types and Templates as well as content nodes and media. There are also some specialized starter kits, for example for creating a blog. Umbraco HQ has released their [own starter kit](https://www.nuget.org/packages/Umbraco.TheStarterKit), that creates a small site with the most commonly used features.
39
+
Starter kits are, as the name suggests, a package that helps you set up a starter version of whatever you want to build. Most starter kit packages are for starting a website, and include schema like Document Types and Templates as well as content nodes and media. There are also some specialized starter kits, for example for creating a blog. Umbraco HQ has released their [own starter kit](https://www.nuget.org/packages/Umbraco.TheStarterKit), which creates a small site with the most commonly used features.
40
40
41
41
#### Content Apps
42
42
@@ -46,10 +46,6 @@ Content apps are almost like dashboards for content nodes that are intended to d
46
46
47
47
This type of package can be a lot of things, and can include a number of the other package types. They are generally integrating a larger system into Umbraco. A good example could be an e-commerce package such as [Umbraco Commerce](https://docs.umbraco.com/umbraco-commerce), that includes an entire webshop module for Umbraco.
48
48
49
-
## [Types of Packages](types-of-packages.md)
50
-
51
-
Packages for Umbraco 10 and above are installed as NuGet packages.
52
-
53
49
## [Creating a Package](creating-a-package.md)
54
50
55
51
This short tutorial will teach you how to create a package in the Umbraco backoffice. It will also give a quick overview of what a generated package will contain.
0 commit comments