Title: WP Reading List
Author: Mike Stumpf
Published: <strong>August 29, 2013</strong>
Last modified: October 28, 2022

---

Search plugins

![](https://ps.w.org/wp-reading-list/assets/banner-772x250.png?rev=768467)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://s.w.org/plugins/geopattern-icon/wp-reading-list_858576.svg)

# WP Reading List

 By [Mike Stumpf](https://profiles.wordpress.org/mstumpf/)

[Download](https://downloads.wordpress.org/plugin/wp-reading-list.4.0.1.zip)

 * [Details](https://test.wordpress.org/plugins/wp-reading-list/#description)
 * [Reviews](https://test.wordpress.org/plugins/wp-reading-list/#reviews)
 *  [Installation](https://test.wordpress.org/plugins/wp-reading-list/#installation)
 * [Development](https://test.wordpress.org/plugins/wp-reading-list/#developers)

 [Support](https://wordpress.org/support/plugin/wp-reading-list/)

## Description

**WP Reading List** (or, **WPRL**) is a plugin designed to help organize and display
books, magazines, articles, and anything else that you have read lately. This plugin
allows users to display what they have read, attach text like a review or notes 
to it, and provide a link to where visitors can find the piece. The plugin comes
bundled with two archive templates (as well as templates for single items and “author”&“
type” archives) and is easily customizable with CSS. View a working example at `
https://mikestumpf.com`

## Screenshots

 * [[
 * Grid Layout
 * [[
 * Single Item View
 * [[
 * Author View
 * [[
 * Shortcode View
 * [[

## Installation

 1. Install the plugin by searching for “WP Reading List” in the WordPress.org plugin
    directory **or** upload the `wp-reading-list` plugin folder, available here: `https://
    wordpress.org/plugins/wp-reading-list/`, to the `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Set the plugin settings via the submenu “WP Reading List” under “Settings” in the
    WordPress admin menu
 4. Add Reading List items in the “Works” tab
 5. View your Reading List items at “mydomain.com/reading-list/”

## FAQ

### How do I see my WP Reading List items?

After activating the plugin, publish a reading list item or two under the “Works”
tab in the WordPress admin menu and then navigate to “mydomain.com/reading-list/”(
or to “mydomain.com/?post_type=works” if you are using the “default” permalink structure.
Adding the “/reading-list/” or “/?post_type=works”to your site’s base url directs
users to your reading list items. You can then add this url to your custom menu 
to make it easier for users to get to.

### Why doesn’t “mydomain.com/reading-list/” or “mydomain.com/?post_type=works” work? **A.K.A.** Why is my website returning a 404 “Not Found” error when I try to view my reading list?

If this is the case, simply go to “Settings” and then “Permalinks” and hit save (
you do not have to change any settings). This refreshes your website’s rewrite rules
and now “mydomain.com/reading-list/” or “mydomain.com/?post_type=works” should work.
Otherwise, make sure you have at least one published reading list item.

### If I deactivate/delete the WP Reading List plugin will I lose all the reading list items and authors I have already created?

If you deactivate or delete the plugin, you will not lose the content you have created
but you will lose your plugin settings.

### Why aren’t my widgets or sidebars displaying on the WP Reading List layout view?

At this point, the plugin does not support widgets or sidebars in its templates 
due to difficulty organizing the lists due to the unpredictability of widget/sidebar
sizes.

### What can I do if I want to change the look of the Reading List layout to better fit with my theme?

There are several options available in the WP Reading List admin settings to help
the reading list layouts fit smoothly into any existing theme. In addition, the 
templates have been highly detailed in terms of extra id’s and classes for easy 
customization via CSS. Many themes have a “Custom CSS” tab built into the admin 
menu where you can add your changes. Otherwise, you can always place your modifications
within the “style.css” file of your parent or child theme.

### How can I change the default WP Reading List image?

There are two options: 1) You can use the settings in the admin panel and use the
file uploader there. 2) You can use a file manager and go to “wp-content/plugins/
wp-reading-list/wprl-theme/” and replace the “default.png” image with your image
of the same name. It is recommended that you choose a default image with a 3:4 aspect
ratio (width:height) to match the other cover images.

### The “Works”, “Authors”, “Types”, and “Reading List” terminology is confusing. Is there a easier way to think of these things?

Yes. Think of “works” as specialized “posts” and similarly of “authors” & “types”
as different kinds of “tags”. The “Reading List” and “Reading List Items” is a phrase
which tries to include all kinds of reading materials such as books, magazines, 
articles, etc.

### How do I use the WP Reading List shortcodes?

The WP Reading List shortcode embeds a list of items on a page or sidebar widget
according to both the plugin settings in the admin panel and the parameters passed
to the shortcode. The format is: [wprl layout=”plain” number=”10″]. At this time,
the only format available is “plain” but you can specify any number for the number
of works displayed. (*Note, -1 returns all works.)

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“WP Reading List” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Mike Stumpf ](https://profiles.wordpress.org/mstumpf/)

[Translate “WP Reading List” into your language.](https://translate.wordpress.org/projects/wp-plugins/wp-reading-list)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/wp-reading-list/), 
check out the [SVN repository](https://plugins.svn.wordpress.org/wp-reading-list/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/wp-reading-list/)
by [RSS](https://plugins.trac.wordpress.org/log/wp-reading-list/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 4.0.1

 * Fixed incorrect urls

#### 4.0.0

 * Replaced frontend templates and styling to be response, i.e. mobile friendly,
   and to reuse common logic
 * Refactored code to be more human-readable and removed redundant admin settings

#### 3.0

*Added image uploader for default cover image
 *Added shortcode support for embedding
plain reading list *Fixed whitespace issue in source code *Fixed issue with grid
view layout

#### 2.2.3

*Fixed information fields not displaying in works archive

#### 2.2.2

*Added more meta fields showing in single works template

#### 2.2.1

*Added css id for use in styling plugin templates

#### 2.2

*Fixed bug in grid view for paginated views
 *Fixed bugs resulting from adding language
support *Added way to update database without removing previous settings in admin
panel

#### 2.1.1

*Added further language support

#### 2.1

*Fixed bug which did not show the last row of details in the grid view
 *Added multi-
language support

#### 2.0.1

 * Fixed minor redirect bug

#### 2.0

 * Fixed bug which removed commenting from a site when installed
 * Fixed permalink issue so the plugin now displays regardless of permalink setting
 * Added “work types” so that a user can add classifications like “journal”, “magazine”,“
   book”, etc.

#### 1.3

 * Fixed minor bugs from 1.2
 * Improved terminology and taxonomy. Deleted all references to “books” in favor
   of “works”
 * Added to Readme

#### 1.2

 * Added native update feature for future versions of the plugin
 * Added admin feature for links to author archives
 * Fixed small bugs since 1.1
 * Sharpened default image and screenshots
 * Added support for page ranges
 * Improved user input sanitation and validation

#### 1.1

 * Added code documentation and improved the WordPress Readme file
 * Fixed an activation problem
 * Removed delete items with uninstallation of plugin function
 * Added a header picture and screenshots
 * Added missing validate function for admin setting
 * Finished “author” view template
 * Fixed several display-related bugs
 * Minor edits

#### 1.0

 * First Stable release

## Meta

 *  Version **4.0.1**
 *  Last updated **3 years ago**
 *  Active installations **50+**
 *  WordPress version ** 3.0 or higher **
 *  Tested up to **6.1.10**
 *  Language
 * [English (US)](https://wordpress.org/plugins/wp-reading-list/)
 * Tags
 * [custom post](https://test.wordpress.org/plugins/tags/custom-post/)[images](https://test.wordpress.org/plugins/tags/images/)
   [posts](https://test.wordpress.org/plugins/tags/posts/)[reading-list](https://test.wordpress.org/plugins/tags/reading-list/)
   [works](https://test.wordpress.org/plugins/tags/works/)
 *  [Advanced View](https://test.wordpress.org/plugins/wp-reading-list/advanced/)

## Ratings

 3 out of 5 stars.

 *  [  0 5-star reviews     ](https://wordpress.org/support/plugin/wp-reading-list/reviews/?filter=5)
 *  [  2 4-star reviews     ](https://wordpress.org/support/plugin/wp-reading-list/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/wp-reading-list/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/wp-reading-list/reviews/?filter=2)
 *  [  1 1-star review     ](https://wordpress.org/support/plugin/wp-reading-list/reviews/?filter=1)

[Add my review](https://wordpress.org/support/plugin/wp-reading-list/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/wp-reading-list/reviews/)

## Contributors

 *   [ Mike Stumpf ](https://profiles.wordpress.org/mstumpf/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/wp-reading-list/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://mikestumpf.com/)