Recept: Addofy van een scherm weghouden

Doel: één adminscherm, bijvoorbeeld een pagina van een plugin met een eigen paginavullende interface, houdt zijn native WordPress-uiterlijk.

Wat uitsluiten doet

Op een uitgesloten scherm blijft Addofy uit: geen Addofy-styling en geen Addofy-assets. Het scherm ziet er native uit.

In code, één scherm

add_filter( 'adba_is_excluded_screen', static function ( bool $excluded, string $screen_id ) {
	if ( 'toplevel_page_myplugin' === $screen_id ) {
		return true;
	}
	return $excluded;
}, 10, 2 );

De filter krijgt het Screen-object ook als derde argument. De waarde die je ontvangt is al waar als het scherm op de uitsluitlijst staat of een fullscreen-app is, zoals de Customizer of de site-editor. Geef hem ongewijzigd terug voor schermen die niet van jou zijn.

Voor een hele plugin

Heeft een plugin meerdere schermen, schrijf dan een compatibiliteitsadapter met excluded_fragments(): elk scherm waarvan het id een van de stukjes bevat, wordt uitgesloten.

Zonder code

Een sitebeheerder kan schermen uitsluiten in de Addofy-instellingen.

Veilige modus

Veilige modus wint altijd. Zolang die actief is (?adba_safe=1 of de constante ADBA_SAFE_MODE), staat Addofy overal uit en kan geen filter het weer aanzetten.

Gerelateerd

• Hooks voor core en modules