WordPress.org

Ready to get started?Download WordPress

Plugin Directory

AutoNav Graphical Navigation and Gallery Plugin

Creates customizable lists/tables of text/thumbnails/links to posts, pages, taxonomies, attachments, custom post types, and image directories.

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: <a rel="lightbox" ...>

  • 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 this 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 Media Tags plugin or the Attachment Taxonomy 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.

Requires: 3.5 or higher
Compatible up to: 3.8.3
Last Updated: 2013-12-16
Downloads: 30,809

Ratings

4 stars
4.6 out of 5 stars

Support

0 of 1 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

1 person says it works.
0 people say it's broken.

0,1,0
100,1,1
0,1,0 100,2,2 100,1,1 100,2,2
100,1,1 100,1,1
0,1,0
0,3,0
50,2,1 100,2,2 100,2,2 100,1,1 67,3,2
100,1,1 100,1,1
100,1,1
100,1,1 100,1,1
100,2,2 100,2,2
100,1,1 100,1,1
100,1,1
100,1,1
100,1,1
100,2,2 100,3,3
100,1,1 67,3,2
60,5,3
100,6,6
100,1,1 100,1,1 100,1,1 100,1,1 67,3,2
100,1,1
100,1,1
100,3,3
100,1,1
100,1,1
100,1,1