Get the Flash Player to see this player.

Compose tips

  • SmugMug filter Guide

    Introduction

    SmugMug filter allows you to easily display images and slide showsfrom any SmugMug account into any portion of text that allows filtering.

    Basic Usage - Images

    Inside the body of the text, you simply insert [smugmug|id=xxxxx] where ever you want a picture displayed. The xxxxx being the image ID you want displayed. To find the picture ID, you simply surf your gallery for the image you want displayed. The number at the end of the url is the imageID you want to copy.

    An example

    This image url: http://www.warmy.com/image/9387

    The image ID is: 9387

    Your final SmugMug filter tag will look like this: [smugmug|id=9387]

    Options

    This module allows you to specify various options to control the position, size and other options of how to display your image. The options are listed below.

    Option: alt
    Allows you to define alternative text to display for your image. The default alt text is the SmugMug image description.

    Option: align
    Defines how to align the image near/within text, top, bottom, center, left, right. The deafult is to align left.

    Option: size
    Allows you to select the size of the image to display. The default size is thumb. The sizes available are tiny (or ti), thumb (or t), small (or s), medium (or m), large (or l), original (or o) or you can define a number, such as 200. This would request and image from SmugMug where the longest side is 200, and the other side is resized to the proper ratio. This method is not preferred as stats are not tracked for odd size images.

    Option: link
    Allows you to supply an alternative link for an image. This defaults to the image within the gallery.

    Basic Usage - Slide Shows

    Inside the body of the text, you simply insert [smugmug-slide|image=xxxx,yyyy,zzzz] where ever you want a slide show displayed. The xxxx,yyyy,zzzzz being the image ID(s) you want displayed. You can specify as many images as you want. Additionaly, you can specify albums to display. To do this, simply use the album= setting, specifying as many albums as you want.

    Example Slide show tags

    [smugmug-slide|image=1234,2345,3456,4567]
    Make a slide show with imageIDs 1234, 2345, 3456 and 4567.
    [smugmug-slide|album=39871,23982]
    Make a slide show using images inside albums 39871 and 23982.

    Options

    This module allows you to specify various options to control the position, size and other settings for your slide show.
    Option: align
    Defines how to align the image near/within text, top, bottom, center, left, right. The deafult is to align left.

    Option: size
    Allows you to select the size of the image to display. The default size is thumb. The sizes available are tiny (or ti), thumb (or t), small (or s), medium (or m), large (or l), original (or o) or you can define a number, such as 200. This would request and image from SmugMug where the longest side is 200, and the other side is resized to the proper ratio. This method is not preferred as stats are not tracked for odd size images.

    Option: link
    Allows you to supply an alternative link for an image. This defaults to the image within the gallery.

    Option: image=xxx[,...]
    A list of image IDs, seperated by commas without spaces to include in slide show. Can be used in conjunction with the "album" option. Can have as many images as you wish.

    Option: album=xxx[,...]
    A list of album IDs, seperated by commas without spaces to include in slide show. Can be used in conjunction with the "image" option. Can have as many albums as you wish.

    Option: link
    Allows you to supply an alternative link for the images. This defaults to the image within the gallery.

    Option: desc_prefix
    String prefix for image descriptions display.

    Option: controls_top
    Use to place slide show controls at the top.

    Option: show_controls
    Display slide show controls.

    Option: fadecolor=XXX
    Sets the background color of images while fading.
    Can use any color accepted by web browers. Can use words like red, blue, green, or you can use the #RRGGBB values.

    Option: delay=XXX
    Delay between image rotations in milliseconds.

    Option: show_descriptions
    Show image captions/text near image.

    Option: border=xx
    Show a border with a width of XX.

    Option: border_color=XXX
    Can use any color accepted by web browers. Can use words like red, blue, green, or you can use the #RRGGBB values.

    Option: border_style=ABC
    Use any valid CSS style border. See http://www.tizag.com/cssT/border.php for ideas.

    Option: random
    Ranomize the order of pictures on each page load.