Kodujemy użyteczne archiwum wpisów wg daty

Podstawowe funkcje WordPressa pozwalają nam na zbudowanie bardzo podstawowego archiwum wpisów wg. daty ich publikacji. Wystarczy jeden widget i kilka kliknięć, lub też jedna funkcja i kilka definicji parametrów i już mamy listę wpisów wg. miesięcy ;).

Gdy jednak chcemy zbudować coś ala ProBlogger, czyli rok, a obok niego lista wszystkich miesięcy, to tutaj już pojawiają się schody – z pomocą przychodzą nam umiejętności programistyczne.

Całość zostanie zawarta w jednej tylko funkcji – funkcję tę najlepiej będzie umieścić w pliku functions.php, znajdującym się w folderze naszego szablonu (większość szanujących się szablonów WordPressa posiada taki plik). Otwieramy więc go i gdzieś na samym dole przez zamykającym znacznikiem ?> wklejamy następujący kod:

function get_new_archive() {
     global $wpdb;
}

Gwoli wyjaśnienia dla osób nie mających do tej pory kontaktu z php – kod ten definiuje funkcję (get_new_archive()), która potem wyświetli nam treść na stronie. W funkcji tej znajdzie się cały kod odpowiedzialny za wyświetlanie naszego archiwum. Natomiast global $wpdb; będzie nam potrzebna do wykonania zapytania do bazy danych. Wyglądać ono powinno następująco:

$years = $wpdb->get_col("SELECT DISTINCT YEAR(post_date) FROM $wpdb->posts WHERE post_status = 'publish' AND post_type = 'post' ORDER BY post_date DESC");
foreach ( $years as $year ) {
}

Zapytanie to pobierze nam z bazy danych lata, w których były publikowane wpisy, a następnie przypisze je do zmiennej $years. Następnie wywołana zostanie pętla foreach, dzięki czemu każdy rok zostanie wyświetlony osobno. Teraz musimy jeszcze zdefiniować zapytanie, które pobierze nam wszystkie miesiące dla danego roku:

$months = $wpdb->get_col("SELECT DISTINCT MONTH(post_date) FROM $wpdb->posts WHERE post_status = 'publish' AND post_type = 'post' AND YEAR(post_date) = '".$year."' ORDER BY post_date ASC");
$with_posts = array_flip($months);

Mamy już rok, mamy miesiące, teraz musimy ustalić ich liczbę – jeśli nic się nie zmieniło, mamy ich dwanaście ;):

for ( $i = 1 ; $i <= 12 ; $i++ ) {
	if ( array_key_exists($i, $with_posts) ) {
		//Link
	} else {
		//Pusty miesiac
	}
}

Pozostaje nam już tylko wyświetlić dane – rok należy wyświetlić kodem następującym:

<a href="<?php echo get_year_link($year); ?>"><?php echo $year; ?></a>

Natomiast w przypadku miesięcy sprawa wygląda nieco inaczej. Zerknijcie na powyższą pętlę for – odpowiednie kody wstawiamy w miejsca komentarzy //Link oraz //Pusty miesiac.

for ( $i = 1 ; $i <= 12 ; $i++ ) {
	if ( array_key_exists($i, $with_posts) ) {
		echo '<div><a href="'. get_month_link($year, $i); .'">'. echo $set_month["$i"]; .'</div>';
	} else {
                echo '<div>'. $set_month["$i"]; .'</div>';
        }
}

Spostrzegawczy zauważą jednak tablicę $set_month – pozwala nam ona na wyświetlenie nazw miesięcy, a nie samych liczb – umieszczamy ją przed pierwszą pętlą foreach ( $years as $year ) aby całość była nieco bardziej zoptymalizowana. Sama tablica wygląda następująco:

$set_month = array(
		1 => Jan,
		2 => Feb,
		3 => Mar,
		4 => Apr,
		5 => May,
		6 => Jun,
		7 => Jul,
		8 => Aug,
		9 => Sep,
		10 => Oct,
		11 => Nov,
		12 => Dec
	);

W powyższym przypadku miesiące brzmią dosyć „wyspiarsko”, jeśli chcemy możemy je zmienić na polskie odpowiedniki ;) – nie powinno to już być problemem. W końcu wszystko trzeba ubrać w ładną tabelkę i skleić w całość:

function get_wp_archives(){
global $wpdb;
?>
<table id="archives_table">
<tbody>
<?php

$set_month = array(
1 => Jan,
2 => Feb,
3 => Mar,
4 => Apr,
5 => May,
6 => Jun,
7 => Jul,
8 => Aug,
9 => Sep,
10 => Oct,
11 => Nov,
12 => Dec
);

$years = $wpdb->get_col("SELECT DISTINCT YEAR(post_date) FROM $wpdb->posts WHERE post_status = 'publish' AND post_type = 'post' ORDER BY post_date DESC");

foreach ( $years as $year ){
?>
<tr>
<th class="archives_headline"><a href="<?php echo get_year_link($year); ?>"><?php echo $year; ?></a>:</th>
<?php
$months = $wpdb->get_col("SELECT DISTINCT MONTH(post_date) FROM $wpdb->posts WHERE post_status = 'publish' AND post_type = 'post' AND YEAR(post_date) = '".$year."' ORDER BY post_date ASC");

$with_posts = array_flip($months);

for ( $i = 1 ; $i <= 12 ; $i++ ){
if ( array_key_exists($i, $with_posts) ){ ?>
<td><a href="<?php echo get_month_link($year, $i); ?>"><?php echo $set_month["$i"];?></td>
<?php } else { ?>
<td class="archives_empty"><?php echo $set_month["$i"]; ?></td>
<?php }
} ?>
</tr>
<?php } ?>
</tbody>
</table>

<?php } ?>

Voila – całość zapisujemy, otwieramy odpowiedni plik naszego szablonu i dodajemy linijkę:

<?php get_wp_archives(); ?>

Czyż to nie jest genialne? Bardziej wyrachowani „koderzy” z pewnością dodadzą do tej prostej funkcji odpowiednie stylowanie czy wesprą kod za pomocą AJAX’a – jednak nawet bez tego całość działa – nie trzeba już nic zmieniać, skrypt automatycznie wyświetli wszystkie lata i doda linki do miesięcy, w których cokolwiek zostało opublikowane. Nie było tak źle, prawda?