WordPress文章配图插件使用教程

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

如果正在使用文章配图插件的版本低于0.0.6,安装0.0.6版本的文章配图需要卸载旧版本的插件,方可正常使用。卸载前请备份重要数据!

配图方式 & 缩略图模式

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

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

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

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

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

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

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

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

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

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

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

背景颜色|文字颜色

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

参考设置:

#1B9BE3|#ffffff
#2561A6|#ffffff
#12A696|#ffffff
#277FD6|#ffffff
#05C160|#ffffff
#FB9E3E|#ffffff
#FE3019|#ffffff
#FE6A00|#ffffff
#01B6FD|#ffffff
#1678FF|#ffffff
#00AEC3|#ffffff
#5b8982|#ffffff
#45545f|#cec6b6
#d47655|#e1f8e1
#7379b0|#c6edec
#ffffd2|#344986
#344986|#ffffd2
#f8fe85|#344986
#344986|#f8fe85
#344986|#f7ec77
#f7ec77|#344986
#344986|#abf2fb
#abf2fb|#344986
#a8d8ea|#344986
#344986|#a8d8ea
#5be7a9|#344986
#344986|#5be7a9
#fcbad3|#344986
#344986|#fcbad3
#ffbd67|#344986
#344986|#ffbd67
#ffffd2|#876464
#876464|#ffffd2
#f8fe85|#876464
#876464|#f8fe85
#ffffd2|#3576a7
#3576a7|#ffffd2
#4ec9df|#344986
#344986|#4ec9df
#344986|#f1a3c5
#f1a3c5|#344986
#f8fe85|#3576a7
#3576a7|#f8fe85
#f7ec77|#876464
#876464|#f7ec77
#876464|#abf2fb
#abf2fb|#876464
#344986|#ed9f66
#ed9f66|#344986
#ffffd2|#da5151
#da5151|#ffffd2
#3576a7|#f7ec77
#f7ec77|#3576a7
#3576a7|#abf2fb
#abf2fb|#3576a7
#ffffd2|#a964cd
#a964cd|#ffffd2
#f8fe85|#da5151
#da5151|#f8fe85
#f8fe85|#a964cd
#a964cd|#f8fe85
#a8d8ea|#876464
#876464|#a8d8ea
#5be7a9|#876464
#876464|#5be7a9
#aa96da|#344986
#344986|#aa96da
#f7ec77|#da5151
#da5151|#f7ec77
#fcbad3|#876464
#876464|#fcbad3
#344986|#b589ef
#b589ef|#344986
#da5151|#abf2fb
#abf2fb|#da5151
#ffbd67|#876464
#876464|#ffbd67
#f7ec77|#a964cd
#63a1d0|#344986
#a964cd|#f7ec77
#344986|#63a1d0
#abf2fb|#a964cd
#a964cd|#abf2fb
#a8d8ea|#3576a7
#3576a7|#a8d8ea
#5be7a9|#3576a7
#3576a7|#5be7a9
#fcbad3|#3576a7
#ff6464|#344986
#3576a7|#fcbad3
#344986|#ff6464
#ffbd67|#3576a7
#3576a7|#ffbd67
#ffffd2|#ff6464
#ff6464|#ffffd2
#ff6464|#f8fe85
#f8fe85|#ff6464
#876464|#4ec9df
#4ec9df|#876464
#f1a3c5|#876464
#876464|#f1a3c5
#ffffd2|#63a1d0
#a8d8ea|#da5151
#63a1d0|#ffffd2
#ffffd2|#b589ef
#da5151|#a8d8ea
#b589ef|#ffffd2
#f8fe85|#63a1d0
#da5151|#5be7a9
#63a1d0|#f8fe85
#5be7a9|#da5151
#aa96da|#ffffd2
#ffffd2|#aa96da
#fcbad3|#da5151
#da5151|#fcbad3
#a8d8ea|#a964cd
#a964cd|#a8d8ea
#b589ef|#f8fe85
#f8fe85|#b589ef
#5be7a9|#a964cd
#ffbd67|#da5151
#a964cd|#5be7a9
#da5151|#ffbd67
#aa96da|#f8fe85
#4ec9df|#3576a7
#f8fe85|#aa96da
#3576a7|#f1a3c5
#3576a7|#4ec9df
#ed9f66|#876464
#876464|#ed9f66
#fcbad3|#a964cd
#f1a3c5|#3576a7
#a964cd|#fcbad3
#f7ec77|#ff6464
#ff6464|#f7ec77
#ffbd67|#a964cd
#3576a7|#ff6464
#ff6464|#3576a7
#63a1d0|#ffbd67
#ed9f66|#abf2fb
#ed9f66|#f7ec77
#876464|#ff6464
#b589ef|#abf2fb
#ed9f66|#3576a7
#abf2fb|#ff6464
#a964cd|#ffbd67

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

图片链接地址伪静态

如果设置了此项,则需要修改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

背景图片文件夹

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

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

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

本地图片文件夹

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

如果想要不同的分类使用不同的图片,需要在设置的文件夹下新建名称为分类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

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

图片关键词

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

自动生成缩略图

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。

内容里添加图片

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

是否解析内容中的简码

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

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

内容图片来源

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

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

本地图片文件夹

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

如果想要不同的分类使用不同的图片,需要在设置的文件夹下新建名称为分类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>

将图片永久更新至内容里

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

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

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

插件执行优先级

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