Przewodnik po tworzeniu niestandardowych skrótów w WordPress

Najprostszym sposobem na przedstawienie skrótów jest zdefiniowanie ich jako łatwego sposobu dodawania dynamicznej zawartości do postów, stron i pasków bocznych WordPress. Wiele wtyczek i motywów WordPress ma skróty jako sposób dodawania wyspecjalizowanych treści, takich jak formularze kontaktowe, galerie zdjęć, suwaki i inne. Najłatwiejszym sposobem na rozpoczęcie tworzenia i używania shortcode jest wtyczka shortcode. Jeśli jednak jesteś zainteresowany tworzeniem niestandardowych skrótów w WordPressie, zapnij pasy, ponieważ ten przewodnik jest dla Ciebie. Pamiętaj, że będzie to wymagało pewnej wiedzy technicznej w zakresie kodowania, o czym prawdopodobnie już wiesz.

Istnieją więc dwa sposoby, dzięki którym możesz znaleźć skróty WordPress, które będą dla Ciebie przydatne:

1. mogą zmniejszyć ilość kodu, który trzeba napisać,
2. upraszczają korzystanie z wtyczek, motywów i innych funkcji WordPress.

Proces przygotowania WordPressa do niestandardowych skrótów

Chociaż w żadnym wypadku nie jest to konieczne, ogólnie dobrym pomysłem jest przechowywanie niestandardowych skrótów w ich własnym pliku. W przeciwnym razie możesz dodać je do pliku functions.php motywu. Zacznij od utworzenia nowego pliku o nazwie „custom-shortcodes.php” i zapisz go w tym samym folderze, co plik functions.php motywu. Następnie, wewnątrz nowo utworzonego pliku, dodałbyś następujący blok kodu:
<?php
?>
Po wykonaniu tej czynności chcesz otworzyć plik functions.php i dodać następujący wiersz kodu:
include('skróty-własne.php');
Gratulacje! Jesteś teraz gotowy do tworzenia niestandardowych skrótów w WordPress.

Tworzenie podstawowych skrótów w WordPress

Wyjaśnimy proces tworzenia podstawowego shortcode WordPressa na przykładzie wstawienia prostego obrazu awatara. Pierwszym krokiem jest stworzenie funkcji shortcode. Wewnątrz pliku custom-shortcodes.php dodasz następujące elementy:

function simpleavatar_function() {
return '<img src=”https://simpleavatar.com/wp-content/uploads/avatar-simple.png”
alt=”doti-avatar” width=”96″ height=”96″ class=”left-align” />':
}

W powyższym przykładzie kodu funkcja simpleavatar_function zwraca wstępnie określony obraz o nazwie avatar-simple.png. Następnym krokiem byłoby zarejestrowanie shortcode w WordPress za pomocą wbudowanej funkcji add_shortcode. Nadal wewnątrz custom-shortcodes.php, upewnij się, że dodałeś następujący wiersz kodu:

add_shortcode('simpleavatar', 'simpleavatar_function');

Po zarejestrowaniu shortcode za pomocą funkcji add_shortcode, przekażesz tag shortcode ($tag) i odpowiednią funkcję ($func)/hook, które będą wykonywane przy każdym użyciu tego skrótu. W tym konkretnym przypadku znacznik skrótu to simpleavatar, a haczyk to dotiavatar_function.
Upewnij się, że w nazwach tagów używasz tylko małych liter , pomijając myślniki. Podkreślenia są jednak dopuszczalne.
Więc teraz, gdy utworzyłeś krótki kod i zarejestrowałeś go, byłoby wspaniale, gdybyś go wypróbował. Ilekroć chcesz, aby prosty awatar pojawił się w treści posta, po prostu użyj skrótu: [simpleavatar]

Tworzenie niestandardowych krótkich kodów w WordPressie z parametrami (atrybutami)

W poprzednim przykładzie nie miałeś dużo miejsca na zmiany. I załóżmy, że zamiast wypychania pojedynczego obrazu, chciałbyś mieć możliwość ustawienia, którego obrazu chcesz użyć za pomocą parametru. Świetnym sposobem na to jest dodanie kilku atrybutów ($atts). Tak jak poprzednio, wewnątrz custom-shortcodes.php dodaj kolejną funkcję:

function simplerating_function( $att=array() ) {

//ustaw domyślne parametry

extract(shortcode_atts(tablica(

'ocena'=> '5'

), $atts));

zwróć „<img src=\”http://simpleavatar.com/wp-content/uploads/$raing-star.png\”

alt=\”simple-rating\” width=\”130\” height=\”190\” class=\”left-align\” />”;

}

To, co napisałeś powyżej, akceptuje jeden parametr: ocenę. Jeśli wartość oceny nie zostanie przekazana, użyje domyślnej wartości ciągu 5. Robi to poprzez rozpakowanie tablicy atrybutów za pomocą wbudowanej funkcji shortcode_atts, a następnie połączenie wartości domyślnych z wartościami, które mogły zostać przekazane do funkcji . Upewnij się, że nie zapomnisz zarejestrować kodu :
add_shortcode('upraszczanie', 'upraszczanie_funkcji');

Po utworzeniu funkcji shortcode i dodaniu hooka, shortcode jest gotowy do znalezienia swojego miejsca w treści posta:

[ocena uproszczenia=3]

To byłby sedno tworzenia samozamykających się skrótów WordPress. Jednak istnieje jeszcze inny rodzaj, który możesz stworzyć.

Dodatkowy rodzaj krótkich kodów, które możesz utworzyć: dołączanie krótkich kodów

Do tego momentu wyjaśnialiśmy samozałączające się skróty. Istnieje jednak inny rodzaj krótkiego kodu, który chcielibyśmy przedstawić: dołączanie krótkich kodów.

Pozwalają one na użycie formatu w stylu BBCode. Taki styl wyglądałby tak:

[shortcode]treść[/shortcode]

Załączanie skrótów jest przydatne w przypadku, gdy trzeba manipulować załączoną treścią. Aby dokładniej to zilustrować, załóżmy, że masz określony styl przycisku, którego używasz w swojej witrynie. Możesz użyć kodu HTML, aby wygenerować ten przycisk/styl za każdym razem, gdy będziesz go potrzebować. Możesz jednak również skonfigurować niestandardowy krótki kod, aby zrobić to za Ciebie.

Korzystając z krótkiego kodu, będziesz mógł skupić się na treści zamiast na kodzie.

Tworzenie załączających krótkich kodów

Jeszcze raz byś do pliku custom-shortcodes.php i dodał co następuje:

function simplefollow_function( $atts, $content = null ) {

return '<a href=”https://twitter.com/simpleavatar/” target=”blank” class=”doti-follow”>' . $treść . '</a>';

}

W powyższym bloku kodu, $content = null służy do identyfikacji tej funkcji jako obejmującego shortcode. Wewnątrz tej funkcji umieszczasz zawartość w kodzie HTML. Prawdopodobnie domyślasz się następujący krok – rejestracja skróconego kodu:

add_shortcode('simplefollow', 'simplefollow_function');

Voila! Krótki kod jest gotowy do użycia.

Do czego to się sprowadza

Gdy zrozumiesz, jak działa tworzenie niestandardowych skrótów w WordPressie, sam proces okaże się prosty i bezproblemowy. Jeśli jednak wydaje Ci się to zbyt dużym wyzwaniem, pamiętaj, że możesz całkowicie obejść ten proces i wybrać wtyczki, motywy i inne funkcje, które pozwolą Ci dostosować stronę do własnych upodobań.