Adăugare buton personalizat în TinyMCE 4, utilizabil începând cu WordPress 3.9-beta1

25 mar. 2014, 17:36:12
Vizualizări: 18.7K
Voturi: 21

Cum este posibil să adaugi un buton personalizat în editorul vizual TinyMCE, Versiunea 4?

În prezent am găsit această întrebare și răspuns cu câteva indicii pe această temă, dar nu o soluție sau un ghid pas cu pas. Nu am găsit un tutorial, documentație sau întrebări/răspunsuri despre cum să adaugi un buton personalizat în TinyMCE versiunea 4, inclus în WordPress începând cu versiunea 3.9-beta1.

Obiectiv

Exemplu de buton personalizat în TinyMCE

0
Toate răspunsurile la întrebare 3
1
24

Următorul mic plugin creează un buton personalizat în linia 1 a editorului vizual TinyMCE Versiunea 4 din WordPress, testat în WP Versiunea 3.9-beta2.

Plugin-ul include var_dump pentru a înțelege valorile. De asemenea, este posibil să adăugați butonul pe alte linii ale editorului vizual, folosind un alt hook, cum ar fi pentru linia 2: mce_buttons_2.

Rezultat

imagine descriere aici

Plugin, partea PHP - tinymce4-test.php

<?php
/**
 * Plugin Name: TinyMCE 4 @ WP Test
 * Description: 
 * Plugin URI:  
 * Version:     0.0.1
 * Author:      Frank Bültge
 * Author URI:  http://bueltge.de
 * License:     GPLv2
 * License URI: ./assets/license.txt
 * Text Domain: 
 * Domain Path: /languages
 * Network:     false
 */

add_action( 'admin_head', 'fb_add_tinymce' );
function fb_add_tinymce() {
    global $typenow;

    // Doar pe Post Type: post și page
    if( ! in_array( $typenow, array( 'post', 'page' ) ) )
        return ;

    add_filter( 'mce_external_plugins', 'fb_add_tinymce_plugin' );
    // Adaugă în linia 1 din WP TinyMCE
    add_filter( 'mce_buttons', 'fb_add_tinymce_button' );
}

// Include JS pentru TinyMCE
function fb_add_tinymce_plugin( $plugin_array ) {

    $plugin_array['fb_test'] = plugins_url( '/plugin.js', __FILE__ );
    // Afișează toate căile plugin-urilor JS
    var_dump( $plugin_array );
    return $plugin_array;
}

// Adaugă cheia butonului pentru adresare via JS
function fb_add_tinymce_button( $buttons ) {

    array_push( $buttons, 'fb_test_button_key' );
    // Afișează toate butoanele
    var_dump( $buttons );
    return $buttons;
}

Script, partea JavaScript - plugin.js

( function() {
    tinymce.PluginManager.add( 'fb_test', function( editor, url ) {

        // Adaugă un buton care deschide o fereastră
        editor.addButton( 'fb_test_button_key', {

            text: 'FB Test Button',
            icon: false,
            onclick: function() {
                // Deschide fereastra
                editor.windowManager.open( {
                    title: 'Example plugin',
                    body: [{
                        type: 'textbox',
                        name: 'title',
                        label: 'Title'
                    }],
                    onsubmit: function( e ) {
                        // Inserează conținut când formularul ferestrei este trimis
                        editor.insertContent( 'Title: ' + e.data.title );
                    }

                } );
            }

        } );

    } );

} )();

Gist

Folosește Gist bueltge/9758082 ca referință sau descarcă-l. Gist-ul conține și mai multe exemple pentru diferite butoane în TinyMCE.

Link-uri

25 mar. 2014 17:36:12
Comentarii

Documentația TinyMCE despre cum să creezi dialoguri nu este de fapt foarte utilă. Așa că am scris un articol care enumeră diferitele widget-uri și layout-uri de containere disponibile: http://makina-corpus.com/blog/metier/2016/how-to-create-a-custom-dialog-in-tinymce-4

Gagaro Gagaro
30 mar. 2016 12:31:21
2

Și, dacă dorești să ai un buton cu un icon real, atunci poți folosi dashicons sau propria ta fontă de iconiți pentru asta.

Crează un fișier CSS și încarcă-l în partea de administrare;

i.mce-i-pluginname:before {
    content: "\f164";
    display: inline-block;
    -webkit-font-smoothing: antialiased;
    text-align: center;
    font: 400 20px/1 dashicons!important;
    speak: none;
    vertical-align: top;
}

Practic luat direct din nucleul WordPress.

27 mar. 2014 10:14:45
Comentarii

Corect, era în lista mea de linkuri de mai sus, în lista de linkuri.

bueltge bueltge
27 mar. 2014 11:02:04

Aș fi vrut să găsesc acest răspuns înainte să petrec jumătate de oră încercând să-l adaug printr-un fișier CSS. Aceasta pare cea mai bună metodă; toate tutorialele pe care le-am găsit online sunt inutil de verbose.

aendra aendra
14 iul. 2014 12:24:57
1

Metoda simplă de adăugare a unui buton

1) ADAUGAȚI ACEST COD ÎN FUNCTIONS.PHP SAU ÎNTR-UN PLUGIN

//add_protect_shortcode_button
add_action('admin_init', 'add_cb_button');function add_cb_button() {
   if (current_user_can('edit_posts')  &&  get_user_option('rich_editing') == 'true') {
        add_filter('mce_buttons_2', 'register_buttonfirst');
        add_filter('mce_external_plugins', 'add_pluginfirst');
   }
}
function register_buttonfirst($buttons) {  array_push($buttons, "|", "shortcode_button1" );   return $buttons;}
function add_pluginfirst($plugin_array) {$plugin_array['MyPuginButtonTag'] =  plugin_dir_url( __FILE__ ).'My_js_folder/1_button.php';return $plugin_array;}
add_filter( 'tiny_mce_version', 'my_refresh_mceeee1');  function my_refresh_mceeee1($ver) {$ver += 3;return $ver;}

2) Creați fișierul 1_button.php în directorul țintă și inserați acest cod (notă, modificați URL-urile "wp-load" și "ButtonImage.png"!!!)

<?php 
header("Content-type: application/x-javascript");
require('../../../../wp-load.php');
?>
(function() {
    // START my customs
    var abcd =location.host;

    tinymce.create('tinymce.plugins.shortcodebuton_plugin2', {  
        init            : function(ed, this_folder_url)
        {
                    // -------------------------
                    ed.addButton('shortcode_button1', {  
                        title : 'Show Level1 count',  
                        image : this_folder_url + '/ButtonImage.png',
                        onclick : function() {  
                            ed.selection.setContent('[statistics_sp]');  
                                //var vidId = prompt("YouTube Video", "");
                                //ed.execCommand('mceInsertContent', false, '[youtube id="'+vidId+'"]');
                        }  
                    });


        }, 

        createControl   : function(n, cm) {     return null;  }, 
    });  
    tinymce.PluginManager.add('MyPuginButtonTag', tinymce.plugins.shortcodebuton_plugin2);  
})();
20 feb. 2015 17:37:43
Comentarii

Cred că aceasta nu este cea mai bună metodă. Includerea fișierului wp-load.php nu este stabilă. Locația acestui fișier poate varia. Instalarea WordPress oferă posibilități implicite de a muta folderele pentru teme și plugin-uri.

bueltge bueltge
20 feb. 2015 18:29:48