Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/11ty/eleventy-activity-feed
Create one centralized RSS feed for all of the content you create across the web (aggregates from Twitter, RSS, Atom, Mastodon, YouTube)
https://github.com/11ty/eleventy-activity-feed
Last synced: about 2 months ago
JSON representation
Create one centralized RSS feed for all of the content you create across the web (aggregates from Twitter, RSS, Atom, Mastodon, YouTube)
- Host: GitHub
- URL: https://github.com/11ty/eleventy-activity-feed
- Owner: 11ty
- Created: 2022-11-14T04:32:13.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2023-01-25T14:38:57.000Z (over 1 year ago)
- Last Synced: 2024-03-23T22:17:55.685Z (6 months ago)
- Language: JavaScript
- Size: 51.8 KB
- Stars: 94
- Watchers: 5
- Forks: 4
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# eleventy-activity-feed
Activity feed lets you build one centralized RSS feed that pulls in new entries from a bunch of different social networking sites. Support for (one or more) YouTube, RSS or Atom for existing blogs, Mastodon (via RSS), and your Twitter account (contributions for more are welcome!).
This allows you to encourage folks to subscribe in *one* location and you can control how that feed is populated later.
As a completely hypothetical example, if/when Twitter dies in a burning fire and you want to remove that channel from your centralized feed, you can do so and still keep all of your existing subscribers!
**Limitations:**
* This is not a permanent data store or archival tool for your content. This does _not_ (yet?) fetch old data beyond the initial page of results for each activity type’s API. This is merely a aggregation and rebroadcast tool for your new content in RSS.
**Caching Notes**:
* When used in a static build, this will only update the feed when your build runs. I’d recommend setting up a recurring build to generate your feed regularly (maybe daily?). You could use this in serverless mode if you wanted!
* If on Netlify, I would also recommend using the `netlify-plugin-cache` plugin to persist your API fetch call cache across builds. You can see an example of this on the [Eleventy Fetch docs](https://www.11ty.dev/docs/plugins/fetch/#running-this-on-your-build-server). You can control the maximum frequency at which new fetches are made to the APIs using `feed.setCacheDuration("4h");`
## Demo
You can subscribe to the following Eleventy feed in your RSS reader of choice to see it in action:
https://www.11ty.dev/follow/
## Installation
```
npm install @11ty/eleventy-activity-feed
```
Twitter User activity requires a `TWITTER_BEARER_TOKEN` environment variable (you can put this in a `.env` file).
### Sample Eleventy Template
* Use `follow-feed.11ty.cjs` in an ESM project (if `"type": "module"` in your `package.json`)
* Use `follow-feed.11ty.js` in a CommonJS project
```js
module.exports = class {
data() {
return {
// Controls where the file is written
permalink: "/follow.rss"
}
}
async render() {
const { ActivityFeed } = await import("@11ty/eleventy-activity-feed");
let feed = new ActivityFeed();
feed.setCacheDuration("4h");
// YouTube
feed.addSource("youtubeUser", "YouTube", "UCskGTioqrMBcw8pd14_334A");
// Blog
feed.addSource("atom", "Blog", "https://www.11ty.dev/blog/feed.xml");
// Mastodon
feed.addSource("rss", "Mastodon", "https://fosstodon.org/users/eleventy.rss");
// Twitter
feed.addSource("twitterUser", "Twitter", "eleven_ty", "949639269433380864");
return feed.toRssFeed({
title: "Eleventy’s Activity Feed",
language: "en",
url: "https://www.11ty.dev/follow/",
subtitle: "One centralized feed of Eleventy activity across the web.",
});
}
};
```
Add to the `` of your page to show it in RSS readers:
```html
```
## What’s Next?
Happy to accept PRs for better HTML display of different feed entries ([YouTube needs URL->`` linkified descriptions](https://github.com/11ty/eleventy-activity-feed/issues/2) and [Twitter could use @-username links on content](https://github.com/11ty/eleventy-activity-feed/issues/3)) and addition of more types of data! Feel free to contribute!
Check out the [issue tracker](https://github.com/11ty/eleventy-activity-feed/issues).