Listora
검수 기능이 있는 지역 디렉터리: 검색, 지도, 10가지 목록 유형, 회원 제출, 리뷰, 소유권 신청, 대시보드.
플러그인
Listora
검수 기능이 있는 지역 디렉터리: 검색, 지도, 10가지 목록 유형, 회원 제출, 리뷰, 소유권 신청, 대시보드.
설명
Listora는 EmDash 사이트를 지역 디렉터리로 바꿔 줍니다. 방문자는 검색하고 지도에서 목록을 둘러볼 수 있습니다. 회원은 목록을 추가하고, 리뷰를 쓰고, 즐겨찾기를 저장하고, 비즈니스의 소유권을 신청할 수 있습니다. 모든 항목은 공개되기 전에 관리자 화면에서 사용자가 승인합니다.
제공되는 기능
- 디렉터리와 검색. 키워드 및 위치 검색, 유형·카테고리·도시별 필터, 그리드와 목록 보기, 추천 행, 지도.
- 10가지 목록 유형. 비즈니스와 음식점부터 이벤트, 채용, 부동산까지, 각각 고유한 필드와 schema.org 유형을 가집니다.
- 회원 제출. 중복 확인, 차단 단어 목록, 시간당 제한이 있는 다섯 단계 양식.
- 리뷰와 소유권 신청. 회원 한 명당 목록 하나에 리뷰 하나이며, 소유자는 자신의 비즈니스를 신청할 수 있습니다. 둘 다 승인을 기다립니다.
- 소유자 도구. 소유자는 자신의 목록을 편집하고, 사진을 추가하고, 방문자의 메시지를 읽고, 리뷰에 답글을 달고, 만료가 다가오는 목록을 갱신할 수 있습니다. 편집, 사진, 답글은 사용자의 승인을 기다립니다.
- 사진과 만료. 각 목록에 갤러리가 있고, 목록이 공개 상태로 유지되는 일수를 선택적으로 설정할 수 있습니다.
- 가져오기와 내보내기. 목록을 스프레드시트로 내려받거나, CSV 파일에서 한 번에 100개씩 초안으로 추가할 수 있습니다.
- 관리자 화면에서의 검수. 대기 중인 모든 항목을 위한 대기열, 그 수를 세는 대시보드 카드, Settings 페이지.
전체 구조
Listora는 엔진입니다. 라우트, 저장소, 관리자 화면을 담당합니다. EmDash 플러그인은 사이트에 페이지를 추가할 수 없으므로 공개 페이지는 하나의 명령으로 복사되는 키트로 제공됩니다. 개발자에게 10분 정도의 시간을 주세요. 설치를 참고하세요.
손님은 목록을 둘러보고 메시지를 보낼 수 있습니다. 추가, 리뷰, 저장, 소유권 신청에는 계정이 필요합니다.
요청하는 권한
- 콘텐츠(읽기, 쓰기, 게시)와 콘텐츠 유형(읽기): 목록은 사이트의 콘텐츠입니다.
- 카테고리(읽기, 지정): 양식에는 사용자의 카테고리가 표시됩니다.
- 미디어(추가): 소유자의 사진.
- 이메일(전송): 메시지가 대기 중이거나 목록이 곧 만료될 때 소유자에게 보내는 짧은 알림. 방문자의 글은 이메일로 보내지 않으며 각 알림은 끌 수 있습니다.
설치
설치하기 전에
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: 아직 지원되지 않습니다. Cloudflare Workers에서 EmDash는 플러그인 호출 한 번에 사이트로의 요청 10개를 허용하는데, 이 플러그인의 여러 페이지와 작업은 그보다 더 필요해서 실패합니다. 이에 맞는 릴리스를 준비 중입니다. Node 사이트는 영향을 받지 않습니다.
개발 서버를 멈췄다가 다시 시작하세요. 이제 관리자 메뉴에 Registry가 표시됩니다.
2. 플러그인은 엔진입니다. 방문자 페이지는 사이트 키트에서 옵니다. 레지스트리 플러그인은 사이트에 페이지를 추가할 수 없습니다. 키트를 복사하기 전까지는 해당 주소(예: /listings/)에서 사이트의 404 페이지가 표시됩니다. 이는 정상입니다. 아래의 키트 복사는 명령 하나면 됩니다.
3. Node 22.16 이상이 필요합니다. npx emdash seed 단계 때문입니다.
Node의 blog 템플릿으로 EmDash 1.3.1에서 확인했습니다.
설치 방법
-
Admin, Registry에서 Listora를 검색하고 Install한 다음 권한을 수락합니다.
-
사이트의 루트 폴더에서 다음을 실행합니다.
kit="$(mktemp -d)" && git clone --depth 1 \ --branch v0.6.3 \ https://github.com/wbcomdesigns/emdash-listora \ "$kit/emdash-listora" && "$kit/emdash-listora/scripts/add-to-site.sh" . -
출력된 seed 명령을 실행합니다. 개발 서버를 다시 시작합니다.
-
Admin, Menus에서 출력된 메뉴 링크를 추가합니다.
-
Listora를 열고 Get started를 선택합니다.
업데이트할 때마다 새 태그로 2단계를 다시 실행하세요.
전체 가이드: https://github.com/wbcomdesigns/emdash-listora/blob/v0.6.3/docs/website/getting-started/install.md
자주 묻는 질문
설치 후 /listings/가 404인 이유는 무엇인가요?
EmDash 플러그인은 페이지를 만들 수 없습니다. 설치 항목의 설정 명령을 실행해 사이트에 페이지를 추가한 다음 새로 고치세요.
손님이 목록이나 리뷰를 추가할 수 있나요? 아니요. 손님은 둘러보고 목록에 메시지를 보낼 수 있습니다. 목록 추가, 리뷰, 저장, 소유권 신청에는 로그인한 계정이 필요하며, 이로써 스팸이 줄고 모든 목록에 소유자가 생깁니다.
새 목록이 바로 공개되나요? Settings에서 승인을 끈 경우에만 그렇습니다. 켜 둔 상태(기본값)에서는 목록이 사용자가 승인할 때까지 대기열에서 기다립니다. 소유자의 편집, 사진, 리뷰 답글은 항상 사용자의 승인을 기다립니다.
다크 모드에서도 작동하나요? 네. 키트의 색상은 사이트 테마를 따릅니다.
이메일을 보내나요? 사이트에 이메일이 설정되어 있다면 목록 소유자에게 짧은 알림 두 가지를 보냅니다. 메시지가 대기 중이라는 알림과 목록이 7일 뒤에 만료된다는 알림입니다. 둘 다 방문자의 글을 담지 않으며 각각 Settings에서 끌 수 있습니다. 이메일이 없어도 소유자는 자신의 계정에서 모든 내용을 볼 수 있습니다.
유료 버전이 있나요? 아니요. 여기 있는 모든 것은 무료입니다.
블로그 글 안에 목록을 표시할 수 있나요?
네, 한 단계가 더 필요합니다. 키트에는 글과 페이지 본문용 Listings 블록이 들어 있으며 astro.config.mjs에서 켭니다. 추가할 줄은 설치 가이드에 있습니다.
스프레드시트의 목록을 옮겨 올 수 있나요?
네. 사이트 관리자는 /listings/import/에서 CSV 파일을 가져올 수 있습니다. 행은 먼저 검사되고 초안으로 들어오며, 파일당 최대 100개입니다.
변경 내역
0.6.3
업데이트한 후 사이트의 루트 폴더에서 키트를 다시 복사하세요.
kit="$(mktemp -d)" &&
git clone --depth 1 \
--branch v0.6.3 \
https://github.com/wbcomdesigns/emdash-listora \
"$kit/emdash-listora" &&
"$kit/emdash-listora/scripts/add-to-site.sh" .
- 수정: 도중에 중단된 승인은 목록이나 사진을 대기열로 되돌립니다. More reviews 위에 리뷰 양식과의 여백을 추가했습니다. 손상된 리뷰 링크는 간단한 메시지를 표시합니다.
- 개선: 계정 탭이 휴대폰에서 줄바꿈됩니다. 리뷰가 10개를 넘으면 계정에 전체 리뷰 수가 표시됩니다. 새 사이트에서는 Settings에 /listings/import/가 표시됩니다.
0.6.2
업데이트한 후 키트를 다시 복사하세요.
- 신규: Get started가 설치된 버전용 키트 명령과 그것이 추가하는 방문자 주소를 알려 줍니다.
- 수정: 대규모 사이트에서 목록이 더 이상 100행에서 멈추지 않습니다. 대기열의 샘플 목록을 승인할 수 있습니다. 오래된 두 번째 결정은 거부됩니다. 빈 디렉터리는 그렇다고 표시됩니다. 다크 모드 버튼이 4.5:1을 충족합니다.
- 보안: 새 목록은 각 필드를 길이 제한을 두어 저장합니다. 공개 상태 점검은 아무것도 기록하지 않습니다.
- 개선: 관리자 그룹 이름이 Listora로, 리뷰 페이지 이름이 Listing reviews로 바뀌었습니다.
0.6.1
- 보안: 지도 팝업은 목록 제목을 일반 텍스트로 표시합니다. 이메일은 일반 주소로만 저장됩니다. 업데이트한 후 키트를 다시 복사하세요.
- 수정: 갱신과 편집은 목록의 현재 소유자를 따릅니다.
0.6.0
- 보안: 웹사이트 링크는 전체 http 또는 https 주소여야 합니다. 서버 측 호출은 웹 요청 없이 EmDash 내부에서 실행됩니다.
- 개선: 설정이 탭으로 나뉘고, 모든 관리자 목록에 Find와 Load more가 생겼으며, 방문자에게 보이는 모든 문구가 하나의 파일에 모였습니다. 업데이트한 후 키트를 다시 복사하세요.
이전 버전: https://github.com/wbcomdesigns/emdash-listora/blob/main/CHANGELOG.md