Plugin: Been There!

This plugin is the outcome of a thread started by Mark Bowen. He was looking for something that could show an entry as ‘viewed’. And that is exactly what this plugin does.

After a few additions and tweaks I was confident enough to release this to the public for all to enjoy.

You can grab a copy from GitHub: - Been There! (EE 1.6.x) - Been There! (EE 2.x)

In short, what this plugin does is mark an entry as viewed once a user has viewed the single entry page (provided that the template tag has been added there). This allows you to show a piece of content depending on if the user has viewed it before or not.

You can also use it in a list of entries to highlight entries the users hasn’t seen yet.

You can use Been There! in two different ways: 1. Specify content for both unviewed (no) and viewed (yes) entries. (Example 1) 2. Only specify content to show if the entry has been viewed by leaving out both the yes and no tag-pairs. (Example 2)

// Listing example. the set='no' parameter prevents the entry from being marked as viewed
{exp:weblog:entries weblog='news'}
  {exp:been_there entry_id='{entry_id}' set='no'}
    {yes}
      Boring...
    {/yes}
    {no}
      Oooh... Shiny!
    {/no}
  {/exp:been_there}
{/exp:weblog:entries}

If you don’t specify either of them it wil just return the entire tag data…

// Single entry page example.
// If no entry_id has been specified it will try to auto discover it by checking the last url segment.
// It will check for both entry_id's as well as utl_title's in the last segment
{exp:been_there}
  Boring...
{/exp:been_there}

Note: This add-on utilizes cookies for storage, so if a user has cookies disabled it won’t work properly –it won’t break, just not work as intended. Relying on this plugin for system critical features is therefore discouraged, but for so called “nice-to-haves” it’s perfect!

Have some fun with it!

Greetz, Wouter