Locations Plugin 🌍

[merefield (Robert)]

	Summary	A Discourse plugin that adds structured and geocoded topic and user locations with map-based discovery
	Repository Link	https://github.com/merefield/discourse-locations
	Install Guide	How to install plugins in Discourse
	Sponsorship	Please consider becoming an ongoing sponsor of my open source work at a level that suits your or your organisation’s resources and needs to ensure this plugin gets the maintenance it deserves and continues to work for your site in the future.

Enjoying this plugin? Please it on GitHub!

Features

Discourse Locations provides the complete location-storage, geocoding, and map foundation. The optional Pro extension adds advanced discovery, automation, and users-map presentation while requiring this base plugin.

Feature	Base plugin	Pro extension
Structured topic locations and configurable input fields		—
Optional or required geocoding with multiple providers		—
Category and site-wide topic map views		—
User locations on posts, profiles, cards, and the directory map		—
Leaflet users map with local name and username search		—
Configurable location labels, flags, map markers, clustering, and tiles		—
Default a new topic to the current user’s location		—
Automated IP-based user-location estimation	—	Exclusive
Nearby-topic discovery based on the current user’s location	—	Exclusive
Optional location-aware Discourse Chatbot tools	—	Exclusive
Permission-aware group and result-limit users-map filters	—	Exclusive
Interactive WebGL users-map globe	—	Exclusive
Idle globe screen saver	—	Exclusive

Installing Pro adds its exclusive features to the base functionality; it does not replace the base plugin.

Configuration

The base plugin’s settings use the location_ prefix and control topic locations, geocoding, map display, user locations, and the standard users map.

Useful documentation:

• Administration settings
• Locations in topics
• Locations in categories

Privacy and storage

Users choose whether to save a profile location. Complete editable topic and user locations remain in base-owned custom fields, while plugin-owned projection tables support spatial queries and map ordering.

Raw location custom fields are not made globally public. Topic, profile, card, post, and directory responses expose only the location data required by that surface and respect Discourse’s profile and group visibility rules.

Pro extension

Discourse Locations Pro is an optional extension available to GitHub Sponsors as a thank-you for supporting ongoing development. Individual and independent-community sponsors receive access from the $7/month Bronze tier; businesses and institutions must sponsor at the $40/month Silver tier or above. Eligible sponsors receive private-repository installation instructions.

The Pro extension adds automated IP lookup, Nearby topics, Chatbot tools, enhanced users-map filters, the interactive globe, and the globe screen saver. Each optional automation or integration remains disabled until configured, and the Pro master setting can disable all Pro behaviour without disabling the base plugin.

Sponsor on GitHub to get Locations Pro

[ycrepeau]

저는 이 기술에 대해 매우 초보입니다. 플러그인을 설치했는데 (햄버거 메뉴에서 Map 명령어를 볼 수 있으며, 사용자 프로필 페이지에 위치 필드가 있고 nominatim을 통한 지리 참조도 정상적으로 작동합니다) 그런데…

에디터에서 “위치 추가” 버튼을 찾을 수 없습니다.

제 설정은 다음과 같습니다:

그리고 이것이 에디터 창입니다:

마지막으로, 플러그인을 설치한 방법은 다음과 같습니다:

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/discourse/docker_manager.git
          - git clone https://github.com/discourse/discourse-math.git
          - git clone https://github.com/paviliondev/discourse-events.git
          - git clone https://github.com/paviliondev/discourse-locations.git
          - git clone https://github.com/davidtaylorhq/discourse-whos-online.git
          - git clone https://github.com/discourse/twitter-profile-link.git
          - git clone https://github.com/discourse/discourse-tooltips.git

locale= en으로 설정하여 시도해 보았지만 결과는 동일합니다.

[ycrepeau]

음, 음, 수정 사항: 플러그인은 사용자 프로필에서 예상대로 작동합니다.

지도에 따르면, 저는 죽은 사람입니다. 지도가 몬트리올 최대 규모의 묘지 한가운데에 지점을 표시하고 있기 때문이죠:

[SouperC (NotSoSuper)]

사용하려는 각 카테고리별로 활성화해야 합니다.

[ycrepeau]

감사합니다! 잘 작동했습니다.

참고로 체크 표시는 기본적으로 “켜져” 있었지만!! 해당 기능이 실제로 작동하려면 설정 패널을 표시한 후 체크를 해제하고 다시 체크해야 합니다.

[SouperC (NotSoSuper)]

동작하는 걸 확인해서 다행이에요. 플러그인을 한참 동안 안 써서 대충 추측한 거였거든요.

[Richie (Richie Rich)]

@angus 최근 사용자 프로필에 위치가 입력되지 않은 경우 이 문제가 발생하는 것을 확인했습니다:

하지만 모든 사용자에게 발생하는 것은 아니고, 정확한 패턴을 파악하기가 어렵습니다.

혹시 프로필에서 위치를 삭제한 사용자들일까요? 아니면 NULL 대신 빈 문자열(예: “”)인 경우일까요?

[omarfilip]

최근 업데이트로 인해 사용자 카드에서 위치 정보가 완전히 제거된 것 같습니다.

사용자 카드:

사용자 프로필:

[david (David Taylor)]

이 문제는 코어에서 발생한 다음 변경 사항으로 인해 발생한 가능성이 매우 높습니다:

사용자 카드 데이터 소스 변경

This is now the new default, and the setting has been removed https://github.com/discourse/discourse/commit/576872a2d93ce8546c5fded6d9edf5344c9bb4fe

[Richie (Richie Rich)]

@omarfilip @david 통찰력 있는 말씀 감사합니다

@angus 이 부분을 수정할 수 있으신가요?

[angus (Angus McLeod)]

@david @Richie 감사합니다. 이 플러그인은 해당 변경 사항을 지원하도록 업데이트되었습니다.

Add geo_location to user_card serializer

참고로, 이 플러그인은 곧 Pavilion의 다른 주요 플러그인과 동일한 업데이트 주기로 전환될 예정입니다. 이는 매월 첫 주에 최신 Discourse 코어와 호환되도록 업데이트된다는 의미입니다. 이 플러그인에 대한 구체적인 세부 사항은 추후 안내드리며, 아래 링크를 참고해 주세요:

• Topic List Previews (legacy) - #900 by merefield
• Angus' Events Plugin 📅 - #664 by fzngagan
• Question Answer Plugin - #228 by mbcahyono

[omarfilip]

빠르게 수정해 줘서 고마워, 앵거스.

[Richie (Richie Rich)]

안녕하세요 @angus 님, 위치가 이제 사용자 카드에 표시되는 것을 확인했습니다. 하지만 여전히 일부 사용자는 위치를 입력하지 않았음에도 지도 핀과 지도 아이콘이 표시되는 문제를 보고하고 있습니다:

그리고 전체 프로필 페이지에서도:

[k4rtik (Kartik)]

현재 locations 플러그인 때문에 Discourse 앱을 시작할 수 없습니다. 아래 로그를 첨부합니다. app.yml에서 locations를 주석 처리하면 정상적으로 작동합니다. 이 문제를 우선적으로 처리해 수정해 주실 수 있을까요?

또한, 메인 Discourse 앱이 그러하듯, 테스트가 통과한 버전의 플러그인으로만 업그레이드할 수 있는 방법이 있을까요? 이렇게 하면 앞으로 이러한 문제에 직면하지 않을 수 있을 것 같습니다.

Log

5: from /var/www/discourse/plugins/discourse-layouts/plugin.rb:49:in `block in activate!'
4: from /var/www/discourse/lib/discourse_event.rb:13:in `trigger'
3: from /usr/local/lib/ruby/2.6.0/set.rb:338:in `each'
2: from /usr/local/lib/ruby/2.6.0/set.rb:338:in `each_key'
1: from /var/www/discourse/lib/discourse_event.rb:14:in `block in trigger'
/var/www/discourse/plugins/discourse-locations/plugin.rb:234:in `block in activate!': uninitialized constant DiscourseLayouts::WidgetHelper
Did you mean?  DiscourseLayouts::WidgetSerializer (NameError)

** INCOMPATIBLE PLUGIN **

You are unable to build Discourse due to errors in the plugin at
/var/www/discourse/plugins/discourse-locations

Please try removing this plugin and rebuilding again!
I, [2020-04-25T20:32:06.399307 #1]  INFO -- : gem install icalendar -v 2.4.1 -i /var/www/discourse/plugins/discourse-events/gems/2.6.5 --no-document --ignore-dependencies --no-user-install
HEADS UP! iCalendar 2.0 is not backwards-compatible with 1.x. Please see the README for the new syntax

HEADS UP! icalendar 2.2.0 switches to non-strict parsing as default. Please see the README if you
rely on strict parsing for information on how to enable it.

ActiveSupport is required for TimeWithZone support, but not required for general use.
Successfully installed icalendar-2.4.1
1 gem installed
gem install geocoder -v 1.4.4 -i /var/www/discourse/plugins/discourse-locations/gems/2.6.5 --no-document --ignore-dependencies --no-user-install
Successfully installed geocoder-1.4.4
1 gem installed

I, [2020-04-25T20:32:06.400580 #1]  INFO -- : Terminating async processes
I, [2020-04-25T20:32:06.400773 #1]  INFO -- : Sending INT to HOME=/var/lib/postgresql USER=postgres exec chpst -u postgres:postgres:ssl-cert -U postgres:postgres:ssl-cert /usr/lib/postgresql/10/bin/postmaster -D /etc/postgresql/10/main pid: 50
I, [2020-04-25T20:32:06.400979 #1]  INFO -- : Sending TERM to exec chpst -u redis -U redis /usr/bin/redis-server /etc/redis/redis.conf pid: 167
167:signal-handler (1587846726) Received SIGTERM scheduling shutdown...
2020-04-25 20:32:06.401 UTC [50] LOG:  received fast shutdown request
2020-04-25 20:32:06.403 UTC [50] LOG:  aborting any active transactions
2020-04-25 20:32:06.406 UTC [50] LOG:  worker process: logical replication launcher (PID 59) exited with exit code 1
167:M 25 Apr 2020 20:32:06.406 # User requested shutdown...
167:M 25 Apr 2020 20:32:06.406 * Saving the final RDB snapshot before exiting.
2020-04-25 20:32:06.409 UTC [54] LOG:  shutting down
2020-04-25 20:32:06.439 UTC [50] LOG:  database system is shut down
167:M 25 Apr 2020 20:32:06.502 * DB saved on disk
167:M 25 Apr 2020 20:32:06.502 # Redis is now ready to exit, bye bye...


FAILED
--------------------
Pups::ExecError: cd /var/www/discourse && su discourse -c 'bundle exec rake db:migrate' failed with return #<Process::Status: pid 13098 exit 1>
Location of failure: /pups/lib/pups/exec_command.rb:112:in `spawn'
exec failed with the params {"cd"=>"$home", "hook"=>"db_migrate", "cmd"=>["su discourse -c 'bundle exec rake db:migrate'"]}
b5a02d7f9df6b6a9dc160e269de30eef49bb0aeaf5dcb1b712bab5e6edad4030
** FAILED TO BOOTSTRAP ** please scroll up and look for earlier error messages, there may be more than one.
./discourse-doctor may help diagnose the problem.
root@discuss:/var/discourse#

[angus (Angus McLeod)]

@k4rtik 신고해 주셔서 감사합니다. 불편을 겪으셨다니 죄송합니다. 문제가 발생한 이유는 다음과 같습니다:

1. layouts 플러그인이 2일 전에 업데이트되었습니다.
2. locations 플러그인은 기존 layouts 플러그인 버전을 지원하고 있었습니다.
3. 두 플러그인을 모두 사용 중입니다.
4. layouts 플러그인의 초기 업데이트와 locations 플러그인에 지원이 추가되기 사이에 Discourse를 업데이트했습니다.

locations 플러그인을 업데이트하여 새로운 layouts 플러그인 버전을 지원하도록 했습니다: Update to support layouts v0.2 · merefield/discourse-locations@52aec30 · GitHub. 이제 두 플러그인이 모두 설치된 상태에서 업데이트하면 정상적으로 작동할 것입니다. @Richie 이 문제로 인한 해결책입니다: Add include? to geo_json in user_card serializer · merefield/discourse-locations@5185063 · GitHub

이러한 특정 상황이나 기타 상당수의 플러그인 호환성 문제 상황에서 플러그인에 tests-passed 브랜치를 유지하는 것은 큰 도움이 되지 않을 것입니다. 사람들은 다양한 주기로 업데이트를 수행하며, 다양한 커스터마이징 조합을 가지고 있기 때문입니다.

그럼에도 불구하고, 이 문제를 해결하기 위해 몇 가지 조치를 취하기 시작했습니다. 5월 1일부터 5일까지 매월 첫 5일 동안, Pavilion의 주요 오픈소스 플러그인(이 플러그인, Events, Topic List Previews 등)이 Discourse와 항상 최신 상태를 유지하도록 24시간 주기의 일정을 운영할 예정입니다.

이를 통해 try.thepavilion.io의 모든 플러그인과 Discourse 자체를 업데이트할 때 다음과 같은 확실성이 높아지는 안전한 업데이트 기간을 확보하게 됩니다:

1. 플러그인과 Discourse 간의 충돌을 경험하지 않으며, 충돌이 발생하더라도 24시간 이내에 해결됩니다.

2. 플러그인 자체의 변경 사항으로 인한 문제를 경험하지 않습니다. 플러그인 자체에 잠재적으로 호환성을 깨뜨릴 수 있는 변경 사항은 이 기간 밖에서 이루어집니다.

이 정책은 여기에 나열된 모든 플러그인에 적용됩니다:

이 목록은 시간이 지남에 따라 확장될 수 있습니다. 자세한 내용은 다음을 참조하세요: https://try.thepavilion.io.

이와 관련하여 질문이 있으시면 편하게 DM을 보내거나 thepavilion.io를 통해 저희에게 연락해 주세요.

[k4rtik (Kartik)]

고마워요, 네, 마지막 업데이트 이후로 왜 커스텀 레이아웃이 표시되지 않는지 알아보고 있었거든요. 그래도 아직은 안 보이지만, Pavilion에서 플러그인 변경 사항에 대한 업데이트된 문서를 공개하는 과정에 있다는 걸 확인했으니, 조금 기다려볼게요.

[Richie (Richie Rich)]

@angus

@Richie 이 방법으로 문제를 해결할 수 있습니다: Add include? to geo_json in user_card serializer · paviliondev/discourse-locations@5185063 · GitHub

@angus 확인했습니다 - 문제가 해결되었습니다

이 플러그인에 대한 지속적인 지원에 다시 한번 감사드립니다

[Richie (Richie Rich)]

안녕하세요 @angus. 이 스레드의 첫 번째 게시글이 수정되었다는 알림을 확인했습니다.

리포지토리의 위치가 변경된 것 같습니다.

모두가 discourse 설정을 새 위치로 업데이트해야 하는지, 아니면 기존/기존 위치도 계속 업데이트되는지 궁금합니다.

플러그인 소스 위치를 변경한 후 무언가를 다시 빌드해야 하나요?

[angus (Angus McLeod)]

Hey @Richie, 기존 URL인 https://github.com/angusmcleod/discourse-locations를 계속 사용하셔도 됩니다. 다른 이유로 사이트를 다시 빌드해야 하는 등 자연스러운 기회가 있을 때 업데이트하시면 됩니다.

이 플러그인은 얼마 전 제 개인 GitHub에서 Pavilion의 GitHub으로 이전되었습니다. 저장소가 이전되면 GitHub이 자동으로 기존 위치를 가리키는 모든 링크를 새 위치로 리디렉션합니다.

첫 번째 게시물은 앞으로 몇 주 동안 조금 더 변경될 예정입니다. thepavilion.io에 관련 문서를 작성하고, 이곳 메타에는 더 짧은 설명을 추가할 계획입니다.

[Richie (Richie Rich)]

@angus

리포지토리가 이전되면 Github은 기존 위치를 가리키는 모든 링크를 자동으로 새 위치로 리디렉션합니다.

훌륭네요, 그걸 몰랐습니다

다시 한번 도움 주셔서 감사합니다!