WordPress.org

Author: William Lindley

Auto Graphics Site Navigation with Gallery

I wrote this plugin to make it easy for me to write graphical page-based Wordpress sites. I wanted to address these issues:

• I wanted to create websites with many nested pages, and permit the user to navigate among them by clicking on pictures within the pages, rather than having to use the Page List. I wanted to list child pages in tables, and have the size of the tables, and the number of rows, automatically computed to fit my layout, based on the thumbnail sizes.

• I wanted the thumbnail pictures, and the galleries of pictures I added in each page, to have be automatically resized either through a single default setting in the Wordpress administration page, or by specifying a size in a page I was editing. I further wanted those thumbnails to be automatically generated, or regenerated, so there would never be a missing image.

• I wanted to put all the images for a specific page, in a single directory under the wp-content/uploads directory. This makes it easy to add or remove images from FTP or from a command line. It also makes it possible to move an image from one page to another -- which is maddeningly difficult if not impossible using Wordpress's built-in Attachment system.

This plugin does all that, with two modes.

In navigation mode: Creates a list or table of the current page's child pages. Tables are composed of linked thumbnail pictures based a custom field in each child page, or the child page's attached picture. Example:

[autonav display="images" pics_only="1"]

displays a table of the current page's child pages. Only child pages that have associated pictures will be displayed. The table will have 3 or 4 columns depending on the default size of the thumbnails and depending on the column settings in the Wordpress administration screen.

In gallery mode: Creates one or more tables of linked thumbnail pictures based on the current page's attachments, or on specified directories of picture files under the uploads directory. Example:

[autonav display="/project2" include="32,37,56"]

Displays a table, with a gallery of three pictures from the wp-content/uploads/project2 directory, in the specified order.

Uses parameters from the Gallery Shortcode (introduced in Wordpress 2.5):

 display="x"     Chooses a display mode based on "x" as follows:
         images -- displays a table of images, one for each of the child
              pages of this post. 
         list -- displays a list of links to the child pages of this post. 
         attached -- displays a table of images attached to the post
         /folder -- displays a table of images located in the
              wp-content/uploads/folder directory
 columns="4"     displays 4 columns of images
 size="x"        Choose a display size 'x' as:
         thumbnail, medium, large, full -- Wordpress standard sizes
         300x200 -- force images to be resized and cropped to exact size
         auto -- uses settings from autonav control panel
 titles="1"      Displays page titles below images if 1 (default: "0")
 pics_only="1"   When displaying child pages, only show those with associated images
 include="1,7"   The resulting table will have only two pictures, the first
         found ending in "1" and "7" -- note that because both 1 and 7
         are numeric, the image "pic11.jpg" would not be included, but
         "pic1.jpg" or "pic01.jpg" would be.  For non-numeric values, the 
         first found picture whose name ends with the value given will
         be selected.
 combine="x"     Combines table rows as follows (default: "all")
         all -- all rows combined into one table
         none -- each row a separate table
         full -- combine all full rows into one table, with trailing
          row a separate table (so it can be centered)
 crop="1"        Crops images to fit exact size, or "0" to fit maximum into size.
 imgrel="lightbox" Sets the relation tag of the <a> to be: rel="lightbox"
 group="vacation1" When combined with imgrel="lightbox*" this sets the relation
           tag to be: rel="lightbox[vacation1]
 exclude="3,5"   Excludes pages with ID 3 and 5 from the list (with display="list")
 postid="123"    Displays images or subpages attached to the page or post
             with the given ID, instead of the current page or post.

Parameters not specified will be taken from the values set in the WordPress admin panel.