Wariacje na temat prostych shortcodes

WordPress Shortcodes część 2

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:

    1. Tworzenie podstawowej metody uchwytu
    2. 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

Podstawowa funkcja jest troche zmodyfikowana. Przyjmuje ona dwa parametry:

ATTS

i

CONTENT
function quote( $atts, $content = null ) {
return '
"'.$content.'"
'; }

Podłączenie do WordPressa:

Kolejny krok jest taki sam, jak w przykładnie pierwszym, czyli:

{add_shortcode("quote", "quote");}

Podsumowanie:

Mamy z powodzenie zintegrowane kolejne shortcodes do naszej templatki WordPress w sposób bardzo przyjazny dla użytkownika. Mam nadzieję, że ten poradnik okaże się dla Ciebie pomocny. Zapraszam do używania tych skrawków kodu w swoich projektach. Jeśli potrzebujesz pomocy, pisz w komentarzu.

O autorze

Krzysztof Czukiewski

Właściciel CP System. Pasjonat technologii internetowych. Od 2009 zgłębia tajemnice Wordpressa i optymalizacji SEO. Aktywnie pomaga właścicielom stron www w poprawie ich widoczności w wyszukiwarkach internetowych Google i Bing wykorzystując całą wiedzę i zdobyte przez lata doświadczenie.

Dodaj komentarz

pozostało znaków

Nie dodano jeszcze żadnego komentarza.