Title: Must Read Posts
Author: trick77
Published: <strong>2009 年 1 月 2 日</strong>
Last modified: 2012 年 1 月 11 日

---

搜索插件

**该插件尚未通过WordPress的最新3个主要版本进行测试**。 当与较新版本的WordPress一起
使用时，可能不再受到维护或支持，并且可能会存在兼容性问题。

![](https://s.w.org/plugins/geopattern-icon/must-read-posts.svg)

# Must Read Posts

 作者：[trick77](https://profiles.wordpress.org/trick77/)

[下载](https://downloads.wordpress.org/plugin/must-read-posts.2.0.2.zip)

 * [详情](https://cn.wordpress.org/plugins/must-read-posts/#description)
 * [评价](https://cn.wordpress.org/plugins/must-read-posts/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/must-read-posts/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/must-read-posts/#developers)

 [支持](https://wordpress.org/support/plugin/must-read-posts/)

## 描述

Retrieves posts (or pages) with a certain custom field (e.g. to permanently show
your **most recommended posts** in a widget) and displays them in a list. The plugin
uses a custom field named _must-read_ if it exists in a post or a page. If the field
exists in a page or post **and** has the value _true_, the post automatically will
be shown in the widget.

#### What’s new

2.0.2: Stripping HTML tags from titles (thanks, Reinaldo!)
 2.0.1: Several sorting
options added, check out the widget configuration area.

#### Use it as a Widget

If your theme supports widgets, simply drag it to your sidebar. You can specify 
the maximum number of posts to be shown in the widget. You can also change the widget’s
title to something like “Most recommended posts”, “FAQ”, “Read first” or whatever
you like.

#### Use it in a .php page

Just put `<?php get_mustread(); ?>` in your template. You could even use it within
your posts or pages using the [Exec-PHP plugin](https://wordpress.org/extend/plugins/exec-php/)
that allows you to put php code fragments directly into the text. This allows you
to create a static page or a post showing your most recommended posts. The get_mustread
function takes 4 **optional** arguments: title, maximum number of posts to be shown,
name of the custom tag, sort order. Optional means you don’t have to specify any
parameters if you don’t need to.

#### Marking a post or page to be included

If you’re using the plugin for the first time, click “Add new custom field” to add
the field name _must-read_ and insert _true_ in the value field of the page or post
you want to be shown in the new widget. Once you want to display an additional post
in the widget, just select it from the custom field drop-down box and insert “true”
in the value field.
 If you don’t want the custom field to be named _must-read_ 
you can also change it to something else. The custom field value always has to start
with _true_ for the page or post to appear in the list.

#### Custom sort order

The plugin features several self explanatory sorting options. You can also specify
a custom sort order. Just add a semi-colon and a sort-number after _true_ in the
custom value field. The field value for your 1st post would be _true;01_ and the
2nd field would like _true;02_ and so on. This gives you full flexibility over the
positioning of your posts or pages in the Must-Read-Posts list. If you mix sorted
and unsorted posts or pages, the ones with no number will be sorted first. If you
have a bunch of posts or pages that you just want to sort at the end use something
like _true;99_ on all of them to move them at the end of the sort order.

#### Remove a post or page from the Must-ReadPosts list

To remove a post or page from the Must-Read-Posts list set the custom-field-value
to _false_ or remove the custom-field from the post or pages.

## 屏幕截图

[⌊Must Read Posts in action in widget in the right sidebar⌉⌊Must Read Posts in action
in widget in the right sidebar⌉[

Must Read Posts in action in widget in the right sidebar

[⌊Widget configuration⌉⌊Widget configuration⌉[

Widget configuration

[⌊How to add the must-read custom field to a post or page, don't forget to add the
value true⌉⌊How to add the must-read custom field to a post or page, don't forget
to add the value true⌉[

How to add the _must-read_ custom field to a post or page, don’t forget to add the
value _true_

## 安装

 1. Upload must-read-posts.php to the /wp-content/plugins/ directory.
 2. Activate “Must Read Posts” through the ‘Plugins’ menu in WordPress.
 3. What to do now depends on how up to date your theme is (see below)
 4. Mark all the posts/pages you want to show in the widget with the custom field _must-
    read_ and the value _true_ (see screenshots).

**Modern theme with widget support**

The plugin is a widget. If your theme supports widgets, and you have installed the
widget plugin, adding the plugin to the sidebar is easy: Go to the appearance menu
and drag and drop the widget into the sidebar. Don’t forget to save your new widget
structure using the save button below.

**Old school theme without widget support**

This will require some programming in the sidebar.php file. There are many resources
on the web about how to do this.

## 常见问题

  I want to change the look of the list. How can I do that?

The look of the list of posts and pages in the widget can be customized using the
style.css cascading style sheet. Just add your own or the following style to your
current theme’s style.css file:

  must-read-posts li {

list-style-type:square;
 margin-bottom:0.4em; }

## 评价

此插件暂无评价。

## 贡献者及开发者

「Must Read Posts」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ trick77 ](https://profiles.wordpress.org/trick77/)

[帮助将「Must Read Posts」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/must-read-posts)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/must-read-posts/)，查看
[SVN仓库](https://plugins.svn.wordpress.org/must-read-posts/)，或通过[RSS](https://plugins.trac.wordpress.org/log/must-read-posts/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/must-read-posts/)。

## 额外信息

 *  版本 **2.0.2**
 *  最后更新：**14 年前**
 *  活跃安装数量 **10+**
 *  WordPress 版本 ** 2.5 或更高版本 **
 *  已测试的最高版本为 **3.3.2**
 *  语言
 * [English (US)](https://wordpress.org/plugins/must-read-posts/)
 * 标签
 * [links](https://cn.wordpress.org/plugins/tags/links/)[posts](https://cn.wordpress.org/plugins/tags/posts/)
   [sidebar](https://cn.wordpress.org/plugins/tags/sidebar/)[widgets](https://cn.wordpress.org/plugins/tags/widgets/)
 *  [高级视图](https://cn.wordpress.org/plugins/must-read-posts/advanced/)

## 评级

尚未提交反馈。

[Your review](https://wordpress.org/support/plugin/must-read-posts/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/must-read-posts/reviews/)

## 贡献者

 *   [ trick77 ](https://profiles.wordpress.org/trick77/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/must-read-posts/)