The CAC Featured Content Widget is a plugin developed for the CUNY Academic Commons — an academic social network powered

CAC特色内容窗口小部件是为 CUNY Academic Commons （由学术社交网络提供支持）开发的插件

by WordPress, BuddyPress, and MediaWiki.

由WordPress，BuddyPress和MediaWiki提供。

The widget provides several useful tools for featuring selected content, such as Featured Blogs, Featured Groups, Featured Posts, Featured Members and Featured Resources.

该小部件提供了一些用于精选内容的有用工具，例如精选博客，精选组，精选帖子，精选成员和精选资源。

Currently the plugin will work on both single and multisite installs, but is BuddyPress dependent.

目前，该插件可以在单站点安装和多站点安装上运行，但与BuddyPress 相关相关。

It will not work on a non-BuddyPress install.

在非BuddyPress安装中，它将不运行。

The five featured content types (blog, group, post, member and resource) share a lot of the code behind the scenes.

五种特色内容类型（博客，组，帖子，成员和资源）在幕后共享了许多代码。

Their layouts (views) and structure are all very similar.

它们的布局（视图）和结构都非常相似。

It’s only the specific details about each that change.

只是每一个变化的具体细节。

The admin interface for the plugin has been augmented with autocomplete functionality to help simplify administrative tasks.

该插件的管理界面已增加了自动完成功能，以帮助简化管理任务。

The featured blog address, featured group name, featured post name and featured member username will all provide results from your BuddyPress/MultiSite installation as you type.

特色博客地址，特色论坛名称，特色帖子名称和特色会员用户名都将在您键入时提供BuddyPress / MultiSite安装的结果。

If the description provided by the chosen featured content type is not suitable, for whatever reason, the plugin offers a Custom Description text field to provide an alternative.

如果由于某些原因，由选定的特色内容类型提供的描述不合适，则插件会提供自定义描述文本字段以提供替代方法。

The text entered in this field will override any description that was automatically parsed by the plugin while querying for your featured content type.

在此字段中输入的文本将覆盖在查询特色内容类型时插件自动解析的所有描述。

This field also serves as the only description for the Featured Resource content type.

此字段还作为精选资源内容类型的唯一说明。

The crop length (in characters) of the description can be controlled via the plugin’s Crop Length input field.

描述的裁切长度（以字符为单位）可以通过插件的裁切长度输入字段进行控制。

Either the automatically parsed description, or the custom description text, will be cropped with ellipses appended to the end.

自动剖析的描述或自定义描述文本将被裁剪，并在末尾附加省略号。

The default is 250 characters.

默认值为250个字符。

The widget that’s displayed to the user on the front of the site provides a link after the description to allow the visitor to view the remainder of the featured content in its full glory.

在网站前面显示给用户的窗口小部件在说明后提供了一个链接，以使访问者可以全面浏览特色内容的其余部分。

The link text defaults to “Read More…”, but can be customized through the Read More Label field.

链接文本默认为“阅读更多…”，但可以通过阅读更多标签字段进行自定义。

Because many site admins do not have access to how a theme styles the HTML output of the widgets added to a sidebar, the admin section allows you to choose what heading element will be used to wrap the widget’s title.

由于许多网站管理员无法访问主题样式设置为添加到侧边栏的小部件的HTML输出的样式，因此admin部分允许您选择将用于包装小部件标题的标题元素。

You can choose from an

all the way down to an

.

您可以从

一直选择到

。

This allows you to add the widget to any number of sidebars (or widgetized areas) in a theme that has defined different looks between different page sections.

这样，您便可以将小部件添加到主题中定义了不同页面部分外观的主题中的任意数量的侧边栏（或小部件化区域）中。

You have almost complete control over the plugin’s image handling capabilities.

您几乎完全可以控制插件的图像处理功能。

The Display Images checkbox toggles the displaying of all images.

显示图像复选框可切换所有图像的显示。

When images are displayed they will be chosen based on the type of featured content, unless you enter a URL to a specific image in the Image URL field.

显示图像时，除非您在图像URL 字段中输入特定图像的URL，否则将根据精选内容的类型进行选择。

For groups, the image is the group’s avatar;

对于群组，图片是群组的头像；

for members their personal avatar is used;

会员使用其个人化身；

for a blog the author’s avatar is used;

对于博客，使用作者的头像；

and for posts the image used is either the first image within the post or the avatar of the post’s author.

对于帖子，使用的图片要么是帖子中的第一张图片，要么是帖子作者的头像。

The resource type will use the URL from the Image URL field to load an image from an external source.

资源类型将使用图片URL 字段中的URL从外部源加载图片。

The size of the thumbnail displayed in the widget can be controlled through the Image Width and Image Height fields, which are both set to 50px by default.

可以通过图像宽度和图像高度字段控制窗口小部件中显示的缩略图的大小，这些字段默认情况下均设置为50px。

Additional technical details can be found in the plugin's README on Github

其他技术细节可以在 Github 上的插件自述文件中找到。

Notice

通知

This release is a complete rewrite of most of the core functionality of the plugin.

此版本完全重写了该插件的大部分核心功能。

Many old features were removed and new functionality has been added.

删除了许多旧功能，并添加了新功能。

Upgrading

升级

Version 1.0.0 breaks backwards compatibility as of version 0.8.4, the prior stable release.

1.0.0版打破了先前稳定版本0.8.4版的向后兼容性。

Some filters that existed in the previous version no longer exist.

先前版本中存在的某些过滤器不再存在。

Additionally, any current widgets will need to be repopulated with featured content due to structural changes to the core of the plugin.

此外，由于插件核心的结构变化，所有当前的小部件都需要重新添加特色内容。

Please be aware of these issues before deciding to upgrade to the newly redesigned version 1.0.0.

在决定升级到新设计的1.0.0版本之前，请注意这些问题。

Support

支持

Please direct all support requests, feedback and patches (pull requests) to the

请将所有支持请求，反馈和补丁（拉取请求）定向到

>issues section of the plugin's Github repo.

插件的Github存储库的“问题”部分。