feat(content): 본문 이미지 목록 썸네일·og:image 폴백 전 티어 구현
공개 이슈 https://github.com/gnuboard/g7/issues/22 — 본문에 삽입한 이미지가 카드/갤러리 목록 썸네일과 공유 미리보기(og:image)에 반영되지 않던 공백을 코어+3모듈+2템플릿에서 해소. - 코어 7.0.9: HtmlImageExtractor(내부 이미지 한정, origin 정규화 SSoT 재사용) + seo.og_image_default 사이트 기본 공유 이미지 설정 + SeoMetaResolver 폴백 체인 - board 1.1.0 / ecommerce 1.2.0 / page 1.1.0: content_thumbnail_url 캐시 컬럼, saving 추출(html 모드 한정·첨부 우선·비밀글 게이트 유지), filter_content_thumbnail 훅, 기존 데이터 백필 업그레이드 스텝 - ecommerce 카테고리 og:image 생산자 신설, page og:description 死키 정정 - sirsoft-basic 1.1.2 og 바인딩 정정, admin_basic 1.0.7 SEO 탭 업로더(+ja 팩 2종) - 검수 중 발견한 text 모드 오캐시 결함은 실패 테스트 선행 후 수정
This commit is contained in:
1 parent
14eb2e39e4
commit
1ba67ca7cf
98 files changed
+4640
-101
No files matched your search
@@ -4,6 +4,12 @@
|
||||
형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/)를 따르며,
|
||||
[Semantic Versioning](https://semver.org/lang/ko/)을 준수합니다.
|
||||
|
||||
## [1.0.7] - 2026-08-22
|
||||
|
||||
### Added
|
||||
|
||||
- 환경설정 > SEO 탭에서 사이트 기본 공유 이미지(og:image)를 업로드할 수 있습니다. 화면별 공유 이미지가 없을 때 이 이미지가 링크 미리보기 카드에 사용됩니다.
|
||||
|
||||
## [1.0.6] - 2026-08-22
|
||||
|
||||
### Added
|
||||
|
||||
@@ -1419,6 +1419,8 @@
|
||||
"og_image_default_width": "OG Image Default Width (px)",
|
||||
"og_image_default_height": "OG Image Default Height (px)",
|
||||
"og_image_default_size_hint": "Default values when thumbnail size is unknown. Facebook recommends 1200×630, minimum 200×200.",
|
||||
"og_image_default": "Default Share Image",
|
||||
"og_image_default_desc": "Site-wide fallback image used when a page has no share image of its own. Shown in link preview cards.",
|
||||
"twitter_default_card": "Twitter Card Default Type",
|
||||
"twitter_default_card_hint": "Use summary_large_image for large image cards, summary for compact ones.",
|
||||
"twitter_default_site": "Twitter Site Handle",
|
||||
|
||||
@@ -1423,6 +1423,8 @@
|
||||
"og_image_default_width": "OG 이미지 기본 가로 (px)",
|
||||
"og_image_default_height": "OG 이미지 기본 세로 (px)",
|
||||
"og_image_default_size_hint": "썸네일 실제 크기를 모르는 경우의 기본값입니다. 페이스북은 권장 1200×630, 최소 200×200.",
|
||||
"og_image_default": "기본 공유 이미지",
|
||||
"og_image_default_desc": "화면별 공유 이미지가 없을 때 사용할 사이트 기본 이미지입니다. 링크 공유 시 미리보기 카드에 표시됩니다.",
|
||||
"twitter_default_card": "Twitter 카드 기본 타입",
|
||||
"twitter_default_card_hint": "이미지가 큰 카드는 summary_large_image, 작은 카드는 summary 권장.",
|
||||
"twitter_default_site": "Twitter 사이트 핸들",
|
||||
|
||||
+102
-1
@@ -395,6 +395,107 @@
|
||||
},
|
||||
"text": "$t:admin.settings.seo.og_image_default_size_hint"
|
||||
},
|
||||
{
|
||||
"type": "basic",
|
||||
"name": "Div",
|
||||
"children": [
|
||||
{
|
||||
"type": "basic",
|
||||
"name": "Label",
|
||||
"props": {
|
||||
"className": "form-label"
|
||||
},
|
||||
"text": "$t:admin.settings.seo.og_image_default"
|
||||
},
|
||||
{
|
||||
"type": "basic",
|
||||
"name": "P",
|
||||
"props": {
|
||||
"className": "text-tertiary mb-2"
|
||||
},
|
||||
"text": "$t:admin.settings.seo.og_image_default_desc"
|
||||
},
|
||||
{
|
||||
"id": "og_image_default_uploader",
|
||||
"type": "composite",
|
||||
"name": "FileUploader",
|
||||
"props": {
|
||||
"collection": "og_image_default",
|
||||
"disabled": "{{_computed.isReadOnly}}",
|
||||
"maxFiles": 1,
|
||||
"maxSize": "{{_global.settings?.upload?.max_file_size ?? _global.uploadSettings?.max_file_size ?? 10}}",
|
||||
"accept": "{{_global.settings?.upload?.allowed_extensions_formatted ?? _global.uploadSettings?.allowed_extensions_formatted ?? '.jpg,.jpeg,.png,.gif,.svg,.webp'}}",
|
||||
"imageCompression": {
|
||||
"maxSizeMB": 1,
|
||||
"maxWidthOrHeight": "{{_global.settings?.upload?.image_max_width ?? _global.uploadSettings?.image_max_width ?? 1200}}"
|
||||
},
|
||||
"initialFiles": "{{settings?.data?.seo?.og_image_default ?? []}}",
|
||||
"autoUpload": false,
|
||||
"uploadTriggerEvent": "upload:og_image_default",
|
||||
"confirmBeforeRemove": true
|
||||
},
|
||||
"actions": [
|
||||
{
|
||||
"event": "onFilesChange",
|
||||
"type": "change",
|
||||
"if": "{{$args[0] && $args[0].length > 0}}",
|
||||
"handler": "setState",
|
||||
"params": {
|
||||
"target": "local",
|
||||
"hasChanges": true
|
||||
}
|
||||
},
|
||||
{
|
||||
"event": "onUploadComplete",
|
||||
"type": "change",
|
||||
"handler": "setState",
|
||||
"params": {
|
||||
"target": "local",
|
||||
"hasChanges": true,
|
||||
"form.seo.og_image_default": "{{[...(_local.form?.seo?.og_image_default ?? []), ...$args[0]]}}"
|
||||
}
|
||||
},
|
||||
{
|
||||
"event": "onUploadComplete",
|
||||
"type": "custom",
|
||||
"handler": "toast",
|
||||
"params": {
|
||||
"type": "success",
|
||||
"message": "$t:attachment.upload_success"
|
||||
}
|
||||
},
|
||||
{
|
||||
"event": "onUploadError",
|
||||
"type": "custom",
|
||||
"handler": "toast",
|
||||
"params": {
|
||||
"type": "error",
|
||||
"message": "{{$args[0]}}"
|
||||
}
|
||||
},
|
||||
{
|
||||
"event": "onRemove",
|
||||
"type": "change",
|
||||
"handler": "setState",
|
||||
"params": {
|
||||
"target": "local",
|
||||
"hasChanges": true,
|
||||
"form.seo.og_image_default": "{{(_local.form?.seo?.og_image_default ?? []).filter(item => (item.hash || item.id) !== $args[0])}}"
|
||||
}
|
||||
},
|
||||
{
|
||||
"event": "onRemove",
|
||||
"type": "custom",
|
||||
"handler": "toast",
|
||||
"params": {
|
||||
"type": "info",
|
||||
"message": "$t:attachment.deleted"
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"type": "basic",
|
||||
"name": "Div",
|
||||
@@ -1197,7 +1298,7 @@
|
||||
"props": {
|
||||
"type": "button",
|
||||
"disabled": "{{_computed.isReadOnly || ['queued','running','writing'].includes(sitemap_status?.data?.progress?.status ?? '')}}",
|
||||
"className": "w-full md:w-auto px-4 py-2 bg-blue-600 hover:bg-blue-700 disabled:bg-gray-400 text-white text-sm font-medium rounded-lg transition-colors whitespace-nowrap"
|
||||
"className": "w-full md:w-auto px-4 py-2 bg-blue-600 dark:bg-blue-500 hover:bg-blue-700 dark:hover:bg-blue-600 disabled:bg-gray-400 dark:disabled:bg-gray-600 text-white dark:text-white text-sm font-medium rounded-lg transition-colors whitespace-nowrap"
|
||||
},
|
||||
"text": "{{['queued','running','writing'].includes(sitemap_status?.data?.progress?.status ?? '') ? $t('admin.settings.seo.sitemap_regenerating') : $t('admin.settings.seo.sitemap_manual_update')}}",
|
||||
"actions": [
|
||||
|
||||
+2
-2
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"name": "sirsoft-admin_basic",
|
||||
"version": "1.0.6",
|
||||
"version": "1.0.7",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "sirsoft-admin_basic",
|
||||
"version": "1.0.6",
|
||||
"version": "1.0.7",
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"@dnd-kit/core": "^6.3.1",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "sirsoft-admin_basic",
|
||||
"version": "1.0.6",
|
||||
"version": "1.0.7",
|
||||
"description": "Gnuboard7 Basic Admin Template Components",
|
||||
"type": "module",
|
||||
"main": "dist/components.js",
|
||||
|
||||
@@ -5,7 +5,7 @@
|
||||
"ko": "Admin Basic",
|
||||
"en": "Admin Basic"
|
||||
},
|
||||
"version": "1.0.6",
|
||||
"version": "1.0.7",
|
||||
"license": "MIT",
|
||||
"description": {
|
||||
"ko": "그누보드7 기본 관리자 템플릿",
|
||||
@@ -22,7 +22,7 @@
|
||||
"url": "https://sirsoft.com"
|
||||
},
|
||||
"release_date": "2026-05-15",
|
||||
"g7_version": ">=7.0.7",
|
||||
"g7_version": ">=7.0.9",
|
||||
"dependencies": {
|
||||
"modules": {},
|
||||
"plugins": {}
|
||||
|
||||
@@ -4,6 +4,16 @@
|
||||
형식은 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/)를 따르며,
|
||||
[Semantic Versioning](https://semver.org/lang/ko/)을 준수합니다.
|
||||
|
||||
## [1.1.2] - 2026-08-22
|
||||
|
||||
### Changed
|
||||
|
||||
- sirsoft-page 최소 버전을 1.1.0 으로 상향했습니다 (페이지 공유 이미지 연동).
|
||||
|
||||
### Fixed
|
||||
|
||||
- 페이지 공유 미리보기의 이미지(og:image)와 설명(og:description)이 채워지도록 페이지 표시 화면의 공유 정보 연결을 정비했습니다. (#22 @abc101 님께서 제보해주셨습니다.)
|
||||
|
||||
## [1.1.1] - 2026-08-19
|
||||
|
||||
### Added
|
||||
|
||||
+144
@@ -0,0 +1,144 @@
|
||||
/**
|
||||
* @file search-product-item-list-thumbnail.test.tsx
|
||||
* @description 통합검색 상품 리스트형 아이템 썸네일 키 정정 회귀 (공개 #22 부수 — 별건 P3-A)
|
||||
*
|
||||
* 회귀 배경: `_item_list.json` 이 生産측(SearchProductsListener)이 방출하지 않는
|
||||
* `product.thumbnail` 키를 바인딩해 리스트형 썸네일 src 가 항상 비었다 (카드형은 정상).
|
||||
* 정정: `product.thumbnail_url` 바인딩 + if 가드 + 부재 시 placeholder.
|
||||
*
|
||||
* 검증 방식: 실제 partial JSON 을 iteration 래퍼에 넣어 DynamicRenderer 로 렌더링,
|
||||
* thumbnail_url 존재/부재 두 케이스의 DOM 을 단언한다.
|
||||
*
|
||||
* @vitest-environment jsdom
|
||||
*/
|
||||
|
||||
import React from 'react';
|
||||
import { describe, it, expect, afterEach } from 'vitest';
|
||||
import { createLayoutTest, screen } from '@/core/template-engine/__tests__/utils/layoutTestUtils';
|
||||
import { ComponentRegistry } from '@/core/template-engine/ComponentRegistry';
|
||||
|
||||
import itemListPartial from '../../layouts/partials/search/products/_item_list.json';
|
||||
|
||||
// ========== 테스트용 컴포넌트 ==========
|
||||
|
||||
const TestDiv: React.FC<{ className?: string; children?: React.ReactNode }> = ({ className, children }) => (
|
||||
<div className={className}>{children}</div>
|
||||
);
|
||||
|
||||
const TestSpan: React.FC<{ className?: string; children?: React.ReactNode; text?: string }> = ({ className, children, text }) => (
|
||||
<span className={className}>{children || text}</span>
|
||||
);
|
||||
|
||||
const TestButton: React.FC<{ className?: string; children?: React.ReactNode }> = ({ className, children }) => (
|
||||
<button type="button" className={className}>{children}</button>
|
||||
);
|
||||
|
||||
const TestImg: React.FC<{ src?: string; alt?: string; className?: string }> = ({ src, alt, className }) => (
|
||||
<img data-testid="product-thumb" src={src} alt={alt} className={className} />
|
||||
);
|
||||
|
||||
const TestIcon: React.FC<{ name?: string; className?: string }> = ({ name, className }) => (
|
||||
<i data-testid={`icon-${name}`} className={className} />
|
||||
);
|
||||
|
||||
const TestHtmlContent: React.FC<{ content?: string; className?: string }> = ({ content, className }) => (
|
||||
<div className={className}>{content}</div>
|
||||
);
|
||||
|
||||
const TestFragment: React.FC<{ children?: React.ReactNode }> = ({ children }) => <>{children}</>;
|
||||
|
||||
function setupTestRegistry(): void {
|
||||
const registry = ComponentRegistry.getInstance();
|
||||
(registry as any).registry = {
|
||||
Div: { component: TestDiv, metadata: { name: 'Div', type: 'basic' } },
|
||||
Span: { component: TestSpan, metadata: { name: 'Span', type: 'basic' } },
|
||||
Button: { component: TestButton, metadata: { name: 'Button', type: 'basic' } },
|
||||
Img: { component: TestImg, metadata: { name: 'Img', type: 'basic' } },
|
||||
Icon: { component: TestIcon, metadata: { name: 'Icon', type: 'basic' } },
|
||||
HtmlContent: { component: TestHtmlContent, metadata: { name: 'HtmlContent', type: 'composite' } },
|
||||
// iteration 렌더는 Fragment 래퍼를 요구한다 — 미등록 시 반복 전체가 조용히 빈 출력
|
||||
Fragment: { component: TestFragment, metadata: { name: 'Fragment', type: 'layout' } },
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* 실제 partial 을 iteration 래퍼에 넣은 테스트 레이아웃을 만든다.
|
||||
*
|
||||
* @param products 검색 결과 상품 배열 (SearchProductsListener 방출 형태)
|
||||
*/
|
||||
const testLayout = {
|
||||
version: '1.0.0',
|
||||
layout_name: 'test/search-item-list',
|
||||
components: [
|
||||
{
|
||||
type: 'basic',
|
||||
name: 'Div',
|
||||
iteration: {
|
||||
source: 'search_products.data',
|
||||
item_var: 'product',
|
||||
index_var: 'product_index',
|
||||
},
|
||||
children: [itemListPartial],
|
||||
},
|
||||
],
|
||||
};
|
||||
|
||||
/**
|
||||
* 검색 결과 상품 배열을 initialData 컨텍스트로 넘겨 테스트 유틸을 만든다.
|
||||
*
|
||||
* @param products 검색 결과 상품 배열 (SearchProductsListener 방출 형태)
|
||||
*/
|
||||
function createUtils(products: Array<Record<string, unknown>>) {
|
||||
return createLayoutTest(testLayout as any, {
|
||||
componentRegistry: ComponentRegistry.getInstance(),
|
||||
initialData: { search_products: { data: products } },
|
||||
} as any);
|
||||
}
|
||||
|
||||
describe('통합검색 상품 리스트형 썸네일 (partials/search/products/_item_list.json)', () => {
|
||||
let cleanup: (() => void) | null = null;
|
||||
|
||||
afterEach(() => {
|
||||
cleanup?.();
|
||||
cleanup = null;
|
||||
});
|
||||
|
||||
it('thumbnail_url 이 있으면 그 값으로 Img 가 렌더된다 (死키 thumbnail 미의존)', async () => {
|
||||
setupTestRegistry();
|
||||
const utils = createUtils([
|
||||
{
|
||||
id: 1,
|
||||
name: '검색 상품',
|
||||
category_name: '카테고리',
|
||||
thumbnail_url: '/api/plugins/sirsoft-ckeditor5/images/abc123',
|
||||
selling_price_formatted: '10,000원',
|
||||
},
|
||||
]);
|
||||
cleanup = () => utils.cleanup();
|
||||
|
||||
await utils.render();
|
||||
|
||||
const img = screen.getByTestId('product-thumb');
|
||||
expect(img.getAttribute('src')).toBe('/api/plugins/sirsoft-ckeditor5/images/abc123');
|
||||
expect(screen.queryByTestId('icon-image')).toBeNull();
|
||||
});
|
||||
|
||||
it('thumbnail_url 이 없으면 Img 대신 placeholder 아이콘이 렌더된다', async () => {
|
||||
setupTestRegistry();
|
||||
const utils = createUtils([
|
||||
{
|
||||
id: 2,
|
||||
name: '이미지 없는 상품',
|
||||
category_name: '카테고리',
|
||||
thumbnail_url: null,
|
||||
selling_price_formatted: '5,000원',
|
||||
},
|
||||
]);
|
||||
cleanup = () => utils.cleanup();
|
||||
|
||||
await utils.render();
|
||||
|
||||
expect(screen.queryByTestId('product-thumb')).toBeNull();
|
||||
expect(screen.getByTestId('icon-image')).toBeTruthy();
|
||||
});
|
||||
});
|
||||
@@ -15,12 +15,14 @@
|
||||
"og": {
|
||||
"type": "website",
|
||||
"title": "{{page.data.title ?? ''}}",
|
||||
"description": "{{page.data.excerpt ?? ''}}"
|
||||
"description": "{{page.data.seo_meta?.description ?? ''}}",
|
||||
"image": "{{page.data.content_thumbnail_url ?? ''}}"
|
||||
},
|
||||
"structured_data": {
|
||||
"@type": "WebPage",
|
||||
"name": "{{page.data.title ?? ''}}",
|
||||
"description": "{{page.data.excerpt ?? ''}}",
|
||||
"description": "{{page.data.seo_meta?.description ?? ''}}",
|
||||
"image": "{{page.data.content_thumbnail_url ?? ''}}",
|
||||
"datePublished": "{{page.data.created_at ?? ''}}",
|
||||
"dateModified": "{{page.data.updated_at ?? ''}}"
|
||||
}
|
||||
@@ -302,7 +304,7 @@
|
||||
"if": "{{!att_item.is_image}}",
|
||||
"props": {
|
||||
"name": "file",
|
||||
"className": "text-gray-400 text-sm flex-shrink-0"
|
||||
"className": "text-gray-400 dark:text-gray-500 text-sm flex-shrink-0"
|
||||
}
|
||||
},
|
||||
{
|
||||
|
||||
@@ -12,9 +12,25 @@
|
||||
"props": { "className": "w-16 h-16 flex-shrink-0 rounded-lg overflow-hidden bg-gray-100 dark:bg-gray-700" },
|
||||
"children": [
|
||||
{
|
||||
"comment": "생산측(SearchProductsListener)은 thumbnail_url 키를 방출한다 — thumbnail 은 死키였다 (공개 #22 부수 정정)",
|
||||
"type": "basic",
|
||||
"name": "Img",
|
||||
"props": { "src": "{{product.thumbnail}}", "alt": "{{product.name}}", "className": "w-full h-full object-cover" }
|
||||
"if": "{{product.thumbnail_url}}",
|
||||
"props": { "src": "{{product.thumbnail_url}}", "alt": "{{product.name}}", "className": "w-full h-full object-cover" }
|
||||
},
|
||||
{
|
||||
"comment": "이미지가 없는 경우 플레이스홀더 (board 카드형 패턴 축소 미러)",
|
||||
"type": "basic",
|
||||
"name": "Div",
|
||||
"if": "{{!product.thumbnail_url}}",
|
||||
"props": { "className": "w-full h-full flex items-center justify-center bg-gray-200 dark:bg-gray-700" },
|
||||
"children": [
|
||||
{
|
||||
"type": "basic",
|
||||
"name": "Icon",
|
||||
"props": { "name": "image", "className": "text-gray-400 dark:text-gray-500" }
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
},
|
||||
|
||||
+2
-2
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"name": "sirsoft-basic",
|
||||
"version": "1.1.1",
|
||||
"version": "1.1.2",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "sirsoft-basic",
|
||||
"version": "1.1.1",
|
||||
"version": "1.1.2",
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"@dnd-kit/core": "^6.3.1",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "sirsoft-basic",
|
||||
"version": "1.1.1",
|
||||
"version": "1.1.2",
|
||||
"description": "Gnuboard7 Basic User Template Components - Nexibase Style",
|
||||
"type": "module",
|
||||
"main": "dist/components.js",
|
||||
|
||||
@@ -5,7 +5,7 @@
|
||||
"ko": "Basic",
|
||||
"en": "Basic"
|
||||
},
|
||||
"version": "1.1.1",
|
||||
"version": "1.1.2",
|
||||
"license": "MIT",
|
||||
"description": {
|
||||
"ko": "그누보드7 기본 사용자 템플릿",
|
||||
@@ -22,12 +22,12 @@
|
||||
"url": "https://sirsoft.com"
|
||||
},
|
||||
"release_date": "2026-01-07",
|
||||
"g7_version": ">=7.0.6",
|
||||
"g7_version": ">=7.0.9",
|
||||
"dependencies": {
|
||||
"modules": {
|
||||
"sirsoft-board": ">=1.0.0",
|
||||
"sirsoft-ecommerce": ">=1.1.0",
|
||||
"sirsoft-page": ">=1.0.0"
|
||||
"sirsoft-page": ">=1.1.0"
|
||||
},
|
||||
"plugins": {
|
||||
"sirsoft-daum_postcode": ">=1.0.0"
|
||||
|
||||
Reference in new issue
Block a user