v17

README.md

@@ -4,6 +4,8 @@
 **uTPro** is a powerful **Starter Kit Template** built to **accelerate website development on the Umbraco platform**.  
 It enables developers to create **enterprise‑grade websites** faster, more reliably, and with a professional structure from day one.  
 
+<img width="1200" height="297" alt="image" src="https://github.com/user-attachments/assets/41cd2a67-8bc1-40ca-a689-3db1bcee1b24" />
+
 ---
 
 ## 🔑 Core Principles

docs/1.-Intro.md

@@ -0,0 +1,54 @@
+#  <img width="50" height="50" alt="Logo" src="https://github.com/user-attachments/assets/09bd91e7-76d6-4223-8ffe-60b3c9cde3b0" /> uTPro – Umbraco Turbo Pro
+## For developers, by developers  
+
+**uTPro** is a powerful **Starter Kit Template** built to **accelerate website development on the Umbraco platform**.  
+It enables developers to create **enterprise‑grade websites** faster, more reliably, and with a professional structure from day one.  
+
+---
+
+## 🔑 Core Principles
+
+- **Umbraco Turbo Pro**  
+  Speed up Umbraco development with a streamlined, production‑ready foundation that ensures stability and scalability.  
+
+- **Universal Template Project**  
+  A flexible, ready‑to‑use structure that adapts to multiple use cases: enterprise websites, product showcases, landing pages, and more.  
+
+- **Ultimate Tech Productivity**  
+  Reduce repetitive setup tasks, maximize efficiency, and let developers focus on delivering real value instead of boilerplate work.  
+
+---
+
+## 🚀 Why uTPro?
+
+- **Fast to start** – Launch projects in minutes with a clean, optimized base.  
+- **Flexible** – Easily customize to fit unique business or creative needs.  
+- **Scalable** – Built to support both small projects and enterprise‑level solutions.  
+- **Free & Open Source** – 100% customizable, extendable, and community‑driven.  
+
+---
+
+## 🌐 Perfect for
+
+- Corporate websites and enterprise portals  
+- Product landing pages and marketing campaigns  
+- Developer teams who want a consistent, professional starting point  
+- Agencies looking to deliver faster without sacrificing quality  
+
+---
+
+## ⚙️ Pre‑installed Utilities
+
+uTPro comes with a curated set of utilities and best practices already integrated, so you can start building immediately:
+
+- **Pre‑configured build scripts** (minification, bundling, cache‑busting).  
+- **SEO‑friendly meta setup** and Open Graph defaults.  
+- **Accessibility helpers** to ensure inclusive design.
+- **Performance optimizations** (lazy loading, async scripts, caching hints).
+- **Sample components** (navigation, footer, hero section) ready to customize.
+
+**With the support of extensions:** [Smidge](https://github.com/Shazwazza/Smidge), [UmbracoSeoVisualizer](https://marketplace.umbraco.com/package/umbracoseovisualizer), [Umbraco.Community.BlockPreview](https://marketplace.umbraco.com/package/umbraco.community.blockpreview), [uSync](https://marketplace.umbraco.com/package/usync), [WebMarkupMin.AspNetCoreLatest](https://www.nuget.org/packages/WebMarkupMin.AspNetCoreLatest/), [LigerShark.WebOptimizer.Core](https://www.nuget.org/packages/LigerShark.WebOptimizer.Core)...
+
+---
+
+uTPro is **completely free and open source**, giving developers the freedom to **customize, extend, and innovate without limits**.  

docs/2.-Setup.md

@@ -0,0 +1,40 @@
+# 2.1 Setup Domain
+In addition to the configurations used for Umbraco, we also provide other configurations for backoffice and language customization:
+
+<img width="322" height="90" alt="image" src="https://github.com/user-attachments/assets/e9317805-d459-424c-a3d0-2a7b0e32b4a7" />
+
+If you want to use multi site or configure separate backoffice, please update the **hosts file** according to each operating system.
+
+* For Windows: C:\Windows\System32\Drivers\etc\hosts)
+* For MacOS and Linux: /etc/hosts
+
+<img width="606" height="488" alt="image" src="https://github.com/user-attachments/assets/fb6a735d-f1bd-4657-a473-bb2702dc5781" />
+
+---
+# 2.2 Setup Project
+Setting up uTPro is simple. Once you have downloaded the source code, you can open the project solution file in Visual Studio. We recommend using Visual Studio 2022 (or later).
+
+<img width="260" height="138" alt="image" src="https://github.com/user-attachments/assets/a3075e3f-7ddd-4dba-a891-924ea3cab723" />
+
+Then follow the minimum requirements of the Umbraco CMS project:
+
+* Database: SQL Server (Please change the ConnectionString in the appsettings.json with key: **umbracoDbDSN** => create an **empty database** on SQL Server. Then use the database name you created and edit it in **appsettings**.
+
+<img width="177" height="80" alt="image" src="https://github.com/user-attachments/assets/e11e9a72-fd0d-4206-a287-602c5b7a4701" />).
+
+<img width="954" height="124" alt="image" src="https://github.com/user-attachments/assets/8b9a772a-5d6c-492b-a3c0-1aaadfdd2585" />
+
+* Target framework: .NET 9 (Changes depending on the Umbraco version in use)
+
+<img width="847" height="307" alt="image" src="https://github.com/user-attachments/assets/ffd40c2a-a951-4910-8350-3c91ee1450db" />
+
+---
+# 2.3 Setup Data
+The project has been integrated with data, and you can use **uSync to synchronize data** after installing Umbraco CMS.
+
+<img width="800" alt="image" src="https://github.com/user-attachments/assets/288360f8-c34f-42c9-8098-3d9436c03e7f" />
+
+In the "Everything" group, select "Import" and wait for the results, then refresh the page, return to the "Content" tab to check the results.
+
+<img width="502" height="269" alt="image" src="https://github.com/user-attachments/assets/b0e66bf7-e4ea-4f5f-be43-e3259c37939b" />
+

docs/3.-Project-Structure.md

@@ -0,0 +1,12 @@
+uTPro is developed in modular fashion. In this section we will go into details of each module and inner workings of its structure.
+
+This is an empty Project structure with no specialized features created yet:
+
+<img width="249" height="301" alt="image" src="https://github.com/user-attachments/assets/df9f411a-639e-4c9f-ab61-83e872d5145f" />
+
+# 3.1 uTPro.Web
+# 3.2 uTPro.Configure
+# 3.3 uTPro.Common
+# 3.4 uTPro.Extension
+# 3.5 uTPro.Foundation
+# 3.6 uTPro.Feature (Optional)

docs/4.-Configurations.md

@@ -0,0 +1,19 @@
+In addition to the configurations used for Umbraco, we also provide other configurations for backoffice and language customization:
+
+# 4.1 Configuration Remember Language - Culture and Hostnames
+We do provide multilingual configuration by **cookie**. This defaults Umbraco to support multilingual only! You can find our **"Culture and Hostnames"** settings in the "Home" node (_**uTPro -> Sites -> Home**_)
+
+<img width="922" height="554" alt="image" src="https://github.com/user-attachments/assets/ee51eba4-9738-493e-ba79-4d33a150fb60" />
+
+**IMPORTANT:** Make sure that the default language (first access user has no cookie and url has no language set) is set to END "/" by default and set it to the last position (In the picture we are using Vietnamese as the default language). Make sure each language has a hostname for Remember Language to work properly.
+
+You can disable this feature by setting **Enabled: "false"** for **RememberLanguage**:
+
+<img width="405" height="144" alt="image" src="https://github.com/user-attachments/assets/e41601ea-39bc-46cb-8c37-1c158c10adb3" />
+
+# 4.2 Configuration Backoffice and Website run separately
+You can separate Backoffice and Website into 2 separate domains, if you have enabled and configured the domain for Backoffice, try accessing the Website domain and "/umbraco" to see the result.
+
+<img width="308" height="96" alt="image" src="https://github.com/user-attachments/assets/a031509d-06aa-4458-964d-f46c6d075ef7" />
+
+

docs/_Footer.md

@@ -0,0 +1,8 @@
+---
+✍️ **Author**: Nguyễn Thiên Tứ  
+📬 **Contact**: [thientu@t4vn.com](mailto:thientu@t4vn.com)  
+📄 **Website**: [t4vn.com](https://t4vn.com)  
+📦 **Repository**: [github.com/T4VN/uTPro](https://github.com/T4VN/uTPro)    
+📍 **Location**: Ho Chi Minh City, VietNam  
+🕒 Timezone: GMT+7   
+✨ **SPECIAL**: We also offer a **LOW COST PREMIUM** version for those who want exclusive customization tailored to their personal style. Your support means a lot to us!

uTPro/Common/uTPro.Common/Models/CMS/File.generated.cs

@@ -2,7 +2,7 @@
 // <auto-generated>
 //   This code was generated by a tool.
 //
-//    Umbraco.ModelsBuilder.Embedded v16.4.1+3472ff9
+//    Umbraco.ModelsBuilder.Embedded v16.5.0+8b2c22a
 //
 //   Changes to this file will be lost if the code is regenerated.
 // </auto-generated>
@@ -24,15 +24,15 @@ public partial class File : PublishedContentModel
 	{
 		// helpers
 #pragma warning disable 0109 // new is redundant
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		public new const string ModelTypeAlias = "File";
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		public new const PublishedItemType ModelItemType = PublishedItemType.Media;
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		[return: global::System.Diagnostics.CodeAnalysis.MaybeNull]
 		public new static IPublishedContentType GetModelContentType(IPublishedContentTypeCache contentTypeCache)
 			=> PublishedModelUtility.GetModelContentType(contentTypeCache, ModelItemType, ModelTypeAlias);
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		[return: global::System.Diagnostics.CodeAnalysis.MaybeNull]
 		public static IPublishedPropertyType GetModelPropertyType<TValue>(IPublishedContentTypeCache contentTypeCache, Expression<Func<File, TValue>> selector)
 			=> PublishedModelUtility.GetModelPropertyType(GetModelContentType(contentTypeCache), selector);
@@ -52,22 +52,22 @@ public File(IPublishedContent content, IPublishedValueFallback publishedValueFal
 		///<summary>
 		/// File size
 		///</summary>
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		[ImplementPropertyType("umbracoBytes")]
 		public virtual long UmbracoBytes => this.Value<long>(_publishedValueFallback, "umbracoBytes");
 
 		///<summary>
 		/// File extension
 		///</summary>
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		[global::System.Diagnostics.CodeAnalysis.MaybeNull]
 		[ImplementPropertyType("umbracoExtension")]
 		public virtual string UmbracoExtension => this.Value<string>(_publishedValueFallback, "umbracoExtension");
 
 		///<summary>
 		/// File
 		///</summary>
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		[global::System.Diagnostics.CodeAnalysis.MaybeNull]
 		[ImplementPropertyType("umbracoFile")]
 		public virtual string UmbracoFile => this.Value<string>(_publishedValueFallback, "umbracoFile");

uTPro/Common/uTPro.Common/Models/CMS/Folder.generated.cs

@@ -2,7 +2,7 @@
 // <auto-generated>
 //   This code was generated by a tool.
 //
-//    Umbraco.ModelsBuilder.Embedded v16.4.1+3472ff9
+//    Umbraco.ModelsBuilder.Embedded v16.5.0+8b2c22a
 //
 //   Changes to this file will be lost if the code is regenerated.
 // </auto-generated>
@@ -24,15 +24,15 @@ public partial class Folder : PublishedContentModel
 	{
 		// helpers
 #pragma warning disable 0109 // new is redundant
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		public new const string ModelTypeAlias = "Folder";
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		public new const PublishedItemType ModelItemType = PublishedItemType.Media;
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		[return: global::System.Diagnostics.CodeAnalysis.MaybeNull]
 		public new static IPublishedContentType GetModelContentType(IPublishedContentTypeCache contentTypeCache)
 			=> PublishedModelUtility.GetModelContentType(contentTypeCache, ModelItemType, ModelTypeAlias);
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		[return: global::System.Diagnostics.CodeAnalysis.MaybeNull]
 		public static IPublishedPropertyType GetModelPropertyType<TValue>(IPublishedContentTypeCache contentTypeCache, Expression<Func<Folder, TValue>> selector)
 			=> PublishedModelUtility.GetModelPropertyType(GetModelContentType(contentTypeCache), selector);

uTPro/Common/uTPro.Common/Models/CMS/GlobalFolderArchives.generated.cs

@@ -2,7 +2,7 @@
 // <auto-generated>
 //   This code was generated by a tool.
 //
-//    Umbraco.ModelsBuilder.Embedded v16.4.1+3472ff9
+//    Umbraco.ModelsBuilder.Embedded v16.5.0+8b2c22a
 //
 //   Changes to this file will be lost if the code is regenerated.
 // </auto-generated>
@@ -24,15 +24,15 @@ public partial class GlobalFolderArchives : PublishedContentModel
 	{
 		// helpers
 #pragma warning disable 0109 // new is redundant
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		public new const string ModelTypeAlias = "globalFolderArchives";
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		public new const PublishedItemType ModelItemType = PublishedItemType.Content;
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		[return: global::System.Diagnostics.CodeAnalysis.MaybeNull]
 		public new static IPublishedContentType GetModelContentType(IPublishedContentTypeCache contentTypeCache)
 			=> PublishedModelUtility.GetModelContentType(contentTypeCache, ModelItemType, ModelTypeAlias);
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		[return: global::System.Diagnostics.CodeAnalysis.MaybeNull]
 		public static IPublishedPropertyType GetModelPropertyType<TValue>(IPublishedContentTypeCache contentTypeCache, Expression<Func<GlobalFolderArchives, TValue>> selector)
 			=> PublishedModelUtility.GetModelPropertyType(GetModelContentType(contentTypeCache), selector);

uTPro/Common/uTPro.Common/Models/CMS/GlobalFolderNavigationLinkForSite.generated.cs

@@ -2,7 +2,7 @@
 // <auto-generated>
 //   This code was generated by a tool.
 //
-//    Umbraco.ModelsBuilder.Embedded v16.4.1+3472ff9
+//    Umbraco.ModelsBuilder.Embedded v16.5.0+8b2c22a
 //
 //   Changes to this file will be lost if the code is regenerated.
 // </auto-generated>
@@ -24,15 +24,15 @@ public partial class GlobalFolderNavigationLinkForSite : PublishedContentModel
 	{
 		// helpers
 #pragma warning disable 0109 // new is redundant
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		public new const string ModelTypeAlias = "globalFolderNavigationLinkForSite";
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		public new const PublishedItemType ModelItemType = PublishedItemType.Content;
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		[return: global::System.Diagnostics.CodeAnalysis.MaybeNull]
 		public new static IPublishedContentType GetModelContentType(IPublishedContentTypeCache contentTypeCache)
 			=> PublishedModelUtility.GetModelContentType(contentTypeCache, ModelItemType, ModelTypeAlias);
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		[return: global::System.Diagnostics.CodeAnalysis.MaybeNull]
 		public static IPublishedPropertyType GetModelPropertyType<TValue>(IPublishedContentTypeCache contentTypeCache, Expression<Func<GlobalFolderNavigationLinkForSite, TValue>> selector)
 			=> PublishedModelUtility.GetModelPropertyType(GetModelContentType(contentTypeCache), selector);
@@ -52,7 +52,7 @@ public GlobalFolderNavigationLinkForSite(IPublishedContent content, IPublishedVa
 		///<summary>
 		/// Items
 		///</summary>
-		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.4.1+3472ff9")]
+		[global::System.CodeDom.Compiler.GeneratedCodeAttribute("Umbraco.ModelsBuilder.Embedded", "16.5.0+8b2c22a")]
 		[global::System.Diagnostics.CodeAnalysis.MaybeNull]
 		[ImplementPropertyType("navigationItems")]
 		public virtual global::Umbraco.Cms.Core.Models.Blocks.BlockListModel NavigationItems => this.Value<global::Umbraco.Cms.Core.Models.Blocks.BlockListModel>(_publishedValueFallback, "navigationItems");