Scripting Reference

This page documents the the way you invoke the display of albums, photos and slideshows from within the text of a WP Page or Post.

  1. The first item in each WPPA+ invocation must be:

    %%wppa%% to ‘wake-up’ WPPA+.

  2. The second item (which is optional, i.e. you may leave it out) specifies the Album to be used this time and the way how to display it, or the single photo. It can be one of the following:

    • %%album=xx%% to show the contents of album xx.
      It displays the covers of sub-albums (if any) and thumbnails of the photos in the album (if there are more than the tresholdvalue as specified in the Photo Albums -> Settings page.
    • %%cover=xx%% to show the cover of album xx.
      This displays the cover of the specified album only. The visitor can decide what to do with it, using the links to the contents or the slideshow (if enabled).
    • %%slide=xx%% to show a slideshow of the photos in album xx.
      The supporting navigation bars that will be displayed are all set in the Photo Albums -> Settings page along with the decision whether to start the slideshow running or not.
    • %%slideonly=xx%% to show a running slideshow of the photos in album xx without any surrounding navigation bars.
    • %%photo=yy%% to show a single photo yy.

    Note: xx means: any album id. You will find album ids in the Photo Albums admin page.

    yy means: any photo id. You will find photo ids in the Photo Albums -> edit -> Manage Album Information page under: Manage Photos. Each photoitem includes a Get insertion Code button that gives you the required code.

    If you leave this second item out, you will get all albums that have set their parent to —none—, i.e. the Generic Photo Album.

  3. The third item (which is also optional) can be:

    %%size=zz%%

    It indicates that the width of the entire photo album (content) can be set to the specified number of pixels or to auto (auto is new at version 2.4.0).

    If this value is set, it overrules both Column Width and Full Size you specified in the Photo Albums -> Settings admin page.

    If this value is auto the wppa-invocation behaves as the content of a theme with a floating column width, and it overrules the Stretch setting as if it was checked, and the vertical alignment as if it was set to fit.

    4. New at version 2.4.0 is:

  4. The fourth item (also optional) is ment for horizontal alignment. It can be one of the following:

    %%align=left%%
    %%align=center%%
    %%align=right%%

    Although it looks like %%align=left%% is the default, there may be a difference in layout between the two cases wheter you use %%align=left%% or leave the item out.

The maximum of 4 items need not to be on different lines, they may be typed on one line, without spaces between them if you like. Al text between the items will be lost. The sequence of the four items should be as documented, any item out of sequence will give unpredictable results.