Chciałbym podzielić się prostą metodą integracji (instalacji) Prolinka ze swoim blogiem postawionym na WordPress-ie, dzięki czemu linki będziemy mogli wstawić na przykład w treści wbudowanego widgetu tekstowego WordPressa.

Wszystko robimy tak jak w instrukcji na stronie Prolinka, czyli pobranie i rozpakowanie paczki, później "wrzucenie" wszystkiego do katalogu głównego serwisu. Pamiętamy o nadaniu uprawnienień do zapisu (chmod 666).

Następnie otwieramy do edycji plik wp-config.php, znajdujący się w katalogu głównym WordPress-a i na jego początku umieszczamy linijkę kodu php:

include_once($_SERVER["DOCUMENT_ROOT"] . "/prolink.php");

Teraz, gdy mamy już wszystko przygotowane, musimy jeszcze dodać jedną linijkę kodu gdzieś w kodzie aktualnego motywu, która wyświetli nasze linki z prolinka.

<?php prolink_getLinks(); ?>

I tak by to wyglądało standardowo. Jak to trochę ulepszyć? Już tłumaczę...

WordPress to bardzo elastyczne narzędzie, podatne na dodawanie wielu słusznych ulepszeń, które możemy sobie sami stworzyć / napisać.

Ja postanowiłem stworzyć sobie WordPress-owy shortcode dla Prolinka, dzięki któremu będziemy mogli łatwo umieścić linki, i później jeszcze łatwiej je przenosić pomiędzy dostępnymi w motywie widgetami - przykładowo jednym, wygodnym ruchem myszki będziemy mogli zmienić kolejność widgetów i pozycję linków prolinka na stronie, albo szybko przeneść je ze stopki do sidebara, a to wszystko z poziomu kokpitu.

Koniec teorii. Teraz praktyka!

Zacznijmy od tego, że pomijamy/cofamy ostatni krok w instalacji linków do prolinka (chodzi o dodanie funkcji prolink_getLinks() do motywu), bo za chwilę zrobimy to trochę inaczej

Otwieramy do edycji plik functions.php naszego aktualnego motywu i na jego początku (albo na końcu) dodajemy naszą funkcję rejestrującą shortcode:

add_shortcode('prolink', 'shortcode_prolink');

function shortcode_prolink(){
 return prolink_getLinks();
}

//Opcjonalnie:
add_filter('widget_text', 'do_shortcode');


Zacznijmy od argumentów pierwszej funkcji add_shortcode():

• prolink - to nazwa wywołująca shortcode, czyli ta której będziemy później używać w widgetach;
• shortcode_prolink - to nazwa funkcji, która obsłuży shortcode.
  

Druga funkcja ma za zadanie obsłużenie shortcode-u, dużo magii tutaj nie ma, po jej wywołaniu funkcja ma tylko zwrócić linki wygenerowane przez wcześniej usuniętą funkcję prolink_getLinks().

Na koniec dodajemy filtr, aktywujący shortcodes w widgetach tekstowych.

Jak zaznaczyłem wyżej jest to linijka opcjonalna (bardzo możliwe, że już gdzieś się znajduje w motywie) i należy ja dodać do functions.php tylko w przypadku, gdy shorcode nie będzie działał - będzie wyświetlał [prolink] zamiast linków z prolinka.

Zapisujemy zmiany w functions.php, zamykamy plik - nie będzie nam już potrzebny.


Teraz wystarczy już tylko przejść do widgetów w kokpicie WP i upuścić widget tekstowy w polu widgetów i wywołać nasz nowy shortcode, komendą:

[prolink]