Egyedi kód, sablonok és szövegek módosítása

Az AffiliateWP kinézetét és működését a bővítmény fájljainak átírása nélkül is módosíthatod. A közvetlen szerkesztés azért rossz ötlet, mert a következő frissítés felülírja a változtatásaidat, egy elírás pedig az egész oldalt elérhetetlenné teheti. Három biztonságos módszer van: kódrészlet (snippet), felülírt sablonfájl és szövegcsere.

Kódrészletek hozzáadása a WPCode-dal

A kódrészlet egy rövid PHP-, JavaScript-, CSS- vagy HTML-kód, amely új funkciót ad az oldalhoz, vagy módosít egy meglévőt. A kezelésére jó eszköz a WPCode bővítmény: a kódot a saját felületén tárolja, egy kattintással ki-be kapcsolható, és nem nyúl a téma vagy a bővítmények fájljaihoz. A kódrészlet írásához alap PHP-, CSS- vagy HTML-ismeret kell.

A WPCode telepítése

1. Nyisd meg a Bővítmények → Új hozzáadása oldalt.
2. Keress rá a „WPCode” névre (teljes neve: WPCode, Insert Headers and Footers + Custom Code Snippets).
3. Kattints a Telepítés most, majd az Aktiválás gombra.

Az aktiválás után megjelenik a Code Snippets menüpont: itt hozod létre és kezeled a kódrészleteket.

PHP-kódrészlet létrehozása

1. A Code Snippets menüben válaszd az Add Snippet lehetőséget.
2. Vidd az egeret az Add Your Custom Code (New Snippet) csempére, és kattints az Add Custom Snippet gombra.
3. Válaszd ki a kód típusát: PHP Snippet, JavaScript Snippet vagy CSS Snippet.
4. Adj a kódrészletnek beszédes címet, például „Partnerterület egyedi címsor”.
5. Illeszd be a kódot a szerkesztőbe.
6. Az Insertion résznél hagyd az Insert Method értékét Auto Insert beállításon. A Location legyen Run Everywhere, így a kód a nyilvános oldalon és az admin felületen is lefut. Ha a kódot csak egy oldalon vagy bejegyzésben szeretnéd használni, shortcode-ként is beszúrhatod.
7. Kapcsold be az Active kapcsolót a jobb felső sarokban, majd kattints a Save Snippet gombra.

Példa: üdvözlő címsor a partnerterület tetején.

// Egyedi címsor a partnerterületen
function egyedi_partnerterulet_cimsor() {
    echo '<h2>Üdv a partnerfiókodban!</h2>';
}
add_action( 'affwp_affiliate_dashboard_top', 'egyedi_partnerterulet_cimsor' );

Ha a kód aktív, nyisd meg a partnerterületet: a címsor a felület tetején jelenik meg.

CSS-kódrészlet létrehozása

A CSS-kódrészlet ugyanígy készül, csak a típus CSS Snippet. Példa: a partnerterület füleinek színe.

/* Az összes fül szövegének színe */
#affwp-affiliate-dashboard-tabs li.affwp-affiliate-dashboard-tab a {
    color: #333;
}

/* Az aktív fül színe és félkövér szedése */
#affwp-affiliate-dashboard-tabs li.affwp-affiliate-dashboard-tab.active a {
    color: #3498db;
    font-weight: bold;
}

Állítsd a beszúrást Auto Insert módra, mentsd és aktiváld a kódrészletet.

Példa: a szintek számának bővítése

A Többszintű jutalékok kiegészítő alapból legfeljebb 5 szintet kezel. Ha ennél többet szeretnél, a következő kódrészlet 6 szintre emeli a határt (a 6 helyére a kívánt számot írd):

add_filter( 'affwp_mtc_max_tiers', function( $tiers ) {
    return 6; // a szintek száma
} );

Mentés és aktiválás után a Többszintű jutalékok beállításainál megjelenik a plusz szint.

Gyakori kérdések

• Miért érdemes a WPCode-ot használni? Mert a változtatásaid biztonságban maradnak a frissítések során, és bármikor ki-be kapcsolhatók.
• Elronthatja a kódrészlet az oldalt? Helyes kóddal, WPCode-ból futtatva nem. Lehetőleg előbb próbáld ki egy tesztoldalon.
• Kikapcsolhatom vagy törölhetem később? Igen, a WPCode-ban bármelyik kódrészletet ki lehet kapcsolni vagy törölni, a bővítmény fájljai érintetlenek maradnak.

Sablonfájlok módosítása

Az AffiliateWP sablonjait a gyermektémádban felülírhatod, így a változtatások a bővítményfrissítések után is megmaradnak.

Módosítható sablonok

Csoport	Fájlok
E-mailek	body-default.php (törzs), header-default.php (fejléc), footer-default.php (lábléc)
Partnerterület	dashboard.php (főoldal), dashboard-tab-urls.php (hivatkozások), dashboard-tab-stats.php (statisztika), dashboard-tab-graphs.php (grafikonok), dashboard-tab-referrals.php (ajánlások), dashboard-tab-payouts.php (kifizetések), dashboard-tab-visits.php (látogatások), dashboard-tab-creatives.php (kreatívok), dashboard-tab-settings.php (beállítások)
Űrlapok és hozzáférés	login.php (belépés), register.php (regisztráció), no-access.php (a hozzáférés hiányát jelző üzenet)
Kreatívok	creative.php

Módosítás gyermektémával

1. Keresd meg a módosítandó fájlt a bővítmény sablonmappájában.
2. A gyermektéma könyvtárában hozz létre egy affiliatewp nevű mappát.
3. Másold a kiválasztott sablont ebbe a mappába. E-mailsablonok esetén az affiliatewp mappán belül hozz létre egy emails almappát, és abba tedd a fájlokat (affiliatewp/emails/body-default.php).
4. Szerkeszd a másolatot kódszerkesztőben, ügyelve a PHP és a HTML helyes szintaxisára.
5. Töltsd fel a módosított affiliatewp mappát a gyermektémába.

A gyermektéma az eredeti sablon helyett a saját másolatodat használja. Szerkesztés előtt készíts mentést az oldalról, és a változtatás után ellenőrizd a működést.

Módosítás WPCode-dal

Ha nem akarsz gyermektémát használni, a módosítást PHP-kódrészletként is megoldhatod: a WPCode-ban hozz létre egy új PHP Snippet elemet, illeszd be a kódot, kapcsold be, mentsd el, majd ellenőrizd az eredményt.

Szövegek átírása a Say What? bővítménnyel

Ha az AffiliateWP egy felirata nem módosítható a beállításokban, a Say What? bővítménnyel bármelyik szöveget lecserélheted, a bővítmény fájljainak érintése nélkül.

1. Telepítsd és aktiváld a Say What? bővítményt a wordpress.org-ról.
2. Nyisd meg az Eszközök → Text changes oldalt.
3. Kattints felül az Add New gombra.
4. Töltsd ki az űrlapot:

Mező	Mit írj bele
Original String	A lecserélendő szöveg pontosan, ahogy megjelenik: a kis- és nagybetűket, az írásjeleket és a szóközöket is beleértve
Text Domain	affiliate-wp, így a csere csak az AffiliateWP szövegeire vonatkozik
Text Context	Hagyd üresen, ha nem ismered a szöveg környezetét
Replacement String	Az új szöveg

5. Kattints az Add gombra.

A csere onnantól mindenhol érvényes, ahol az eredeti szöveg megjelenik. A bővítmény ingyenes változatában minden írásváltozathoz külön bejegyzés kell: ha a „affiliate” és az „Affiliate” szót is cserélnéd, mindkettőt fel kell venned.