Brandon Kelly

Apr 27, 2008

Playa for ExpressionEngine

Playa field

Playa is a powerful one-to-many field for ExpressionEngine. It enables you to…

Pull content from multiple weblogs

Other relationship fields limit you to a single weblog. That suits most scenarios just fine, but for the times when it would be nice to pull from multiple weblogs, Playa is ready and waiting.

Limit the number of selectable entries

You can easily set a limit on the number of entries an author can select. When they’ve passed that limit, new selections will appear grayed-out to reflect that they will not show up in the template.

Order your selections with drag-and-drop

Alphabetical order is great and all, but sometimes it’s nice to have a little more control. Playa gives you that control.

Close your entries and mean it

Other relationship fields will display a related entry whether it’s open or not. Playa respects an entry’s status

Set selections as searchable

When setting up your Playa fields, you’re given the option to make them searchable. Unlike other relationship fields, this setting actually works with Playa. (This is limited to the related entries’ titles only. )

Installation Instructions

  1. Download the latest version (below)
  2. Upload ext.playa.php and the entire playa folder to system/extensions/
  3. Enable Playa in the Extensions Manager

Usage

To set up a playa field, just select “Playa” from the Field Type drop-down when creating a new custom field. From there you can customize it just like any other field type.

To add a Playa field to a template, just use the Relationship field syntax:

{related_entries id="my_playa_field"}
    <h4>{title}</h4>
    <p>{body}</p>
{/related_entries}

That’s it! Playa will loop through that code block multiple times to display each entry.