== SUMMARY ==
The Recently Read module displays the history of recently read content (nodes)
a particular user has viewed. Each authenticated user has its own history
recorded, so this module may be useful i.e. for displaying recently viewed
products on the e-commerce site. The history is displayed as a block and each
content type gets its own block.
If you need more flexibility, this module can be replaced by properly configured
Flag, Rules and Views modules. Check out the following links for more details:
* http://drupal.org/node/405754
* http://jan.tomka.name/blog/list-recently-viewed-nodes-drupal
For a full description of the module, visit the project page:
http://drupal.org/sandbox/pgorecki/1080970
To submit bug reports and feature suggestions, or to track changes:
http://drupal.org/project/issues/1080970
== REQUIREMENTS ==
None.
== INSTALLATION ==
* Install as usual, see http://drupal.org/node/70151 for further information.
== CONFIGURATION ==
* Customize the module settings in Administer >> Site configuration >>
Recently read content. On this pace you can:
- Select which content types will should be tracked by the module
After enabling content type tracking, go to Administer >> Site building >>
Blocks to configure the block settings of each tracked content type.
- Recently read list length specifies the maximum number of nodes
per user per content type that will be stored in a databse. Note that this
is different from "Maximum number of links to display in the block" setting
available in the Recently read block configutation options.
== CUSTOMIZATION ==
Recently read module lacks UI for advanced configuration, but most tasks can
be easily implemented by code snippets or in the theme layer.
* Displaying more than a node title
By default, Recently Read block displays a list of links to node titles.
You can customize the output by overriding theme_recently_read_item() and
theme_recently_read_item_list() functions in your theme.
For example, to display an image field and a link:
function mytemplate_recently_read_item($item) {
$output = '';
if ($item['type'] == 'page') {
$node = node_load($item['nid']);
if (isset($node->field_image[0])) {
$output .= theme('imagefield_item', $node->field_image[0]);
}
}
$output .= l($item['title'], 'node/' . $item['nid']);
return $output;
}
* Multiple content types in the same block
To display multiple content types in the same block, create a new block with PHP body
and modify the following examlpe to your needs:
<?php
// disable page caching if this block is displayed
recently_read_disable_page_cache();
// get 3 recently read pages and articles items for current user
// (you can skip the last argument to display all items)
global $user;
user_is_logged_in() ? $user_id = $user->uid : 0;
$items = recently_read_get_read_items(array('page', 'article'), $user_id, 3);
// get html string with all items
return theme('recently_read_item_list', array('items' => $items));
?>
-- CONTACT --
Current maintainer:
* Przemyslaw Gorecki (pgorecki) - http://drupal.org/user/642012
