WordPress shortcode – pozycja w treści wpisu lub strony

HOWtorli WordPressO funkcjonalności shortcode (termin, oznaczający krótki kod, będący etykietą funkcji zdefiniowanej we wtyczce lub pliku functions.php) w WordPress napisano już wiele artykułów i poradników. Nie znalazłem w nich jednak informacji dotyczącej umiejscowienia treści, jaką każdy shortcode generuje. W oficjalnej dokumentacji nie doszukałem się ich również, więc przyjrzałem się konstrukcji kilku wtyczek. Oto rezultat.

Najprostszym przykładem jest (jak zawsze) wygenerowanie jakiegoś tekstu. Tak więc po umieszczeniu we wpisie krótkiego kodu [cp] w podglądzie wpisu powinien zostać wyświetlony tekst “Code is poetry”. Wystarczy, że poniższy kod zapiszemy jako plik o nazwie wtyczka.php:

function code() {
return 'Code is poetry';
}
add_shortcode('cp', 'code');

Jeśli teraz stworzymy wpis o treści: “Motto WordPress brzmi: [cp]” i wyświetlimy podgląd wpisu, będzie on wyglądał następująco:

Motto WordPress brzmi: Code is poetry

Zmodyfikujmy teraz kod funkcji code() do następującego:

function code() {
echo 'Code is poetry';
}
add_shortcode('cp', 'code');

Po tej modyfikacji treść wpisu będzie wyglądała następująco:

Code is poetryMotto WordPress brzmi:

Konkluzja jest więc następująca. Jeśli do wyświetlenia zawartości generowanej przez funkcję użyjemy polecenia echo, wygenerowana zawartość pojawi się zawsze na początku wpisu, przed jego treścią niezależnie od tego, w którym miejscu wpisu umieścimy krótki kod. Aby jednak wygenerowana treść pojawiła się w miejscu, które świadomie określimy poprzez wpisanie krótkiego kodu, koniecznie trzeba użyć polecenia return w funkcji generującej treść dla danego krótkiego kodu. Z punktu widzenia przejrzystości kodu, jak również dostępności wskazane jest używanie polecenia return, ponieważ dzięki temu można lepiej wykorzystać funkcje opisane za pomocą krótkich kodów.
W domyślnej instalacji WordPress (obecnie w wersji 2.7.1) jest zaimplementowany krótki kod [gallery]. Pomimo wielu użytecznych opcji, treść generowana jest przy użyciu poleceń echo, co uniemożliwia wstawienie zestawu zdjęć powiązanych z wpisem, np. po krótkim wstępie. Teraz jednak, dzięki powyższej wskazówce, nic nie stoi na przeszkodzie, aby każdy w szybki sposób mógł to naprawić.

Więcej przykładów i informacji dotyczących krótkich kodów:
Oficjalne API WordPress
Smashing Magazine
WPEngineer

Tłumaczenie WordPress 2.7.1 na język polski

WordPress 2.7.1 PLNajnowsza wersja WordPress doczekała się po niedługim czasie od premiery pakietu znacznych poprawek, co spowodowało wydanie nowej podwersji WordPress 2.7.1. Tym razem poza wsparciem importu z LiveJournal system został załatany i usprawniony w 68 miejscach. Aktualizacja dzięki nowemu automatycznemu systemowi przebiegła bez zakłóceń na kilku serwisach, którymi zarządzam oszczędzając mi mnóstwo czasu – brawa i słowa uznania dla Zespołu WordPress! Tak trzymać!
Tradycyjnie dla wszystkich zainteresowanych przygotowałem tłumaczenie do języka polskiego, które można pobrać poniżej lub ze strony Tłumaczeń WordPress.

Polskie tłumaczenie WordPress 2.7.1

Tłumaczenia do poprzednich wersji jak również najnowsze 2.7.1 przeznaczone dla serwisów można pobrać tutaj.