AutoNav Graphical Navigation and Gallery PluginbyWilliam Lindley

Auto Graphics Site Navigation with Gallery

This plugin simplifies the creation of graphically navigable WordPress
sites, creating a list or tables of pages, posts, taxonomies, and
custom post types, selected in a variety of ways. Highly customizable
output using a variety of optional user-defined filters.

• Sites with nested pages can show a table of clickable thumbnails
  of child pages, with size of the tables, and the number of rows,
  automatically computed to fit, based on the thumbnail sizes.
• A table of posts selected by tag, category, or author can be
  displayed in the same manner.
• Thumbnails of pictures, and the galleries of pictures added in
  each page, can be automatically resized either through a single
  default setting in the WordPress administration page, or by
  specifying a size in each page. Missing thumbnails will be
  automatically generated.
• A gallery of images can be created simply by placing them in a new
  directory under the wp-content/uploads directory. Standard
  command-line or FTP tools can then be used to move, rename, or
  delete images.
• Output and page/post selection is extensible through the use of
  filters.
• Works with WordPress’s standard attachment mechanism, and with
  J. Christopher’s “Attachments” plugin (see FAQ)

NOTE: You can raise issues or participate in development at GitHub
If you experience errors or missing pages, you might try the stable version.
All previous versions are archived here.

The plugin is invoked with the [autonav] shortcode, with two basic modes:

NAVIGATION.

Creates a list or table of the current page’s child pages. Tables are
composed of linked thumbnail pictures (see “How is a Child Page’s
“Associated Image” determined?” in the FAQ). 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.

GALLERY.

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. Examples:

[autonav display="attach"]

displays a table of images attached to the current post or page.

[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.

[autonav ids="57,65"]

For compability with the [gallery] ids parameter introduced in
WordPress 3.5, displays a table of attachments with the exactly
specified attachment IDs.

Shortcode Parameters

Parameters not specified will be taken from the values set in the
WordPress admin panel. The optional display parameters should be
enclosed in the display argument; for example,
[autonav display=”posts,list,thumb,title”]

• display="x" Displays a list or table, based on “x” as follows:

  • images — a table, with one cell for each of the child pages of the current page.
  • list — a list, with an entry for each child of the current page
  • attached — a table of images attached to the current post or page
  • attachments — table of items from the “Attachments” plugin (see below)
  • posts — a table of posts listed in the postid=”” parameter
  • posts:TYPE — a table of posts in custom post type TYPE
  • /folder — a table of images located in wp-content/uploads/folder

  Optional parameters, in a comma-separated list:

  • list — Used with display=”posts” for list, not table
  • plain — Replaces unordered-list with a div, for use with
    JavaScript/jQuery slideshows, etc.
  • thumb — Display the thumbnail for the pages or posts
  • title — Display the title for the pages or posts
  • excerpt — Display the child page’s “manual excerpt” (see FAQ)
  • siblings — Display siblings (other children) of the current
    page
  • family — Display all children, grandchildren, etc. of page
  • self — Include the current page (with siblings, or family)
    (normally the current page or post is excluded)
  • image — For posts, link to full-size of thumbnail instead of
    to post itself
  • page — For attachments, link to attachment page
  • nolink — Disables links entirely The above parameters may be
    preced by ‘no’ to disable the feature (as when set by default or
    in the plugin options page).

  Example: display="list,notitle,thumb,excerpt"

• caption="x" Adds a caption to the table. (First table only, see combine below)

• columns="4" Displays 4 columns of images

• size="x" Choose a display size ‘x’ as:

  • thumb (or: thumbnail), medium, large — WordPress standard sizes
  • size_small, size_med, size_large — sizes from AutoNav settings screen
  • 300x200 — force images to be resized/cropped to an exact size
  • auto — uses settings from autonav control panel

  Sizes registered with add_image_size() should also work.

• titles="1" Displays page titles below images if 1 (default: “0”)
  (same as using title parameter to display=)

• pics_only="1" When displaying child pages, only show those with associated images

• ids="57,65" Selects the attachments with the exactly specified
  attachment IDs. display= is assumed to be “attach”. Works
  similarly to WordPress’s built-in [gallery] shortcode. orderby=
  defaults to the exact ordering given, but can be overridden.

• include="1,7" Used with display=/folder syntax only; others, see
  postid parameter. 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.

• exclude="3,dessert" Excludes posts/pages with ID 3 and the slug
  ‘dessert‘ Note: To include posts or pages by category, author,
  etc, see the postid parameter.

• 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, centering image; “2” crops from upper-left; “3” from top
  middle (useful with head-and-shoulders portraits)

• sharp="1" Changes downsize algorithm from ‘resample’ (smooth) to
  the more blocky ‘resize’ (see below)

• start="1" Starts at the second image or page (counting from zero)

• count="2" Includes only two images or pages

• paged="12" Displays 12 images on one ‘page’ along with next/prev,
  and page numbers. Note: ‘start’ and ‘count’ are applied first to
  trim which images are included in those displayed and paged.

• order="desc" Sort order: “asc” ascending, “desc” descending, “rand” random.
  See the

• orderby="x" Where ‘x’ is any orderby parameter (e.g., date, title) from the
  codex
  or one of:

  • postmash — use order defined by PostMash plugin
  • meta:subpage_title — sorts by any custom field; here we sort
    by the child page’s title as overridden by the subpage_title
    custom field (see FAQ section)

  The orderby parameter is not used when displaying attachments or
  images from a directory.

• imgrel="lightbox" Sets the relation tag of the created links as:
  

• group="vacation1" When combined with imgrel="lightbox*" this
  sets the relation tag to be: rel="lightbox[vacation1]

• postid="123" Displays images or subpages attached to the page(s)
  or post(s) with the given ID, or comma-delimited list of IDs,
  instead of the current page or post. Can also select posts in
  category/tag/author; or pages with specified path, author or custom
  field value.

  In addition to a numeric postid, you may select posts or pages
  as follows:

  • postid="cat:17" posts in a numeric category or categories
  • postid="category:17" (same, ‘cat’ is abbreviation)
  • postid="category:-17" posts not in a numeric category
  • postid="category:cakes" posts by category name
  • postid="category__in:cakes,cookies" posts in any of the listed categories
  • postid="category__and:cakes,chocolate" posts that must be in both
    categories
  • postid="category__not_in:cakes,chocolate" posts not one or more categories
  • postid="category:*" posts in the same category as the current post/page
  • postid="tag:37,38,53" posts with numerically specified tag(s)
  • postid="tag:chocolate" posts by tag name
  • postid="tag__and:chocolate,hot" posts that have both tags
  • postid="author:27" posts or child pages with a specific author
    by ID,
  • postid="author:Todd" …by author name,
  • postid="author:*" …by same author as current post or page.
  • postid="status:future" future posts or pages. see list in the
    codex
    status=* for same status as current post/page.
    Can also use custom status types.
  • postid="movies:comedy" posts tagged in a custom taxonomy
  • postid="movies:drama,horror" posts with any of those tags in
    custom taxonomy (if ‘movies’ taxonomy is defined) or with
    custom field
  • postid="month:january" subpages of current page, with custom
    field “month”=”january” Note: selection of Pages by taxonomy not
    yet supported
  • postid="recipes/desserts" page by its full path (NOT merely its slug)

You can specify both a page/post ID and one of the above. For example,
postid=”27,author:Todd” would show subpages of the page with ID=27 that have
author Todd.

Note that any of several plugins, like one,
must be used to associate a category with a page. Once you have done
so, you can for example, create a page for each of your categories
which will display a list of the most recent posts in “its” category:

[autonav display="posts,nothumb,title,list" postid="category:*"]

You could also display a list of all the most recent posts not in
the page’s category:

[autonav display="posts,nothumb,title,list" postid="category__not_in:*"]

The postid selectors category__and, category__in, category__not_in
permit more complex category selection, as described in the
codex.

You may also select attachments based on their parent (given by
slug or post-ID), their author (which WordPress sets when the
attachment is uploaded; there is no built-in way to edit an
attachment’s author, although a plugin may provide one), by status
or by the categories or tags set through the plugin or the
plugin:

[autonav display="attached" postid="recipes,tag:dessert"]

would display images, attached to the recipes page, having the
attachment tag “dessert”.

It is even possible to display attachments having a certain tag or
category from all posts and pages, a special case of postid="-1":

[autonav display="attached" postid="-1,tag:dessert"]

Note that you must set the taxonomies on the AutoNav settings
page. For Media Tags, use attachment tag, “media-tags“; for the
Attachment Taxonomy plugin, use “attachment_tag” and
“attachment_category“. Other taxonomy names are permissible in hopes
of being compatible with future WP versions.

NOTE: The Sharp parameter is now regarded only by an optional
addon. Additional example values are:

• 0 — standard smooth resample
• 1 — standard blocky resize
• 60 — resize, with 60% image quality on JPEG save
• 95.75 — intermediate image resized down by 75%, then resampled
  to final giving a “75% sharpness” factor, then saved with
  95% image quality
• 90.50 — “50% sharpness” and 90% image quality
• -60 — resampled, and saved with 60% image quality

Development Notes

• [Note 20120111] Other filetypes handled in get_images_from_folder()
  must take care to let actual images take priority regardless of
  which appears first in directory. The switch statement will need to
  take this into account.