 |
요약 | Discourse Custom Post Button은 Discourse 게시물 안의 링크를 스타일링된 버튼으로 변환합니다. |
 |
저장소 | github.com/koloki-co/discourse-custom-post-button |
 |
설치 가이드 | 테마 또는 테마 컴포넌트 설치하기 |
 |
Discourse 테마를 처음 사용하시나요? | Discourse 테마 사용 가이드 |
이 테마 컴포넌트 설치
이 커뮤니티 테마 컴포넌트는 Koloki Ltd에서 유지보수하고 있습니다. 공식 Discourse 컴포넌트가 아닙니다. 알파 버전이므로 버그가 있을 수 있습니다. 버그 보고 및 기능 요청은 GitHub 저장소에서 해주세요.
스크린샷
버튼
특정 사용 사례: ‘개인 메시지로 질문하기’ 버튼
기능
[wrap]를 사용하여 토픽이나 게시물 어디에서든 일반 링크를 버튼으로 변환합니다.- TC(테마 컴포넌트) 레벨에서 설정 가능한 기본 배경색, 모서리 반경, 패딩, 글꼴 굵기, 텍스트 색상, 호버 투명도를 제공하며, 그렇지 않으면 사이트 기본값을 사용합니다.
- 개별 버튼이 기본 배경색을 오버라이드할 수 있습니다.
- 버튼 옆에 설명 텍스트를 지원합니다.
- 기본 콘텐츠를 일반 링크로 유지하여 버튼이 외부 페이지나
/new-message와 같은 내부 Discourse 라우트를 열 수 있도록 합니다.
중요: 이 TC가 설치되어 있다면 포럼의 모든 사용자가 이러한 버튼을 만들 수 있습니다. 특정 사용자에게만 버튼 기능을 제한하려면 전체 플러그인이 필요합니다. 그러나 실제로는 사용자가 설치된 사실을 알고 버튼을 만드는 방법을 알아야 하므로 실제로 방법을 아는 사용자는 적을 것으로 추정됩니다. 또한 Watched Words를 사용하여
[wrap=custom-button]이 포함된 게시물을 승인 대기 상태로 필터링하여 기능을 제한할 수도 있습니다.
설치
관리자 > 외관 > 테마 및 컴포넌트에서 컴포넌트 탭을 열고, 설치를 선택한 후 Git 저장소 URL에서 설치를 선택하세요. 다음을 사용하세요:
https://github.com/koloki-co/discourse-custom-post-button
설치 후, 해당 컴포넌트가 사용 가능해야 하는 각 활성 테마에 추가하세요.
사용법
기본 버튼
TC 설정의 기본 버튼 색상이 사용됩니다.
[wrap=custom-button][Your Custom Button Text](https://example.com)[/wrap]
버튼별 색상 설정
[wrap=custom-button color=#7CC146][Your Custom Button Text](https://example.com)[/wrap]
버튼 뒤에 설명 텍스트 추가
[wrap=custom-button][Your Custom Button Text](https://example.com)[/wrap]
[wrap=text-after-button]Additional explanatory text[/wrap] (새 줄)
그룹으로 개인 메시지 열기
(참고: 이는 내장 Discourse 기능을 사용하여 미리 채워진 텍스트와 함께 Composer를 여는 것입니다 - 이 기능의 그 부분은 테마 컴포넌트에서 오는 것이 아니라, 가능한 사용 사례를 데모하기 위해 사용하는 것입니다. 해당 그룹으로의 PM을 허용하는 그룹 설정이 필요합니다.)
[wrap=custom-button][Ask Us a Question](/new-message?groupname=somegroup&title=Aask%20Us&body=Please%20type%20your%20question%20here.)[/wrap]
그룹의 ‘Full Name’ 대신 슬러그화된 name을 사용하고 파라미터 값은 URL 인코딩 하세요. 그룹의 이 그룹으로 메시지가 가능한 사람? 설정은 여전히 주소지정 Composer를 열 수 있는 사람을 결정하며, 로그인하지 않은 방문자는 로그인을 요청받게 됩니다.
설정
| 설정 | 목적 |
|---|---|
button_default_color |
기본 버튼 배경 및 테두리 색상 |
button_border_radius |
버튼 모서리 반경 |
button_padding |
버튼 라벨 주변의 여백 |
button_font_weight |
버튼 라벨 굵기 |
button_text_color |
버튼 라벨 색상 |
button_hover_opacity |
호버 시 버튼 투명도 |
이 컴포넌트는 사용 가능한 테마 아이콘을 위한 svg_icons 설정도 노출하지만, 현재 게시물 버튼에 아이콘을 삽입하지는 않습니다. 이에 대한 수요가 있다면 해당 기능을 추가할 것입니다.
참고 사항
- 이 컴포넌트는 표시 방식만 변경합니다. 버튼은 여전히 링크이며 대상 권한은 변경되지 않습니다.
- 활성 Discourse 테마를 로드하지 않는 이메일 클라이언트 및 기타 컨텍스트에서는 버튼 스타일링 없이 기본 링크가 표시될 수 있습니다.
- 이 컴포넌트는 MIT 라이선스 하에 배포됩니다.
이 컴포넌트는 토픽 게시물에 버튼 임베드하는 방법에서 논의된 유용한 [wrap] 패턴에서 발전했습니다.
