jQuery insert plugin for MediumEditor

This plugin expands capabilities of MediumEditor which is a clone of medium.com WYSIWYG editor.

The plugin is next, completely rewritten version of previous "images plugin". Now inserting images is only one of the plugin's addons. More addons (inserting files and maps) are coming soon...

Table of Contents

• Demo
• Available Addons
• Download
• Usage
• Options
• Methods
• Development
• Contributing
• Author

Demo

http://orthes.github.io/medium-editor-insert-plugin

Available Addons

Current available addons:

• images

More are coming soon...

Download

• Bower: bower install medium-editor-insert-plugin --save
• Manual: Download the latest release

Usage

The first step is to add all prerequisites (MediumEditor and jQuery):

<link rel="stylesheet" href="medium-editor/css/medium-editor.css">
<script src="medium-editor/js/medium-editor.min.js"></script>
<script src="bower_components/jquery/jquery.min.js"></script>

Now you have two possibilites. You can load all addons at once:

<link rel="stylesheet" href="medium-editor-insert-plugin/css/medium-editor-insert-plugin.css">
<script src="medium-editor-insert-plugin/js/medium-editor-insert-plugin.all.min.js"></script>

Or if you for some reason want, you can load only addons that you want separately. In this case, don't forget to load medium-editor-insert-plugin.min.js, which is the main plugin file, that initializes addons:

<link rel="stylesheet" href="medium-editor-insert-plugin/css/medium-editor-insert-plugin.css">
<script src="medium-editor-insert-plugin/js/addons/medium-editor-insert-plugin.min.js"></script>
<script src="medium-editor-insert-plugin/js/addons/medium-editor-insert-images.min.js"></script>

Initialize MediumEditor as you normally would:

<script>var editor = new MediumEditor('.editable');</script>

Finally, you can initialize the insert plugin with images addon:

$(function () {
  $('.editable').mediumInsert({
    editor: editor,
    addons: {
      images: {}
    }
  });
});

Options

• editor: (MediumEditor) instance of MediumEditor
• addons: (object) keys are names of used addons and values is object of addon options. Now available images and maps addons. (NOTICE: Remember to use medium-editor-insert-plugin.all.min.js, which includes all addons, or separately load medium-editor-insert-plugin.min.js and medium-editor-insert-maps.min.js or medium-editor-insert-images.min.js). Options for images addon:
  • imagesUploadScript: (string) relative path to a script that handles file uploads. Default: upload.php
  • formatData: (function) function that formats data before sending them to server while uploading an image
• enabled: (boolean) plugin's state: Default true.

Methods

• enable: enables the plugin. It's connected to Medium Editor's own activate function, so if the editor is activated, so is the plugin. (The plugin is enabled automatically. Use it only if you previously disabled the plugin.)
• disable: disables the plugin. It's connected to Medium Editor's own deactivate function, so if the editor is deactivated, so is the plugin.
• registerAddon: create new addon, like images or maps. Your addon object should contain init(options) method to initialize your addon and insertButton method that contains code of button in list of available addons.
• getAddon: simple getter for available addons.

Use example:

$('.editable').mediumInsert('disable');

Development

The plugin uses Grunt for automating development tasks and Bower for package management. To install all the necessities for development run these commands:

npm install
bower install

These are available Grunt tasks:

• js: runs jshint, uglify and copy
• css: runs compass
• test: runs jshint and qunit
• watch: watches for modifications on script/scss files and runs js/css task

Contributing

I'm happy when you not only use the plugin, but contribute your improvements, too. To do that, you need to meet only two requirements:

1. Use the same coding style as the plugin
2. Write QUnit tests (if you're adding a new funcionality) and test your changes with grunt test

Author

Pavel Linkesch | @linkesch | http://www.linkesch.sk