Języki: English – Français – 日本語 (Dodaj swój język)
Od wersji 2.5 WordPress obsługuje tak zwane Shortcodes. Zostały one wprowadzone do tworzenia makr, które mają być używane w treści postu. Przykłady shortcodes i sposoby ich użycia można znaleźć na stronie WordPress.com Shortcodes, chociaż niektóre shortcodes tam zamieszczone są ekskluzywne dla WordPress.com.
Trywialny shortcode dla galerii wygląda następująco:
Skróty mogą być również używane z dodatkowymi atrybutami, jak pokazuje poniższy przykład:
Oba przykłady będą wyświetlać galerię obrazów, która byłaby trudna do utrzymania podczas pisania znaczników HTML dla niej i utrzymywania jej w synchronizacji z przesłanymi obrazami. Korzystając z shortcode, znacznik dla galerii zostanie utworzony dynamicznie i automatycznie.
Wbudowane i dodatkowe shortcodes
WordPress domyślnie oferuje niektóre z shortcodes (na przykład galerię), a wtyczki mogą dodawać własne również za pośrednictwem Shortcode API.
Następujące shortcodes są dołączone do WordPressa:
Escaping Shortcodes
Czasami możesz chcieć użyć tekstu, który zwykle reprezentuje shortcode w swoich postach. Aby to zrobić, musisz uciec od shortcode, używając dwóch zestawów nawiasów zamiast jednego. Tak więc, aby wyświetlić to w swoim poście:
Piszesz to:
]
Dla shortcodów, które mają tag początkowy i końcowy, musisz uciec tylko pierwszy i ostatni nawias:
... ]
Zauważ, że tylko obecnie dostępne shortcodes mogą być ucieczką w ten sposób. Użycie podwójnych nawiasów wokół tekstu, który nie jest obecnie zarejestrowany jako shortcode, spowoduje, że oba zestawy nawiasów będą wyświetlane w twoim poście, a nie tylko jeden, jak w przypadku ucieczki zarejestrowanych shortcodes.
Shortcodes in Widgets
Domyślnie WordPress nie obsługuje shortcodes w widżetach paska bocznego do wersji 4.9. Rozwija tylko shortcodes w treści postu, strony lub niestandardowego typu postu. Aby dodać obsługę shortcode do widżetów paska bocznego, możesz zainstalować wtyczkę, użyć poniższego kodu lub przejrzeć Ulepszenia widżetów w 4.9:
add_filter( 'widget_text', 'shortcode_unautop' );add_filter( 'widget_text', 'do_shortcode' );
Ważne jest, aby te linie zostały dodane w tej kolejności. Pierwsza linia uniemożliwia WordPressowi przekształcanie podziałów linii w znaczniki akapitu, ponieważ uniemożliwia to działanie shortcodes. Druga linia jest tą, która sprawia, że shortcodes działają.
Shortcodes for Missing Plugins (Unregistered Names)
Oprócz wbudowanych shortcodes wszystkie inne są dodawane przez wtyczki. Jeśli wtyczka, która udostępnia dany shortcode, nie istnieje lub jest nieaktywna, WordPress potraktuje cały shortcode, jego atrybuty i zawartość wewnątrz niego jako zwykły tekst i zachowa znaki specjalne w wyjściowym HTML.
| Input |
Yay! |
<Yay> |
|
| z pluginem |
<(^_^)> |
<(^_^)> -- Yay! |
<(^_^<) -- <Yay> |
| (wyrenderowany) | <> | <> -.- Yay! | <<) – – |
| bez wtyczki |
Yay! |
<Yay> |
|
| (wyrenderowany) | Yay! |