API pentru butoane de editare HTML (Quicktags) în WordPress

API pentru butoane de editare HTML vă permite să includeți butoane suplimentare în modul Text (HTML) al editorului WordPress .

Utilizare

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

Parametri

id – (string) (obligatoriu) ID-ul HTML pentru buton.

Implicit: Niciunul

display – (string) (obligatoriu) Valoarea HTML pentru buton.

Implicit: Niciunul

arg1 – (string) (obligatoriu) Fie o etichetă de început care să fie introdusă precum „<span>„, fie un apel invers care este executat atunci când butonul este apăsat.

Implicit: Niciunul

arg2 – (string) (opțional) Eticheta de închidere precum „</span>„. Lasă gol dacă eticheta nu are nevoie să fie închisă (de exemplu, „<hr />„).

Implicit: Niciunul

access_key – (string) (opțional) Cheie de acces la comenzi rapide pentru buton.

Implicit: Niciunul

title – (string) (opțional)) Valoarea titlului HTML pentru buton.

Implicit: Niciunul

priority – (int) (opțional) Un număr care reprezintă poziția dorită a butonului din bara de instrumente. 1 – 9 = prima, 11-19 = al doilea, 21-29 = treilea, etc.

Implicit: Niciunul

instance – (string) (opțional) Limitează butonul la o solicitare specifică, se adaugă la toate solicitările dacă nu este prezent.

Implicit: Niciunul

Valori de returnare

(mixed) Null sau obiectul buton de care este nevoie pentru retrocompatibilitate.

Exemple

// adaugă mai multe butoane la editorul html
function appthemes_add_quicktags() {
if (wp_script_is(‘quicktags’)){
?>
<script type=”text/javascript”>
QTags.addButton( ‘eg_paragraph’, ‘p’, ‘<p>’, ‘</p>’, ‘p’, ‘Paragraph tag’, 1 );
QTags.addButton( ‘eg_hr’, ‘hr’, ‘<hr />’, ”, ‘h’, ‘Horizontal rule line’, 201 );
QTags.addButton( ‘eg_pre’, ‘pre’, ‘<pre lang=”php”>’, ‘</pre>’, ‘q’, ‘Preformatted text tag’, 111 );
</script>
<?php
}
}
add_action( ‘admin_print_footer_scripts’, ‘appthemes_add_quicktags’ );

(Notă: pentru a evita o eroare de referință vom verifica să vedem dacă scriptul pentru butoane de editare HTML este sau nu în uz.)

Cele de mai sus ar adăuga butoane HTML la butoanele de editare HTML implicite în editorul de text. De exemplu, butonul HTML „p” ar fi:

<input type=”button” id=”qt_content_eg_paragraph” accesskey=”p” class=”ed_button” title=”Paragraph tag” value=”p”>

(Valoarea ID pentru fiecare buton este prefixată automat cu șirul „qt_content_„.)

Aici este un loc pentru un comentariu specific din quicktags.js, este destul de util în sine.

/**
* Funcția API principală pentru adăugarea unui buton de editare HTML
*
* Adaugă qt.Button sau qt.TagButton, în funcție de argumente. Primele trei argumente sunt întotdeauna necesare.
* Pentru a putea adăuga butoane de editare HTML, script-ul ar trebui să fie considerat ca dependent
* de butonul de editare HTML și scos în subsol. Dacă afișați JS direct din PHP,
* utilizați add_action („admin_print_footer_scripts”, „output_my_js”, 100) sau add_action („wp_footer”, „output_my_js”, 100)
*
* Minimum necesar pentru a adăuga un buton, care solicită o funcție externă:
*     QTags.addButton( ‘my_id’, ‘my button’, my_callback );
*     function my_callback() { alert(‘yeah!’); }
*
* Minimum necesar pentru a adăuga un buton care introduce o etichetă:
*     QTags.addButton( ‘my_id’, ‘my button’, ‘<span>’, ‘</span>’ );
*     QTags.addButton( ‘my_id2’, ‘my button’, ‘<br />’ );
*/

Butoane de editare HTML implicite

Acestea sunt valorile implicite ale butoanelor de editare HTML adăugate de WordPress pentru editorul de text (sortate în funcție de valoarea cheii de acces). Cheia de acces și ID trebuie să fie unice. Când adăugați propriile butoane, nu utilizați aceste valori:

Cheie de acces ||| ID ||| Valoare ||| Etichetă de start ||| Etichetă de închidere
a ||| link ||| link ||| <a href=”‘ + URL + ‘”> ||| </a>
b ||| strong ||| b ||| <strong> ||| </strong>
c ||| code ||| code ||| <code> ||| </code>
d ||| del ||| del ||| <del datetime=”‘ + _datetime + ‘”> ||| </del>
f ||| fullscreen ||| fullscreen ||| ||| |||
i ||| em ||| i ||| <em> ||| </em>
l ||| li ||| li ||| t<li> ||| </li>n
m ||| img ||| img ||| <img src=”‘ + src + ‘” alt=”‘ + alt + ‘” /> ||| |||
o ||| ol ||| ol ||| <ol>n ||| </ol>nn
q ||| block ||| b-quote ||| nn<blockquote> ||| </blockquote>nn
s ||| ins ||| ins ||| <ins datetime=”‘ + _datetime + ‘”> ||| </ins>
t ||| more ||| more ||| <!–more–> |||
u ||| ul ||| ul ||| <ul>n ||| </ul>nn
||| spell ||| lookup ||| |||
||| close ||| close ||| |||