Adding and Implementing a new widget view

These instructions will guide you to create a new view, assign it to a widget and then implement it on the front end of your site.

First, we need to add the new view to the system:

1. Open your AppManager, and navigate to the Central Site.
   
   
   
   
2. Management Apps > Widget Manager.
   
   
   
3. Find the widget in the list and click the pencil icon to the right. (Edit Widget Definition)
   
   
   
4. Scroll down to the "Widget Views" section and click the '+' button at the bottom of the view listing.
   
   
   
5. Fill in the Name of the view and click the 'View Picker' option on the right.
   
   
   
6. In the left column, find the widget that you are looking to add a view to and select the "Upload View" button.
   
   
   
7. Click the "Choose File" button and select the '.html' file on your local machine, then click "Upload".
   
   
   
8. Once the view is uploaded, select it from the View Picker modal.
   
9. Make sure to select "Save & Exit" when you are done applying your changes to the widget definition:
   

Next, we will add the view to the delivery site's "available views" list:  

You will need the Widget Instance Name from the Widget Properties screen on the front end.

1. Navigate to the AppManager in the Delivery Site you are looking to incorporate this view into.
   
   
   
2. Management Apps > Widget Manager.
   
   
   
3. Find the widget in the list and click the button with the "card" icon.
   
   
   
4. Find the widget instance name that matches the widget instance used on the front-end (this can be found on the widget properties page of the widget) and click the "pencil" icon to the right.
   
   In AppManager:
   
   
   Front-end:
   
   
   
5.  Scroll down to the "Widget Options" section and find the new view in the list. Check the "Display View" checkbox, and select "Save & Exit" at the top of the page.
   

Finally, we need to tell the widget to use the new view:

1. From the Akumina Debug panel, on the front end of your site, please select the "Refresh Cache" option.
   
   
   
2. On a page where you see the widget in question, expand the Voice Rail and click "Edit Mode" at the top.
   
   
   
3. Hover over the widget needing updating and click the "gear" icon.
   
   
   
4. Choose the new view from the "Select Layout" drop-down and select "Save Widget".
   
   
   
5. Note: If you are editing a Global Widget instance you will see the following prompt upon saving the widget changes. If you select "Yes" to saving the properties only for that page, it will become a page-specific widget instance. Selecting "No" will keep it as a global instance, and will apply your changes to all copies of where that widget instance is deployed.
   
   
   
6. Click the "Publish" icon in the top right corner of the screen.
   
   
   
7. When prompted if you want to leave edit mode, select "Yes".