This module is a helping tool to render your widgets, when you're using the Geins CMS to create custom widgets.

• Geins account and Geins PWA Ralph Storefront. Get a free trial here
• Geins Ralph UI 20.0.0 or higher

These extra options can be added to the module configuration in nuxt.config.js file.

The component this module includes is called GeinsCreatedWidgets and it's only job is to render the component specified in the JSON supplied to the widget.

npm i @geins/ralph-module-cms

Add the module to your storefront by adding the following line to your nuxt.config.json file:

...
  modules: [
      ...
      '@geins/ralph-module-cms'
  ]

Set the widgetRenderTypesComponents config object in your nuxt.config.json file to use the GeinsCreatedWidgets component from this module to be used, instead of the default for the JSON widget type.

...
  publicRuntimeConfig: {
    ...
      widgetRenderTypesComponents: {
        JSON: 'GeinsCreatedWidgets'
      },
    ...
  }
...

Use the Create widget function in your Geins Merchant Center. Add your configuration in the following JSON format for this module to work correctly:

{
  "component": "MyWidgetComponent",
  "configuration": {
    // Add your configuration here
  }
}

Your custom widget component needs a configuration prop. This prop will hold the configuration from your JSON above. For example:

...
export default {
  name: 'MyWidgetComponent',
  props: {
    configuration: {
      type: Object,
      required: true
    }
  }
  ...
}
...