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....
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 pageattached — a table of images attached to the current post or pageattachments — table of items from the “Attachments” plugin (see below)posts — a table of posts listed in the postid=”” parameterposts: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 tableplain — Replaces unordered-list with a div, for use with
JavaScript/jQuery slideshows, etc.thumb — Display the thumbnail for the pages or poststitle — Display the title for the pages or postsexcerpt — Display the child page’s “manual excerpt” (see FAQ)siblings — Display siblings (other children) of the current
pagefamily — Display all children, grandchildren, etc. of pageself — 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 itselfpage — For attachments, link to attachment pagenolink — 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 sizessize_small, size_med, size_large — sizes from AutoNav settings screen300x200 — force images to be resized/cropped to an exact sizeauto — 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 tablenone — each row a separate tablefull — 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 pluginmeta: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 categoriespostid="category:17" (same, ‘cat’ is abbreviation)postid="category:-17" posts not in a numeric categorypostid="category:cakes" posts by category namepostid="category__in:cakes,cookies" posts in any of the listed categoriespostid="category__and:cakes,chocolate" posts that must be in both
categoriespostid="category__not_in:cakes,chocolate" posts not one or more categoriespostid="category:*" posts in the same category as the current post/pagepostid="tag:37,38,53" posts with numerically specified tag(s)postid="tag:chocolate" posts by tag namepostid="tag__and:chocolate,hot" posts that have both tagspostid="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 taxonomypostid="movies:drama,horror" posts with any of those tags in
custom taxonomy (if ‘movies’ taxonomy is defined) or with
custom fieldpostid="month:january" subpages of current page, with custom
field “month”=”january” Note: selection of Pages by taxonomy not
yet supportedpostid="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.
Speed Test Benchmark
Learn more how we collect the data
Memory Usage Benchmark
Learn more how we collect the data
Stats
More
Email Subscription Request
Be Part of the Conversation with WordPress Enthusiasts
Using AutoNav Graphical Navigat...? Great, join the conversation now!
Let’s talk about overall quality, ease of use, stellar support, unbeatable value, and the amazing experience AutoNav Graphical Navigat... brings to you.