Compose tips

Allowed HTML tags: <a> <em> <strong> <cite> <code> <ul> <ol> <li> <dl> <dt> <dd> <p> <br> <hr />

It's possible to show video content in the lightbox. In this case the "rel" attribute should be set to lightvideo. It's possible to group videos and to control the size of the lightbox by setting the "width" and "height" properties. The properties can be configured like lightvideo[group|width:300px; height: 200px;][caption]. The properties should all be of the format "property: value;" - note the closing semi-colon. If no properties are set, then the default width and height of 400px will be used. See below for more detailed examples.

Basic example:
<a href="http://video.google.com/videoplay?docid=1811233136844420765" rel="lightvideo">Google video example - default size</a>

Controlling lightbox size example:
<a href="http://video.google.com/videoplay?docid=1811233136844420765" rel="lightvideo[group|width:400px; height:300px;][caption]">Google video example - custom size</a>

Supported video formats include asx, wmv, mov and swf. A number of online video providers are also supported, including YouTube and Google Video. For a full list of the current supported video providers please see the documentation on drupal.org.

To add a lightbox to your images, add rel="lightbox" attribute to any link tag to activate the lightbox. For example:

<a href="image-1.jpg" rel="lightbox">image #1</a>

<a href="image-1.jpg" rel="lightbox[][my caption]">image #1</a>

To show a caption either use the title attribute or put in the second set of square brackets of the rel attribute.

If you have a set of related images that you would like to group, then you will need to include a group name between square brackets in the rel attribute. For example:

<a href="image-1.jpg" rel="lightbox[roadtrip]">image #1</a>
<a href="image-2.jpg" rel="lightbox[roadtrip][caption 2]">image #2</a>
<a href="image-3.jpg" rel="lightbox[roadtrip][caption 3]">image #3</a>


There are no limits to the number of image sets per page or how many images are allowed in each set.

If you wish to turn the caption into a link, format your caption in the following way:

<a href="image-1.jpg" rel='lightbox[][<a href="http://www.yourlink.com">View Image Details</a>]' >image #1</a>

To add a lightbox slideshow to your images, add rel="lightshow[slideshowname][slide caption]" attribute to any link tag to activate the slideshow. For example:

<a href="image-1.jpg" rel="lightshow[show1]">image #1</a>
<a href="image-2.jpg" rel="lightshow[show1]">image #2</a>
<a href="image-3.jpg" rel="lightshow[show1]">image #3</a>


The title attribute in the link tag is optional. The addition of this attribute enables the display of a caption with the image displayed in the lightbox.

There are no limits to the number of slideshow image sets per page or how many images are allowed in each slideshow.

If you wish to turn the caption into a link, format your caption in the following way:

<a href="image-1.jpg" rel='lightshow[show1][<a href="http://www.yourlink.com">View Image Details</a>]'>image #1</a>

It's possible to show webpage content in the lightbox, using iframes. In this case the "rel" attribute should be set to "lightframe". Again it's possible to group the content, (e.g. lightframe[search][caption]) but in addition to that, it's possible to control some of the iframe properties. It's possible to set the "width", "height" and "scrolling" properties of the iframe. The properties are separated from the group name by a |, for example lightframe[search|width:100px;][caption]. If no grouping is being used, then the | is still used and the format would be lightframe[|width:100px;]. The properties should all be of the format "property: value;" - note the closing semi-colon. If no iframe properties are set, then the default width and height of 400px will be used. See below for more detailed examples.

Basic example:
<a href="http://www.google.com" rel="lightframe">Search google</a>

Grouped example:
<a href="http://www.google.com" rel="lightframe[search][caption]">Search google</a>
<a href="http://www.yahoo.com" rel="lightframe[search]">Search yahoo</a>

Controlling iframe property example:
<a href="http://www.google.com" rel="lightframe[|width:400px; height:300px; scrolling: auto;][caption]">Search google</a>

Controlling iframe property when grouped example:
<a href="http://www.google.com" rel="lightframe[search|width:400px; height:300px; scrolling: auto;]">Search google</a>
<a href="http://www.yahoo.com" rel="lightframe[search|width:400px; height:300px;]">Search yahoo</a>

It's possible to show HTML snippets in the lightbox, that is on the same domain. In this case the "rel" attribute should be set to "lightmodal". Again it's possible to group the content, (e.g. lightmodal[group][caption]) but in addition to that, it's possible to control some of the modal properties. It's possible to set the "width", "height" and "scrolling" properties of the modal. The properties are separated from the group name by a |, for example lightmodal[group|width:100px;][caption]. If no grouping is being used, then the | is still used and the format would be lightmodal[|width:100px;]. The properties should all be of the format "property: value;" - note the closing semi-colon. If no modal properties are set, then the default width and height of 400px will be used. See below for more detailed examples.

Basic example:
<a href="search.php" rel="lightmodal">Search</a>

Grouped example:
<a href="search.php" rel="lightmodal[search][caption 1]">Search</a>
<a href="search.php?status=1" rel="lightmodal[search]">Search published</a>

Controlling modal property example:
<a href="search.php" rel="lightmodal[|width:400px; height:300px; scrolling: auto;][caption]">Search</a>

Controlling modal property when grouped example:
<a href="search.php" rel="lightmodal[search|width:400px; height:300px; scrolling: auto;]">Search</a>
<a href="search.php?status=1" rel="lightmodal[search|width:400px; height:300px;]">Search published</a>

Gallery2 Filter:

You can link to items in your embedded Gallery2 using a special code. This code will be replaced by a thumbnail image that is linked to the actual item in your Gallery.

Syntax: [G2: item_id n= number type= type size= number class= name frame= name album_frame= name item_frame= name ]

• item_id (required): This is the item ID from Gallery2. If you look at the URL of the item, this is the last number. Note that if the item_id is a single photo, n must be 1.
• n (suggested): This is the number of photos you want the block to show. It will override whatever is set in the defaults (initially 1). Note: this will change past instances where you did not set n -- the reason for its suggested use.
• type: The default type of gallery block. Any of the following may be used: randomImage, recentImage, viewedImage, randomAlbum, recentAlbum, viewedAlbum, dailyImage, weeklyImage, monthlyImage, dailyAlbum, weeklyAlbum, monthlyAlbum, specificItem. Note that for n=1, selectedItem is automatically chosen regardless of this parameter.
• class: The block that Gallery2 returns is wrapped in a DIV so additional styling can be done. The classes for this DIV are located in g2_filter.css. Included with the module are "left", "right", and "nowrap". These position the image block to the left or right or on a line all its own with the text not wrapping. You can also add your own class(es) to the CSS file and they will automatically be available.
• size: The length of the longest side for the thumbnail. The other side is determined automatically to keep the same aspect ratio. This option (for Gallery2.2 and above) will use the gallery image that is closest in size, and so may end up using a smaller image and expanding it (lower quality). If so, use "exactsize". For Gallery2.1, if you want your size to be bigger thanthe thumbnail size for that image as defined in your Gallery2, you must select "Full Size" inthe gallery settings page (but note that the full image will be returned and then resized by the browser, so it may take a while to download).
• exactsize: The length of the longest side for the thumbnail. The other side is determined automatically to keep the same aspect ratio. This option always ensures that the image is scaled from a larger image and so image quality is maintained. This only works for Gallery2.2 and above.
• frame/album_frame/item_frame: You can use just "frame" to assign a frame to the thumbnail regardless of whether it\'s for an album or a single item. Using aframe will only affect albums and iframe will only affect single items. Frames included with the default Gallery 2 install are: bamboo, book, brand , dots, flicking, gold, gold2, polaroid, polaroids, shadow, shells, slide, solid, notebook, wood.