Open-source eCommerce platform for C# and ASP.NET Core 10 with MongoDB. Build multi-store shops and multi-vendor marketplaces with B2B/B2C, REST API, plugins, Vue 3 and Docker.
C# aspnet-corecsharpdockerdotnetecommerceecommerce-platformmongodbmulti-storemulti-vendornosqlonline-shopshoppingcart
Checklist: Plugin and Theme Release
Run before shipping a new plugin or theme, or a version of one.
Domain rules live in the per-kind skills; this is the packaging and lifecycle gate.
Identity
-
SystemNameidentical inManifest.cs,{Feature}Defaults, the provider, and the output folder name. -
SystemNamefollows{Group}.{Name}, andGroupis an existing group value. -
SystemNameunchanged from the previously shipped version — it is the persisted identity. -
Versionin the manifest bumped. -
FriendlyNamein{Feature}Defaultsis a resource key, and the provider resolves it throughITranslationService.
Project
- Imports
..\..\Build\Grand.Common.props. - Correct SDK:
Microsoft.NET.Sdk.RazorwithAddRazorSupportForMvc=trueandStaticWebAssetsEnabled=falseif it has views;Microsoft.NET.Sdkotherwise. - Output path set for both Debug and Release, to
Grand.Web/Plugins/{SystemName}/. - All GrandNode project references
<Private>false</Private>, withExcludeAssetsmatching the nearest comparable plugin. - Package references carry no inline version.
- Added to
GrandNode.slnx. -
logo.jpgpresent and copied to output. - Themes only:
Content/theme.jpgpresent, andContent/**copied withPreserveNewest.
Registration
-
IStartupApplicationregisters the provider(s) with the right lifetime. -
Prioritymatches the convention for comparable plugins. -
Configureis empty unless the plugin owns middleware or endpoints. - Nothing was added to
Program.csor to a core project on the plugin's behalf.
Install and uninstall
-
Install()saves default settings and adds every resource key, then callsbase.Install()last. -
Uninstall()deletes settings and removes every keyInstall()added, then callsbase.Uninstall()last. - The two lists were diffed against each other, key by key.
- Install and uninstall touch nothing outside the plugin's own settings and resources.
- Install → uninstall → install leaves the store in its original state.
Configuration screen
-
ConfigurationUrlmatches the admin controller's actual route. -
[AuthorizeAdmin],[Area("Admin")],[PermissionAuthorize(...)]all present. - Store scope from
IAdminStoreService.GetActiveStore()used on both GET and POST. -
LoadSettingbefore mutation, so untouched fields are not reset. -
ClearCache()after save. - Invalid model state re-renders instead of saving.
-
_ViewImports.cshtmland_ViewStart.cshtmlpresent under the plugin's view folders.
Behavior
-
LimitedToStoresandLimitedToGroupsbehave as documented. -
Priorityis driven by aDisplayOrdersetting the operator controls. - Themes only:
GetViewLocations()ends with the two default fallbacks, andThemeNamematches theViews/folder. - Widgets only: zone names match the strings actually used in the target views.
- Consent gating present where the plugin injects third-party scripts.
Verification in a running store
- Build output lands in
Grand.Web/Plugins/{SystemName}/for Release as well as Debug. - Plugin appears in the admin plugin list with its logo and friendly name.
- Install succeeds on a store that has existing data.
- Configuration screen loads, saves, and the saved value takes effect on the storefront.
- The feature works on a second store with different settings.
- Uninstall succeeds and leaves no orphaned settings or resources.
Documentation
- PR states what the plugin does, which providers it registers, and which settings it adds.
- Breaking changes stated truthfully — including any renamed system name or removed setting.
- Themes only: the list of copied views and the upstream revision they were copied at.