问题描述

我最终想要实现的是额外的设置添加到图像详细信息框，将存储在图像<img> 标记为 data-*属性

示例：<img src="..." data-my_setting="...">

我的代码

我正在创建一个插件，我需要创建更多的设置，当你编辑图像。到目前为止，我有以下代码：

jQuery(function($) {

    var imageDetails = wp.media.view.ImageDetails

    wp.media.view.ImageDetails = wp.media.view.ImageDetails.extend({
        // Initialize - Call function to add settings when rendered
        initialize: function() {
            this.on('post-render', this.add_settings);
        },
        // To add the Settings
        add_settings: function() {
            $('.advanced-section').prepend('
                <h2>My Settings</h2>
                <input type="text" class="my_setting">
            ');

            // Set Options
            this.controller.image.set({"data-settings": 'setting-value-here'})
        }
    });

}) // End of jQuery(function($))

我创建了一个新的帖子并添加了一个图像，然后点击它并按下 Edit(工具栏中弹出的铅笔图标) 。我最终在图片详细信息页面，这是什么样子：

到现在为止还挺好。在这行：

this.controller.image.set({"data-settings": 'setting-value-here'})

我通常会使用 jQuery 获取输入的值，但为了测试目的，我将其改为'setting-value-here'的静态值。我在图像详细信息框的 bottom-right 角中按了’Update’ 。

问题

在文本编辑器中，它显示 HTML 代码：

这个没有 data-settings="setting-value-here"，怎么来的？

如果我用以下替代行：

 this.controller.image.set({alt: 'setting-value-here'})

它确实将 ALT 标签更改为 alt="setting-value-here"。那么我试图设置 data- *属性我做错了什么？

解决方案

感谢 @bonger(拥有 50 个声望的完整赏金)，我有以下代码：

PHP：

function add_my_settings() {
    ob_start();
    wp_print_media_templates();
    $tpl = ob_get_clean();
    if ( ( $idx = strpos( $tpl, 'tmpl-image-details' ) ) !== false
            && ( $before_idx = strpos( $tpl, '<div class="advanced-section">', $idx ) ) !== false ) {
        ob_start();
        ?>
        <div class="my_setting-section">
            <h2><?php _e( 'My Settings' ); ?></h2>
            <div class="my_setting">
                <label class="setting my_setting">
                    <span><?php _e( 'My Setting' ); ?></span>
                        <input type="text" data-setting="my_setting" value="{{ data.model.my_setting }}" />
                    </label>
                </div>
            </div>
        <?php
        $my_section = ob_get_clean();
        $tpl = substr_replace( $tpl, $my_section, $before_idx, 0 );
    }
    echo $tpl;
};

// Hack the output of wp_print_media_templates()
add_action('wp_enqueue_media', $func =
    function() {
        remove_action('admin_footer', 'wp_print_media_templates');
        add_action('admin_footer',  'add_my_settings');
    }
);

JavaScript :(需要使用 wp_enqueue_script()入队)

// When Image is Edited
wp.media.events.on('editor:image-edit', function(data) {
    data.metadata.my_setting = data.editor.dom.getAttrib( data.image, 'data-my_setting' );
});

// When Image is Updated
wp.media.events.on('editor:image-update', function(data) {
    data.editor.dom.setAttrib( data.image, 'data-my_setting', data.metadata.my_setting );
});

最佳解决方案

一个方法是使用 (非常方便) 的编辑器：image-edit 和编辑器：image-update 事件触发由 tinymce wpeditimage 插件直接获取/设置 dom(更新为包装在 wp_enqueue_media 动作)：

add_action( 'wp_enqueue_media', function () {
    add_action( 'admin_footer', function () {
        ?>
        <script type="text/javascript">
        jQuery(function ($) {
            if (wp && wp.media && wp.media.events) {
                wp.media.events.on( 'editor:image-edit', function (data) {
                    data.metadata.my_setting = data.editor.dom.getAttrib( data.image, 'data-my_setting' );
                } );
                wp.media.events.on( 'editor:image-update', function (data) {
                    data.editor.dom.setAttrib( data.image, 'data-my_setting', data.metadata.my_setting );
                } );
            }
        });
        </script>
        <?php
    }, 11 );
} );

要添加和填充设置字段，可能会破坏 wp_print_media_templates()的输出，而不是覆盖 ImageDetails.initialize()(更新为包装在 wp_enqueue_media 操作中)：

add_action( 'wp_enqueue_media', function () {
    remove_action( 'admin_footer', 'wp_print_media_templates' );
    add_action( 'admin_footer', $func = function () {
        ob_start();
        wp_print_media_templates();
        $tpl = ob_get_clean();
        // To future-proof a bit, search first for the template and then for the section.
        if ( ( $idx = strpos( $tpl, 'tmpl-image-details' ) ) !== false
                && ( $before_idx = strpos( $tpl, '<div class="advanced-section">', $idx ) ) !== false ) {
            ob_start();
            ?>
    <div class="my_setting-section">
        <h2><?php _e( 'My Settings' ); ?></h2>
        <div class="my_setting">
            <label class="setting my_setting">
                <span><?php _e( 'My Setting' ); ?></span>
                <input type="text" data-setting="my_setting" value="{{ data.model.my_setting }}" />
            </label>
        </div>
    </div>
            <?php
            $my_section = ob_get_clean();
            $tpl = substr_replace( $tpl, $my_section, $before_idx, 0 );
        }
        echo $tpl;
    } );
} );

参考文献

注：本文内容整合自 Google/Baidu/Bing 辅助翻译的英文资料结果。如果您对结果不满意，可以加入我们改善翻译效果：薇晓朵技术论坛。