插件下载地址: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>
将图片永久更新至内容里
设置为是后,插件生成的图片将会更新到内容里永久保存。
在调试文章图片时,请将此选项设置为否。否则,错误的图片将会永久保存至内容里。
只有确定生成的图片没问题,才可以将此选项启用。
插件执行优先级
某些插件或主题拥有较高的执行优先级,可以通过设置优先级增加文章配图成功率。