web-dev-qa-db-ja.com

ギャラリーのメディアマネージャを強化する

ギャラリービューで、WordPress 3.5以降のメディアエディタを強化したいと思います。
右側に新しい選択フィールドを追加して、選択した値をギャラリーのショートコードに送信します。

enter image description here

私は、wp.media.galleryのwp-includes/js/media-editor.jsという関数が、ギャラリーのショートコードを挿入するためのデフォルトの関数だと思います。

新しいパラメータを追加したいのですが、パラメータの値はMedia Manager内の選択フィールドから取得されます。

私は、特に この質問 から、さまざまなソースでプレイしてきましたが、Backboneは私にとって非常に新しいものであり、それがどのように機能するのかわかりません。私はフックprint_media_templatesでもプレイしましたが、メディアビューには結果がありません。

どんなフックを使うべきですか？

plugin-developmentmediamedia-librarymedia-modal
29
bueltge

ソリューションを作成するためのプラグインのための、おそらく小さな情報源。最初のphpパートでは、Media Manager内のボタンのためのJavaScriptが含まれています。もっと使える答えですが、@ One Trick Ponyの答えが作成されたことと正しい方向性とJSソリューションです。

画像上の結果を参照してください。 enter image description here

サイズがデフォルトのサイズではない場合、結果のショートコード。 enter image description here

フックprint_media_templatesは、ボタン、マークアップを含めるための適切な場所です。また、スクリプトをエンキューした、コントロールを追加するための解決策があります。

class Custom_Gallery_Setting {
    /**
     * Stores the class instance.
     *
     * @var Custom_Gallery_Setting
     */
    private static $instance = null;


    /**
     * Returns the instance of this class.
     *
     * It's a singleton class.
     *
     * @return Custom_Gallery_Setting The instance
     */
    public static function get_instance() {

        if ( ! self::$instance )
            self::$instance = new self;

        return self::$instance;
    }

    /**
     * Initialises the plugin.
     */
    public function init_plugin() {

        $this->init_hooks();
    }

    /**
     * Initialises the WP actions.
     *  - admin_print_scripts
     */
    private function init_hooks() {

        add_action( 'wp_enqueue_media', array( $this, 'wp_enqueue_media' ) );
        add_action( 'print_media_templates', array( $this, 'print_media_templates' ) );
    }


    /**
     * Enqueues the script.
     */
    public function wp_enqueue_media() {

        if ( ! isset( get_current_screen()->id ) || get_current_screen()->base != 'post' )
            return;

        wp_enqueue_script(
            'custom-gallery-settings',
            plugins_url( 'js/custom-gallery-setting.js', __FILE__ ),
            array( 'media-views' )
        );

    }

    /**
     * Outputs the view template with the custom setting.
     */
    public function print_media_templates() {

        if ( ! isset( get_current_screen()->id ) || get_current_screen()->base != 'post' )
            return;

        ?>
        <script type="text/html" id="tmpl-custom-gallery-setting">
            <label class="setting">
                <span>Size</span>
                <select class="type" name="size" data-setting="size">
                    <?php

                    $sizes = apply_filters( 'image_size_names_choose', array(
                        'thumbnail' => __( 'Thumbnail' ),
                        'medium'    => __( 'Medium' ),
                        'large'     => __( 'Large' ),
                        'full'      => __( 'Full Size' ),
                    ) );

                    foreach ( $sizes as $value => $name ) { ?>
                        <option value="<?php echo esc_attr( $value ); ?>" <?php selected( $value, 'thumbnail' ); ?>>
                            <?php echo esc_html( $name ); ?>
                        </option>
                    <?php } ?>
                </select>
            </label>
        </script>
        <?php
    }

}

// Put your hands up...
add_action( 'admin_init', array( Custom_Gallery_Setting::get_instance(), 'init_plugin' ), 20 );

フォローソースはjavascriptで、phpのサンプルソースではcustom-gallery-setting.jsファイルです。

/**
 * Custom Gallery Setting
 */
( function( $ ) {
    var media = wp.media;

    // Wrap the render() function to append controls
    media.view.Settings.Gallery = media.view.Settings.Gallery.extend({
        render: function() {
            media.view.Settings.prototype.render.apply( this, arguments );

            // Append the custom template
            this.$el.append( media.template( 'custom-gallery-setting' ) );

            // Save the setting
            media.gallery.defaults.size = 'thumbnail';
            this.update.apply( this, ['size'] );
            return this;
        }
    } );
} )( jQuery );
21
bueltge

あなたが本当にバックボーンテンプレートを使いたいのなら、あなたのフックは正しいです。

ギャラリー設定ビューのtemplate()関数をオーバーライドするのではなく、jQueryを使用してHTMLテンプレートを挿入します。しかし、私はあなたがすでにそれを知っていると思うので、私はBackboneバージョンを投稿するつもりです：

add_action('print_media_templates', function(){

  // define your backbone template;
  // the "tmpl-" prefix is required,
  // and your input field should have a data-setting attribute
  // matching the shortcode name
  ?>
  <script type="text/html" id="tmpl-my-custom-gallery-setting">
    <label class="setting">
      <span><?php _e('My setting'); ?></span>
      <select data-setting="my_custom_attr">
        <option value="foo"> Foo </option>
        <option value="bar"> Bar </option>        
        <option value="default_val"> Default Value </option>        
      </select>
    </label>
  </script>

  <script>

    jQuery(document).ready(function(){

      // add your shortcode attribute and its default value to the
      // gallery settings list; $.extend should work as well...
      _.extend(wp.media.gallery.defaults, {
        my_custom_attr: 'default_val'
      });

      // merge default gallery settings template with yours
      wp.media.view.Settings.Gallery = wp.media.view.Settings.Gallery.extend({
        template: function(view){
          return wp.media.template('gallery-settings')(view)
               + wp.media.template('my-custom-gallery-setting')(view);
        }
      });

    });

  </script>
  <?php

});
19
onetrickpony