Custom item ordering and categorizing for the widget

[karthikb351]

Implements #166.

• Customize the titles of rendered categories
• Enforce ordering of items

Available via a new config categories

window.Boxoffice.init({
        org: 'hasgeek', // Organisation to show
        itemCollection: 'd386dbcf-1a32-11e7-b315-5d5ee7239cc7', // ItemCollection ID to show
        paymentDesc: 'HasGeek', // Description for payments widget
        categories: [
                    {
                        'name': 'conference',
                        'title': 'Standard',
                        'item_ids': ['68e27823-1a33-11e7-842a-85544f6e9ad9']
                    },
                    {
                        'name': 'premium',
                        'title': 'Premium',
                        'item_ids': ['63d94e70-1b3a-11e7-85fb-737e61409825','19e47ba8-1e8e-11e7-8f39-45cbac6935ba']
                    }
                ]
        ]
      });

An Item's name is unique in an item collection, and is human readable so I chose that over id

---

Examples

With categories

window.Boxoffice.init({
        org: 'hasgeek', // Organisation to show
        itemCollection: 'd386dbcf-1a32-11e7-b315-5d5ee7239cc7', // ItemCollection ID to show
        paymentDesc: 'HasGeek', // Description for payments widget
        categories: [
                    {
                        'name': 'conference',
                        'title': 'Standard',
                        'item_ids': ['68e27823-1a33-11e7-842a-85544f6e9ad9']
                    },
                    {
                        'name': 'premium',
                        'title': 'Premium',
                        'item_ids': ['63d94e70-1b3a-11e7-85fb-737e61409825','19e47ba8-1e8e-11e7-8f39-45cbac6935ba']
                    }
                ]
      });

With duplicates and ordering

window.Boxoffice.init({
        org: 'hasgeek', // Organisation to show
        itemCollection: 'd386dbcf-1a32-11e7-b315-5d5ee7239cc7', // ItemCollection ID to show
        paymentDesc: 'HasGeek', // Description for payments widget
        categories: [
                    {
                        'name': 'conference',
                        'title': 'Standard',
                        'item_ids': ['68e27823-1a33-11e7-842a-85544f6e9ad9']
                    },
                    {
                        'name': 'premium',
                        'title': 'Premium',
                        'item_ids': ['63d94e70-1b3a-11e7-85fb-737e61409825','19e47ba8-1e8e-11e7-8f39-45cbac6935ba']
                    }
                ]
      });

Without any value, defaults to server defined categories

window.Boxoffice.init({
        org: 'hasgeek', // Organisation to show
        itemCollection: 'd386dbcf-1a32-11e7-b315-5d5ee7239cc7', // ItemCollection ID to show
        paymentDesc: 'HasGeek' // Description for payments widget
            }
        ]
      });

[vidya-ram]

Wouldn't it better to do the filtering of items on the server side.

[vidya-ram]

Here customising category on the client side involves overriding the existing categories and also classification of items. Wouldn't this lead to confusion.

[shreyas-satish]

This line can just be widgetConfig.categories.length > 0.

[karthikb351]

@shreyas-satish Works with ids instead of names - I've updated the example here to reflect that. Good to merge?