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.
-
Open your terminal and go to your Craft project:
cd /path/to/project -
Then tell Composer to load the plugin:
composer require page-8/craft-manytomany -
In the Control Panel, go to Settings → Plugins and click the “Install” button for Many to Many Field Type.
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.
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
- 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.