Add content category for items in tag page (#337)

* - Added content category (principle/standard/pattern) to docs
- Added `displayContentCategory` to content document list macro - allows category to be displayed in collection view
- Displaying content category in tag page

* Added test to check document category is displayed in tag page and not principle/standard/pattern pages

_includes/layouts/tag.njk

@@ -24,7 +24,8 @@
     {{ documentList.contentDocumentList({
       headingLevel: 3 if paginationHeading else 2,
       classes: "app-document-list--large",
-      items: collections[tag] | orderPagesByTitle
+      items: collections[tag] | orderPagesByTitle,
+      displayContentCategory: true
     }) }}
 
     {{ appProseScope(content) if content }}

_includes/macros/contentDocumentList.njk

@@ -16,6 +16,11 @@
       {% endif %}
       {% if item.data.date or item.data.tags %}
       <ul class="app-document-list__item-metadata">
+        {% if params.displayContentCategory === true and item.data.category %}
+        <li class="app-document-list__attribute document-category">
+          {{ item.data.category }}
+        </li>
+        {% endif %}
         {% if item.data.id %}
         <li class="app-document-list__attribute">
           {{ item.data.id }}
@@ -35,4 +40,4 @@
   <p class="govuk-body">No documents found.</p>
 {% endif %}
 
-{% endmacro %}
+{% endmacro %}

cypress/e2e/spec.cy.js

@@ -139,3 +139,35 @@ describe('Pagination links', () => {
     cy.contains('h1', 'Principles')
   })
 })
+
+describe('Content category displays in correct listing pages', () => {
+  it('finds the content category in tag page', () => {
+    cy.visit(testing_params.TEST_ROOT_URL + '/tags/ways-of-working/')
+    cy.get('ol.app-document-list').find('.document-category')
+      .its('length').should('be.gte', 5)
+  })
+
+  it('does not find the content category in principles page', () => {
+    cy.visit(testing_params.TEST_ROOT_URL)
+    cy.contains('Read our principles').click()
+    // No .document-category listed in this page
+    cy.get('ol.app-document-list').find('.document-category')
+      .should('have.length', 0)
+  })
+
+  it('does not find the content category in standards page', () => {
+    cy.visit(testing_params.TEST_ROOT_URL)
+    cy.contains('Read our standards').click()
+    // No .document-category listed in this page
+    cy.get('ol.app-document-list').find('.document-category')
+      .should('have.length', 0)
+  })
+
+  it('does not find the content category in patterns page', () => {
+    cy.visit(testing_params.TEST_ROOT_URL)
+    cy.contains('Read our patterns').click()
+    // No .document-category listed in this page
+    cy.get('ol.app-document-list').find('.document-category')
+      .should('have.length', 0)
+  })
+})

docs/patterns/patterns.11tydata.js

@@ -1,5 +1,6 @@
 module.exports = {
   tags: [],
+  category: 'Pattern',
   eleventyComputed: {
     viewSource: data => `./docs${data.page.filePathStem}.md?plain=1`
   },

docs/principles/principles.11tydata.js

@@ -1,5 +1,6 @@
 module.exports = {
     tags: [],
+    category: 'Principle',
     eleventyComputed: {
         viewSource: data => `./docs${data.page.filePathStem}.md?plain=1`
     },

docs/standards/standards.11tydata.js

@@ -1,5 +1,6 @@
 module.exports = {
   tags: [],
+  category: 'Standard',
   eleventyComputed: {
     viewSource: data => `./docs${data.page.filePathStem}.md?plain=1`
   },