@uttori/plugin-vm-random-documents v2.1.4

Uttori View Model Enrichment Plugin - Random Documents

A plugin to expose and add randomly selected documents to a view-model or other object.

Install

npm install --save @uttori/plugin-vm-random-documents

Config

{
  // Registration Events
  events: {
    callback: ['view-model-home'],
  },

  // Key to use in the view model
  key: 'randomDocuments',

  // Number of documents to return.
  limit: 10,

  // A list of slugs to ignore
  ignore_slugs: [],
}

API Reference

ViewModelRandomDocuments

Uttori View Model Enrichment - Random Documents

Kind: global class

• ViewModelRandomDocuments
  • .configKey ⇒ string
  • .defaultConfig() ⇒ object
  • .validateConfig(config, _context)
  • .register(context)
  • .callback(viewModel, context) ⇒ Promise.<object>

ViewModelRandomDocuments.configKey ⇒ string

The configuration key for plugin to look for in the provided configuration.

Kind: static property of ViewModelRandomDocuments Returns: string - The configuration key. Example (ViewModelRandomDocuments.configKey)

const config = { ...ViewModelRandomDocuments.defaultConfig(), ...context.config[ViewModelRandomDocuments.configKey] };

ViewModelRandomDocuments.defaultConfig() ⇒ object

The default configuration.

Kind: static method of ViewModelRandomDocuments Returns: object - The configuration. Example (ViewModelRandomDocuments.defaultConfig())

const config = { ...ViewModelRandomDocuments.defaultConfig(), ...context.config[ViewModelRandomDocuments.configKey] };

ViewModelRandomDocuments.validateConfig(config, _context)

Validates the provided configuration for required entries.

Kind: static method of ViewModelRandomDocuments

Example (ViewModelRandomDocuments.validateConfig(config, _context))

ViewModelRandomDocuments.validateConfig({ ... });

ViewModelRandomDocuments.register(context)

Register the plugin with a provided set of events on a provided Hook system.

Kind: static method of ViewModelRandomDocuments

Example (ViewModelRandomDocuments.register(context))

const context = {
  config: {
    [ViewModelRandomDocuments.configKey]: {
      ...,
      events: {
        callback: ['document-save', 'document-delete'],
        validateConfig: ['validate-config'],
      },
    },
  },
  hooks: {
    on: (event, callback) => { ... },
  },
};
ViewModelRandomDocuments.register(context);

ViewModelRandomDocuments.callback(viewModel, context) ⇒ Promise.<object>

Queries for random documents and searches the storage provider.

Kind: static method of ViewModelRandomDocuments Returns: Promise.<object> - The provided view-model document.

Example (ViewModelRandomDocuments.callback(viewModel, context))

const context = {
  config: {
    [ViewModelRandomDocuments.configKey]: {
      ...,
    },
  },
  hooks: {
    on: (event) => { ... },
    fetch: (event, query) => { ... },
  },
};
ViewModelRandomDocuments.callback(viewModel, context);

Tests

To run the test suite, first install the dependencies, then run npm test:

npm install
npm test
DEBUG=Uttori* npm test

Contributors

• Matthew Callis

License

• MIT