Manage Preferences

Each Activity Feed item is broken down into small, manageable pieces to make it as flexible as possible for your needs.  At the top of each column is an example feed item (about Joe User), with an example phrase expected in that column underlined.

When a new Weblog Entry is posted, you probably want to write something like the following:

Joe User commented on the blog post ‘Blog Post’ in the blog ‘Weblog’

In the Action, Parent Reference, and Grandparent Reference columns, you would therefore want: ‘commented’, ‘on the blog post’, and ‘in the blog’.

And in your template you would put something like:

{actor_screen_name} {action} {parent_reference} {parent_title} {grandparent_reference} {grandparent_title}

Fields

The Preferences page is divided up into 3 columns for each type of activity.  The text you put into each column is accessible in your templates through the variables listed under each item below.  All preference fields are optional, and some do not require a parent or grandparent reference (which is why the default installation has some blank).

Action

Accessible in template via: {action}

This refers to the action word describing what the user did.  Examples are “commented”, “posted”, “joined”, etc.

Parent Reference

Accessible in template via: {parent_reference}

This refers to the bridge between the action phrase and what they posted / did.  Examples are “on the blog post”, “to the blog”, “in the group”, etc.

Grandparent Reference

Accessible in template via: {grandparent_reference}

In some cases, there is a third level of detail we want.  For example, if Joe User commented on a blog post in a specific blog, the reference to the specific blog would be your grandparent reference.  Examples are “on the blog”, “in the group”, “in the forum”, etc.