You are here

Home » API reference » Views exclude previous 8

README.txt in Views exclude previous 8 

CONTENTS OF THIS FILE
---------------------

 * Introduction
 * Example
 * Compatibility

INTRODUCTION
------------

The Views exclude previous module provides a views filter that excludes nodes
that have already been loaded/displayed on the current page.

This is very useful when you have pages with several embedded views,
and you want to make sure that a given node only appears once in the page.

The advantage of using Views exclude previous rather than manually
excluding nodes is that:

- Each view does not need to know which context it will be displayed in
- Each view can be displayed in a different context
(different page, different order) without needing to change the filter
- Only the nodes that are actually displayed are taken into consideration
  - not those that would fall beyond the first page of the pager

Example
-------

Say you have a view A which displays the 5 most recent nodes
tagged with 'Carrot' ;
and a view B which displays the 5 most recent nodes tagged with 'Freedom'.
Both views are displayed on the same page (A before B) ;
and both have the Views Exclude Previous filter.
Then, given a node N tagged with both 'Carrot' and 'Freedom' :

- If node N is in the 5 most recent entries of both A and B, then it will
  be displayed for A only
- If node N is in the 5 most recent entries of B, but not in the five most
  recent entries of A then it will be displayed for B

Compatibility
-------------

There is no reliable way within Drupal to know when a node has been displayed.
Views exclude previous does it's best by hooking into various relevant parts
of the system.

At the time of writting, Views exclude previous will be able to track nodes
that have been displayed using:

The Views module, with the 'Row style' set to 'Node'
The Views module, with the 'Row style' set to 'Field'
and using the default 'Unformatted', 'List', 'Grid' or 'Table' styles.
It will also track nodes that are loaded/prepared for viewing using the nodeapi.
If you know of any module that embeds nodes/lists/etc in pages,
please report whether they work/don't work with Views exclude
previous so that the compatibility list can be kept up to date.

File

README.txt
View source 
  1. CONTENTS OF THIS FILE

  2. ---------------------

  3. 

  4.  * Introduction

  5.  * Example

  6.  * Compatibility

  7. 

  8. INTRODUCTION

  9. ------------

  10. 

  11. The Views exclude previous module provides a views filter that excludes nodes

  12. that have already been loaded/displayed on the current page.

  13. 

  14. This is very useful when you have pages with several embedded views,

  15. and you want to make sure that a given node only appears once in the page.

  16. 

  17. The advantage of using Views exclude previous rather than manually

  18. excluding nodes is that:

  19. 

  20. - Each view does not need to know which context it will be displayed in

  21. - Each view can be displayed in a different context

  22. (different page, different order) without needing to change the filter

  23. - Only the nodes that are actually displayed are taken into consideration

  24.   - not those that would fall beyond the first page of the pager

  25. 

  26. Example

  27. -------

  28. 

  29. Say you have a view A which displays the 5 most recent nodes

  30. tagged with 'Carrot' ;

  31. and a view B which displays the 5 most recent nodes tagged with 'Freedom'.

  32. Both views are displayed on the same page (A before B) ;

  33. and both have the Views Exclude Previous filter.

  34. Then, given a node N tagged with both 'Carrot' and 'Freedom' :

  35. 

  36. - If node N is in the 5 most recent entries of both A and B, then it will

  37.   be displayed for A only

  38. - If node N is in the 5 most recent entries of B, but not in the five most

  39.   recent entries of A then it will be displayed for B

  40. 

  41. Compatibility

  42. -------------

  43. 

  44. There is no reliable way within Drupal to know when a node has been displayed.

  45. Views exclude previous does it's best by hooking into various relevant parts

  46. of the system.

  47. 

  48. At the time of writting, Views exclude previous will be able to track nodes

  49. that have been displayed using:

  50. 

  51. The Views module, with the 'Row style' set to 'Node'

  52. The Views module, with the 'Row style' set to 'Field'

  53. and using the default 'Unformatted', 'List', 'Grid' or 'Table' styles.

  54. It will also track nodes that are loaded/prepared for viewing using the nodeapi.

  55. If you know of any module that embeds nodes/lists/etc in pages,

  56. please report whether they work/don't work with Views exclude

  57. previous so that the compatibility list can be kept up to date.