xemlock / wp-post-thumbnail-endpoint
一个WordPress插件,提供通过对应文章ID访问文章缩略图的特殊URL
This package is auto-updated.
Last update: 2024-09-10 06:53:38 UTC
README
此WordPress插件提供了一个仅依赖于文章ID的特殊URL,当访问时,会重定向到对应ID的文章缩略图(也称为特色图片)。
这在实现仅基于文章ID显示文章缩略图客户端JavaScript功能(在主题或插件中)时特别有用,而无需发送额外的AJAX请求。
安装
将插件目录放置在WordPress安装目录下的wp-content/plugins
中。然后转到插件管理屏幕并激活插件。
您还可以直接将主插件文件plugin.php
包含到您自己的插件或主题中。只要引用它的插件或主题保持活动状态,此插件就会保持激活状态。
用法
文章缩略图URL
插件安装后,可以通过以下URL访问文章缩略图
/index.php?post_thumbnail=POST_ID
如果启用了美观的永久链接,则通过
/post_thumbnail/POST_ID
您可以在URL中指定文章缩略图大小,通过在原始URL中添加size
查询变量
/index.php?post_thumbnail=POST_ID&size=SIZE
或将它附加到美观的URL
/post_thumbnail/POST_ID/SIZE
URL中提供的尺寸必须是已注册的缩略图尺寸名称,即内置尺寸("thumbnail","medium","large"和"full")或通过add_image_size()
显式添加的尺寸。未识别的尺寸名称将被忽略,这将导致重定向到原始(未调整大小)的图片。
函数
插件提供了两个函数来构建统一的文章缩略图URL
-
get_post_thumbnail_endpoint_structure()
该函数返回统一URL的当前结构,其中
post_id
和size
参数分别作为%post_id%
和%size%
给出。这可以用作客户端的URL模板。 -
get_post_thumbnail_endpoint( $post_id [, $size ] )
该函数返回给定文章ID和可选缩略图大小的统一文章缩略图URL
免责声明
此插件旨在供主题/插件开发者使用,而不是最终用户,因为它为后者不提供任何可用的功能。