From 3db582559a827a83709ad66fd3b6389257462e96 Mon Sep 17 00:00:00 2001 From: Jagadedes Date: Mon, 24 Nov 2014 15:06:01 +0530 Subject: [PATCH] 31455 readme --- README.md | 46 +++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 43 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 41768f9..a792ecc 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,44 @@ -civicrm-wci -=========== -CiviCRM CMS independent extension for Widget Creation Interface (WCI). +Widget Creation Interface (WCI) Extension + +Overview + +This is a CiviCRM CMS independent extension for Widget Creation Interface (WCI). which will allow users to create widgets and associate progress bar to show status of the goal set. User can create embed code which can be used by other sites to embed the widget. + +Prerequisite + +- CMS. (Preferably Drupal Version 7.x) +- CiviCRM Version 4.7.x or above + +Features + +- Widget : Create, Edit and Delete +- Progress bar : Create, Edit and Delete +- Embed Code : Create, Edit and Delete +- Default Profile setting +- Setting + +Progress bar + +To draw a progress bar we need a starting amount, goal amount and current amount. Using 'Create Progress bar' (civicrm/wci/progress-bar/add) form user can set these information. Current amount for the progress bar is taken from the contributions done in the selected Civi Contribution page. User can select multiple source contribution pages and percentage of amount to take from those contribution pages for calculating current amount in the progress bar. By clicking save the information is saved to database and form gets forwarded to 'Manage Progress bar' page. There user can edit or delete already created progress bars. + +Widget + +A lot of widget properties can be set here. User can give colors, texts, image for the widget and its elements. There is provision to show either amount or percentage on top of the progress bar in the widget. Also can hide or show border, title, and progress bar caption. Advanced users can override default template by checking 'Override' check box. At that time they have to provide custom template code which should be based on smarty v2. + +Mailing list Groups can be added using Civi Group(civicrm/group/add?reset=1). To get that group in the CreateWidget form check 'Mailing List' check box only. + +By clicking Save and Preview button information will be saved to the database and a sample widget will be displayed on top of the form. To go to the Manage Widget page click 'Save' button. There user can edit, or delete existing widgets. + +Embed Code + +To use the widget in other web sites, user has to create embed code. This can be done in 'New Embed Code' (civicrm/wci/embed-code/add) form. Select a widget, give a title and save and preview, it will show the preview of the widget and embed code that can be used in other web sites. Click 'Save' to save and go to 'Manage Embed Code' page where user can edit or delete existing embed codes. + +Settings + +Mailing list subscription feature also exposed though widget. To use that first create a Profile. Then in that profile add field of type 'contact' as 'email'. Add one more field 'contact' as 'group'. Use 'Public Pages' for 'Visibility'. Note the profile id. Use this id in the Widget Settings(civicrm/wci/settings) for Default profile. + +For getting better performance WCI widget uses a cache system. A timeout value can be provided 'Widget cache timeout' field for saving the widget in database for that specified time. + Static widgets (widgets with out progress bar) will be caches permanently unless there is any change in the widget. + +CiviCRM-WCI development is sponsored by Zyxware Tehnologies, Kerala, India. -- 2.25.1