xemlock/wp-post-thumbnail-endpoint

一个WordPress插件,提供通过对应文章ID访问文章缩略图的特殊URL

v0.1.0 2015-09-26 20:16 UTC

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_idsize参数分别作为%post_id%%size%给出。这可以用作客户端的URL模板。

  • get_post_thumbnail_endpoint( $post_id [, $size ] )

    该函数返回给定文章ID和可选缩略图大小的统一文章缩略图URL

免责声明

此插件旨在供主题/插件开发者使用,而不是最终用户,因为它为后者不提供任何可用的功能。