AutoNav Graphical Navigation and Gallery Plugin

Screenshots

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