/related-posts-by-taxonomy

A WordPress plugin that provides a widget and shortcode to display related posts by taxonomies as links, full posts, excerpts or post thumbnails.

Primary LanguagePHPGNU General Public License v2.0GPL-2.0

Version: 2.7.2
Requires at least: 4.2
Tested up to: 5.2

Welcome to the GitHub repository for this plugin

This is the development repository for the WordPress plugin Related Posts by Taxonomy.

The master branch is where you'll find the most recent, stable release. The develop branch is the current working branch for development. Both branches are required to pass all unit tests. Any pull requests are first merged with the develop branch before being merged into the master branch. See Pull Requests

Description

This WordPress plugin displays related posts as thumbnails, links, excerpts or as full posts with a widget or shortcode. Posts with the most terms in common will display at the top. Use multiple taxonomies and post types to get the related posts. Include or exclude terms. Change the look and feel with your own html templates in your (child) theme.

Visit these resources for more information.

Installation

Pull Requests

When starting work on a new feature, branch off from the develop branch.

# clone the repository
git clone https://github.com/keesiemeijer/related-posts-by-taxonomy.git

# cd into the related-posts-by-taxonomy directory
cd related-posts-by-taxonomy

# switch to the develop branch
git checkout develop

# create new branch newfeature and switch to it
git checkout -b newfeature develop

Creating a new build

To build the plugin without all the development files (as in the WP repository) use the following commands:

# Go to the master branch
git checkout master

# Install Grunt tasks
npm install

# Build the production plugin
grunt build

The plugin will be compiled in the build directory.

Bugs

If you find an issue, let us know here!

Support

This is a developer's portal for Related Posts by Taxonomy and should not be used for support. Please visit the support forums.

Translations

Dutch
French (by Annie Stasse)
Spanish (by Ludobooks – Cuentos personalizados)
Catalan (by Ludobooks – Cuentos personalizados)
Polish (by koda0601)

Contributions

There are various ways you can contribute:

  1. Raise an Issue on GitHub
  2. Send us a Pull Request with your bug fixes and/or new features
  3. Translate Related Posts by Taxonomy into different languages
  4. Provide feedback and suggestions on enhancements