Changelog

[v2.6.2] - 2026.11.05

Features

  • Multi-tenant data isolation and per-tenant scheduled jobs: IFreeSql is now a tenant-aware scoped proxy, so repositories, units of work and background logging read and write the tenant database; [Scheduler] jobs gain TenantScope, running once per enabled tenant by default, while host-level jobs can opt out explicitly; tenant menus exclude only host-level pages by Path (tenant management, error logs, task scheduler), keeping menu management and data dictionaries assignable
  • CMS EnableComments switch (off by default): when off, no comment table is created, no comment moderation menu appears, and writes fail fast; existing comments and permission grants are kept and restored when re-enabled
  • Advanced-search "unset" handled by the framework: empty strings and -1 are no longer treated as filters, so optional columns no longer need an "All" placeholder; a new select supports nullable enums

Bug Fixes

  • Full tenant isolation for chat and internal messages: chat broadcasts, direct messages, connect/disconnect notifications, online status, and real-time internal/system notifications are all routed by the tenant code in the login ticket instead of global connections or global Redis keys; the same user id in different tenants no longer leaks messages to each other. Notification group names change from user_{userId} to tenant_{tenantCode}_user_{userId}, and NotificationHub.GetUserGroup becomes GetUserGroup(string tenantCode, long userId); host code that calls it to push messages must pass the tenant code (usually AdminContext.TenantCode). Requires EasyAdminBlazor.Chat 2.6.2 and EasyAdminBlazor.MultiTenant 2.6.2
  • The main database connection was recycled after 3 minutes idle in multi-tenant mode: FreeSqlCloud recycles idle instances by default, and once the main ORM was recycled, main-database accesses such as login and tenant resolution all threw ObjectPool has been disposed. The main instance is now registered to never be recycled, while tenant databases still use the default policy (EasyAdminBlazor.MultiTenant 2.6.2)
  • Saving a tenant on SQLite failed with database is locked: the join-table DDL ran inside a transaction; the join table is now created during initialization
  • Rows whose parent is filtered out no longer disappear from tree lists: such rows are attached to the root level, keeping paging and the total count unchanged

Documentation

  • Development conventions and the corporate-site generation workflow were merged into a single project skill (.github/skills/easyadminblazor-dev) with the pitfalls checklist and templates;

[v2.6.1] - 2026.10.26

Bug Fixes

  • Fixed the online user count being over- or under-counted when a connection lifecycle callback and a page binding race
  • Fixed list button parameters taking effect only on the first render, ignoring later dynamic changes from the parent
  • Fixed large column flags on second-level navigation being missed when an intermediate entity has no flags
  • Split the NuGet package licenses: LICENSE for free use, LICENSE-SOURCE for commercial source-code licensing
  • verify-packages.ps1 now supports four-part versions and checks every assembly under lib/ and ref/

Documentation

  • Corrected the KeepOriginalFile, multi-tenant database mode and admin route secret examples

[v2.6.0] - 2026.10.25

Breaking changes

  • The controlled download of private files has been removed: the /api/files/{id} endpoint and the FileService.OpenPrivateFileAsync method are gone; files are served from their static URL. Check whether your own code references any of these members before upgrading (none of the framework's built-in extension packages do -- every one of them has been checked). The reason for removing it: uploaded files live under wwwroot and are reachable statically anyway, so the switch never actually protected anything. The access URL of a file record is still available through SysFile.AccessUrl. The SysFile.IsPublic field stays on the entity but no longer takes part in any decision

Features

  • Light query for list pages: on a remote database (cloud database, cross-datacenter link) the default SELECT * pulls every large column (longtext / blob) of the entity and of every included navigation entity back to the server, so a single page of a few dozen rows can transfer several megabytes and take more than ten seconds, while the list usually needs only a few dozen ordinary columns. Calling e.Select.LightQuery() in OnBeforeQuery makes the list load only the columns it really needs: the main table selects non-large columns only, navigation objects are batched and loaded by foreign key (also without large columns), and existing Where / OrderBy / Include calls stay exactly as they are; use e.Select.IncludeLargeColumns(x => x.Remark) to opt a large column back in. Disabled by default -- other projects behave exactly as before
  • Large column flags: when a page only needs to know whether a large column has a value (or how long it is) and not the body itself, add a flag property to the entity ([Column(IsIgnore = true)] public bool? IsRemark { get; set; }, or {Column}Length for the length, or [LargeColumnFlag("Column")] to state the source column explicitly). Light query computes it in SQL (Review IS NOT NULL AND Review <> ''), the normal query computes it in memory -- both modes produce exactly the same result -- and flags declared on navigation entities work as well
  • The edit dialog re-fetches the complete row by primary key: with light query the list rows no longer carry large columns, so the complete row is re-fetched by primary key before the dialog opens; the large columns in the form are still complete, so saving cannot write unloaded fields as null
  • A "Get Source Code" entry in the admin header: controlled by ShowSourceLink (default true); projects with a source license can set it to false in AddEasyAdminBlazor
  • The copyright text in the footer and on the login page no longer includes "All rights reserved."
  • NuGet package pages now include the project site and licenses: project URL, icon, tags and release notes were added, and the package ships the free-use license (LICENSE) and the source code commercial license (LICENSE-SOURCE)
  • New "Security Configuration" document: covers 11 security settings including upload size, redirect limit, login lockout, CSRF, host allow-list, rate limiting and external call timeout

Bug Fixes

  • The online user count no longer only goes up: now based on browser connections, reduced quickly after a normal disconnect (an abnormal network loss depends on SignalR's disconnect detection)
  • The loading overlay no longer stays forever when a list query fails
  • List permission gating and recycle-bin mode are no longer overwritten by parent component parameters
  • The "is null / is not null" filters no longer throw
  • Large column flags: type, source path and naming convention fixed
  • Converted WebP files no longer overwrite existing files
  • Keep-original mode no longer leaves unreferenced WebP files: with KeepOriginalFile=true a non-WebP original is kept as-is, without conversion or resizing, so no orphan .webp file is produced (oversized WebP originals are still resized and re-encoded)
  • Image decoding now has a pixel limit: new setting FileSettings:MaxImagePixels
  • Windows reserved device names no longer crash "new group"
  • A malformed User-Agent no longer crashes the login
  • Local redirects can no longer be bypassed with a TAB character
  • The antiforgery cookie now carries the Secure attribute
  • Approval revocation is no longer permanently blocked by an earlier round
  • Changing the approval flow no longer leaves bills in flight stuck "under approval": a bill follows the level count it was submitted with (new SysApprovalRecord.TotalLevels)
  • Custom cron expressions of scheduled jobs are resolved in the scheduler's time zone: no more 8-hour offset
  • An invalid [Scheduler] cron no longer runs every 5 seconds: it never enters the scheduler
  • A paused scheduled job no longer comes back to life after a restart
  • ISchedulerService.FindTask no longer throws
  • Excel import can no longer bypass the "edit" permission: rows that would update an existing record require edit
  • Objects and collections replaced in OnBeforeImportAsync / OnBeforeSaveAsync are no longer ignored
  • Enabling the import button no longer wipes the page's own toolbar
  • The exported file no longer has fewer columns than the table
  • The message center no longer requires the Redis extension: the admin menu and the notification icon in the top right both used to require IRedisService to be registered, so turning on EnableMessage without the Redis extension hid the message center menu and redirected Admin/Message back to the home page. The message center itself only needs the database and SignalR (NotificationHub already replaced the former Redis Pub/Sub solution); Redis is only used to persist cached chat messages. The switch now only looks at EnableMessage -- projects that do use Redis are unaffected
  • Column name ambiguity in ORDER BY under light query: after the column trimming the sorted column is no longer part of the SELECT list, so a bare column name in ORDER BY (e.g. ORDER BY createdtime desc) loses its unique target and raises Column 'createdtime' in order clause is ambiguous as soon as the query joins a table with the same column name. Light query now translates sorting into table-qualified column sorting (table alias plus column name), keeping the sorting semantics identical to the normal query (the page's own OrderBy → SortList → SortName)
  • The WeChat extension's rate limit settings are no longer dead letters: Security:RateLimitPermitLimit and Security:RateLimitWindow were never read by any code (the thresholds were hard-coded, so changing the configuration had no effect). Both options now really take part in the calculation, and they can only tighten -- never loosen -- an endpoint's own threshold. The default behaviour is exactly the same as before

[v2.5.1] - 2026.10.23

Bug Fixes

  • The draft countdown stopped working: after the AdminTable refactor the draft callbacks were only wrapped when the page supplied its own callback. Without a page callback the parameter and the wrapper instance were both null, so the reference-equality check wrongly reported "already wrapped" and the default wrapper was never installed -- draft auto-save and the countdown stopped working silently

[v2.5.0] - 2026.10.23

Bug Fixes

  • The header is dark again in dark mode -- ant.css no longer paints the header and logo area with the primary color unconditionally; the dark theme falls back to the dark header variables and the primary color only applies to the light header
  • The header theme-color button is no longer a solid blue block -- the dropdown toggle now uses a transparent background with the header foreground color, and a semi-transparent white highlight on hover/open, matching the light/dark mode button
  • The admin home and login redirect now both use /Admin/ -- the trailing slash is added so the route resolves the same way from every entry point
  • AdminSelectEntity no longer renders blank on first render -- Items are now loaded in SetParametersAsync before the base initialization runs, removing the race where a cache miss rendered one frame with an empty list and left the selected item text permanently empty
  • The role permission tree can now express read-only roles -- the menu permission tree no longer relies on the component library's default parent/child cascading and instead uses the framework's own rules: unchecking the buttons of a menu keeps the menu page and its group checked (so read-only roles such as viewers or report staff can be configured); this also fixes the bug where opening a read-only role for editing recomputed the saved menu permissions as unchecked and wiped them on save

Features

  • New carbon.css theme -- a Carbon-inspired palette (dark header, low-saturation surfaces), opt-in from the host project and disabled in the Demo by default
  • New approval failure message extension point IApprovalFailureMessageProvider (Core contract layer): when approval processing fails the framework first asks the message hook registered by the business module; on a match the readable message is exposed (still with a TraceId for troubleshooting), otherwise the generic message is used; behavior is exactly as before when no hook is registered
  • New approval post-action hook IApprovalPostAction (Core contract layer): business writes (such as inventory posting) run inside the very same transaction at the moment the approval is granted, so a business module only has to implement the hook; behavior is unchanged when no hook is registered. AdminTable also auto-submits an approval after saving, and documents under approval are no longer editable or deletable

[v2.5.0-beta.1] - 2026.10.21

Bug Fixes

  • Uploaded files no longer store an empty Md5 -- the hash is now computed from the final file on disk (image compression may convert to WebP, so the written file is what gets hashed) as 32 uppercase hex characters, matching the format used for remote images
  • FileService.IncludeExtension is no longer overwritten per instance -- the property is shared by every instance (AdminFilePicker and the File page read it statically), so it is now initialized once at registration time by AddFileService; scoped instances no longer write shared state
  • AdminTable ignored search columns now follow parameter changes -- the columns are re-extracted when IgnoreSearchColumns changes instead of reusing the result of the first call
  • Excel import no longer fails on SQLite because of UpdateColumns

Localization

  • Extensions can ship their own language files: Locales/zh.json and Locales/en.json are distributed with the extension assembly; CMS is already wired up and registration is unified in the framework
  • Reconnection prompts in the admin UI support Chinese and English (EasyAdminReconnector)
  • The upgrade extension (EasyAdminBlazor.Upgrade) supports Chinese and English

Features and Compatibility

  • Reconnection handling is delegated back to BootstrapBlazor: adminblazor.js keeps only the upgrade logic, so hosts without the upgrade extension no longer see a false "connection interrupted" message
  • The upgrade overlay keeps a fixed message: the title stays "Upgrading the application, please wait..." during the whole upgrade instead of cycling through stage texts; the "updater not responding" troubleshooting hint is retained; rollback misjudgement fixed, upgrade host and setsid lookup unified
  • easyadmin-frontend / easyadmin-conventions skills synced with the Cms module: the corporate template is now CMS-driven ([CmsPage] page definitions, vc:textblock copy blocks, CmsData sample seed, slug routing with legacy-id compatibility); conventions add extension-development rules and front-office content selection; doc/AI Assistant Configuration updated in both languages
  • CMS-related content added to the docs: How to Build Your Own Extension grows to seven extension points (adding operation-log parameter redaction IOperationLogParameterRedactor) and lists Cms in the reference table; README index, Project Overview, Starting a New Module (with a "catalog content needs no entity" note), and the FAQ (login-state retention premise) updated in both languages; Application Online Upgrade gains a troubleshooting table in the Chinese edition
  • How to Build Your Own Extension now provisions menus with the framework's MenuProvisioning: EnsureMenuAsync / EnsureButtonsAsync create the menu and its button permissions idempotently, replacing the hand-written "select then insert" code (same pattern as the Scheduler, Approval, Print, MultiTenant and CodeGenerator extensions)
  • Mail providers split apart: mail settings are read per group (backward compatible with the old layout) and static state was removed from the security configuration
  • Redis writes use FreeRedis native async APIs
  • WeChat rate limiting uses the built-in .NET sliding window limiter
  • The Print extension reuses the main project's TopN SQL generation

Refactoring and Code Quality

  • Large files split into partials by responsibility: AdminTable, ApprovalService, AdminContext, FileService, WeChat, FreeSqlExtensions and more
  • The 12 AdminExtensions partials merged into 3 (registration entry point / infrastructure / web and business), with line-by-line comments for the 19 registration steps
  • Duplicated implementations consolidated: login ticket parsing and validation, column name resolution via strongly typed ColumnAttribute, and AdminTable save/write-permission checks
  • Dead code and redundant locals removed, including unused conversion and reflection helpers in the extensions

[v2.4.2] - 2026.10.18

  • Added the EasyAdminBlazor.Cms extension: declare content types and pages with [CmsPage] / [CmsDataType]; table sync, admin menus and field configuration are provisioned automatically, Doc
  • The extension covers content, categories, page elements, SEO and comments: supports Live Edit, comment submission and moderation, detail lookup by ID or Slug, and a unified front-end submission service
  • Improved database compatibility and performance: custom-field filtering now supports SQLite; lists skip article bodies by default, can load them on demand, and remain stable across pages by sorting on the requested order plus ID
  • Upgraded BootstrapBlazor to 11.0.1
  • Fixed the upload/delete buttons disappearing in the file picker -- AdminFilePicker checked permissions before the authentication state was ready; with a slow remote database admin.User was still null, so the buttons were hidden as "no permission"
  • Fixed page-level upgrade polling running before the footer rendered, which made it ineffective

[v2.4.1] - 2026.10.15

  • Updated vulnerable SignalR packages
  • UseEasyAdminBlazor now supports custom ServerComponentsEndpointOptions

[v2.4.0] - 2026.10.10

Upgrade Notes (Upgrading from 2.3.x / 2.4.0-preview)

  • Program.cs must be changed to app.UseEasyAdminBlazor<App>();: Pass the host's own App component (Components/App.razor) as TApp. The framework will automatically add registered extension assemblies to Razor component routing. Hosts should no longer write app.MapRazorComponents<App>().AddAdditionalAssemblies(...), otherwise duplicate mappings will occur.
  • Components/Routes.razor's AdditionalAssemblies should now be read from configuration:
@using System.Reflection

<Router AppAssembly="@typeof(Program).Assembly" AdditionalAssemblies="@AdditionalAssemblies">
    <Found Context="routeData">
        <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
    </Found>
</Router>

@code {
    private IEnumerable<Assembly> AdditionalAssemblies =>
        AdminOptions.Value.Assemblies ?? [];
}

Optional Features Moved to Extensions (New Print and Code Generator Extensions)

  • New EasyAdminBlazor.Print extension: Print templates, report designer, and print implementation (PrintTemplate / ReportDesignerEditTemplate / IPrintService / PrintServiceImpl / report-designer*.js) have been moved from the framework into this extension. The framework only retains a compatibility facade PrintService. If the extension is not referenced, there is no print functionality.
  • New EasyAdminBlazor.CodeGenerator extension: The code generation page CrudGenerator has been moved from the framework into this extension.
  • Pages now ship with their respective extensions: Pages such as TaskScheduler, Tenant, and ApprovalTodo have been moved to the EasyAdminBlazor.Scheduler / MultiTenant / Approval extensions respectively. ErrorLogCleanupJob has also been moved to the Scheduler extension.
  • Unified extension initialization mechanism: Added IExtensionInitializer (Core) and ExtensionInitializerHostedService (Framework). Extensions register their own assemblies and initializers via AddEasyAdminBlazorAssembly(). Menus and seed data are automatically initialized at startup.
  • UseEasyAdminBlazor<TApp>() is now generic: Automatically adds registered extension assemblies to MapRazorComponents().AddAdditionalAssemblies(...). Extension pages no longer need to be manually registered by the host.

Bug Fixes

  • No more persistent "Connection Interrupted" message when the Upgrade extension is not referenced: adminblazor.js no longer takes over connection and reconnection prompts when there is no upgrade version marker (i.e., EasyAdminBlazor.Upgrade is not installed), handing control back to Blazor. This fixes the issue where the login page and admin pages would persistently display "The connection to the server has been interrupted, reconnecting... (The application is restarting, please wait. It will resume automatically once restored)."
  • Pages without permission no longer redirect to the login page.

Other

  • License update: LICENSE has been replaced with the EasyAdminBlazor Commercial Software License Agreement.
  • Framework, Core, all extensions, and documentation are unified at 2.4.0.

Dependency Upgrades and Compatibility Adaptations

  • Complete removal of SixLabors; image processing and CAPTCHA unified on SkiaSharp: The framework no longer references SixLabors.ImageSharp. FileService's image format validation (IsImageByImageSharp → IsImageBySkiaSharp), width/height reading, oversized proportional scaling (max width 1600), and WebP conversion are all implemented with SkiaSharp. Source code customers will no longer trigger Six Labors License prompts during restore/build. Added SkiaSharp and SkiaSharp.NativeAssets.Linux.NoDependencies (no need to install fontconfig on Linux hosts).
  • Upgraded BootstrapBlazor 10.9.2 → 10.10.2 (synchronized between the framework and the EasyAdminBlazor.Upgrade extension; BootstrapBlazor.TableExport 10.0.2 → 10.0.3).
  • Form validation changed to async: EditContext.Validate() is obsolete. The framework has uniformly switched to await EditContext.ValidateAsync() (EditContextCapture.ValidateAsync(), profile saving, password change, AdminTable add/edit pre-save validation). Validation behavior and prompts remain unchanged.
  • Extensions dependencies upgraded synchronously: SkiaSharp 3.119.4, Microsoft.AspNetCore.SignalR.Client 10.0.12, Microsoft.AspNetCore.SignalR 1.2.13, MailKit 4.18.1, FreeScheduler 2.1.5, ZiggyCreatures.FusionCache 2.9.0, AlibabaCloud.SDK.Dysmsapi20180501 1.0.11, System.Security.Cryptography.Pkcs 10.0.12.
  • Host and test project dependencies upgraded synchronously: Microsoft.Extensions.Hosting.WindowsServices / Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation 10.0.12; Microsoft.NET.Test.Sdk 18.10.1, xunit.runner.visualstudio 4.0.0, FluentAssertions 8.11.0, Moq 4.21.0, coverlet.collector 10.1.0.

In-App Online Upgrade (Provided as the Independent Extension EasyAdminBlazor.Upgrade)

  • Application version and framework version completely separated: The application version comes from the host csproj's <Version> (release version = application version). The framework version is read independently via EasyAdminBlazorVersion. Specifying the application version with -p:Version in the host will no longer affect the framework version. The footer displays Powered by EasyAdminBlazor v2.4.0-preview.4 · App v1.1 · Check for Updates.
  • Admin "Check for Updates" entry: No new menu/page is added; it reuses the existing dialog and checks on open. Displays current version, latest version, release notes, and upgrade package size. Only administrators can perform upgrades.
  • Version-by-version incremental upgrade: Upgrade packages are chained by previousVersion (1.0 → 1.1 → 1.2). When a customer is several versions behind, upgrades are automatically applied in sequence without manually skipping versions.
  • Packages generated on publish: Publishing once in Release configuration automatically produces incremental packages in the publish directory updates/v<version>/ (update.zip + release.json + files.json + updated index.json). The previous version is automatically identified. Release notes are written to release-notes.txt in the project root.
  • Two publish sources: Local publish directory (intranet/private deployment, manual package copy) and HTTPS publish index (customers upgrade themselves).
  • Zero risk to customer data: wwwroot/uploads, logs, DataProtection keys, updates, appsettings*.json, and database files are never written to or deleted. Deletion entries must have matching hashes. Backups only cover files about to be overwritten.
  • Security and concurrency: Triple verification via package SHA256, in-package file hashes, and baseline hashes. ZIP path traversal / absolute paths / symbolic links are all rejected. Only one upgrade task is allowed per application at a time.
  • Failure rolls back only the current step and guarantees the application is brought back up (with multiple layers of fallback). Successfully completed steps are retained.
  • Upgrade process visualization: After clicking "Upgrade Now," a full-screen overlay is displayed (unaffected by the application stopping or the connection dropping). During rolling upgrades, it shows "Step x/y, updating to vN." After health checks confirm the target version, it displays "Upgrade Complete" and automatically refreshes after a 3-second countdown. Users do not need to log in again.
  • Online user statistics: Added IOnlineUserCount (Count for online user count, UserIds for the list of online user IDs, deduplicated by user). The upgrade confirmation dialog will indicate the current number of online users.
  • Deployment adaptation: RestartMode supports Direct (self-hosted/BT Panel/systemd), WindowsService, Systemd, and External. The upgrade entry is automatically disabled when hosted in-process by IIS.
  • Provided as an independent extension: Upgrade capability is only available when EasyAdminBlazor.Upgrade is referenced. If not referenced, the footer, /health, and publish hooks do not exist, and the behavior of old projects remains completely unchanged. Supports NuGet package references (publish hooks take effect automatically within the package; pure NuGet can also generate packages automatically) and source code references.
  • For detailed instructions, see Application Upgrade.

[v2.3.2] - 2026.10.01

Security Hardening

  • Login ticket upgraded to v2: the ticket now binds the issuing tenant and carries an issued-at timestamp, validated server-side against TicketLifetime; the legacy v1 payload is treated as signed-out (a one-time re-login is expected after upgrading). NotificationHub / ChatHub no longer accept a ticket based on user id alone without checking tenant and expiry
  • Host whitelist: new Security:AllowedHosts; when multi-tenant resolves the tenant from the request Host, the Host is checked against the whitelist first to stop Host-header spoofing. Empty means unrestricted (previous behaviour); *.example.com is supported
  • Login lockout wired to configuration: Security:LoginFailureLimit / LoginLockout now take effect (default 5 attempts / 10 minutes), reserve the attempt before evaluating it, and key the lock on both IP and account so concurrent logins cannot widen the quota; enforcement happens server-side instead of only on the login page
  • Server-side forced-password-change guard: ForcePasswordChange is enforced on all server-side write entry points (add/edit/delete/import), so the default-password account cannot write data before changing its password
  • DatabaseLogger user attribution fixed: the logger resolves user/tenant from the current request/circuit identity and request scope, removing the captive dependency; SysLog carries UserId / TenantCode again
  • AesKey actually takes effect: AesKey now derives the Data Protection ApplicationName and participates in cookie/ticket key isolation; changing it invalidates existing sessions, as documented

Engineering

  • Transaction boundary for generic writes: add/edit/delete/import in AdminTable now use UnitOfWorkManager + Binding (the same pattern as ApprovalService) and roll back as a whole on failure
  • CI and build gate: GitHub Actions (build + test), Directory.Build.props and .editorconfig centralise shared configuration and turn warnings into errors (all historical nullable warnings are cleared, with no exclusions)
  • Maintainability: extracted the export feature from AdminTable.razor into a partial; renamed EasyAdminBlazor.Test to EasyAdminBlazor.Demo
  • Menu management hides button nodes by default: /Admin/Menu no longer shows button-type nodes by default; tick "Show buttons" in the toolbar when needed
  • Operation log records change details (DiffPlex highlighting for long text): update operations capture the previous row before writing and store field changes structurally; short fields render as "old → new" and long text gets word/character-level inline highlighting via DiffPlex with no truncation (very large text degrades to whole-block comparison but stays complete); collection columns ([JsonMap] etc.) are compared by content and rendered as JSON; saves with no actual change produce no log entry; audit fields are skipped and [JsonIgnore] sensitive fields (such as passwords) are logged as "(changed)" only
  • Failed operations record the reason: failures returned from inside a method (save exceptions, permission/data-permission rejections, approval locks, forced-password-change blocks, etc.) now write the failure reason as well; when no specific reason is available a placeholder is stored so the column is never empty
  • Change history in the edit dialog: AdminTable adds a "Change history" button at the bottom-left of the edit dialog; it queries the operation log by EntityType + EntityKey and renders the diff with DiffPlex. The entry point follows the same rules as editing (button permission + data permission) and only appears for records that already exist. SysOperationLog gains EntityType/EntityKey columns plus the idx_operationlog_entity index (legacy rows have them empty and therefore do not appear in per-record history)
  • "Save without closing" keeps the dialog open and works with cascade saves: the dialog is no longer closed and reopened after saving, the draft timer restarts in place, and subsequent saves of a newly created record are treated as updates; the current model (including child collections) is re-attached after saving so existing children are not inserted again during cascade saves
  • Recycle bin (restore / permanently delete soft-deleted rows): entities with soft delete get a "Recycle bin" toggle right after the delete button in the toolbar; inside it only deleted rows are listed (the global soft-delete filter is temporarily disabled) and rows can be restored or permanently deleted individually or in bulk after confirmation. It reuses the delete permission and is hidden for entities without soft delete
  • Fixed the task scheduler "Next run" column header: it was mistakenly bound to Topic, so the header read "Title" while the cell showed a date; it now binds to NextRunTime

[v2.3.1] - 2026.09.19

Bug Fixes

  • File upload no longer blocked with 401: removed the [Authorize] attribute layered onto FileUploadController. The framework's login state is a custom encrypted cookie rather than a standard ASP.NET Core authentication scheme, so the attribute made requests validate against the default authentication scheme before reaching the controller - when a host application uses its own site-user cookie as the default scheme, administrators were rejected with 401 and the IsLogin() check inside the controller never ran. Login is now decided solely by IsLogin(), returning 401 when not signed in.
  • Editor "save remote images" CSRF failure fixed: the editor now fetches an Antiforgery token and sends it in the request header before every write (the header name comes from the server instead of being hard-coded), retrying once with a refreshed token on failure. A failed token fetch is logged to the console instead of failing silently.

[v2.3.0] - 2026.09.17

Security Hardening

  • Notification hub privilege escalation fixed: NotificationHub now requires authentication, and a user is only added to the group resolved from the server-side identity; the client-controllable JoinGroup / LeaveGroup methods were removed and the client now connects with a signed ticket
  • CSRF protection for HtmlEditor uploads: upload and remote-image endpoints now require authentication and an Antiforgery token, returning 400 instead of 500 on failure; the editor sends the token via the X-CSRF-TOKEN header
  • SSRF hardening for remote images: automatic redirects are disabled and every hop is re-validated (max 3, no HTTPS downgrade); a connect callback pins the validated IP to prevent DNS rebinding; responses are streamed to disk instead of buffered in memory
  • Data permission for Excel import: import, batch update and batch delete all run through the data-permission check, so forged primary keys can no longer touch other users' data
  • Private file download: a gated endpoint /api/files/{id} verifies login, tenant, file record and authorization; public files keep the existing static URL behaviour
  • Path safety: a unified safe-path service performs root containment checks for code generation, upload, download and template paths, plus a whitelist for generated route paths
  • Login ticket authentication: a new authentication handler lets [Authorize] recognise the framework's existing encrypted-cookie login state

Multi-Tenant Isolation

  • No more secondary container: the multi-tenant extension no longer calls BuildServiceProvider(); FreeSqlCloud is registered through a service-provider factory
  • Concurrency-safe tenant creation: initialisation for the same tenant is serialised so concurrent requests cannot create the same database and tables twice
  • Tenant code whitelist: tenant codes are validated before they can reach database names, file paths or cache keys
  • Cache and Redis isolation: system config, permission, select/tree/dictionary caches and chat Redis keys all carry the tenant prefix, so tenants no longer share business caches or locks

Approval Consistency

  • Transactional: submit, approve, reject, revoke and transfer all run inside a database transaction and roll back as a whole on any failure, eliminating half-applied state
  • Concurrency protection: every state change is a conditional update, so concurrent approve/transfer/revoke can only succeed once and cannot advance a node twice or duplicate approval records
  • Notification timing: in-app messages and real-time pushes are sent after the transaction commits; a failed commit never notifies success
  • Server authority: approver, current node, next node and level are all derived by the server from the flow configuration; clients cannot specify them or skip nodes
  • Transfer eligibility: the transfer target must belong to the current tenant and be enabled, and transferring to the submitter is rejected
  • XSS-safe comments: approval comments are stored as plain text with HTML entity encoding and are length-limited
  • Flow configuration validation: level continuity, approver source validity and the node-count cap are validated on load; invalid configuration is refused
  • Error message containment: failures return a generic message plus a TraceId, with details written to the log only
  • Audit fields: approval records now capture the operator, before/after status and the flow instance identifier, making transfers and revocations fully traceable

Bug Fixes

  • Duplicate bell notifications: fixed the same message being inserted twice when the database unread list and the SignalR push arrived together
  • PBKDF2 parameters upgraded: hashes now carry a version and iteration count; existing passwords still work and are transparently re-hashed after a successful login
  • Semantic upload status codes: 401 unauthenticated, 403 forbidden, 400 bad request, 413 too large, 415 unsupported type instead of always returning 500
  • Two-layer upload size limit: the 10 MB limit is enforced both while parsing HTTP and in the business layer
  • WeChat anonymous endpoint protection: login, decrypt and mini-program QR endpoints now validate parameters and apply rate limiting and timeouts, and no longer leak upstream error details
  • Database logger back-pressure: a bounded queue with exponential backoff and recovery replay, plus TraceId, request path, user and tenant fields
  • Synchronous blocking removed: GetAwaiter().GetResult() and similar sync-over-async waits were eliminated
  • Configurable scheduler time zone: the time zone is no longer hard-coded and keeps the previous China time-zone behaviour by default
  • Snowflake startup validation: the worker id stays 6-bit and out-of-range values fail fast with guidance for multi-instance deployments

New Features

  • Unified security options: a new Security configuration section centralises upload size, redirect count, login lockout, CSRF and rate-limit settings, with a documented example
  • Global exception handling: API exceptions are converted into a friendly message plus a TraceId, with details written to the log only

[v2.2.18] - 2026.09.08

New Features

  • Stay on the current page after save: editing existing data no longer jumps back to page one after saving; only new records return to the first page (consistent for "Save and Close" and "Save without Close")
  • Database migration guide: a new document explains how to switch from SQLite to MySQL / SQL Server / PostgreSQL or other FreeSql-supported databases
  • Serilog file logging guide: a new document shows how to add file logging with Serilog while keeping the framework's database logger (writeToProviders: true)

Bug Fixes

  • File upload prompt fixed: any upload exception (disk/permission/image/database, etc.) is now converted into a clear "Upload failed" message, and the upload dialog auto-closes after 60 seconds so the "Uploading." prompt can never get stuck
  • Chat "The operation was canceled" error fixed: fixed the cancellation/disposal errors thrown by the SignalR connection and online-presence maintenance in the chat extension
  • Chat/notification self-connect fixed under strict auth: notifications and chat previously self-connected using the public URL, which failed (all connections down, chat stuck offline, page reload loops) under strong auth (HttpOnly cookie), reverse proxies or LAN-IP access; they now connect to the Kestrel listening address, and a failed connection only degrades those features instead of breaking the page or circuit
  • Null-safe menu path filtering: admin menu filtering now guards against a null PathLower to avoid layout crashes
  • Generated page row layout fixed: generated edit fields are now wrapped in a row form-inline container even when there are few fields
  • MailKit upgraded: the Mail extension explicitly references MailKit 4.17.0 to avoid transitive dependency conflicts with NETCore.MailKit

[v2.2.17] - 2026.08.30

New Features

  • Save button loading in edit dialogs: clicking either "Save" or "Save and Close" in add/edit dialogs now puts both buttons into a loading state and disables them, automatically recovering on errors (including exceptions) and preventing duplicate submissions
  • Table shows loading while querying: AdminTable no longer flashes "No data" while a query is in flight; a loading indicator is shown until the query completes, then data or the empty state is displayed
  • Much faster export: AdminTable export now projects only the table's visible columns (dynamic DTO projection) instead of SELECT *, skips Include/IncludeMany navigation loading during export (new IsExport flag on the query event), and writes Excel directly via MiniExcel with per-column lookup caching; for remote databases, exporting thousands of rows drops from minutes to seconds and the file contains only clean, visible columns
  • Instant export feedback: a non-blocking "Exporting." badge appears in the table toolbar immediately on click (server-side state driven, pure CSS) and auto-dismisses when done or on error
  • Data Protection key persistence: new DataProtectionKeyPath / DataProtectionApplicationName options persist the auth-cookie encryption keys to a fixed directory with a stable application name, so users stay logged in across IIS app pool restarts

Bug Fixes

  • Solution build fixed: EasyAdminBlazor.AliyunSms now targets net10.0 instead of net9.0, which broke the whole solution build; all project versions are unified
  • Message center connection leak fixed: the Widget component now overrides DisposeAsync(bool) to release its SignalR connection when the component is disposed
  • AdminTable permission wrapping fixed: internal default save/delete handlers are no longer double-wrapped on re-render (the old method-group comparison always returned false)
  • Enable/disable toggles made reliable: user, menu and org toggles now await the database write and roll back the UI state with an error toast on failure
  • Redis message persistence hardened: entries that fail JSON deserialization are no longer passed to the database writer
  • WeChat Pay certificate loading modernized: X509CertificateLoader replaces the obsolete X509Certificate2 constructors; a missing platform certificate now logs a clear error
  • "Cannot match Roles" user role search fixed: ignored search columns are now extracted before the component's first render, preventing a race where navigation-collection filters (e.g. Roles) reached FreeSql; pruned dynamic filters no longer leave empty wrapper nodes behind
  • Unused Session middleware removed from the demo: the app never uses ASP.NET Session, so the "Error unprotecting the session cookie" warnings are gone
  • Tests modernized: log queue tests await asynchronously instead of blocking

[v2.2.16] - 2026.08.22

New Features

  • Corporate site Tailwind template: new easyadmin-frontend skill (corporate template in a clean Tailwind CSS style); frontend pages for Home / Services / Products / News / Contact, news with category filtering and comments (captcha + moderation), navigation includes the admin entry; new Service / Product / Feedback entities with admin CRUD pages; seed data for services/products and demo menus (Services / Products / Feedback), blog menu renamed to News Management / News Categories (zh/en); legacy Themes feature removed
  • EasyAdminBlazor.Mail now supports Tencent Cloud SES: calls the Tencent Cloud API directly (TC3-HMAC-SHA256 signature), no SDK required
  • Mail provider switching: new Mail:Provider config (Smtp / SendCloud / TencentCloud), defaults to Auto (SendCloud → Tencent Cloud → SMTP); callers can switch without code changes
  • Template emails: in Tencent Cloud mode, SendTemplateEmailAsync takes the numeric template ID and template parameters are serialized to TemplateData JSON automatically
  • Admin config: the system config page adds SendCloud / Tencent Cloud parameter groups, each with its own test-email button; when Mail:Provider is explicitly set, only the matching provider's settings are shown (all groups are shown in Auto mode)
  • Per-call provider: SendEmailAsync gains an optional provider string parameter ("Smtp" / "SendCloud" / "TencentCloud"); providers are resolved by the Mail extension so Core stays provider-agnostic and new providers don't require a Core release
  • Data-driven config page: the test-email feature is driven by contributor declarations (IsEmailProvider / EmailRequiredKeys); adding a new email provider only requires a new contributor class in the Mail extension, with no /Admin/Config changes
  • Data permission auto-enabled: AdminTable / AdminMultiSelect / AdminSelectTable automatically enable data permissions when the entity implements IDataPermission + IEntityCreated, with no per-page configuration required
  • Official site link in the public footer: a link to the official site is added at the bottom of the public layout
  • AI assistant configuration guide: new doc/AI????.md (with an English version) covering the easyadmin-conventions / easyadmin-frontend skills and corporate site templates for ChatGPT / Cursor / Claude

Bug Fixes

  • Tencent Cloud business errors no longer mistaken for success: Tencent Cloud API 3.0 returns HTTP 200 for business errors, which are carried in the Response.Error body; these are now detected and reported correctly
  • Send failure reasons written to error log: failures from SendCloud / Tencent Cloud are logged at Error level (the database error log only records Error and above)
  • Official domain typo fixed: easyadmim corrected to easyadmin (admin layout, home page, README, docs)
  • Tenant primary key conflict fixed: removed the legacy SysTenant.Id AOP branch that ToLower()ed the long key and skipped snowflake ID generation, fixing conflicts when adding a second tenant
  • Corporate site menu seeding made idempotent: migrated legacy /Admin/Service paths and unified Path to Admin/* to avoid duplicate menu insertion; home-page doc parsing regex and csproj cleanup
  • AuthPath stale state fixed: AuthPathSuccess is now updated in sync when AuthPath carries button parameters, so the page body no longer shows stale state
  • Redis subscription exception guard: RedisService.Subscribe no longer breaks the subscription when deserialization fails
  • Nullable and warning cleanup: HexToBytes return type corrected to byte[]?; nullable and unassigned warnings in Chat.razor / FileUploadController / Generator.Model eliminated; removed a leftover Console.WriteLine in MainLayout
  • Changelog display fixed: the changelog now renders correctly on the admin home page

Refactoring / Other

  • Solution slimmed down: removed EasyAdminBlazor.Api.Host and EasyAdminBlazor.Application projects; blog entities Article / Classify / Comment moved into EasyAdminBlazor.Test/Entities/Blog (namespace unchanged); solution and csproj references updated; skills and docs updated with layered-architecture notes (shared layer + multi-host entry model), local path references removed
  • Version unification: EasyAdminBlazor / EasyAdminBlazor.Core / EasyAdminBlazor.Mail package versions unified to 2.2.16

[v2.2.15] - 2026.08.15

New Feature: Admin Theme Color Switching

  • Theme color switcher: a palette dropdown in the header with 5 presets (Default Blue, Fresh Green, Elegant Purple, Vibrant Orange, China Red); switching takes effect immediately and persists locally
  • Default theme color option: EasyAdminBlazorOptions.DefaultThemeColor configures the system default color, applied when the user has not manually chosen
  • Full component theming: primary buttons, tab active states, menus, calendars, form focus, dropdown selection, TinyMCE editor, link colors etc. follow the theme color in both light and dark modes
  • Login page theme sync: the login page applies the saved theme color or configured default color, consistent with the admin console

Bug Fixes

  • User batch operation logic fixed: no longer executes when role/department/password is not selected; empty-selection guard added
  • Delete reference protection: roles referenced by users, menus referenced by roles, and orgs with children/users are blocked from deletion to avoid orphaned data
  • Role save guard: saving a role without any menu permission now shows a prompt instead of saving an empty permission set
  • Menu "show buttons" state fixed: checkbox state now matches the actual filter logic
  • Dictionary import parent linkage fixed: dictionary items no longer all attach to the last category when importing multiple categories
  • Config page fixes: test email validation now only checks SMTP settings; SMS test now reports success/failure/exceptions
  • Task scheduler fixes: next-run time is filled server-side to avoid index-out-of-range; editing an existing task preserves its round count
  • Profile sync after save: nickname/email/mobile update immediately in the header without refresh
  • File upload empty-list guard: no longer reports "0 files uploaded successfully" when nothing was selected
  • Select component cache fixed: cache key changed from expression reference hash to expression string, resolving cache-miss-every-time repeated DB queries
  • Operation log guard: parameterless delete methods no longer access non-existent arguments
  • Code generator resilience: assembly scanning tolerates ReflectionTypeLoadException so the page always opens
  • Login page theme applied: the login page now applies the saved theme color or configured default color, matching the admin console
  • Tab title localization: /Admin tab title supports Chinese/English (???/Home)

[v2.2.14] - 2026.08.14

Dependency Upgrades

  • BootstrapBlazor upgraded to 10.9.2: fixed compatibility with the deprecated ColumnVisibleItem API
  • FreeSql packages unified to 3.5.311 (FreeSql.Extensions.AggregateRoot, FreeSql.Extensions.JsonMap, FreeSql.Provider.Sqlite, FreeSql.Provider.MySqlConnector); FreeSql.Cloud stays at the latest 2.0.1

Security Fixes

  • Fixed stored XSS in internal messages: message/notification content is HTML-sanitized server-side before rendering (scripts, event attributes, javascript: URLs removed); chat markdown rendering now HTML-encodes raw input
  • Fixed data-permission bypass in AdminSelectTable: record backfill by selected Id now applies the same data-permission filter, preventing low-privilege users from reading records out of scope
  • Fixed ChatHub identity spoofing: SignalR connections are validated against the login cookie, and message senders must match the authenticated user, so a forged userid can no longer impersonate other users
  • Custom data permissions now fail closed: invalid/unparsable custom org config yields "no visible data" instead of leaking all records
  • Login page hardening: UAParser singleton reuse, unknown fallback on IP parse failure, in-process lock for login failure counting, removed captcha debug output

Bug Fixes

  • Fixed forced password-change dialog crash: DialogService.Show is deferred until after the first render so BootstrapBlazorRoot is registered; the dialog now closes and auth state refreshes after a successful password change
  • Fixed print module SQL dialect compatibility: pagination uses TOP/LIMIT/FETCH FIRST per database type, queries are parameterized, and errors are no longer silently swallowed
  • Fixed empty target entity in print templates: assembly scanning tolerates ReflectionTypeLoadException
  • Fixed report designer script loading: replaced eval + synchronous XHR with standard <script> injection (CSP-safe, loaded once); generated HTML field names are escaped
  • Fixed message deletion overreach: deleting a message only removes the current user's association
  • Fixed password blank-out on user edit: leaving the password field empty no longer overwrites the original password
  • Fixed protected rows being deleted in batch delete: administrator/super-admin rows are excluded before deletion
  • Fixed stale permission cache version: permission cache is invalidated immediately after changes
  • Fixed draft residue when saving without closing
  • Fixed unvalidated Cron expressions: new tasks are pre-validated, invalid expressions fall back to a 5-second interval
  • Fixed chat resource leaks: timer and SignalR connection disposal completed, beforeunload reference released
  • Fixed HttpClient leak in mail service: switched to IHttpClientFactory-managed connections
  • Fixed new tenant admin not forced to change password
  • Fixed null reference when deleting an empty selection in AdminTable

Other Improvements

  • GetConfig no longer throws and caches results for 1 minute
  • Explicit data source for the tenant database-type dropdown; removed the unused "HTTP request / clean task data" template from the task scheduler
  • Added XSS sanitizer regression tests; test count 156 → 160

[v2.2.12] - 2026.06.17

NEW: Print Template Designer (Major Feature)

  • Visual Print Template Designer: New /Admin/PrintTemplate page for designing print templates through a visual interface
  • AdminTable Integration: If an entity has corresponding print templates, AdminTable automatically shows a "Print" button - select records and print with one click
  • Print Service Abstraction: New PrintService that can be called from anywhere

Designer Enhancements

  • 2-Column Layout Button: One-click insertion of two-column layouts in the template designer
  • i18n Support: Complete Chinese/English translations for the print module (zh.json / en.json)

Bug Fixes

  • Fixed issue where the left sidebar menu could not be minimized

[v2.2.11] - 2026.06.13

Architecture Refactoring

  • Auth Middleware Split: Refactored EasyAdminAuthStartupFilter (120-line inline middleware) into three independent classes
    • AdminRouteSecretMiddleware: Admin route obfuscation protection
    • AuthCookieMiddleware: Blazor Server cookie bridging endpoints
    • CookieOptionsHelper: Shared cookie security policy factory, eliminating code duplication
  • Extension Namespace Normalization: 9 namespace-less extension classes (UtilConvertExtension, StringExtension, etc.) moved to EasyAdminBlazor.Infrastructure.Extensions namespace to avoid polluting NuGet consumers' global namespace

Test Coverage

  • New unit test project EasyAdminBlazor.Tests (xUnit + Moq + FluentAssertions)
    • 150 test cases covering security validation, entity hierarchy, extension methods, UA parsing, encryption utilities, and logging infrastructure
    • Security-critical paths tested: redirect validation, SSRF protection, file magic-byte verification, PBKDF2/AES encryption

Improvements

  • UAParser Singleton: AuthService now injects UAParser as a singleton via constructor, avoiding regex recompilation on every login
  • OperationLogAttribute Parameter Truncation: Serialized parameters capped at 2000 characters, auto-truncated to prevent memory exhaustion
  • DatabaseLoggerBackgroundService Exception Safety: Added general exception handling to prevent the log service from crashing permanently on unexpected errors

Security Enhancements

  • SSRF Bug Fix: FileSecurityValidator.IsSafeRemoteUri incorrectly used HasFlag on UriHostNameType (non-[Flags] enum), causing private IP addresses to bypass security checks
  • Admin route secret middleware now has more controllable pipeline ordering

Internationalization

  • Enum Values Anglicized: All Chinese enum members renamed to English (integer values unchanged, backward compatible)
    • SysLoginLog.LoginType: { 登陆成功, 登陆失败 } → { Success, Failure }
    • SysOrg.OrgType: { 集团, 公司, 部门, 供应商 } → { Group, Company, Department, Supplier }
    • OperationResult: { 成功, 失败 } → { Success, Failure }
    • OperationType: { 查询, 添加, 修改, 删除, 导入, 导出 } → { Query, Add, Update, Delete, Import, Export }

Bug Fixes

  • Fixed draft timer not restarting: In OnSaveWithoutClose, the _restartDraftAfterClose flag was set after the dialog close callback, preventing the auto-save timer from ever restarting. Manual draft save was also unresponsive.
  • Fixed Navigation Property Nullable Annotations: SysUser.Org, SysOrg.Parent, SysMenu.Parent and other navigation properties properly marked as nullable, eliminating null! abuse

[v2.2.10] - 2026.06.07

New Features

  • New Code Generator: Visually generate CRUD pages (only in local development environment)
    • The old version of the code generator has been deprecated. Please manually add the following URL as a backend menu: Admin/CodeGenerator
  • AdminTable Draft Features
    • EnableDraft: Auto-save form data to localStorage
    • EnableSaveWithoutClose: Keep window open after save
    • DraftAutoSaveInterval: Custom save interval (default 30 seconds)
  • Smart Draft Recovery: Only prompt when content changed, auto-clean unchanged drafts
  • New "Save Without Closing" button

Improvements

  • Split AdminContext into multiple partial classes for cleaner code
  • AdminFileInput component now supports direct path copying
  • Database logging changed to async queue writes to reduce request blocking
  • Logging supports batch insertion + queue size limits
  • Automatically flush remaining logs on service stop
  • FileService now uses IHttpClientFactory for HttpClient management
  • Cleaned up nullable warnings in Core project

Security Enhancements

  • Cookie Auth: Removed JS read/write fallback, unified server-side HttpOnly Cookie writes
  • Open Redirect Fix: Security hardening for login and authentication endpoints
  • SSRF Protection: Added security checks for remote image saving
  • File Upload: Added content type detection and stream size validation
  • Login tickets now protected by ASP.NET Core Data Protection
  • Login rate limiting IP retrieval changed to trusted proxy mode

Bug Fixes

  • Fixed potential null HttpContext exception in AdminContext
  • Optimized login/logout redirect logic for Blazor Server WebSocket scenarios
  • Fixed circular dependency serialization issue

Documentation Updates

  • Added Code Generator documentation (Chinese & English)
  • Updated AdminTable, Menu Management, Data Permission, Project Introduction docs

[v2.2.9] - 2026-05-30

Added

  • Added remote login logout option
  • Improved English translations for all modules, localization enabled by default.
  • Breaking change: SysMenuType and DataPermissionType enum types changed. After upgrading to this version, please manually execute: migrate_enum_v.2.2.7.sql

[v2.2.6] - 2026-05-29

Added

  • Added changelog display on the admin dashboard
  • Updated sample module content

Fixed

  • Prevent Chat timer from accessing services after DI disposal causing ObjectDisposedException
  • Added IsAdmin property to AdminContext
  • Fixed issue where e.Select.OrderByDescending in OnBeforeQuery was not working
  • Fixed login not obtaining IP address
  • Fixed issue where inline Switch could still be toggled without edit permission
  • Fixed BootstrapBlazor edit dialog submit button stuck in loading state
  • Fixed login failure when EasyAdminBlazor.Scheduler extension is not installed

Refactored

  • Refactored default sorting logic
  • Optimized FreeSql registration in non-multi-tenant mode
  • Synced NuGet package versions

Documentation

  • Added extensive documentation: AdminTable, Multi-Tenant, Localization, Data Permission, File Management, etc.
  • Updated quick start documentation
  • Added project introduction documentation

v2.2.0 - 2026-05-23

  • Refactored: FreeRedis provided as an extension (EasyAdminBlazor.Redis)
  • Refactored: Scheduled tasks provided as an extension (EasyAdminBlazor.Scheduler)
  • Refactored: Multi-tenancy provided as an extension (EasyAdminBlazor.MultiTenant)
  • Refactored: Caching provided as an extension (EasyAdminBlazor.FusionCache)
  • Refactored: FusionCache provided as an extension project

v2.0.x - 2026-05-22 ~ 2026-05-23

  • Added: WeChat Pay

v2.0.x - 2026-04-09 ~ 2026-04-15

  • Refactored: Architecture layering, separated data from UI to accommodate multi-layer architecture
  • Added: Added login city record
  • Optimized: Fully adapted for mobile devices
  • Fixed: Removed BootstrapBlazor's WebClient to resolve timeout exceptions
  • Enhanced: AdminSelectEntity.razor now supports binding to any field
  • Fixed: Save button could not be clicked again after a save exception
  • Fixed: Corrected OrgId hardcoding issue, now prioritizes Column(Name=value) for Flags type matching
  • Enhanced: Table filtering and advanced search now support Flags enums

v2.0.x - 2026-03-01 ~ 2026-03-20

  • Added: Added permission control for file upload Picker
  • Added: Access admin backend via security code
  • Added: Added SendCloud email delivery
  • Fixed: Resolved task scheduling failure in multi-project scenarios

v2.0.x - 2025-12-31 ~ 2026-02-22

  • Optimized: Fixed TinyMCE not being able to modify image alt text
  • Added: Menu show/hide option

v2.0.3 - 2026-01-03

  • Integrated: Directly integrated FusionCache
  • Enhanced: Added GetOrSet method to cache

v2.0.1 - 2026-01-01

  • Enhanced: Admin list added quick toggle for enabled/disabled status
  • Enhanced: Encryption key is now customizable
  • Enhanced: Encrypted login Cookie
  • Enhanced: CAPTCHA and login error count stored in Redis when configured, otherwise in-memory

v2.0.0 - 2025-12-31

  • Upgraded: Upgraded to .NET 10
  • Upgraded: Upgraded all NuGet packages to latest versions

v1.4.7 - 2025-06-06 ~ 2025-11-25

  • Added: Upload parameters are configurable
  • Enhanced: Changed tree component's sort property to string type
  • Fixed: Fixed issue with fuzzy search returning no results
  • Added: Added image CAPTCHA extension (EasyAdminBlazor.Captcha)
  • Fixed: Fixed issue where organization responsible person could not be assigned
  • Added: Added WeChat integration extension (EasyAdminBlazor.WeChat)
  • Optimized: Overall optimization and bug fixes

[1.4.6] - 2025-06-02

Added

  • Editor added paste-to-upload functionality
  • Editor added remote image download and local image drag-to-upload functionality
  • AdminTable component added custom import method based on dictionary data

Fixed

  • Fixed issue with files not being deleted correctly

[1.4.5] - 2025-06-01

Added

  • Added menu favorites feature
  • Login CAPTCHA now configurable for display
  • System name now configurable for display
  • Help link now configurable for display
  • Message center now configurable for display
  • Added AdminSelectTreeEntity component
  • Added AdminDictMultiSelect dictionary multi-select component
  • Added AdminTree component (generates tree from entity without manual data binding; same effect for other Admin-prefixed data components)
  • AdminTable component added custom import method based on dictionary data

[1.4.0] - 2025-05-29

Added

  • Optimized page permission verification
  • Added default tenant ID
  • Added previous/next navigation for message reminders
  • Separated chat component as an independent extension project
  • Added forced password change functionality
  • Added uploadable file type hints
  • Optimized file upload logic, enhanced file upload security checks
  • Separated email sending, SMS sending, and rich text editor as extensions for easy replacement
  • Adjusted file selection style
  • Added log viewing for scheduled tasks

[1.3.0] - 2025-05-26

Added

  • Added scheduled tasks
  • Modified login logic

[1.2.0] - 2025-05-25

Added

  • Added in-site messaging
  • Added system notifications
  • Style adjustments
  • Night mode improvements for file selector, rich text editor, and other components

[1.1.0] - 2025-05-22

Added

  • Added batch role assignment, department assignment, and password reset for users
  • Added responsible person binding for organization management
  • Added organization chart
  • Added batch dictionary import/export
  • AdminSelectTable component added Id binding @bind-ValueId="v.ArticleId"

Fixed

  • Fixed occasional loss of tenant ORM object (now re-fetched on every URL change)
  • Login success did not reset password error count
  • Fixed issue where single selection in function menu did not return the selected item

[1.0.0] - 2025-05-15

Initial Release

  • Released basic project functionality.