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

> Hogyan szabhatod testre az AffiliateWP-t a bővítményfájlok szerkesztése nélkül: kódrészletek, sablonfájlok és szövegcserék.

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.

```php
// 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.

```css
/* 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):

```php
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.