Locations Plugin 🌍

[merefield (Robert)]

지금 진행 중인 프로토타입 작업의 미리보기입니다.

현재 및 최근 후원자들에게 일정 기간 동안(후원 등급과 관계없이) 이 기능에 대한 조기 액세스를 제공하려고 합니다.

앞으로는 개인 후원자/소규모 커뮤니티에게는 월 7달러, 비즈니스에게는 월 40달러부터 새로운 기능의 조기 액세스를 제공할 예정입니다.

[merefield (Robert)]

현재 스폰서들을 대상으로 한 얼리 액세스 초대장이 방금 발송되었습니다. 곧 과거 스폰서들에게도 이 범위를 확대할 예정이며, 일정 기간 동안 이러한 액세스가 유지된 후, 최소 스폰서십 수준을 유지해야 합니다.

스폰서 목록은 매일 검토되므로, Locations의 최신 기능을 사용하거나 제 작업을 지원하고자 하신다면 스폰서를 고려해 주세요.

백커스는 항상 수정 사항을 먼저 받게 됩니다.

기능은 개별적으로, 그리고 일정 지연 후 공개 저장소로 이전됩니다 …

[nathank (Nathan Kershaw)]

방금 자동 사용자 위치 결정(Automated User Location Determination) 기능을 구현했는데, 여기에는 Maxmind를 올바르게 설정하는 작업이 포함됩니다. 이 작업은 새로운 인스턴스에서 진행했습니다.

새로운 app.yml 파일은 훌륭하고 간결하지만, 더 이상 Maxmind 환경 변수가 주석으로 포함되어 있지 않습니다.

이 기능이 자신감이 없는 셀프호스팅 시스템 관리자에게 더 접근하기 쉬워야 한다면, 명확한 설명이 필요할 수 있습니다. 또한 다음 주제에 대한 링크를 제공해야 합니다:

MAXMIND를 역 IP 조회용으로 설정하기

What is MAXMIND and why would I want it? Discourse uses MAXMIND to provide geographical information for reverse IP lookups. [location] Without Maxmind’s database you’ll see something like this: [nolocation] Or perhaps you’ve noticed this message fly by when you rebuild your container: MaxMind IP database download requires an account ID and a license key Please set DISCOURSE_MAXMIND_ACCOUNT_ID and DISCOURSE_MAXMIND_LICENSE_KEY. See https://meta.discourse.org/t/configure-maxmind-for-reverse…

---

그리고 - 사소한 UX 관련 사항

원치 않는(저는 원치 않습니다) 지도 링크가 사이드바에 표시되며, 이는 어떤 설정으로도 제어되지 않습니다. 저는 다음과 같이 이를 숨겼습니다:

// 사용자 지도 링크 숨기기
.sidebar-sections li[data-list-item-name="users map"] {
    display: none;
}

아마도 이 링크와 (설정으로 제어되는) 주제 지도 링크를 모두 비추천(deprecate)할 때가 된 것 같습니다. 관리자가 원한다면 이제 표준 UI를 통해 이들을 쉽게 추가할 수 있습니다.

[Moin]

@nathank

이제 관리자가 원할 경우 표준 UI를 통해 쉽게 추가할 수 있으므로, 이 기능과 (설정으로 제어되는) 토픽 맵 링크를 모두 비추천(deprecate)할 때가 되지 않았을까요?

현재 관리자가 사이드바에 추가한 링크는 번역이 불가능합니다. 따라서 사용자가 서로 다른 인터페이스 언어를 선호할 수 있는 커뮤니티의 경우, 사이드바에 링크를 추가하는 플러그인이 여러 언어로 번역하고 표시할 수 있는 옵션을 제공합니다.

[gilles]

카테고리에 주제 지리 위치 설정을 허용할 수 없다는 것을 발견했습니다

변경 사항을 저장할 수 있는 옵션이 제공되지 않습니다 (현재 버전은 2026.5.0-latest입니다)

[merefield (Robert)]

이 문제는 이제 수정되었습니다.

해당 수정 사항은 호환성 관련 수정 사항들과 함께 Early Access 버전과 공개(Public) 버전의 저장소에 배포되어야 합니다.

이 작업의 일환으로 버전 간 차이를 확대했습니다.

충분한 권한을 가진 스폰서에게 공개되는 Early Access 버전에는 현재 공개 버전의 Locations에 없는 다음과 같은 기능이 포함되어 있습니다:

제목	설명
사용자 지도 지구본	사용자 지도에 아바타를 위치 기반으로 배치하고, 드래그/터치 회전, 줌, 초기화, 검색 포커스, 사용자 카드 클릭, 그리고 항상 켜져 있는 범프 매핑을 지원하는 인터랙티브 3D 지구본 뷰를 추가합니다.
지구본 스크린세이버	헤더 아래에서 사용자 아바타가 표시되는 회전하는 3D 지구본을 보여주는 선택적 실험적 유휴 스크린세이버입니다.
향상된 사용자 지도 필터	사용자 지도에서 결과 제한, 검색 유형, 검색어, 그룹 필터링을 위한 컨트롤을 추가합니다.
가까운 주제 필터	현재 사용자의 위치를 기준으로 한 거리 기반의 가까운 주제 목록 필터를 추가합니다.
IP 기반 사용자 위치 조회	IP 데이터를 기반으로 사용자 위치를 자동으로 추정하여 저장하며, 설정 가능한 트리거 모드, 세밀도, 쿨다운, GeoNames 해석, 기존 값이 있을 경우 건너뛰기 동작, 그리고 디버그 로깅을 지원합니다.

이것은 유지 관리되는 공개 버전이 약간 하향 조정되었음을 의미합니다. 제 스폰서들이 충분한 혜택을 받을 수 있도록 보장해야 하므로 어쩔 수 없는 조치입니다.

이 추가 기능들을 원하신다면, 저를 스폰서로 후원해 주시고 Early Access를 포함하는 월간 티어를 선택해 주세요. 적절한 티어로 후원해 주시면 24시간 이내에 Early Access 버전에 접근할 수 있습니다.

[gilles]

@merefield 님, 빠른 대응 감사합니다 .

[Roi]

최근 Discourse 버전에서 비추천(deprecation) 알림을 우연히 발견했습니다:

[PLUGIN discourse-locations] 비추천 알림: model:composer에 api.modifyClass를 사용하는 것은 비추천됩니다. 대신 addModelField, addModelAccessor/addModelGetter/addModelSetter, addModelMethod, addModelSaveProperty, addModelCallback API를 사용하세요. [Discourse 2026.8부터 비추천] [deprecation id: discourse.modify-class-model]

상상 속 친구에게 물어보았지만, 제 초보적인 프로그래밍 실력으로는 해결하기가 힘든 것 같습니다…

[Jagster (Jakke Flemming)]

참고:

[관리자 공지] 플러그인 'discourse-locations'에는 업데이트가 필요한 코드가 포함되어 있습니다. (id:discourse.modify-class-model)

[Viddekla (Julian Müller)]

저도 같은 문제를 겪고 있습니다:

마지막 업데이트 후 관리자 안내

[Bildschirmfoto 2026-08-08 um 13.00.26] [Admin-Hinweis] Plug-in ‘discourse-locations’ enthält Code, der aktualisiert werden muss. (ID:discourse.modify-class-model)​ [Admin-Hinweis] Eines deiner Themes oder Plug-ins enthält Code, der aktualisiert werden muss. (ID:discourse.legacy-array-like-object.proxied-array) Seit dem letzten Update erhalte ich ständig diese beiden Fehlermeldungen. Was kann ich da tun?

[merefield (Robert)]

이 문제는 @cvx 님의 기여로 해결되었습니다 (사실 5일 전에 해결되었습니다! )

최근 PR

PR	주요 목적	작성자
#168	보안 경고를 해결하기 위해 Ruby 및 JavaScript 의존성을 업데이트합니다.	angusmcleod
#169	비추천되는 Composer modifyClass 사용법을 현대적인 모델 확장 API로 교체합니다.	cvx
#171	Composer 위치 기본값 테스트를 확장하고 카테고리 전환 시 위치 동기화 문제를 수정합니다.	merefield
#172	플러그인 린팅 및 개발 도구를 현재 Discourse 플러그인 스켈레톤과 동기화합니다.	merefield
#173	use-after-free 취약점을 수정하기 위해 Ruby json 제물을 2.21.1에서 2.21.2로 업그레이드합니다.	dependabot
#174	위치 검색 오류 처리를 복원하고, 빈 지오코딩 요청을 방지하며, 맵 안전 장치 및 회귀 테스트 커버리지를 개선합니다.	merefield

기여해 주신 @angus 님과 @cvx 님께 감사드립니다.

이 변경사항은 무료 플러그인과 스폰서 전용 조기 접근 플러그인 모두에 적용되었습니다.

또한, Chatbot을 사용하여 사용자 위치를 논의할 수 있도록 하는 코드는 스폰서 전용 저장소의 추가 기능적 역량을 한층 더 강화하기 위해 Locations Early Access로 이동되었습니다.

[merefield (Robert)]

오늘 저는 얼리 액세스에서 메인 플러그인으로 여러 비기능적 개선 사항을 백포트했습니다:

DEV: Back-port shared early-access improvements (#175)

[merefield (Robert)]

북마크 메모 플러그인과 유사하게, Locations를 재구성하여 프로 스폰서가 아니더라도 이 플러그인을 사용하려면 기본적으로 기반 플러그인이 필요합니다.

이는 유지보수 작업을 간소화하기 위해 필요한 조치였습니다. 이를 통해 기본 기능에 대한 지원이 더 신속하게 이루어질 수 있도록 보장할 수 있습니다. 또한 이전에 “얼리 액세스”라고 불리던 버전을 스폰서 전용 기능이 포함된 확정된 프리미엄 확장으로 확립합니다.

기존의 얼리 액세스 클론 명령어를 app.yml에서 다음으로 교체하세요. 이때 기반 플러그인을 먼저 배치해야 합니다:

  git clone https://github.com/merefield/discourse-locations.git
  git clone https://YOUR_GITHUB_USERNAME:YOUR_TOKEN@github.com/merefield/discourse-locations-pro-ext.git

그 후 Discourse를 정상적으로 다시 빌드하세요. 기존 위치 데이터는 유지되므로 수동 마이그레이션은 필요하지 않습니다.

이름 변경 후에도 저장소 접근 권한은 유지되어야 합니다. 접근 또는 설치 문제가 발생하면 메시지로 알려주시면 기꺼이 도움을 드리겠습니다.

비스폰서 사용자의 경우 추가 조치가 필요하지 않습니다. 기반 플러그인은 업데이트되었지만, 사이트는 해당 플러그인을 사용하여 정상적으로 빌드될 것입니다!

계속된 관심과 지원에 감사드립니다!

GitHub에서 월 7달러 이상의 브론즈 등급으로 스폰서를 등록하면 Locations Pro에 접근할 수 있습니다

기능

Discourse Locations는 완전한 위치 저장, 지오코딩, 지도 기반을 제공합니다. 선택적인 Pro 확장 기능은 고급 탐색, 자동화, 사용자 지도 표시를 추가하며, 이 기반 플러그인을 요구합니다.

기능	기반 플러그인	Pro 확장
구조화된 주제 위치 및 구성 가능한 입력 필드		—
여러 제공자를 통한 선택 또는 필수 지오코딩		—
카테고리 및 사이트 전체 주제 지도 보기		—
게시물, 프로필, 카드, 디렉터리 지도에 표시되는 사용자 위치		—
지역 이름 및 사용자 이름 검색이 가능한 Leaflet 사용자 지도		—
구성 가능한 위치 라벨, 국기, 지도 마커, 클러스터링, 타일		—
새 주제를 현재 사용자의 위치로 기본 설정		—
IP 기반 사용자 위치 자동 추정	—	독점
현재 사용자 위치 기반의 인근 주제 탐색	—	독점
위치 인식 Discourse Chatbot 도구 (선택)	—	독점
권한 인식 그룹 및 결과 제한 사용자 지도 필터	—	독점
인터랙티브 WebGL 사용자 지도 지구본	—	독점
유휴 지구본 화면 보호기	—	독점

Pro를 설치하면 독점 기능이 기본 기능에 추가되며, 기반 플러그인을 대체하지는 않습니다.

[merefield (Robert)]

이전에는 우회 조치로 추가되었지만, 이후 PM CSS가 일반적인 주제처럼 보이게 되었으므로 이를 제거하고, PM 사용자 위치 라벨 정렬을 다시 깔끔하게 가져오게 되었습니다:

FIX: Remove obsolete PM location offset (#184)

[neilernst (Neil)]

사용자 정의 위치를 저장할 방법이 있을까요? 예를 들어 여러 사람이 사용하는 외딴 산장 같은 경우, 이름이 아니라 좌표로 위치를 찾아야 하므로 쉽게 검색할 방법이 없습니다. 위도/경도 좌표 세트를 사용자 지정 이름과 함께 저장할 수 있다면 매우 유용할 것입니다.

[merefield (Robert)]

네. 좌표만 주제를 저장할 수 있습니다.

아래 사항을 확인해 주세요:

입력 필드를 끄면 위치 정보 제공자에 해당 위치 항목이 있는 한 일반 검색을 사용할 수 있습니다: