브라우저·SEO 실측(T1~T7 매트릭스 + 봇 렌더 스윕)에서 발견된 결함을 보완한다. - 코어: 회원 일괄 상태변경 응답 메시지의 :count 플레이스홀더 미치환 수정 - 게시판·페이지: 비밀글·삭제글·미발행 첨부 썸네일이 KVE-2026-1914 게이트로 깨진 것을 한시 서명 preview URL(게이트 통과 직렬화 발급 + 유효 서명 허용)로 복구 — 무서명·변조·만료 요청 게이트는 종전과 동일 - 페이지: 발행/미발행 전환(after_publish)에도 SEO 캐시·사이트맵 갱신 구독 - 게시판: 게시판 디렉토리(전체 목록 + 내장 최근글)에 열람 권한 필터 적용 - 검색 화면: searchResults 데이터소스 auth_mode=optional 선언으로 로그인 회원 검색 범위 복구 + data-sources.md 선언 의무 규정화(coverage 등록)
174 lines
8.2 KiB
JSON
174 lines
8.2 KiB
JSON
{
|
|
"version": "1.0.0",
|
|
"layout_name": "search/index",
|
|
"permissions": [],
|
|
"extends": "_user_base",
|
|
"meta": {
|
|
"seo": {
|
|
"enabled": true,
|
|
"extensions": [
|
|
{ "type": "module", "id": "sirsoft-ecommerce" }
|
|
],
|
|
"data_sources": ["searchResults"],
|
|
"page_type": "search",
|
|
"toggle_setting": "$module_settings:sirsoft-ecommerce:seo.seo_search_result",
|
|
"vars": {
|
|
"site_name": "$core_settings:general.site_name"
|
|
},
|
|
"priority": 0.3,
|
|
"changefreq": "daily",
|
|
"og": {
|
|
"type": "website",
|
|
"title": "{{_seo.search.title ?? ''}}"
|
|
},
|
|
"structured_data": {
|
|
"@type": "SearchResultsPage",
|
|
"name": "{{_seo.search.title ?? ''}}"
|
|
}
|
|
}
|
|
},
|
|
"state": {
|
|
"q": ""
|
|
},
|
|
"init_actions": [
|
|
{
|
|
"handler": "setState",
|
|
"params": {
|
|
"target": "global",
|
|
"_local": {
|
|
"q": "{{query?.q || ''}}"
|
|
}
|
|
}
|
|
}
|
|
],
|
|
"data_sources": [
|
|
{
|
|
"id": "searchResults",
|
|
"label_key": "$t:editor.data_source.searchResults",
|
|
"type": "api",
|
|
"comment": "탭·게시판필터·정렬·페이지·커서는 전역 상태가 아니라 URL 쿼리를 읽는다. 전역 상태에 두면 주소가 바뀌지 않아 새로고침·뒤로가기에서 전부 초기값으로 돌아가고 결과를 그대로 공유할 수도 없다. cursor 는 커서로 넘길 수 있는 정렬(최신순 등)에서 이전/다음 이동 시 채워진다. 비어 있으면 서버가 첫 페이지로 읽고 다음 커서를 발급한다 — 관련도순은 계산값 정렬이라 서버가 커서를 발급하지 않고 page 로만 움직인다. auth_mode=optional: 검색 라우트는 optional.sanctum 으로 로그인 회원의 열람 범위(회원 전용 게시판 포함)를 해석하므로, 토큰이 있으면 반드시 실어 보낸다 — 미선언(none)이면 로그인 회원도 비회원 범위로 검색되어 서버측 권한 해석이 무력화된다",
|
|
"endpoint": "/api/search?q={{query?.q}}&type={{query?.type ?? 'all'}}&board_slug={{query?.board_slug ?? ''}}&sort={{query?.sort ?? 'relevance'}}&page={{query?.page ?? 1}}&cursor={{query?.cursor ?? ''}}&per_page={{(query?.type === 'products') ? 12 : 10}}",
|
|
"method": "GET",
|
|
"auth_mode": "optional",
|
|
"auto_fetch": true,
|
|
"loading_strategy": "progressive",
|
|
"condition": "{{query?.q}}",
|
|
"fallback": {
|
|
"data": {
|
|
"keyword": "",
|
|
"total": 0,
|
|
"results": {
|
|
"posts": {
|
|
"total": 0,
|
|
"items": []
|
|
},
|
|
"products": {
|
|
"total": 0,
|
|
"items": []
|
|
},
|
|
"pages": {
|
|
"total": 0,
|
|
"items": []
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
],
|
|
"slots": {
|
|
"content": [
|
|
{
|
|
"type": "layout",
|
|
"name": "Container",
|
|
"props": {
|
|
"className": "py-4"
|
|
},
|
|
"responsive": {
|
|
"desktop": {
|
|
"props": {
|
|
"className": "py-8"
|
|
}
|
|
}
|
|
},
|
|
"children": [
|
|
{
|
|
"comment": "페이지 헤더",
|
|
"type": "basic",
|
|
"name": "Div",
|
|
"props": {
|
|
"className": "mb-6"
|
|
},
|
|
"children": [
|
|
{
|
|
"type": "basic",
|
|
"name": "H1",
|
|
"props": {
|
|
"className": "text-2xl font-bold text-gray-900 dark:text-white flex items-center gap-2"
|
|
},
|
|
"children": [
|
|
{
|
|
"type": "basic",
|
|
"name": "Icon",
|
|
"props": {
|
|
"name": "search",
|
|
"size": "lg"
|
|
}
|
|
},
|
|
{
|
|
"type": "basic",
|
|
"name": "Span",
|
|
"text": "$t:search.title"
|
|
}
|
|
]
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"partial": "partials/search/_search_input.json"
|
|
},
|
|
{
|
|
"partial": "partials/search/_search_tabs.json"
|
|
},
|
|
{
|
|
"partial": "partials/search/_search_filters.json"
|
|
},
|
|
{
|
|
"partial": "partials/search/_search_states.json"
|
|
},
|
|
{
|
|
"partial": "partials/search/_search_results.json"
|
|
},
|
|
{
|
|
"comment": "페이지네이션 — 총 건수가 상한에 걸리면 last_page 가 null 로 온다. 그때는 페이지 번호 목록과 마지막 페이지 점프가 사라지고 이전/다음만 남으며, 다음 이동은 has_more_pages 로 끝까지 열려 있다",
|
|
"type": "composite",
|
|
"name": "Pagination",
|
|
"if": "{{query?.q && (query?.type ?? 'all') !== 'all' && ((searchResults?.data?.last_page ?? 0) > 1 || searchResults?.data?.has_more_pages === true || (searchResults?.data?.current_page ?? 1) > 1)}}",
|
|
"props": {
|
|
"comment": "커서로 넘길 때 서버는 페이지 번호를 세지 않으므로 표시용 번호는 화면이 센다",
|
|
"currentPage": "{{Number(query?.page ?? searchResults?.data?.current_page ?? 1)}}",
|
|
"totalPages": "{{searchResults?.data?.last_page ?? null}}",
|
|
"hasMorePages": "{{searchResults?.data?.has_more_pages ?? false}}",
|
|
"className": "mt-6 flex justify-center"
|
|
},
|
|
"actions": [
|
|
{
|
|
"comment": "같은 검색 안에서의 페이지 이동이라 mergeQuery 로 검색어·탭·정렬·게시판필터를 그대로 승계한다. 커서는 이동 방향으로 정한다 — 이 시점의 query.page 는 아직 이동 전 값이라 앞뒤를 알 수 있고, 서버가 커서를 발급하지 않는 정렬(관련도순)에서는 빈 값이 되어 키가 지워지고 page 로만 움직인다",
|
|
"event": "onPageChange",
|
|
"handler": "navigate",
|
|
"params": {
|
|
"path": "/search",
|
|
"mergeQuery": true,
|
|
"query": {
|
|
"page": "{{$args[0]}}",
|
|
"cursor": "{{$args[0] > Number(query?.page ?? 1) ? (searchResults?.data?.next_cursor ?? '') : ($args[0] < Number(query?.page ?? 1) ? (searchResults?.data?.prev_cursor ?? '') : '')}}"
|
|
}
|
|
}
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
}
|