WB Reviews
기사와 페이지에 별점과 검수된 리뷰를 제공합니다.
설명
WB Reviews는 기사와 페이지에 별점과 검수된 리뷰를 추가합니다. 방문자는 평균, 별점 분포, 작성된 리뷰를 읽을 수 있습니다. 회원이나 게스트는 페이지당 리뷰를 하나 남길 수 있습니다. 무엇을 공개할지는 당신이 승인합니다.
제공 기능
- 모든 콘텐츠에 평점. 사이트 자체의 콘텐츠 유형을 이름으로 선택해 체크합니다. 게시물에만 묶여 있지 않습니다.
- 글 리뷰와 별점만. 글은 선택 사항입니다. 별점만 있는 평점은 평균에 포함되지만 목록에는 나타나지 않습니다.
- 회원 또는 누구나. 게스트는 이름(요청하는 경우 이메일도)을 입력합니다. 게스트 리뷰는 항상 승인을 기다립니다. 방문자당 리뷰는 하나입니다.
- 검수. 대기 중 및 게시됨 페이지, 텍스트로 찾기, 이메일로 게스트의 리뷰 삭제.
- 소유자 답글. 리뷰 아래에 관리자 화면에서 작성하는 공개 답글 하나.
- 검색 엔진. 평점이 구조화된 데이터로 페이지에 추가됩니다.
- 대기 중인 항목을 보여주는 대시보드 카드와, 리뷰 본문도 링크도 없는 선택적 시간당 이메일.
전체 구조
플러그인은 엔진입니다. 라우트, 스토리지, 관리자 화면을 담당합니다. EmDash 플러그인은 사이트에 페이지를 추가할 수 없으므로, 공개 화면은 한 번 복사해 넣는 사이트 키트로 제공됩니다. 설치를 참조하세요.
리뷰는 코어 댓글이 아닙니다. 댓글은 대화를 위해 그대로 남습니다. 이 플러그인이 더하는 것은 평점, 사람당 하나의 항목, 평균, 막대 분포, 그리고 소유자 답글입니다.
설치
설치하기 전에
1. 사이트에는 샌드박스 러너가 필요합니다. 레지스트리 플러그인은 샌드박스에서 실행됩니다. 사이트에 샌드박스 러너가 없는 동안에는 Admin, Plugins에 “No plugins configured”가 표시되고 메뉴에 Registry가 없습니다.
- Node: 사이트에서
npm install @emdash-cms/sandbox-workerd workerd를 실행한 다음,astro.config.mjs의emdash()안에sandboxRunner: "@emdash-cms/sandbox-workerd/sandbox",를 추가합니다. - Cloudflare:
import { sandbox } from "@emdash-cms/cloudflare";와sandboxRunner: sandbox(),를 추가합니다. Workers Paid 요금제,LOADER라는 이름의worker_loaders바인딩(Wrangler 설정에서 주석 해제), 그리고storage: r2(...)로 지정한 R2 버킷이 필요하며, 없으면 설치가 “Storage error while installing plugin”으로 중단됩니다. 그런 다음npm run deploy를 실행합니다.
개발 서버를 중지했다가 다시 시작하세요. 이제 관리자 메뉴에 Registry가 표시됩니다.
2. 플러그인은 엔진입니다. 방문자 페이지는 사이트 키트에서 나옵니다. 레지스트리 플러그인은 사이트에 페이지를 추가할 수 없습니다. 키트를 복사하기 전에는 그 주소(예: /account/reviews/)가 사이트의 404 페이지를 보여줍니다. 이는 정상입니다. 아래 키트 복사는 명령 하나면 됩니다.
EmDash 1.3.1에서 blog 템플릿으로 Node와 Cloudflare Workers(레지스트리 설치) 모두에서 확인했습니다.
설치 단계
-
Admin, Registry에서 WB Reviews를 검색하고, Install한 다음 권한을 수락합니다.
-
사이트의 루트 폴더에서:
kit="$(mktemp -d)" && git clone --depth 1 \ --branch v0.3.0 \ https://github.com/wbcomdesigns/emdash-reviews \ "$kit/emdash-reviews" && "$kit/emdash-reviews/scripts/add-to-site.sh" . -
출력된 줄을 붙여넣습니다. 개발 서버를 다시 시작합니다.
-
출력된 메뉴 링크를 Admin, Menus에 추가합니다.
-
Reviews, Waiting을 엽니다.
업데이트할 때마다 새 태그로 2단계를 실행하세요.
가이드: https://github.com/wbcomdesigns/emdash-reviews/blob/v0.3.0/docs/website/getting-started/install.md
자주 묻는 질문
설치 후 리뷰 블록이 보이지 않는 이유는 무엇인가요? 플러그인은 페이지나 CSS를 추가할 수 없습니다. 사이트 키트 컴포넌트를 템플릿에 복사한 다음 새로 고침하세요.
페이지에 리뷰 양식이 없는 이유는 무엇인가요? 해당 콘텐츠 유형이 Admin → Reviews → Settings에서 체크되어 있지 않습니다. 체크하지 않으면 양식은 숨겨진 채로 있습니다.
게스트도 리뷰를 쓸 수 있나요? 네. Settings에서 누구나 리뷰할 수 있도록 설정한 경우입니다. 게스트는 이름을 입력하고, 요청하는 경우 이메일도 입력합니다. 게스트 리뷰는 항상 승인을 기다립니다.
새 리뷰가 바로 공개되나요? 회원 리뷰만, 그리고 승인을 끈 경우에만 그렇습니다. 승인이 켜져 있으면(기본값) 리뷰는 당신이 승인할 때까지 기다립니다. 공개된 리뷰의 수정도 기다리며, 해당 변경을 승인하기 전까지는 게시된 글이 유지됩니다.
별점만 있는 평점이란 무엇인가요? 글이 없는 별입니다. 평균과 막대에는 포함되지만 작성된 글 목록에는 나타나지 않습니다.
이메일을 보내나요? 리뷰가 대기 중일 때 시간당 최대 한 통의 짧은 알림을 보내며, 이 기능을 켜고 사이트에 메일 기능(공식 Resend 플러그인)이 있는 경우에만 해당합니다. 알림에는 리뷰 본문도 링크도 없습니다.
유료 버전이 있나요? 아니요. 여기 있는 모든 것은 무료입니다.
변경 내역
0.3.0
- 개선: 모든 페이지, 관리자 작업, 방문자 요청이 플러그인 호출당 요청 10개라는 Cloudflare 제한 안에 들어갑니다. 카운트는 페이지의 모든 리뷰를 다시 읽는 대신 리뷰마다 갱신됩니다.
- 개선: 대기 중 및 게시됨 페이지가 날짜별로 나뉘며, Find는 한 번에 수백 개의 리뷰를 검색합니다. Delete all my reviews와 이메일로 삭제는 단계별로 진행됩니다.
- 수정: 같은 순간에 보낸 리뷰가 각각 한 번씩 집계됩니다. 0.2.0에서 손실된 평점은 다시 만들어집니다.
- 업데이트 후 관리자에서 Reviews를 여세요. 검수를 계속하는 동안 몇 단계에 걸쳐 0.2 데이터를 가져옵니다. 새 권한은 없습니다.
업데이트한 후에는 사이트의 루트 폴더에서 키트를 다시 복사하세요.
kit="$(mktemp -d)" &&
git clone --depth 1 \
--branch v0.3.0 \
https://github.com/wbcomdesigns/emdash-reviews \
"$kit/emdash-reviews" &&
"$kit/emdash-reviews/scripts/add-to-site.sh" .0.2.2
- 수정: 게시물 페이지와 게시물 카드에 이미 WB Reviews가 표시되는 사이트에서 scripts/add-to-site.sh를 다시 실행하면 해당 줄이 이미 있다고 알려줍니다.
0.2.1
- 보안: 호스트가 방문자 주소를 전달하는 곳(Cloudflare 또는 trustedProxyHeaders)에서만 게스트가 리뷰할 수 있으며, 그렇지 않으면 로그인해야 합니다. IPv6는 /64 단위로 집계합니다.
- 신규: Waiting에 Set up visitor pages가 표시됩니다. scripts/add-to-site.sh가 키트를 복사하고 붙여넣을 줄을 출력합니다.
- 수정: 대기 중인 리뷰가 더 이상 게시된 리뷰를 가리거나 평점을 깨뜨리지 않으며, 게시되지 않은 페이지에는 아무것도 표시되지 않습니다.
이전 버전: https://github.com/wbcomdesigns/emdash-reviews/blob/main/CHANGELOG.md