WordPress文章配图插件使用教程

插件下载地址：https://www.ggdoc.cn/plugin/3.html

配图方式

支持5种配图方式：背景颜色、背景图片、本地图片、媒体库图片、Pixabay图片。

背景颜色：使用纯色背景颜色生成缩略图图片。

背景图片：使用指定文件夹下的图片生成缩略图图片。

本地图片：使用指定文件夹下的图片生成缩略图图片。

媒体库图片：使用媒体库中的图片生成缩略图图片。

Pixabay图片：使用Pixabay网站上的图片生成缩略图图片。

背景图片与本地图片的区别：背景图片可以添加文章标题文字，而本地图片不可以添加文章标题文字。

缩略图模式

支持3种缩略图模式：动态生成、仅保存文件、保存至媒体库。

当缩略图模式为动态生成时：不生成缩略图本地图片文件。当配图方式为背景颜色、背景图片时，每次都需要动态生成缩略图。其它配图方式则会直接读取图片链接，不会动态生成缩略图。请注意：当配图方式为Pixabay图片时，此选项仅供测试，因为Pixabay图片返回的链接是临时链接，不可以永久使用。

当缩略图模式为仅保存文件时：当配图方式为背景颜色、背景图片、Pixabay图片时，会生成缩略图本地图片文件。其它配图方式则会直接读取图片链接，不会生成缩略图本地图片文件。

当缩略图模式为保存至媒体库时：无论哪种配图方式，都会生成缩略图本地图片文件，并将图片添加至媒体库。

注意：如果主题不支持动态生成、仅保存文件这2种模式，网站上的缩略图都会显示同一张图片，这个图片其实为插件生成的底图。这种情况下，请将缩略图模式改为保存至媒体库试试。

背景颜色|文字颜色

每行一个设置，每个设置可以使用|分隔背景颜色和文字颜色。如果设置只包含一种颜色，则会使用默认的文字颜色。

参考设置：

#1B9BE3|#ffffff
#2561A6|#ffffff
#12A696|#ffffff
#277FD6|#ffffff
#05C160|#ffffff
#FE3019|#ffffff
#1678FF|#ffffff
#5b8982|#ffffff
#d47655|#e1f8e1
#7379b0|#c6edec
#344986|#ffffd2
#344986|#f7ec77
#344986|#abf2fb
#344986|#a8d8ea
#344986|#fcbad3
#344986|#ffbd67
#876464|#f8fe85
#876464|#abf2fb
#344986|#ed9f66
#da5151|#ffffd2
#a964cd|#ffffd2
#da5151|#f8fe85
#a964cd|#f8fe85
#a964cd|#f7ec77
#3576a7|#f1a3c5

使用背景颜色生成缩略图，此选项必须需要设置。

图片链接地址伪静态

如果设置了此项，则需要修改Nginx或者Apache伪静态配置。

设置中需要确保含有{id}，这个是用来携带文章ID的配置。

假如设置为：/images/{id}.png

则NGINX需要添加如下设置：

if (!-e $request_filename) {
    rewrite ^/images/(\d+)\.png$ /wp-admin/admin-ajax.php?action=awpimage&post_id=$1 last;
    break;
}

上面设置完后，生成的缩略图图片的链接地址为：https://www.ggdoc.cn/images/4051.png

如果不设置这个选项，生成的缩略图图片的链接地址为：https://www.ggdoc.cn/wp-admin/admin-ajax.php?action=awpimage&post_id=4051

背景图片文件夹

使用背景图片生成缩略图，需要将图片上传至设置的文件夹内。

这个文件夹必须位于网站文件夹下，例如：

网站文件夹为：C:\dev\project\wordpress\wordpress_vip

那么此设置的文件夹可以设置为：

C:\dev\project\wordpress\wordpress_vip\images

C:\dev\project\wordpress\wordpress_vip\wp-content\uploads\local

简单来说，就是设置的文件夹必须在网站文件夹下，同时确保插件有权限读写这个文件夹。

不可以设置为：

C:\dev\project\wordpress\wordpress_ggdoc\images

C:\dev\nginx\html\wordpress

如果想要不同的分类使用不同的图片，需要在设置的文件夹下新建名称为分类ID的文件夹，然后手动将图片上传至此文件夹下。

例如：选项设置为/www/wwwroot/ggdoc/wp-content/plugins/article-with-pictures/images，未分类的ID为1，则可以将图片上传至/www/wwwroot/ggdoc/wp-content/plugins/article-with-pictures/images/1目录下，这样未分类的文章将会优先读取此目录下的图片。

本地图片文件夹

使用本地图片生成缩略图，需要将图片上传至设置的文件夹内。

这个文件夹必须位于网站文件夹下，例如：

网站文件夹为：C:\dev\project\wordpress\wordpress_vip

那么此设置的文件夹可以设置为：

C:\dev\project\wordpress\wordpress_vip\images

C:\dev\project\wordpress\wordpress_vip\wp-content\uploads\local

简单来说，就是设置的文件夹必须在网站文件夹下，同时确保插件有权限读写这个文件夹。

不可以设置为：

C:\dev\project\wordpress\wordpress_ggdoc\images

C:\dev\nginx\html\wordpress

如果想要不同的分类使用不同的图片，需要在设置的文件夹下新建名称为分类ID的文件夹，然后手动将图片上传至此文件夹下。

例如：选项设置为/www/wwwroot/ggdoc/wp-content/plugins/article-with-pictures/images，未分类的ID为1，则可以将图片上传至/www/wwwroot/ggdoc/wp-content/plugins/article-with-pictures/images/1目录下，这样未分类的文章将会优先读取此目录下的图片。

Pixabay API key

请按照提示申请，然后在文档页面中可以找到。

图片关键词

获取图片关键词，多个关键词使用,分开。例如：风景,自然,动物。

数据缓存时间（秒）

在数据缓存时间内，如果获取的图片数据未使用完，插件是不会请求接口获取新的图片数据。

注意：Pixabay图片返回的链接是临时链接（这个链接多久过期？Pixabay网站上并未说明），会在一定时间内过期，导致图片链接无法访问。上面设置的数据缓存时间应该要小于这个时间。

自动生成缩略图

2种方式：显示内容前、发布/更新内容后。

如果网站无法生成缩略图，请勾选显示内容前。

默认缩略图

填写默认缩略图图片地址。

当缩略图生成失败，使用设置的图片作为缩略图。

优先提取内容里的图片生成缩略图

如果文章内容里有图片，会优先使用文章内容里的图片生成缩略图。在某些配图方式和缩略图模式下，可能无法提取第三方图片链接生成缩略图。

开启页面配图

除了文章可以使用，新版插件页面也可以使用。

显示分类设置数量

如果有些分类在设置中没有显示，可调整此数量。

分类

指定分类下的文章使用文章配图。如果不设置，则全部文章都使用文章配图。

缩略图宽度

文章列表页面中的缩略图宽度。尽量与主题显示的缩略图宽度一致。必须需要设置。

缩略图高度

文章列表页面中的缩略图高度。需要与主题显示的缩略图高度一致。必须需要设置。

是否自动更新缩略图

当设置、标题变化后或者缩略图不存在时，自动重新生成缩略图。

缩略图默认背景颜色

例如：#dda0dd。如果不设置，图片生成失败会生成默认黑色背景的图片。

缩略图文件名称

32位加密字符串：生成32位加密字符串的图片文件名。

文章ID：以当前文章ID作为图片文件名。

文章标题：以当前文章标题作为图片文件名。如果不是必要，请不要用此选项。

缩略图文件格式

图片格式，支持png、bmp、jpeg、jpg、webp 5种格式选择。

图片背景虚化

如果图片上要添加文字，可以设置此选项。插件会将图片虚化后，然后添加文字，这样文字看起来就比较清晰。

设置页面采用的是rgba来设置，其参数如下：

rgba() 函数使用红(R)、绿(G)、蓝(B)、透明度(A)的叠加来生成各式各样的颜色。

RGBA 即红色、绿色、蓝色、透明度（英语：Red, Green, Blue、Alpha）。

红色（R）0 到 255 间的整数，代表颜色中的红色成分。。
绿色（G）0 到 255 间的整数，代表颜色中的绿色成分。
蓝色（B）0 到 255 间的整数，代表颜色中的蓝色成分。
透明度（A）取值 0~1 之间， 代表透明度。

推荐将图片虚化的值设置为：rgba(0, 0, 0, 0.75)，那么文字的颜色应该设置为白色：#FFFFFF。这样设置将会产生灰底白字的效果。

在缩略图上添加标题文字

启用后，将会在缩略图上添加文章标题文字。

缩略图标题文字字体

请下载免费可商用的中文字体文件（后缀为ttf文件）。下载后，将字体文件上传至/wp-content/plugins/article-with-pictures/fonts目录下。注意：字体文件的名称不能有空格等特殊符号，建议使用拼音重新命名字体文件，例如：ziti1.ttf、ziti2.ttf。中文字体文件的大小一般在5兆左右，低于1兆的字体文件可能无法使用。

缩略图标题文字颜色

例如：#000000。

缩略图标题文字大小

例如：16。

缩略图标题文字单行显示

文字是否在缩略图上显示一行，如果设置为否，则会在缩略图上显示多行文字。

缩略图标题每行文字个数限制

多行文字显示时，可以限制行数，例如：3。

缩略图标题每行文字个数限制

缩略图上每行最多显示的文字个数，超过设置则会截取。默认每行文字个数减3。

内容里添加图片

如果文章内容没有图片，可以设置此选项，在内容里显示缩略图或者本地图片。

是否解析内容中的简码

如果内容中含有简码，请根据实际情况设置。

特别提示：如果开启了将图片永久更新至内容里此选项，可能导致内容中的简码覆盖。

内容图片来源

缩略图：直接将缩略图添加到文章内容里。

本地图片：将指定文件夹下的图片添加到文章内容里。

本地图片文件夹

将图片上传至设置的文件夹内即可。

这个文件夹必须位于网站文件夹下，例如：

网站文件夹为：C:\dev\project\wordpress\wordpress_vip

那么此设置的文件夹可以设置为：

C:\dev\project\wordpress\wordpress_vip\images

C:\dev\project\wordpress\wordpress_vip\wp-content\uploads\local

简单来说，就是设置的文件夹必须在网站文件夹下，同时确保插件有权限读写这个文件夹。

不可以设置为：

C:\dev\project\wordpress\wordpress_ggdoc\images

C:\dev\nginx\html\wordpress

如果想要不同的分类使用不同的图片，需要在设置的文件夹下新建名称为分类ID的文件夹，然后手动将图片上传至此文件夹下。

例如：选项设置为/www/wwwroot/ggdoc/wp-content/plugins/article-with-pictures/images，未分类的ID为1，则可以将图片上传至/www/wwwroot/ggdoc/wp-content/plugins/article-with-pictures/images/1目录下，这样未分类的文章将会优先读取此目录下的图片。

内容图片代码模板

可使用{img}替换缩略图（或者本地图片）img标签完整内容，默认为：

<figure class="wp-block-image size-full aligncenter">{img}</figure>

如果想要文章内容图片居中，可以设置为：

<p style="text-align:center;">{img}</p>

生成的内容如下：

<p style="text-align:center;"><img width="480" height="300" src="https://www.ggdoc.cn/wp-admin/admin-ajax.php?action=awpimage&post_id=3336" class="attachment-480x300 size-480x300" alt="高温天气" decoding="async" loading="lazy"></p>

将图片永久更新至内容里

设置为是后，插件生成的图片将会更新到内容里永久保存。

在调试文章图片时，请将此选项设置为否。否则，错误的图片将会永久保存至内容里。

只有确定生成的图片没问题，才可以将此选项启用。

插件执行优先级

某些插件或主题拥有较高的执行优先级，可以通过设置优先级增加文章配图成功率。