25 10 10 Nawigacja między wpisami w Wordpresie
Na niemal każdym blogu istnieje możliwość poruszania się między wpisami lub ich grupami. W przypadku Wordpresa skonstruowanie tego typu nawigacji jest dość łatwe za sprawą kilku bardzo przydatnych funkcji motywów. Nieniejszy wpis ma na celu przedstawić jak z ów wbudowanych udogodnień korzystać.
Nawigacja między grupami wpisów
W większości przypadków, wpisy na blogach wyświetlane są grupami, po kilka ( kilkanaście ) na jednej stronie i w kolejności odwrotnej do tej w jakiej zostały dodane.
Do dadania odnośników służących przejściu do grupy nowszych wpisów służy funkcja previous_posts_link. Aby natomiast wyświetlić odnośnik do wpisów dodanych wcześniej, używamy funcji next_posts_link.
Funkcja previous_posts_link przyjmuje dwa argumenty:
Pierwszym z nich jest etykieta ( widoczny fragment ) odnośnika, drugim natomiast liczba ( lub cyfra ) określająca liczbę stron, na których odnośnik do kolejnych grup wpisów zostanie wyświetlony ( domyślnie 0 ).
<?php previous_posts_link('Nowsze wpisy', 0); ?>
Funkcja next_posts_link przyjmuje idenytyczne argumenty jak poprzednio omawiana.
<?php next_posts_link('Starsze wpisy', 0); ?>
Nawigacja w kategoriach i archiwach
Do wyświetlania odnośników umożliwiających porusznanie się po wpisach indeksu, archiwów i kategorii służy funkacja posts_nav_link.
<?php posts_nav_link('łącznik','nowsze wpisy','starsze wpisy'); ?>
Funkcja posts_nav_link przyjmuje trzy argumenty ( wszystkie w postaci łańcucha znaków ). Pierwszym jest łącznik, jaki znajdzie się pomiędzy odnośnikami do poprzedniego i następnego wpisu, drugim etykieta odnośnika wskazującego na stronę z nowszymi wpisami, trzecim natomiast etykieta odnośnika wskazującego na starsze wpisy.
Stosując podwójne wywołanie tej funkcji, można oddzielić od siebie oba odnośniki.
<div>
<?php posts_nav_link('','','<strong>Starsze wpisy</strong>'); ?>
</div>
<div>
<?php posts_nav_link('','<strong>Nowsze wpisy</strong>',''); ?>
</div>
Wszystkie argumenty dla funkcji posts_nav_link są łańcuachami znaków. Bez wiekszego problemu można osadzić w nich tagi HTML ( jak w przykładzie powyżej ).
Poruszanie się pomiędzy pojedyńczymi wpisami
Gdy jesteśmy na stronie pełnego wpisu i chcemy przejść do kolejnego ( dodanego po nim ), używamy funkcji motywu o nazwie next_post_link.
<?php next_post_link('format','etykieta odnośnika','tylko_z_kategorii_aktualnego_wpisu','wyłączone_kategorie'); ?>
Jeżeli natomiast chcemy zobaczyć chronologicznie starszy wpis, wówczas korzystamy z funkcji previous_post_link.
<?php previous_post_link('format','etykieta odonśnika','tylko_z_kategorii_aktualnego_wpisu','wyłaczone_kategorie'); ?>
Obie funkcje przyjmują podobne argumenty. Pierwszym z nich jest format określający co znajdzie się za i przed odnośnikiem do wpisu. Na przykład, aby wyświetlić sam odnośnik wpisujemy:
'%link'
Jeżeli chcemy aby odnośnik został pogrubiony, format może wyglądać tak:
'<strong>%link</strong>'
Drugim argumentem dla obu omawianych funkcji jest tekst widocznej części odnośnika. Może to być np. %title, czyli tytuł poprzedniego lub następnego wpisu.
Aby zamiast tytułu umieścić graficzny odnośnik, można dodać kod jak poniżej:
'<img src = "/ścieżka/do/pliku.jpg" alt = "alternatywny tekst" title = "%title" />'
Trzeci argument określa czy chcemy poruszać się tylko pomiędzy wpisami z określonej kategorii. Jeżeli tak, przyjmie on wartość TRUE ( w innym wypadku FALSE ).
Ostatni argument pozwala wykluczyć kategorie z których wpisy chcemy pominąć. Niechciane kategorie określamy za pomocą ich numerów ID i oddzielamy słowem "and %quot; Na przykład:
'1 and 3 and 12'
.
Typowy odnośnik do poprzedneiego wpisu może być więc wyświetlony z pomocą kodu jak poniżej:
<?php previous_post_link('%link','%title'); ?>
Odnośnik do starszego wpisu możemy natomiast wyświetlić tak:
<?php next_post_link('%link','%title') ?>
Jak można się przekonać z powyższych przykładów, zbudowanie w pełni funkcjonalnej nawigacji dla stron i wpisów w Wordpresie jest dość nieskomplikowane bo niemal cała praca jest wykonywana za nas przez funkcje motywów.
Szczegółowe opisy wszystkich omawianych tu funkcji można znaleźć w Kodeksie Wordpresa (posts_nav_link, next_posts_link, previous_posts_link, next_post_link, previous_post_link ).
Autor wpisu jest blogerem, programistą PHP, administratorem Linux oraz twórcą blogów
RSS Subskrybuj wpisy bloga