NOTIFICATION, 1.3
=================
This dynamic action plug-in provides an unobtrusive notification popup.  You provide
a title and text and can include an image that will display to the left of the text.
You can also determine whether to make the notification 'sticky', meaning the user will
need to manually dismiss, or to have it hide after a prescribed amount of time (even
with this option, the user can dismiss it early).


TABLE OF CONTENTS
=================

* Installation
* Advanced Installation
* How to use
* Uninstall
* Credits, License and Terms of Use
* Support
* Change Log


INSTALLATION
============
1. Ensure you are running Oracle APEX version 4.0 or higher
2. Unzip and extract all files
2. Access your target Workspace
3. Select the Application Builder
4. Select the Application where you wish to import the plug-in 
   (plug-ins belong to an application, not a workspace)
5. Access Shared Components > Plug-Ins
6. Click [Import >]
7. Browse and locate the installer file, dynamic_action_plugin_com_oracle_apex_gritter_notification.sql
8. Complete the wizard

If the plug-in already exists in that application, you will need to confirm that you 
want to replace it.  Also, once imported, this plug-in can be installed into additional
applications within the same workspace.  Simply navigate to the Export Repository 
(Export > Export Repository), click Install, and then select the target application.
Once the install file is no longer needed, it can be removed from the Export Repository.


ADVANCED INSTALLATION
=====================
1. Follow the steps in INSTALLATION
2. Copy the files of the directory "server" to the /images/plugins/notification_v1_3
   or any other directory on the web server
3. Set the "File Prefix" attribute of the plug-in to #IMAGE_PREFIX#plugins/notification_v1_3/

This will provide better performance, because the static files will be served by the web server
instead of reading them each time from the database.


HOW TO USE
==========
1. Install the plug-in (see INSTALLATION)
2. Create a new dynamic action
3. Use the "Advanced Wizard"
4. Select the plug-in "Notification" as action
5. Follow the wizard and use Item Level Help to get more information about the
   purpose and usage of the different settings.

Note that you can also update existing dynamic actions to use this new item-type, 
once installed.


UNINSTALL
=========
To completely remove the plug-in:

1. Access the plug-in under Shared Components > Plug-Ins
2. Click [Delete]
   Note: If the [Delete] button doesn't show that indicates the plug-in is in use within the
         application.  Click on 'Utilization' under 'Tasks' to see where it is used.


CREDITS, LICENSE AND TERMS OF USE
=================================
Copyright 2010, Oracle. All rights reserved.

This dynamic action plug-in is based on the
jQuery plug-in Gritter v1.6 http://github.com/jboesch/Gritter

It's dual licensed under the MIT and GPL licenses:

  * http://www.opensource.org/licenses/mit-license.php
  * http://www.gnu.org/licenses/gpl.html

Terms of use: http://apex.oracle.com/plugins#TERMS


SUPPORT
=======
This plug-in is not part of Oracle Application Express software and is therefore not supported by Oracle Support.
Any issues with it can be discussed on the Application Express Forum at http://forums.oracle.com/forums/forum.jspa?forumID=137


CHANGE LOG
==========
v1.3 (24-Nov-2011)
-) Fixed issue with CSS files that caused underlying Application Express session to be invalidated.

v1.2 (29-Sep-2010)
-) Notification plug-in didn't work if a different jQuery version was loaded on the page where the plug-in was used
-) Renamed jquery.gritter.min.js and jquery.gritter.js to apex.jquery.gritter.min.js and apex.jquery.gritter.js

v1.1 (10-Sep-2010)
-) Fixed server\apex.jquery.gritter.css because it contained an incorrect path for the images

v1.0 (23-Jun-2010)
-) initial release
