WordPress shortcode – pozycja w treści wpisu lub strony
Sobota, 14.02.2009
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
Niewielu mamy w Polsce sportowców rozpoznawanych na świecie. Tym bardziej należy się cieszyć i szanować tych kilku którym się to udało. Szczególnie cenię w tej kwestii Roberta Kubicę, za to że pomimo wielu przeciwności losu doszedł do tego, aby ścigać się z najlepszymi kierowcami świata w serii wyścigowej Formuła 1. “Kubicując” podczas każdego Grand Prix można się nieźle bawić obstawiając wyniki w Lidze typerów F1 na portalu v10.pl. Specjalnie dla członków Ligi stworzyłem narzędzie dzięki któremu można po każdym wyścigu podliczyć zdobyte punkty. Narzędzie zostało opracowane zgodnie z zapisami regulaminu ligi na sezon 2008.
Zawód informatyka to nieustająca walka o to, aby nie pozostać w tyle z bieżącymi informacjami. Dzięki wprowadzeniu kart w przeglądarkach, życie stało się łatwiejsze. Dotychczas otwierając przeglądarkę musiałem albo z głowy albo z ulubionych otwierać po kolei interesujące mnie serwisy informacyjne lub strony związane z bieżącą pracą czy zleceniem. Wraz z wprowadzeniem kart do przeglądarek, wystarczy otworzyć kilka stron i poukładać karty np. według rodzaju informacji. Odpowiednia opcja w przeglądarce umożliwia zapamiętanie układu i zawartości kart z poprzedniego uruchomienia programu. Przyznam się, że często z tego korzystam, jednak zdarzały mi się sytuacje w których traciłem informację o ostatnio otwartych kartach. Wystarczyło wejść na stronę i kliknąć w link, który otwierał nowe okno. Teraz, jeśli najpierw zamykałem główne okno przeglądarki a następnie dodatkowe, podczas następnego uruchomienia przeglądarki miałem zawartość dodatkowego okna zamiast mojego obszaru roboczego. Było to bardzo frustrujące, ponieważ za każdym razem, kiedy to się działo traciłem pozostawiony poprzedniego dnia tok myślenia. Z pomocą przychodzi dodatek do programu Firefox o nazwie