Jak utworzyć własne skróty WordPress
W wersji 2.5 WordPress wprowadził krótkie kody i wszyscy prawdopodobnie użyliśmy ich w tym samym czasie. Zwykle dostarczane są w pakiecie z wtyczkami, a nawet motywami, a to, co robią, jest oglądane, gdy wstawia się coś w nawiasach kwadratowych, a następnie zastępuje je inną treścią; może to być proste zdanie lub potężna funkcja PHP, wszystko zależy od tego, co poleciłeś WordPressowi.
Dołączone kody są świetne i znacznie przyspieszają, ale czy nie byłoby wspaniale wiedzieć, jak tworzyć własne skróty?
W tym artykule poprowadzę Cię przez tworzenie prostych skrótów WordPress, aby pomóc Ci stworzyć dowolną funkcjonalność.
Prosty shortcode
Shortcode API działa bardzo prosto: najpierw musisz utworzyć funkcję zwrotną, która będzie działać w dowolnym momencie, gdy użyty zostanie shortcode; następnie musisz powiązać tę funkcję z określonym shortcode, dzięki czemu jest gotowy do użycia. Kod jest często umieszczany w pliku functions.php, ale jeśli planujesz mieć wiele skrótów, warto utworzyć oddzielny plik i dołączyć ten plik do pliku functions.php.
W naszym pierwszym przykładzie chcemy utworzyć shortcode, który stworzy trochę lorem ipsum za każdym razem, gdy wpiszemy [lorem] do edytora. Najpierw musimy utworzyć funkcję wywołania zwrotnego, która zwróci wartość lorem ipsum (w kodzie skrótów nic nie echo, wszystko jest zwracane):
function lorem_function() {return 'Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec nec nulla vitae lacus mattis volutpat eu at sapien. Nunc interdum congue libero, quis laoreet elit sagittis ut. Pellentesque lacus erat, dictum condimentum pharetra vel, malesuada volutpat risus. Nunc sit amet risus dolor. Etiam posuere tellus nisl. Integer lorem ligula, tempor eu laoreet ac, eleifend quis diam. Proin cursus, nibh eu vehicula varius, lacus elit eleifend elit, eget commodo ante felis at neque. Integer sit amet justo sed elit porta convallis a at metus. Suspendisse molestie turpis pulvinar nisl tincidunt quis fringilla enim lobortis. Curabitur placerat quam ac sem venenatis blandit. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Nullam sed ligula nisl. Nam ullamcorper elit id magna hendrerit sit amet dignissim elit sodales. Aenean accumsan consectetur rutrum.';}Następnie musimy dodać ten shortcode do WordPressa za pomocą funkcji add_shortcode w naszym pliku functions.php lub pliku, który jest w nim zawarty, ta funkcja dodaje kod short i łączy go z funkcją, którą właśnie utworzyliśmy. add_shortcode przyjmuje tylko dwa argumenty, z których pierwszy to nazwa, którą chcemy mieć w tym shortcode (co będziemy wpisywać między nawiasami kwadratowymi), a druga to funkcja, którą chcemy dołączyć do tego shortcode:
add_shortcode('lorem', 'lorem_function');To wszystko, czego potrzeba, aby stworzyć prosty shortcode w WordPress.
Dodawanie parametrów
Kontynuując tę sztuczną koncepcję treści, często potrzebujemy obrazów w naszych treściach podczas przygotowywania naszych makiet, a te obrazy muszą mieć różne rozmiary, więc teraz utworzymy krótki kod, aby wstawić obraz podobny do tego:
[picture width="500" height="500"]Kiedy WordPress napotka na ten problem, potrzebujemy funkcji, która wstawi obraz. Musi odczytać atrybuty width i height, ale na wszelki wypadek udostępnimy wartości domyślne, aby można było z nich korzystać bez atrybutów. Ponieważ możemy nie mieć dostępnego obrazu, użyjemy lorempixel.com usługa dostarczania losowego obrazu.
Najpierw musimy stworzyć funkcję:
function random_picture($atts) {extract(shortcode_atts(array('width' => 400,'height' => 200,), $atts));return '
';}Nazwaliśmy tę funkcję random_picture, a ponieważ ten shortcode będzie w stanie przyjąć argumenty, daliśmy mu parametr $ atts . Aby korzystać z atrybutów, potrzebujemy dwóch funkcji: shortcode_atts, która jest funkcją WordPress, która łączy nasze atrybuty ze znanymi atrybutami i wypełnia wartości domyślne w razie potrzeby; oraz funkcję PHP wyodrębniającą, która, jak sama nazwa wskazuje, wyodrębnia te atrybuty, które ustawiliśmy dla naszego shortcode. W końcu funkcja zwraca żądaną wartość, w tym przypadku kod HTML naszego obrazu w połączeniu ze zmiennymi szerokości i wysokości.
Pozostaje tylko zarejestrować ten kod:
add_shortcode('picture', 'random_picture');Nasz shortcode jest kompletny, po wpisaniu [picture] da nam losowy obraz 400 na 200, a jeśli użyjemy atrybutów, możemy stworzyć obraz o dowolnej wielkości.
Wniosek
Tworzenie krótkich skrótów do rzeczy, z których często korzystamy, zdecydowanie pomaga nam w pisaniu postów na blogu, ponieważ możesz zrobić wszystko, co chcesz, dzięki krótkim kodom, może to być tak proste, jak zwrot zdania, lub tak złożone, jak dodanie formularza lub najnowszych postów posortowanych według miesięcy.
Czy stworzyłeś pomocne skróty do WordPress? Jakie kody chciałbyś mieć? Daj nam znać w komentarzach.
Wyróżniony obraz / miniatura, obraz kodu via Marjan Krebelj.