W jednym z poprzednich wpisów opisywałem generowanie prostych shortcodów, które miały wyświetlać najnowsze wpisy. Shortcode to jeden z głownych powodów, dlaczego WordPress jest najpopularniejszą platformą CMS. Dzisiaj przyjrzymy się procesowi integracji jednej z popularnych funkcji shortcode w sposób możliwie najbardziej przyjazny dla użytkownika.
Chociaż istnieje kilka milionów opcji do wyboru, WordPress dzierży koronę, jako król systemów CMS i platform blogowych dzięki swojej niesamowitej elastyczności. Shortcodes to jedna z tych cech, które przyczyniają się do łatwości obsługi tego systemu.
Czytaj także: Shortcode w WordPressie
Definiowanie własnych shortcode w przeciwieństwie do BBCode jest o wiele prostsze, użytkownik nie musi pamiętać o skomplikowanej składni znaczników, które muszą być wprowadzone w celu np. utworzenia przycisku.
Prosty shortcode
Jesli nie masz pojęcia o BBCode, a co za tym idzie shortocdes, jego najprostsza wersja wygląda tak:
[my-gallery]
Ten kod odpowiada za wyświetlanie galerii w wordpressie. Prawda, że proste ?
Inne przykłady to:
[button]Tekst przycisku[/button]
Przenalizujemy każdy z wariantów
Każde wdrożenie shortcode wymaga dwustopniowego procesu:
- Tworzenie podstawowej metody uchwytu
- Podłączenie do obsługi WordPressa
Przykład 1: Zamiana zmiennych
Będziemy najpierw uczyć się, jak wdrożyć najprostszy możliwy shortcode. Na przykład pod każdym nowym wpisem chcemy umieścić wspólny tekst. Kopiowanie i wklejanie to proste podejście, ale na dłuższą metę będzie męczące.
O ile nie zaznaczono inaczej, wszystkie fragmenty kodu należy umieścić w pliku functions.php w katalogu używanej templatki
Tworzenie podstawowej funkcji
Podstawowa funkcja odpowiada za zamianę naszego shortcode
Function signOffText () {
Return „Dziękuję bardzo za czytanie! I pamiętaj, aby zapisać się do naszego kanału RSS. ’ ;
}
Podłączenie do wordpressa
Kolejny krok, który należy wykonać to skojarzyć dany shortcode z odpowiednią funkcją. Odbywa się to za pomocą metody
add_shortcode
add_shortcode ( „signoff” , „signOffText ’ );
Dokładnie, jedna linia kodu załatwia całą sprawę! Pierwszy parametr określa shortcode, który będzie używał w edytorze w wordpressie, drugi wskazuje funkcję, którą stworzyliśmy parę wierszy wyżej.
Uwaga: Dodanie metody add_shortcode odbywa się zawsze po okresleniu funkcji, nigdy przed!
To powinno wystarczyć. Wystarczy wpisać [SIGNOFF] do edytora i WordPress dynamicznie zastąpić tekst w razie potrzeby.
Przykład 2: Formatowanie tekstu za pomocą shortcode
Następnym przykładem dotyczy formatowanie fragmentu tekstu, np cytatu:
[quote]Jakiś tekst[/quote]
Tworzenie podstawowej funkcji
function quote( $atts, $content = null ) {
return '
';
}
Podłączenie do WordPressa:
Kolejny krok jest taki sam, jak w przykładnie pierwszym, czyli:
{add_shortcode(„quote”, „quote”);}