Можно ли повторно использовать wp.media.editor Modal для диалогов, отличных от медиа

30

Чтобы расширить: я хотел бы использовать тот же модальный код / ​​внешний вид (который используется в wp.media.Modal, wp.media.FocusManager), чтобы открыть модальный собственный диалог, а не редактор мультимедиа. Раньше для такого рода вещей я использовал Thickbox, но wp.media.Modal - это путь будущего модалов - не говоря уже о том, что он выглядит круто.

Я немного поковырялся в источнике JS и нашел пару возможных решений:

  1. "Займи" код media-views.js и используй его в моем плагине.
  2. «Расширьте» wp.media.Modal (в конце концов, это Backbone View).
  3. Создать собственную реализацию, jQueryUI и т. Д.
  4. Просто сдайся и используй толстый ящик.

Заимствование кажется немного менее опасным, чем использование wp.media.Model.extend ({}), но расточительно. Я не большой поклонник модальностей jQueryUI, но с этим можно справиться. В то же время, я мог бы сделать пользовательскую реализацию модалов (или основать ее на другой библиотеке).

Такое ощущение, что я упускаю что-то очевидное: кто-нибудь еще справился с этим, или новый модальный код библиотеки мультимедиа «слишком новый», чтобы его можно было использовать повторно?

Иер
источник
3
Похоже, ты просто скучаешь, пробуя это. Я бы порекомендовал пойти на # 2: вероятно, самый чистый и самый сложный / веселый, плюс, похоже, вы знаете свой путь в Backbone.
Монреалист
2
Пожалуйста, поделитесь своими выводами!
Пол
Интересный плагин / учебное пособие по адресу github.com/ericandrewlewis/wp-media-javascript-guide - Интерактивная документация по Javascript, поддерживающему WP Media .
Jgraup

Ответы:

12

Поздний ответ и редактирование. Отказ от ответственности: ниже нет кода для копирования и вставки.

Набросок

Поскольку я никогда не пытался использовать медиа-модал для чего-то еще, вот краткий обзор, набросанный путем выделения части из проекта, в котором я сейчас работаю. Это не готовый пример, но он должен приблизить вас достаточно близко. Просто внимательно прочитайте комментарии и внедрите следующий PHP в ваши объекты.

PHP

В нашем конструкторе мы регистрируем наши скрипты, добавляем мета-блоки, содержащие информацию и мультимедийную кнопку, фильтруем дополнительные типы MIME (например, ZIP) и заботимся о сохранении дополнительных данных:

public function __construct()
{
    add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_scripts' ) );

    foreach( $this->post_types as $post_type )
        add_action( "add_meta_boxes_{$post_type}", array( $this, 'add_meta_box' ) );

    add_filter( 'media_view_settings', array( $this, 'filter_media_view_settings' ), 10, 2 );

    add_action( 'wp_insert_post_data', array( $this, 'wp_insert_post_data' ), 10, 2 );
}

Убедитесь, что вы прерываете работу, если вам не нужен этот скрипт на определенной странице. Это экономит память, время запроса и помогает поддерживать вашу установку в чистоте.

public function enqueue_scripts( $page )
{
    if (
        ! in_array( $page, array( 'post.php', 'post-new.php' ) )
        # Assuming that there's a class property array that holds post types we want to add to
        # OR ! in_array( get_current_screen()->post_type, array_keys( $this->post_types ) )
    )
        return;

    wp_enqueue_media();
    wp_enqueue_script(
        'wpse_media_modal',
        plugins_url( 'assets/js/media-modal.js', dirname( __FILE__ ) ),
        array(
            # 'jquery',
            'media-views'
        ),
        null,
        true
    );
    wp_localize_script(
        'wpse_media_modal',
        'wpse_obj',
        $this->get_media_props()
    );
}

Затем мы добавляем мета-поле. Внутри функции мы можем положиться на свойство $postobjects post_type, которое также будет установлено для новых сообщений. Поскольку мы уже зарегистрировали обратные вызовы в конструкторе для соответствующих контекстных хуков, мы можем просто взять любой тип записи.

public function add_meta_box( $post )
{
    add_meta_box(
        'wprd_upload',
        __( 'Upload', 'our_textdomain' ),
        array( $this, 'render_content' ),
        $post->post_type,
        'advanced',
        'default',
        array()
    );
}

Дополнительные типы MIME

Просто добавьте массив, который либо переопределяет, либо добавляет к стандартным MIME-типам Media Modal. Вы также можете добавить или переопределить другие настройки. Просто var_dump( $settings );чтобы увидеть, что обеспечивает обратный вызов. Также убедитесь, что мы не перехватываем неправильный тип сообщения.

public function filter_media_view_settings( $settings, $post )
{
    if ( ! in_array( $post->post_type, array_keys( $this->post_types ) ) )
        return $settings;

    $settings['mimeTypes'] += array( 'application/zip' );

    return $settings;
}

Визуализировать контент

public function render_content()
{
    $props = array(
        'modalTitle'      => __( 'Select ZIP Archives', 'our_textdomain' ),

        // The following data is what we will access later
        // SomeIDfromLocalizedScriptOBJ
        'buttonID'        => 'open-media-lib',
        'buttonClass'     => 'open-media-button',
        'buttonText'      => __( 'Add ZIP', 'our_textdomain' ),
        'buttonDataText'  => __( 'Select', 'our_textdomain' ),
        'buttonDataTitle' => __( 'Select Whatever', 'our_textdomain' ),

        'mimeTypes'       => array(
            $zip => __( 'ZIP Archive', 'our_textdomain' ),
        ),
    );

    wp_nonce_field( plugin_basename( __FILE__ ), $this->nonce_name );
    ?>
    <input type="button"
           class="button <?php echo $props['buttonClass']; ?>"
           id="<?php echo $props['buttonID']; ?>"
           value="<?php echo $props['buttonText']; ?>"
           data-title="<?php echo $props['buttonDataTitle']; ?>"
           data-button-text="<?php echo $props['buttonDataText']; ?>" />
}

Сохранить данные

Наконец, мы гарантируем, что наши данные будут сохранены правильно и будут проверены. Используйте все esc_*()функции, приведение типов, одноразовые номера, а что нет.

public function wp_insert_post_data( $data, $post_array )
{
    if (
        ! in_array( $post_array['post_type'], array_keys( $this->post_types ) )
        # OR ( defined( 'DOING_AUTOSAVE' ) AND DOING_AUTOSAVE )
        OR ! isset( $_POST[ $this->nonce_name ] )
        OR ! wp_verify_nonce( $_POST[ $this->nonce_name ], plugin_basename( __FILE__ ) )
    )
        return $data;

    $post_array['zip'] = array_map( 'array_filter', $post_array['zip'] );

    $id = $post_array['ID'];
    update_post_meta(
        $id,
        'zip',
        $post_array['zip'],
        get_post_meta( $id, 'zip' )
    );

    return $data;
}

Последнее замечание перед тем, как перейти к примеру с JS: код не работает в текущем проекте. Так что он, как уже упоминалось, не будет работать по умолчанию! Это всего лишь руководство и ничего больше.

Javascript

Сам javascript довольно прост. Не. Но, как вы можете видеть, я внедряю оба jQuery как пользовательский локализованный объект сценария в функцию. С этого момента вам придется добавить любую логику, которая вам может понадобиться. Базовое окружение для разных состояний и обратных вызовов предоставляется и console.log()присутствует.

var ds = ds || {};

( function( $, obj ) {
    var media;

    ds.media = media = {};

    _.extend( media, {
        view: {},
        controller: {}
    } );

    media.buttonID    = '#' + obj.buttonID,

    _.extend( media, {
        frame: function() {
            if ( this._frame )
                return this._frame;

            var states = [
                new wp.media.controller.Library(),
                new wp.media.controller.Library( {
                    id:                 'image',
                    title:              'Images',
                    priority:           20,
                    searchable:         false,
                    library:            wp.media.query( { type: 'image' } ),
                    multiple:           true
                } ),
                /*new wp.media.controller.Library( {
                    id:                 'video',
                    title:              'Video',
                    priority:           40,
                    library:            wp.media.query( { type: 'video' } ),
                    multiple:           false,
                    contentUserSetting: false // Show the Upload Files tab.
                } ),*/
                new wp.media.controller.Library( {
                    id:                 obj.SomeIDfromLocalizedScriptOBJ,
                    title:              obj.SomeTitlefromLocalizedScriptOBJ,
                    priority:           30,
                    searchable:         true,
                    // filterable:         'uploaded',
                    library:            wp.media.query( { type: obj.SomeMIMETypesfromLocalizedScriptOBJ } ),
                    multiple:           true
                    // contentUserSetting: true
                } ),
            ];

            this._frame = wp.media( {
                // className: 'media-frame no-sidebar',
                states: states
                // frame: 'post'
            } );

            this._frame.on( 'open', this.open );

            this._frame.on( 'ready', this.ready );

            this._frame.on( 'close', this.close );

            this._frame.on( 'menu:render:default', this.menuRender );

            this._frame.state( 'library' ).on( 'select', this.select );
            this._frame.state( 'image' ).on( 'select', this.select );
            this._frame.state( obj.ZIPTabID ).on( 'select', this.select );

            return this._frame;
        },

        open: function() {
            console.log( 'Frame opened' );
        },

        ready: function() {
            console.log( 'Frame ready' );
        },

        close: function() {
            console.log( 'Frame closed' );
        },

        menuRender: function( view ) {
            /* view.unset( 'library-separator' );
            view.unset( 'embed' );
            view.unset( 'gallery' ); */
        },

        select: function() {
            var settings = wp.media.view.settings,
                selection = this.get( 'selection' );

            selection.map( media.showAttachmentDetails );
        },

        showAttachmentDetails: function( attachment ) {
            // This function normally is used to display attachments
            // Handle removal of rows
            media.removeAttachmentRow( /* some var */ );
        },

        removeAttachmentRow: function( row ) {
            // Remove stuff callback
        },

        init: function() {
            // Open media frame
            $( media.buttonID ).on( 'click.media_frame_open', function( e ) {
                e.preventDefault();

                media.frame().open();
            } );
        }
    } );

    $( media.init );
} )( jQuery, wpse_obj );

Учебники

Доминик Шиллинг (Dominik Schilling) - автор медиа-менеджера WP 3.5 - написал набор демонстраций для медиа-модалов. Вы можете просмотреть их на GitHub .

кайзер
источник