Archived
This project is now archived, development has been picked up by Verbb and can be found here, (*1)
Many to Many Field Type plugin for Craft 3
Many to Many is a Craft CMS plugin developed by Page 8 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., (*2)
Requirements
This plugin requires Craft CMS 3.0.0-beta.28 or later., (*3)
Installation
To install the plugin, follow these instructions., (*4)
-
Open your terminal and go to your Craft project:, (*5)
cd /path/to/project
-
Then tell Composer to load the plugin:, (*6)
composer require oberonamsterdam/craft-manytomany
-
In the Control Panel, go to Settings → Plugins and click the “Install” button for Many to Many Field Type., (*7)
Usage
- 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
- 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
- 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)
- Attach the newly created Many to Many field to your section
Template Usage
Since this plugin relies on Craft's built in relationships, you can continue to use relationships just as you always have., (*8)
Recipes showing Related Ingredients, (*9)
<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, (*10)
<h1>Related Recipes</h1>
{% set relatedRecipes = craft.entries.section('recipes').relatedTo(entry).all() %}
{% for recipe in relatedRecipes %}
{{ recipe.title }}<br />
{% endfor %}
Version History
See CHANGELOG.md., (*11)
To Do
- Allow the field to work across all (or at least more) Element Types. Currently only supports Entries.
- 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).
- Fix a bug that doesn't allow it to work from the modal tab.
- 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., (*12)