What Are Widgets?


Widgets are the building blocks of every Brilliant Directories website and contain the vast majority of the PHP, HTML, CSS, and Javascript code that is used to make a website work the way it does.  In order to edit the functionality of many areas of your website, you will likely customize a widget in the process.


Default Widgets


Default Widgets are located in a central database that is accessed "behind the scenes" by all Brilliant Directories websites.  Because these widgets are always maintained in a central database, they are always automatically up-to-date.


Default Widgets are maintained and updated often by our internal development team to insure the default functionality of every Brilliant Directories website is working as expected, to add new functionality, and to provide other important updates.  


If a website owner never customizes any of the Default Widgets, their website will always be automatically using the most up-to-date code.


All Default Widgets can be viewed by navigating to Toolbox » Widget Manager in the Admin area of a website:





Customized Widgets


If a Default Widget has been customized, it will appear in the "Customized Widgets" section of the Toolbox » Widget Manager page, above the Default Widgets:





How Can I Customize These Widgets?


If a website owner would like to customize one of the Default Widgets, they can do so by utilizing the search functionality highlighted down below:





OR


By locating these widgets on the Front End using the Admin Bar, as shown in this article: Locating The Widgets Via Admin Bar


Once the Default Widget has been found, it can be customized by clicking on the Customize button which is under "Actions":





Clicking on "Customize" will open up the content of the Default Widget so it can be edited:





Once the desired changes are complete, click on "Save Changes", which will save the customized version of this widget to your website.  The customized version of this widget will then be used on the website instead of the Default Widget.


Edit Widget Tabs


All the Widgets include 4 sections, the first 3 (HTML - CSS - Javascript) are meant to be used to edit the respective language depending on the tab you are on. 


The fourth section called Diff will highlight the difference in code between the default version of the widget vs your custom code:





Important Note: The "Diff" tab is only available for Customized Widgets.


Disabling / Enabling a Customized Widget


Disabling a custom widget will keep a copy of it on your website, but will prevent the system from using the widget on your live website.  This is useful if you do not want to permanently delete a widget, but do not want the widget to be active and used on your website.  This is also useful if you have a custom copy of a widget on your website and you want to make sure the Default version of the widget is used instead, without permanently deleting the widget.


To do this, click on Actions » Disable next to the custom widget:





A prompt will appear to confirm you would like to continue. Confirm that you would like to continue.





Once confirmed, the widget will be highlighted in red, and a "DISABLED" tag will be added to the widget:





To re-enable a widget, simply click on Actions » Enable next to the custom widget:





IMPORTANT: If there are two customized widgets present on a site that have the exact same name, the widget with the greater ID number will be used.  To prevent any kind of conflict which can cause confusion, we recommend re-naming or disabling the version of the widget you do not want to be used on the website.


Deleting a Customized Widgets


Deleting a custom widget will permanently remove it from a website.  This cannot be un-done, so please be sure you would like the widget to be removed completely before continuing.


Once a custom widget has been deleted, the Default Version of the widget can be customized again if you would like to make a new custom version of the widget based on the most recent content of the Default Widget.


To delete a widget, click on Actions » Delete next to the custom widget:





Creating a Brand New Widget


Creating a custom widget can come in handy if you do not necessarily want to customize our existing functionality but instead add completely new functionality that the software does not offer by default.


To create a new custom widget navigate to the top right corner of the widget manager and click on "New Widget":





Then give your widget a name and add your custom code in the respective tab depending on the code language your adding and click save:




After saving your new widget, the module will reload and take you to the main widget manager page.



Bulk Actions For Customized Widgets


To perform a bulk action on customized widgets, either select all the widgets:





Or select the widgets individually:





and select one of the bulk edit options (Delete Selected. Enable Selected, Disable Selected) and click "Save":