[官方連結](https://sap.github.io/spartacus-docs/context-configuration/)

CMS 中定義的每個站點都有自己的上下文，其中包括基本站點 ID、語言屬性和貨幣屬性。 上下文還定義了這些屬性如何在 URL 中持久化。

# Static Multi-Site Configuration

您可以透過定義上下文屬性（例如基本站點、語言和貨幣）來配置您的應用程式。 當您將這些屬性的值附加到店面 URL 時，店面將根據這些值進行配置。

例如訪問https://localhost:4200/electronics-spa/en/USD/時，應用程式載入electronics-spa基地站點，設定站點語言為英語（en），設定貨幣為美元 （美元）。

上下文屬性還為語言和貨幣下拉選單設定預設值，您可以使用它們來動態更改店面的上下文。

![](https://img-blog.csdnimg.cn/img_convert/1d30af4f5b5cd51c9d349ca5512882b2.png)

site 的屬性：theme，channel 和 language

![](https://img-blog.csdnimg.cn/img_convert/21df540e50d994b3e95753d9fbf5eba2.png)

content catalog：
![](https://img-blog.csdnimg.cn/img_convert/45842e380b91c9cb8ed78f5ee05d1041.png)

預設顯示的產品：

![](https://img-blog.csdnimg.cn/img_convert/fd296ec183c79a1933f6413286f25b53.png)

配置現在放到 C:\Code\SPA\spartacus\projects\storefrontapp\src\app\spartacus\spartacus-b2c-configuration.module.ts 裡了：

![](https://img-blog.csdnimg.cn/img_convert/0eae8e293ffbcd228fd6fdd1fb856a6c.png)

# Context Properties

上下文屬性位於 app.module.ts 中。

baseSite、語言和貨幣屬性是將陣列中的第一個元素作為預設值的陣列。

urlParameters 屬性採用其他上下文屬性的值來建立附加到店面 URL 的上下文結構。

例如，如果您的店面 URL 是 https://localhost:4200，那麼它會變為 https://localhost:4200/electronics-spa/en/USD/ 並具有以下上下文配置：

```typescript
context: {
    baseSite: [
      'electronics-spa', //Selected by default because it is the first element in the list
      'electronics',
    ],
    language: [
      'en'
    ],
    currency: [
      'USD'
    ],
    urlParameters: ['baseSite', 'language', 'currency']
  },
 ...
```

# Enabling Context in the Storefront URL

預設情況下，上下文不會出現在 Spartacus 店面 URL 中。

您可能希望在店面 URL 中顯示上下文，以此作為最佳化 SEO 的一種方式，或保持 URL 與以前店面的相容性。 例如，您可能希望搜尋機器人根據 URL 中的語言和貨幣對不同版本的店面進行分類。 或者，您可能正在從另一個店面遷移到 Spartacus，該店面在店面 URL 中包含上下文，並且您希望保持先前建立的頁面排名。

要在 URL 中包含上下文，請將 urlParameters 屬性新增到 app.modules.ts 中的上下文屬性。 下面是一個例子：

```typescript
context: {
    baseSite: ['electronics-spa'],
    urlParameters: ['baseSite', 'language', 'currency']
  },
```

# Automatic Multi-Site Configuration

此功能是在 Spartacus 庫的 1.3 版中引入的。

CMS 中定義的每個站點都有自己的上下文，其中包括基本站點 ID、語言屬性和貨幣屬性。 上下文還定義了這些屬性如何在 URL 中持久化。 您可以允許 Spartacus 根據 CMS 中定義的站點 URL 模式自動確定上下文。 您可以透過簡單地不在 app.module.ts 中定義 context.baseSite 屬性來啟用此自動上下文配置。

在應用程式初始化之前，Spartacus 從後端獲取基站點列表，將當前 URL 與 CMS 中定義的站點的 URL 模式進行比較，然後識別當前基站點及其語言， 貨幣和 URL 編碼屬性。

# Mitigating the Initial Back End Call

對基本站點的後端的初始呼叫可能很慢，這會影響使用者體驗。 為了解決這個問題，您可以選擇使用伺服器端渲染 (SSR) 或漸進式 Web 應用程式 (PWA) 技術來快取上下文。

# Caching the Site Context with Server-Side Rendering

可以在伺服器端渲染期間識別站點，並且可以使用 Angular TransferState 機制將上下文傳輸到瀏覽器。 為了避免在每次頁面請求時呼叫伺服器端的基本站點，可以使用反向代理快取頁面。

要允許在伺服器端識別站點，您需要向 Spartacus 提供當前請求 URL。 您可以透過使用 ngExpressEngine 的 Spartacus 裝飾器來完成此操作，該裝飾器在幕後提供 SERVER_REQUEST_URL 注入令牌。 您可以在 main.server.ts 中進行配置，如下所示：

```typescript
import { ngExpressEngine as engine } from '@nguniversal/express-engine';
import { NgExpressEngineDecorator } from '@spartacus/core';

export const ngExpressEngine = NgExpressEngineDecorator.get(engine);
```

# Caching the Back End Response with Base Sites in PWA

使用 PWA 時，Angular Service Worker 可以快取提供基本站點的後端響應，方法是向 Service Worker 配置中的 dataGroups 陣列新增配置。 以下是來自 ngsw-config.json 的示例：

```typescript
{
  // ...
  "dataGroups": [
    // ...
    {
      "name": "basesites",
      "urls": [
        "*/rest/v2/basesites?fields=baseSites\\(uid,defaultLanguage\\(isocode\\),urlEncodingAttributes,urlPatterns,stores\\(currencies\\(isocode\\),defaultCurrency\\(isocode\\),languages\\(isocode\\),defaultLanguage\\(isocode\\)\\)*"
      ],
      "cacheConfig": {
        "maxSize": 1,
        "maxAge": "1d", // Set to 1 day. Customize this value according to your needs.
        "strategy": "performance"
      }
    }
  ]
}
```

# Base Sites and Storefronts

當基本站點在 URL 引數中編碼時，Spartacus 引用 baseSite 引數，而 CMS 將此引數稱為 storefront. 您應該繼續在 CMS 中使用店面引數名稱，因為 Spartacus 將店面隱式對映到 baseSite。 其他引數，如語言和貨幣，不受影響。

如下圖所示：backoffice CMS 裡使用引數 “storefront”：

![](https://img-blog.csdnimg.cn/img_convert/a7a44a52ffb10a50ee98cc609538086d.png)

而 Spartacus 使用 baseSite：
![](https://img-blog.csdnimg.cn/img_convert/1e4ca5bfdadcdb70cafcfc06ef349178.png)

# Writing URL Patterns in Java

由於歷史原因，在 CMS 中定義的具有 URL 模式的正規表示式是用 Java 編寫的。 但是，這些正規表示式是在前端使用 JavaScript 計算的。 您應該繼續在 CMS 中使用 Java regex，它們將在 Spartacus 中隱式轉換為 JavaScript。 例如，為了不區分大小寫，諸如 (?i) 之類的修飾符被對映到 /i。

注意：雖然 Java regex 和 JavaScript 之間的現有對映應該足以滿足最常見的情況，但並非所有 Java regex 功能都在 JavaScript 中可用，因此驗證您的 URL 模式不使用 Java regex 功能在 JavaScript 中不可用非常重要 JavaScript。 否則，任何帶有錯誤 URL 模式的基本站點都不會被 Spartacus 識別。

# Disabling a Base Site

無論 CMS 中定義的選項如何，例如 active、activeFrom 或 activeTo，後端端點都會返回所有基本站點的列表，不包含有關該站點是否處於活動狀態的任何資訊。 要禁用基本站點，您必須刪除該基本站點的 URL 模式。

作為替代的低階解決方法，您可以設定對後端資料庫呼叫的限制，以僅過濾活動站點。

SAP Spartacus Multi-Site Configuration

相關文章