Das Plugin über die Einstellungsseite, Umgebungsvariablen, wp-config und Hooks konfigurieren
Es gibt verschiedene Möglichkeiten, die Optionen des Plugins zu konfigurieren.
Die Einstellungsseite
Die Einstellungsseite ermöglicht es, das Plugin in der WordPress-Administration zu konfigurieren.
Um sie zu öffnen, klicke auf den Link „Settings" im Menü des Plugins:
Die Einstellungen sind in Tabs organisiert, wobei jeder Tab einem Modul entspricht:
Nachdem du eine Option aktualisiert hast, klicke auf die Schaltfläche Save Changes, um den neuen Wert zu speichern und anzuwenden.
Über Umgebungsvariablen und wp-config-Konstanten
Alle Optionen der Einstellungsseite können auch über Umgebungsvariablen und Konstanten gesetzt werden, die in der Datei wp-config.php definiert sind.
Die Priorität bei der Auswahl des Optionswerts ist folgende:
- Wenn die entsprechende Umgebungsvariable vorhanden ist, wird sie verwendet
- Wenn die entsprechende Konstante in
wp-config.phpdefiniert ist, wird sie verwendet - Andernfalls wird der Wert von der Einstellungsseite verwendet
Nach dem Hinzufügen oder Ändern einer Umgebungsvariablen oder wp-config-Konstante muss die Plugin-Konfiguration neu generiert werden. Gehe dazu zur Einstellungsseite und klicke auf Save Changes.
Umgebungsvariablen
| Modul | Option | Umgebungsvariable |
|---|---|---|
| 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-Konstanten
Der Name der Konstante in der Datei wp-config.php ist identisch mit dem der Umgebungsvariablen, wobei GATOGRAPHQL_ vorangestellt wird.
Zum Beispiel muss die Umgebungsvariable EDITING_ACCESS_SCHEME in wp-config.php als GATOGRAPHQL_EDITING_ACCESS_SCHEME definiert werden.
Über Hooks
Wir können den Wert einer Option über einen Hook überschreiben.
Jede Option löst ihren eigenen Hook aus:
use PoP\ComponentModel\ComponentConfiguration\ComponentConfigurationHelpers;
$hookName = ComponentConfigurationHelpers::getHookName(
$componentConfigurationClass,
$envVariable
);
add_filter($hookName, 'myFunctionToOverrideSettingsValue', PHP_INT_MAX);Um den Hook-Namen zu erhalten, müssen wir angeben:
$componentConfigurationClass: DieComponentConfiguration-Klasse des Pakets, in dem die Option definiert ist$envVariable: Der Name der zu setzenden Umgebungsvariablen
Sieh dir ein Beispiel für das Setzen eines Hooks an.