Jak dodać coś przed i po każdym wpisie

Na razie nie wchodząc głęboko w szczegóły wyjaśnię, o co w tym wpisie chodzi. Otóż postaram się przybliżyć wam filtr the_content, dzięki któremu bardzo łatwo zrealizujemy cel postawiony w temacie.

Filtry w WordPressie są często wykorzystywane we wtyczkach – np. do dodawania na końcu wpisu guzików z mediów społecznościowych.

Wyobraźmy sobie sytuację w której mamy już wiele opublikowanych wpisów. Wyobrażamy sobie naszego bloga z 50 wpisami (bardzo często odwiedzanym z resztą). I teraz chcielibyśmy sobie coś tam zmienić, coś tam dodać na początku tekstu, może też na końcu. Najlepszy przykład jaki przychodzi mi teraz do głowy to kod reklamy. 🙂 Mamy już na naszym blogu gotowe shortcode-y, więc moglibyśmy sobie spokojnie zedytować posty i wpisując krótką komendę w edytorze, albo nawet klikając guzik shortcode-a w edytorze umieścić go w treści nasz baner. Zaraz, edytować 50 postów i bawić się w ręczne dodawanie?

Sposób oczywiście najlepiej sprawdza się w sytuacji, gdy chcemy dodać coś bezpośrednio na początku wpisu i bezpośrednio po nim. Wiadomo, że mając te 50 postów, które prawdopodobnie powstawały na przestrzeni kilku miesięcy/lat, to każdy wpis będzie trochę inny. Dlatego sposób wymaga przewidzenia niektórych sytuacji i sprawdzenia efektu końcowego „ręcznie – naocznie”, niemniej zawsze jest to lepsze niż edycja każdego wpisu z osobna.

Po tym przydługim wstępniaku, zacznijmy wreszcie działać, oto przykład:

Cały kod:

// dodanie przed i po poscie jednostki reklamowe
function add_text($content)
{
    //kod reklamy
    $ad = 'TWÓJ KOD REKLAMY';

    $updated_content = '';

    if ( is_single() ) 
    {
        $updated_content = $ad . '<br />' . $content . '<br />' . $ad . '<br />';
        return $updated_content;
    }
    else
    {
        return $content;
    }
}

add_filter( 'the_content', 'add_text' );

A teraz postaram się wytłumaczyć o co tutaj chodzi.

W pliku functions.php piszemy nową funkcję add_text(), przyjmującą argument $content. Tak, w tym argumencie znajduje się treść naszego wpisu.

W ciele funkcji, w zmiennej $ad zapisujemy kod reklamy dla naszego przykładu, albo cokolwiek innego, co chcielibyśmy umieścić na początku (na końcu) wpisu.

W zmiennej $updated_content zapiszemy naszą, za chwilę lekko zmodyfikowaną, wersję wpisu.

W „ifi-e” sprawdzamy, czy wywołanie dotyczy pojedynczego wpisu, bo nie chcielibyśmy, żeby reklama pojawiała się liście wpisów przy każdym wycinku, prawda? W tym miejscu możemy także dodać jakiś inny własny warunek jak sprawdzenie typu/statusu wpisu, czy należy do jakiejś kategorii, zawiera tag itd., zależy od naszych potrzeb.

Wreszcie instrukcja właściwa:

$updated_content = $ad . '<br />' . $content . '<br />' . $ad . '<br />';

Nie jest to jakaś zdobycz programowania (tylko podstawy podstaw), ale chodzi o zrozumienie przykładu i tego w jaki sposób osiągnąć wspomniany efekt. Do reklamy na początku „doklejamy” znak łamania linii, do tego doklejamy kontent wpisu, znak łamana linii, reklamę która ma być na końcu wpisu i na koniec znowu znak łamania linii. Na dokładnym „sklejeniu” „stringów”, w kolejnej linijce, która tak na prawdę spokojnie mogłaby być uwzględniona w poprzedniej, zwracamy efekt końcowy.

Ważne jest, że jeżeli używamy już tego „ifa”, bo nie zawsze jest nam potrzebny, to należy pamiętać także o else. Jeżeli go pominiemy, a warunek nie zostanie spełniony, to nie wyświetli nam się w ogóle treść wpisu.

Na koniec, najważniejsze, czyli dodanie filtra z argumentem the_content i add_text. Dzięki temu WordPress weźmie pod uwagę naszą funkcję przed wyświetleniem wpisów.

• the_content – jak nazwa wskazuje, oznacza że chodzi o kontent, treść wpisu. Z resztą tak samo nazywa się funkcja, której używamy w pętli WordPress-a do wyświetlenia treści wpisu.
• add_text – tak nazywa się nasza właśnie utworzona funkcja. Jeżeli nazwa naszej funkcji i nazwa podana w filtrze nie będą się pokrywać, wpis także nie zostanie wyświetlony.

Wspomniany sposób można z powodzeniem wykorzystać także w przypadku tytułu wpisu. Wtedy zamiast the_content, używamy the_title, o tak:

add_filter( 'the_title', 'add_before_title' );