Hookok: átirányítások

Ez a fejezet az átirányítások, a 404-figyelés és a letiltott archívumok hookjait gyűjti össze. A funkciók beállításairól az Átirányítások és az Átirányítások importálása CSV-ből fejezet szól. A hookok használatának általános szabályait a Composer és hookok használata fejezet írja le. A kódot a gyermeksablonod functions.php fájljába vagy egy saját bővítménybe tedd.

Hook	Típus	Legkisebb verzió	Mire jó
seopress_redirections_imported	művelet	10.3	Kód futtatása az átirányítások tömeges importja után.
seopress_watch_taxonomy_for_redirects	szűrő	9.1	Annak eldöntése, mely taxonómiákra készüljön automatikus átirányítási javaslat.
seopress_automatic_redirect_cpt	szűrő	5.1	Annak eldöntése, mely tartalomtípusokra készüljön automatikus átirányítási javaslat.
seopress_post_automatic_redirect	szűrő	4.0	Az automatikus átirányítási javaslatok kikapcsolása.
seopress_before_redirect	művelet	5.3	Kód futtatása közvetlenül az átirányítás keresése után.
seopress_stop_counter_redirects	szűrő	7.2	A találatszámláló növelésének leállítása.
seopress_stop_last_date_request_redirects	szűrő	7.2	Az utolsó kérés időpontjának mentése leállítása.
seopress_export_redirections_query	szűrő	4.5	Az átirányítások exportjának lekérdezése.
seopress_export_404_query	szűrő	7.4	A 404-es hibák exportjának lekérdezése.
seopress_disable_archives_redirect_url	szűrő	6.5	A letiltott szerzői és dátumos archívumok átirányításának célja.
seopress_disable_archives_redirect_status	szűrő	6.5	A letiltott szerzői és dátumos archívumok átirányításának állapotkódja.

Művelet az átirányítások importja után

A seopress_redirections_imported művelet akkor fut le, amikor a tömeges átirányítás-import az utolsó sort is kiírta. Paramétere nincs. Használhatod például gyorsítótár ürítésére vagy értesítés küldésére.

add_action( 'seopress_redirections_imported', 'sajat_import_utan' );
function sajat_import_utan() {
    error_log( 'Az átirányítások importja befejeződött.' );
}

Taxonómiák szűrése az automatikus javaslatokhoz

A SEOPress javaslatot tesz átirányításra, ha törölsz vagy átnevezel (új slugot adsz) egy kifejezést. Alapból azokat a taxonómiákat figyeli, amelyek nyilvánosak vagy nyilvánosan lekérdezhetők. A seopress_watch_taxonomy_for_redirects szűrő három paramétert kap: az alapértelmezett döntést (true vagy false), a taxonómia nevét és a taxonómia objektumot. Igazat visszaadva figyeli, hamisat visszaadva nem figyeli az adott taxonómiát.

add_filter( 'seopress_watch_taxonomy_for_redirects', 'sajat_taxonomia_figyeles', 10, 3 );
function sajat_taxonomia_figyeles( $should_watch, $taxonomy_name, $taxonomy ) {
    // A termékcímkékre ne készüljön javaslat.
    if ( 'product_tag' === $taxonomy_name ) {
        return false;
    }
    return $should_watch;
}

Tartalomtípusok szűrése az automatikus javaslatokhoz

A seopress_automatic_redirect_cpt szűrő a tartalomtípusok listáját kapja, azokat, amelyekre a SEOPress átirányítási javaslatot ad, ha megváltozik egy tartalom slugja vagy törlöd. A lista kulcsa a tartalomtípus neve, értéke a tartalomtípus objektuma. A SEOPress előtte már kivesz belőle néhány belső típust (például a lapszerkesztők sablonjait), a szűrővel további típusokat vehetsz ki.

add_filter( 'seopress_automatic_redirect_cpt', 'sajat_tartalomtipusok' );
function sajat_tartalomtipusok( $post_types ) {
    // A termékekre ne készüljön javaslat.
    unset( $post_types['product'] );
    return $post_types;
}

Az automatikus javaslatok kikapcsolása

A seopress_post_automatic_redirect szűrő azt dönti el, megjelenjen-e az átirányítási javaslat a slug módosítása vagy a törlés után. Ha hamisat adsz vissza, a javaslatok nem jelennek meg. A SEOPress maga is ezt teszi, ha az SEO → PRO → Átirányítások / 404 oldalon bekapcsolod az Értesítések letiltása slug módosításakor vagy bejegyzés / kifejezés törlésekor beállítást.

add_filter( 'seopress_post_automatic_redirect', '__return_false' );

Művelet az átirányítás előtt

A seopress_before_redirect művelet akkor fut le, amikor a SEOPress megkereste a kért URL-hez tartozó átirányítási szabályt, de még nem hajtotta végre az átirányítást. Egy paramétert kap: a talált átirányítási bejegyzést (WP_Post objektum). Ha nincs találat, az érték üres, ezért ellenőrizd az ID meglétét.

add_action( 'seopress_before_redirect', 'sajat_atiranyitas_elott' );
function sajat_atiranyitas_elott( $atiranyitas ) {
    if ( isset( $atiranyitas->ID ) ) {
        error_log( 'Átirányítás: ' . $atiranyitas->post_title );
    }
}

Találatszámláló és utolsó kérés leállítása

A SEOPress minden átirányítás használatakor megnöveli a találatok számát, és elmenti az utolsó kérés idejét. Nagy forgalmú webhelyen ez sok adatbázis-írást jelent. A két szűrő külön-külön leállítja ezeket: igazat visszaadva az adott mentés elmarad.

Szűrő	Mit állít le
seopress_stop_counter_redirects	A találatok számának növelését.
seopress_stop_last_date_request_redirects	Az utolsó kérés időpontjának mentését.

add_filter( 'seopress_stop_counter_redirects', '__return_true' );
add_filter( 'seopress_stop_last_date_request_redirects', '__return_true' );

Az exportlekérdezések szűrése

A CSV-exportnál a SEOPress egy WP_Query paramétertömbbel kéri le a bejegyzéseket. Két szűrővel módosíthatod ezt a tömböt, például hogy csak egy részüket exportáld.

Szűrő	Mit exportál alapból
seopress_export_redirections_query	Az átirányításokat (301, 302, 307, 410 és 451 típusúak).
seopress_export_404_query	A 404-es hibákat (azokat a bejegyzéseket, amelyekhez nincs átirányítási típus mentve).

Mindkét szűrő a paramétertömböt kapja, és a módosított tömböt kell visszaadnod.

add_filter( 'seopress_export_redirections_query', 'sajat_export_szuro' );
function sajat_export_szuro( $args ) {
    // Csak az utolsó 100 átirányítást exportáld.
    $args['posts_per_page'] = 100;
    return $args;
}

Letiltott archívumok átirányítása

Ha a SEO → Titles & Metas → Archívumok oldalon letiltod a szerzői vagy a dátumos archívumokat, a SEOPress a főoldalra irányítja a látogatókat 301-es állapotkóddal. Két szűrővel módosíthatod ezt.

Szűrő	Mit állít	Alapérték
seopress_disable_archives_redirect_url	Az átirányítás célját.	A webhely főoldala
seopress_disable_archives_redirect_status	Az állapotkódot.	301

add_filter( 'seopress_disable_archives_redirect_url', 'sajat_archivum_cel' );
function sajat_archivum_cel( $url ) {
    return home_url( '/blog/' );
}

add_filter( 'seopress_disable_archives_redirect_status', 'sajat_archivum_allapot' );
function sajat_archivum_allapot( $status ) {
    return '302';
}