Welcome Guest, you are in: Namespace

Site Activity Popup Notifications

RSS
Modified on 2011/12/11 10:57 by daveburke. Categorized as HowTo Guide, Sueetie AddonPack, Triple Scoop Products.
Description of the Sueetie AddonPack Site Activity Popup Notification feature.

Keeping In Touch Without Loading a Page

Site Activity Popup Notifications keep you in touch with what's going on in your community while you work without requiring you to reload the page or view your Site Activity List. Site Activity Notifications poll your site activity logs every minute and display a popup message with the new activity in your browser window.

Here's an example.

Image

A description of the activity along with the member's avatar and links to the new content is displayed in the popup so you can go immediately to where the action is.

Activities Displayed

The activity types displayed in the popup notifications are those which are defined for public display in Sueetie Administration. Also, only the activity of other community members are displayed. You won't see notifications of your own activity.

Popup Notification Options

UserLog Popup Notifications are configured on the Sueetie AddonPack Settings page as shown below. The options are to 1) Enable Popup Notifications, 2) Set Popups as sticky or temporary, 3) Activity check interval, and 4) Display Popups to Anonymous Users or to Registered Users only. In a future release we plan to support user-configurable Popup Notification Options as well.

Image

How it Works

Notifications are designed no differently than the Sueetie Tag Control and Calendar Control. UserLog Notifications consists of an ASPNET Control which is dropped onto a Master page. Like the Tag and Calendar Controls, it also has a supporting .JS file.

Here's a screenshot of the Notification ASPNET Control added to /themes/THEME/masters/Sueetie.Master.

Image

Sueetie Notifications use a customized version of the Gritter jQuery Plugin. That .JS is located in the site /scripts folder and is loaded in the child .master page's "cphHeader" ASP:Content area for non-application pages, or elsewhere based on the application. In BlogEngine.NET, for instance, it is loaded with all /blog/scripts in BlogBasePage.OnLoad(). Apart from adding gritter-min.js to your /blog/scripts folder you'll also want to make sure your gritter-min.js is located in your /wiki/JS folder. Otherwise the /scripts/gritter-min.js is used.

Here's the javascript file loaded in the Home.Master page.

Image

The v3.3 upgrade package will contain the .JS and .Master updates in the Lollipop theme to use as a guide. The popup's CSS classes are located in your theme's Shared.css stylesheet.

An additional word on styling, the ASPNET Control has a NotifyPopupCssClass property which you can use to modify the popup style. The default class name is "userlogNotifyPopup" which you'll see in use in your shared.css, or which you can modify and replace with NotifyPopupCssClass.

Notification Javascript Coexistence

Site Activity Popup Notifications depend on a javascript SetInterval() call in a PageLoad() function. If you have other javascript which performs various tasks in a PageLoad() function there could be a conflict. For that reason, the Notification javascript is rendered in two parts, a PageLoad() area and a plain block with additional functions.

The Notification Control has a property called "UsePageLoadSetInterval" which is set to true by default. If you have existing PageLoad() code in use, set "UsePageLoadSetInterval" to false and add the SetInterval() call to your page's PageLoad() script.

Here's an example of using the "UsePageLoadSetInterval" property in the Notification Control.

Image

Here's an example of adding the SetInterval Code in your existing PageLoad() script to avoid an execution conflicts.

Image

Product Keys and Feature Freedom

Sueetie Popup Notifications are included in the Sueetie Premium Edition. Sueetie Premium License Keys are available in the Sueetie Marketplace.

Top

ScrewTurn Wiki version 3.0.4.560.

Copyright © 2008-2012 Sueetie LLC. All rights reserved.
Sueetie