종속 플러그인 설정은 ... 정말 최고입니다!

커뮤니티 구축 칭찬
4

문서가 존재하지만, 현재는 독립적인 개발자 가이드로 제시되기보다는 단편적으로 나뉘어 있는 상태입니다.

주요 공식 참조 자료는 다음과 같습니다:

  • config/site_settings.yml:52의 스키마 문서: depends_on, depends_on_values, depends_behavior, dependent_setting_display를 다룹니다.
  • .skills/discourse-site-settings/SKILL.md:203의 더 자세한 가이드와 예시.
  • spec/lib/site_setting_extension_spec.rb:706의 백엔드 동작 스펙.
  • frontend/discourse/admin/services/admin-site-setting-store.js:41의 프론트엔드 의존성 해석.
  • frontend/discourse/tests/acceptance/admin-site-settings-test.js:142의 UI 예시.

기본 구문은 다음과 같습니다:

child_setting:
  default: ""
  depends_on:
     - parent_setting
  depends_behavior: "hidden"

열거형(enum) 또는 문자열 부모 설정의 경우:

 child_setting:
    default: ""
    depends_on:
      - parent_setting
    depends_on_values:
      parent_setting:
        - enabled_mode
        - another_mode
    depends_behavior: "hidden"
    dependent_setting_display: "inline"

중요한 제한 사항이 하나 있습니다: 의존성에는 여러 직접적인 부모 설정을 포함할 수 있지만, 의존성 해석은 이행적(transitive)이지 않습니다. A → B → C와 같은 중첩된 체인의 경우, C가 B가 A에 의해 숨겨져 있는지 자동으로 고려하지 않습니다. C는 단순히 B의 저장된 값만 평가합니다.

4개의 좋아요