MODX Revolution
설치 안내 · 1.0.0-rc1
릴리스 후보 버전입니다. 운영 적용 전 CMS 버전, 테마, 프로젝트 공개 토큰으로 테스트 사이트에서 검증하세요. 마켓플레이스 인증을 주장하지 않습니다.
설치 전
Vinalfa 프로젝트를 만들고 Trial 또는 구독을 활성화한 뒤 공개 위젯 토큰에 사이트 도메인을 허용하세요. 여기에 서버 Bearer 토큰을 넣지 마세요.
설치 및 배치
- assets/components/vinalfa/Catalog.php를 복사하세요. elements/snippet.vinalfa.php에서 시작 PHP 태그를 빼고 VinalfaCatalog 스니펫을 만드세요.
- 별도 리소스에서 config_id, public_token, search_url, language를 전달해 [[!VinalfaCatalog]]를 호출하세요. 스니펫 소스이며 .transport.zip이 아닙니다.
CONFIG_ID, public widget token, 언어 및 {article}이 포함된 쇼핑몰 HTTPS 검색 URL을 입력하세요. Vinalfa 프로젝트에도 같은 URL을 설정하세요. 프로젝트 설정이 어댑터 값을 덮어쓸 수 있습니다. 쇼핑몰의 OEM/SKU 검색을 확인하세요.
[[!VinalfaCatalog? &config_id=`YOUR_CONFIG_ID` &public_token=`YOUR_PUBLIC_WIDGET_TOKEN` &search_url=`https://YOUR-STORE.example/search/?q={article}` &language=`ko`]]설치 후
VIN/FRAME → 차량 → 도면 → OEM 번호 → 쇼핑몰 검색, 새로 고침, 접근 오류와 한도를 테스트하세요. 320 px 이상 휴대폰에서 전체 흐름을 확인하고 캐시, CSP, JavaScript 최적화 도구를 점검하세요.
네이티브 어댑터는 별도 서버 규칙 없이 hash 라우팅을 사용합니다. 테마, 사이트 빌더 및 React/Vue 컴포넌트는 iframe을 사용하므로 내부 카탈로그 위치가 상위 페이지 URL에 저장되지 않습니다.
연동 범위
카탈로그, VIN/FRAME, 도면 및 쇼핑몰 검색 링크를 제공합니다. 가격, 재고, 장바구니와 주문은 쇼핑몰에서 처리합니다. 상품 가져오기와 가격 동기화는 포함되지 않습니다.
제거
먼저 페이지의 카탈로그와 메뉴 링크를 제거하세요. 이후 CMS 표준 기능으로 비활성화·제거하거나 백업 후 추가한 파일만 삭제하세요. Bitrix 모듈 제거 시 컴포넌트와 페이지는 보존되며 완전 삭제는 별도로 진행합니다.
빌드 검증
플러그인은 SQLite를 사용하는 WordPress 6.8.3에서 활성화, 설정, 쇼트코드, 제거를 검증했습니다. 다른 CMS는 전체 설치 없이 코드 및 개별 어댑터 시나리오를 확인했습니다. React/Vue와 설치 스크립트는 모의 API로 테스트하여 VIN 한도를 사용하지 않았습니다.