Heartbeat activity in drupal7 by default with views and display suite enabled


Heartbeat displays user activity on a website. This module is an API to log activity. The logged data contains message structures, attributes and variables. Once the activity messages exist in the database, they will be parsed and build into activity streams.


Each module can log their own activity streams. This could be done by calling the api functions or by rules. This implicates that other modules, using the rules ui, can be interesting for Heartbeat if activity events and triggers are defined. Great modules that handle user relations like organic groups and friendlist describe rule events.


Heartbeat has global configuration for display, message template configuration and stream configuration. Each stream (or access type) is a class based on HeartbeatAccess. It is basically a query builder (more gracefully in Drupal 7 branch thx to excellent database design) that returns its results to a parser.
The activity messages can be restricted on several levels which means that there are lots of access checks. Because sometimes this debugging is rather hard, heartbeat can now run in debug-mode. This way it's real easy to see why a message is blocked when viewing a stream.
Each message can have a number of attachments. E.g.: commenting, flags.

As community module, heartbeat integrates with flag_friend, friendlist and User relationships. The connected heartbeat is a built-in stream, available when enabling the friendlist_activity module. Make sure to select the friends API in the global settings.


  • Heartbeat logs activity for nodes, comments, users/profiles and organic group activity
  • Integration module for flags, so each activity stream item can have a number of flags as message attachment.
  • heartbeat comments submodule to comment on a message. Message templates can be set to use node-comments when in node context.
  • shout submodule to shout a message like twitter or facebook's "What are you doing", and to allow commenting
  • Heartbeat Display suite implementation to make the theming controllable by UI only. Build modes can be set per message type or overriden per stream.
  • View integration although heartbeat is in fact a display module. The grouping and "max number" does not work properly. I strongly recommend using the heartbeat blocks and pages. Pages can be found at http://yoursite/heartbeat/[stream-name] .
  • Drupal7 only Basic Node.js integration on streams.

Other modules that work great with heartbeat activity


Enable the debug mode setting when you want to know in detail why certain fetched messages aren't shown.


This project will be deprecated. The future would be in the module Message. It's much smaller and it cannot be compared to heartbeat when it comes to features. However the possibilities as API would be the same.
My guess and hopes are to have a couple of contribs extending on the message module that add certain community behavior.

In the meantime, I am dying to get someone help me on this module or even take it over.
Also as a result of the fact that there is nobody to help me commit patches, this module will be look abandoned. So please send a mail to stalski if you want to help this project and it's users.



Micro activity is an implementation of heartbeat that shows personal micro activities when hovering certain user-links.


Follow what's coming.


As of drupal7, heartbeat is dependent on Ctools. There are submodules that are dependent on others too, like rules, token, ...


This module is sponsored by Menhir. You can follow me on Twitter for quick release and documentation updates. My daily work is located at Wunderkraut Belgium


This module is currently co-maintained by Venkat Raman working in Capgemini Bangalore, India.
You can follow Venkat on Twitter

Related projects


Project Information