0.0.4 • Published 5 years ago

xws-editor-outlink v0.0.4

Weekly downloads
-
License
MIT
Repository
-
Last release
5 years ago

npm.io

Link Tool

Link Block for the Editor.js.

npm.io

Features

Allows to add link previews to your articles.

Note: this Tool requires server-side implementation for link data fetching. See backend response format for more details.

Installation

Install via NPM

Get the package

npm i --save-dev xws-editor-outlink

Include module at your application

const LinkTool = require("xws-editor-outlink");

Download to your project's source dir

  1. Download folder dist from repository
  2. Add dist/bundle.js file to your page.

Usage

Add a new Tool to the tools property of the Editor.js initial config.

var editor = EditorJS({
  ...

  tools: {
    ...
    linkTool: {
      class: LinkTool,
      config: {
        endpoint: 'http://localhost:8008/fetchUrl', // Your backend endpoint for url data fetching
      }
    }
  }

  ...
});

Config Params

Link Tool supports these configuration parameters:

FieldTypeDescription
endpointstringRequired: endpoint for link data fetching.

Output data

This Tool returns data with following format

FieldTypeDescription
linkstringPasted link url
metaobjectFetched link data. Any data got from backend. Currently title, image and description are supported by plugin's design.
{
  "type": "linkTool",
  "data": {}
}

Backend response format

You can implement backend for link data fetching your own way. It is a specific and trivial task depending on your environment and stack.

Backend response should cover following format:

{
  success: 1,
  meta: {
    // ... any fields you want
  }
}
Also, can contain any additional fields you want to store.