About home widgets

=======================



This folder contain the views for home page widgets. Each view script has the same filename as the widget name. 



Creating an home page widget is simple. Just follow this steps.



1) Give your widget a unique name. e.g. [your dev name][widget name], for example "mayorbrainstocks" 

	This is important, so your widget does not override existing widgets

2) Create the view and copy it into this folder (i.e. the "home" folder). See other view files in this folder for 

	guide on how to create your widget view.

3) Notify Precurio of your widget by updating the configuration file (precurio.ini). You do this in two steps.

	a) Add your widget to the [widget] section. that is, wgt_mayorbrainstocks = "1"

	b) Describe your widget, by creating its own section, for example

		[mayorbrainstocks]

		mayorbrainstocks.title = "BloomBerg Stock Portfolio"

		mayorbrainstocks.short_title = "BloomBerg Stocks"

		mayorbrainstocks.description = "Display live stock data of obligors in our portfolio"

		mayorbrainstocks.position = "side"

		mayorbrainstocks.order = "1"

		mayorbrainstocks.is_standalone = "0"

		mayorbrainstocks.is_widget = "1"

4) Now your widget is active, and users will have the option of enabling it. But if you want to force this on all users,

	simply follow this steps;

	a) Using your favorite mysql client, Open the precurio database

	b) empty the table "users_settings"

	c) Once the table is empty, all users will see the new widget when they visit the home page. 