插件配置通过设置页面、环境变量、wp-config 和 hooks 配置插件
通过设置页面、环境变量、wp-config 和 hooks 配置插件
插件选项有多种配置方式。
设置页面
设置页面可在 WordPress 管理后台对插件进行配置。
要打开它，请点击插件菜单中的「Settings」链接：
设置按标签页组织，每个标签页对应一个模块：
更新选项后，点击 Save Changes 按钮以保存并应用新值。
通过环境变量和 wp-config 常量
设置页面上的所有选项也可通过环境变量以及在 wp-config.php 文件中定义的常量来设置。
选项值的优先级如下：
- 如果存在对应的环境变量，则使用该变量
- 如果在
wp-config.php中定义了对应的常量，则使用该常量 - 否则，使用设置页面中的值
添加或修改环境变量或 wp-config 常量后，必须重新生成插件配置。为此，请前往设置页面并点击 Save Changes。
环境变量
| 模块 | 选项 | 环境变量 |
|---|---|---|
| Schema Editing Access | Editing Access Scheme | EDITING_ACCESS_SCHEME |
| Single Endpoint | Endpoint Path | GRAPHQL_API_ENDPOINT |
| Custom Endpoints | Endpoint Path | CUSTOM_ENDPOINT_SLUG_BASE |
| Persisted Queries | Endpoint Path | PERSISTED_QUERY_SLUG_BASE |
| Graphiql For Single Endpoint | Client Path | GRAPHIQL_CLIENT_ENDPOINT |
| Interactive Schema For Single Endpoint | Client Path | VOYAGER_CLIENT_ENDPOINT |
| Public Private Schema | Mode | USE_PRIVATE_SCHEMA_MODE |
| Public Private Schema | Enable Granular | ENABLE_INDIVIDUAL_CONTROL_FOR_PUBLIC_PRIVATE_SCHEMA_MODE |
| Schema Namespacing | Use Namespacing | NAMESPACE_TYPES_AND_INTERFACES |
| Nested Mutations | Enable Nested Mutations | ENABLE_NESTED_MUTATIONS |
| Nested Mutations | Disable redundant root type fields | DISABLE_REDUNDANT_ROOT_TYPE_MUTATION_FIELDS |
| Cache Control | Default Max Age | DEFAULT_CACHE_CONTROL_MAX_AGE |
| Schema Posts | List Default Limit | POST_LIST_DEFAULT_LIMIT |
| Schema Posts | List Max Limit | POST_LIST_MAX_LIMIT |
| Schema Posts | Add Type To Custom Post Union Type | ADD_POST_TYPE_TO_CUSTOMPOST_UNION_TYPES |
| Schema Users | List Default Limit | USER_LIST_DEFAULT_LIMIT |
| Schema Users | List Max Limit | USER_LIST_MAX_LIMIT |
| Schema Tags | List Default Limit | TAG_LIST_DEFAULT_LIMIT |
| Schema Tags | List Max Limit | TAG_LIST_MAX_LIMIT |
| Schema Pages | List Default Limit | PAGE_LIST_DEFAULT_LIMIT |
| Schema Pages | List Max Limit | PAGE_LIST_MAX_LIMIT |
| Schema Pages | Add Type To Custom Post Union Type | ADD_PAGE_TYPE_TO_CUSTOMPOST_UNION_TYPES |
| Schema Custom Posts | List Default Limit | CUSTOMPOST_LIST_DEFAULT_LIMIT |
| Schema Custom Posts | List Max Limit | CUSTOMPOST_LIST_MAX_LIMIT |
| Schema Custom Posts | Use Single Type Instead Of Union Type | USE_SINGLE_TYPE_INSTEAD_OF_CUSTOMPOST_UNION_TYPE |
wp-config 常量
wp-config.php 文件中的常量名称与环境变量相同，但需在前面加上 GATOGRAPHQL_。
例如，环境变量 EDITING_ACCESS_SCHEME 在 wp-config.php 中必须定义为 GATOGRAPHQL_EDITING_ACCESS_SCHEME。
通过 hooks
我们可以通过 hook 来覆盖某个选项的值。
每个选项都会触发其对应的 hook：
use PoP\ComponentModel\ComponentConfiguration\ComponentConfigurationHelpers;
$hookName = ComponentConfigurationHelpers::getHookName(
$componentConfigurationClass,
$envVariable
);
add_filter($hookName, 'myFunctionToOverrideSettingsValue', PHP_INT_MAX);要获取 hook 名称，需要提供：
$componentConfigurationClass：定义该选项的包中的ComponentConfiguration类$envVariable：要设置的环境变量名称
请参阅此示例了解如何设置 hook。
Prev
Next