diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
new file mode 100644
index 0000000000..247193db89
--- /dev/null
+++ b/CODE_OF_CONDUCT.md
@@ -0,0 +1,94 @@
+# Contributor Covenant Code of Conduct
+
+## Preamble
+
+The ABP Framework was created to implement common generic web application features in a common code base. This approach helps developers to decouple line of business application features from their custom business logic. Besides, the ABP Framework helps create MVPs and kick-start your project as quickly as possible. All the contributors try to save valuable time by automating repetitive tasks at the framework level. This code of conduct has been adopted by many [other open source communities](http://contributor-covenant.org/adopters/) and we feel it expresses our values well.
+
+
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation. We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.
+
+
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our community include:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes, and learning from the experience
+- Focusing on what is best not just for us as individuals but for the overall community
+
+Examples of unacceptable behavior include:
+
+- The use of sexualized language or imagery, and sexual attention or advances of any kind
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others’ private information, such as a physical or email address, without their explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned with this Code of Conduct and will communicate reasons for moderation decisions when appropriate.
+
+
+
+## Scope
+
+This Code of Conduct applies within all community spaces and when an individual officially represents the community in public spaces. Examples of representing our community include:
+
+- Using an official e-mail address.
+- Posting via an official social media account.
+- Acting as an appointed representative at an online or offline event.
+
+
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at [info@abp.io](mailto:info@abp.io). All complaints will be reviewed and investigated promptly and fairly. All community leaders must to respect the privacy and security of the reporter of any incident.
+
+
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact:** Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community.
+
+**Consequence:** A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact:** A violation through a single incident or series of actions.
+
+**Consequence:** A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period. This includes avoiding interactions in community spaces and external channels like social media. Violating these terms may lead to a temporary or permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact:** A serious violation of community standards, including sustained inappropriate behavior.
+
+**Consequence:** A temporary ban from any interaction or public communication with the community for a specified period. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact:** Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior, harassment of an individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence:** A permanent ban from any sort of public interaction within the community.
+
+
+
+## Attribution
+
+This document is adapted from the [Contributor Covenant](https://www.contributor-covenant.org/), version 2.0, available at https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+Community Impact Guidelines were inspired by [Mozilla’s code of conduct enforcement ladder](https://github.com/mozilla/diversity).
+For answers to common questions about this code of conduct, see the FAQ at https://www.contributor-covenant.org/faq.
+Translations are available at https://www.contributor-covenant.org/translations.
diff --git a/README.md b/README.md
index b588e0cba4..f1f941f794 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,8 @@
[](https://www.nuget.org/packages/Volo.Abp.Core)
[](https://docs.abp.io/en/abp/latest/Nightly-Builds)
[](https://www.nuget.org/packages/Volo.Abp.Core)
-
+[](https://github.com/abpframework/abp/blob/dev/CODE_OF_CONDUCT.md)
+[](https://cla-assistant.io/abpframework/abp)
[](https://discord.gg/abp)
ABP Framework is a complete **infrastructure** based on **ASP.NET Core** to create **modern web applications** and **APIs** by following the software development **best practices** and the **latest technologies**. Check out https://abp.io
diff --git a/abp_io/AbpIoLocalization/AbpIoLocalization/Admin/Localization/Resources/en.json b/abp_io/AbpIoLocalization/AbpIoLocalization/Admin/Localization/Resources/en.json
index 4543ac1509..acfe23fd00 100644
--- a/abp_io/AbpIoLocalization/AbpIoLocalization/Admin/Localization/Resources/en.json
+++ b/abp_io/AbpIoLocalization/AbpIoLocalization/Admin/Localization/Resources/en.json
@@ -460,6 +460,7 @@
"ReloadFromSourceConfirmationMessage": "This post will be refreshed from \"{0}\". Do you want to continue?",
"UnitPrice": "Unit Price",
"OverallDiscountAmount": "Overall Discount Amount",
- "DiscountAmount": "Discount Amount"
+ "DiscountAmount": "Discount Amount",
+ "FullChangeHistory": "Full Change History"
}
}
diff --git a/abp_io/AbpIoLocalization/AbpIoLocalization/Base/Localization/Resources/en.json b/abp_io/AbpIoLocalization/AbpIoLocalization/Base/Localization/Resources/en.json
index b363220bb4..d228bed40c 100644
--- a/abp_io/AbpIoLocalization/AbpIoLocalization/Base/Localization/Resources/en.json
+++ b/abp_io/AbpIoLocalization/AbpIoLocalization/Base/Localization/Resources/en.json
@@ -70,7 +70,7 @@
"MeetTheABP": "Meet the ABP",
"CompleteWebDevelopment": "A Complete Web Development",
"Platform": "Platform",
- "ABPDescription": "ABP Framework is a complete infrastructure to create modern web applications by following the software development best practices and conventions.",
+ "ABPDescription": "An open-source framework for web application development for ASP.NET Core. It offers complete infrastructure by following the best practices of software development.",
"StrongInfrastructure": "Strong Infrastructure",
"CompleteArchitecture": "Complete Architecture",
"DeveloperFocused": "Developer Focused",
diff --git a/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/en.json b/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/en.json
index c6521a6c56..bddb51b98b 100644
--- a/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/en.json
+++ b/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/en.json
@@ -161,7 +161,7 @@
"WhatIsTheABPCommercial": "What is ABP Commercial?",
"WhatAreDifferencesThanAbpFramework": "What are the differences between the open source ABP Framework and ABP Commercial?",
"AbpCommercialMetaTitle": " {0} | ABP Commercial",
- "AbpCommercialMetaDescription": "ABP Commercial is a set of pre-built application modules, rapid development tooling, UI themes and services built on top of the open-source ABP framework.",
+ "AbpCommercialMetaDescription": "A comprehensive web development platform on ABP Framework with pre-built modules, startup templates, rapid dev tools, pro UI themes & premium support.",
"ABPCommercialExplanation": "ABP Commercial is a set of premium modules, tools, themes and services that are built on top of the open source ABP framework. ABP Commercial is being developed and supported by the same team behind the ABP framework.",
"WhatAreDifferencesThanABPFrameworkExplanation": "
ABP framework is a modular, themeable, microservice compatible application development framework for ASP.NET Core. It provides a complete architecture and a strong infrastructure to let you focus on your own business code rather than repeating yourself for every new project. It is based on the best practices of software development and popular tools you already know.
ABP framework is completely free, open source and community-driven. It also provides a free theme and some pre-built modules (e.g. identity management and tenant management).
",
"VisitTheFrameworkVSCommercialDocument": "Visit the following link for more information {1} ",
@@ -539,6 +539,8 @@
"Pricing_Page_Testimonial_5": "ABP Framework is not only a framework, but it is also a guide for project development/management, because it provides DDD, GenericRepository, DI, Microservice, and Modularity training. Even if you are not going to use the framework itself, you can develop yourself with docs.abp.io which is well and professionally prepared (OpenIddict, Redis, Quartz etc.). Because many things are pre-built, it shortens project development time significantly (Such as login page, exception handling, data filtering, seeding, audit logging, localization, auto API controller etc.). As an example from our application, I have used Local Event Bus for stock control. So, I am able to manage order movements by writing stock handler. It is wonderful not to lose time for CreationTime, CreatorId. They are being filled automatically.",
"Pricing_Page_Testimonial_6": "ABP Framework is a good framework but it needs time to understand the different layers, classes, and libraries it used (specially ABP). I spent a lot of time reading the code base, but ABP Commercial save us time to create the project specialty entities (AR) and the repository linked to each of them. I liked also the approach used in ABP is very mature, we know is based on DDD and monolith.",
"Pricing_Page_Testimonial_7": "As a startup we need to iterate quickly and spend minimal time on boilerplate and non-core features.\nOur engineers range from highly experienced to junior engineers, we needed a common understanding and a way to share technical and domain knowledge, ABP allowed us to do this due to their great guides and documentation. \nThere are things we haven't had to worry about since they work out of the box with ABP. \nABP helped us streamline rapid prototyping and development, less than 4 weeks from feature inception to production. With all its premium features included in the license, ABP has given us, \"Startup in a Box\" on the Software Engineering Side.",
+ "Pricing_Page_Testimonial_8": "I would recommend ABP commercial to all those who want to expand the range of products available to their customers. It's fantastic when need to use a distributed enterprise enviroment (Angualr, WPF, Win&Linux). In addition to their products, we love their support, which makes our job faster and easier. We already know that we have found a great partner for the future who will support us in expanding our business.",
+ "Pricing_Page_Testimonial_9": "We are a company of 2 employees that's been in business for over 20 years.\nIn terms of our experience with ABP Commercial, we were approached by a client who requested that we develop a new human resources application in a modern environment to replace their 25-year-old Access application. We decided to transition from a desktop solution to a web-based one.\n\nAt the time, we had very little knowledge of web applications and .NET but we stumbled upon ABP Commercial, and with the help of ABP Framework, technical documentation, and ABP Suite, we were able to not only develop the application to the client's specifications but also successfully work within a .NET environment within a year.",
"AbpBookDownloadArea_ClaimYourEBook": "Claim your Mastering ABP Framework E-Book",
"AddMemberModal_Warning_1": "If the username you are trying to add doesn't exist in the system, please ask your team member to register on {0} and share the username of his/her account with you.",
"MyOrganizations_Detail_WelcomeMessage": "Welcome to your organization, {0}",
@@ -832,6 +834,14 @@
"Volo.AbpIo.Commercial:040001": "API Access Key is incorrect.",
"GetLepton": "Get Lepton Now",
"MyOrganizations_Detail_LicenseStartDate": "License Start Date",
- "MyOrganizations_Detail_LicenseExpiryDate": "Expiry Date"
+ "MyOrganizations_Detail_LicenseExpiryDate": "Expiry Date",
+ "BlazoriseSupport": "How do I get the Blazorise license key and support from the Blazorise team?",
+ "BlazoriseSupportExplanation": "Follow the steps below to get support from the Blazorise team and get your Blazorise license key:",
+ "BlazoriseSupportExplanation1": "Sign up for a new account at blazorise.com/support/register with the same email address as your abp.io account. Leave the \"License Key\" entry blank. It must be the same email address as your email account on abp.io.",
+ "BlazoriseSupportExplanation2": "Verify your email address by checking your email box. Check your spam box if you don't see an email in your inbox!",
+ "BlazoriseSupportExplanation3": "Log into the Blazorise support website at blazorise.com/support/login.",
+ "BlazoriseSupportExplanation4": "If you have an active ABP Commercial license, you will also have a Blazorise PRO license. You can get your Blazorise license key at blazorise.com/support/user/manage/license.",
+ "BlazoriseSupportExplanation5": "You can post your questions on the support website and generate a product token for your application.",
+ "AbpLiveTrainingPackages": "ABP Live Training Packages"
}
}
diff --git a/abp_io/AbpIoLocalization/AbpIoLocalization/Community/Localization/Resources/en.json b/abp_io/AbpIoLocalization/AbpIoLocalization/Community/Localization/Resources/en.json
index 5fa2120cce..e6b3cf46f7 100644
--- a/abp_io/AbpIoLocalization/AbpIoLocalization/Community/Localization/Resources/en.json
+++ b/abp_io/AbpIoLocalization/AbpIoLocalization/Community/Localization/Resources/en.json
@@ -181,13 +181,14 @@
"Post_Create_Page_CreateNewPost": "Create New Post",
"Post_Index_Page_MetaDescription": "ABP Community's purpose is to create a contribution environment for developers who use the ABP framework.",
"Layout_Title": "{0} | ABP Community",
- "Layout_MetaDescription": "ABP Community is an environment where people can share posts about ABP framework and follows the projects.",
+ "Layout_MetaDescription": "A hub for ABP Framework, .NET, and software development. Access articles, tutorials, news, and contribute to the ABP community.",
"Index_Page_CommunityIntroduction": "This is a hub for ABP Framework, .NET and software development. You can read the articles, watch the video tutorials, get informed about ABP’s development progress and ABP-related events, help other developers and share your expertise with the ABP community.",
"TagsInArticle": "Tags in article",
"IConsentToMedium": "I consent to the publication of this post at https://medium.com/volosoft.",
"SearchResultsFor": "Search results for \"{0}\"",
"SeeMoreVideos": "See more videos",
"DiscordPageTitle": "ABP Discord Community",
- "ViewVideo": "View Video"
+ "ViewVideo": "View Video",
+ "AbpCommunityTitleContent": "ABP Community - Open Source ABP Framework"
}
}
diff --git a/abp_io/AbpIoLocalization/AbpIoLocalization/Www/Localization/Resources/en.json b/abp_io/AbpIoLocalization/AbpIoLocalization/Www/Localization/Resources/en.json
index 16ce5acab0..3351b7d8cf 100644
--- a/abp_io/AbpIoLocalization/AbpIoLocalization/Www/Localization/Resources/en.json
+++ b/abp_io/AbpIoLocalization/AbpIoLocalization/Www/Localization/Resources/en.json
@@ -420,14 +420,16 @@
"CreateSolutionFolder": "Create Solution Folder",
"CreateSolutionFolderOption": "Specifies if the project will be in a new folder in the output folder or directly the output folder.",
"BooksPageTitle": "ABP Books",
- "PackageDetailPage_NuGetPackageInstallationOptions": "There are two ways to install {0} NuGet package to your project",
+ "PackageDetailPage_NuGetPackageInstallationOptions": "There are three ways to install {0} NuGet package to your project",
"PackageDetailPage_InstallingWithABPCLI": "1: Installing with the ABP CLI",
"PackageDetailPage_InstallingWithABPCLIDescription1": "If you haven't installed the ABP CLI, first install by executing the following command in a command-line terminal",
"PackageDetailPage_InstallingWithABPCLIDescription2": "Once you have installed the ABP CLI, open a command-line terminal in the location of the project (.csproj file) you want to install it and execute the following command",
"PackageDetailPage_InstallingWithABPCLIDescription3": "It will add the {0} package reference to your project and the {1} dependency to your module class.",
- "PackageDetailPage_ManualInstallation": "2: Manual Installation",
- "PackageDetailPage_ManualInstallationDesription1": "Add {0} NuGet package reference to your project using your IDE or executing the following command",
- "PackageDetailPage_ManualInstallationDesription2": "Then add the {0} dependency to your module class as shown in the following example",
- "PackageDetailPage_SeeDocumentation": "See the documentation to learn how to use this package in your applications."
+ "PackageDetailPage_ManualInstallation": "2: Installing with the Dotnet CLI",
+ "PackageDetailPage_ManualInstallationDescription1": "Add {0} NuGet package reference to your project using your IDE or executing the following command",
+ "PackageDetailPage_ManualInstallationDescription2": "Then add the {0} dependency to your module class as shown in the following example",
+ "PackageDetailPage_SeeDocumentation": "See the documentation to learn how to use this package in your applications.",
+ "PackageDetailPage_InstallingUsingPMC": "3: Installing with the Package Manager Console",
+ "PackageDetailPage_InstallingUsingPMCDescription1": "Open the Package Manager Console in Visual Studio (Tools -> Nuget Package Manager -> Package Manager Console) and execute the following command"
}
}
diff --git a/configureawait.props b/configureawait.props
index 92f22f85fb..93d9dfa6a4 100644
--- a/configureawait.props
+++ b/configureawait.props
@@ -1,9 +1,9 @@
-
+ Allruntime; build; native; contentfiles; analyzers
-
\ No newline at end of file
+
diff --git a/docs/en/API/Auto-API-Controllers.md b/docs/en/API/Auto-API-Controllers.md
index e139c16d20..1644e2d28a 100644
--- a/docs/en/API/Auto-API-Controllers.md
+++ b/docs/en/API/Auto-API-Controllers.md
@@ -169,3 +169,48 @@ public class PersonAppService : ApplicationService
````
Disabled `IsMetadataEnabled` which hides this service from API explorer and it will not be discoverable. However, it still can be usable for the clients know the exact API path/route.
+
+## Replace or Remove Controllers.
+
+In addition to [Overriding a Controller](../Customizing-Application-Modules-Overriding-Services.md#example-overriding-a-controller), you can also use a completely independent **Controller** to replace the controller in the framework or module.
+
+They have the same [route](https://learn.microsoft.com/en-us/aspnet/core/mvc/controllers/routing?view=aspnetcore-7.0), but can have **different** input and output parameters.
+
+### Replace built-in AbpApplicationConfigurationController
+
+The `ReplaceControllersAttribute` indicates the replaced controller type.
+
+````csharp
+[ReplaceControllers(typeof(AbpApplicationConfigurationController))]
+[Area("abp")]
+[RemoteService(Name = "abp")]
+public class ReplaceBuiltInController : AbpController
+{
+ [HttpGet("api/abp/application-configuration")]
+ public virtual Task GetAsync(MyApplicationConfigurationRequestOptions options)
+ {
+ return Task.FromResult(new MyApplicationConfigurationDto());
+ }
+}
+
+public class MyApplicationConfigurationRequestOptions : ApplicationConfigurationRequestOptions
+{
+
+}
+
+public class MyApplicationConfigurationDto : ApplicationConfigurationDto
+{
+
+}
+````
+
+### Remove contoller
+
+Configure `ControllersToRemove` of `AbpAspNetCoreMvcOptions` to remove the controllers.
+
+````csharp
+services.Configure(options =>
+{
+ options.ControllersToRemove.Add(typeof(AbpLanguagesController));
+});
+````
diff --git a/docs/en/API/Swagger-Integration.md b/docs/en/API/Swagger-Integration.md
index 56ee1de50e..40660eaab9 100644
--- a/docs/en/API/Swagger-Integration.md
+++ b/docs/en/API/Swagger-Integration.md
@@ -43,7 +43,7 @@ If you want to manually install;
## Configuration
-First, we need to use `AddAbpSwaggerGen` extension to configure Swagger in `ConfigureServices` method of our module.
+First, we need to use `AddAbpSwaggerGen` extension to configure Swagger in `ConfigureServices` method of our module:
```csharp
public override void ConfigureServices(ServiceConfigurationContext context)
@@ -63,21 +63,21 @@ public override void ConfigureServices(ServiceConfigurationContext context)
}
```
-Then we can use Swagger UI by calling `UseAbpSwaggerUI` method in the `OnApplicationInitialization` method of our module.
+Then we can use Swagger UI by calling `UseAbpSwaggerUI` method in the `OnApplicationInitialization` method of our module:
```csharp
public override void OnApplicationInitialization(ApplicationInitializationContext context)
{
var app = context.GetApplicationBuilder();
- //... other configarations.
+ //... other configurations.
app.UseAbpSwaggerUI(options =>
{
options.SwaggerEndpoint("/swagger/v1/swagger.json", "Test API");
});
- //... other configarations.
+ //... other configurations.
}
```
@@ -103,9 +103,7 @@ For non MVC/Tiered applications, we need to configure Swagger with OAUTH to hand
> ABP Framework uses OpenIddict by default. To get more information about OpenIddict, check this [documentation](../Modules/OpenIddict.md).
-
-
-To do that, we need to use `AddAbpSwaggerGenWithOAuth` extension to configure Swagger with OAuth issuer and scopes in `ConfigureServices` method of our module.
+To do that, we need to use `AddAbpSwaggerGenWithOAuth` extension to configure Swagger with OAuth issuer and scopes in `ConfigureServices` method of our module:
```csharp
public override void ConfigureServices(ServiceConfigurationContext context)
@@ -130,17 +128,14 @@ public override void ConfigureServices(ServiceConfigurationContext context)
}
```
-Then we can use Swagger UI by calling `UseAbpSwaggerUI` method in the `OnApplicationInitialization` method of our module.
-
-> Do not forget to set `OAuthClientId` and `OAuthClientSecret`.
-
+Then we can use Swagger UI by calling `UseAbpSwaggerUI` method in the `OnApplicationInitialization` method of our module:
```csharp
public override void OnApplicationInitialization(ApplicationInitializationContext context)
{
var app = context.GetApplicationBuilder();
- //... other configarations.
+ //... other configurations.
app.UseAbpSwaggerUI(options =>
{
@@ -151,6 +146,8 @@ public override void OnApplicationInitialization(ApplicationInitializationContex
options.OAuthClientSecret("1q2w3e*"); // clientSecret
});
- //... other configarations.
+ //... other configurations.
}
-```
\ No newline at end of file
+```
+
+> Do not forget to set `OAuthClientId` and `OAuthClientSecret`.
diff --git a/docs/en/Background-Jobs-Hangfire.md b/docs/en/Background-Jobs-Hangfire.md
index ca2067980e..1b04be560f 100644
--- a/docs/en/Background-Jobs-Hangfire.md
+++ b/docs/en/Background-Jobs-Hangfire.md
@@ -52,7 +52,7 @@ After you have installed these NuGet packages, you need to configure your projec
var configuration = context.Services.GetConfiguration();
var hostingEnvironment = context.Services.GetHostingEnvironment();
- //... other configarations.
+ //... other configurations.
ConfigureHangfire(context, configuration);
}
@@ -68,7 +68,7 @@ After you have installed these NuGet packages, you need to configure your projec
> You have to configure a storage for Hangfire.
-2. If you want to use hangfire's dashboard, you can add `UseHangfireDashboard` call in the `OnApplicationInitialization` method in `Module` class
+2. If you want to use hangfire's dashboard, you can add `UseHangfireDashboard` call in the `OnApplicationInitialization` method in `Module` class:
````csharp
public override void OnApplicationInitialization(ApplicationInitializationContext context)
@@ -84,7 +84,7 @@ After you have installed these NuGet packages, you need to configure your projec
### Specifying Queue
-You can use the [`QueueAttribute`](https://docs.hangfire.io/en/latest/background-processing/configuring-queues.html) to specify the queue.
+You can use the [`QueueAttribute`](https://docs.hangfire.io/en/latest/background-processing/configuring-queues.html) to specify the queue:
````csharp
using System.Threading.Tasks;
diff --git a/docs/en/CLI.md b/docs/en/CLI.md
index 22be84f72c..a65f29a324 100644
--- a/docs/en/CLI.md
+++ b/docs/en/CLI.md
@@ -48,6 +48,7 @@ Here, is the list of all available commands before explaining their details:
* **`logout`**: Logouts from your computer if you've authenticated before.
* **`bundle`**: Generates script and style references for ABP Blazor and MAUI Blazor project.
* **`install-libs`**: Install NPM Packages for MVC / Razor Pages and Blazor Server UI types.
+* **`clear-download-cache`** Clears the templates download cache.
### help
@@ -165,6 +166,7 @@ For more samples, go to [ABP CLI Create Solution Samples](CLI-New-Command-Sample
* `--local-framework-ref --abp-path`: Uses local projects references to the ABP framework instead of using the NuGet packages. This can be useful if you download the ABP Framework source code and have a local reference to the framework from your application.
* `--no-random-port`: Uses template's default ports.
* `--skip-installing-libs` or `-sib`: Skip installing client side packages.
+* `--skip-cache` or `-sc`: Always download the latest from our server and refresh their templates folder cache.
* `--with-public-website`: **Public Website** is a front-facing website for describing your project, listing your products and doing SEO for marketing purposes. Users can login and register on your website with this website.
See some [examples for the new command](CLI-New-Command-Samples.md) here.
@@ -362,8 +364,11 @@ abp generate-proxy -t csharp -url https://localhost:44302/
* `--api-name` or `-a`: The name of the API endpoint defined in the `/src/environments/environment.ts`. Default value: `default`.
* `--source` or `-s`: Specifies the Angular project name to resolve the root namespace & API definition URL from. Default value: `defaultProject`.
* `--target`: Specifies the Angular project name to place generated code in. Default value: `defaultProject`.
+ * `--module`: Backend module name. Default value: `app`.
+ * `--entry-point`: Targets the Angular project to place the generated code.
* `--url`: Specifies api definition url. Default value is API Name's url in environment file.
* `--prompt` or `-p`: Asks the options from the command line prompt (for the unspecified options).
+
* `js`: JavaScript. work in the `*.Web` project directory. There are some additional options for this client:
* `--output` or `-o`: JavaScript file path or folder to place generated code in.
* `--module` or `-m`: Specifies the name of the backend module you wish to generate proxies for. Default value: `app`.
diff --git a/docs/en/Community-Articles/2022-11-14-How-to-add-a-custom-grant-type-in-OpenIddict/POST.md b/docs/en/Community-Articles/2022-11-14-How-to-add-a-custom-grant-type-in-OpenIddict/POST.md
index 73a0d7589c..0401c31898 100644
--- a/docs/en/Community-Articles/2022-11-14-How-to-add-a-custom-grant-type-in-OpenIddict/POST.md
+++ b/docs/en/Community-Articles/2022-11-14-How-to-add-a-custom-grant-type-in-OpenIddict/POST.md
@@ -71,7 +71,13 @@ public class MyTokenExtensionGrant : ITokenExtensionGrant
var claimsPrincipal = await userClaimsPrincipalFactory.CreateAsync(user);
claimsPrincipal.SetScopes(principal.GetScopes());
claimsPrincipal.SetResources(await GetResourcesAsync(context, principal.GetScopes()));
+
+ //abp version < 7.3
await context.HttpContext.RequestServices.GetRequiredService().SetAsync(principal);
+
+ //For abp version >= 7.3
+ await context.HttpContext.RequestServices.GetRequiredService().HandleAsync(context.Request, principal);
+
return new SignInResult(OpenIddictServerAspNetCoreDefaults.AuthenticationScheme, claimsPrincipal);
}
diff --git a/docs/en/Contribution/How-to-Contribute-abp.io-as-a-frontend-developer.md b/docs/en/Contribution/How-to-Contribute-abp.io-as-a-frontend-developer.md
index 9b3225a989..719caf844f 100644
--- a/docs/en/Contribution/How-to-Contribute-abp.io-as-a-frontend-developer.md
+++ b/docs/en/Contribution/How-to-Contribute-abp.io-as-a-frontend-developer.md
@@ -55,4 +55,4 @@ Your backend should be running successfully
There is a demo app. The path of the demo app is `npm\ng-packs\apps\dev-app`. The demo app is connected to the packages with local references. Open the terminal in `npm\ng-packs\apps\dev-app` and execute `yarn` or `npm i` in terminal. After the package installed run `npm start` or `yarn start`.
-The repo uses Nx and packages connected with `local references`. The packages path is `”npm\ng-packs\packages`
+The repo uses Nx and packages connected with `local references`. The packages path is `npm\ng-packs\packages`
diff --git a/docs/en/Distributed-Event-Bus.md b/docs/en/Distributed-Event-Bus.md
index f1b8464d59..550ea6d9f8 100644
--- a/docs/en/Distributed-Event-Bus.md
+++ b/docs/en/Distributed-Event-Bus.md
@@ -185,6 +185,51 @@ If you perform **database operations** and use the [repositories](Repositories.m
> The handler class must be registered to the dependency injection (DI). The sample above uses the `ITransientDependency` to accomplish it. See the [DI document](Dependency-Injection.md) for more options.
+## Monitoring Distributed Events
+
+The ABP Framework allows you to stay informed when your application **receives** or **sends** a distributed event. This capability enables you to track the event flow within your application and take appropriate actions based on the received or sent distributed events.
+
+### Received Events
+
+The `DistributedEventReceived` local event is published when your application receives an event from the distributed event bus. `DistributedEventReceived` class has the following fields:
+
+- **`Source`:** It represents the source of the distributed event. Source can be `Direct`, `Inbox`, `Outbox`.
+- **`EventName`:** It represents the [name](#event-name) of the event received.
+- **`EventData`:** It represents the actual data associated with the event received. Since it is of type `object`, it can hold any type of data.
+
+**Example: Get informed when your application receives an event from the distributed event bus**
+
+```csharp
+public class DistributedEventReceivedHandler : ILocalEventHandler, ITransientDependency
+{
+ public async Task HandleEventAsync(DistributedEventReceived eventData)
+ {
+ // TODO: IMPLEMENT YOUR LOGIC...
+ }
+}
+```
+
+### Sent Events
+
+The `DistributedEventSent` local event is published when your application sends an event to the distributed event bus. `DistributedEventSent` class has the following fields:
+
+- **`Source`:** It represents the source of the distributed event. Source can be `Direct`, `Inbox`, `Outbox`.
+- **`EventName`:** It represents the [name](#event-name) of the event sent.
+- **`EventData`:** It represents the actual data associated with the event sent. Since it is of type `object`, it can hold any type of data.
+
+**Example: Get informed when your application sends an event to the distributed event bus**
+
+```csharp
+public class DistributedEventSentHandler : ILocalEventHandler, ITransientDependency
+{
+ public async Task HandleEventAsync(DistributedEventSent eventData)
+ {
+ // TODO: IMPLEMENT YOUR LOGIC...
+ }
+}
+```
+
+You can seamlessly integrate event-tracking capabilities into your application by subscribing to the `DistributedEventReceived` and `DistributedEventSent` local events as above examples. This empowers you to effectively monitor the messaging flow, diagnose any potential issues, and gain valuable insights into the behavior of your distributed messaging system.
## Pre-Defined Events
diff --git a/docs/en/Getting-Started-React-Native.md b/docs/en/Getting-Started-React-Native.md
index df8fb355a5..bc3c7ef419 100644
--- a/docs/en/Getting-Started-React-Native.md
+++ b/docs/en/Getting-Started-React-Native.md
@@ -1,11 +1,11 @@
# Getting Started with the React Native
-````json
+```json
//[doc-params]
{
- "Tiered": ["No", "Yes"]
+ "Tiered": ["No", "Yes"]
}
-````
+```
ABP platform provide basic [React Native](https://reactnative.dev/) startup template to develop mobile applications **integrated to your ABP based backends**.
@@ -20,7 +20,6 @@ Please follow the steps below to prepare your development environment for React
3. **[Optional] Install VS Code:** [VS Code](https://code.visualstudio.com/) is a free, open-source IDE which works seamlessly with TypeScript. Although you can use any IDE including Visual Studio or Rider, VS Code will most likely deliver the best developer experience when it comes to React Native projects.
4. **Install an Emulator:** React Native applications need an Android emulator or an iOS simulator to run on your OS. See the [Android Studio Emulator](https://docs.expo.io/workflow/android-simulator/) or [iOS Simulator](https://docs.expo.io/workflow/ios-simulator/) on expo.io documentation to learn how to set up an emulator.
-
## How to Start a New React Native Project
You have multiple options to initiate a new React Native project that works with ABP:
@@ -56,6 +55,7 @@ Please do the following:
> When you are using OpenIddict, You should remove 'clientSecret' on Environment.js (if exists) and disable "HTTPS-only" settings. (Openiddict has default since Version 6.0)
### How to disable Https-only in Openiddict.
+
You should add this code on {{ if Tiered == "No" }}`MyProjectNameHttpApiHostModule`{{ else if Tiered == "Yes" }}`MyProjectNameAuthServerModule`{{ end }}.
```csharp
@@ -79,26 +79,27 @@ A React Native application running on an Android emulator or a physical phone **
{{ if Tiered == "No"}}
-* Open the `appsettings.json` in the `.HttpApi.Host` folder. Replace the `localhost` address on the `SelfUrl` and `Authority` properties with your local IP address.
-* Open the `launchSettings.json` in the `.HttpApi.Host/Properties` folder. Replace the `localhost` address on the `applicationUrl` properties with your local IP address.
+- Open the `appsettings.json` file in the `.HttpApi.Host` folder. Replace the `localhost` address on the `SelfUrl` and `Authority` properties with your local IP address.
+- Open the `launchSettings.json` file in the `.HttpApi.Host/Properties` folder. Replace the `localhost` address on the `applicationUrl` properties with your local IP address.
{{ else if Tiered == "Yes" }}
-* Open the `appsettings.json` in the `.AuthServer` folder. Replace the `localhost` address on the `SelfUrl` property with your local IP address.
-* Open the `launchSettings.json` in the `.AuthServer/Properties` folder. Replace the `localhost` address on the `applicationUrl` properties with your local IP address.
-* Open the `appsettings.json` in the `.HttpApi.Host` folder. Replace the `localhost` address on the `Authority` property with your local IP address.
-* Open the `launchSettings.json` in the `.HttpApi.Host/Properties` folder. Replace the `localhost` address on the `applicationUrl` properties with your local IP address.
+- Open the `appsettings.json` file in the `.AuthServer` folder. Replace the `localhost` address on the `SelfUrl` property with your local IP address.
+- Open the `launchSettings.json` file in the `.AuthServer/Properties` folder. Replace the `localhost` address on the `applicationUrl` properties with your local IP address.
+- Open the `appsettings.json` file in the `.HttpApi.Host` folder. Replace the `localhost` address on the `Authority` property with your local IP address.
+- Open the `launchSettings.json` file in the `.HttpApi.Host/Properties` folder. Replace the `localhost` address on the `applicationUrl` properties with your local IP address.
{{ end }}
Run the backend application as described in the [getting started document](Getting-Started.md).
> You should turn off the "Https Restriction" if you're using OpenIddict as a central identity management solution. Because the IOS Simulator doesn't support self-signed certificates and OpenIddict is set to only work with HTTPS by default.
+
## How to disable the Https-only settings of OpenIddict
- Go to MyProjectNameHttpApiHostModule.cs under the host project. Add put these codes under the `PreConfigureServices` function.
+Go to MyProjectNameHttpApiHostModule.cs under the host project. And put these codes under the `PreConfigureServices` function.
```csharp
#if DEBUG
@@ -109,7 +110,6 @@ Run the backend application as described in the [getting started document](Getti
#endif
```
-
## How to Configure & Run the React Native Application
1. Make sure the [database migration is complete](./Getting-Started?UI=NG&DB=EF&Tiered=No#create-the-database) and the [API is up and running](./Getting-Started?UI=NG&DB=EF&Tiered=No#run-the-application).
@@ -128,21 +128,20 @@ Run the backend application as described in the [getting started document](Getti
{{ end }}
-4. Run `yarn start` or `npm start`. Wait Expo CLI to start. Expo CLI opens the management interface on the `http://localhost:19002/` address.
+4. Run `yarn start` or `npm start`. Wait for the Expo CLI to print the opitons.
> The React Native application was generated with [Expo](https://expo.io/). Expo is a set of tools built around React Native to help you quickly start an app and, while it has many features.
-
+
-In the above management interface, you can start the application with an Android emulator, an iOS simulator or a physical phone by the scan the QR code with the [Expo Client](https://expo.io/tools#client).
+In the above image, you can start the application with an Android emulator, an iOS simulator or a physical phone by scanning the QR code with the [Expo Client](https://expo.io/tools#client) or choosing the option.
-Enter **admin** as the username and **1q2w3E*** as the password to login to the application.
+Enter **admin** as the username and **1q2w3E\*** as the password to login to the application.
The application is up and running. You can continue to develop your application based on this startup template.
-
## See Also
-* [React Native project structure](./Startup-Templates/Application#react-native)
+- [React Native project structure](./Startup-Templates/Application#react-native)
diff --git a/docs/en/Image-Manipulation.md b/docs/en/Image-Manipulation.md
new file mode 100644
index 0000000000..7aff8cc1df
--- /dev/null
+++ b/docs/en/Image-Manipulation.md
@@ -0,0 +1,380 @@
+# Image Manipulation
+ABP Framework provides services to compress and resize images and implements these services with popular [ImageSharp](https://sixlabors.com/products/imagesharp/) and [Magick.NET](https://github.com/dlemstra/Magick.NET) libraries. You can use these services in your reusable modules, libraries and applications, so you don't depend on a specific imaging library.
+
+> The image resizer/compressor system is designed to be extensible. You can implement your own image resizer/compressor contributor and use it in your application.
+
+## Installation
+
+You can add this package to your application by either using the [ABP CLI](CLI.md) or manually installing it. Using the [ABP CLI](CLI.md) is the recommended approach.
+
+### Using the ABP CLI
+
+Open a command line terminal in the folder of your project (.csproj file) and type the following command:
+
+```bash
+abp add-package Volo.Abp.Imaging.Abstractions
+```
+
+### Manual Installation
+
+If you want to manually install;
+
+1. Add the [Volo.Abp.Imaging.Abstractions](https://www.nuget.org/packages/Volo.Abp.Imaging.Abstractions) NuGet package to your project:
+
+```
+Install-Package Volo.Abp.Imaging.Abstractions
+```
+
+2. Add the `AbpImagingAbstractionsModule` to the dependency list of your module:
+
+```csharp
+[DependsOn(
+ //...other dependencies
+ typeof(AbpImagingAbstractionsModule) //Add the new module dependency
+ )]
+public class YourModule : AbpModule
+{
+}
+```
+
+## Providers
+
+ABP Framework provides two image resizer/compressor implementations out of the box:
+
+* [Magick.NET](#magicknet-provider)
+* [ImageSharp](#imagesharp-provider)
+
+You should install one of these provides to make it actually working.
+
+> If none of the provider packages installed into your application, compress/resize operations return the untouched input image.
+
+## IImageResizer
+
+You can [inject](Dependency-Injection.md) the `IImageResizer` service and use it for image resize operations. Here is the available methods of the `IImageResizer` service:
+
+```csharp
+public interface IImageResizer
+{
+ /* Works with a Stream object that represents an image */
+ Task> ResizeAsync(
+ Stream stream,
+ ImageResizeArgs resizeArgs,
+ string mimeType = null,
+ CancellationToken cancellationToken = default
+ );
+
+ /* Works with a byte array that contains an image file */
+ Task> ResizeAsync(
+ byte[] bytes,
+ ImageResizeArgs resizeArgs,
+ string mimeType = null,
+ CancellationToken cancellationToken = default
+ );
+}
+```
+
+**Example usage:**
+
+```csharp
+var result = await _imageResizer.ResizeAsync(
+ stream, /* A stream object that represents an image */
+ new ImageResizeArgs
+ {
+ Width = 100,
+ Height = 100,
+ Mode = ImageResizeMode.Crop
+ },
+ mimeType: "image/jpeg"
+);
+```
+
+> You can use `MimeTypes.Image.Jpeg` constant instead of the `image/jpeg` magic string used in that example.
+
+### ImageResizeArgs
+
+The `ImageResizeArgs` is a class that is used to define the resize operation parameters. It has the following properties:
+
+* `Width`: The width of the resized image.
+* `Height`: The height of the resized image.
+* `Mode`: The resize mode (see the [ImageResizeMode](#imageresizemode) section for more information).
+
+### ImageResizeMode
+
+The `ImageResizeMode` is an enum that is used to define the resize mode. It has the following values:
+
+```csharp
+public enum ImageResizeMode : byte
+{
+ None = 0,
+ Stretch = 1,
+ BoxPad = 2,
+ Min = 3,
+ Max = 4,
+ Crop = 5,
+ Pad = 6,
+ Default = 7
+}
+```
+
+> See the [ImageSharp documentation](https://docs.sixlabors.com/api/ImageSharp/SixLabors.ImageSharp.Processing.ResizeMode.html) for more information about the resize modes.
+
+### ImageResizeResult
+
+The `ImageResizeResult` is a generic class that is used to return the result of the image resize operations. It has the following properties:
+
+* `Result`: The resized image (stream or byte array).
+* `State`: The result of the resize operation (type: `ImageProcessState`).
+
+### ImageProcessState
+
+The `ImageProcessState` is an enum that is used to return the the result of the image resize operations. It has the following values:
+
+```csharp
+public enum ImageProcessState : byte
+{
+ Done = 1,
+ Canceled = 2,
+ Unsupported = 3,
+}
+```
+
+### ImageResizeOptions
+
+`ImageResizeOptions` is an [options object](Options.md) that is used to configure the image resize system. It has the following properties:
+
+* `DefaultResizeMode`: The default resize mode. (Default: `ImageResizeMode.None`)
+
+## IImageCompressor
+
+You can [inject](Dependency-Injection.md) the `IImageCompressor` service and use it for image compression operations. Here is the available methods of the `IImageCompressor` service:
+
+```csharp
+public interface IImageCompressor
+{
+ /* Works with a Stream object that represents an image */
+ Task> CompressAsync(
+ Stream stream,
+ string mimeType = null,
+ CancellationToken cancellationToken = default
+ );
+
+ /* Works with a byte array that contains an image file */
+ Task> CompressAsync(
+ byte[] bytes,
+ string mimeType = null,
+ CancellationToken cancellationToken = default
+ );
+}
+```
+
+**Example usage:**
+
+```csharp
+var result = await _imageCompressor.CompressAsync(
+ stream, /* A stream object that represents an image */
+ mimeType: "image/jpeg"
+);
+```
+
+### ImageCompressResult
+
+The `ImageCompressResult` is a generic class that is used to return the result of the image compression operations. It has the following properties:
+
+* `Result`: The compressed image (stream or byte array).
+* `State`: The result of the compress operation (type: `ImageProcessState`).
+
+### ImageProcessState
+
+The `ImageProcessState` is an enum that is used to return the the result of the image compress operations. It has the following values:
+
+```csharp
+public enum ImageProcessState : byte
+{
+ Done = 1,
+ Canceled = 2,
+ Unsupported = 3,
+}
+```
+
+## Magick.NET Provider
+
+`Volo.Abp.Imaging.MagickNet` NuGet package implements the image operations using the [Magick.NET](https://github.com/dlemstra/Magick.NET) library.
+
+## Installation
+
+You can add this package to your application by either using the [ABP CLI](CLI.md) or manually installing it. Using the [ABP CLI](CLI.md) is the recommended approach.
+
+### Using the ABP CLI
+
+Open a command line terminal in the folder of your project (.csproj file) and type the following command:
+
+```bash
+abp add-package Volo.Abp.Imaging.MagickNet
+```
+
+### Manual Installation
+
+If you want to manually install;
+
+1. Add the [Volo.Abp.Imaging.MagickNet](https://www.nuget.org/packages/Volo.Abp.Imaging.MagickNet) NuGet package to your project:
+
+```
+Install-Package Volo.Abp.Imaging.MagickNet
+```
+
+2. Add `AbpImagingMagickNetModule` to your [module](Module-Development-Basics.md)'s dependency list:
+
+```csharp
+[DependsOn(typeof(AbpImagingMagickNetModule))]
+public class MyModule : AbpModule
+{
+ //...
+}
+```
+
+### Configuration
+
+`MagickNetCompressOptions` is an [options object](Options.md) that is used to configure the Magick.NET image compression system. It has the following properties:
+
+* `OptimalCompression`: Indicates whether the optimal compression is enabled or not. (Default: `false`)
+* `IgnoreUnsupportedFormats`: Indicates whether the unsupported formats are ignored or not. (Default: `false`)
+* `Lossless`: Indicates whether the lossless compression is enabled or not. (Default: `false`)
+
+## ImageSharp Provider
+
+`Volo.Abp.Imaging.ImageSharp` NuGet package implements the image operations using the [ImageSharp](https://github.com/SixLabors/ImageSharp) library.
+
+## Installation
+
+You can add this package to your application by either using the [ABP CLI](CLI.md) or manually installing it. Using the [ABP CLI](CLI.md) is the recommended approach.
+
+### Using the ABP CLI
+
+Open a command line terminal in the folder of your project (.csproj file) and type the following command:
+
+```bash
+abp add-package Volo.Abp.Imaging.ImageSharp
+```
+
+### Manual Installation
+
+If you want to manually install;
+
+1. Add the [Volo.Abp.Imaging.ImageSharp](https://www.nuget.org/packages/Volo.Abp.Imaging.ImageSharp) NuGet package to your project:
+
+```
+Install-Package Volo.Abp.Imaging.ImageSharp
+```
+
+2. Add `AbpImagingImageSharpModule` to your [module](Module-Development-Basics.md)'s dependency list:
+
+
+```csharp
+[DependsOn(typeof(AbpImagingImageSharpModule))]
+public class MyModule : AbpModule
+{
+ //...
+}
+```
+
+### Configuration
+
+`ImageSharpCompressOptions` is an [options object](Options.md) that is used to configure the ImageSharp image compression system. It has the following properties:
+
+* `DefaultQuality`: The default quality of the JPEG and WebP encoders. (Default: `75`)
+* [`JpegEncoder`](https://docs.sixlabors.com/api/ImageSharp/SixLabors.ImageSharp.Formats.Jpeg.JpegEncoder.html): The JPEG encoder. (Default: `JpegEncoder` with `Quality` set to `DefaultQuality`)
+* [`PngEncoder`](https://docs.sixlabors.com/api/ImageSharp/SixLabors.ImageSharp.Formats.Png.PngEncoder.html): The PNG encoder. (Default: `PngEncoder` with `IgnoreMetadata` set to `true` and `CompressionLevel` set to `PngCompressionLevel.BestCompression`)
+* [`WebPEncoder`](https://docs.sixlabors.com/api/ImageSharp/SixLabors.ImageSharp.Formats.Webp.WebpEncoder.html): The WebP encoder. (Default: `WebPEncoder` with `Quality` set to `DefaultQuality`)
+
+**Example usage:**
+
+```csharp
+Configure(options =>
+{
+ options.JpegEncoder = new JpegEncoder
+ {
+ Quality = 60
+ };
+ options.PngEncoder = new PngEncoder
+ {
+ CompressionLevel = PngCompressionLevel.BestCompression
+ };
+ options.WebPEncoder = new WebPEncoder
+ {
+ Quality = 65
+ };
+});
+```
+
+## ASP.NET Core Integration
+
+`Volo.Abp.Imaging.AspNetCore` NuGet package defines attributes for controller actions that can automatically compress and/or resize uploaded files.
+
+## Installation
+
+You can add this package to your application by either using the [ABP CLI](CLI.md) or manually installing it. Using the [ABP CLI](CLI.md) is the recommended approach.
+
+### Using the ABP CLI
+
+Open a command line terminal in the folder of your project (.csproj file) and type the following command:
+
+```bash
+abp add-package Volo.Abp.Imaging.AspNetCore
+```
+
+### Manual Installation
+
+If you want to manually install;
+
+1. Add the [Volo.Abp.Imaging.AspNetCore](https://www.nuget.org/packages/Volo.Abp.Imaging.AspNetCore) NuGet package to your project:
+
+```
+Install-Package Volo.Abp.Imaging.AspNetCore
+```
+
+2. Add `AbpImagingAspNetCoreModule` to your [module](Module-Development-Basics.md)'s dependency list:
+
+```csharp
+[DependsOn(typeof(AbpImagingAspNetCoreModule))]
+public class MyModule : AbpModule
+{
+ //...
+}
+```
+
+### CompressImageAttribute
+
+The `CompressImageAttribute` is used to compress the image before. `IFormFile`, `IRemoteStreamContent`, `Stream` and `IEnumrable` types are supported. It has the following properties:
+
+* `Parameters`: Names of the the parameters that are used to configure the image compression system. This is useful if your action has some non-image parameters. If you don't specify the parameters names, all of the method parameters are considered as image.
+
+**Example usage:**
+
+```csharp
+[HttpPost]
+[CompressImage] /* Compresses the given file (automatically determines the file mime type) */
+public async Task Upload(IFormFile file)
+{
+ //...
+}
+```
+
+### ResizeImageAttribute
+
+The `ResizeImageAttribute` is used to resize the image before requesting the action. `IFormFile`, `IRemoteStreamContent`, `Stream` and `IEnumrable` types are supported. It has the following properties:
+
+* `Parameters`: Names of the the parameters that are used to configure the image resize system. This is useful if your action has some non-image parameters. If you don't specify the parameters names, all of the method parameters are considered as image.
+* `Width`: Target width of the resized image.
+* `Height`: Target height of the resized image.
+* `Mode`: The resize mode (see the [ImageResizeMode](#imageresizemode) section for more information).
+
+**Example usage:**
+
+```csharp
+[HttpPost]
+[ResizeImage(Width = 100, Height = 100, Mode = ImageResizeMode.Crop)]
+public async Task Upload(IFormFile file)
+{
+ //...
+}
+```
\ No newline at end of file
diff --git a/docs/en/KB/Windows-Path-Too-Long-Fix.md b/docs/en/KB/Windows-Path-Too-Long-Fix.md
index e463288239..6a822c1402 100644
--- a/docs/en/KB/Windows-Path-Too-Long-Fix.md
+++ b/docs/en/KB/Windows-Path-Too-Long-Fix.md
@@ -1,10 +1,39 @@
# How to Fix "Filename too long" Error on Windows
-If you encounter the "filename too long" or "unzip" error on Windows, it's probably related to the Windows maximum file path limitation. Windows has a maximum file path limitation of 250 characters. To solve this, [enable the long path option in Windows 10](https://docs.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=cmd#enable-long-paths-in-windows-10-version-1607-and-later).
+If you encounter the "filename too long" or "unzip" error on Windows, it's probably related to the Windows maximum file path limitation. Windows has a maximum file path limitation of 255 characters.
+
+## Solution 1
+Try [enabling the long path option in Windows 10](https://docs.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=cmd#enable-long-paths-in-windows-10-version-1607-and-later).
If you face long path errors related to Git, try the following command to enable long paths in Windows.
```
git config --system core.longpaths true
```
-See https://github.com/msysgit/msysgit/wiki/Git-cannot-create-a-file-or-directory-with-a-long-path
\ No newline at end of file
+See https://github.com/msysgit/msysgit/wiki/Git-cannot-create-a-file-or-directory-with-a-long-path
+
+
+## Solution 2
+
+You may encounter a "DirectoryNotFoundException - Could not find a part of the path" exception in Windows while using certain .NET MAUI build tools. This is related to some 32 bit .NET MAUI build tools. To resolve this issue, you can try placing the solution in the root directory of your drive, such as `C:\Projects\`. However, please note that this solution is specific to this particular exception and may not be applicable to all cases of the Windows long path issue.
+
+
+## Solution 3
+
+You can define an alias for a path in Windows by creating a symbolic link using the `mklink` command in the command prompt. Here's an example:
+
+```
+mklink /D C:\MyProject C:\my\long\path\to\solution\
+```
+
+> Your **solution (.sln)** file should be in `C:\my\long\path\to\solution\`. Keep in mind that, if you have relative paths in your .csproj file, it will not work!
+
+This command creates a symbolic link named `MyProject` in the root of the `C:` drive that points to the `C:\my\long\path\to\solution\` directory. You can then use `C:\MyProject` to access the contents of the `C:\my\long\path\to\solution\` directory.
+
+> Note that you need to run the command prompt as an administrator to the create symbolic links.
+
+Then you can try building your project with `dotnet build` command.
+
+```
+dotnet build C:\MyProject\MyProjectName.sln
+```
diff --git a/docs/en/Local-Event-Bus.md b/docs/en/Local-Event-Bus.md
index 57c12d4c3b..81c0c5a171 100644
--- a/docs/en/Local-Event-Bus.md
+++ b/docs/en/Local-Event-Bus.md
@@ -149,7 +149,7 @@ namespace AbpDemo
}
````
-That's all. `MyHandler` is **automatically discovered** by the ABP Framework and `HandleEventAsync` is called whenever a `StockCountChangedEvent` occurs. You can inject any service and perform any required logic in your handler class.
+That's all. `MyHandler` is **automatically discovered** by the ABP Framework and `HandleEventAsync` is called whenever a `StockCountChangedEvent` occurs. You can inject any service and perform any required logic in your handler class.
* **One or more handlers** can subscribe to the same event.
* A single event handler class can **subscribe to multiple events** by implementing the `ILocalEventHandler` interface for each event type.
@@ -158,6 +158,29 @@ If you perform **database operations** and use the [repositories](Repositories.m
> The handler class must be registered to the dependency injection (DI). The sample above uses the `ITransientDependency` to accomplish it. See the [DI document](Dependency-Injection.md) for more options.
+### LocalEventHandlerOrder Attribute
+
+`LocalEventHandlerOrder` attribute can be used to set the execution order for the event handlers, which can be helpful if you want to handle your event handlers in a specific order.
+
+````csharp
+[LocalEventHandlerOrder(-1)]
+public class MyHandler
+ : ILocalEventHandler,
+ ITransientDependency
+{
+ public async Task HandleEventAsync(StockCountChangedEvent eventData)
+ {
+ //TODO: your code that does something on the event
+ }
+}
+````
+
+> By default, all event handlers have an order value of 0. Thus, if you want to take certain event handlers to be executed before other event handlers, you can set the order value as a negative value.
+
+#### LocalEventHandlerOrderAttribute Properties
+
+* `Order` (`int`): Used to set the execution order for a certain event handler.
+
### Transaction & Exception Behavior
Event handlers are always executed in the same [unit of work](Unit-Of-Work.md) scope, that means in the same database transaction with the code that published the event. If an event handler throws an exception, the unit of work (database transaction) is rolled back. So, **use try-catch yourself** in the event handler if you want to hide the error.
@@ -205,7 +228,7 @@ The pre-built event types are;
* `EntityDeletedEventData` is published just after an entity was successfully deleted.
* `EntityChangedEventData` is published just after an entity was successfully created, updated or deleted. It can be a shortcut if you need to listen any type of change - instead of subscribing to the individual events.
-#### How It Was Implemented?
+### How It Was Implemented?
Pre-build events are published when you save changes to the database;
diff --git a/docs/en/Modules/OpenIddict.md b/docs/en/Modules/OpenIddict.md
index 74598ab1f8..db13d4b452 100644
--- a/docs/en/Modules/OpenIddict.md
+++ b/docs/en/Modules/OpenIddict.md
@@ -323,16 +323,16 @@ Configure(options =>
[Claims Principal Factory](https://docs.abp.io/en/abp/latest/Authorization#claims-principal-factory) can be used to add/remove claims to the `ClaimsPrincipal`.
-The `AbpDefaultOpenIddictClaimDestinationsProvider` service will add `Name`, `Email,` and `Role` types of Claims to `access_token` and `id_token`, other claims are only added to `access_token` by default, and remove the `SecurityStampClaimType` secret claim of `Identity`.
+The `AbpDefaultOpenIddictClaimsPrincipalHandler` service will add `Name`, `Email,` and `Role` types of Claims to `access_token` and `id_token`, other claims are only added to `access_token` by default, and remove the `SecurityStampClaimType` secret claim of `Identity`.
-Create a service that inherits from `IAbpOpenIddictClaimDestinationsProvider` and add it to DI to fully control the destinations of claims.
+Create a service that inherits from `IAbpOpenIddictClaimsPrincipalHandler` and add it to DI to fully control the destinations of claims.
```cs
-public class MyClaimDestinationsProvider : IAbpOpenIddictClaimDestinationsProvider, ITransientDependency
+public class MyClaimDestinationsHandler : IAbpOpenIddictClaimsPrincipalHandler, ITransientDependency
{
- public virtual Task SetDestinationsAsync(AbpOpenIddictClaimDestinationsProviderContext context)
+ public virtual Task HandleAsync(AbpOpenIddictClaimsPrincipalHandlerContext context)
{
- foreach (var claim in context.Claims)
+ foreach (var claim in context.Principal.Claims)
{
if (claim.Type == MyClaims.MyClaimsType)
{
@@ -351,7 +351,7 @@ public class MyClaimDestinationsProvider : IAbpOpenIddictClaimDestinationsProvid
Configure(options =>
{
- options.ClaimDestinationsProvider.Add();
+ options.ClaimsPrincipalHandlers.Add();
});
```
diff --git a/docs/en/Startup-Templates/Application.md b/docs/en/Startup-Templates/Application.md
index 98ccdd10d2..0c5e9c4c38 100644
--- a/docs/en/Startup-Templates/Application.md
+++ b/docs/en/Startup-Templates/Application.md
@@ -261,6 +261,19 @@ You should run the application with the given order:
* Then run the `.HttpApi.Host` since it is used by the `.Web` application.
* Finally, you can run the `.Web` project and login to the application (using `admin` as the username and `1q2w3E*` as the password).
+### Blazor UI
+If you choose `Blazor` as the UI Framework (using the `-u blazor` or `-u blazor-server` option), the solution will have a project named `.Blazor`. This project contains the Blazor UI application. According to your choice, it will be a Blazor WebAssembly or Blazor Server application. If Blazor WebAssembly is selected, the solution will also have a `.HttpApi.Host`. This project is an ASP.NET Core application that hosts the backend application for the Blazor single page application.
+
+#### .Blazor Project (Server)
+The Blazor Server project is similar to the ASP.NET Core MVC project. It replaces `.Web` project with `.Blazor` in the solution structure above. It has the same folder structure and the same application flow. Since it's an ASP.NET Core application, it can contain **.cshtml** files and **.razor** components at the same time. If routing matches a razor component, the Blazor UI will be used. Otherwise, the request will be handled by the MVC framework.
+
+
+
+#### .Blazor Project (WebAssembly)
+The Blazor WebAssembly project is a single page application that runs on the browser. You'll see it as `.Blazor` project in the solution. It uses the `.HttpApi.Host` project to communicate with the backend. It can't be used without the backend application. It contains only **.razor** components. It's a pure client-side application. It doesn't have any server-side code. Everything in this layer will be for the client side.
+
+
+
### Angular UI
If you choose `Angular` as the UI framework (using the `-u angular` option), the solution is being separated into two folders:
diff --git a/docs/en/UI/Angular/Card-Component.md b/docs/en/UI/Angular/Card-Component.md
index 861171c39e..ca056853ff 100644
--- a/docs/en/UI/Angular/Card-Component.md
+++ b/docs/en/UI/Angular/Card-Component.md
@@ -29,7 +29,7 @@ ABP Card Component is a part of the `ThemeSharedModule` module. If you've import
// my-feature.module.ts
import { ThemeSharedModule } from '@abp/ng.theme.shared';
-import { CardDemoComponent } from './chart-demo.component';
+import { CardDemoComponent } from './card-demo.component';
@NgModule({
imports: [
diff --git a/docs/en/UI/Angular/Checkbox-Component.md b/docs/en/UI/Angular/Checkbox-Component.md
new file mode 100644
index 0000000000..898f86732c
--- /dev/null
+++ b/docs/en/UI/Angular/Checkbox-Component.md
@@ -0,0 +1,51 @@
+# Checkbox Component
+
+The ABP Checkbox Component is a reusable form input component for the checkbox type.
+
+# Inputs
+
+- `label`
+- `labelClass (default form-check-label)`
+- `checkboxId`
+- `checkboxReadonly`
+- `checkboxReadonly (default form-check-input)`
+- `checkboxStyle`
+
+# Outputs
+
+- `checkboxBlur`
+- `checkboxFocus`
+
+# Usage
+
+The ABP Checkbox component is a part of the `ThemeSharedModule` module. If you've imported that module into your module, there's no need to import it again. If not, then first import it as shown below:
+
+```ts
+// my-feature.module.ts
+
+import { ThemeSharedModule } from "@abp/ng.theme.shared";
+import { CheckboxDemoComponent } from "./CheckboxDemoComponent.component";
+
+@NgModule({
+ imports: [
+ ThemeSharedModule,
+ // ...
+ ],
+ declarations: [CheckboxDemoComponent],
+ // ...
+})
+export class MyFeatureModule {}
+```
+
+Then, the `abp-checkbox` component can be used. See the example below:
+
+```html
+
+
+
+
+```
+
+See the checkbox input result below:
+
+
diff --git a/docs/en/UI/Angular/FormInput-Component.md b/docs/en/UI/Angular/FormInput-Component.md
new file mode 100644
index 0000000000..f1dedd824a
--- /dev/null
+++ b/docs/en/UI/Angular/FormInput-Component.md
@@ -0,0 +1,49 @@
+# Form Input Component
+
+The ABP FormInput Component is a reusable form input component for the text type.
+
+# Inputs
+* `label`
+* `labelClass (default form-label)`
+* `inputPlaceholder`
+* `inputReadonly`
+* `inputClass (default form-control)`
+
+# Outputs
+* `formBlur`
+* `formFocus`
+
+# Usage
+
+The ABP FormInput component is a part of the `ThemeSharedModule` module. If you've imported that module into your module, there's no need to import it again. If not, then first import it as shown below:
+
+```ts
+import { ThemeSharedModule } from "@abp/ng.theme.shared";
+import { FormInputDemoComponent } from "./FomrInputDemoComponent.component";
+
+@NgModule({
+ imports: [
+ ThemeSharedModule,
+ // ...
+ ],
+ declarations: [FormInputDemoComponent],
+})
+export class MyFeatureModule {}
+```
+
+Then, the `abp-form-input` component can be used. See the example below:
+
+```html
+