Merge pull request #163 from chrisrhymes/feature/customise-product-collections

Allow custom collection name for products

Author: chrisrhymes

_includes/cookie-banner.html

@@ -23,13 +23,13 @@
             {% if site.google_analytics %}
                 consentGrantedAdStorage();
             {% endif %}
-            Cookies.set('showCookieBanner', 'false', { expires: 7, path: '/' });
-            Cookies.set('cookiesAccepted', 'true', {expires: 7, path: '/'});
+            Cookies.set('showCookieBanner', 'false', { expires: 365, path: '/' });
+            Cookies.set('cookiesAccepted', 'true', {expires: 365, path: '/'});
             toggleCookieBanner();
         }
 
         function rejectCookies() {
-            Cookies.set('showCookieBanner', 'false', { expires: 7, path: '/' });
+            Cookies.set('showCookieBanner', 'false', { expires: 365, path: '/' });
             toggleCookieBanner();
         }
 

_layouts/product-category.html

@@ -7,7 +7,11 @@
         {{ page.content }}
     </div>
 
-    {% assign sorted_products = site.products | sort: page.sort %}
+    {% if page.collection %}
+        {% assign sorted_products = site.[page.collection] | sort: page.sort %}
+    {% else %}
+        {% assign sorted_products = site.products | sort: page.sort %}
+    {% endif %}
 
     {% for product in sorted_products %}
         <div class="column is-4-desktop is-6-tablet">

docs/products/category-page.md

@@ -21,4 +21,19 @@ show_sidebar: false
 sort: title
 ```
 
-[View example Category page](/bulma-clean-theme/products/)
+[View example Category page](/bulma-clean-theme/products/)
+
+## Customising the collection
+
+To use a different collection than `products`, set the collection name in the category page's front matter. 
+
+The below example uses a collection called `books`. 
+
+```yaml
+title: Books
+subtitle: Check out our range of books
+layout: product-category
+show_sidebar: false
+sort: title
+collection: books
+```

docs/products/product-pages.md

@@ -9,7 +9,11 @@ toc: true
 
 ## Products Directory
 
-Start by creating a `_products` directory to hold your product pages.
+The default collection name for products is `products`, so create a `_products` directory to hold your product pages.
+
+## Custom Collection Directory
+
+You can override the default and create a folder with your own collection name. For example, using a collection of `books` would require you to create a folder called `_books`.
 
 ## Product Pages
 
@@ -52,3 +56,7 @@ collections:
 ```
 
 You can also set default product page values here if you like, such as the layout or image. 
+
+{% include notification.html message="If you use a custom collection name then update `products` to your custom collection name. In the example above for the `_books` folder use `books` as the collection name." %}
+
+For more information on collections, please refer to the [Jekyll documentation](https://jekyllrb.com/docs/collections/).