What's this [media] tag about anyway?
It's here to make it easy for users to embed items into any place that accepts BBC tags, such as forum posts.
Here are a couple of quick examples:
[media id=123 type=preview align=center width=400 caption="Hello, world!"]
Show a center-aligned mid-size (preview) picture, resized to 400 pixels wide, with a caption below it. All parameters are optional, except for the item ID.
[media id=1,2 type=album]
Shows the latest items in your first two albums, using the box type (see below.)
Possible values:
- type=normal, box, link, preview, full, album
- align=none, left, center, right
- width=123 (in pixels)
- caption="Caption text" or caption=SingleWordText
Available parameters
id
- All items are identified by a specific number which you can see in its URL. Just use it here. This is the only parameter that is NOT optional.
You may specify several items by separating them with commas, as in "[media id=1,2,3 type=album]".
type
- normal (default, except if set up differently) - show the thumbnail. Click on it to show a preview.
- av - embed an audio or video item within a player. If you do not use this parameter, the item's thumbnail will show up as expected, but clicking on it will load the file directly. You don't want that to happen. Really.
- box - show the thumbnail box, with full details, as in the Media Gallery pages. Clicking on the thumbnail will lead you to the item page.
- link - just like the default, except that the caption is clickable and leads you to the item page. If no caption is set, a default link will be shown instead.
- preview (may be default if set up accordingly) - show the preview picture (halfway between thumbnail and full picture.)
- full (may be default if set up accordingly) - show the full picture. Make sure you set the width parameter!
- album - show the latest items from the album(s) indicated in id. They will be shown using the box type.
align
- none (default) - normal alignment. Will not allow thumbnails to its right or left.
- left - left-align the thumbnail. Use several left-aligned [media] tags to show thumbnails next to each other.
- center - center-align the thumbnail. Will not allow thumbnails to its right or left, except if showing them in this order: [media align=left][media align=right][media align=center]
- right - same as left, but right-aligned. You got it.
width
- Any number higher than zero will do. This parameter is only needed if you want to force a specific width.
- Set the tag type according to the desired size. For instance, if your thumbnails have a default width of 120, and previews are 500 pixels wide, use [media type=preview] if you're forcing a width of 300 to 500 pixels, otherwise the resulting thumbnail will be very blurry.
caption
- Show a caption below the thumbnail (if type is set to link, the caption will be clickable and lead you to the item page.)
- Any string will do. If it contains spaces or brackets, be sure to enclose it between "double quotes".