var fs = require('fs'), path = require('path'), RDB = require('./redis.js'), async = require('async'), winston = require('winston'), eventEmitter = require('events').EventEmitter, plugins = { libraries: {}, loadedHooks: {}, staticDirs: {}, cssFiles: [], // Events readyEvent: new eventEmitter, init: function() { if (this.initialized) return; if (global.env === 'development') winston.info('[plugins] Initializing plugins system'); var _self = this; // Read the list of activated plugins and require their libraries async.waterfall([ function(next) { RDB.smembers('plugins:active', next); }, function(plugins, next) { if (plugins && Array.isArray(plugins) && plugins.length > 0) { async.each(plugins, function(plugin, next) { var pluginPath = path.join(__dirname, '../plugins/', plugin), modulePath = path.join(__dirname, '../node_modules/', plugin); if (fs.existsSync(pluginPath)) _self.loadPlugin(pluginPath, next); else if (fs.existsSync(modulePath)) _self.loadPlugin(modulePath, next); else { if (global.env === 'development') winston.warn('[plugins] Plugin \'' + plugin + '\' not found'); next(); // Ignore this plugin silently } }, next); } else next(); }, function(next) { if (global.env === 'development') winston.info('[plugins] Sorting hooks to fire in priority sequence'); Object.keys(_self.loadedHooks).forEach(function(hook) { var hooks = _self.loadedHooks[hook]; hooks = hooks.sort(function(a, b) { return a[3] - b[3]; }); }); next(); } ], function(err) { if (err) { if (global.env === 'development') winston.info('[plugins] NodeBB encountered a problem while loading plugins', err.message); return; } if (global.env === 'development') winston.info('[plugins] Plugins OK'); _self.initialized = true; _self.readyEvent.emit('ready'); }); }, ready: function(callback) { if (!this.initialized) this.readyEvent.once('ready', callback); else callback(); }, initialized: false, loadPlugin: function(pluginPath, callback) { var _self = this; fs.readFile(path.join(pluginPath, 'plugin.json'), function(err, data) { if (err) return callback(err); var pluginData = JSON.parse(data), libraryPath, staticDir; async.parallel([ function(next) { if (pluginData.library) { libraryPath = path.join(pluginPath, pluginData.library); fs.exists(libraryPath, function(exists) { if (exists) { _self.libraries[pluginData.id] = require(libraryPath); if (pluginData.hooks && Array.isArray(pluginData.hooks) && pluginData.hooks.length > 0) { async.each(pluginData.hooks, function(hook, next) { _self.registerHook(pluginData.id, hook, next); }, next); } } }); } else next(); }, function(next) { // Static Directories for Plugins if (pluginData.staticDir) { staticDir = path.join(pluginPath, pluginData.staticDir); fs.exists(staticDir, function(exists) { if (exists) { _self.staticDirs[pluginData.id] = staticDir; next(); } else next(); }); } else next(); }, function(next) { // CSS Files for plugins if (pluginData.css && pluginData.css instanceof Array) { if (global.env === 'development') winston.info('[plugins] Found ' + pluginData.css.length + ' CSS file(s) for plugin ' + pluginData.id); _self.cssFiles = _self.cssFiles.concat(pluginData.css.map(function(file) { return path.join('/plugins', pluginData.id, file); })); next(); } else next(); } ], function(err) { if (!err) { if (global.env === 'development') winston.info('[plugins] Loaded plugin: ' + pluginData.id); callback(); } else callback(new Error('Could not load plugin system')) }); }); }, registerHook: function(id, data, callback) { /* `data` is an object consisting of (* is required): `data.hook`*, the name of the NodeBB hook `data.method`*, the method called in that plugin `data.callbacked`, whether or not the hook expects a callback (true), or a return (false). Only used for filters. (Default: false) `data.priority`, the relative priority of the method when it is eventually called (default: 10) */ var _self = this; if (data.hook && data.method) { // Assign default priority of 10 if none is passed-in if (!data.priority) data.priority = 10; _self.loadedHooks[data.hook] = _self.loadedHooks[data.hook] || []; _self.loadedHooks[data.hook].push([id, data.method, !! data.callbacked, data.priority]); if (global.env === 'development') winston.info('[plugins] Hook registered: ' + data.hook + ' will call ' + id); callback(); } else return; }, fireHook: function(hook, args, callback) { var _self = this hookList = this.loadedHooks[hook]; if (hookList && Array.isArray(hookList)) { //if (global.env === 'development') winston.info('[plugins] Firing hook: \'' + hook + '\''); var hookType = hook.split(':')[0]; switch (hookType) { case 'filter': // Filters only take one argument, so only args[0] will be passed in var returnVal = (Array.isArray(args) ? args[0] : args); async.eachSeries(hookList, function(hookObj, next) { if (hookObj[2]) { _self.libraries[hookObj[0]][hookObj[1]](returnVal, function(err, afterVal) { returnVal = afterVal; next(err); }); } else { returnVal = _self.libraries[hookObj[0]][hookObj[1]](returnVal); next(); } }, function(err) { if (err) { if (global.env === 'development') { winston.info('[plugins] Problem executing hook: ' + hook); } } callback(err, returnVal); }); break; case 'action': async.each(hookList, function(hookObj) { if ( _self.libraries[hookObj[0]] && _self.libraries[hookObj[0]][hookObj[1]] && typeof _self.libraries[hookObj[0]][hookObj[1]] === 'function' ) { _self.libraries[hookObj[0]][hookObj[1]].apply(_self.libraries[hookObj[0]], args); } else { if (global.env === 'development') winston.info('[plugins] Expected method \'' + hookObj[1] + '\' in plugin \'' + hookObj[0] + '\' not found, skipping.'); } }); break; default: // Do nothing... break; } } else { // Otherwise, this hook contains no methods var returnVal = (Array.isArray(args) ? args[0] : args); if (callback) callback(null, returnVal); } }, isActive: function(id, callback) { RDB.sismember('plugins:active', id, callback); }, toggleActive: function(id, callback) { this.isActive(id, function(err, active) { if (err) { if (global.env === 'development') winston.info('[plugins] Could not toggle active state on plugin \'' + id + '\''); return; } RDB[(active ? 'srem' : 'sadd')]('plugins:active', id, function(err, success) { if (err) { if (global.env === 'development') winston.info('[plugins] Could not toggle active state on plugin \'' + id + '\''); return; } if (callback) { callback({ id: id, active: !active }); } }); }); }, showInstalled: function(callback) { // TODO: Also check /node_modules var _self = this; localPluginPath = path.join(__dirname, '../plugins'), npmPluginPath = path.join(__dirname, '../node_modules'); async.waterfall([ function(next) { async.parallel([ function(next) { fs.readdir(localPluginPath, next); }, function(next) { fs.readdir(npmPluginPath, next); } ], function(err, dirs) { if (err) return next(err); dirs[0] = dirs[0].map(function(file) { return path.join(localPluginPath, file); }).filter(function(file) { var stats = fs.statSync(file); if (stats.isDirectory()) return true; else return false; }); dirs[1] = dirs[1].map(function(file) { return path.join(npmPluginPath, file); }).filter(function(file) { var stats = fs.statSync(file); if (stats.isDirectory() && file.substr(npmPluginPath.length + 1, 14) === 'nodebb-plugin-') return true; else return false; }); next(err, dirs[0].concat(dirs[1])); }); }, function(files, next) { var plugins = []; async.each(files, function(file, next) { var configPath; async.waterfall([ function(next) { fs.readFile(path.join(file, 'plugin.json'), next); }, function(configJSON, next) { var config = JSON.parse(configJSON); _self.isActive(config.id, function(err, active) { if (err) next(new Error('no-active-state')); delete config.library; delete config.hooks; config.active = active; config.activeText = ' ' + (active ? 'Dea' : 'A') + 'ctivate'; next(null, config); }); } ], function(err, config) { if (err) return next(); // Silently fail plugins.push(config); next(); }); }, function(err) { next(null, plugins); }); } ], function(err, plugins) { callback(err, plugins); }); } } plugins.init(); module.exports = plugins;