[wordpress插件] AutoNav Graphical Navigation and Gallery PluginAutoNav图形导航和图库插件

Auto Graphics Site Navigation with Gallery

带有图库的自动图形站点导航

This plugin simplifies the creation of graphically navigable WordPress

此插件简化了可图形导航的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
  

  WordPress管理页面中的默认设置，或者按
  

  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.

  wp-content / uploads目录下的目录。

  Standard
  

  标准
  

  command-line or FTP tools can then be used to move, rename, or
  

  然后可以使用命令行或FTP工具移动，重命名或
  

  delete images.

删除图像。

• Output and page/post selection is extensible through the use of
  

• 通过使用
  可扩展输出和页面/帖子选择

  filters.

过滤器。

• Works with WordPress’s standard attachment mechanism, and with
  

• 使用WordPress的标准附件机制以及
  

  J. Christopher’s “Attachments” plugin (see FAQ)

J. Christopher的“附件”插件（请参阅常见问题解答）

NOTE: You can raise issues or participate in development at GitHub


注意：您可以在 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:

该插件使用[autonav]短代码调用，有两种基本模式：

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"]
  [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
3或4列，具体取决于缩略图的默认大小和
depending on the column settings in the WordPress administration
取决于WordPress管理中的列设置
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"]
  [autonav display =“ attach”]
 
displays a table of images attached to the current post or page.
显示附在当前帖子或页面上的图像表。
[autonav display="/project2" include="32,37,56"]
  [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.
wp-content / uploads / project2目录，按指定顺序。
[autonav ids="57,65"]
  [autonav ids =“ 57,65”]
 
For compability with the [gallery] ids parameter introduced in
为了与
中引入的[gallery] id参数兼容
WordPress 3.5, displays a table of attachments with the exactly
WordPress 3.5，显示带有准确附件的表格
specified attachment IDs.
指定的附件ID。
Shortcode Parameters
简码参数
Parameters not specified will be taken from the values set in the
未指定的参数将从
中设置的值中获取
WordPress admin panel.
WordPress管理面板。
The optional display parameters should be
可选的显示参数应为
enclosed in the display argument;
包含在display参数中；
for example,
    
例如，
    
[autonav display=”posts,list,thumb,title”]
[autonav display =”帖子，列表，缩略图，标题”] 
display="x"  Displays a list or table, based on “x” as follows:
  display =“ x” 根据“ x”显示列表或表格，如下所示：
images — a table, with one cell for each of the child pages of the current page.
  images  —一个表，当前页面的每个子页面都有一个单元格。
list   — a list, with an entry for each child of the current page
  list  —列表，其中包含当前页面每个子项的条目
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  — postid =””参数中列出的帖子表
posts:TYPE — a table of posts in custom post type TYPE
  posts：TYPE  —自定义帖子类型TYPE的帖子表
/folder — a table of images located in wp-content/uploads/folder
  / folder  —位于wp-content / uploads / folder 中的图像表
Optional parameters, in a comma-separated list:
可选参数，以逗号分隔：
list — Used with display=”posts” for list, not table
  list  —与display =” posts”一起用于列表，而不是表
plain — Replaces unordered-list with a div, for use with
  plain  —用div替换无序列表，用于
JavaScript/jQuery slideshows, etc.
JavaScript / jQuery幻灯片等。
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)
 摘录-显示子页面的“手册摘录”（请参阅​​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)
  self -包括当前页面（带有兄弟姐妹或家人）
(normally the current page or post is excluded)
（通常不包括当前页面或帖子）
image — For posts, link to full-size of thumbnail instead of
  image  —对于帖子，请链接到全尺寸缩略图，而不是
to post itself
发布自己
page — For attachments, link to attachment page
 页面 —对于附件，请链接到附件页面
nolink — Disables links entirely The above parameters may be
  nolink  —完全禁用链接上面的参数可能是
preced by ‘no’ to disable the feature (as when set by default or
以“否”开头以禁用该功能（如默认设置或
in the plugin options page).
在插件选项页面中。）
Example: display="list,notitle,thumb,excerpt"
示例： display =“ list，notitle，thumb，摘录”  
caption="x" Adds a caption to the table.
  caption =“ x” 将标题添加到表中。 
(First table only, see combine below)
（仅第一个表，请参见下面的 combine ）
columns="4"  Displays 4 columns of images
  columns =“ 4” 显示4列图像
size="x"      Choose a display size ‘x’ as:
  size =“ x” 选择显示尺寸“ x”为：
thumb (or: thumbnail), medium, large — WordPress
  thumb （或： thumbnail ），中，大 — WordPress
standard sizes
标准尺寸
size_small, size_med, size_large — sizes from AutoNav settings screen
  size_small ， size_med ， size_large -AutoNav设置屏幕中的尺寸
300x200 — force images to be resized/cropped to an exact size
  300x200  —强制将图像调整大小/裁剪为精确大小
auto — uses settings from autonav control panel
  auto -使用autonav控制面板中的设置
Sizes registered with add_image_size() should also work.
在add_image_size（）中注册的大小也应该起作用。
titles="1" Displays page titles below images if 1 (default: “0”)
  titles =“ 1” 如果为1（默认值：“ 0”），则在图像下方显示页面标题。
(same as using title parameter to display=)
（与在 display = 中使用 title 参数相同）
pics_only="1" When displaying child pages, only show those with associated images
  pics_only =“ 1” 显示子页面时，仅显示具有相关图像的页面
ids="57,65" Selects the attachments with the exactly specified
  ids =“ 57,65” 选择具有完全指定的附件
attachment IDs.
附件ID。 
display= is assumed to be “attach”.
 display = 假定为“附加”。
Works
作品
similarly to WordPress’s built-in [gallery] shortcode.
类似于WordPress的内置[画廊]简码。 
orderby=
 orderby =  
defaults to the exact ordering given, but can be overridden.
默认为给定的确切顺序，但可以覆盖。
include="1,7" Used with display=/folder syntax only;
  include =“ 1,7” 仅用于 display = / folder 语法；
others, see
其他，请参见
postid parameter.
postid参数。
The resulting table will have only two pictures,
结果表将只有两张图片，
the first found ending in “1” and “7” — note that because both 1
第一个以“ 1”和“ 7”结尾的结果-请注意，因为1 
and 7 are numeric, the image “pic11.jpg” would not be included, but
和7是数字，则不包含图片“ pic11.jpg”，但
“pic1.jpg” or “pic01.jpg” would be.
将是“ pic1.jpg”或“ pic01.jpg”。
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
  exclude =“ 3，甜点” 排除ID为3和弹头的帖子/页面
‘dessert‘ Note: To include posts or pages by category, author,
“ 甜点” 注意：要按类别，作者，
 包括个帖子或页面
etc, see the postid parameter.
等等，请参见 postid 参数。
combine="x" Combines table rows as follows (default: “all”)
  combine =“ x” 如下组合表行（默认值：“全部”）
all  — all rows combined into one table
  all  —将所有行合并到一个表中
none — each row a separate table
  none -每行有一个单独的表
full — combine all full rows into one table, with trailing row a separate table (so it can be centered)
  full  —将所有完整的行合并到一个表中，尾随一个单独的表（以便可以居中）
crop="1" Crops images to fit exact size, or “0” to fit maximum
  crop =“ 1” 裁剪图像以适合确切大小，或裁剪“ 0”以适合最大值
into size, centering image;
放入大小，居中图像；
“2” crops from upper-left;
左上角为“ 2”种作物；
“3” from top
顶部的“ 3” 
middle (useful with head-and-shoulders portraits)
中间（适用于头肩肖像）
sharp="1" Changes downsize algorithm from ‘resample’ (smooth) to
  sharp =“ 1” 将尺寸缩小算法从“重新采样”（平滑）更改为
the more blocky ‘resize’ (see below)
更具阻隔性的“调整大小”（见下文）
start="1" Starts at the second image or page (counting from zero)
  start =“ 1” 从第二个图像或页面开始（从零开始计数）
count="2" Includes only two images or pages
  count =“ 2” 仅包含两个图像或页面
paged="12" Displays 12 images on one ‘page’ along with next/prev,
  paged =“ 12” 在一个“页面”上显示12张图像以及下一个/上一个
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
  order =“ desc” 排序顺序：“  asc ”升序，“  desc ”降序，“  rand 
>” random.
>”随机。
See the
见
orderby="x" Where ‘x’ is any orderby parameter (e.g., date, title) from the
  orderby =“ x” 其中“ x”是
中的任何orderby参数（例如， date ， title ）
codex
法典 
or one of:
或以下之一：
postmash — use order defined by PostMash plugin
  postmash -使用PostMash插件定义的顺序
meta:subpage_title — sorts by any custom field;
  meta：subpage_title -按任何自定义字段排序；
here we sort
在这里我们排序
by the child page’s title as overridden by the subpage_title
由子页面的标题（由subpage_title 
覆盖）
custom field (see FAQ section)
自定义字段（请参阅“常见问题”部分）
The orderby parameter is not used when displaying attachments or
显示附件或
时不使用orderby参数
images from a directory.
目录中的图片。
imgrel="lightbox" Sets the relation tag of the created links as:
  
  imgrel =“ lightbox” 将创建的链接的关系标签设置为：
  
  
group="vacation1" When combined with imgrel="lightbox*" this
  group =“ vacation1” 与 imgrel =“ lightbox *” 结合使用时此
sets the relation tag to be: rel="lightbox[vacation1]
将关系标签设置为： rel =“ lightbox [vacation1]  
postid="123" Displays images or subpages attached to the page(s)
  postid =“ 123” 显示附加到页面的图像或子页面
or post(s) with the given ID, or comma-delimited list of IDs,
或具有给定ID的帖子，或以逗号分隔的ID列表，
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
除了数字postid，您还可以选择帖子或页面 
as follows:
如下：
postid="cat:17" posts in a numeric category or categories
一个或多个数字类别中的
  postid =“ cat：17” 帖子
postid="category:17" (same, ‘cat’ is abbreviation)
  postid =“ category：17” （相同，“ cat”是缩写）
postid="category:-17" posts not in a numeric category
  postid =“ category：-17” 在数字类别中发布 not  
postid="category:cakes" posts by category name
  postid =“ category：cakes” 按类别名称发布的帖子
postid="category__in:cakes,cookies" posts in any of the listed categories
列出的任何类别中的
  postid =“ category__in：cakes，cookies” 帖子
postid="category__and:cakes,chocolate" posts that must be in both
  postid =“ category__and：cakes，chocolate” 帖子必须同时在两个帖子中
categories
类别
postid="category__not_in:cakes,chocolate" posts not one or more categories
  postid =“ category__not_in：cakes，chocolate” 发布的不是一个或多个类别
postid="category:*" posts in the same category as the current post/page
与当前帖子/页面相同类别的
  postid =“ category：*” 帖子
postid="tag:37,38,53" posts with numerically specified tag(s)
  postid =“ tag：37,38,53” 带有数字指定标签的帖子
postid="tag:chocolate"  posts by tag name
  postid =“ tag：chocolate” 通过标签名称发帖
postid="tag__and:chocolate,hot" posts that have both tags
带有两个标签的
  postid =“ tag__and：chocolate，hot” 帖子
postid="author:27" posts or child pages with a specific author
  postid =“ author：27” 具有特定作者的帖子或子页面
by ID,
通过ID，
postid="author:Todd" …by author name,
  postid =“ author：Todd” …作者姓名，
postid="author:*" …by same author as current post or page.
  postid =“ author：*” …与当前帖子或页面的作者相同。
postid="status:future" future posts or pages.
  postid =“ status：future” 以后的帖子或页面。 
see list in the

中的请参见列表
codex
  
法典 
  
status=* for same status as current post/page.
status = *，表示与当前帖子/页面相同的状态。
Can also use custom status types.
也可以使用自定义状态类型。
postid="movies:comedy"  posts tagged in a custom taxonomy
在自定义分类法中标记的
  postid =“ movies：comedy” 帖子
postid="movies:drama,horror" posts with any of those tags in
  postid =“ movies：drama，horror” 带有
中任何标签的帖子
custom taxonomy (if ‘movies’ taxonomy is defined) or with
自定义分类法（如果定义了“电影”分类法）或
custom field
自定义字段
postid="month:january" subpages of current page, with custom
当前页面的
  postid =“ month：january” 子页面，具有自定义
field “month”=”january” Note: selection of Pages by taxonomy not
字段“ month” =“ january” 注意：按分类选择的页面不是
yet supported
尚未支持
postid="recipes/desserts" page by its full path (NOT merely its slug)
  postid =“ recipes / desserts” 页面的完整路径（不仅仅是它的子弹）
You can specify both a page/post ID and one of the above.
您可以同时指定页面/帖子ID 和其中之一。
For example,
例如，
postid=”27,author:Todd” would show subpages of the page with ID=27 that have
postid =“ 27，author：Todd”将显示ID = 27的页面子页面，其中
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:*"]
  [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:*"]
  [autonav display =“ posts，nothumb，title，list” postid =“ category__not_in：*”]
 
The postid selectors category__and, category__in, category__not_in
 postid选择器类别__和类别__ in，类别__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
slug或post-ID），作者（WordPress设置
attachment is uploaded;
附件已上传；
there is no built-in way to edit an
没有内置的方式来编辑
attachment’s author, although a plugin may provide one), by status
附件的作者（尽管一个插件可能会提供）），通过 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"]
  [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":
所有帖子和页面中的类别， postid =“-1” 的特殊情况：
[autonav display="attached" postid="-1,tag:dessert"]
  [autonav display =“ attached” postid =“-1，tag：甜点”]
 
Note that you must set the taxonomies on the AutoNav settings
 注意，您必须在AutoNav设置中设置分类法
page.
页。
For Media Tags, use attachment tag, “media-tags“;
对于媒体标签，请使用附件标签“  media-tags ”；
for the
对于
Attachment Taxonomy plugin, use “attachment_tag” and
附件分类法插件，使用“  attachment_tag ”和
“attachment_category“.
“  attachment_category ”。
Other taxonomy names are permissible in hopes
希望使用其他分类法名称
of being compatible with future WP versions.
与将来的WP版本兼容。
NOTE: The Sharp parameter is now regarded only by an optional
注意：Sharp参数现在只能由可选的
使用
addon.
添加在。
Additional example values are:
其他示例值是：
0 — standard smooth resample
 0-标准平滑重采样
1 — standard blocky resize
 1-标准块状调整大小
60 — resize, with 60% image quality on JPEG save
 60 —调整大小，JPEG保存时图像质量达到60％
95.75 — intermediate image resized down by 75%, then resampled
      
 95.75 —将中间图像缩小75％，然后重新采样
      
to final giving a “75% sharpness” factor, then saved with
      
最终给出“ 75％的清晰度”因子，然后保存为
      
95% image quality
95％的图像质量
90.50 — “50% sharpness” and 90% image quality
 90.50 —“ 50％的清晰度”和90％的图像质量
-60 — resampled, and saved with 60% image quality
 -60-重新采样，并以60％的图像质量保存
Development Notes
开发说明
[Note 20120111] Other filetypes handled in get_images_from_folder()
 [Note 20120111]在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
switch语句将需要
take this into account.
考虑到这一点。