All versions: If you have upgraded AutoNav and are using new\nparameters, you will need to go to the AutoNav Settings page on the\nWordPress administration panel and save your settings. This will add\nthe required default values which permit the parameter parser to work.<\/p>","1.5.6":"
Lists will use the class given in the class= argument directly,\nwithout appending "-list" and the enclosed items will omit the class\nentirely. You may need to modify your stylesheet along these lines:<\/p>\n\n
From: .myclass-list { ... } .myclass-item { ... }\nTo: .myclass ul { ... } .myclass ul li { ... }\n<\/code><\/pre>","1.5.0":"If you have used the Media Tags plugin, you must set the taxonomies on\nthe AutoNav settings page: use attachment tag,\n"media-tags<\/code>". This now supports the Attachment Taxonomy plugin; use\n"attachment_tag<\/code>" and "attachment_category<\/code>". Other taxonomy names\nare permissible in hopes of being compatible with future WP versions.<\/p>","1.4.8":"When using display="post" you may need to add the nothumb argument:<\/p>\n\n
display="post,nothumb"\n<\/code><\/pre>\n\nif you want the previous behaviour of titles and no thumbnails.\nFor display="list" the default is still titles and no thumbnails.<\/p>\n\n
Support addons via filters. "notitle" and similar parameters for\nsuppressing default behaviors.<\/p>"},"ratings":{"1":0,"2":"1","3":"1","4":0,"5":"8"},"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":"1143859","resolution":"256x256","location":"assets"}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":"1143848","resolution":"772x250","location":"assets"}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1.8","1.1.9","1.2.2","1.2.3","1.2.4","1.2.5","1.2.7","1.2.8","1.2.9","1.3.0","1.3.1","1.3.2","1.3.3","1.3.4","1.3.5","1.3.6","1.3.7","1.3.8","1.4.0","1.4.1","1.4.7","1.4.9","1.5.0","1.5.2","1.5.3","1.5.4","1.5.6","1.5.9"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":"823465","resolution":"1","location":"assets"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"823465","resolution":"2","location":"assets"},"screenshot-3.png":{"filename":"screenshot-3.png","revision":"823465","resolution":"3","location":"assets"},"screenshot-4.png":{"filename":"screenshot-4.png","revision":"823465","resolution":"4","location":"assets"}},"screenshots":{"1":"Child pages displayed in two different ways, first as a list and\nthen as a table.","2":"AutoNav used together with the Hierarchical Pages plugin on the\nFisher Shotcrete site. Along with the third screenshow, demonstrates\nhow graphical navigation of a large site can work.","3":"Second-level page on the Fisher site. Note, with Hierarchical\nPages, only the pages that are \"siblings\" to the current page are \nlisted in the sidebar (otherwise there could be hundreds).","4":"Demonstrating a \"magazine style page template\" where the first\nattachment (a) is displayed at large size, the second (b) in a\nmedium, and all subsequent ones (c) as small thumbnails. Merely\nreordering the attachments updates the page and creates any needed\nthumbnails."}},"plugin_section":[],"plugin_tags":[9922,210,1753,243,166],"plugin_category":[43,50,57],"plugin_contributors":[],"plugin_business_model":[],"class_list":["post-6792","plugin","type-plugin","status-closed","hentry","plugin_tags-child","plugin_tags-gallery","plugin_tags-navigation","plugin_tags-pages","plugin_tags-posts","plugin_category-customization","plugin_category-media","plugin_category-taxonomy","plugin_committers-cardiganmedia"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/autonav_b6bec6.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/autonav\/assets\/screenshot-1.png?rev=823465","caption":"Child pages displayed in two different ways, first as a list and\nthen as a table."},{"src":"https:\/\/ps.w.org\/autonav\/assets\/screenshot-2.png?rev=823465","caption":"AutoNav used together with the Hierarchical Pages plugin on the\nFisher Shotcrete site. Along with the third screenshow, demonstrates\nhow graphical navigation of a large site can work."},{"src":"https:\/\/ps.w.org\/autonav\/assets\/screenshot-3.png?rev=823465","caption":"Second-level page on the Fisher site. Note, with Hierarchical\nPages, only the pages that are \"siblings\" to the current page are \nlisted in the sidebar (otherwise there could be hundreds)."},{"src":"https:\/\/ps.w.org\/autonav\/assets\/screenshot-4.png?rev=823465","caption":"Demonstrating a \"magazine style page template\" where the first\nattachment (a) is displayed at large size, the second (b) in a\nmedium, and all subsequent ones (c) as small thumbnails. Merely\nreordering the attachments updates the page and creates any needed\nthumbnails."}],"raw_content":"\n
Auto Graphics Site Navigation with Gallery<\/p>\n\n
This plugin simplifies the creation of graphically navigable Wordpress\nsites, creating a list or tables of pages, posts, taxonomies, and\ncustom post types, selected in a variety of ways. Highly customizable\noutput using a variety of optional user-defined filters.<\/p>\n\n
\n- Sites with nested pages can show a table of clickable thumbnails\nof child pages, with size of the tables, and the number of rows,\nautomatically computed to fit, based on the thumbnail sizes.<\/li>\n
- A table of posts selected by tag, category, or author can be\ndisplayed in the same manner.<\/li>\n
- Thumbnails of pictures, and the galleries of pictures added in\neach page, can be automatically resized either through a single\ndefault setting in the Wordpress administration page, or by\nspecifying a size in each page. Missing thumbnails will be\nautomatically generated.<\/li>\n
- A gallery of images can be created simply by placing them in a new\ndirectory under the wp-content\/uploads directory. Standard\ncommand-line or FTP tools can then be used to move, rename, or\ndelete images.<\/li>\n
- Output and page\/post selection is extensible through the use of\nfilters.<\/li>\n
- Works with WordPress's standard attachment mechanism, and with\nJ. Christopher's \"Attachments\" plugin (see FAQ)<\/li>\n<\/ul>\n\n
NOTE: You can raise issues or participate in development at GitHub<\/a>\nIf you experience errors or missing pages, you might try the previous\nstable version<\/a>.\nAll previous versions are archived here<\/a>.<\/p>\n\nThe plugin is invoked with the [autonav] shortcode, with two basic modes:<\/p>\n\n
NAVIGATION.<\/p>\n\n
Creates a list or table of the current page's child pages. Tables are\ncomposed of linked thumbnail pictures (see \"How is a Child Page's\n\"Associated Image\" determined?\" in the FAQ). Example:<\/p>\n\n
[autonav display=\"images\" pics_only=\"1\"]\n<\/code><\/pre>\n\ndisplays a table of the current page's child pages. Only child pages\nthat have associated pictures will be displayed. The table will have\n3 or 4 columns depending on the default size of the thumbnails and\ndepending on the column settings in the Wordpress administration\nscreen.<\/p>\n\n
GALLERY.<\/p>\n\n
Creates one or more tables of linked thumbnail pictures based on the\ncurrent page's attachments, or on specified directories of picture\nfiles under the uploads directory. Examples:<\/p>\n\n
[autonav display=\"attach\"]\n<\/code><\/pre>\n\ndisplays a table of images attached to the current post or page.<\/p>\n\n
[autonav display=\"\/project2\" include=\"32,37,56\"]\n<\/code><\/pre>\n\nDisplays a table, with a gallery of three pictures from the\nwp-content\/uploads\/project2 directory, in the specified order.<\/p>\n\n
[autonav ids=\"57,65\"]\n<\/code><\/pre>\n\nFor compability with the [gallery] ids parameter introduced in\nWordPress 3.5, displays a table of attachments with the exactly\nspecified attachment IDs.<\/p>\n\n
Shortcode Parameters<\/h3>\n\n
Parameters not specified will be taken from the values set in the\nWordPress admin panel. The optional display parameters should be\nenclosed in the display argument; for example,\n [autonav display=\"posts,list,thumb,title\"]<\/p>\n\n
\ndisplay=\"x\"<\/code> Displays a list or table, based on \"x\" as follows:<\/p>\n\n\nimages<\/code> -- a table, with one cell for each of the child pages of the current page.<\/li>\nlist<\/code> -- a list, with an entry for each child of the current page<\/li>\nattached<\/code> -- a table of images attached to the current post or page<\/li>\nattachments<\/code> -- table of items from the \"Attachments\" plugin (see below)<\/li>\nposts<\/code> -- a table of posts listed in the postid=\"\" parameter<\/li>\nposts:TYPE<\/code> -- a table of posts in custom post type TYPE<\/li>\n\/folder<\/code> -- a table of images located in wp-content\/uploads\/folder<\/li>\n<\/ul>\n\nOptional parameters, in a comma-separated list:<\/p>\n\n
\nlist<\/code> -- Used with display=\"posts\" for list, not table<\/li>\nplain<\/code> -- Replaces unordered-list with a div, for use with\nJavaScript\/jQuery slideshows, etc.<\/li>\nthumb<\/code> -- Display the thumbnail for the pages or posts<\/li>\ntitle<\/code> -- Display the title for the pages or posts<\/li>\nexcerpt<\/code> -- Display the child page's \"manual excerpt\" (see FAQ)<\/li>\nsiblings<\/code> -- Display siblings (other children) of the current\npage<\/li>\nfamily<\/code> -- Display all children, grandchildren, etc. of page<\/li>\nself<\/code> -- Include the current page (with siblings, or family)\n(normally the current page or post is excluded)<\/li>\nimage<\/code> -- For posts, link to full-size of thumbnail instead of\nto post itself<\/li>\npage<\/code> -- For attachments, link to attachment page<\/li>\nnolink<\/code> -- Disables links entirely The above parameters may be\npreced by 'no' to disable the feature (as when set by default or\nin the plugin options page).<\/li>\n<\/ul>\n\nExample: display=\"list,notitle,thumb,excerpt\"<\/code><\/p><\/li>\ncaption=\"x\"<\/code> Adds a caption to the table. (First table only, see combine<\/code> below)<\/p><\/li>\ncolumns=\"4\"<\/code> Displays 4 columns of images<\/p><\/li>\nsize=\"x\"<\/code> Choose a display size 'x' as:<\/p>\n\n\nthumb<\/code> (or<\/em>: thumbnail<\/code>), medium<\/code>, large<\/code> -- Wordpress standard sizes<\/li>\nsize_small<\/code>, size_med<\/code>, size_large<\/code> -- sizes from AutoNav settings screen<\/li>\n300x200<\/code> -- force images to be resized\/cropped to an exact size<\/li>\nauto<\/code> -- uses settings from autonav control panel<\/li>\n<\/ul>\n\nSizes registered with add_image_size() should also work.<\/p><\/li>\n
titles=\"1\"<\/code> Displays page titles below images if 1 (default: \"0\")\n(same as using title<\/code> parameter to display=<\/code>)<\/p><\/li>\npics_only=\"1\"<\/code> When displaying child pages, only show those with associated images<\/p><\/li>\nids=\"57,65\"<\/code> Selects the attachments with the exactly specified\nattachment IDs. display=<\/code> is assumed to be \"attach\". Works\nsimilarly to WordPress's built-in [gallery] shortcode. orderby=<\/code>\ndefaults to the exact ordering given, but can be overridden.<\/p><\/li>\ninclude=\"1,7\"<\/code> Used with display=\/folder<\/code> syntax only; others, see\npostid parameter. The resulting table will have only two pictures,\nthe first found ending in \"1\" and \"7\" -- note that because both 1\nand 7 are numeric, the image \"pic11.jpg\" would not be included, but\n\"pic1.jpg\" or \"pic01.jpg\" would be. For non-numeric values, the\nfirst found picture whose name ends with the value given will be\nselected.<\/p><\/li>\nexclude=\"3,dessert\"<\/code> Excludes posts\/pages with ID 3 and the slug\n'dessert<\/code>' Note<\/strong>: To include<\/em> posts or pages by category, author,\netc, see the postid<\/code> parameter.<\/p><\/li>\ncombine=\"x\"<\/code> Combines table rows as follows (default: \"all\")<\/p>\n\n\nall<\/code> -- all rows combined into one table<\/li>\nnone<\/code> -- each row a separate table<\/li>\nfull<\/code> -- combine all full rows into one table, with trailing row a separate table (so it can be centered)<\/li>\n<\/ul><\/li>\ncrop=\"1\"<\/code> Crops images to fit exact size, or \"0\" to fit maximum\ninto size, centering image; \"2\" crops from upper-left; \"3\" from top\nmiddle (useful with head-and-shoulders portraits)<\/p><\/li>\nsharp=\"1\"<\/code> Changes downsize algorithm from 'resample' (smooth) to\nthe more blocky 'resize' (see below)<\/p><\/li>\nstart=\"1\"<\/code> Starts at the second image or page (counting from zero)<\/p><\/li>\ncount=\"2\"<\/code> Includes only two images or pages<\/p><\/li>\npaged=\"12\"<\/code> Displays 12 images on one 'page' along with next\/prev,\nand page numbers. Note<\/strong>: 'start' and 'count' are applied first to\ntrim which images are included in those displayed and paged.<\/p><\/li>\norder=\"desc\"<\/code> Sort order: \"asc<\/code>\" ascending, \"desc<\/code>\" descending, \"rand<\/code>\" random.\nSee the<\/p><\/li>\norderby=\"x\"<\/code> Where 'x' is any orderby parameter (e.g., date<\/code>, title<\/code>) from the\ncodex<\/a>\nor one of:<\/p>\n\n\npostmash<\/code> -- use order defined by PostMash plugin<\/li>\nmeta:subpage_title<\/code> -- sorts by any custom field; here we sort\nby the child page's title as overridden by the subpage_title\ncustom field (see FAQ section)<\/li>\n<\/ul>\n\nThe orderby parameter is not used when displaying attachments or\nimages from a directory.<\/p><\/li>\n
imgrel=\"lightbox\"<\/code> Sets the relation tag of the created links as:\n <\/a><\/p><\/li>\ngroup=\"vacation1\"<\/code> When combined with imgrel=\"lightbox*\"<\/code> this\nsets the relation tag to be: rel=\"lightbox[vacation1]<\/code><\/p><\/li>\npostid=\"123\"<\/code> Displays images or subpages attached to the page(s)\nor post(s) with the given ID, or comma-delimited list of IDs,\ninstead of the current page or post. Can also select posts in\ncategory\/tag\/author; or pages with specified path, author or custom\nfield value.<\/p>\n\nIn addition to a numeric postid, you may select posts or pages<\/strong>\nas follows:<\/p>\n\n\npostid=\"cat:17\"<\/code> posts in a numeric category or categories<\/li>\npostid=\"category:17\"<\/code> (same, 'cat' is abbreviation)<\/li>\npostid=\"category:-17\"<\/code> posts not<\/em> in a numeric category<\/li>\npostid=\"category:cakes\"<\/code> posts by category name<\/li>\npostid=\"category__in:cakes,cookies\"<\/code> posts in any of the listed categories<\/li>\npostid=\"category__and:cakes,chocolate\"<\/code> posts that must be in both\ncategories<\/li>\npostid=\"category__not_in:cakes,chocolate\"<\/code> posts not one or more categories<\/li>\npostid=\"category:*\"<\/code> posts in the same category as the current post\/page<\/li>\npostid=\"tag:37,38,53\"<\/code> posts with numerically specified tag(s)<\/li>\npostid=\"tag:chocolate\"<\/code> posts by tag name<\/li>\npostid=\"tag__and:chocolate,hot\"<\/code> posts that have both tags<\/li>\npostid=\"author:27\"<\/code> posts or child pages with a specific author\nby ID,<\/li>\npostid=\"author:Todd\"<\/code> ...by author name,<\/li>\npostid=\"author:*\"<\/code> ...by same author as current post or page.<\/li>\npostid=\"status:future\"<\/code> future posts or pages. see<\/em> list in the\ncodex<\/a>\n status=* for same status as current post\/page.\nCan also use custom status types.<\/li>\npostid=\"movies:comedy\"<\/code> posts tagged in a custom taxonomy<\/li>\npostid=\"movies:drama,horror\"<\/code> posts with any of those tags in\ncustom taxonomy (if 'movies' taxonomy is defined) or with\ncustom field<\/li>\npostid=\"month:january\"<\/code> subpages of current page, with custom\nfield \"month\"=\"january\" Note<\/strong>: selection of Pages by taxonomy<\/em> not\nyet supported<\/li>\npostid=\"recipes\/desserts\"<\/code> page by its full path (NOT merely its slug)<\/li>\n<\/ul><\/li>\n<\/ul>\n\nYou can specify both a page\/post ID and<\/em> one of the above. For example,\npostid=\"27,author:Todd\" would show subpages of the page with ID=27 that have\nauthor Todd.<\/p>\n\nNote that any of several plugins, like this\none<\/a>,\nmust be used to associate a category with a page. Once you have done\nso, you can for example, create a page for each of your categories\nwhich will display a list of the most recent posts in \"its\" category:<\/p>\n\n[autonav display=\"posts,nothumb,title,list\" postid=\"category:*\"]\n<\/code><\/pre>\n\nYou could also display a list of all the most recent posts not<\/em> in\nthe page's category:<\/p>\n\n[autonav display=\"posts,nothumb,title,list\" postid=\"category__not_in:*\"]\n<\/code><\/pre>\n\nThe postid selectors category__and, category__in, category__not_in\npermit more complex category selection, as described in the\ncodex<\/a>.<\/p>\n\nYou may also select attachments<\/strong> based on their parent (given by\nslug or post-ID), their author (which WordPress sets when the\nattachment is uploaded; there is no built-in way to edit an\nattachment's author, although a plugin may provide one), by status<\/code>\nor by the categories or tags set through the Media Tags\nplugin<\/a> or the\nAttachment Taxonomy\nplugin<\/a>:<\/p>\n\n[autonav display=\"attached\" postid=\"recipes,tag:dessert\"]\n<\/code><\/pre>\n\nwould display images, attached to the recipes page, having the\nattachment tag \"dessert\".<\/p>\n\n
It is even possible to display attachments having a certain tag or\ncategory from all<\/em> posts and pages, a special case of postid=\"-1\"<\/code>:<\/p>\n\n[autonav display=\"attached\" postid=\"-1,tag:dessert\"]\n<\/code><\/pre>\n\nNote<\/strong> that you must set the taxonomies on the AutoNav settings\npage. For Media Tags, use attachment tag, \"media-tags<\/code>\"; for the\nAttachment Taxonomy plugin, use \"attachment_tag<\/code>\" and\n\"attachment_category<\/code>\". Other taxonomy names are permissible in hopes\nof being compatible with future WP versions.<\/p>\n\nNOTE: The Sharp parameter is now regarded only by an optional\naddon. Additional example values are:<\/p>\n\n
\n- 0 -- standard smooth resample<\/li>\n
- 1 -- standard blocky resize<\/li>\n
- 60 -- resize, with 60% image quality on JPEG save<\/li>\n
- 95.75 -- intermediate image resized down by 75%, then resampled\n to final giving a \"75% sharpness\" factor, then saved with\n 95% image quality<\/li>\n
- 90.50 -- \"50% sharpness\" and 90% image quality<\/li>\n
- -60 -- resampled, and saved with 60% image quality<\/li>\n<\/ul>\n\n
Development Notes<\/h3>\n\n\n- [Note 20120111] Other filetypes handled in get_images_from_folder()\nmust take care to let actual images take priority regardless of\nwhich appears first in directory. The switch statement will need to\ntake this into account.<\/li>\n<\/ul>\n\n\n
This section describes how to install the plugin and get it working.<\/p>\n\n
\n- Create the autonav-wl directory in the
\/wp-content\/plugins\/<\/code> directory,\nand place the plugin files there.<\/li>\n- Activate the plugin through the administration menus in Wordpress.<\/li>\n
- Configure the plugin under Settings in the Wordpress administration menu.<\/li>\n<\/ol>\n\n
Additional add-ons, which are plugins that tie into AutoNav's filters,\nare in the addons.zip file. (The additional complication of this zip\nwithin a zip is because WordPress's plugin system has no way to handle\n\"optional but part of the distribution\" plugins).<\/p>\n\n
How to use the addons<\/h4>\n\n
In your AutoNav plugin's directory you should find a file, addons.zip\nwhich contains several add-on plugins in a subdirectory. Move only\nthe files you wish to use, into the same directory as the\nautonav-wl.php file itself. Then enable whichever addons you wish.<\/p>\n\n\n
\n- How is a Child Page's \"Associated Image\" determined?<\/dt>\n
AutoNav uses the first of these that exist, as the associated picture\nfor a child page:<\/p>\n\n
\n