diff --git a/skills/salesforce-experience-react-site/SKILL.md b/skills/salesforce-experience-react-site/SKILL.md index 14e4400..9331638 100644 --- a/skills/salesforce-experience-react-site/SKILL.md +++ b/skills/salesforce-experience-react-site/SKILL.md @@ -41,147 +41,15 @@ Create any files and directories that don't already exist, using these paths: The DigitalExperience directory contains only `_meta.json` and `content.json`. Do not create any directories other than `sfdc_cms__site` inside the bundle. ### Step 3: Populate All Metadata Fields -Use the templates below. Values in `{braces}` are resolved property references — substitute them with the actual values from Step 1. +Use the default templates in the docs below. Values in `{braces}` are resolved property references — substitute them with the actual values from Step 1. -#### Network -```xml - - - false - false - unfiled$public/CommunityChangePasswordEmailTemplate - true - admin@company.com - {siteName} - false - true - false - true - false - true - {enableGuestAccess} - false - false - true - false - false - false - false - true - false - false - false - true - true - true - false - false - unfiled$public/CommunityForgotPasswordEmailTemplate - false - unfiled$public/CommunityHeadlessForgotPasswordTemplate - unfiled$public/CommunityHeadlessRegistrationTemplate - - admin - - - Standard - Designer - Designer - Designer - Designer - - admin@company.com - {siteName}1 - false - true - {siteName} - NotArchived - Live - - home - Chatter - - {siteUrlPathPrefix}vforcesite - unfiled$public/CommunityWelcomeEmailTemplate - -``` - -#### CustomSite -```xml - - - true - false - false - false - false - false - true - false - CommunitiesLogin - BandwidthExceeded - true - true - SameOriginOnly - true - true - FileNotFound - Exception - InMaintenance - CommunitiesLanding - {siteName} - false - true - CommunitiesSelfReg - ChatterNetwork - {siteUrlPathPrefix}vforcesite - -``` - -#### DigitalExperienceConfig -```xml - - - - - {siteUrlPathPrefix} - - site/{siteName}1 - -``` - -#### DigitalExperienceBundle -```xml - - - - -``` - -#### DigitalExperience — `_meta.json` -```json -{ - "apiName": "{siteName}1", - "path": "", - "type": "sfdc_cms__site" -} -``` - -#### DigitalExperience — `content.json` -```json -{ - "type": "sfdc_cms__site", - "title": "{siteName}", - "urlName": "{siteUrlPathPrefix}", - "contentBody": { - "authenticationType": "AUTHENTICATED_WITH_PUBLIC_ACCESS_ENABLED", - "appContainer": true, - "appSpace": "{appNamespace}__{appDevName}" - } -} -``` - -The `appContainer: true` and `appSpace` fields are what make this a React site rather than a standard LWR site. The `appSpace` value follows the format `{namespace}__{developerName}` and must match a deployed `WebApplication` metadata record. +| Metadata Type | Template Reference | +|--------------|-------------------| +| Network | [configure-metadata-network.md](docs/configure-metadata-network.md) | +| CustomSite | [configure-metadata-custom-site.md](docs/configure-metadata-custom-site.md) | +| DigitalExperienceConfig | [configure-metadata-digital-experience-config.md](docs/configure-metadata-digital-experience-config.md) | +| DigitalExperienceBundle | [configure-metadata-digital-experience-bundle.md](docs/configure-metadata-digital-experience-bundle.md) | +| DigitalExperience (sfdc_cms__site) | [configure-metadata-digital-experience.md](docs/configure-metadata-digital-experience.md) | ### Step 4: Resolve Additional Configurations Address any extra configurations the user requests. Use the schemas returned by `get_metadata_api_context` in Step 2 to understand each field's purpose, and update only the minimum necessary fields. diff --git a/skills/salesforce-experience-react-site/docs/configure-metadata-custom-site.md b/skills/salesforce-experience-react-site/docs/configure-metadata-custom-site.md new file mode 100644 index 0000000..e6b524e --- /dev/null +++ b/skills/salesforce-experience-react-site/docs/configure-metadata-custom-site.md @@ -0,0 +1,41 @@ +# Configure Metadata: CustomSite + +## Purpose +This configuration file creates a **net-new, default** CustomSite metadata record for a Digital Experience Site. It is not intended to edit or modify an existing CustomSite record. Use this template only when provisioning a brand-new site. + +## File Location +``` +sites/{siteName}.site-meta.xml +``` + +## Default Template +```xml + + + true + false + false + false + false + false + true + false + CommunitiesLogin + BandwidthExceeded + true + true + SameOriginOnly + true + true + FileNotFound + Exception + InMaintenance + CommunitiesLanding + {siteName} + false + true + CommunitiesSelfReg + ChatterNetwork + {siteUrlPathPrefix}vforcesite + +``` diff --git a/skills/salesforce-experience-react-site/docs/configure-metadata-digital-experience-bundle.md b/skills/salesforce-experience-react-site/docs/configure-metadata-digital-experience-bundle.md new file mode 100644 index 0000000..80e580e --- /dev/null +++ b/skills/salesforce-experience-react-site/docs/configure-metadata-digital-experience-bundle.md @@ -0,0 +1,17 @@ +# Configure Metadata: DigitalExperienceBundle + +## Purpose +This configuration file creates a **net-new, default** DigitalExperienceBundle metadata record for a Digital Experience Site. It is not intended to edit or modify an existing DigitalExperienceBundle record. Use this template only when provisioning a brand-new site. + +## File Location +``` +digitalExperiences/site/{siteName}1/{siteName}1.digitalExperience-meta.xml +``` + +## Default Template +```xml + + + + +``` diff --git a/skills/salesforce-experience-react-site/docs/configure-metadata-digital-experience-config.md b/skills/salesforce-experience-react-site/docs/configure-metadata-digital-experience-config.md new file mode 100644 index 0000000..bd41aa2 --- /dev/null +++ b/skills/salesforce-experience-react-site/docs/configure-metadata-digital-experience-config.md @@ -0,0 +1,21 @@ +# Configure Metadata: DigitalExperienceConfig + +## Purpose +This configuration file creates a **net-new, default** DigitalExperienceConfig metadata record for a Digital Experience Site. It is not intended to edit or modify an existing DigitalExperienceConfig record. Use this template only when provisioning a brand-new site. + +## File Location +``` +digitalExperienceConfigs/{siteName}1.digitalExperienceConfig-meta.xml +``` + +## Default Template +```xml + + + + + {siteUrlPathPrefix} + + site/{siteName}1 + +``` diff --git a/skills/salesforce-experience-react-site/docs/configure-metadata-digital-experience.md b/skills/salesforce-experience-react-site/docs/configure-metadata-digital-experience.md new file mode 100644 index 0000000..d55779f --- /dev/null +++ b/skills/salesforce-experience-react-site/docs/configure-metadata-digital-experience.md @@ -0,0 +1,38 @@ +# Configure Metadata: DigitalExperience (sfdc_cms__site) + +## Purpose +These configuration files create **net-new, default** DigitalExperience content records (`sfdc_cms__site` type) for a Digital Experience Site. They are not intended to edit or modify existing DigitalExperience content. Use these templates only when provisioning a brand-new site. + +The `appContainer: true` and `appSpace` fields in `content.json` are what make this a React site rather than a standard LWR site. The `appSpace` value follows the format `{namespace}__{developerName}` and must match a deployed `WebApplication` metadata record. + +## File Location +The DigitalExperience directory contains only `_meta.json` and `content.json`. Do not create any directories other than `sfdc_cms__site` inside the bundle. + +``` +digitalExperiences/site/{siteName}1/sfdc_cms__site/{siteName}1/_meta.json +digitalExperiences/site/{siteName}1/sfdc_cms__site/{siteName}1/content.json +``` + +## Default Templates +### `_meta.json` +```json +{ + "apiName": "{siteName}1", + "path": "", + "type": "sfdc_cms__site" +} +``` + +### `content.json` +```json +{ + "type": "sfdc_cms__site", + "title": "{siteName}", + "urlName": "{siteUrlPathPrefix}", + "contentBody": { + "authenticationType": "AUTHENTICATED_WITH_PUBLIC_ACCESS_ENABLED", + "appContainer": true, + "appSpace": "{appNamespace}__{appDevName}" + } +} +``` diff --git a/skills/salesforce-experience-react-site/docs/configure-metadata-network.md b/skills/salesforce-experience-react-site/docs/configure-metadata-network.md new file mode 100644 index 0000000..705f914 --- /dev/null +++ b/skills/salesforce-experience-react-site/docs/configure-metadata-network.md @@ -0,0 +1,72 @@ +# Configure Metadata: Network + +## Purpose +This configuration file creates a **net-new, default** Network metadata record for a Digital Experience Site. It is not intended to edit or modify an existing Network record. Use this template only when provisioning a brand-new site. + +## File Location +``` +networks/{siteName}.network-meta.xml +``` + +## Default Template +```xml + + + false + false + unfiled$public/CommunityChangePasswordEmailTemplate + true + admin@company.com + {siteName} + false + true + false + true + false + true + {enableGuestAccess} + false + false + true + false + false + false + false + true + false + false + false + true + true + true + false + false + unfiled$public/CommunityForgotPasswordEmailTemplate + false + unfiled$public/CommunityHeadlessForgotPasswordTemplate + unfiled$public/CommunityHeadlessRegistrationTemplate + + admin + + + Standard + Designer + Designer + Designer + Designer + + admin@company.com + {siteName}1 + false + true + {siteName} + NotArchived + Live + + home + Chatter + + {siteUrlPathPrefix}vforcesite + unfiled$public/CommunityWelcomeEmailTemplate + +```