virtocommerce/storefront

VirtoCommerce Storefront for ASP.NET Core 2.1

镜像概述和主要用途

VirtoCommerce Storefront是基于VirtoCommerce平台构建的官方在线购物网站前端，采用ASP.NET Core 2.1开发。作为平台的客户端应用，它仅通过公共API与VirtoCommerce平台通信，提供企业级电子商务网站所需的核心功能，适用于构建多商店、多语言、多货币支持的电商平台。

核心功能和特性

核心功能

• 多商店支持：可同时管理多个独立运营的在线商店
• 多语言支持：提供多语言界面和内容展示
• 多货币支持：支持多种货币结算和汇率转换
• 多主题支持：可灵活切换不同设计主题
• 分面搜索支持：提供高级商品筛选和搜索功能
• SEO友好路由：优化URL结构以提升搜索引擎收录效果

技术特性

• 基于ASP.NET MVC Core 2.1和.NET Core 2.1框架构建
• 集成ASP.NET Identity Core 2.1实现用户认证与授权
• 使用Microsoft AutoRest自动生成REST服务客户端
• 采用DotLiquid模板引擎处理视图渲染
• 通过LibSassHost在运行时处理SCSS样式表
• 基于ASP.NET Core内存缓存和响应缓存中间件优化性能
• 使用ASP.NET Core内置依赖注入替代Unity DI容器
• 支持基于CancellationChangeToken的选择性缓存失效机制

使用场景和适用范围

适用于需要构建企业级电子商务平台的各类场景，特别适合：

• 多品牌、多区域运营的零售企业
• 需支持多语言、多货币的跨境电商平台
• 追求主题定制化和灵活配置的电商项目
• 采用ASP.NET Core技术栈的开发团队

详细使用方法和配置说明

前提条件

• .NET Core 2.1运行时环境
• Microsoft Visual C++ 2015 Redistributable（SCSS引擎依赖）

源码获取与配置

1. 克隆代码仓库

   bash
   git clone https://github.com/<<your GitHub user name>>/vc-storefront-core.git C:\vc-storefront-core
   cd C:\vc-storefront-core
   git remote add upstream https://github.com/VirtoCommerce/vc-storefront-core.git
   

2. 配置VirtoCommerce平台端点 在VirtoCommerce.Storefront/appsettings.json中设置平台连接信息：

   json
   "VirtoCommerce": {
     "Endpoint": {
       "Url": "http://localhost/admin",  // VirtoCommerce平台管理地址
       "AppId": "Enter your AppId here",  // HMAC认证AppId
       "SecretKey": "Enter your SecretKey here"  // HMAC认证SecretKey
     }
   }
   

   开发环境中推荐使用Secret Manager工具管理敏感信息

3. 配置主题存储 在appsettings.json中通过ContentConnectionString指定主题存储位置：

   json
   "ConnectionStrings": {
     // 本地文件系统存储
     "ContentConnectionString": "provider=LocalStorage;rootPath=~/cms-content",
     // 或Azure Blob存储
     // "ContentConnectionString": "provider=AzureBlobStorage;rootPath=cms-content;DefaultEndpointsProtocol=https;AccountName=yourAccountName;AccountKey=yourAccountKey"
   }
   

   • 若平台已安装示例数据，可创建符号链接指向平台主题目录：

     bash
     mklink /d C:\vc-storefront-core\VirtoCommerce.Storefront\wwwroot\cms-content C:\vc-platform\VirtoCommerce.Platform.Web\App_Data\cms-content
     

   • 若无示例数据，需在平台中创建商店并下载主题，详见主题开发文档

Docker部署示例

Docker Run命令

bash
docker run -d -p 80:80 \
  -e "VirtoCommerce__Endpoint__Url=http://platform-host/admin" \
  -e "VirtoCommerce__Endpoint__AppId=your-app-id" \
  -e "VirtoCommerce__Endpoint__SecretKey=your-secret-key" \
  -e "ConnectionStrings__ContentConnectionString=provider=LocalStorage;rootPath=/app/wwwroot/cms-content" \
  -v ./cms-content:/app/wwwroot/cms-content \
  docker.xuanyuan.run/virtocommerce/storefront-core:latest

Docker Compose配置

yaml
version: '3'
services:
  storefront:
    image: docker.xuanyuan.run/virtocommerce/storefront-core:latest
    ports:
      - "80:80"
    environment:
      - VirtoCommerce__Endpoint__Url=http://platform-host/admin
      - VirtoCommerce__Endpoint__AppId=your-app-id
      - VirtoCommerce__Endpoint__SecretKey=your-secret-key
      - ConnectionStrings__ContentConnectionString=provider=LocalStorage;rootPath=/app/wwwroot/cms-content
    volumes:
      - ./cms-content:/app/wwwroot/cms-content

IIS部署

项目已包含web.config配置文件，可直接部署到IIS。详细配置步骤参考官方文档。

可用主题

• Default主题：https://github.com/VirtoCommerce/vc-theme-default
• Material主题：https://github.com/VirtoCommerce/vc-theme-material
• B2B主题：https://github.com/VirtoCommerce/vc-theme-b2b

演示地址

• 公开演示：[***]
• 私有云演示：通过Azure部署设置专属Microsoft云环境

许可证

遵循Virto Commerce开放软件许可证，详见官方许可说明。