93 lines
3.1 KiB
Text
93 lines
3.1 KiB
Text
|
|
== 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
|