Képhookok: fájlnév-tisztítás, automatikus cím, alt szöveg és képattribútumok

Ez a fejezet a SEOPress képekkel kapcsolatos szűrőit gyűjti össze. Két beállításcsoporthoz kapcsolódnak, amelyeket a SEO → Advanced oldal Image SEO fülén találsz (lásd a képek SEO-optimalizálásáról szóló fejezetet):

• a Cleaning media filename kapcsoló a feltöltött fájl nevét tisztítja meg;
• az Image Title, Image Alt text és a hozzájuk tartozó kapcsolók a feltöltött kép címét, alt szövegét, feliratát és leírását töltik ki automatikusan.

https://minta-bolt.hu/wp-admin/admin.php?page=seopress-advanced

A képen a fájlnév-tisztítás és az automatikus képattribútumok kapcsolói látszanak. A fejezet hookjai csak akkor futnak le, ha a hozzájuk tartozó kapcsoló be van kapcsolva. 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_image_seo_before_cleaning	szűrő	6.3	A fájlnév módosítása a tisztítás előtt.
seopress_image_seo_clean_input	szűrő	6.3	A tisztítás során lecserélendő karakterek (minták) listája.
seopress_image_seo_clean_output	szűrő	6.3	A lecserélendő karakterek helyére kerülő karakterek listája.
seopress_image_seo_after_cleaning	szűrő	6.3	A fájlnév módosítása a tisztítás után.
seopress_auto_image_title	szűrő	3.4	A feltöltéskor automatikusan képzett képcím (alt szöveg, felirat, leírás alapja) módosítása.
seopress_auto_image_attr	szűrő	3.4	A kép címének, feliratának és leírásának tömbje, mielőtt a SEOPress elmenti.
seopress_auto_image_alt_target_kw	szűrő	4.5	A célkulcsszóból képzett alt szöveg módosítása.

A fájlnév tisztítása: négy szűrő

Amikor a Cleaning media filename be van kapcsolva, a SEOPress a WordPress sanitize_file_name szűrőjén keresztül tisztítja a feltöltött fájl nevét. A folyamat sorrendje:

1. seopress_image_seo_before_cleaning: megkapja az eredeti fájlnevet.
2. A SEOPress UTF-8-ra kényszeríti a nevet, majd a karakterlista alapján lecseréli az ékezetes és különleges karaktereket (például az á a lesz, a © pedig copy). A cserélendő karakterek listáját a seopress_image_seo_clean_input, a helyettük beírt karaktereket a seopress_image_seo_clean_output szűrő adja át.
3. A kérdőjelek törlődnek, a betűk kisbetűsek lesznek.
4. seopress_image_seo_after_cleaning: megkapja a megtisztított nevet.

Mindegyik szűrő a módosított értéket adja vissza.

Fájlnév módosítása a tisztítás előtt vagy után

A tisztítás előtt például a fájlnév elejére tehetsz egy előtagot, vagy kicserélhetsz benne egy szót:

add_filter( 'seopress_image_seo_before_cleaning', 'sajat_fajlnev_tisztitas_elott' );
function sajat_fajlnev_tisztitas_elott( $filename ) {
    return str_replace( 'IMG_', 'foto-', $filename );
}

A tisztítás után a már kisbetűs, ékezet nélküli nevet egészítheted ki:

add_filter( 'seopress_image_seo_after_cleaning', 'sajat_fajlnev_tisztitas_utan' );
function sajat_fajlnev_tisztitas_utan( $filename ) {
    return 'minta-' . $filename;
}

A cserélendő karakterek bővítése

A két szűrő tömbje párban működik: a clean_input tömb n-edik eleme (reguláris kifejezés, perjelek között) a clean_output tömb n-edik elemére cserélődik. Ha új karaktert adsz hozzá, mindkét szűrőben ugyanabba a pozícióba tedd, különben a párosítás elcsúszik. Példa: a @ jel lecserélése - jelre:

add_filter( 'seopress_image_seo_clean_input', 'sajat_tisztitando_karakterek' );
function sajat_tisztitando_karakterek( $karakterek ) {
    $karakterek[] = '/@/';
    return $karakterek;
}

add_filter( 'seopress_image_seo_clean_output', 'sajat_csere_karakterek' );
function sajat_csere_karakterek( $csere ) {
    $csere[] = '-';
    return $csere;
}

Ha mindkét tömbhöz a végére fűzöl, a pozíciók egyeznek.

Automatikus képcím, alt szöveg, felirat és leírás

Ha az Image Title, Image Alt text, felirat vagy leírás automatikus kitöltése be van kapcsolva, a SEOPress minden feltöltött képhez kiszámít egy szöveget, és beírja a bekapcsolt mezőkbe. A szöveg forrása a kép fájlneve (pontosabban a kép címe), WooCommerce-termékhez csatolt képnél a termék címe. A kötőjelek, aláhúzásjelek és a felesleges szóközök szóközzé alakulnak, a szöveg pedig kisbetűs lesz.

seopress_auto_image_title

A szűrő a kiszámított szöveget módosíthatod, mielőtt a SEOPress beírná a mezőkbe. A szűrő négy paramétert kap: a szöveget, a szülő bejegyzés típusát, a szülő bejegyzés azonosítóját és a kép azonosítóját. Ez a szöveg kerül a címbe, az alt szövegbe, a feliratba és a leírásba is, amelyik be van kapcsolva. Példa: az első betű nagybetűssé tétele:

add_filter( 'seopress_auto_image_title', 'sajat_kepcim', 10, 4 );
function sajat_kepcim( $szoveg, $tipus, $szulo_id, $kep_id ) {
    return ucfirst( $szoveg );
}

seopress_auto_image_attr

A szűrő tömböt kap, amely a mentendő adatokat tartalmazza: az ID a kép azonosítója, a post_title, post_excerpt (felirat) és post_content (leírás) pedig csak akkor szerepel benne, ha a megfelelő kapcsoló be van kapcsolva. Ezt a tömböt kell visszaadnod. Példa: a felirat kiegészítése egy szöveggel:

add_filter( 'seopress_auto_image_attr', 'sajat_kepattributumok' );
function sajat_kepattributumok( $adatok ) {
    if ( isset( $adatok['post_excerpt'] ) ) {
        $adatok['post_excerpt'] .= ' (fotó: Minta Kft.)';
    }
    return $adatok;
}

Az alt szöveg külön tárolódik, ezért az nem része ennek a tömbnek: azt a seopress_auto_image_title szűrő értéke határozza meg.

A két szűrő akkor is lefut, ha az alt szövegeket tömeges művelettel állítod be a médiatárban.

Alt szöveg a célkulcsszóból: seopress_auto_image_alt_target_kw

Az Alt from target keywords kapcsoló a frontenden azokhoz a képekhez, amelyeknek nincs alt szövege, a bejegyzés célkulcsszavát írja be. A szűrő a kulcsszót kapja meg, és a módosított szöveget kell visszaadnod. Példa: a kulcsszó kiegészítése a webhely nevével:

add_filter( 'seopress_auto_image_alt_target_kw', 'sajat_alt_kulcsszo' );
function sajat_alt_kulcsszo( $kulcsszo ) {
    return $kulcsszo . ' - Minta Bolt';
}

Ha a szűrő üres szöveget ad vissza, a kép alt szövege üresen marad.