Merge pull request #119 from AdamBrodzinski/change-selector-opt

adds changeSelector method

README.md

@@ -182,6 +182,22 @@ TabularTables.People = new Tabular.Table({
 });
 ```
 
+
+## Modifying the selector
+
+If your table requires the selector to be modified before it's published, you can modify it with the `changeSelector` method. This can be useful for modifying what will be returned in a search.
+
+```js
+TabularTables.Posts = new Tabular.Table({
+  // other properties...
+  changeSelector: function(selector) {
+    // modify it here ...
+    return selector;
+  }
+});
+```
+
+
 ## Security
 
 You can optionally provide an `allow` and/or `allowFields` function to control which clients can get the published data. These are used by the built-in publications on the server only.

common.js

@@ -30,6 +30,7 @@ Tabular.Table = function (options) {
   self.onUnload = options.onUnload;
   self.allow = options.allow;
   self.allowFields = options.allowFields;
+  self.changeSelector = options.changeSelector;
 
   if (_.isArray(options.extraFields)) {
     var fields = {};

server/tabular.js

@@ -83,6 +83,11 @@ Meteor.publish("tabular_getInfo", function(tableName, selector, sort, skip, limi
 
   selector = selector || {};
 
+  // Allow the user to modify the selector before we use it
+  if (typeof table.changeSelector === 'function') {
+    selector = table.changeSelector(selector);
+  }
+
   // Apply the server side selector specified in the tabular
   // table constructor. Both must be met, so we join
   // them using $and, allowing both selectors to have