A WordPress plugin that provides a widget and shortcode to display related posts by taxonomies as links, full posts, excerpts or post thumbnails.
PHP Shell JavaScript
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
includes
lang
templates
tests
.gitignore
.travis.yml
Gruntfile.js
LICENSE
package.json
phpunit.xml
readme.md
readme.txt
related-posts-by-taxonomy.php
uninstall.php

readme.md

Related Posts by Taxonomy Build Status

Version: 2.2.2
Requires at least: 4.0
Tested up to: 4.7

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.

More information can be found at the WordPress repository and at the official plugin documentation.

Installation

This will download the latest stable copy of Related Posts by Taxonomy.

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 msoravilla)
Catalan (by msoravilla)
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