Skip to content

Automattic/newspack-listings

Repository files navigation

newspack-listings

semantic-release newspack-listings

Create reusable content as listings and add them to lists wherever core blocks can be used. Create static, curated lists or dynamic, auto-updating lists with optional "load more" functionality. Edit display options to control how the list looks and behaves for readers. Compatible with AMP.

Usage

  1. Activate this plugin.
  2. In the WP admin dashboard, look for Listings.
  3. Create and publish listings of any type. Listings can contain any core blocks as content.
  4. Optionally tag or categorize your listings to keep them organized, even across different listing types.
  5. Once at least one listing is published, add a Curated List block to any post or page.
  6. Choose Specific Listings mode to create a static list, or Query mode to create a dynamic list which will automatically update itself when new listings matching the query options are published.
  7. Edit list options to control the list's display and behavior.

For more detailed instructions, refer to the public documentation for Newspack Listings.

Development

Run composer update && npm install.

Run npm run build.

Each listing type is a separate custom post type. Configuration is in includes/newspack-listings-core.php.

Metadata for listing CPTs is synced from certain blocks in the post content. See configuration in includes/newspack-listings-core.php for details.