Updating Instructions
Note: It’s highly recommended that you backup your database before updating to Playa 4 from any earlier version.
Note: Do not uninstall your previous version of Playa before updating. If you do that, ExpressionEngine will delete all of your Playa fields, as well as any relationships you created with them.
Updating from Playa 1 on ExpressionEngine 1
- Update to ExpressionEngine 2
- Ensure that your system meets the Prerequisites listed in the Installation Instructions, and then follow the installation procedure
- Update your templates to use the new template syntax:
Playa 1 Playa 4 {related_entries id="my_playa_field"} ... {/related_entries}{my_playa_field} ... {/my_playa_field}{reverse_related_entries channel="my_channel"} ... {/reverse_related_entries}{exp:playa:parents channel="my_channel"} ... {/exp:playa:parents}
Updating from Playa 2 or 3 on ExpressionEngine 1
- Update to ExpressionEngine 2
- Ensure that your system meets the Prerequisites listed in the Installation Instructions, and then follow the installation procedure
- Update your templates to use the new template syntax:
Playa 2 and 3 Playa 4 {reverse_related_entries channel="my_channel"} ... {/reverse_related_entries}{exp:playa:parents channel="my_channel"} ... {/exp:playa:parents}
Updating from Playa 3 on ExpressionEngine 2
- Ensure that your system meets the Prerequisites listed in the Installation Instructions, and then follow the installation procedure
- Delete system/language/english/lang.playa.php from your server if you’re updating from an earlier version than Playa 3.1
- Delete the themes/playa folder if you’re updating from an earlier version than Playa 3.0.8
- Update your templates to use the new template syntax:
Playa 3 Playa 4 {reverse_related_entries channel="my_channel"} ... {/reverse_related_entries}{exp:playa:parents channel="my_channel"} ... {/exp:playa:parents}
Updating from an earlier version of Playa 4
- Ensure that your system meets the Prerequisites listed in the Installation Instructions, and then follow the installation procedure
- Go to Add-Ons → Fieldtypes → Playa to trigger Playa’s update script. (No action is necessary.)