Merge branch 'rel-9.2' into feature/#22507

Author: oykuermann

Directory.Packages.props

@@ -151,6 +151,17 @@ property =>
 
 > Tip: Use `DefaultValueFactory` option only if the default value may change over the time (like `DateTime.Now` in this example). If it is a constant value, then use the `DefaultValue` option.
 
+### DataTypeAttribute
+
+`DataTypeAttribute` is used to specify the type of the property. It is used to determine how to render the property on the user interface:
+
+```csharp
+property =>
+{
+    property.Attributes.Add(new DataTypeAttribute(DataType.Date));
+}
+```
+
 ### Validation
 
 Entity extension system allows you to define validation for extension properties in a few ways.

docs/en/framework/architecture/modularity/extending/module-entity-extensions.md

@@ -755,7 +755,17 @@ public static class QADbContextModelCreatingExtensions
 
 > The `Object Extension` feature need the `Change Tracking`, which means you can't use the read-only repositories for the entities that have `extension properties(MapEfCoreProperty)`, Please see the [Repositories documentation](../../architecture/domain-driven-design/repositories.md) to learn the change tracking behavior.
 
-See the "*ConfigureByConvention Method*" section above for more information.
+See the **ConfigureByConvention Method** section above for more information.
+
+### Accessing Extra Properties(Shadow Properties)
+
+Extra properties stored in separate fields in the database are known as **Shadow Properties**. These properties are not defined in the entity class, but are part of the EF Core model and can be referenced in LINQ queries using the EF.Property static method
+
+```csharp
+var query = (await GetQueryableAsync()).Where(x => EF.Property<string>(x, "Title") == "MyTitle");
+```
+
+See the [EF Core Shadow and Indexer Properties document](https://learn.microsoft.com/en-us/ef/core/modeling/shadow-properties) for more information.
 
 ## Advanced Topics
 

docs/en/framework/data/entity-framework-core/index.md

@@ -248,6 +248,17 @@ namespace MyProject
 
 The `L` property is also available for some other base classes like `AbpController` and `AbpPageModel`.
 
+## Supported Languages
+
+You can configure the `AbpLocalizationOptions`'s `Languages` property to add the languages supported by the application. The template already sets common languages, but you can add new languages as shown below:
+
+```csharp
+Configure<AbpLocalizationOptions>(options =>
+{
+    options.Languages.Add(new LanguageInfo("uz", "uz", "Uzbek"));
+});
+```
+
 ## The Client Side
 
 See the following documents to learn how to reuse the same localization texts in the JavaScript side;

docs/en/framework/fundamentals/localization.md

@@ -37,10 +37,15 @@ Open a command line terminal and run the `adb reverse` command to expose a port
 
 `adb reverse tcp:44305 tcp:44305`
 
-> You should replace "44305" with the real port.
-> You should run the command after starting the emulator.
+> Replace `44305` with the port number your backend application is running on.
+>
+> Run this command **after** the Android emulator has started.
 
-> If you don't have a separate installation of Android Debug Bridge, you can open it from **Visual Studio** by following toolbar menu `Tools` > `Android` > `Android Adb Command Prompt`. Android emulator has to be running for this operation.
+> [!IMPORTANT]
+> If your project uses a **tiered** or **microservice** architecture, ensure that both the **auth server** and all **remote service ports** are properly proxied using the `adb reverse` command. You can find all the required remote service ports and AuthServer configurations in your `YourProjectName.Maui/appsettings.json` file.
+
+> [!NOTE]
+> If you don't have a separate installation of **Android Debug Bridge** _(adb)_, you can open it from **Visual Studio** by following toolbar menu `Tools` > `Android` > `Android Adb Command Prompt`. Android emulator has to be running for this operation.
 
 
 ### iOS

docs/en/framework/ui/maui/index.md

@@ -89,7 +89,10 @@ This example overrides the **login page** defined by the [Account Module](../../
 
 Create a page model class deriving from the ` LoginModel ` (defined in the ` Volo.Abp.Account.Web.Pages.Account ` namespace):
 
+> If you are using the `AbpAccountWebOpenIddictModule` or `AbpAccountPublicWebOpenIddictModule`, the base class is `OpenIddictSupportedLoginModel` instead of `LoginModel`. And you should change the `ExposeServices` attribute to `[ExposeServices(typeof (MyLoginModel), typeof(OpenIddictSupportedLoginModel), typeof(LoginModel))]`
+
 ````csharp
+[ExposeServices(typeof (MyLoginModel), typeof(LoginModel))]
 public class MyLoginModel : LoginModel
 {
     public MyLoginModel(
@@ -114,8 +117,6 @@ public class MyLoginModel : LoginModel
 
 You can override any method or add new properties/methods if needed.
 
-> Notice that we didn't use `[Dependency(ReplaceServices = true)]` or `[ExposeServices(typeof(LoginModel))]` since we don't want to replace the existing class in the dependency injection, we define a new one.
-
 Copy `Login.cshtml` file into your solution as just described above. Change the **@model** directive to point to the `MyLoginModel`:
 
 ````xml

docs/en/framework/ui/mvc-razor-pages/customization-user-interface.md

@@ -37,6 +37,20 @@ You can create new forwardings or update/delete existing ones, in the admin side
 
 ![url-forwarding-page](../../images/url-forwarding-page.png)
 
+
+## Options
+
+### ShortenedUrlCacheOptions
+
+`ShortenedUrlCacheOptions` is used to configure the cache settings for the URL forwarding system. Example:
+
+```csharp
+Configure<ShortenedUrlCacheOptions>(options =>
+{
+    options.CacheAllOnStartup = true; // Cache all shortened URLs on startup
+});
+```
+
 # Internals
 
 ## Domain Layer

docs/en/modules/cms-kit-pro/url-forwarding.md

@@ -62,7 +62,7 @@ This module adds some initial data (see [the data seed system](../framework/infr
 
 * Creates language records configured using `AbpLocalizationOptions`.
 
-If you want to change the seeded language list, see the next section.
+If you want to change the seeded language list, see the [Localization](../framework/fundamentals/localization.md#Supported-Languages) document.
 
 ## Internals
 

docs/en/modules/language-management.md

@@ -28,6 +28,7 @@ With this version on, ABP Framework allows you to use single blog mode, without
 * `Volo.Blogging.Pages.Members` -> `Volo.Blogging.Pages.Blogs.Members` (members folder)
 
 > If you haven't overridden the pages above, then you don't need to make any additional changes. See [#19418](https://github.com/abpframework/abp/pull/19418) for more information.
+
 ## Removed `FlagIcon` property from the `ILanguageInfo`
 
 The `FlagIcon` property has been removed from the `ILanguageInfo` interface since we removed the flag icon library in the earlier versions from all of our themes and none of them using it now.
@@ -57,11 +58,20 @@ In this version, the Angular UI has been updated to use the Angular version 17.3
 
 The **Session Management** feature allows you to prevent concurrent login and manage user sessions.
 
-In this version, a new entity called `IdentitySession` has been added to the framework and you should create a new migration and apply it to your database.
+In this version, a new entity called `IdentitySession` has been added to the framework and you need to add new `DbSet<IdentitySession>` to your `DbContext` class if it implements `IIdentityDbContext` interface.
+
+```csharp
+public class YourDbContext : AbpDbContext<YourDbContext>, IIdentityDbContext
+{
+    public DbSet<IdentitySession> Sessions { get; set; }
+}
+```
+
+You should also create a new migration and apply it to your database.
 
 ## Upgraded NuGet Dependencies
 
-You can see the following list of NuGet libraries that have been upgraded with this release, if you are using one of these packages explicitly, you may consider upgrading them in your solution:
+You can see the following list of NuGet libraries that have been upgraded with this release, **if you are using one of these packages explicitly**, you may consider upgrading them in your solution, especially **Microsoft.IdentityModel.*** packages:
 
 | Package                                                    | Old Version | New Version |
 | ---------------------------------------------------------- | ----------- | ----------- |

docs/en/release-info/migration-guides/abp-8-2.md

@@ -107,9 +107,9 @@ public class ProductIntegrationService : ApplicationService, IProductIntegration
 
 Now that we have created the `IProductIntegrationService` interface and the `ProductIntegrationService` class, we can consume this service from the Ordering service.
 
-### Adding a Reference to the `CloudCrm.CatalogService.Contracts` Package
+### Adding a Reference to the `CloudCrm.OrderingService` Package
 
-First, we need to add a reference to the `CloudCrm.CatalogService.Contracts` package in the Ordering service. Open the ABP Studio, and stop the application(s) if it is running. Then, open the *Solution Explorer* and right-click on the `CloudCrm.OrderingService` package. Select *Add* -> *Package Reference* command:
+First, we need to add a reference to the `CloudCrm.OrderingService` package in the Ordering service. Open the ABP Studio, and stop the application(s) if it is running. Then, open the *Solution Explorer* and right-click on the `CloudCrm.OrderingService` package. Select *Add* -> *Package Reference* command:
 
 ![add-package-reference-ordering-service](images/add-package-reference-ordering-service.png)