mojoPortal.Web.Controls

Author: Joe Audette Created: 2007-08-15 Last Modified: 2007-08-15 Licensed under the terms of the GNU Lesser General Public License: http://www.opensource.org/licenses/lgpl-license.php You must not remove this notice, or any other, from this software.

Author: Joe Audette Created: 2007-08-15 Last Modified: 2007-08-15 The use and distribution terms for this software are covered by the Common Public License 1.0 (http://opensource.org/licenses/cpl.php) which can be found in the file CPL.TXT at the root of this distribution. By using this software in any fashion, you are agreeing to be bound by the terms of this license. You must not remove this notice, or any other, from this software.

Author: Joe Audette Created: 2007-08-16 Last Modified: 2007-08-16 The use and distribution terms for this software are covered by the Common Public License 1.0 (http://opensource.org/licenses/cpl.php) which can be found in the file CPL.TXT at the root of this distribution. By using this software in any fashion, you are agreeing to be bound by the terms of this license. You must not remove this notice, or any other, from this software.

Author: Joe Audette Created: 2007-08-17 Last Modified: 2007-08-17 Licensed under the terms of the GNU Lesser General Public License: http://www.opensource.org/licenses/lgpl-license.php You must not remove this notice, or any other, from this software.

deprecated not used internally properties remain only for backward compat with custom modules

Author: Joe Audette Created: 2006-07-30 Last Modified: 2007-08-30 The use and distribution terms for this software are covered by the Common Public License 1.0 (http://opensource.org/licenses/cpl.php) which can be found in the file CPL.TXT at the root of this distribution. By using this software in any fashion, you are agreeing to be bound by the terms of this license. You must not remove this notice, or any other, from this software.

If DoRounding is true renders botom elements for Corner Rounding Based on Nifty Corners: rounded corners without images By Alessandro Fulciniti http://www.html.it/articoli/nifty/index.html Tip: this property can be set in theme.skin file for a skin to turn rounded corners on or off. The rounding is actually done by css, this control only adds markup (extra unsemantic divs) that the css is applied to for the rounding effect. Example css .rtop, .rbottom{display: block;} .rtop, .rbottom{background: #414141;} .rtop .r1, .rtop .r2, .rtop .r3, .rtop .r4, .rbottom .r1, .rbottom .r2, .rbottom .r3, .rbottom .r4{background: #545454;} .rtop .r1, .rtop .r2, .rtop .r3, .rtop .r4, .rbottom .r1, .rbottom .r2, .rbottom .r3, .rbottom .r4 { display: block;height: 1px;overflow: hidden; } .r1{margin: 0 5px} .r2{margin: 0 3px} .r3{margin: 0 2px} .rtop .r4, .rbottom .r4{ margin: 0 1px; height: 2px } .rbottom { margin-bottom:10px; }

If DoRounding is true renders top elements for Corner Rounding Based on Nifty Corners: rounded corners without images By Alessandro Fulciniti http://www.html.it/articoli/nifty/index.html Tip: this property can be set in theme.skin file for a skin to turn rounded corners on or off. The rounding is actually done by css, this control only adds markup (extra unsemantic divs) that the css is applied to for the rounding effect. Example css .rtop, .rbottom{display: block;} .rtop, .rbottom{background: #414141;} .rtop .r1, .rtop .r2, .rtop .r3, .rtop .r4, .rbottom .r1, .rbottom .r2, .rbottom .r3, .rbottom .r4{background: #545454;} .rtop .r1, .rtop .r2, .rtop .r3, .rtop .r4, .rbottom .r1, .rbottom .r2, .rbottom .r3, .rbottom .r4 { display: block;height: 1px;overflow: hidden; } .r1{margin: 0 5px} .r2{margin: 0 3px} .r3{margin: 0 2px} .rtop .r4, .rbottom .r4{ margin: 0 1px; height: 2px } .rbottom { margin-bottom:10px; }

if true an html 5 nav element is wrapped arround the pager

Code sample by Mike Ellison from article http://www.codeproject.com/aspnet/MellDataCalendar.asp subclass of the ASP.NET Calendar control for displaying events from a DataTable with support for templates Mike has given permission to use this as we will with no conditions though he does appreciate any reference to him in the credits or code Last Modified: 2008-01-28 Joe Audette

Based on an article by Mike Ellison http://www.codeproject.com/aspnet/MellDataCalendar.asp allowing for databinding syntax like the following to be used in the .aspx page: Last Modified: 4/10/2005 Joe Audette

Author: Joe Audette Created: 2007-11-07 Last Modified: 2007-11-07 Licensed under the terms of the GNU Lesser General Public License: http://www.opensource.org/licenses/lgpl-license.php You must not remove this notice, or any other, from this software.

Represents a calendar day. [To be supplied.] Gets the date represented by an instance of this class. This property is read-only. Gets the string equivilent of the date represented by an instance of this class. This property is read-only. Gets a value indicating whether the date represented by an instance of this class is in a different month from the month currently being displayed. This property is read-only. Gets a value indicating whether the date represented by an instance of this class is today's date. This property is read-only. Gets a value indicating whether the date represented by an instance of this class is on a weekend day. This property is read-only.

A Calendar control that can be databound to a data source to show events

The name of the field in the dataset that will represent the datetime

The template for the databound items

Added 2007/04/26 Adapted from Code Project Article http://www.codeproject.com/aspnet/swfobject_server_control.asp Last Modified: 2007/05/01

Based on a custom GridView by Matt Berseth: http://mattberseth.com/blog/2007/07/how_to_show_header_and_footer.html It allows header and footer to be shown even the there is no data in the GridView.

The photo album handler. This class can act as an HttpHandler or as a Control. IHttpHandler,

The background color of the image thumbnails and previews.

The color used to draw borders around image thumbnails and previews.

The tooltip for going back to the folder view from the image preview.

The text of the back to parent link.

Tooltip for going back to the parent folder.

The top CSS class for the control.

The CSS class for the details (meta-data) link in the preview pages.

The text for the details (meta-data) link in the preview pages.

The tooltip for displaying the preview page.

Tooltip for seeing the image at full resolution.

The template for the folder mode.

The CSS class for a thumbnail.

CSS class for metadata field names.

CSS class for metadata section heads.

CSS class for metadata values.

Tooltip for the link to the next image.

Format string for the open folder tooltip.

Template for the control in image preview mode.

A permanent link to the current page with the Album in its current state.

The tooltip for the link to the previous image.

The path of the current file.

The URL of the handler.

The info for the current image.

The list of image infos for the current folder.

True if the class is used in Control mode (as opposed to handler mode).

Defines how the Album navigation links work.

Info for the next image.

Information for the parent folder.

The current virtual path.

The fixed part of the path.

The information for the previous image.

The subfolders of the current folder.

The title for the current Album view.

The description for the current Album view.

added by Joe Audette 2008-05-02

Ensures that the next and previous image infos have been computed.

Directs to the right rendering methos according to the mode.

The writer to write to.

Does the actual rendering for the folder mode.

The writer to write to. The virtual path to the folder. The physical for the folder.

Gets an array of file infos for the images in a folder, sorted by date.

The folder's physical path. The list of file infos, sorted by date.

Gets an array of file infos for the images in a folder, sorted by date.

The folder's physical path. True if subfolders should be included. The list of file infos, sorted by date.

Gets the top n images in a folder, sorted by date descending.

Maximum number of images to return. True if subfolders should be included. The image infos.

Renders an image preview page.

The writer to render to. The virtual path of the directory. The physical path of the directory. The name of the image.

Sends a 500 error to the client.

The error message.

Parses the parameters from the querystring.

Parses the parameters.

The parameter collection to parse from.

Describes an album folder.

Constructs an AlbumFolderInfo.

The Album that owns this info. The virtual path of the folder. True if the folder decribes the parent of the current Album view.

Constructs an AlbumFolderInfo.

The Album that owns this info. The virtual path of the folder.

The icon URL for the folder.

True if the folder is the parent of the current view.

The name of this folder.

The display modes or views for the Album Handler.

Unknown mode.

Displays the contents of a folder.

Displays the preview page for an image.

Returns the reduced image used in the preview page.

Returns an image thumbnail.

Returns a folder thumbnail.

Returns a parent folder thumbnail.

Returns the CSS stylesheet.

Navigation mode when the album is used as a control.

The default, this mode uses callbacks to refresh the album without navigating away from the page or posting back. Ifthe browser does not support callbacks, the control will post back.

This mode uses form post backs to navigate in the album.

Uses regular links to navigate in the album. May have side-effects on the rest of the page, which may have its own state management.

Base for classes that describe an album page

Constructs an AlbumPageInfo.

The Album that owns this info. The virtual path of the page.

The Album that owns this page.

The virtual path to the page.

The character used as a command for this type of album page

The AlbumHandlerMode for this type of pages

A javascript link (callback if the browser supports it, postback otherwise) to this album page.

A permanent link to this image's preview page.

A template container for the album handler.

Constructs a template container for an Album.

The Album that owns this template.

The DataItem is the owner Album.

The templates are single items, so the index is always zero.

Storing location for the cached preview and thumbnail images.

Cached images are stored on disk in the application's compilation folder.

Images are cached in memory.

No caching. Images are redrawn on every request.

Size in pixels of the thumbnails.

Size in pixels of the preview images.

The background color of the image thumbnails and previews.

The color used to draw borders around image thumbnails and previews.

The width in pixels of the thumbnail border.

The width in pixels of the image previews.

The color of the shadow that's drawn around up folder stacked image thumbnails.

The width in pixels of the shadow that's drawn around up folder stacked image thumbnails.

The color of the arrow that's drawn on up folder thumbnails.

The relative size of the arrow that's drawn on up folder thumbnails.

The number of images on the up folder thumbnail stack.

The quality (between 0 and 100) of the thumbnail JPEGs.

Location of the cache. Can be Disk (recommended), Memory or None.

If using memory cache, the duration in minutes of the sliding expiration.

The default CSS that's requested by the header.

Static constructor that sets up the caching directory

Gets the path for a cached image and its status.

The path to the image. Type of image. The physical path of the cached image (out parameter). True if the cached image exists and is not outdated.

Sends the default CSS to the response.

The response where to write the CSS.

Outputs a resized image to the HttpResponse object

Outputs a folder thumbnail to the HttpResponse.

Prepares a string to be used in JScript by escaping characters.

This is not a general purpose escaping function: we do not encode characters that can't be in Windows paths. It should not be used in general to prevent injection attacks. The unencoded string. The encoded string.

Creates a Bitmap object from a file.

The path ofthe image. The bitmap object.

Creates a reduced Bitmap from a full-size Bitmap.

Creates the thumbnail Bitmap for a folder.

Gets the JPEG codec.

The JPEG codec.

Returns the encoder parameters.

Writes an image on the response.

The Bitmap to write. The HttpResponse to write to.

Writes an image to the response.

The path of the file. The HttpResponse to write to.

Writes a byte array to the response.

The bytes to write The HttpResponse to write to.

Gets an array of bytes from a Bitmap.

The Bitmap. The byte array.

Describes an Album image.

Constructs an ImageInfo.

The Album that owns this image. The virtual path of the image. The physical path of the image.

The image caption. It is the name if available from the ITPC meta-data, or the file name.

The date the image was created.

The URL of the thumbnail for this image.

The metadata for this image.

The URL of the preview image for this image.

The virtual path of the full resolution image.

Extracts and caches the metadata for an image.

The FileInfo to the image. The MetaData for the image.

Gets and caches the most relevant date available for an image. It looks first at the EXIF date, then at the creation date from ITPC data, and then at the file's creation date if everything else failed.

The FileInfo for the image. The date.

Author: Joe Audette Created: 2008-08-12 Last Modified: 2008-08-12 The use and distribution terms for this software are covered by the Common Public License 1.0 (http://opensource.org/licenses/cpl.php) which can be found in the file CPL.TXT at the root of this distribution. By using this software in any fashion, you are agreeing to be bound by the terms of this license. You must not remove this notice, or any other, from this software. An transaction you can map to from your commerce order for tracking purchases in google Analytics. You must add transaction items corresponding to your order items.

An transaction you can map to from your commerce order for tracking purchases in google Analytics. You must add transaction items corresponding to your order items.

Requires at least one item

Call this to check validity before rendering the google analytics transaction

Required

Author: Joe Audette Created: 2008-08-12 Last Modified: 2008-08-12 The use and distribution terms for this software are covered by the Common Public License 1.0 (http://opensource.org/licenses/cpl.php) which can be found in the file CPL.TXT at the root of this distribution. By using this software in any fashion, you are agreeing to be bound by the terms of this license. You must not remove this notice, or any other, from this software. An item you can map to from your commerce order items for tracking purchases in google Analytics

An item you can map to from your commerce order items for tracking purchases in google Analytics

Call this to check validity before rendering the google analytics transaction

Required

Optional

Required

message to display if the api key is not found

default is 13, lower number zooms out higher number zooms in

This should be the path to the folder containing mojoPortal custom javascript for working with google APIs i.e ~/ClientScript/google/ This is NOT the path to the google server.

To use google maps you need an API key. Get it here: http://code.google.com/apis/maps/signup.html put it in Web.config as

You can set this on the control if you need to use a different Web.config key for some reason.

Indicates whether the GMapApiKey was initialized. Initialization happens in on pre-render

Hooks up the main GMap script. SubClasses should override but call the base method before doing anything else.

Author: Joe Audette Created: 2008-03-23 Last Modified: 2008-03-23 The use and distribution terms for this software are covered by the Common Public License 1.0 (http://opensource.org/licenses/cpl.php) which can be found in the file CPL.TXT at the root of this distribution. By using this software in any fashion, you are agreeing to be bound by the terms of this license. You must not remove this notice, or any other, from this software. implements support for google static map http://code.google.com/apis/maps/documentation/staticmaps/

default is 13, lower number zooms out higher number zooms in

To use google maps you need an API key. Get it here: http://code.google.com/apis/maps/signup.html put it in Web.config as

You can set this on the control if you need to use a different Web.config key for some reason.

pixel height of rendered map

pixel width of rendered map

Indicates whether the GMapApiKey was initialized. Initialization happens in on pre-render

This a control for displaying a google map based on the location set in the location property. This is more simple than using latitude longitude, lat and long are derived automatically if possible from the location. Alternatively you can set the coordinates. TODO: implement more of the optional features like overlays etc

gets or sets the text on the button used for requesting directions

gets or sets the tooltip text on the button used for requesting directions

if true the options for satelite and hybrid maps are vailable

if true uses the ma control with zoom tool

if true shows a ballon with the location info

if true shows a search input and searches google for things close to the location

if true shows an input and a button for entering a start address and requesting directions.

pixel height of rendered map

pixel width of rendered map

If set to true the map will be centered on the Latitude/Longitude coordinates.

If UseLatLong is true, the map will be centered using this Latitude.

If UseLatLong is true, the map will be centered using this Longitude.

If UseLatLong is false and this string has a value of a location that can be looked up, the map will display the found location.

Sets up the javscript for this map instance to be created.

sets up google analytics tacking

Requires at least one item

Tracking code for google analytics

If you specify an overridedomain, ._setDomainName(...) will be called http://code.google.com/apis/analytics/docs/tracking/gaTrackingSite.html

Instance name of the PageTracker

If true page load times will be measured

A key for tracking authenticated user.

A label for tagging customers or members

If true pageTracker._setLocalRemoteServerMode(); wil be called resulting in analytics data appearing in the web logs. This data can be used for additional offline processing using Urchin.

If you want to ovveride how the page is tracked you can enter it here. Like in SearchResults.aspx we track /SearchResults.aspx?q=searchterm

if you want to host the script locally put the path for the src=

Last chance to change what gets rendered.

http://www.codeproject.com/aspnet/graphicalcontrols.asp Graphical Asp.Net checkbox (with customizable images)

Load global graphical control settings from Application?

Automaticly post-back when control is clicked

Is checkbox checked ?

Gets or sets a value indicating whether the check box will allow three check states rather than two.

State of checkbox (Can be checked, unchecked and Indeterminate).

Custom image url for checked checkbox

Custom image url for indeterminate state of checkbox

Custom image url for indeterminate state of active checkbox

Custom image url for unchecked checkbox

Custom image url for checked checkbox

Custom image url for unchecked checkbox

Custom image url for checked disabled checkbox

Custom image url for unchecked disabled checkbox

Checkbox title (Used as alt attribute for image)

Checkbox text

Render hidden input control and img element

The HTML writer to write out to

Raise checked-changed event

Load data from POST (load checked from hidden input)

Key Data True when value changed

Raise check-changed event

Is raised when value is changed

State of checkbox (for three-state checkbox)

The control is unchecked.

The control is checked.

The control is indeterminate. An indeterminate control generally has a shaded appearance.

http://www.codeproject.com/aspnet/graphicalcontrols.asp Class that allows developer to simply set same images to all Graphical controls in project

Custom image url for indeterminate state of checkbox

Custom image url for indeterminate state of active checkbox

Custom image url for checked checkbox

Custom image url for unchecked checkbox

Custom image url for checked checkbox

Custom image url for unchecked checkbox

Custom image url for checked disabled checkbox

Custom image url for unchecked disabled checkbox

Custom image url for checked radiobutton

Custom image url for unchecked radiobutton

Custom image url for checked radiobutton

Custom image url for unchecked radiobutton

Custom image url for checked disabled radiobutton

Custom image url for unchecked disabled radiobutton

Save settings to Application

Load saved global settings

Object with settings or null

http://www.codeproject.com/aspnet/graphicalcontrols.asp Graphical Asp.Net checkbox (with customizable images)

Load global graphical control settings from Application?

Automaticly post-back when control is clicked

Is radiobutton checked ?

Custom image url for checked radiobutton

Custom image url for unchecked radiobutton

Custom image url for checked radiobutton

Custom image url for unchecked radiobutton

Custom image url for checked disabled radiobutton

Custom image url for unchecked disabled radiobutton

Radiobutton title (Used as alt attribute for image)

Radiobutton text

Radio buttons group

Render hidden input control and img element

The HTML writer to write out to

Raise checked-changed event

Load data from POST (load checked from hidden input)

Key Data True when value changed

Raise check-changed event

Is raised when value is changed

Source: http://www.freshclickmedia.com/blog/2008/02/gravatar-aspnet-control/ 2008-08-13 Joe Audette added to this project and changed namespace to be more convenient 2008-08-13 Joe Audette added support for SSL by returning the secure url if request is secure

The Email for the user

Size of Gravatar image. Must be between 1 and 512.

An optional "rating" parameter may follow with a value of [ G | PG | R | X ] that determines the highest rating (inclusive) that will be returned.

Determines whether the image is wrapped in an anchor tag linking to the Gravatar sit

Optional property for link title for gravatar website link

By default links to Gravatar so users can get a gravatar, but you can override it and link to a user profile for example

An optional "default" parameter may follow that specifies the full, URL encoded URL, protocol included, of a GIF, JPEG, or PNG image that should be returned if either the requested email address has no associated gravatar, or that gravatar has a rating higher than is allowed by the "rating" parameter.

Gets the base Url based on whether the request is secure or not. Added by Joe Audette 2008-08-13

This control is deprecated, you should use the portal:mojoHelpLink from the mojoPortal.Web project instead of this one.

I use this to wrap things so they are not displayed when using https/ssl, otherwise the user gets browser warnings about the insecure items in the request

Render this control to the output parameter specified.

The only purposeof this control is because we use the CSS Control Adapter to extend it rather thasn extend the standard GridView directly. This allows the standard GridView to work as expected for those who don't want to use the Adapter.

Created: 2006/04/20 Last Modified: 2007/04/20 The use and distribution terms for this software are covered by the Common Public License 1.0 (http://opensource.org/licenses/cpl.php) which can be found in the file CPL.TXT at the root of this distribution. By using this software in any fashion, you are agreeing to be bound by the terms of this license. You must not remove this notice, or any other, from this software. The purpose of this control is just for displaying a separator between links in the mojoportal skins either as text or image, with option to hide when authenticated or hide when anonymous.

See http://www.addthis.com

Your addthis.com username. If this is not set the control will not render.

if true will show widget in the page

The logo to display on the popup window (about 200x50 pixels). The popup window is show when the user selects the 'More' choice

The color to use as a background around the logo in the popup

The color to use for the text next to the logo in the popup

The brand name to display in the drop-down (top right)

A comma-separated ordered list of options to include in the drop-down Example: addthis_options = 'favorites, email, digg, delicious, more'; Currently supported options: delicious, digg, email, favorites, facebook, fark, furl, google, live, myweb, myspace, newsvine, reddit, slashdot, stumbleupon, technorati, twitter, more (the default is currently 'favorites, digg, delicious, google, myspace, facebook, reddit, newsvine, live, more', in that order).

Vertical offset for the drop-down window widget (in pixels) thiscontrol defaults to -999 which means unsepcified this will result in the defaults from addthis.com not sure what the defsault is

Horizontal offset for the drop-down window widget (in pixels) thiscontrol defaults to -999 which means unsepcified this will result in the defaults from addthis.com not sure what the defsault is

Author: Joe Audette Created: 2006-12-13 Last Modified: 2008-08-15 02/12/2007 Alexander Yushchenko: refactoring to simplify control logic. 2007/04/16 JA fixed bugs introduced in refactoring, was not resolving booleans correctly with tryparse and once that was fixed was showing config key instead of text when UseLabelTag = false This control is really just designed for use in mojoPortal and external projects that plug into mojoPortal. 2007-11-26 Joe Audette - change to render directly to output without unneccesary string creation 2008-08-15 Joe Audette removed use of viewstate

Author: Joe Audette Created: 2005-08-20 Last Modified: 2008-09-03 Dependencies: must point the ScriptDirectory property at a folder containing SmartCombo.js as well as the Sarissa javascript files: sarissa.js and sarissa_ieemu_xpath.js which provide a javascript abstration layer around the different XmlHttpRequest features of the different web browsers. more info: http://sarissa.sourceforge.net/doc/

Render this control to the output parameter specified.

Based on article from CodeProject, with modifications by Joe Audette 7/3/2006 Source: http://www.codeproject.com/useritems/WatermarkTextBoxControl.asp?df=100 The WatermarkTextBox is a asp.net servercontrol that extends a default textbox by showing the "watermark" when no text is entered by the user. Typical watermark text can be " enter your text here " or " search terms " Copyright 2006, Wouter Steenbergen - We See Consultancy (www.wesee.nl)

Public default constructor

The text to show when no text is entered by the user.

Gets or sets the script directory.

The script directory.

Use the HTML5 placeholder attribute?

Render this control to the output parameter specified.

The HTML writer to write out to