README

显示帖子、自定义帖子类型或置顶帖子的终极小部件，具有一系列选项来自定义显示。

为普通用户和开发者设计，Ultimate Posts Widgets 致力于在您的侧边栏区域内灵活方便地显示任何类型的帖子。提供一系列小部件选项、钩子、过滤器以及自定义模板，以便进行更高级的自定义。

选项

按分类筛选
按当前分类筛选
按标签筛选
按当前标签筛选
按自定义帖子类型筛选
按置顶帖子筛选
选择要显示的帖子数量
显示标题
以自定义格式显示发布日期/时间
显示帖子作者和链接
显示帖子评论数
显示摘要或全文
显示“阅读更多”链接，并自定义标签
显示特色图像，并可选择任何大小
显示帖子分类
显示帖子标签
显示自定义字段
在帖子列表前后添加文本或HTML
向小部件添加CSS类
添加小部件标题链接
更改摘要长度（以单词计）
按日期、标题、评论数、随机或自定义字段排序

支持

喜欢这个插件？发送一个提示以支持开发。

常见问题解答

过滤器

upw_enqueue_styles (布尔值) 允许更改是否加载模板CSS文件。

upw_wp_query_args (数组) 允许更改小部件的WP_Query参数。

upw_custom_template_path (字符串) 允许更改默认自定义模板路径。

模板

legacy 自2.0.0版本起，我们更改了小部件HTML标记。对于2.0.0之前的安装，您可以使用旧模板以保留旧HTML标记和兼容性。

standard 自2.0.0版本起的新标准模板。它具有更好的HTML5标记，在各种主题上的样式改进，无需自定义CSS，以及hfeed微格式。

custom 自2.0.0版本起，您现在可以提供自己的自定义模板文件。为此，在您的主题中创建一个名为upw的目录，并从插件的templates目录中复制一个模板。根据需要编辑。

然后，在“显示”标签页下的小工具设置中，从“模板”下拉菜单中选择“自定义”。在出现的“自定义模板名称”字段中，输入你的模板文件名（不包括.php）。例如，如果你的模板命名为custom.php，则在“自定义模板名称”字段中输入custom。

图片大小

从版本2.0.0开始，插件不再支持从小工具选项面板设置自定义图片大小。

要更改图片大小，你可以编辑内置的大小（缩略图、中等和大型），或者在你的主题的functions.php文件中定义一个自定义图片大小。

编辑内置图片大小：转到设置 > 媒体，并根据需要更改图片大小。一旦图片大小更改，你需要重新生成缩略图以更新现有图片。这可以通过AJAX Thumbnail Rebuild或Regenerate Thumbnails插件来完成。注意，这将影响整个站点的图片大小。

定义自定义图片大小：编辑你的functions.php文件，并使用add_image_size函数添加一个新的图片大小。请参阅WordPress codex文档。一旦添加了函数，你的自定义大小将可在小工具选项中选择。像编辑内置大小一样，你需要为现有图片重新生成缩略图。

示例

<?php add_image_size( 'my-custom-size', 800, 600, false ); ?>

缩略图不显示

从版本2.0.0开始，timthumb不再使用。

此插件使用timthumb库来调整文章缩略图的大小。如果你在显示缩略图时遇到问题，请查看这些要求和故障排除技巧。

右键单击 > 查看图片 - 如果图片没有加载，你应该首先这样做。90%的情况下，它会以易于阅读的错误消息告诉你问题所在。
JetPack插件 - 已知JetPack的“Photon”组件存在冲突，请禁用它以兼容timthumb。
服务器要求 - PHP和GD图像库必须安装在您的Web服务器上。通常，大多数Web服务器默认包括它们。
缓存权限 - 缓存目录wp-content/plugins/ultimate-posts-widget/cache应设置为777，如果不起作用，则可能755也可以。
图片大小 - timthumb配置为仅适用于小于1500 x 1500的图片。如果图片大于1500 x 1500，插件将自动从“设置 > 媒体”中选择“大型”大小，你需要减小图片大小或修改thumb.php中的配置以支持更大的图片大小。
URL中的波浪号(~) - timthumb存在已知问题，请在修复之前使用不带波浪号的URL。错误报告
缩略图仅与WordPress的内置文章缩略图/特色图片一起工作。许多主题使用自定义图片字段作为缩略图，这些不被支持。

仍然卡住了？请参阅timthumb作者提供的其他故障排除技巧。

屏幕截图

使用TwentyTwelve主题和默认小工具选项的示例
常规选项标签页
显示选项标签页
过滤器选项标签页
排序选项标签页

变更日志

2.0.8

向小工具实例添加过滤器（感谢@X-Raym）
将当前标签和类别的帖子显示到页面中（感谢 @veracompadriatics）

2.0.7

测试更新 WordPress 4.8

2.0.6

修复 PHP 通知（感谢 @rhyswynne）
在子主题和父主题中搜索自定义模板（感谢 @groucho75）

2.0.5

添加菜单顺序排序选项

2.0.4

更新类构造函数以兼容 WordPress 4.3（感谢 @JustB）

2.0.3

添加缩略图链接
添加显示所有分类、标签或类型的选项，以提高可用性
改进某些主题的标准模板的间距和字体大小
记录添加自定义图像大小
添加显示完整尺寸帖子缩略图的选项
从遗留模板中删除 post_class() 以提高向后兼容性

2.0.2

恢复使用 widget_title 过滤器
修复帖子数量设置，以允许无限数量
添加实例和小工具 ID 变量到过滤器以进行更多控制

2.0.1

修复在同一页面上加载多个小工具并使用相同模板的问题
为新实例添加默认标题
改进文档

2.0.0

添加新的标准模板和自定义模板支持
添加基本的 CSS 样式以更好地格式化
在新标准模板中添加 hfeed 微格式
改进小工具选项界面
添加按标签或当前标签过滤的选项
为了使用内置的 WordPress 图像大小，移除 timthumb
移除“更多按钮”小工具选项
更改日期显示选项，现在可以接受任何自定义日期格式
添加帖子前后 HTML 字段
添加小工具 CSS 类选项（感谢 @avenirer）
添加显示评论计数的选项
为新创建的小工具设置更好的默认值
各种错误修复和优化

从早期版本升级吗？

从 2.0.0 之前的版本升级，我们将保留“遗留”模板供您使用。要更改要使用的模板，请转到“显示”选项卡下的“模板”选项。
如果您使用了“更多按钮”，则需要将您自己的 HTML 添加到新字段之一，因为更多按钮现在已经删除。
如果您使用了自定义缩略图设置，则需要更新它们。现在您可以选择 WordPress 可用的预定义大小。如果您需要额外的图像大小，请参阅如何添加图像大小。
日期格式已更改，您需要更新您的设置。默认情况下，它使用 WordPress 的日期/时间选项。

1.9.0

添加按自定义字段排序的选项（感谢 @enekochan）
从链接标题中删除“永久链接到：”（感谢 @wirelessgizmo）
瑞典翻译（感谢 @brstp）

1.8.1

添加内容显示选项

1.8

添加自定义字段显示
重新组织小工具选项
为图像缩略图使用合适的 alt 标签
改进链接的标题属性

1.7

添加显示作者选项
添加用于突出显示当前帖子的类
修复 PHP 错误通知

1.6

添加本地化支持
添加显示帖子分类选项
添加显示帖子标签选项
添加自定义小工具标题 URL 选项
改进固定帖子过滤器控制
错误修复

###1.5.1

升级 timthumb 到 2.8.11
加载“大”尺寸的帖子缩略图，这应该可以消除大图像错误
改进缩略图故障排除的 FAQ

1.5

添加裁剪模式选项
添加显示发布时间选项
现在使用日期/时间格式设置
错误修复

1.4.5

更新截图

1.4.4

修复 show_readmore 函数
添加更多按钮链接选项

1.4

更干净的小工具选项
代码重构和修复
添加排序选项

1.3

固定帖子现在为可选

1.2

添加帖子类型过滤器选项。
代码清理。
改进分类的选择机制。

1.1

添加分类过滤器选项。

1.0

第一个版本。

升级通知

2.0.0

这是一个主要更新，包括一些破坏性更改。已引入了新模板，一些字段已更改，缩略图已修改。请参阅变更日志以获取详细信息。

安装

下载并解压zip压缩包
将ultimate-posts-widget文件夹上传到/wp-content/plugins/
通过WordPress的“插件”菜单激活该插件
将小工具添加到侧边栏并按需配置选项

关于

由Boston Dell-Vandenberg用爱心制作。

bostondv / ultimate-posts-widget

维护者

详细信息

README

选项

更多信息

支持

常见问题解答

过滤器

模板

图片大小

缩略图不显示

屏幕截图

变更日志

2.0.8

2.0.7

2.0.6

2.0.5

2.0.4

2.0.3

2.0.2

2.0.1

2.0.0

1.9.0

1.8.1

1.8

1.7

1.6

1.5

1.4.5

1.4.4

1.4

1.3

1.2

1.1

1.0

升级通知

2.0.0

安装

关于