A Field Type plugin for CraftCMS that allows the management of relationships from both sides
Clone or download
Latest commit bd4d2e8 May 17, 2018

README.md

Many to Many Field Type plugin for Craft 3

Many to Many is a Craft CMS plugin developed by Pageworks and updated to support Craft 3 by Oberon. This plugin allows you to manage relationships in Craft from either of the entries that belong to the association. For example, if you have a recipe with many ingredients, and ingredients that belong to many recipes, you can manage the relationship from either the Recipe's entry or the Ingredient's entry.

Requirements

This plugin requires Craft CMS 3.0.0-beta.28 or later.

Installation

To install the plugin, follow these instructions.

  1. Open your terminal and go to your Craft project:

     cd /path/to/project
    
  2. Then tell Composer to load the plugin:

     composer require page-8/craft-manytomany
    
  3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Many to Many Field Type.

Usage

  1. Create your initial relationship field using the Entries Field Type and attach it to your first section
  • This is done directly through Craft's native "Entries" field type
  • This example assumes this is done on the "Recipes" section creating a field called "Related Ingredients" that allows entries from the Ingredients section Recipes Screen
  1. Create another field that attaches the relationship using the Many to Many field type
  • This is done by creating a new field and selecting the Many to Many field type
  1. Customize your Settings
  • Linked Section will be the initial section that contains the relationship. (in our example Recipes)
  • Associated Field is the field on the other end of this relationship. (in our example Related Ingredients) Settings Screen
  1. Attach the newly created Many to Many field to your section Ingredients Screen

Template Usage

Since this plugin relies on Craft's built in relationships, you can continue to use relationships just as you always have.

Recipes showing Related Ingredients

<h1>Related Ingredients</h1>
{% set relatedIngredients = craft.entries.section('ingredients').relatedTo(entry).all() %}
{% for ingredient in relatedIngredients %}
    {{ ingredient.title }}<br />
{% endfor %}

Ingredients showing Related Recipes

<h1>Related Recipes</h1>
{% set relatedRecipes = craft.entries.section('recipes').relatedTo(entry).all() %}
{% for recipe in relatedRecipes %}
    {{ recipe.title }}<br />
{% endfor %}

Feedback?

Contact us on Twitter @teampageworks or visit us at page.works

Version History

  • 1.0.0 - Release form Craft 3 by contributor Oberon
  • 0.1.2 - Added translatable text
  • 0.1.1 - Optimized the cache control. Instead of clearing all Entry types from the cache, just clears records related to the changed element
  • 0.1.0 - Initial Release

To Do

  1. Allow the field to work across all (or at least more) Element Types. Currently only supports Entries.
  2. Allow custom ordering of the secondary relationship. Currently you can only order the primary relationship (by Craft's native ordering of the Entries field type).
  3. Fix a bug that doesn't allow it to work from the modal tab.
  4. Other stuff I assume.

Notes

  • Currently doesn't support locales
  • As always, use at your own risk

License

This work is licenced under the MIT license.