在 ContentTools 中插入来自自定义媒体管理器的图像

Insert image from custom media manager in ContentTools

我在过去几年一直在开发的 PHP 框架中实现了很棒的 Content Tools 编辑器,但我已经走到了死胡同。

我想在当前可编辑区域内的光标位置插入来自自定义媒体管理器(已实现)的图像,就像默认图像工具所做的那样。

我曾尝试按照 教程 开发我的 自己的工具 ,但我的 知识不多 的 Coffee Script 和 JavaScript 阻碍了我。


根据我的理解,步骤可能是:

  1. 基于图像工具
  2. 创建新工具
  3. 这些工具将在模态 (iframe) 上打开 媒体管理器,而不是 ContentTools 的默认对话框(这就是媒体管理器在 FW 中的工作方式)
  4. 在媒体管理器上做我的事情(上传、裁剪、分类图像等)
  5. Select 从列表中选择一张图片,然后单击“插入”
  6. 媒体管理器 iframe 调用 parent.someFunction({ image data }) 插入图像,就像默认的 "图像" 工具一样。
  7. 完成!

一些严重的疑惑:

  1. 如何用模态调用覆盖默认对话框?

  2. 我是否必须将 区域名称光标位置(?) 作为参数传递给 iframe 或此信息是否存储在某个主要范围内? (或者...我什至不必担心这个问题,还是 编辑会处理所有事情?)

  3. 是否可以创建一个可以像这样调用的函数:

    parent.insertMediaManagerItem({
      url: 'my-image.png',
      width: '300px',
      height: '200px'
    });
    

同样,我对 ContentTools 主题非常迷失。任何帮助将不胜感激。

我能提供的最好的例子是用于 KCFinder 的实现,这是另一个用 PHP 编写的媒体管理器,我相信它使用(至少在我帮助的实现中)一个新的 window一个 iframe,但我相信主体将是相同的。

正如您所指出的,最简单的解决方案是编写您自己的图像工具来替换默认工具,这样上传 and/or 返回图像的责任将通过 CT 切换到您的自定义媒体管理器教程中讨论了图像对话框和 ImageUploader class。

以下是我们用于KCFinder的工具代码的修改版本:

When I say we I'm referring to myself and Wouter Van Marrum who raised and helped create the KCFinder example on github here)

// So this little bundle of variables is required because I'm using CoffeeScript
// constructs and this code will potentially not have access to these.
var __slice = [].slice,
__indexOf = [].indexOf || function(item) { for (var i = 0, l = this.length; i < l; i++) { if (i in this && this[i] === item) return i; } return -1; },
__hasProp = {}.hasOwnProperty,
__extends = function(child, parent) { for (var key in parent) { if (__hasProp.call(parent, key)) child[key] = parent[key]; } function ctor() { this.constructor = child; } ctor.prototype = parent.prototype; child.prototype = new ctor(); child.__super__ = parent.prototype; return child; },
__bind = function(fn, me){ return function(){ return fn.apply(me, arguments); }; };

// Define out custom image tool
var CustomImageTool = (function(_super) {
    __extends(CustomImageTool, _super);

    function CustomImageTool() {
      return CustomImageTool.__super__.constructor.apply(this, arguments);
    }

    // Register the tool with ContentTools (in this case we overwrite the 
    // default image tool).
    ContentTools.ToolShelf.stow(CustomImageTool, 'image');

    // Set the label and icon we'll use 
    CustomImageTool.label = 'Image';
    CustomImageTool.icon = 'image';

    CustomImageTool.canApply = function(element, selection) {    
        // So long as there's an image defined we can alwasy insert an image
        return true;
    };

    CustomImageTool.apply = function(element, selection, callback) {

        // First define a function that we can send the custom media manager
        // when an image is ready to insert.
        function _insertImage(url, width, height) {
            // Once the user has selected an image insert it

            // Create the image element
            var image = new ContentEdit.Image({src: url});

            // Insert the image
            var insertAt = CustomImageTool._insertAt(element);
            insertAt[0].parent().attach(image, insertAt[1]);

            // Set the image as having focus
            image.focus();

            // Call the given tool callback
            return callback(true);

            window.KCFinder = null;
        }

        // Make the new function accessible to your iframe
        window.parent.CustomMediaManager = {_inserImage: _insertImage};

        // Hand off to your custom media manager
        //
        // This bit you'll need to figure out for yourself or provide more
        // details about how your media manager works, for example in 
        // KCFinder here we open a new window and point it at the KCFinder
        // browse.php script. In your case you may be looking to insert an
        // iframe element and/or set the src for that iframe. 
        //
        // When the user uploads/selects an image in your media manager you
        // are ready to call the `_insertImage` function defined above. The
        // function is accessed against the iframe parent using:
        //
        //     window.parent.CustomMediaManager._insertImage(url, width, height);
        //

    };

    return CustomImageTool;

})(ContentTools.Tool);

我希望提供的内容足以帮助您集成媒体管理器,但如果没有,您能否提供有关媒体管理器工作原理的更多详细信息(也许是我可以查看的示例),我会很乐意尝试并提供更多完整的解决方案。