// layoutResponse is the top-level shape of a GraphQL layout query response.
type layoutResponse struct {
Data struct {
Layout struct {
Item *struct {
Rendered json.RawMessage `json:"rendered"`
} `json:"item"`
} `json:"layout"`
} `json:"data"`
Errors struct {
Message string `json:"message"`
} `json:"errors"`
}
// fetchLayoutData retrieves the Sitecore layout snapshot
// for the given site name, language, and route path.
// Returns (nil, nil) when the route does not exist in Sitecore.
func fetchLayoutData(site, language, routePath string) (mapstringany, error) {
endpoint := os.Getenv("SITECORE_EDGE_PLATFORM_URL")
contextID := os.Getenv("SITECORE_EDGE_CONTEXT_ID")
var gql layoutResponse
if err := json.NewDecoder(resp.Body).Decode(&gql); err != nil {
return nil, fmt.Errorf("decode: %w", err)
}
if len(gql.Errors) > 0 {
return nil, fmt.Errorf("graphql: %s", gql.Errors0.Message)
}
if gql.Data.Layout.Item == nil {
return nil, nil // route does not exist in Sitecore
}
// `rendered` can arrive as a JSON object or a JSON-encoded string.
raw := gql.Data.Layout.Item.Rendered
var out mapstringany
if json.Unmarshal(raw, &out) == nil {
return out, nil
}
// Fall back: rendered was a quoted string - decode and re-parse it.
var s string
if json.Unmarshal(raw, &s) != nil {
return nil, fmt.Errorf("cannot parse rendered field")
}
if err := json.Unmarshal(byte(s), &out); err != nil {
return nil, fmt.Errorf("cannot parse rendered string: %w", err)
}
return out, nil
}
func main() {
// Load .env file if present (ignored when not found, e.g. in production).
_ = godotenv.Load()
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
site := os.Getenv("SITECORE_SITE_NAME")
language := os.Getenv("SITECORE_SITE_LANGUAGE_CODE")
if language == "" {
language = "en"
}
func main() {
// Load .env file if present (ignored when not found, e.g. in production).
_ = godotenv.Load()
site := os.Getenv("SITECORE_SITE_NAME")
language := os.Getenv("SITECORE_SITE_LANGUAGE_CODE")
if language == "" {
language = "en"
}
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
// Derive the Sitecore route path from the URL. Keep root "/" as-is;
// trim any trailing slash from other paths.
routePath := r.URL.Path
if routePath != "/" {
routePath = strings.TrimRight(routePath, "/")
}
data, err := fetchLayoutData(site, language, routePath)
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
if data == nil {
// Route does not exist in Sitecore.
if routePath == "/404" {
// Sitecore 404 page is not configured; serve a minimal fallback.
http.NotFound(w, r)
return
}
http.Redirect(w, r, "/404", http.StatusFound)
return
}
Component is not implemented. Add an implementation and register it in the component map.
components.goを作成し、以下のコードを貼り付けます:
// components.go
package main
import "html/template"
// ComponentFunc is the signature every component renderer must satisfy.
type ComponentFunc func(fields, params mapstringany, placeholders mapstringany) template.HTML
// componentRegistry maps Sitecore componentName values to their Go render
// functions. Add an entry here whenever you implement a new component.
var componentRegistry mapstringComponentFunc
func init() {
componentRegistry = mapstringComponentFunc{
// Register component implementations here as you build them.
}
}
// field helpers
// strField reads the "value" string of a plain-text or rich-text field.
func strField(fields mapstringany, name string) string {
f, _ := fieldsname.(mapstringany)
v, _ := f"value".(string)
return v
}
// imgValue reads an Image field's value object, with jsonValue as a fallback
// for direct item queries.
func imgValue(fields mapstringany, name string) mapstringany {
f, _ := fieldsname.(mapstringany)
if v, ok := f"value".(mapstringany); ok {
return v
}
if jv, ok := f"jsonValue".(mapstringany); ok {
v, _ := jv"value".(mapstringany)
return v
}
return nil
}
// lnkValue reads a General Link field's value object, with jsonValue fallback.
func lnkValue(fields mapstringany, name string) mapstringany {
f, _ := fieldsname.(mapstringany)
if v, ok := f"value".(mapstringany); ok {
return v
}
if jv, ok := f"jsonValue".(mapstringany); ok {
v, _ := jv"value".(mapstringany)
return v
}
return nil
}
// ms reads a string value from any mapstringany by key.
func ms(m mapstringany, key string) string {
v, _ := mkey.(string)
return v
}
---
// src/components/Placeholder.astro
import { componentMap } from './componentMap.js';
import MissingComponent from './MissingComponent.astro';
const { name, rendering } = Astro.props;
// Type casts are needed because the component map is keyed dynamically
// and rendering items are untyped layout data.
const map = componentMap as Record<string, any>;
const items: any = rendering ?? ;
if (!layoutData) {
return Astro.redirect('/404');
}
placeholder.goを作成し、以下のコードを貼り付けます:
// placeholder.go
package main
import (
"fmt"
"html/template"
"strings"
)
// renderPlaceholder renders every component in a named placeholder slot.
func renderPlaceholder(name string, items any) template.HTML {
var sb strings.Builder
for _, item := range items {
comp, ok := item.(mapstringany)
if !ok {
continue
}
sb.WriteString(string(renderComponent(comp)))
}
return template.HTML(fmt.Sprintf(
`
// renderComponent dispatches one layout component object to its registered
// renderer, or falls back to renderMissingComponent for unknown names.
func renderComponent(comp mapstringany) template.HTML {
componentName, _ := comp"componentName".(string)
fields, _ := comp"fields".(mapstringany)
params, _ := comp"params".(mapstringany)
rawPH, _ := comp"placeholders".(mapstringany)
if fields == nil {
fields = mapstringany{}
}
if params == nil {
params = mapstringany{}
}
// Coerce the nested placeholder arrays from any to a typed slice.
placeholders := make(mapstringany, len(rawPH))
for k, v := range rawPH {
if arr, ok := v.(any); ok {
placeholdersk = arr
}
}
if fn, ok := componentRegistrycomponentName; ok {
return fn(fields, params, placeholders)
}
return renderMissingComponent(componentName, placeholders)
}
var pageTmpl = template.Must(template.New("page").Parse(`
{{- if .HasRoute}}
{{.Header}}{{.Main}}
{{- else}}
Layout data is missing for this route.
{{- end}}
\`))
type pageVars struct {
Title string
HasRoute bool
Header template.HTML
Main template.HTML
Footer template.HTML
}
// renderLayout writes a complete HTML page to w using the provided layout data.
// Fields of type template.HTML are rendered as-is by html/template (no escaping),
// which is intentional. Our component renderers produce safe, trusted HTML.
func renderLayout(w io.Writer, layoutData mapstringany) error {
if layoutData == nil {
return pageTmpl.Execute(w, pageVars{Title: "Page not found"})
}
sitecore, _ := layoutData"sitecore".(mapstringany)
route, _ := sitecore"route".(mapstringany)
if route == nil {
return pageTmpl.Execute(w, pageVars{Title: "Page not found"})
}
func main() {
// Load .env file if present (ignored when not found, e.g. in production).
_ = godotenv.Load()
site := os.Getenv("SITECORE_SITE_NAME")
language := os.Getenv("SITECORE_SITE_LANGUAGE_CODE")
if language == "" {
language = "en"
}
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
// Derive the Sitecore route path from the URL. Keep root "/" as-is;
// trim any trailing slash from other paths.
routePath := r.URL.Path
if routePath != "/" {
routePath = strings.TrimRight(routePath, "/")
}
data, err := fetchLayoutData(site, language, routePath)
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
if data == nil {
// Route does not exist in Sitecore.
if routePath == "/404" {
// Sitecore 404 page is not configured; serve a minimal fallback.
http.NotFound(w, r)
return
}
http.Redirect(w, r, "/404", http.StatusFound)
return
}
// Image field, with jsonValue as a fallback for direct item queries.
const imageField = fields?.Image;
const imageValue = imageField?.value ?? imageField?.jsonValue?.value;
const { src, alt, width, height } = imageValue ?? {};
const caption = fields?.ImageCaption?.value;
// General Link field, with jsonValue as a fallback for direct item queries.
const linkField = fields?.TargetUrl;
const link = linkField?.value ?? linkField?.jsonValue?.value;
// src/components/componentMap.js
import Image from './Image.astro';
import RichText from './RichText.astro';
import Title from './Title.astro';
// Import all your other components here
export const componentMap = {
'Image': Image,
'RichText': RichText,
'Title': Title,
// Map all your other components here
};
func renderPromo(fields, params mapstringany, _ mapstringany) template.HTML {
for _, name := range string{"PromoText", "PromoText2", "PromoText3"} {
if html := strField(fields, name); html != "" {
return template.HTML(html) // rich-text: inject as raw HTML, not escaped
}
}
return ""
}
func renderColumnSplitter(fields, params mapstringany, placeholders mapstringany) template.HTML {
// Determine which column indices are enabled (params value: "1,2,3").
var enabled string
if ep := ms(params, "EnabledPlaceholders"); ep != "" {
for _, p := range strings.Split(ep, ",") {
enabled = append(enabled, strings.TrimSpace(p))
}
}
type col struct {
index int
key string
items any
}
var cols col
for key, items := range placeholders {
// Column placeholder keys look like "column-N-{uid}".
if !strings.HasPrefix(key, "column-") {
continue
}
rest := keylen("column-"):
dash := strings.Index(rest, "-")
if dash < 0 {
continue
}
idx, err := strconv.Atoi(rest
)
if err != nil {
continue
}
idxStr := strconv.Itoa(idx)
if len(enabled) > 0 {
found := false
for _, e := range enabled {
if e == idxStr {
found = true
break
}
}
if !found {
continue
}
}
cols = append(cols, col{index: idx, key: key, items: items})
}
sort.Slice(cols, func(i, j int) bool { return colsi.index < colsj.index })
var sb strings.Builder
sb.WriteString(fmt.Sprintf(`
`, esc(ms(params, "GridParameters"))))
for _, c := range cols {
colClass := ms(params, fmt.Sprintf("ColumnWidth%d", c.index))
sb.WriteString(fmt.Sprintf(`
This assistant uses AI to generate responses based on Sitecore documentation. While it has access to official sources, answers may be incomplete or inaccurate and should not be considered official advice or support.
) : (
`, esc(ms(img, "src")), esc(ms(img, "alt")), esc(ms(img, "width")), esc(ms(img, "height")), ) // Wrap the image in a link if TargetUrl is set. lnk := lnkValue(fields, "TargetUrl") var content string if lnk != nil && ms(lnk, "href") != "" { targetAttr := "" if target := ms(lnk, "target"); target != "" { targetAttr = fmt.Sprintf(` target="%s"`, esc(target)) } content = fmt.Sprintf(`<a href="%s"%s>%s`, esc(ms(lnk, "href")), targetAttr, imgTag) } else { content = imgTag } // Show a caption below the image if ImageCaption is set. caption := strField(fields, "ImageCaption") if caption != "" { return template.HTML(fmt.Sprintf("