Woo - termékek widget fejlesztőknek

A Woo - termékek widget kimenetét PHP-horgokkal módosíthatod. A kódot a gyermektéma functions.php fájljába vagy egy saját bővítménybe tedd.

Action-horgok

Minden action két paramétert kap: a termék azonosítóját ($product_id) és a widget beállításait ($settings). Az első szám a prioritás, a második a paraméterek száma.

Horog	Mikor fut le
uael_woo_products_before_summary_wrap	A termékösszegzés elején.
uael_woo_products_after_summary_wrap	A termékösszegzés végén.
uael_woo_products_title_before	A termék címe előtt.
uael_woo_products_title_after	A termék címe után.
uael_woo_products_price_before	Az ár előtt.
uael_woo_products_price_after	Az ár után.
uael_woo_products_rating_before	Az értékelés előtt.
uael_woo_products_rating_after	Az értékelés után.
uael_woo_products_short_description_before	A rövid leírás előtt.
uael_woo_products_short_description_after	A rövid leírás után.
uael_woo_products_add_to_cart_before	A kosárba tétel gomb előtt.
uael_woo_products_add_to_cart_after	A kosárba tétel gomb után.
uael_woo_products_category_before	A kategória előtt.
uael_woo_products_category_after	A kategória után.

Példa: szöveg a termékösszegzés elejére.

function summary_wrap( $product_id, $settings ) {
    echo '<div>Ez a termékösszegzés eleje.</div>';
}
add_action( 'uael_woo_products_before_summary_wrap', 'summary_wrap', 10, 2 );

A többi horog ugyanígy működik, csak a horog nevét kell kicserélni.

Filter-horgok

A lekérdezés argumentumainak módosítása:

add_filter( 'uael_woo_product_query_args', function( $query, $settings ) {
    // Itt módosíthatod a lekérdezést.
    return $query;
}, 10, 2 );

Az „Elfogyott” felirat módosítása:

add_filter( 'uael_woo_out_of_stock_string', function( $modified_string ) {
    // Itt módosíthatod a szöveget.
    return $modified_string;
}, 10, 2 );

A termékcím hivatkozásának módosítása:

add_filter( 'uael_woo_title_link', function( $title_link ) {
    // Itt módosíthatod a hivatkozást.
    return $title_link;
}, 10, 2 );

A termékkártya elemeinek sorrendje. A tömbben szereplő elemek cseréjével átrendezheted a kártyát:

add_filter( 'uael_woo_products_content_structure', function( $shop_structure, $settings ) {
    $shop_structure = [ 'category', 'ratings', 'title', 'price', 'add_cart', 'short_desc' ];
    return $shop_structure;
}, 10, 2 );

A termékkép hivatkozásának kikapcsolása (false visszaadásával):

add_filter( 'uael_product_disable_link', function( $is_enable ) {
    // Térj vissza false értékkel a hivatkozás kikapcsolásához.
    return $is_enable;
}, 10, 2 );

A gyorsnézet szerkezete. Itt is a tömb elemeinek cseréjével alakíthatod:

add_filter( 'uael_quick_view_product_structure', function( $quick_view_structure ) {
    $quick_view_structure = [ 'title', 'ratings', 'price', 'short_desc', 'add_cart' ];
    return $quick_view_structure;
}, 10, 2 );

A „Gyorsnézet” szöveg átírása

A gyorsnézet gombjának szövege nem állítható a widget beállításaiból, de a gettext szűrővel átírhatod. A kód a WordPress fordítási rendszerébe kapcsolódik, és a bővítmény szövegtárában (uael) keresi a megadott szöveget.

1. Készíts biztonsági másolatot a téma functions.php fájljáról.
2. Lépj be a WordPress admin felületére, és nyisd meg a Megjelenés → Témafájl-szerkesztő oldalt (vagy használj gyermektémát).
3. A jobb oldali fájllistában válaszd ki a functions.php fájlt.
4. Illeszd be a lenti kódot, és mentsd a fájlt. A változás azonnal érvényesül.
5. Nyisd meg a boltoldalt, és vidd az egeret a termékképre: a gyorsnézet gombján az új szöveg áll.

A példa a szöveget „Megnézem”-re cseréli (a case ágban a felületen most látható szöveg áll):

add_filter( 'gettext', function( $translated_text, $text, $domain ) {
    if ( $domain === 'uael' ) {
        switch ( $translated_text ) {
            case 'Quick View':
                $translated_text = __( 'Megnézem', 'uael' );
                break;
        }
    }
    return $translated_text;
}, 20, 3 );

A case ágban annak a szövegnek kell állnia, amelyet a felületen most látsz, a magyar felületen tehát a magyar felirat.