O 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

Najnowsza 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.

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

UdostÄ™pniam dziÅ› do pobrania tÅ‚umaczenie jednej z lepszych wtyczek zarzÄ…dzajÄ…cych obrazami do WordPress – NextGEN Gallery. Alex Rabe, twórca wtyczki przygotowuje już kolejnÄ… wersjÄ™, póki co jednak wersja 1.0.2 oznaczona jest jako stabilna. Oto niektóre zmiany i nowe funkcje jakie zostaÅ‚y wprowadzone:

1. Wsparcie dla technik SEO
2. Rozszerzone funkcje sortowania
3. Dodanie pól data i czas do bazy danych, które pobierane są z danych EXIF zdjęć
4. Wsparcie dla technologii PicLens
5. Kopiowanie i przenoszenie zdjęć między galeriami
6. Zarządzanie tagami obrazów
7. Generator miniatur wykorzystujÄ…cy technologiÄ™ AJAX
8. Rozszerzone zarzÄ…dzanie uprawnieniami

Pobierz polskie tłumaczenie wtyczki Galeria NextGen v.1.0.2