Dodawanie niestandardowych szybkich tagów WordPress

Interfejs API WordPress QuickTags umożliwia dodawanie przycisków do edytora tekstu administracyjnego WordPress. Szczerze mówiąc, edytor tekstu jest prawdopodobnie rzadziej używany niż edytor bogaty, a przy okazji dodawanie szybkich tagów może być całkiem przydatne, gdy często powtarzasz te same zadania.

Oto lista domyślnych szybkich tagów dostępnych w WordPressie:

Jak widać możesz tworzyć różne rodzaje przycisków, do każdego z nich przypisać klucz dostępu i łatwo zdefiniować własny, niestandardowy kod.

Aby dodać szybki tag, musisz podłączyć niestandardową funkcję do haka admin_print_footer_scripts. Zasadniczo pomysł polega na dodaniu niestandardowego kodu JavaScript w stopce administratora. Interfejs API szybkich tagów udostępnia wbudowaną funkcję o nazwie addButton:

QTags.addButton( id, display, arg1, arg2, access_key, title, priority, instance );

Funkcja ta przyjmuje 8 argumentów:

id: (string) (wymagany) Identyfikator HTML przycisku
display: (string) (wymagany) Wartość HTML przycisku
arg1: (string) (wymagany) albo tag początkowy, który ma zostać wstawiony, np. „<span>”, albo wywołanie zwrotne wykonywane po kliknięciu przycisku
arg2: (string) (opcjonalnie) Znacznik końcowy, taki jak „”. Pozostaw puste, jeśli tag nie musi być zamykany (np. „
”)
access_key: (string) (opcjonalnie) Skrót klawiszowy dostępu do przycisku
title: (string) (opcjonalnie) Wartość tytułu HTML przycisku
priorytet: (int) (opcjonalnie) Liczba reprezentująca żądaną pozycję przycisku na pasku narzędzi. 1 – 9=pierwszy, 11 – 19=drugi, 21 – 29=trzeci itd.
instancja: (string) (opcjonalnie) Ogranicz przycisk do określonej instancji szybkich tagów, dodaj do wszystkich instancji, jeśli nie są obecne

Oto kompletny fragment, który dodaje łącze WPExplorer do edytora:

// Add buttons to html editor
add_action('admin_print_footer_scripts','rc_quicktags');
function rc_quicktags() { ?>
	<script language="javascript" type="text/javascript">
		/* Adding Quicktag buttons to the editor WordPress ver. 3.3 and above
		* - Button HTML ID (required)
		* - Button display, value="" attribute (required)
		* - Opening Tag (required)
		* - Closing Tag (required)
		* - Access key, accesskey="" attribute for the button (optional)
		* - Title, title="" attribute (optional)
		* - Priority/position on bar, 1-9 = first, 11-19 = second, 21-29 = third, etc. (optional)
		*/
		QTags.addButton( 'WPexplorerlove', 'WPexplorerlove', '<a href="http://wpexplorer.com" target="_blank">', '</a>', 'w' );
	</script>
<?php
}

Oto wynik:

Aby użyć tego szybkiego tagu, kliknij go raz. Wstawi się początek tagu <a>, doda tekst i kliknij przycisk ponownie, co spowoduje dodanie tagu zamykającego . Otóż to!

Jeśli masz jakieś pytania lub rekomendacje, zostaw komentarz!