You are here

Home » API reference » Views Merge Rows 8.2

README.txt in Views Merge Rows 8.2

Same filename and directory in other branches
  1. 8 README.txt
  2. 7 README.txt
CONTENTS OF THIS FILE
---------------------

 * Introduction
 * Requirements
 * Similar modules
 * Installation
 * Configuration
 * Maintainers


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

Sometimes when you use relationships in views you get a number of rows with the
same content in some of the fields. This results in a huge table (grid, list,
etc.) that affects the usability of your view.

The Views Merge Rows module provides a way to combine rows with the same content
in the specified fields.


REQUIREMENTS
------------

This module requires the following modules:
 * Views (Core)

Patches from the following issues are required:
 * https://www.drupal.org/project/drupal/issues/2824920
 * https://www.drupal.org/project/drupal/issues/2826755


SIMILAR MODULES
---------------

 * Views Aggregate Plus (https://www.drupal.org/project/views_aggregator):
   includes an Enumerate function. This builds a list of data from rows
   providing exactly the same sort of output as Views Merge Rows when rows are
   merged using the Group and compress function.
   This suffers from a similar pagination problem as Merge Rows, especially
   when a group crosses a paginated boundary.
 * Views Field View (https://www.drupal.org/project/views_field_view):
   allows you to include a subquery for each row in a table and insert the
   result in a field.
   The subquery is driven by tokens for the contextual filtering which allows
   you to create a list of related entities that match the row.
   This doesn't produce a comma delimited list without some styling
   manipulation, but is very flexible.
 * Views Distinct (https://www.drupal.org/project/views_distinct):
   D7 only.


INSTALLATION
------------

 * Install and enable this module like any other drupal 8 module.


CONFIGURATION
-------------

After installing the module you get the "Merge rows" item in the "Advanced"
section of the Views UI.

To configure the row merging click the "Settings" link next to the "Merge rows"
item.

In the configuration dialog you can enable/disable row merging with the
"Merge rows with the same content in the specified fields" checkbox.

You can specify the "Merge option" for each field.

The fields with "Merge option" set to "Use values of this field as a filter" are
used to check which rows should be merged. If several rows contain exactly the
same values in all of these fields, they are merged together. The values for
other fields are calculated as follows:
 * For fields with "Merge option" set to "Use the first value of this field"
   only the value from the first merged rows is used. The values in other rows
   are disregarded.
 * For fields with "Merge option" set to "Merge values of this field" all the
   values appears in the resulting row.


MAINTAINERS
-----------

Current maintainers:
 * Florent Torregrosa (Grimreaper) - https://www.drupal.org/user/2388214

Previous maintainers:
 * Dmitry Kulik (diolan) - https://www.drupal.org/user/2336786
 * Dominique Gagné (dgagne) - https://www.drupal.org/user/3504808

File

README.txt
View source 
  1. CONTENTS OF THIS FILE

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

  3. 

  4.  * Introduction

  5.  * Requirements

  6.  * Similar modules

  7.  * Installation

  8.  * Configuration

  9.  * Maintainers

  10. 

  11. 

  12. INTRODUCTION

  13. ------------

  14. 

  15. Sometimes when you use relationships in views you get a number of rows with the

  16. same content in some of the fields. This results in a huge table (grid, list,

  17. etc.) that affects the usability of your view.

  18. 

  19. The Views Merge Rows module provides a way to combine rows with the same content

  20. in the specified fields.

  21. 

  22. 

  23. REQUIREMENTS

  24. ------------

  25. 

  26. This module requires the following modules:

  27.  * Views (Core)

  28. 

  29. Patches from the following issues are required:

  30.  * https://www.drupal.org/project/drupal/issues/2824920

  31.  * https://www.drupal.org/project/drupal/issues/2826755

  32. 

  33. 

  34. SIMILAR MODULES

  35. ---------------

  36. 

  37.  * Views Aggregate Plus (https://www.drupal.org/project/views_aggregator):

  38.    includes an Enumerate function. This builds a list of data from rows

  39.    providing exactly the same sort of output as Views Merge Rows when rows are

  40.    merged using the Group and compress function.

  41.    This suffers from a similar pagination problem as Merge Rows, especially

  42.    when a group crosses a paginated boundary.

  43.  * Views Field View (https://www.drupal.org/project/views_field_view):

  44.    allows you to include a subquery for each row in a table and insert the

  45.    result in a field.

  46.    The subquery is driven by tokens for the contextual filtering which allows

  47.    you to create a list of related entities that match the row.

  48.    This doesn't produce a comma delimited list without some styling

  49.    manipulation, but is very flexible.

  50.  * Views Distinct (https://www.drupal.org/project/views_distinct):

  51.    D7 only.

  52. 

  53. 

  54. INSTALLATION

  55. ------------

  56. 

  57.  * Install and enable this module like any other drupal 8 module.

  58. 

  59. 

  60. CONFIGURATION

  61. -------------

  62. 

  63. After installing the module you get the "Merge rows" item in the "Advanced"

  64. section of the Views UI.

  65. 

  66. To configure the row merging click the "Settings" link next to the "Merge rows"

  67. item.

  68. 

  69. In the configuration dialog you can enable/disable row merging with the

  70. "Merge rows with the same content in the specified fields" checkbox.

  71. 

  72. You can specify the "Merge option" for each field.

  73. 

  74. The fields with "Merge option" set to "Use values of this field as a filter" are

  75. used to check which rows should be merged. If several rows contain exactly the

  76. same values in all of these fields, they are merged together. The values for

  77. other fields are calculated as follows:

  78.  * For fields with "Merge option" set to "Use the first value of this field"

  79.    only the value from the first merged rows is used. The values in other rows

  80.    are disregarded.

  81.  * For fields with "Merge option" set to "Merge values of this field" all the

  82.    values appears in the resulting row.

  83. 

  84. 

  85. MAINTAINERS

  86. -----------

  87. 

  88. Current maintainers:

  89.  * Florent Torregrosa (Grimreaper) - https://www.drupal.org/user/2388214

  90. 

  91. Previous maintainers:

  92.  * Dmitry Kulik (diolan) - https://www.drupal.org/user/2336786

  93.  * Dominique Gagné (dgagne) - https://www.drupal.org/user/3504808