Articles

Kompletny przewodnik po WordPress Shortcodes

przed WordPress Block editor, WordPress shortcodes były jedną z najlepszych rzeczy, aby trafić w edytor WordPress, aby ułatwić dodawanie funkcji wtyczek i motywów do stron, postów i innych sekcji witryny WordPress.

WordPress shortcodes ultimate guide

Co to oznacza dla większości starszych wtyczek i stron internetowych, które wciąż są pełne skrótów? Czy skróty WordPress nadal będą działać? Czy istnieje sposób na łatwe przejście od używania skrótów WordPress do bloków WordPress?

Przekonajmy się. W tym przewodniku zbadamy skróty WordPress w erze edytora bloków WordPress.

w tym przewodniku

czym są skróty WordPress?

a WordPress shortcode jest wielokrotnego użytku, dynamiczny bit kodu zawinięty w . Skróty umożliwiają łatwe wstawianie określonych funkcji samego WordPressa lub wtyczki lub motywu do dowolnego postu, strony, niestandardowego typu postu lub widżetu. Pomyśl o skrótach WordPress, takich jak „skróty” lub makra na swojej stronie.

Możesz użyć skrótów WordPress do wyświetlania statycznej treści, która jest zbyt żmudna, aby nadal kodować i powtarzać. Możesz także użyć skrótów do wyświetlania dynamicznej zawartości, takiej jak galerie obrazów, odtwarzacze audio podcastów, kalendarze wydarzeń lub zmiana statystyk dla niektórych danych.

Format skrótów

jeśli chodzi o wstawianie skrótów, podstawowy format może być „rozszerzony” na kilka sposobów, umożliwiając dostosowanie lub dodanie dodatkowych informacji o ustawieniach zwanych atrybutami. Dodatkowo skróty mogą zawijać tekst (lub HTML), a nawet być zagnieżdżane w innym shortcode.

na przykład skrót może mieć następujące formaty:


Some text
<a href="http://mysite.com/">HTML content</a>
Some text more text 
 This is a custom icon 

atrybuty krótkiego kodu

skróty są również elastyczne, ponieważ mogą być rozszerzone o atrybuty. Dzięki atrybutom skróty oferują dodatkowe dostosowanie, po prostu dodając dodatkowe fragmenty kodu w ramach skrótu.

wtyczki i motywy oferują dodatkowe przewodniki i rubryki, które pomagają użytkownikom używać poprawnych fragmentów skrótów do dodawania lub usuwania niektórych elementów na wyjściu.

oto kilka przykładów skrótów z atrybutami.

]

Posts Heading

wbudowane skróty WordPress

WordPress ma kilka wbudowanych skróty do renderowania niektórych typów treści.

]

Skrót audio umożliwia osadzanie plików audio i odtwarzanie ich.

]

używany głównie z pojedynczymi obrazami, Skrót podpisu umożliwia zawijanie napisów wokół treści.

]

krótki kod galerii pozwala na dodanie jednej lub więcej galerii zdjęć do Twoich postów i stron.

]

embed shortcode umożliwia zawijanie osadzonych elementów o maksymalnej (ale nie stałej) szerokości i wysokości.

]

shortcode listy odtwarzania implementuje funkcjonalność wyświetlania kolekcji plików audio lub wideo w poście.

]

krótki kod wideo umożliwia osadzanie plików wideo i odtwarzanie ich.

Wtyczka&skróty motywów

konkretne motywy i wtyczki WordPress mają skróty zaraz po wyjęciu z pudełka, które można wstawić do edytora postów lub stron i wyrenderuje wynik na froncie. Do tej pory wiele motywów i wtyczek nadal używa skrótów.

na przykład skróty są często używane w typowych wtyczkach do kalendarzy, formularzy, tabel, członkostwa, liczników odliczania lub ciągnięcia cudzysłowów. Istnieją nawet wtyczki shortcode, które pozwalają tworzyć skróty dla czegokolwiek.

motywy WordPress mogą również wykorzystywać skróty do renderowania pewnych dynamicznych treści, które są wstępnie stylizowane lub dostarczane przez nie.

niestandardowe skróty

większość ekspertów decyduje się na tworzenie własnych skrótów, zasadniczo skracając czas potrzebny na kodowanie czegoś, co jest powtarzalne. Wystarczy prosty dodatkowy plik w katalogu plików, aby utworzyć niestandardowe skróty.plik php. Jeśli chcesz nauczyć się podstaw niestandardowych skrótów, oto przewodnik dotyczący tworzenia niestandardowych skrótów.

WordPress Shortcode API

dla programistów tworzących własne niestandardowe skróty, WordPress shortcode API zapewnia prosty zestaw funkcji do tworzenia skrótów WordPress do użytku w postach i stronach.

interfejs API Shortcode pomaga programistom wtyczek tworzyć dynamiczną zawartość, którą użytkownicy mogą dodawać do stron lub postów, dodając odpowiedni shortcode do obszaru zawartości. Na szczęście API obsługuje wszystkie skomplikowane parsowanie, eliminując potrzebę pisania niestandardowego wyrażenia regularnego dla każdego krótkiego kodu. Ponadto dołączone są funkcje pomocnicze do ustawiania i pobierania domyślnych atrybutów shortcode.

deweloperzy mogą się dokumentacji API Shortcode WordPress, aby dowiedzieć się więcej na temat:

  • Obsługa atrybutów
  • wyjście
  • zamykanie vs samozamykające się skróty
  • odniesienie do funkcji
  • ograniczenia
  • składnia Formalna

skróty w klasycznym edytorze

w przeszłości skróty były wstawiane do klasycznego edytora dowolnego post lub strona, jak to:

WordPress shortcode

Co to są bloki WordPress?

najpierw były skróty … ale potem przyszła edycja oparta na blokach. Wraz z wprowadzeniem WordPress 5.0 przyszła implementacja długo planowanego edytora Gutenberg lub edytora bloków WordPress jako głównego edytora stron i postów dla WordPress, zastępując klasyczny edytor tekstowy WordPress, który istnieje od lat.

oto spojrzenie na Edytor treści przed WordPress 5.5 (ach, to były czasy!)

edytor Gutenberga został po raz pierwszy ogłoszony w poprzednich wersjach WordPressa, ale pozostał opcjonalny do czasu WordPress 5.0, kiedy stał się domyślnym edytorem.

pobierz Ebook: Ultimate Guide to WordPress 5.0& edytor Gutenberga

nie ma nic złego w nowym zablokowanym edytorze. W rzeczywistości większość użytkowników lubi ulepszony i czystszy, mniej zastraszający wygląd zaplecza WordPress.

ale z edytorem bloków WordPress przyszedł bloki WordPress. Zniknęły opcje formatowania u góry, które przypominają aplikacje do edycji tekstu, takie jak Microsoft Word. Zamiast tego opcje formatowania zostały zastąpione opcjami prawego paska bocznego z zakładkami dla każdego bloku.

bloki WordPress są zasadniczo kontenerami treści. Istnieje wiele różnych bloków dla różnych rodzajów treści-obrazów, filmów, tekstów, nagłówków, galerii—co tylko chcesz.

istnieje nawet blok WordPress do formatowania, dystansowania i dzielenia, a są one swobodnie rozmieszczone w kategoriach dla łatwego dostępu.

wszystkie opcje i kontrolki, które były u góry, znajdują się po prawej stronie edytora stron / postów, z zakładkami u góry wskazującymi, czy chcesz zobaczyć opcje dla bieżącego bloku, sam lub cały dokument.

edytor bloków jest łatwiejszy, szybszy i bardziej przyjazny dla użytkownika. Ponadto twórcy motywów i wtyczek tworzą również własne bloki, które dodają więcej opcji bloków do domyślnych bloków WordPress.

bloki wielokrotnego użytku vs.Shortcodes

starym sposobem zapisywania zestawu predefiniowanych danych wyjściowych w edytorze WordPress classic było tworzenie własnych skrótów. Teraz ta metoda została zastąpiona blokami wielokrotnego użytku.

możliwość zapisywania wstępnie zdefiniowanych i wstępnie dostosowanych bloków ułatwiła również zapisanie układu i projektu określonego bloku i użycie go na innym. Podobnie jak szablon strony.

na przykład, jeśli dodasz Blok przycisków i stylujesz go określonym kolorem, efektami najechania kursorem itp., nie chcesz robić tego na każdej stronie, do której dodajesz ten przycisk. Jeśli zmienisz go na blok wielokrotnego użytku, przycisk zostanie zapisany w Twojej witrynie WordPress i stanie się własnym blokiem, którego możesz użyć na innych stronach lub postach.

Możesz również dalej aktualizować te bloki, konwertując je na zwykłe bloki, zapisując je jako nowe (z nową nazwą) lub aktualizując istniejący projekt bloku.

bloki Grupowe

w WordPress 5.3 pojawiło się również wprowadzenie bloków grupowych i szablonów.

zasadniczo masz możliwość grupowania pewnych bloków razem i przenoszenia lub aktualizowania ich wszystkich razem. To ostatecznie dało początek schematom blokowym. Szablony bloków ułatwiły edycję treści, ponieważ użytkownicy woleliby wybrać wzór i zaktualizować zawartość, zamiast zaczynać od pustego obszaru roboczego.

opcje stylizacji bloków

z każdym motywem dostępne są różne opcje stylu. Zwykle styl treści, które dodajesz na każdej stronie, jest z góry określony przez Twój motyw.

w edytorze bloków masz możliwość aktualizacji stylu każdego bloku indywidualnie, aby się wyróżnić lub uczynić je bardziej zauważalnymi.

bloki& pełna edycja strony

wraz z tymi wszystkimi postępami i zmianami w sposobie tworzenia i budowania stron na WordPress przychodzi pomysł i ostateczne przejście do tzw. pełnej edycji strony.

w wklejaniu większość użytkowników mogła aktualizować tylko faktyczną treść posta lub strony. Niektóre aspekty strony internetowej, takie jak Nagłówek, Stopka, paski boczne i widżety, nadal w dużej mierze zależą od tematu. To oczywiście sprawiło, że poszukiwanie idealnego motywu z odpowiednią ilością opcji było ostateczną walką dla programistów i użytkowników WordPress.

dzięki pełnej edycji witryny i wprowadzeniu konstruktora bloków trend tyka w kierunku edytowania wszystkich sekcji strony lub postu za pomocą bloków.

na przykład najnowszy motyw Twenty-Twenty WordPress podąża za tym wzorcem, dając twórcom i właścicielom witryn większą kontrolę nad ich witryną i tym, jak chcieliby, aby wyglądała.

patrząc w przyszłość, Programiści wtyczek i motywów będą musieli przyjąć inne podejście przy opracowywaniu oprogramowania, aby dostosować się do nowej pełnej edycji witryny i budowania stron edytora bloków WordPress. Chociaż pełne zastosowanie tego jest wciąż na horyzoncie, jest to pozytywna zmiana, którą prawdopodobnie zauważymy raczej wcześniej niż później.

nowy blok skrótów

przed edytorem bloków, skróty były wstawiane bezpośrednio do strony lub Edytora Stron. Teraz edytor bloków WordPress zawiera nowy blok skrótów.

blok shortcode ułatwia dalsze używanie starszych skrótów w poście lub stronie i zachowuje integralność wyjścia shortcode.

Uwaga: Wstawienie skróconego kodu do bloku akapitu może nie zawsze działać, więc może być konieczne użycie zamiast tego bloku skróconego kodu.

blok shortcode można dodać do strony lub postu, klikając przycisk Dodaj blok. Możesz też wpisać / shortcode i nacisnąć enter.

WordPress shortcode block

zauważysz, że w przeciwieństwie do innych popularnych bloków, Blok shortcode nie zawiera żadnych konkretnych ustawień na pasku narzędzi bloku lub pasku bocznym edytora, prawdopodobnie ze względu na fakt, że skróty można dostosować za pomocą ich atrybutów.

co oznacza edytor bloków dla skrótów WordPress?

edytor bloków WordPress ma poważne konsekwencje dla shortcodes. Omówmy kilka najważniejszych rzeczy do zapamiętania na temat skrótów WordPress w erze edytora bloków.

1. Edytor bloków WordPress zasadniczo zmienia potrzebę i cel skrótów dla większości wtyczek i motywów. W systemie edycji opartej na blokach, każdy „element” na stronie ma swój własny blok, a nie jest zawarty w jednym edytowalnym edytorze WYSIWYG.

ponieważ edytor bloków jest zupełnie innym podejściem do komponowania postu lub strony, bardziej dynamiczne części strony generowane przez skróty mogą istnieć jako bloki, które można dodawać indywidualnie.

2. Bloki mogą teraz zastępować większość skrótów, co eliminuje potrzebę nauczenia się obsługi skrótów. Koncepcja i format skrótów może mieć stromą krzywą uczenia się dla niektórych użytkowników, więc podejście blokowe może być łatwiejsze.

na przykład weźmy wtyczkę Gravity Forms. Przed edytorem bloków proces wstawiania formularza do postu lub strony był inny. W klasycznym edytorze trzeba było użyć przycisku, aby wstawić formularz do treści.

formularze grawitacyjne Wstaw formularz

Po wybraniu formularza do treści został dodany Skrót formularza. W zależności od wybranych opcji kod skrócony zawierał atrybuty tytułu i opisu.

teraz wtyczka Gravity Forms oferuje blok osadzania formularza. W edytorze bloków wybierz blok formularzy.

Po wybraniu formularza zobaczysz lepszy podgląd tego, jak formularz będzie wyglądał na twojej stronie. Ustawienia formularza można znaleźć w Ustawieniach bloku.

3. Twórcy motywów i wtyczek będą musieli zdecydować o przyszłości swoich implementacji shortcode i konwersji ich shortcode na bloki. Jak wspomniano powyżej, setki motywów, wtyczek i programistów nadal używają skrótów na swoich stronach internetowych i aplikacjach. Adopcja bloków może być powolna, ale gdy użytkownicy zapoznają się z nowym edytorem bloków, prawdopodobnie zażądają opcji blokowania.

dla tych programistów, którzy wciąż są daleko od przyjęcia systemu edycji bloków WordPress, pełna koncepcja edycji witryny może iść w parze z ich krótkimi kodami. Wtyczki, takie jak wtyczki do recenzji i ocen, odtwarzacze audio, tickery dat, galerie, formularze kontaktowe i większość innych, którzy nadal używają skrótów, są nadal „w grze.”

4. Skróty nie znikną w najbliższym czasie. Prawdopodobnie dlatego edytor bloków WordPress oferuje blok shortcode, aby pomóc w utrzymaniu użycia shortcode. Ponieważ skróty miały tak szerokie zastosowanie i implementację przed WordPress 5.0 i edytorem bloków, ważne jest, aby przyszłe wersje WordPress nadal obsługiwały skróty.

5. Skróty mogą być konwertowane do bloku. Masz ulubiony motyw lub wtyczkę, która używa skrótów? Jest prawdopodobne, że te skróty zostaną przekonwertowane na blok w pewnym momencie. Jeśli jesteś programistą wtyczki lub motywu lub budujesz witryny WordPress i używasz skrótów w niestandardowym motywie, możliwe jest przemyślenie skrótów jako bloków.

w następnej sekcji pokrótce omówimy, jak przekonwertować skróty WordPress na bloki WordPress.

Jak przekonwertować skróty WordPress na bloki WordPress

tak jak możesz dodawać niestandardowe skróty i bloki wielokrotnego użytku, możesz również łatwo konwertować niestandardowe skróty WordPress na bloki WordPress.

wykonaj pierwsze kroki z tego niestandardowego przewodnika po shortcode.

weź ten podstawowy przykład z formularzy Caldera:

 <?php/** * Handler for shortcode * * @param $atts * * @return string */function caldera_learn_basic_blocks_post_title_shortcode_handler($atts){$atts = shortcode_atts(, $atts, 'cl_post_title');return caldera_learn_basic_blocks_post_title($atts, $atts);}/** * Output the post title wrapped in a heading * * @param int $post_id The post ID * @param string $heading Allows : h2,h3,h4 only * * @return string */function caldera_learn_basic_blocks_post_title($post_id, $heading){if (!in_array($heading, )) {$heading = 'h2';}$title = get_the_title(absint($post_id));return "<$heading>$title</$heading>";}/** * Register Shortcode */add_shortcode('cl_post_title', 'caldera_learn_basic_blocks_post_title_shortcode_handler');

ten kod pobiera identyfikator posta i poziom nagłówka (h2, H3, he) i wypisuje tytuł posta zawinięty w kod HTML dla nagłówka.

Po zakończeniu i przetestowaniu, że kod działa, musisz zarejestrować shortcode jako blok. Oto przewodnik krok po kroku do konwersji skrótu WordPress na blok Gutenberga jako przykład.

więcej zasobów na temat tworzenia bloków WordPress

istnieje wiele wtyczek i zasobów dostępnych online, które pomogą Ci przejść do tego kroku, w tym oficjalna dokumentacja z WordPress dotycząca pisania pierwszego typu bloku. Możesz również sprawdzić Post Igora Benika, jak utworzyć blok do wyświetlania postów.

Po przeczytaniu tych przewodników będziesz w stanie dowiedzieć się, jak tworzyć własne bloki WordPress za pomocą niestandardowych skrótów.

Uwaga: proces może być nieco inny w przypadku różnych skrótów. Wtyczki i motywy z krótkimi kodami mogą mieć inne podejście ze względu na ogrom atrybutów, które należy wziąć pod uwagę. Zasadniczo, być może będziesz musiał przeprowadzić wiele badań i poświęcić sporo czasu na kodowanie tego.

werdykt dla WordPress Shortcodes

WordPress shortcodes są i nadal będą jedną z najważniejszych części WordPress. Skróty pomogły wielu programistom wtyczek uczynić ich wtyczki bardziej przyjaznymi dla użytkownika, a wielu programistów motywów rozszerza funkcjonalności swoich motywów. Skróty zmniejszyły również liczbę bólów głowy wielu twórców treści i właścicieli witryn po utworzeniu niestandardowych skrótów, jeśli chodzi o wielokrotne dodawanie i aktualizowanie rzeczy, które chcą.

mając to na uwadze, nie ma wątpliwości, że edytor bloków jest przyszłością edycji WordPress, więc spodziewaj się, że więcej programistów przyczyni się do tego, aby był lepszy i jeszcze bardziej wypełniony funkcjami, w tym tymi, którzy nadal używają skrótów. Patrząc w przyszłość, spodziewamy się, że więcej programistów przejdzie do używania i dodawania bloków WordPress zamiast skrótów WordPress.

mamy nadzieję, że nauczyłeś się wiele o znaczeniu skrótów WordPress, do czego służą i kiedy z nich korzystać. Mam nadzieję, że możesz zacząć tworzyć własne niestandardowe shortcodes i ostatecznie własne bloki, z których oba na pewno nie znikną w najbliższym czasie.

Udostępnij przez:

Dodaj komentarz

Twój adres e-mail nie zostanie opublikowany. Wymagane pola są oznaczone *