The basic shortcode for the insertion of a wppa+ display in a page or post is: [wppa][/wppa].
This sequence is equivalent to %%wppa%% in the classic wppa+ scripting language.
The shortcode allows attributes that specify the type of wppa+ display as well as the specification of albums, photos or special selection of photos.
The basic structure is: [wppa attr1="value1" attr2="value2" …][/wppa] The sequence order of attributes is irrelevant.
Important note: Make sure you do not accidently create the shortcode by a copy from an example text or an email. The double quotes might be “texturized” i.e. opening and closing quotes in stead of simple double quotes ( like in this warning the word texturized! ). This will result in unwanted behaviour!
The following attributes are recognized: type, album, photo, size and align. Possible values for all recognized attributes: (Note: n and m stand for any positive integer number, x stands for any real number in the range 0 < x < 1.)
| Attrubte | Value | Remarks |
| type | generic | This is the default value and generates a generic albums display: a list of album covers that have their parent set to —none—, or the display as requested by the querystring that calls for the page involved. |
| landing | Same as generic, except that it only displays that what is requested in the querystring. | |
| cover | The requested display type is the cover of an album. The album must be specified in the album attrubute. | |
| album | Displays sub-album covers and thumbnail images of photos in the album as specified in the album attribute. | |
| slide | Displays a slideshow of the photos in the album as specified in the album attribute. | |
| slideonly | A slideshow without supporting navigation boxes. | |
| slideonlyf | A slideshow with the filmstrip only. | |
| photo | A single photo as specified by the photo attibute. | |
| mphoto | A single photo displayed with the wp caption. | |
| slphoto | A single photo in the style of a slideshow, but without navigations. | |
| album | n | The id of the album to be used for the type of display requested by the type attribute. |
| $albumname | The name of the album to be used for the type of display requested by the type attribute. When using qTranslate make sure the name language matches the page language. | |
| #last | The most recently added (youngest) album. | |
| #topten[,n][,m] | An imaginary album containing the highest rated photos. May optionally include albumnumber (n, 0 for systemwide) and number of photos(m) if not the default as defined in the Settings admin page. | |
| #lasten[,n][,m] | An imaginary album containing the most recently uploaded photos. May optionally include albumnumber (n, 0 for systemwide) and number of photos(m) if not the default as defined in the Settings admin page. | |
| #comten[,n][,m] | An imaginary album containing the most recently commented photos. May optionally include albumnumber (n, 0 for systemwide) and number of photos(m) if not the default as defined in the Settings admin page. The number refers to the number of comments, so the number of photos may be less if several recent comments are on the same photo. | |
| #all | An imaginary album containing all photos in the system. | |
| photo | n | The id of the photo to be displayed if the type attribute is photo or mphoto |
| $photoname | The name of the photo to be displayed if the type attribute is photo or mphoto. When using qTranslate make sure the name language matches the page language. | |
| #last | ||
| #potd | ||
| size | n | A number > 1: the width of the display in pixels. |
| x | A number < 1: the fraction of the available space. | |
| auto | Uses the full 100% of the available space. | |
| align | left | Indicates where the display has to be located within the available space. |
| center | ||
| right |
Remark: If the type of display is set to a slideshow type, you can supply both an album and a photo. In this case the slideshow will start at the specified photo. The photo must be in the album, and the slideshow should be set to start still at first for this to have effect. This is not possible with scripting because in scripting you cannot supply an album and a photo at the same time. Examples: Display the cover of the album named Crane at a width of 450 pixels: Old syntax: (scripting) %%wppa%% %%cover=58%% %%size=450%% or: %%wppa%% %%cover=$Crane%% %%size=450%% New syntax: (shortcode) [wppa type="cover" album="58" size="450"][/wppa] or: [wppa type="cover" album="$Crane" size="450"][/wppa] all give the same result:
