nova:subscribe

This optional package for Nova lets your users subscribe to the different domains (collections) of your application.

Dependencies & usage

Explicit dependency on nova:users to enable permissions.

If nova:posts is enabled, your users will be able to subscribe to:

new posts from users they follow (subscribed to)
new comments on a post they are subscribed to

If nova:categories is enabled, your users will be able to subscribe to new posts in a category.

Basic usage

This package gives you access to several methods of the type collection.subscribe & collection.unsubscribe. Default group of users can subscribe to any activated domain (see above) with the following methods (action) :

users.subscribe
users.unsubscribe
posts.subscribe
posts.unsubscribe
categories.subscribe
categories.unsubscribe

This package also provides a reusable component called SubscribeTo to subscribe to an document of collection.

This component takes two props, document & documentType. It can trigger any method described below:

1// for example, in PostItem.jsx
2<Telescope.components.SubscribeTo document={post} documentType={"posts"} />
3
4// for example, in UsersProfile.jsx
5<Telescope.components.SubscribeTo document={user} documentType={"users"} />
6
7// for example, in Category.jsx
8<Telescope.components.SubscribeTo document={category} documentType={"categories"} />

Extend to other collections than Users, Posts, Categories

This package export a function called subscribeMethodsGenerator that takes a collection as an argument and create the associated methods code :

1// in my custom package
2import subscribeMethodsGenerator from 'meteor/nova:subscribe';
3import Movies from './collection.js';
4
5// the function creates the code, then you have to associate it to the Meteor namespace:
6Meteor.methods(subscribeMethodsGenerator(Movies));

This will creates for you the methods movies.subscribe & movies.unsubscribe than can be used in the SubscribeTo component:

1// in my custom component
2<Telescope.components.SubscribeTo document={movie} documentType={"movies"} />

You'll also need to write the relevant callbacks, custom fields & permissions to run whenever a user is subscribed to your custom collection's item. See these files for inspiration. Note: it's more or less always the same thing

Reusable component to show a list of subscribed items

There was formerly a component that showed a list of subscribed posts. While reducing the depencies to other packages, it broke. It's on the roadmap to re-enable it. Feel free to discuss about it on the Slack channel if you want to build it!

Subscribe all the things

Original PR & discussion can be found here: https://github.com/TelescopeJS/Telescope/pull/1425