플러그인 설정
플러그인 설정설정 페이지, 환경 변수, wp-config, 훅을 통한 플러그인 설정

설정 페이지, 환경 변수, wp-config, 훅을 통한 플러그인 설정

플러그인의 옵션을 설정하는 방법은 여러 가지가 있습니다.

설정 페이지

설정 페이지를 통해 WordPress 관리 화면에서 플러그인을 설정할 수 있습니다.

열려면 플러그인 메뉴의 「Settings」 링크를 클릭하세요.

설정 페이지 열기

설정은 탭으로 구성되며, 각 탭은 모듈에 해당합니다.

설정 페이지

옵션을 업데이트한 후 Save Changes 버튼을 클릭하여 새 값을 저장하고 적용하세요.

환경 변수와 wp-config 상수를 통한 설정

설정 페이지의 모든 옵션은 환경 변수와 wp-config.php 파일에 정의된 상수를 통해서도 설정할 수 있습니다.

옵션 값을 선택하는 우선순위는 다음과 같습니다.

  1. 해당하는 환경 변수가 있으면 그것이 사용됩니다
  2. wp-config.php에 해당하는 상수가 정의되어 있으면 그것이 사용됩니다
  3. 그 외의 경우 설정 페이지의 값이 사용됩니다

환경 변수나 wp-config 상수를 추가하거나 수정한 후에는 플러그인 설정을 재생성해야 합니다. 이를 위해 설정 페이지로 이동하여 Save Changes를 클릭하세요.

환경 변수

모듈옵션환경 변수
Schema Editing AccessEditing Access SchemeEDITING_ACCESS_SCHEME
Single EndpointEndpoint PathGRAPHQL_API_ENDPOINT
Custom EndpointsEndpoint PathCUSTOM_ENDPOINT_SLUG_BASE
Persisted QueriesEndpoint PathPERSISTED_QUERY_SLUG_BASE
Graphiql For Single EndpointClient PathGRAPHIQL_CLIENT_ENDPOINT
Interactive Schema For Single EndpointClient PathVOYAGER_CLIENT_ENDPOINT
Public Private SchemaModeUSE_PRIVATE_SCHEMA_MODE
Public Private SchemaEnable GranularENABLE_INDIVIDUAL_CONTROL_FOR_PUBLIC_PRIVATE_SCHEMA_MODE
Schema NamespacingUse NamespacingNAMESPACE_TYPES_AND_INTERFACES
Nested MutationsEnable Nested MutationsENABLE_NESTED_MUTATIONS
Nested MutationsDisable redundant root type fieldsDISABLE_REDUNDANT_ROOT_TYPE_MUTATION_FIELDS
Cache ControlDefault Max AgeDEFAULT_CACHE_CONTROL_MAX_AGE
Schema PostsList Default LimitPOST_LIST_DEFAULT_LIMIT
Schema PostsList Max LimitPOST_LIST_MAX_LIMIT
Schema PostsAdd Type To Custom Post Union TypeADD_POST_TYPE_TO_CUSTOMPOST_UNION_TYPES
Schema UsersList Default LimitUSER_LIST_DEFAULT_LIMIT
Schema UsersList Max LimitUSER_LIST_MAX_LIMIT
Schema TagsList Default LimitTAG_LIST_DEFAULT_LIMIT
Schema TagsList Max LimitTAG_LIST_MAX_LIMIT
Schema PagesList Default LimitPAGE_LIST_DEFAULT_LIMIT
Schema PagesList Max LimitPAGE_LIST_MAX_LIMIT
Schema PagesAdd Type To Custom Post Union TypeADD_PAGE_TYPE_TO_CUSTOMPOST_UNION_TYPES
Schema Custom PostsList Default LimitCUSTOMPOST_LIST_DEFAULT_LIMIT
Schema Custom PostsList Max LimitCUSTOMPOST_LIST_MAX_LIMIT
Schema Custom PostsUse Single Type Instead Of Union TypeUSE_SINGLE_TYPE_INSTEAD_OF_CUSTOMPOST_UNION_TYPE

wp-config 상수

wp-config.php 파일의 상수 이름은 환경 변수와 동일하며, 앞에 GATOGRAPHQL_을 붙입니다.

예를 들어, 환경 변수 EDITING_ACCESS_SCHEMEwp-config.php에서 GATOGRAPHQL_EDITING_ACCESS_SCHEME으로 정의해야 합니다.

훅을 통한 설정

훅을 사용하여 옵션의 값을 재정의할 수 있습니다.

각 옵션은 고유한 훅을 트리거합니다.

use PoP\ComponentModel\ComponentConfiguration\ComponentConfigurationHelpers;
 
$hookName = ComponentConfigurationHelpers::getHookName(
    $componentConfigurationClass,
    $envVariable
);
add_filter($hookName, 'myFunctionToOverrideSettingsValue', PHP_INT_MAX);

훅 이름을 얻으려면 다음을 제공해야 합니다.

  • $componentConfigurationClass: 옵션이 정의된 패키지의 ComponentConfiguration 클래스
  • $envVariable: 설정할 환경 변수의 이름

훅 설정 방법은 이 예제를 참고하세요.