Általános hookok: telepítővarázsló, aktiválás, deaktiválás

Ez a fejezet a SEOPress három általános hookját írja le. A hookok használatának általános szabályait (hova másold a kódot, mit ellenőrizz előtte) a Composer és hookok használata fejezet tartalmazza.

Hook	Típus	Legkisebb verzió	Mire jó
seopress_enable_setup_wizard	szűrő (filter)	3.5.8	A SEOPress telepítővarázslójának ki- és bekapcsolása.
seopress_activation	művelet (action)	0.1	A SEOPress aktiválásakor fut le.
seopress_deactivation	művelet (action)	0.1	A SEOPress deaktiválásakor fut le.

A telepítővarázsló ki- és bekapcsolása

A seopress_enable_setup_wizard szűrő dönti el, hogy a SEOPress betölti-e a telepítővarázslót. Az alapértéke true, vagyis a varázsló elérhető, ha a felhasználónak van hozzá jogosultsága. Ha false értéket adsz vissza, a varázsló nem töltődik be.

Add a gyermeksablonod functions.php fájljához:

add_filter( 'seopress_enable_setup_wizard', '__return_false' );

A varázslót újra bekapcsolod, ha eltávolítod ezt a sort, vagy __return_true értéket adsz vissza.

Aktiválási hook

A seopress_activation művelet a SEOPress aktiválásakor fut le, miután a bővítmény elvégezte a saját aktiválási teendőit (például frissítette az átírási szabályokat). Ide kapcsolhatod a saját, aktiváláskor szükséges kódodat.

add_action( 'seopress_activation', 'sajat_aktivalasi_muvelet' );
function sajat_aktivalasi_muvelet() {
    // Ide jön a saját kódod.
}

Mivel az esemény csak az aktiváláskor következik be, a hookot olyan kódban regisztráld, amely már az aktiválás előtt betöltődik (például egy mu-pluginban).

Deaktiválási hook

A seopress_deactivation művelet a SEOPress deaktiválásakor fut le. A bővítmény ilyenkor kikapcsolja a PRO változatot, törli az aktiválást jelző beállítást, frissíti az átírási szabályokat, majd lefuttatja ezt a hookot.

add_action( 'seopress_deactivation', 'sajat_deaktivalasi_muvelet' );
function sajat_deaktivalasi_muvelet() {
    // Ide jön a saját kódod.
}

A deaktiválási hookot is olyan kódban regisztráld, amely a SEOPress kikapcsolásakor is betöltődik, például egy mu-pluginban.