과거에는 테마와 플러그인의 templates/ 디렉토리에 동일한 이름의 파일을 추가하여 Discourse의 Route 또는 Component에 대한 .hbs 템플릿을 오버라이드할 수 있었습니다. 이는 매우 강력한 기능이었지만, 유지보수 측면에서 상당한 문제를 동반하기도 했습니다.
따라서 지난 몇 년간 우리는 템플릿 오버라이드를 권장하지 않는 입장을 유지해 왔으며, 2024년 11월에 이를 공식적으로 비추천(deprecated) 처리했습니다. 현재 더 나은 해결책은 Wrapper Plugin Outlets를 사용하여 코어 콘텐츠 대신 콘텐츠를 렌더링하는 것입니다.
이번 달(2025년 3월)에는 템플릿 오버라이드에 대한 관리자 경고 배너를 도입할 예정이며, Q2 종료 전까지 해당 기능에 대한 지원을 완전히 제거할 계획입니다.
타임라인
(예상 날짜 - 변경될 수 있음)
2024년 11월 - 비추천(deprecation) 도입
2025년 3월 - 관리자 경고 배너 활성화
2025년 6월 - 기능 제거 (6월 2주차 목표)
테마 / 플러그인 업그레이드
테마 및 플러그인 개발자는 Plugin Outlet 가이드를 참고하여 Wrapper Plugin Outlets에 대해 자세히 알아보세요. 사용 사례에 맞는 새로운 확장 포인트를 요청하고 싶으시다면 PR을 열거나 Development 토픽을 생성하는 것을 주저하지 마세요.
실험용 usercard 저장소를 아카이브로 이동했으며, 테마 컴포넌트를 더 이상 업데이트할 계획이 없습니다. 따라서 2025년 6월에 템플릿 오버라이드가 차단되기 전에 해당 기능을 비활성화하셔야 합니다.
향후 실험 기능의 일부가 코어에 반영되기를 희망하고 있지만, 구체적인 일정은 아직 정해지지 않았습니다. user-card는 UI에서 매우 광범위하게 커스터마이징된 부분이므로, 이 부분에 대한 대규모 변경 사항을 적용하려면 신중한 계획 수립과 생태계 전반에 걸친 조정이 필요합니다.
나도 지금 이 모호한 오류(기본 테마를 가리키는 것)가 나옵니다. 콘솔을 확인하라는 힌트가 도움이 되었어요. 이건 우리 커스텀 CSS에 있는 것 같은데, 이 포럼을 맡은 지 얼마 안 되어서 좀 더 파봐야 할 것 같아요. 언제부터 이게 깨지나요? 미리 준비할 수 있도록 시간 계획을 세우고 싶어서요.
음. 재밌네. 우리 데브옵스 팀이 3.4.6으로 업데이트한 후에야 이 배너가 보이기 시작했어. 커스텀 오버라이드는 여전히 렌더링되고 있고 (위치와 외관에 대한 네 말은 맞아). chatgpt가 이 오버라이드가 하는 일을 오해하고 있는 건가 봐. 아직 이 모든 걸 파악하는 중이지
2024년 11월 - 비추천(deprecation) 도입
