Now with server-side template rendering! Adds a Twitter feed widget to Apostrophe's rich content editor

Usage no npm install needed!

<script type="module">
  import apostropheTwitter2 from 'https://cdn.skypack.dev/apostrophe-twitter-2';


Deprecated for new sites

This module was for A2 0.5.x. For new projects, use the apostrophe-twitter-widgets module.


apostrophe-twitter is a widget for the Apostrophe content management system. apostrophe-twitter lets you add a Twitter feed to any content area created with Apostrophe. apostrophe-twitter is also intended as a demonstration of how to add custom widgets to Apostrophe and enable their use in your project. See apostrophe-sandbox for a project that demonstrates how to use apostrophe-twitter.


Due to Twitter's API access policies, you must register a Twitter "app" to use this module. The consumerKey and consumerSecret, accessToken and accessTokenSecret options must be set when initializing the module. After registering your app on dev.twitter.com, click "create my access token." Then refresh the page as Twitter usually fails to display the token on the first try. nodemon## Setup

If you are using apostrophe-site (and you should be), adding this module is as simple as:

npm install apostrophe-twitter-2

And in your app.js file:

modules: {
  ... other modules ...
  'apostrophe-twitter-2': {
    consumerKey: 'get',
    consumerSecret: 'your',
    accessToken: 'own',
    accessTokenSecret: 'credentials'
  ... yet more modules ...

Now it will be included in the default set of controls. If you are setting the controls option on your areas, the widget's name is twitter.

To insert it as a singleton, you might write:

{{ aposSingleton(page, 'twitter', 'twitter', { limit: 3 }) }}

If you want the same feed to appear on many pages, you might use the global virtual page:

{{ aposSingleton(global, 'twitter', 'twitter', { limit: 3 }) }}



The limit option controls the number of tweets to be displayed, at most. The limit option defaults to 5.


Once the tweets have been fully loaded into the template, an event called 'aposTwitterReady' fires. If you are manipulating the tweets on the front-end, you will want to listen for aposTwitterReady, rather than other DOM events. If you don't, the tweets may take a few seconds to load and your wonderful functions will fire before the tweets are accessible. You can then target the twitter widget with a simple declaration.For example:

  $('body').on('aposTwitterReady', '.apos-widget', function() {
    $widget = $(this);


If no tweets could be found, an event called 'aposTwitterNull' fires. If you want something special to happen if there are no tweets available, this is your event.

  $('body').on('aposTwitterNull', '.apos-widget', function() {
    $widget = $(this);