Bestseller Lists from the New York Times

Description

Use this plugin to display all the bestseller lists from New York Times on your own site. Optionally include links from your own local library catalog from each book.

The plugin uses an easy-to-use user-interface which updates quickly and “in-place” when changing lists without reloading the rest of the page.

Use

WordPress 5.0

Use the Bestseller Lists from NYT block. You can optionally specify which list is initially displayed.

WordPress 4.x

Use the [nyt-bestseller-listings] shortcode to embed the lists in your page. You can optionally specify which list is initially displayed by using the initial-list attribute with the list slug as the attribute value. Get the list slug by first placing the shortcode in your page, then visiting the page and changing lists. The page url will change as the list changes, and the list slug can be seen by looking for nyt-list=SLUG-HERE in your browser’s url bar. So for example, to place the lists on a page and set the initial list to be children’s picture books, you would use: [nyt-bestseller-listings initial-list="picture-books"]

To hide the images, add the following bit of css to your theme using the Additional CSS section in the Customizer: .nyt-bestseller-listings-img { display: none; }.

Screenshots

  • The quick-switcher and the top of the list in TwentySeventeen theme.

Installation

  1. Upload this directory to the `/wp-content/plugins/` directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Configure the plugin by looking under Settings > NYT Bestseller Lists. You’ll need to get an free API key from the NY Times, which you can do here: https://developer.nytimes.com/signup.
  4. Embed the shortcode in your page.

FAQ

How do I change which list shows up first?

You can set this at a global level on the administration screen. You can also set it on a per-instance level, by choosing the list in the block, or using the correct shortcode attribute. See the Use section.

Contributors & Developers

“Bestseller Lists from the New York Times” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.2.0

Added a “block” for the new WordPress 5.0 editor. The shortcode is left for backwards-compatibility.

1.0.1

File cleanups.

1.0.0

Initial release. Includes basic listings shortcode with ability control initial list.