pyxis-frontend

2.19.1 • Public • Published

Pyxis plugin

This project is a plugin to be integrated in clay-kiln to manage assets along with Pyxis Backend

Requirements

The Kiln project that is going to use this plugin should set the following environment variables:

PYXIS_HOST=http://localhost:3010 // Where pyxis backend is running
PYXIS_KEY=key // Token for every request

Minimum clay-kiln version required: 8.9.0

Setup

  1. Install the package as a dependency

$ npm install --save pyxis-frontend

  1. Create a folder for your plugin inside the kiln folder in the services section

$ mkdir PROJECT_FOLDER/app/services/kiln/plugins/PLUGIN_NAME

  1. Create an index.js file in the previous directory created, importing main components for the plugin and setting them in the specific window.kiln object.
const {
  NavButton,
  NavContent,
  Input,
  Modal
} = require('pyxis-frontend');

// Used to export components to the window element
module.exports = () => {
  window.kiln.navButtons['pyxis'] = NavButton;
  window.kiln.navContent['pyxis'] = NavContent;
  window.kiln.inputs['pyxis-picker'] = Input;
  window.kiln.modals['pyxis-picker'] = Modal;
};

NavButton: Required component to set the button into the drawer.

NavContent: Component dedicated to show the content of the plugin.

Input: Component to open the Modal for the image picker.

Modal: Component to show the image picker.

  1. At app/services/kiln/index.js require the previous component created.
 require('./plugins/pyxis')();

CUSTOM CONFIGURATION

To add custom configuration for the plugin:

  1. Create a global config if it doesn't exist
window.kiln.config = window.kiln.config || {};
  1. Set a config object in the clay kiln window object.

IMPORTANT: Custom configuration should be set before calling the plugin.

window.kiln.config['pyxis'] = {
  promotionalBaseWidth: 200,
  displayBaseHeight: 100
};
  1. Set a config file in Pyxis Backend.

OPTIONAL CONFIGURATION KEYS

displayBaseHeight: Base height required to calculate the ratio for display renditions.

promotionalBaseWidth: Base width required to calculate the ratio for promotional renditions.

Check how this value help to calculate the ratios in config file.

Readme

Keywords

none

Package Sidebar

Install

npm i pyxis-frontend

Weekly Downloads

104

Version

2.19.1

License

MIT

Unpacked Size

1.51 MB

Total Files

54

Last publish

Collaborators

  • stanographer
  • ealcantara22
  • jordanp9312
  • jess2896
  • wramirez92
  • reubenson
  • kerenzo
  • san_amiro
  • james_owen
  • nymagwebops
  • fpayes
  • afranco