您的插件中的 assets 文件夹是用于存储在插件展示页面使用的图像(如插件头部、图标和截图)的位置。
所有文件都应放置到您的 SVN 目录的 assets 目录中,并且适用于您插件的所有版本。这是一个顶级目录,就像 trunk 一样。您不应将截图放置在 trunk/assets 或 tags/1.0/assets 中。
所有图像都通过 CDN 提供并进行了大量缓存,因此当更改或添加时可能需要一些时间才能更新。请在报告其无法工作时,请给代理一些时间来检索您的图像并将其缓存。这通常只需几分钟,但在服务器负载很高时(例如重大 WordPress 版本发布前和期间),6 小时的情况也并非罕见。
默认图像尺寸
图像尺寸应与名称所暗示的尺寸相同。也就是说,banner-772x250.png 应为宽 772 像素、高 250 像素。同样,icon-256x256.png 应为一个 256×256 的正方形。
我们未定义任何新的横幅尺寸,因此请不要试图耍小聪明并重新命名您的图像,以为它们会起作用。它们将根本不会显示。同样,不要使您的图像更大(或更小)并使用现有名称。效果会很糟糕。
插件头部
插件头部是您在插件页面顶部看到的图像:

在设计您的头部图像时,请牢记国际插件目录的使用。其中一些(如 希伯来语 和 阿拉伯语)使用从右到左(RTL)的语言。理想情况下,设计您的横幅,使得图像中包含的元素可以从右到左或从左到右定位。您可以为 RTL 页面创建不同的图像,名称中包含 -rtl。
文件名
- 普通横幅:
banner-772x250.(jpg|png) - 普通横幅(本地化):
banner-772x250-(rtl|es|es_ES).(jpg|png) - 高 DPI(视网膜):
banner-1544x500.(jpg|png) - 高 DPI(视网膜本地化):
banner-1544x500-(rtl|es|es_ES).(jpg|png)
图像可以针对特定语言或所有 RTL 语言进行本地化。
locale 可以指定为完整 locale(es_ES)或部分 locale(es)。如果语言是 RTL 且未提供特定 locale 的图像,将检查 rtl 图像。
请勿在未进行修改的情况下将英文图像重复到 RTL 和特定 locale 文件中,将使用英文变体。
以 RTL 图像为例,请查看 bbPress 英文版 然后查看 阿拉伯语版。
以视网膜图像为例,查看 Hello Dolly 或 Pluginception。您不能仅使用视网膜图像,它仅作为 772×250 图像的“附加组件”工作。较大的‘视网膜’图像仅在能够显示更高细节的显示器上使用。
4MB 是头部图像的最大尺寸,但越小越好。
插件图标
插件图标是正方形图像,在 WordPress.org 上的搜索中以及 WordPress.org 的后端中显示在插件旁边。

除了 JPG 和 PNG 格式外,您还可以使用SVG。矢量图非常适合图标,因为它们可以缩放到任何尺寸,且文件本身很小。如果您选择使用 SVG,您必须也使用 PNG 图标作为后备,否则您的插件图标在旧版浏览器或 Facebook 上将无法正确显示。
如果您不使用图标,将为您自动生成一个。一些示例如下面的圆形图标:

1MB 是图标的最大文件大小,但与头部一样,越小越好。
文件名
- 普通:
icon-128x128.(png|jpg|gif) - 高 DPI(视网膜):
icon-256x256.(png|jpg|gif) - SVG:
icon.svg
没有计划更改这些尺寸。
截图
截图显示在您的插件的主页上,并用于说明插件管理仪表盘的各个方面或实时示例。您的 readme.txt 文件中的每一行都应该有一个一个截图。行的内容将成为您插件页面中截图的标题。
例如:1. 这是一只猴子
这将显示第一张截图下方有标题“这是一只猴子”。大概是一只猴子的图片。
截图必须本地化才能显示。指向外部文件的链接将不起作用。
10MB 是截图的最大文件大小,但如往常一样,越小越好。
文件名
screenshot-1.(png|jpg)screenshot-2.(png|jpg)
所有文件名应为小写;大写名称将不起作用。
截图可以像横幅一样进行本地化,当插件以德文查看时,以下文件名将优先于上述英文名称:
screenshot-1-de.(png|jpg)screenshot-2-de.(png|jpg)
问题
如果您发现当人们从您的 WordPress.org 插件目录页面点击它们时图像会下载,您需要更改通过 SVN 上传它们的方式。这是由于某些图像以 Content-Type application/octet-stream 发送。
要修复它,运行此命令:
svn propset svn:mime-type image/png *.png
svn propset svn:mime-type image/jpeg *.jpg或者,插件作者可以在其 ~/.subversion/config 文件中设置此内容:
*.png = svn:mime-type=image/png
*.jpg = svn:mime-type=image/jpeg但这仅适用于新文件。修复已提交的文件需要上述命令。