diff --git a/Directory.Build.props b/Directory.Build.props
index 838ffcc995..cfb62d58d2 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -43,7 +43,7 @@
true
- 4.6.0
+ 4.7.0
diff --git a/abp_io/AbpIoLocalization/AbpIoLocalization/Admin/Localization/Resources/en.json b/abp_io/AbpIoLocalization/AbpIoLocalization/Admin/Localization/Resources/en.json
index 8333e0efbe..e5df7c7915 100644
--- a/abp_io/AbpIoLocalization/AbpIoLocalization/Admin/Localization/Resources/en.json
+++ b/abp_io/AbpIoLocalization/AbpIoLocalization/Admin/Localization/Resources/en.json
@@ -470,19 +470,18 @@
"SubTotal": "Sub Total",
"TotalDue": "Total Due",
"QuotationNo": "Quotation no",
- "ValidFor": "Valid for",
+ "ValidTill": "Valid till",
"QuotationNote": "Quotation note",
- "QuotationTemplate.Address": "Address",
"QuotationTemplate.Address:": "Address:",
- "QuotationTemplate.VATNo": "VAT No",
- "QuotationTemplate.Phone": "Phone",
- "QuotationTemplate.E-mail": "E-mail",
+ "QuotationTemplate.VATNo:": "VAT No:",
+ "QuotationTemplate.Phone:": "Phone:",
+ "QuotationTemplate.E-mail:": "E-mail:",
"QuotationTemplate.Quotation": "Quotation",
"QuotationTemplate.To": "To",
"QuotationTemplate.Details": "Details",
- "QuotationTemplate.QuotationNo:": "Quotation:",
+ "QuotationTemplate.QuotationNo:": "Quotation #:",
"QuotationTemplate.IssueDate:": "Issue Date:",
- "QuotationTemplate.ValidFor:": "Valid For:",
+ "QuotationTemplate.ValidTill:": "Valid Till:",
"QuotationTemplate.ValidDays": "{0} Days",
"QuotationTemplate.Description": "Description",
"QuotationTemplate.UnitPrice": "Unit Price",
@@ -490,10 +489,10 @@
"QuotationTemplate.Discount": "Discount",
"QuotationTemplate.Total": "Total",
"QuotationTemplate.Notes": "Notes",
- "QuotationTemplate.SubTotal": "Sub Total",
- "QuotationTemplate.Tax/VAT": "Tax / VAT (%{0})",
- "QuotationTemplate.TotalDiscount": "Total Discount",
- "QuotationTemplate.TotalDue": "Total Due",
- "QuotationTemplate.ThanksForYourBusiness": "Thanks for your business!"
+ "QuotationTemplate.SubTotal:": "Sub Total :",
+ "QuotationTemplate.Tax/VAT:": "Tax / Vat (%{0}) :",
+ "QuotationTemplate.TotalDiscount:": "Total Discount :",
+ "QuotationTemplate.TOTALDUE:": "TOTAL DUE :",
+ "QuotationTemplate.BankAccount": "Our bank account information can be found at {0}"
}
}
diff --git a/abp_io/AbpIoLocalization/AbpIoLocalization/Admin/Localization/Resources/tr.json b/abp_io/AbpIoLocalization/AbpIoLocalization/Admin/Localization/Resources/tr.json
index c7c2febc28..0aca0b7333 100644
--- a/abp_io/AbpIoLocalization/AbpIoLocalization/Admin/Localization/Resources/tr.json
+++ b/abp_io/AbpIoLocalization/AbpIoLocalization/Admin/Localization/Resources/tr.json
@@ -423,28 +423,26 @@
"SubTotal": "Ara Toplam",
"TotalDue": "NET TOPLAM",
"DiscountAmount": "İndirim Tutarı",
- "QuotationTemplate.Address": "Adres",
"QuotationTemplate.Address:": "Adres:",
- "QuotationTemplate.VATNo": "Vergi Dairesi/No",
- "QuotationTemplate.Phone": "Telefon",
- "QuotationTemplate.E-mail": "E-posta",
+ "QuotationTemplate.VATNo:": "Vergi Dairesi/No:",
+ "QuotationTemplate.Phone:": "Telefon:",
+ "QuotationTemplate.E-mail:": "E-posta:",
"QuotationTemplate.Quotation": "Fiyat Teklifi",
"QuotationTemplate.To": "Müşteri",
"QuotationTemplate.Details": "Detay",
"QuotationTemplate.QuotationNo:": "Teklif No:",
"QuotationTemplate.IssueDate:": "Teklif Tarihi:",
- "QuotationTemplate.ValidFor:": "Geçerlilik Süresi:",
- "QuotationTemplate.ValidDays": "{0} Gün",
+ "QuotationTemplate.ValidTill:": "Geçerlilik Tarihi:",
"QuotationTemplate.Description": "Açıklama",
"QuotationTemplate.UnitPrice": "Birim Fiyat",
"QuotationTemplate.Qty": "Adet",
"QuotationTemplate.Discount": "İndirim",
"QuotationTemplate.Total": "Tutar",
"QuotationTemplate.Notes": "Notlar",
- "QuotationTemplate.SubTotal": "Alt Toplam",
- "QuotationTemplate.Tax/VAT": "Vergiler (%{0})",
- "QuotationTemplate.TotalDiscount": "Toplam İndirim",
- "QuotationTemplate.TotalDue": "NET TOPLAM",
- "QuotationTemplate.ThanksForYourBusiness": "Değerli siparişlerinizi bekleriz."
+ "QuotationTemplate.SubTotal:": "Alt Toplam :",
+ "QuotationTemplate.Tax/VAT:": "Vergiler (%{0}) :",
+ "QuotationTemplate.TotalDiscount:": "Toplam İndirim :",
+ "QuotationTemplate.TOTALDUE:": "NET TOPLAM :",
+ "QuotationTemplate.BankAccount": "Banka hesabı bilgilerimiz {0} adresinde bulunabilir."
}
}
diff --git a/abp_io/AbpIoLocalization/AbpIoLocalization/Base/Localization/Resources/en.json b/abp_io/AbpIoLocalization/AbpIoLocalization/Base/Localization/Resources/en.json
index fb6207f8f8..9ef432a8bd 100644
--- a/abp_io/AbpIoLocalization/AbpIoLocalization/Base/Localization/Resources/en.json
+++ b/abp_io/AbpIoLocalization/AbpIoLocalization/Base/Localization/Resources/en.json
@@ -213,12 +213,13 @@
"SpringCampaign": "Welcome Spring Sale!",
"SpringCampaign2": "Limited Time Offer!",
"AboutUs": "About Us",
- "HowItWorks": "How it works?",
+ "HowItWorks": "How it Works?",
"ReleaseNotes": "Release Notes",
"DetailedChangeNotes" : "Detailed Change Notes",
"SeeTrainings": "See Trainings",
"NoContent": "No content",
- "ABPStudioBeta": "ABP Studio BETA",
- "More": "More"
+ "More": "More",
+ "WhyABPIOPlatform": "Why ABP.IO Platform?",
+ "AbpStudio": "ABP Studio"
}
}
diff --git a/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/ar.json b/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/ar.json
index a7cfc334a9..7226737b84 100644
--- a/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/ar.json
+++ b/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/ar.json
@@ -618,7 +618,7 @@
"TrialLicensePaymentInfoSection_Description": "شراء رخصة: بشراء رخصة، ستستمر في الحصول على الدعم المتميز. ستتمكن أيضًا من الحصول على تحديثات رئيسية أو ثانوية للوحدات والسمات. ستتمكن من الاستمرار في إنشاء مشاريع جديدة. وستظل قادرًا على استخدام ABP Suite مما يسرع من تطويرك. راجع جدول مقارنة الرخصة للتحقق من الاختلافات بين أنواع الرخص.",
"SelectTargetLicense": "حدد الرخصة المرادة",
"UpgradePaymentInfoSection_ExtendMyLicenseForOneYear": "نعم، قم بتمديد تاريخ انتهاء رخصتي لمدة عام واحد.",
- "UpgradePaymentInfoSection_WantToExtendLicense": "هل تريد تمديد ترخيصك لمدة {0} سنة (سنوات) أخرى؟",
+ "UpgradePaymentInfoSection_WantToExtendLicense": "هل تريد تمديد ترخيصك لمدة 1 سنة (سنوات) أخرى؟",
"UpgradePaymentInfoSection_UpgradingWillNotExtendLicense": "لن تؤدي الترقية إلى تمديد تاريخ انتهاء رخصتك!",
"UpgradePaymentInfoSection_LicenseUpgradeDescription": "من خلال ترقية رخصتك، ستقوم بالترقية إلى نوع رخصة أعلى مما سيتيح لك الحصول على مزايا إضافية. راجع جدول مقارنة الرخص للتحقق من الاختلافات بين أنواع الرخص.",
"Landing_Page_CustomerStories": "قصص العملاء",
diff --git a/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/en.json b/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/en.json
index abd93b4547..1b8c972d5c 100644
--- a/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/en.json
+++ b/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/en.json
@@ -501,6 +501,7 @@
"DoYouNeedTraining": "Do you need {0} training?",
"GetInTouchUs": "Get in touch with us",
"ForMoreInformationClickHere": "For more information, click here.",
+ "ForMoreInformationClickHereByClass": "For more information, clickhere.",
"IsGetOnboardingTraining": "Would you like to get onboarding & web application development training?",
"OnboardingWebApplicationDevelopmentTrainingMessage": "To schedule your training calendar, please contact {0} after creating the organization",
"CustomPurchaseMessage": "For the next step, click {0} to contact us.",
@@ -600,7 +601,7 @@
"TotalDeveloperPrice": "Total Developer Price",
"Purchase_PricePerDeveloper": "{0} {1} per developer",
"Purchase_IncludedDeveloperInfo": "{0} {1} included.",
- "Purchase_LicenseExtraDeveloperPurchaseMessage": "The {0} license contains {1} developer(s). You can add additional developers now or later.",
+ "Purchase_LicenseExtraDeveloperPurchaseMessage": "The {0} License includes {1} developers. You can add additional developers.",
"StartupTemplates_Page_Title": "ABP Startup Templates",
"StartupTemplates_Page_Description": "ABP Commercial allows you to build solutions with any level of complexity. It provides two main pre-built startup solutions. You can select the one close to your requirements and build your own custom solution on top of it.",
"MicroserviceStartupSolutionForDotnet": "Microservice Startup Solution for .NET",
@@ -643,7 +644,7 @@
"TrialLicensePaymentInfoSection_Description": "Purchase license: By purchasing a license, you will continue to get premium support. You will also be able to get major or minor updates for modules and themes. You will be able to continue creating new projects. And you will still be able to use ABP Suite which speeds up your development. See the license comparison table to check the differences between the license types.",
"SelectTargetLicense": "Select Target License",
"UpgradePaymentInfoSection_ExtendMyLicenseForOneYear": "Yes, extend my license expiration date for 1 year.",
- "UpgradePaymentInfoSection_WantToExtendLicense": "Do you want to extend your license for {0} more year(s)?",
+ "UpgradePaymentInfoSection_WantToExtendLicense": "Do you want to extend your license for 1 more year?",
"UpgradePaymentInfoSection_UpgradingWillNotExtendLicense": "Upgrading will not extend your license expiration date!",
"UpgradePaymentInfoSection_LicenseUpgradeDescription": "By upgrading your license, you will promote to a higher license type which will allow you to get additional benefits. See the license comparison table to check the differences between the license types.",
"Landing_Page_CustomerStories": "Customer Stories",
@@ -825,7 +826,7 @@
"ExpirationDate": "Expiration Date",
"SpringCampaignDiscount": "Spring Campaign Discount",
"WhyUseAbpIoPlatform": "Why should I use the ABP.IO Platform instead of creating a new solution from scratch?",
- "WhyUseAbpIoPlatformFaqExplanation": "See that document for a detailed explanation of why using ABP.IO Platform has a significant advantage over doing everything yourself.",
+ "WhyUseAbpIoPlatformFaqExplanation": "See that page for a detailed explanation of why using ABP.IO Platform has a significant advantage over doing everything yourself.",
"EulaPageTitle": "End User License Agreement (EULA)",
"PrivacyPolicyPageTitle": "Privacy Policy - Cookie Policy",
"TermsConditionsPageTitle": "Terms and Conditions",
@@ -907,8 +908,12 @@
"ExtraQuestionCreditsFaqExplanation": "Yes, you can. To buy extra question credits, send an e-mail to info@abp.io with your organization's name. Here's the price list for the extra question credits:
50 questions pack $999
25 questions pack $625
15 questions pack $450
",
"AlreadyBetaTester": "You have already joined the beta tester program.",
"AbpStudio": "ABP Studio",
+ "AbpStudio_Description": "ABP Studio is still under development. You can fill out the form below to be one of the first users.",
"AbpStudio_Description1": "ABP Studio is a cross-platform desktop application for ABP developers.",
"AbpStudio_Description2": "It is well integrated to the ABP Framework and aims to provide a comfortable development environment for you by automating things, providing insights about your solution, making develop, run and deploy your solutions much easier.",
+ "AbpStudio_ComingSoon": "Coming Soon Planned beta release date: Q4 of 2023.",
+ "AbpStudio_PlannedPreviewDate": "Planned preview release date: Q4 of 2023.",
+ "BetaRequest": "Beta Request",
"CreateNewSolutions": "Create New Solutions",
"CreateNewSolutions_Description1": "You can create from simple applications to modular monolith or microservice solutions easily with a lot of options. You get a full production-ready base software solution for your business.",
"ArchitectYourSolutions": "Architect Your Solutions",
@@ -963,6 +968,111 @@
"OneCodeBaseMultipleDevices": "One Code-Base Multiple Devices",
"OneCodeBaseMultipleDevices_Description": "ABP Mobile applications are cross-platform. They are ready to be installed and run on iOS and Android devices, and they adapt to different form-factors using a single code base. Developers only need to create the UI and front-end code once, there is no need to adapt the code for each device you want to support.",
"ComesWithTheSourceCode": "Comes with the Source-Code",
- "ComesWithTheSourceCode_Description": "The mobile apps are provided with the source-code. Easily customize the UX/UI of your apps to meet branding guidelines."
+ "ComesWithTheSourceCode_Description": "The mobile apps are provided with the source-code. Easily customize the UX/UI of your apps to meet branding guidelines.",
+ "Purchase_OneYearPrice": "1 Year Price",
+ "Purchase_DeveloperSeatCount": "Developer Seat Count",
+ "Purchase_DevelopersAlreadyIncluded": "{0} developers already included",
+ "1Year": "1 year",
+ "{0}Years": "{0} years",
+ "1YearLicense": "1 year license",
+ "{0}YearsLicense": "{0} years license",
+ "1AdditionalDeveloper": "1 additional developer",
+ "{0}AdditionalDevelopers": "{0} additional developers",
+ "Discount": "Discount ({0}%)",
+ "Summary": "Summary",
+ "TrainingPack": "Training pack",
+ "TrainingPackDiscount": "Training pack discount",
+ "Purchase_OnboardingTraining_Description": "This live training package is discounted when purchase with the new license. This discounted price is valid only for new license purchases. Learn more ",
+ "Purchase_Save": "{0}% Save {1} {2}",
+ "RemoveBasket": "Remove from basket",
+ "WhyABPIOPlatform?": "Why ABP.IO Platform?",
+ "DocumentAim": "This document aims to answer the big question:",
+ "DocumentAim_Description": "\"Why should you use the ABP.IO Platform instead of creating a new solution from scratch?\"",
+ "DocumentAim_Description2": "The document introduces the challenges of building a modern software solution and explains how ABP addresses these challenges.",
+ "CreatingANewSolution": "Creating a New Solution",
+ "CreatingANewSolution_Description": "When you need to start a new solution, there are a lot of questions you need to ask yourself, and you should spend a lot of time before starting to write your very first business code.",
+ "CreatingAnEmptySolution": "Creating an Empty Solution",
+ "THEPROBLEM": "THE PROBLEM",
+ "CreatingAnEmptySolution_THEPROBLEM_Description": "Even creating an almost-empty solution is challenging;",
+ "CreatingAnEmptySolution_THEPROBLEM_Description2": "How do you organize your codebase across projects?",
+ "CreatingAnEmptySolution_THEPROBLEM_Description3": "What are the layers and how do they interact?",
+ "CreatingAnEmptySolution_THEPROBLEM_Description4": "How do you integrate to 3rd-party library and systems?",
+ "CreatingAnEmptySolution_THEPROBLEM_Description5": "How to set up the automated tests?",
+ "ABPSOLUTION": "ABP SOLUTION",
+ "CreatingAnEmptySolution_ABPSOLUTION_Description": "ABP provides a well-architected, layered and production-ready startup solution based on the Domain Driven Design principles. The solution also includes a pre-configured unit and integration test projects for each layer.",
+ "CommonLibraries": "Common Libraries",
+ "CommonLibraries_THEPROBLEM_Description": "Which libraries should you use to implement common requirements? The software development ecosystem is highly dynamic and it is hard to follow the latest tools, libraries, trends and approaches.",
+ "CommonLibraries_ABPSOLUTION_Description": "ABP pre-integrates the popular, mature and up-to-date libraries into the solution. You don't spend time integrating them and talking to each other. They properly work out of the box.",
+ "UITheme&Layout": "UI Theme & Layout",
+ "UITheme&Layout_THEPROBLEM_Description": "When it comes to the UI, there are a lot of challenges, including preparing a foundation to create a responsive, modern and flexible UI kit with a consistent look & feel and tons of features (like left/top navigation menu, header, toolbar, footer, widgets and so.).",
+ "UITheme&Layout_THEPROBLEM_Description2": "Even if you buy a pre-built theme, integrating it into your solution may take days of development. Upgrading such a theme is another problem. Most of the time, the theme's HTML/CSS structure is mixed with your UI code, and it is not easy to upgrade or change the theme later.",
+ "UITheme&Layout_ABPSOLUTION_Description": "ABP Framework provides a theming system that makes your UI code independent from the theme. Themes are isolated, and they are NuGet/NPM packages. Installing or upgrading a theme is just a minute. While you can build your theme (or integrate an existing theme), ABP Commercial offers professional and modern themes.",
+ "UITheme&Layout_ABPSOLUTION_Description2": "There are also UI component providers (like Telerik and DevExpress). But they only provide individual components. You are responsible for creating your own layout system. You can use such libraries in your ABP-based solutions just like in any other project.",
+ "TestInfrastructure": "Test Infrastructure",
+ "TestInfrastructure_THEPROBLEM_Description": "Preparing a robust test environment takes time. You need to setup test projects in your solution, select the tools, mock the services and database, create the required base classes and utility services to reduce repeating code in the tests and so on.",
+ "TestInfrastructure_ABPSOLUTION_Description": "ABP Startup Templates comes with the test projects already configured for you, and you can immediately write your first unit or integration test code on day 1.",
+ "CodingStandards&Training": "Coding Standards & Training",
+ "CodingStandards&Training_THEPROBLEM_Description": "Once you create the development-ready solution, you typically need to train the developers to explain the system and develop it with the same conventions in a standard and consistent way. Even if you train the developers, it is hard to prepare and maintain your documentation. Over time, every developer will write the code differently, and coding standards will begin to diverge.",
+ "CodingStandards&Training_ABPSOLUTION_Description": "ABP solution is already well-defined and well-documented. Tutorials and best practice guides clearly explain how to make development on an ABP project.",
+ "KeepingYourSolutionUpToDate": "Keeping Your Solution Up to Date",
+ "KeepingYourSolutionUpToDate_THEPROBLEM_Description": "After you start your development, you must keep track of the new versions of the libraries you use for upgrades & patches.",
+ "KeepingYourSolutionUpToDate_ABPSOLUTION_Description": "We regularly update all packages to the latest versions and test them before the stable release. When you update the ABP Framework, all its dependencies are upgraded to edge technology.",
+ "KeepingYourSolutionUpToDate_ABPSOLUTION_Description2": "Abp update CLI command automatically discovers and upgrades all ABP-dependant NuGet and NPM packages in a solution. With ABP, it is easier to stay with the latest versions.",
+ "DRY": "Don't Repeat Yourself!",
+ "DRY_Description": "Creating a base solution takes significant time and requires well architectural experience. However, this is just the beginning! As you start developing, you will likely have to write lots of repetitive code; that would be great if all this could be handled automatically.",
+ "DRY_Description2": "ABP automates and simplifies repeating code as much as possible by following the convention over configuration principle. However, it doesn't restrict you when you need to switch to manual gear. The control is always in your hands.",
+ "Authentication": "Authentication",
+ "Authentication_THEPROBLEM_Description": "Single Sign On, Active Directory / LDAP Integration, OpenIddict integration, social logins, two-factor authentication, forgot/reset password, email activation, new user registration, password complexity control, locking account on failed attempts, showing failed login attemps ... etc. We know that all these generic requirements are familiar to you. You are not alone!",
+ "Authentication_ABPSOLUTION_Description": "ABP Framework and the commercial version provide all these standard stuff pre-implemented for you as a re-usable account module. You just enable and configure what you need.",
+ "CrossCuttingConcerns": "Cross-Cutting Concerns",
+ "CrossCuttingConcerns_THEPROBLEM_Description": "Cross-Cutting Concerns are the fundamental repeating logic that should be implementedfor each use case. Some examples;",
+ "CrossCuttingConcerns_THEPROBLEM_Description2": "Starting transactions, committing on success and rollback on errors.",
+ "CrossCuttingConcerns_THEPROBLEM_Description3": "Handling and reporting exceptions, returning a proper error response to the clients and handling error cases on the client-side.",
+ "CrossCuttingConcerns_THEPROBLEM_Description4": "Implementing authorization and validation, returning proper responses and handling these on the client-side.",
+ "CrossCuttingConcerns_ABPSOLUTION_Description": "ABP Framework automates or simplifies all the common cross-cutting concerns. You only write code that matters for your business and ABP handles the rest by conventions.",
+ "ArchitecturalInfrastructure": "Architectural Infrastructure",
+ "ArchitecturalInfrastructure_THEPROBLEM_Description": "You typically need to build infrastructure to implement your architecture properly. For example, you generally implement the Repository pattern. You define some base classes to simplify and standardize to create entities, services, controllers and other objects.",
+ "ArchitecturalInfrastructure_ABPSOLUTION_Description": "ABP Framework provides all these and more out of the box. It is mature and well-documented.",
+ "EnterpriseApplicationRequirements": "Enterprise Application Requirements",
+ "EnterpriseApplicationRequirements_THEPROBLEM_Description": "There are a lot of requirements you repeatedly implement in every business application;",
+ "EnterpriseApplicationRequirements_THEPROBLEM_Description2": "Detailed permission system and managing permissions on the UI based on roles and users.",
+ "EnterpriseApplicationRequirements_THEPROBLEM_Description3": "Writing audit logs and entity histories to track when a user modifies a database record.",
+ "EnterpriseApplicationRequirements_THEPROBLEM_Description4": "Make your entities soft delete, so they are marked as deleted instead of physically deleting from the database and automatically filtering deleted entities on your queries.",
+ "EnterpriseApplicationRequirements_THEPROBLEM_Description5": "Creating abstractions and wrappers to consume your backend APIs from the frontend code.",
+ "EnterpriseApplicationRequirements_THEPROBLEM_Description6": "Enqueuing and executing background jobs.",
+ "EnterpriseApplicationRequirements_THEPROBLEM_Description7": "Handling multiple time zones in a global system.",
+ "EnterpriseApplicationRequirements_THEPROBLEM_Description8": "Sharing validation, localization, authorization logic between server and client.",
+ "EnterpriseApplicationRequirements_ABPSOLUTION_Description": "ABP provides infrastructure to implement such requirements easily. Again, you don't spend your valuable time to re-implement all these again and again.",
+ "GeneratingInitialCode&Tooling": "Generating Initial Code & Tooling",
+ "GeneratingInitialCode&Tooling_THEPROBLEM_Description": "You will build many similar pages in a typical web application. Most of them will perform similar CRUD operations. It is very tedious and also error prone to repeatedly create such pages.",
+ "GeneratingInitialCode&Tooling_ABPSOLUTION_Description": "ABP Suite can generate a full-stack CRUD page for your entities in seconds. The generated code is layered and clean. All the standard validation and authorization requirements are implemented. Plus, unit test classes are generated. Once you get a fully running page, you can modify it according to your business requirements.",
+ "IntegratingTo3rdPartyLibrariesAndSystems": "Integrating to 3rd-Party Libraries and Systems",
+ "IntegratingTo3rdPartyLibrariesAndSystems_THEPROBLEM_Description": "Most libraries are designed as low level, and you typically do some work to integrate them properly without repeating the same integration and configuration code everywhere in your solution. For example, assume you must use RabbitMQ to implement your distributed event bus. All you want to do is; send a message to a queue and handle the incoming messages. But you need to understand messaging patterns, queue and exchange details. To write an efficient code, you must create a pool to manage connections, clients and channels. You also must deal with exceptions, ACK messages, re-connecting to RabbitMQ on failures and more.",
+ "IntegratingTo3rdPartyLibrariesAndSystems_ABPSOLUTION_Description": "For example, ABP's RabbitMQ Distributed Event Bus integration abstracts all these details. You send and receive messages without the hustle and bustle. Do you need to write low-level code? No problem, you can always do that. ABP doesn't restrict you when you need to use low-level features of the library you are using.",
+ "WhyNotBuildYourOwnFramework?": "Why Not Build Your Own Framework?",
+ "WhyNotBuildYourOwnFramework_THEPROBLEM_Description": "All the infrastructure, even in the most simple way, takes a lot of time to build, maintain and document. It gets bigger over time, and it becomes hard to maintain it in your solution. Separating these into a re-usable project is the starting point for building your own internal framework.",
+ "WhyNotBuildYourOwnFramework_THEPROBLEM_Description2": "Building, documenting, training and maintaining an internal framework is really hard. If you don't have an experienced, dedicated framework team, your internal framework rapidly becomes an undocumented legacy code that no one can understand and maintain anymore. On the other hand, these frameworks are generally developed by one or two developers in the team. And these fellows are becoming a knowledge silo. It is good for them but bad for the company because they are the project's single point of failure -SPOF-. Once they leave the company, the project dramatically goes down.",
+ "WhyNotBuildYourOwnFramework_ABPSOLUTION_Description": "ABP Framework is a community-driven, well-documented, mature and generic application framework. A team of highly experienced developers are working hard to keep it up-to-date, easy to understand and comfortable to use. Using such a stable framework makes you focus on your own business code and get help with the framework from experts whenever you need it.",
+ "ArchitecturalInfrastructure_Description": "SaaS applications, modular or microservice systems are most used enterprise software models. Building such systems not only requires a good understanding and experience, but also requires a strong software infrastructure. Otherwise, you will find yourself spending a great effort to support these architectural details in your codebase.",
+ "Modularity": "Modularity",
+ "Modularity_THEPROBLEM_Description": "Building a truly modular system is not easy! All the aspects of the system (database, entities, APIs, UI pages/components) can be split into modules, and each module can be re-usable without others. The plain ASP.NET Core doesn't provide such a modular architecture. If you need it, you should think about it from scratch.",
+ "Modularity_ABPSOLUTION_Description": "The ABP Framework is born to be a modular application development structure. Every feature in the framework is developed to be compatible with modularity. Documentation and guides explain how to develop re-usable modules in a standard way.",
+ "SaaSMultiTenancy": "SaaS / Multi-Tenancy",
+ "SaaSMultiTenancy_THEPROBLEM_Description": "Multi-Tenancy is a common way to implement SaaS systems. However, implementing a consistent multi-tenant infrastructure may become complicated.",
+ "SaaSMultiTenancy_ABPSOLUTION_Description": "ABP Framework provides a complete multi-tenant infrastructure and abstract complexity from your business code. Your application code will be mostly multi-tenancy aware while the ABP Framework automatically isolates the database, cache and other details of the tenants from each other. It supports single database, per tenant database and hybrid approaches. It properly configures the libraries like Microsoft Identity and OpenIddict, which are not normally multi-tenancy compatible.",
+ "Microservices": "Microservices",
+ "Microservices_THEPROBLEM_Description": "Building a microservice system requires many infrastructure details: Authenticating and authorizing applications and microservices and implementing asynchronous messaging and synchronous (Rest/GRPC) communication patterns between microservices are the most fundamental issues.",
+ "Microservices_ABPSOLUTION_Description": "The ABP Framework provides services, guides, and samples to help you implement your microservice solution using the industry standard tools.",
+ "Microservices_ABPSOLUTION_Description2": "ABP Commercial even goes one step further and provides a complete startup template to kick-start your microservice solution.",
+ "PreBuiltModules": "Pre-Built Modules",
+ "PreBuiltModules_THEPROBLEM_Description": "All of us have similar but slightly different business requirements. However, we all should re-invent the wheel since no one's code can directly work in our solution. They are all embedded parts of a larger solution.",
+ "PreBuiltModules_ABPSOLUTION_Description":"ABP Commercial modules provides a lot of re-usable application modules like payment, chat, file management, audit log reporting... etc. All of these modules are easily installed into your solution and directly work. We are constantly adding more modules.",
+ "PreBuiltModules_ABPSOLUTION_Description2": "All modules are designed as customizable for your business requirements. If you need complete control, you can download the full source code of any module and completely customize based on your specific business requirements.",
+ "ABPCommunity": "ABP Community",
+ "ABPCommunity_Description": "Finally, Being in a big community where everyone follows similar coding styles and principles and shares a common infrastructure brings power when you have troubles or need help with design decisions. Since we write code similarly, we can help each other much better. ABP is a community-backed project with more then 10K stars on GitHub.",
+ "ABPCommunity_Description2": "It is easy to share code or even re-usable libraries between ABP developers. A code snippet that works for you will also work for others. There are a lot of samples and tutorials that you can directly implement for your application.",
+ "ABPCommunity_Description3": "When you hire a developer who worked before with the ABP architecture will immediately understand your solution and start development in a very short time.",
+ "WhyAbpIo_Page_Title": "Why ABP.IO Platform?",
+ "AbpStudio_Page_Title": "ABP Studio"
}
}
diff --git a/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/fi.json b/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/fi.json
index a4b3ac3a80..3e1b92ff90 100644
--- a/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/fi.json
+++ b/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/fi.json
@@ -642,7 +642,7 @@
"TrialLicensePaymentInfoSection_Description": "Osta käyttölupa: Ostamalla lisenssin saat edelleen premium-tuen. Voit myös saada suurempia tai pieniä päivityksiä moduuleille ja teemoille. Voit jatkaa uusien projektien luomista. Voit edelleen käyttää ABP Suitea, joka nopeuttaa kehitystäsi. Katso käyttölupien vertailutaulukko, jolla voit tarkistaa lisenssityyppien väliset erot.",
"SelectTargetLicense": "Valitse kohdelisenssi",
"UpgradePaymentInfoSection_ExtendMyLicenseForOneYear": "Kyllä, jatka lisenssini voimassaolopäivää 1 vuodella.",
- "UpgradePaymentInfoSection_WantToExtendLicense": "Haluatko jatkaa lisenssiäsi vielä {0} vuodella?",
+ "UpgradePaymentInfoSection_WantToExtendLicense": "Haluatko jatkaa lisenssiäsi vielä 1 vuodella?",
"UpgradePaymentInfoSection_UpgradingWillNotExtendLicense": "Päivitys ei pidennä lisenssisi vanhenemispäivää!",
"UpgradePaymentInfoSection_LicenseUpgradeDescription": "Päivittämällä lisenssisi ylennät korkeampaan lisenssityyppiin, mikä antaa sinulle lisäetuja. Katso lisenssityyppien väliset erot lisenssivertailutaulukosta.",
"Landing_Page_CustomerStories": "Asiakkaiden tarinoita",
diff --git a/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/hu.json b/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/hu.json
index 8b9fb041b7..351a468fe4 100644
--- a/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/hu.json
+++ b/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/hu.json
@@ -642,7 +642,7 @@
"TrialLicensePaymentInfoSection_Description": "Licensz vásárlása: licensz megvásárlásával továbbra is prémium támogatást kap . Emellett kisebb-nagyobb frissítéseket is kaphat a modulokhoz és témákhoz. Folytathatja új projektek létrehozását. És továbbra is használhatja az ABP Suite -ot, amely felgyorsítja a fejlesztést. Tekintse meg a licensz-összehasonlító táblázatot a licensztípusok közötti különbségek ellenőrzéséhez.",
"SelectTargetLicense": "Válassza a Target License lehetőséget",
"UpgradePaymentInfoSection_ExtendMyLicenseForOneYear": "Igen, meghosszabbítom az engedélyem lejárati dátumát 1 évvel.",
- "UpgradePaymentInfoSection_WantToExtendLicense": "Szeretné meghosszabbítani licenszét további {0} évre?",
+ "UpgradePaymentInfoSection_WantToExtendLicense": "Szeretné meghosszabbítani licenszét további 1 évre?",
"UpgradePaymentInfoSection_UpgradingWillNotExtendLicense": "A frissítés nem hosszabbítja meg a licensz lejárati dátumát!",
"UpgradePaymentInfoSection_LicenseUpgradeDescription": "Licenszének frissítésével magasabb licensztípusra lép, amely további előnyökhöz juttatja Önt. Tekintse meg a licensz-összehasonlító táblázatot a licensztípusok közötti különbségek ellenőrzéséhez.",
"Landing_Page_CustomerStories": "Ügyféltörténetek",
diff --git a/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/tr.json b/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/tr.json
index e7781f9fe5..7c4df52c6c 100644
--- a/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/tr.json
+++ b/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/tr.json
@@ -511,6 +511,7 @@
"DoYouNeedTraining": "{0} eğitimine ihtiyacınız var mı?",
"GetInTouchUs": "Bize Ulaşın",
"ForMoreInformationClickHere": "Daha fazla bilgi için buraya tıklayın.",
+ "ForMoreInformationClickHereByClass": "Daha fazla bilgi içinburaya tıklayın.",
"IsGetOnboardingTraining": "İşe alım ve web uygulaması geliştirme eğitimi almak ister misiniz?",
"OnboardingWebApplicationDevelopmentTrainingMessage": "Eğitim takviminizi planlamak için lütfen organizasyonu oluşturduktan sonra {0} ile iletişime geçin",
"CustomPurchaseMessage": "Bir sonraki adım için, bizimle iletişime geçmek üzere {0}'a tıklayın.",
@@ -650,7 +651,7 @@
"TrialLicensePaymentInfoSection_Description": "Lisans satın alma: Bir lisans satın alarak premium destek almaya devam edeceksiniz. Ayrıca modüller ve temalar için büyük veya küçük güncellemeler alabileceksiniz. Yeni projeler oluşturmaya devam edebileceksiniz. Ve gelişiminizi hızlandıran ABP Suite'i kullanmaya devam edebileceksiniz. Lisans türleri arasındaki farkları kontrol etmek için lisans karşılaştırma tablosuna bakın.",
"SelectTargetLicense": "Hedef Lisansı Seçin",
"UpgradePaymentInfoSection_ExtendMyLicenseForOneYear": "Evet, lisansımın geçerlilik süresini 1 yıl uzatın.",
- "UpgradePaymentInfoSection_WantToExtendLicense": "Lisansınızı {0} yıl daha uzatmak istiyor musunuz?",
+ "UpgradePaymentInfoSection_WantToExtendLicense": "Lisansınızı 1 yıl daha uzatmak istiyor musunuz?",
"UpgradePaymentInfoSection_UpgradingWillNotExtendLicense": "Yükseltme işlemi lisansınızın son kullanma tarihini uzatmayacaktır!",
"UpgradePaymentInfoSection_LicenseUpgradeDescription": "Lisansınızı yükselterek, ek avantajlar elde etmenizi sağlayacak daha yüksek bir lisans türüne terfi edeceksiniz. Lisans türleri arasındaki farkları kontrol etmek için lisans karşılaştırma tablosuna bakın.",
"Landing_Page_CustomerStories": "Müşteri Hikayeleri",
diff --git a/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/zh-Hans.json b/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/zh-Hans.json
index 699cc0abf2..0aadd74a52 100644
--- a/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/zh-Hans.json
+++ b/abp_io/AbpIoLocalization/AbpIoLocalization/Commercial/Localization/Resources/zh-Hans.json
@@ -641,7 +641,7 @@
"TrialLicensePaymentInfoSection_Description": "购买许可证:通过购买许可证,您将继续获得高级支持。 您还将能够获得模块和主题的重大更新。 您将能够继续创建新项目。 而且您仍然可以使用 ABP 套件 加速您的开发。 请参阅 许可证比较表来查看许可证类型之间的差异。",
"SelectTargetLicense": "选择目标许可证",
"UpgradePaymentInfoSection_ExtendMyLicenseForOneYear": "是的,将我的许可证到期日期延长 1 年。",
- "UpgradePaymentInfoSection_WantToExtendLicense": "您想将许可证再延长 {0} 年吗?",
+ "UpgradePaymentInfoSection_WantToExtendLicense": "您想将许可证再延长 1 年吗?",
"UpgradePaymentInfoSection_UpgradingWillNotExtendLicense": "升级不会延长您的许可证到期日期!",
"UpgradePaymentInfoSection_LicenseUpgradeDescription": "通过升级您的许可证,您将升级到更高的许可证类型,这将使您获得额外的好处。 请参阅许可证比较表以查看许可证类型之间的差异。",
"Landing_Page_CustomerStories": "客户故事",
diff --git a/docs/en/Best-Practices/Entities.md b/docs/en/Best-Practices/Entities.md
index 1c76469cb7..5a8c07c075 100644
--- a/docs/en/Best-Practices/Entities.md
+++ b/docs/en/Best-Practices/Entities.md
@@ -28,6 +28,7 @@ Every aggregate root is also an entity. So, these rules are valid for aggregate
- **Do** keep the entity as always **valid** and **consistent** within its own boundary.
- **Do** define properties with `private`, `protected`, `internal ` or `protected internal` setter where it is needed to protect the entity consistency and validity.
- **Do** define `public `, `internal` or `protected internal` (virtual) **methods** to change the properties (with non-public setters) if necessary.
+ - **Do** return the entity object (`this`) from the setter methods.
### Aggregate Roots
@@ -86,15 +87,16 @@ public class Issue : FullAuditedAggregateRoot //Using Guid as the key/iden
Labels = new Collection(); //Always initialize the collection
}
- public virtual void SetTitle([NotNull] string title)
+ public virtual Issue SetTitle([NotNull] string title)
{
Title = Check.NotNullOrWhiteSpace(title, nameof(title)); //Validate
+ return this;
}
/* AddLabel & RemoveLabel methods manages the Labels collection
* in a safe way (prevents adding the same label twice) */
- public virtual void AddLabel(Guid labelId)
+ public virtual Issue AddLabel(Guid labelId)
{
if (Labels.Any(l => l.LabelId == labelId))
{
@@ -102,11 +104,13 @@ public class Issue : FullAuditedAggregateRoot //Using Guid as the key/iden
}
Labels.Add(new IssueLabel(Id, labelId));
+ return this;
}
- public virtual void RemoveLabel(Guid labelId)
+ public virtual Issue RemoveLabel(Guid labelId)
{
Labels.RemoveAll(l => l.LabelId == labelId);
+ return this;
}
/* Close & ReOpen methods protect the consistency
diff --git a/docs/en/Community-Articles/2023-08-07-Basic-Theme-Dark-Mode/POST.md b/docs/en/Community-Articles/2023-08-07-Basic-Theme-Dark-Mode/POST.md
new file mode 100644
index 0000000000..00325751ef
--- /dev/null
+++ b/docs/en/Community-Articles/2023-08-07-Basic-Theme-Dark-Mode/POST.md
@@ -0,0 +1,125 @@
+# Adding Dark Mode Support to the Basic Theme
+Basic Theme uses plain bootstrap and does not have any custom colors & styles. This article will show you how to add dark mode support to the [Basic Theme](https://docs.abp.io/en/abp/latest/UI/AspNetCore/Basic-Theme).
+
+Bootstrap brings the [Color Modes](https://getbootstrap.com/docs/5.3/customize/color-modes/#dark-mode) feature with version **5.3**. This feature allows you to add dark mode support to your website with a single line of code. Adding the `data-bs-theme="dark"` attribute changes the color mode of the element to dark mode.
+
+## Instructions
+
+1. Create a new project with the following command:
+ ```bash
+ abp new BasicThemeDarkMode -t app --theme basic
+ ```
+
+2. Create a component that toggles the color mode.
+
+ - Create a new file named `Components/ChangeTheme/Default.cshtml`:
+ ```html
+
+
+
+ ```
+
+ - Create a new file named `Components/ChangeTheme/ChangeThemeViewComponent.cs`:
+ ```csharp
+ using Microsoft.AspNetCore.Mvc;
+ using Volo.Abp.AspNetCore.Mvc;
+
+ namespace BasicThemeDarkMode.Web.Components.ChangeTheme;
+
+ [Widget(ScriptFiles = new[]{"/Components/ChangeTheme/ChangeTheme.js"})]
+ public class ChangeThemeViewComponent : AbpViewComponent
+ {
+ public IViewComponentResult Invoke()
+ {
+ return View("~/Components/ChangeTheme/Default.cshtml");
+ }
+ }
+ ```
+
+ - Create a JavaScript that manages the last selected theme and toggles the color mode. It stores the last selected theme in the *local storage*. So, you don't need to store it in the database.
+
+ - Create a new file named `Components/ChangeTheme/ChangeTheme.js`:
+ ```js
+ $(function () {
+ function changeTheme(theme) {
+ window.localStorage.setItem('theme', theme);
+ document.getElementsByTagName('body')[0].setAttribute('data-bs-theme', theme);
+ }
+
+ function toggleTheme(){
+ getTheme() == 'light' ? changeTheme('dark') : changeTheme('light');
+ }
+
+ function getTheme(){
+ return window.localStorage.getItem('theme') ?? 'dark';
+ }
+
+ function init(){
+ let theme = getTheme();
+ if(theme){
+ changeTheme(theme);
+ }
+ }
+
+ document.getElementById('ToolbarChangeTheme').addEventListener('click', () => {
+ toggleTheme();
+ });
+
+ init();
+ });
+ ```
+
+3. Create a new [Toolbar Contributor](https://docs.abp.io/en/abp/latest/UI/AspNetCore/Toolbars) and add a newly created view component to the application toolbar.
+
+ - Create a new class named `BasicThemeDarkModeToolbarContributor.cs`:
+ ```csharp
+ using BasicThemeDarkMode.Web.Components.ChangeTheme;
+ using System.Threading.Tasks;
+ using Volo.Abp.AspNetCore.Mvc.UI.Theme.Shared.Toolbars;
+
+ namespace BasicThemeDarkMode.Web;
+
+ public class BasicThemeDarkModeToolbarContributor : IToolbarContributor
+ {
+ public Task ConfigureToolbarAsync(IToolbarConfigurationContext context)
+ {
+ if (context.Toolbar.Name == StandardToolbars.Main)
+ {
+ context.Toolbar.Items
+ .Add(new ToolbarItem(typeof(ChangeThemeViewComponent)));
+ }
+
+ return Task.CompletedTask;
+ }
+ }
+ ```
+
+ - Configure [Toolbar Options](https://docs.abp.io/en/abp/latest/UI/AspNetCore/Toolbars) and add a newly created contributor:
+ ```csharp
+ Configure(options =>
+ {
+ options.Contributors.Add(new BasicThemeDarkModeToolbarContributor());
+ });
+ ```
+
+That's it! Now, you can toggle the color mode by clicking the sun icon in the toolbar:
+
+
+
+- Users Page in Dark Mode:
+
+ 
+
+- Settings Page in Dark Mode:
+
+ 
+
+- Login Page in Dark Mode:
+
+ 
+
+## Conclusion
+
+The theme is stored in **local storage** and it's initialized on the client-side. You can use **Cookies** to render the page in the last selected theme on **server-side** to prevent the flash effect while navigating pages. This document shows the concept of adding dark mode support of bootstrap to the Basic Theme.
diff --git a/docs/en/Community-Articles/2023-08-07-Basic-Theme-Dark-Mode/basictheme-dark-login.png b/docs/en/Community-Articles/2023-08-07-Basic-Theme-Dark-Mode/basictheme-dark-login.png
new file mode 100644
index 0000000000..0ee18b54b9
Binary files /dev/null and b/docs/en/Community-Articles/2023-08-07-Basic-Theme-Dark-Mode/basictheme-dark-login.png differ
diff --git a/docs/en/Community-Articles/2023-08-07-Basic-Theme-Dark-Mode/basictheme-dark-settings.png b/docs/en/Community-Articles/2023-08-07-Basic-Theme-Dark-Mode/basictheme-dark-settings.png
new file mode 100644
index 0000000000..6d32677c4c
Binary files /dev/null and b/docs/en/Community-Articles/2023-08-07-Basic-Theme-Dark-Mode/basictheme-dark-settings.png differ
diff --git a/docs/en/Community-Articles/2023-08-07-Basic-Theme-Dark-Mode/basictheme-dark-users.png b/docs/en/Community-Articles/2023-08-07-Basic-Theme-Dark-Mode/basictheme-dark-users.png
new file mode 100644
index 0000000000..67973f8a10
Binary files /dev/null and b/docs/en/Community-Articles/2023-08-07-Basic-Theme-Dark-Mode/basictheme-dark-users.png differ
diff --git a/docs/en/Community-Articles/2023-08-07-Basic-Theme-Dark-Mode/basictheme-toggle-demo.gif b/docs/en/Community-Articles/2023-08-07-Basic-Theme-Dark-Mode/basictheme-toggle-demo.gif
new file mode 100644
index 0000000000..536b30e6ee
Binary files /dev/null and b/docs/en/Community-Articles/2023-08-07-Basic-Theme-Dark-Mode/basictheme-toggle-demo.gif differ
diff --git a/docs/en/Community-Articles/2023-08-12-ABP-Commercial-GDPR-Module-Overview/POST.md b/docs/en/Community-Articles/2023-08-12-ABP-Commercial-GDPR-Module-Overview/POST.md
new file mode 100644
index 0000000000..38cfab67e9
--- /dev/null
+++ b/docs/en/Community-Articles/2023-08-12-ABP-Commercial-GDPR-Module-Overview/POST.md
@@ -0,0 +1,148 @@
+# ABP Commercial - GDPR Module Overview
+
+In this article, I will highlight ABP Commercial's [GDPR Module](https://commercial.abp.io/modules/Volo.Gdpr) and show you how to provide personal data to the GDPR Module that is collected by your application and make it aligned with personal data download results.
+
+## GDPR Module
+
+[GDPR Module](https://docs.abp.io/en/commercial/latest/modules/gdpr) allows users to download and delete the data collected by the application. It's used for Personal Data Management obligating by the GDPR regulation and provides the following features:
+
+* Allows users to request their personal data.
+* Lists the personal data requests and users can download their personal data by the listed request times.
+* Allows users to delete their personal data and their accounts permanently.
+
+The GDPR module is pre-installed in the [Application](https://docs.abp.io/en/commercial/latest/startup-templates/application/index) and [Application (Single Layer)](https://docs.abp.io/en/commercial/latest/startup-templates/application-single-layer/index) Pro Startup templates for ABP Commercial customers. Therefore, most of the time you don't need to manually install it.
+
+> If you need to install the GDPR Module manually, you can refer to the [GDPR Module documentation](https://docs.abp.io/en/commercial/latest/modules/gdpr#how-to-install).
+
+Let's create an Application template with the following command and see the UI for the GDPR module:
+
+```csharp
+abp new GdprDemo -t app-pro
+```
+
+After the application is created, we can run the application and login to the application. Then, when we check the user menu, we should be able to see the "Personal Data" menu item:
+
+
+
+We can click this menu item to navigate to the "Personal Data Management" page:
+
+
+
+This page is used to manage personal data requests. You can view past requests, the current status of the latest request, create a new personal data download request, download the prepared personal data or delete all your personal data (makes the data anonymized) and account from the application.
+
+### Downloading Personal Data
+
+After a quick overview of the GDPR module, now we can deep dive into the Personal Data Download process.
+
+The GDPR module requests information from the other modules that reference the `Volo.Abp.Gdpr.Abstractions` package and merges the response data into a single JSON file and the personal data can be downloaded later by the user from the "Personal Data Management" page when it's prepared (when the specified preparation time has been passed).
+
+Currently, only the [Identity Pro module](https://docs.abp.io/en/commercial/latest/modules/identity) provides some personal data to the GDPR Module because it's the only module that can be considered as collecting personal data, such as the user's name, surname, email address, and so on. Therefore, ABP makes everything that is needed such as getting all data collected when the personal data download request has been made or deleting/anonymizing the personal data when the personal data delete request has been made.
+
+This might be enough for some of your applications and you would not need to collect any other sensitive data from a user. However, most of the time you would probably need to collect some personal data from users for certain reasons.
+
+In that case, you should provide the personal data that you collected for a certain user in your application/module or provider to the GPDR module. So, when the personal data download request has been made, the GDPR module can request the information from the different part of your application and merges the response data into a single JSON file to be downloaded. In other words, the data provided by you will be considered as personal data and whenever a user requests his/her personal data, it'll be included in the result.
+
+In the next section, we will see how to provide personal data from a different module/provider.
+
+## Providing Personal Data
+
+Let's assume that we have an e-commerce application and we need to get the address from a user to send their order. Address information is considered as personal data according to GDPR regulations. Therefore, we need to provide the address information to the GDPR Module.
+
+For this purpose, we need to subscribe to the `GdprUserDataDeletionRequestedEto` and `GdprUserDataRequestEto` distributed events. These ETOs (event transfer objects) come from the `Volo.Abp.Gdpr.Abstractions` package, which is used to start deleting/anonymizing and downloading personal data requests. `Volo.Abp.Gdpr.Domain` package is pre-installed in the domain layer and has reference to that package, so most of the time you don't need to reference to the `Volo.Abp.Gdpr.Abstractions` package.
+
+But, if you want to use these ETOs in a different project, you should add the `Volo.Abp.Gdpr.Abstractions` package. You can use the following command to add it to your project:
+
+```bash
+abp add-package Volo.Abp.Gdpr.Abstractions
+```
+
+After we have ensured that we have reference to the package, then we can create a new event handler class named `AddressGdprEventHandler` and subscribe to the `GdprUserDataDeletionRequestedEto` and `GdprUserDataRequestEto` distributed events:
+
+```csharp
+public class AddressGdprEventHandler :
+ IDistributedEventHandler,
+ IDistributedEventHandler,
+ ITransientDependency
+{
+ //inject your services
+ protected IDistributedEventBus EventBus { get; }
+
+ public AddressGdprEventHandler(IDistributedEventBus eventBus)
+ {
+ EventBus = eventBus;
+ }
+
+ public Task HandleEventAsync(GdprUserDataDeletionRequestedEto eventData)
+ {
+ //anonymize the personal data
+
+ return Task.CompletedTask;
+ }
+
+ public async Task HandleEventAsync(GdprUserDataRequestedEto eventData)
+ {
+ //assume we have retrieved the address for a certain user
+ //by querying eventData.UserId
+ var address = new Address
+ {
+ City = "Istanbul",
+ Postcode = "...",
+
+ //other properties...
+ };
+
+ var gdprDataInfo = new GdprDataInfo
+ {
+ { "City", address.City },
+ { "Postcode", address.Postcode }
+ };
+
+ await EventBus.PublishAsync(
+ new GdprUserDataPreparedEto
+ {
+ RequestId = eventData.RequestId,
+ Data = gdprDataInfo, //collected personal data
+ Provider = GetType().FullName //your module/provider name
+ });
+ }
+}
+```
+
+* Here, we have subscribed to the `GdprUserDataDeletionRequestedEto` and `GdprUserDataRequestEto` distributed events.
+* When a user made a personal data preparation request, then the `GdprUserDataRequestEto` is published by the GDPR module and the data preparation process starts. Modules/providers provide sensitive personal data by subscribing to this event and publishing a `GdprUserDataPreparedEto` distributed event, with the data and the provider information. Thanks to this, you can distinguish the personal data by the collected provider/module.
+* Then, the GDPR module subscribes to the `GdprUserDataPreparedEto` distributed events that are published by multiple modules/providers and merge the response data into a single JSON file, and the personal data can be downloaded later by the user when the data preparation is done.
+* On the other hand, when a user made a request to delete his/her personal data from the application, the `GdprUserDataDeletionRequestedEto` is published, so we can subscribe to the event and anonymize the personal data in our application.
+* Also, the Identity Pro module deletes the user's account permanently.
+
+Now, let's run the application once again and make a personal data download request. But before that, we can configure the `AbpGdprOptions` as follows to not wait for long and show our personal data result:
+
+```csharp
+Configure(options =>
+{
+ options.MinutesForDataPreparation = 5; //wait 5 minutes for data-preperation
+});
+```
+
+After we have made a personal data preparation request, we need to wait for 5 minutes for personal data to be collected and then we can download it. After 5 minutes have passed, we can see the "Download" action button for the request on the "Personal Data Management" page:
+
+
+
+Then, when we clicked the download button, a zip file will be downloaded. We can unzip the file and examine the JSON files that contain our personal data. If you have followed and applied the steps from now, you should be seeing two JSON files. One of them is for user-specific information provided by the Identity Pro module and the other one is the address information provided by us (our application-specific personal data).
+
+
+
+*Basic information for the user:*
+
+```json
+{"Username":"admin","Name":"admin","Surname":null,"Email":"admin@abp.io","Phone Number":null}
+```
+
+*Address information that we provided in this article:*
+
+```json
+{"City":"Istanbul","Postcode":"..."}
+```
+
+## Conclusion
+
+In this article, I've explained the GDPR Module's data collection system and given you a brief overview of the module. GDPR Module allows you to request to download personal data, delete/anonymize your own personal data and delete your account permanently. It's pre-installed in the Application and Application(single layer) Pro Startup templates, but you can easily configure it to your existing application.
diff --git a/docs/en/Community-Articles/2023-08-12-ABP-Commercial-GDPR-Module-Overview/cover-image.png b/docs/en/Community-Articles/2023-08-12-ABP-Commercial-GDPR-Module-Overview/cover-image.png
new file mode 100644
index 0000000000..a733b688f6
Binary files /dev/null and b/docs/en/Community-Articles/2023-08-12-ABP-Commercial-GDPR-Module-Overview/cover-image.png differ
diff --git a/docs/en/Community-Articles/2023-08-12-ABP-Commercial-GDPR-Module-Overview/gdpr-personal-data-menu.png b/docs/en/Community-Articles/2023-08-12-ABP-Commercial-GDPR-Module-Overview/gdpr-personal-data-menu.png
new file mode 100644
index 0000000000..ce92423738
Binary files /dev/null and b/docs/en/Community-Articles/2023-08-12-ABP-Commercial-GDPR-Module-Overview/gdpr-personal-data-menu.png differ
diff --git a/docs/en/Community-Articles/2023-08-12-ABP-Commercial-GDPR-Module-Overview/gdpr-personal-data-page.png b/docs/en/Community-Articles/2023-08-12-ABP-Commercial-GDPR-Module-Overview/gdpr-personal-data-page.png
new file mode 100644
index 0000000000..4b81b2645c
Binary files /dev/null and b/docs/en/Community-Articles/2023-08-12-ABP-Commercial-GDPR-Module-Overview/gdpr-personal-data-page.png differ
diff --git a/docs/en/Community-Articles/2023-08-12-ABP-Commercial-GDPR-Module-Overview/personal-data-download.png b/docs/en/Community-Articles/2023-08-12-ABP-Commercial-GDPR-Module-Overview/personal-data-download.png
new file mode 100644
index 0000000000..2371e31bed
Binary files /dev/null and b/docs/en/Community-Articles/2023-08-12-ABP-Commercial-GDPR-Module-Overview/personal-data-download.png differ
diff --git a/docs/en/Community-Articles/2023-08-12-ABP-Commercial-GDPR-Module-Overview/personal-data-files.png b/docs/en/Community-Articles/2023-08-12-ABP-Commercial-GDPR-Module-Overview/personal-data-files.png
new file mode 100644
index 0000000000..66edf52dff
Binary files /dev/null and b/docs/en/Community-Articles/2023-08-12-ABP-Commercial-GDPR-Module-Overview/personal-data-files.png differ
diff --git a/docs/en/Migration-Guides/Abp-7_4.md b/docs/en/Migration-Guides/Abp-7_4.md
new file mode 100644
index 0000000000..d34b891b66
--- /dev/null
+++ b/docs/en/Migration-Guides/Abp-7_4.md
@@ -0,0 +1,94 @@
+# ABP Version 7.4 Migration Guide
+
+This document is a guide for upgrading ABP v7.3 solutions to ABP v7.4. There are a few changes in this version that may affect your applications, please read it carefully and apply the necessary changes to your application.
+
+## Renamed the `AddGlobalFilters<>` method as `FilterQueryable<>` in `IMongoDbRepositoryFilterer`
+
+ABP Framework provides services to automatically filter data on querying from a database. Prior to this version, creating a new class that derives from the `MongoDbRepositoryFilterer` and overriding its `AddGlobalFilters` method was needed for implementing a data filter for [MongoDB](../MongoDB.md).
+
+In this version, the `AddGlobalFilters<>` method is renamed as `FilterQueryable<>`. Therefore, you need to update the method name if you have used data filtering for MongoDB, in your application.
+
+## Exposing Integration Services
+
+[Integration Services](../Integration-Services.md) are now not being exposed by default. In a monolith application, integration services don't need to be exposed outside since the modules would probably be in-process communication with each other. Therefore, they don't need to be exposed for most of the time.
+
+If you build a microservice solution or you need to access an integration service via a network call from any other application, you will probably need to expose the integration services so the other applications can consume them.
+
+To expose integration services and controllers, you can configure the `AbpAspNetCoreMvcOptions` and set the `ExposeIntegrationServices` property as *true* in the `ConfigureServices` method of your [module class](../Module-Development-Basics.md):
+
+```csharp
+Configure(options =>
+{
+ options.ExposeIntegrationServices = true;
+});
+```
+
+## `LocalizationResource` property removed from the `TemplateDefinition` class
+
+In this version, the `LocalizationResource` property was removed from the `TemplateDefinition` class and instead, the `LocalizationResourceName` property has been added.
+
+```diff
+- public Type LocalizationResource { get; set; }
++ public string LocalizationResourceName { get; set; }
+```
+
+## Changed the method signature for `ICorrelationIdProvider.Get()`
+
+Prior to this version, the `ICorrelationIdProvider.Get()` method used to return a non nullable string that represented a *correlationId* (a unique key that is used in distributed applications to trace requests across multiple services/operations). In this version, this method may return `null` if it hasn't been generated by `AbpCorrelationIdMiddleware` before.
+
+```diff
+public interface ICorrelationIdProvider
+{
+
+- [NotNull] string Get();
++ string? Get();
+
+ //other methods
+
+}
+```
+
+Therefore, if you've used this method in your application, you might want to make a null check and update the method signature where it's used.
+
+> See [#16795](https://github.com/abpframework/abp/pull/16795) for more information.
+
+## Dynamic Setting Store - Setting Management Module
+
+In this version, ABP Framework introduces Dynamic Setting Store, which is an important feature that allows us to collect and get all setting definitions from a single point. This feature requires some actions that need to be taken care of as the following:
+
+* You need to create a new migration and apply it to your database because a new database table has been added.
+* `ISettingDefinitionManager`'s sync methods have been removed and instead, asynchronous versions of the existing methods have been added.
+
+```diff
+public interface ISettingDefinitionManager
+{
+- SettingDefinition Get([NotNull] string name);
++ Task GetAsync([NotNull] string name);
+
+- IReadOnlyList GetAll();
++ Task> GetAllAsync();
+
+- SettingDefinition? GetOrNull(string name);
++ Task GetOrNullAsync([NotNull] string name);
+}
+```
+
+## `IdentityUserIntegrationService` - Identity Module
+
+In this version, ABP Framework introduces the `IdentityUserIntegrationService`, which is designed to get the current user's information, such as his/her role names within a non-authorized integration service.
+
+> For more information, see the related PR: [#16962](https://github.com/abpframework/abp/pull/16962)
+
+This is a breaking change for microservice solutions because of the following two reasons and it should be considered:
+
+* `IdentityUserIntegrationService` provides non-authorized services. This is not breaking the application, but should be taken care of. Since, everyone can use the service to retrieve some information for a certain user (for example, the role names of a user).
+* Secondly, since integration services are not exposed by default anymore as explained in the *Exposing Integration Services* section above, you should explicitly enable exposing integration services. Otherwise, the operation will fail and you'll get a `404` error from the identity microservice.
+
+To expose integration services and controllers, you can configure the `AbpAspNetCoreMvcOptions` and set the `ExposeIntegrationServices` property as *true* in the `ConfigureServices` method of your [module class](../Module-Development-Basics.md):
+
+```csharp
+Configure(options =>
+{
+ options.ExposeIntegrationServices = true;
+});
+```
diff --git a/docs/en/Migration-Guides/Index.md b/docs/en/Migration-Guides/Index.md
index c87004cfb5..88a2087ba0 100644
--- a/docs/en/Migration-Guides/Index.md
+++ b/docs/en/Migration-Guides/Index.md
@@ -2,6 +2,7 @@
The following documents explain how to migrate your existing ABP applications. We write migration documents only if you need to take an action while upgrading your solution. Otherwise, you can easily upgrade your solution using the [abp update command](../Upgrading.md).
+- [7.3 to 7.4](Abp-7_4.md)
- [7.2 to 7.3](Abp-7_3.md)
- [7.1 to 7.2](Abp-7_2.md)
- [7.0 to 7.1](Abp-7_1.md)
diff --git a/docs/en/Modules/Docs.md b/docs/en/Modules/Docs.md
index 143ec7168d..58dd811397 100644
--- a/docs/en/Modules/Docs.md
+++ b/docs/en/Modules/Docs.md
@@ -22,22 +22,16 @@ When you use GitHub to store your docs, Docs Module supports versioning. If you
## Installation
-### 1- Download
+This document covers `Entity Framework Core` provider but you can also select `MongoDB` as your database provider.
-If you do not have an existing ABP project, this step shows you how to create a new project from [abp.io](https://abp.io) to add the Docs Module. If you already have an ABP project, you can skip this step.
+### 1- Creating an application
-It is recommended to use ABP CLI to create new projects. Use the following command:
+If you do not have an existing ABP project, you can either [generate a CLI command from the get started page of the abp.io website](https://abp.io/get-started) and runs it or run the command below:
```bash
abp new Acme.MyProject
```
-You can also generate a CLI command from [get started page](https://abp.io/get-started). Enter your project name as `Acme.MyProject`, other use default options.
-
-Note that this document covers `Entity Framework Core` provider but you can also select `MongoDB` as your database provider.
-
-
-
### 2- Running The Empty Application
After you download the project, extract the ZIP file and open `Acme.MyProject.sln`. You will see that the solution consists of `Application`, `Application.Contracts`, `DbMigrator`, `Domain`, `Domain.Shared`, `EntityFrameworkCore`, `HttpApi`, `HttpApi.Client` and `Web` projects. Right click on `Acme.MyProject.Web` project and **Set as StartUp Project**.
diff --git a/docs/en/Modules/Index.md b/docs/en/Modules/Index.md
index d5037665f0..5e280268e7 100644
--- a/docs/en/Modules/Index.md
+++ b/docs/en/Modules/Index.md
@@ -4,8 +4,8 @@ ABP is a **modular application framework** which consists of dozens of **NuGet &
There are **two types of modules.** They don't have any structural difference but are categorized by functionality and purpose:
-* [**Framework modules**](https://github.com/abpframework/abp/tree/master/framework/src): These are **core modules of the framework** like caching, emailing, theming, security, serialization, validation, EF Core integration, MongoDB integration... etc. They do not have application/business functionalities but makes your daily development easier by providing common infrastructure, integration and abstractions.
-* [**Application modules**](https://github.com/abpframework/abp/tree/master/modules): These modules implement specific application/business functionalities like blogging, document management, identity management, tenant management... etc. They generally have their own entities, services, APIs and UI components.
+* [**Framework modules**](https://github.com/abpframework/abp/tree/dev/framework/src): These are **core modules of the framework** like caching, emailing, theming, security, serialization, validation, EF Core integration, MongoDB integration... etc. They do not have application/business functionalities but makes your daily development easier by providing common infrastructure, integration and abstractions.
+* [**Application modules**](https://github.com/abpframework/abp/tree/dev/modules): These modules implement specific application/business functionalities like blogging, document management, identity management, tenant management... etc. They generally have their own entities, services, APIs and UI components.
## Open Source Application Modules
@@ -29,4 +29,4 @@ See [the GitHub repository](https://github.com/abpframework/abp/tree/dev/modules
## Commercial Application Modules
-[ABP Commercial](https://commercial.abp.io/) license provides **additional pre-built application modules** on top of the ABP framework. See the [module list](https://commercial.abp.io/modules) provided by the ABP Commercial.
\ No newline at end of file
+[ABP Commercial](https://commercial.abp.io/) license provides **additional pre-built application modules** on top of the ABP framework. See the [module list](https://commercial.abp.io/modules) provided by the ABP Commercial.
diff --git a/docs/en/Modules/Setting-Management.md b/docs/en/Modules/Setting-Management.md
index 354fbdd539..e26c7c806e 100644
--- a/docs/en/Modules/Setting-Management.md
+++ b/docs/en/Modules/Setting-Management.md
@@ -177,7 +177,8 @@ public class BookStoreSettingPageContributor : ISettingPageContributor
new SettingPageGroup(
"Volo.Abp.MySettingGroup",
"MySettingGroup",
- typeof(MySettingGroupViewComponent)
+ typeof(MySettingGroupViewComponent),
+ order : 1
)
);
@@ -240,7 +241,8 @@ public class BookStoreSettingComponentContributor : ISettingComponentContributor
new SettingComponentGroup(
"Volo.Abp.MySettingGroup",
"MySettingGroup",
- typeof(MySettingGroupComponent)
+ typeof(MySettingGroupComponent),
+ order : 1
)
);
diff --git a/docs/en/Modules/Tenant-Management.md b/docs/en/Modules/Tenant-Management.md
index e12b6fc7a6..0d43c5e31e 100644
--- a/docs/en/Modules/Tenant-Management.md
+++ b/docs/en/Modules/Tenant-Management.md
@@ -48,6 +48,33 @@ The Features action opens a modal to enable/disable/set [features](../Features.m
*Manage Host features* button is used to set features for the host side, if you use the features of your application also in the host side.
+## Distributed Events
+
+This module defines the following ETOs (Event Transfer Objects) to allow you to subscribe to changes on the entities of the module;
+
+- `TenantEto` is published on changes done on an `Tenant` entity.
+
+**Example: Get notified when a new tenant has been created**
+
+```
+public class MyHandler :
+ IDistributedEventHandler>,
+ ITransientDependency
+{
+ public async Task HandleEventAsync(EntityCreatedEto eventData)
+ {
+ TenantEto tenant = eventData.Entity;
+ // TODO: ...
+ }
+}
+```
+
+
+
+`TenantEto` is configured to automatically publish the events. You should configure yourself for the others. See the [Distributed Event Bus document](https://github.com/abpframework/abp/blob/rel-7.3/docs/en/Distributed-Event-Bus.md) to learn details of the pre-defined events.
+
+> Subscribing to the distributed events is especially useful for distributed scenarios (like microservice architecture). If you are building a monolithic application, or listening events in the same process that runs the Tenant Management Module, then subscribing to the [local events](https://github.com/abpframework/abp/blob/rel-7.3/docs/en/Local-Event-Bus.md) can be more efficient and easier.
+
## Internals
This section can be used as a reference if you want to [customize](../Customizing-Application-Modules-Guide.md) this module without changing [its source code](https://github.com/abpframework/abp/tree/dev/modules/tenant-management).
diff --git a/docs/en/UI/Angular/CapsLock.directive.md b/docs/en/UI/Angular/CapsLock.directive.md
new file mode 100644
index 0000000000..64a3fc42ca
--- /dev/null
+++ b/docs/en/UI/Angular/CapsLock.directive.md
@@ -0,0 +1,80 @@
+# Caps Lock Directive
+
+In password inputs, You may want to show if Caps Lock is on. To make this even easier, you can use the `TrackCapsLockDirective` which has been exposed by the `@abp/ng.core` package.
+
+
+## Getting Started
+
+`TrackCapsLockDirective` is standalone. In order to use the `TrackCapsLockDirective` in an HTML template, import it to related module or your standalone component:
+
+**Importing to NgModule**
+```ts
+import { TrackCapsLockDirective } from '@abp/ng.core';
+
+@NgModule({
+ //...
+ declarations: [
+ ...,
+ TestComponent
+ ],
+ imports: [
+ ...,
+ TrackCapsLockDirective
+ ],
+})
+export class MyFeatureModule {}
+```
+
+## Usage
+
+The `TrackCapsLockDirective` is very easy to use. The directive's selector is **`abpCapsLock`**. By adding the `abpCapsLock` event to an element, you can track the status of Caps Lock. You can use this to warn user.
+
+See an example usage:
+
+**NgModule Component usage**
+```ts
+@Component({
+ selector: 'test-component',
+ template: `
+
+ `,
+ imports: [TrackCapsLockDirective]
+})
+export class StandaloneComponent{
+ capsLock = false;
+}
+```
+
+The `abpCapsLock` event has been added to the `` element. Press Caps Lock to activate the `TrackCapsLockDirective`.
+
+See the result:
+
+
+
+To see Caps Lock icon press Caps Lock.
+
+
diff --git a/docs/en/UI/Angular/Entity-Action-Extensions.md b/docs/en/UI/Angular/Entity-Action-Extensions.md
index 1ee0a3b70a..3ab035b04a 100644
--- a/docs/en/UI/Angular/Entity-Action-Extensions.md
+++ b/docs/en/UI/Angular/Entity-Action-Extensions.md
@@ -312,6 +312,8 @@ type EntityActionOptions = {
icon?: string,
permission?: string,
visible?: ActionPredicate,
+ btnClass?: string,
+ btnStyle?: string,
};
```
@@ -322,6 +324,8 @@ As you see, passing `action` and `text` is enough to create an entity action. He
- **icon** is the classes that define an icon to be placed before the text. (_default:_ `''`)
- **permission** is the permission context which will be used to decide if this type of grid action should be displayed to the user or not. (_default:_ `undefined`)
- **visible** is a predicate that will be used to decide if the current record should have this grid action or not. (_default:_ `() => true`)
+- **btnClass** is the classes that will be applied to the button. (_default:_ `'btn btn-primary text-center'`)
+- **btnStyle** is the styles that will be applied to the button. (_default:_ `''`)
You may find a full example below.
@@ -339,6 +343,8 @@ const options: EntityActionOptions = {
icon: 'fa fa-unlock',
permission: 'AbpIdentity.Users.Update',
visible: data => data.record.isLockedOut,
+ btnClass:'btn btn-warning text-center',
+ btnStyle: '', //Adds inline style
};
const action = new EntityAction(options);
diff --git a/docs/en/UI/Angular/Internet-Connection-Service.md b/docs/en/UI/Angular/Internet-Connection-Service.md
new file mode 100644
index 0000000000..d9002b660e
--- /dev/null
+++ b/docs/en/UI/Angular/Internet-Connection-Service.md
@@ -0,0 +1,30 @@
+# Internet Connection Service
+`InternetConnectionService` is a service which is exposed by the `@abp/ng.core` package. **You can use this service in order to check your internet connection**
+
+## Getting Started
+When you inject the InternetConnectionService you can get the current internet status, and it gets immediately updated if the status changes.
+
+`InternetConnectionService` provides two choices to catch the network status:
+1. Signal (readonly)
+2. Observable
+
+
+# How To Use
+İt's easy, just inject the service and get the network status.
+
+**You can get via signal**
+```ts
+class SomeComponent{
+ internetConnectionService = inject(InternetConnectionService);
+ isOnline = this.internetConnectionService.networkStatus
+}
+```
+**or you can get the observable**
+```ts
+class SomeComponent{
+ internetConnectionService = inject(InternetConnectionService);
+ isOnline = this.internetConnectionService.networkStatus$
+}
+```
+
+To see how we implement to the template, check the `InternetConnectionStatusComponent`
diff --git a/docs/en/UI/Angular/Show-Password-Directive.md b/docs/en/UI/Angular/Show-Password-Directive.md
new file mode 100644
index 0000000000..c19c8073bd
--- /dev/null
+++ b/docs/en/UI/Angular/Show-Password-Directive.md
@@ -0,0 +1,77 @@
+# Show Password Directive
+
+In password input, text can be shown easily via changing input type attribute to `text`. To make this even easier, you can use the `ShowPasswordDirective` which has been exposed by the `@abp/ng.core` package.
+
+
+## Getting Started
+`ShowPasswordDirective` is standalone. In order to use the `ShowPasswordDirective` in an HTML template, import it to related module or your standalone component:
+
+**Importing to NgModule**
+```ts
+import { ShowPasswordDirective } from '@abp/ng.core';
+
+@NgModule({
+ //...
+ declarations: [
+ ...,
+ TestComponent
+ ],
+ imports: [
+ ...,
+ ShowPasswordDirective
+ ],
+})
+export class MyFeatureModule {}
+```
+
+## Usage
+
+The `ShowPasswordDirective` is very easy to use. The directive's selector is **`abpShowPassword`**. By adding the `abpShowPassword` attribute to an input element, you can activate the `ShowPasswordDirective` for the input element.
+
+See an example usage:
+
+**NgModule Component usage**
+```ts
+@Component({
+ selector: 'test-component',
+ template: `
+