Playa 2.0.7

Playa

“The best just got way better.”

The go-to extension for relating entries in ExpressionEngine is back for an encore, packed with plenty of sleazy new features:

Drag ’n Drop ’n Done.

Drag ’n Drop

In Playa 2, you can select and position your entries in one single motion.

In-field filtering and sorting.

Filtering

Filter your entries by Weblog, Author, Category, Status, and Keyword1. Then order them by Title or Date.

Playas in the Matrix.

FF Matrix celltype

On top of its primary fieldtype, Playa 2 also adds a relationship celltype to FF Matrix.

New template tag & options.

Template code

Customize your Playa field output right from your templates with Playa’s all-new template tag.

Installation

  1. Install FieldFrame 1.0.5 or later
  2. Download and unzip the latest version (link provided via email after purchase)
  3. Upload the extensions/fieldtypes/playa folder to extensions/filedtypes
  4. Upload language/english/lang.playa.php to system/language/english
  5. Enable Playa in the Fieldtypes Manager
  6. To activate update notifications, enter your License Key in Playa’s site settings within the Fieldtypes Manager

Upgrading from Playa Classic?

If you’re already sporting Playa Classic, you must disable it in the Extensions Manager before Playa 2 will show up in your Fieldtypes Manager.

You’ll also need to update your templates, as the template tag syntax has changed.

Primary tag pair

In Playa 2, you call your fields directly by name. So, if you have a field named “my_playa_field”, you’d call it from your templates using a tag pair like so:

{my_playa_field}
    {title}
{/my_playa_field}

Tag parameters

The following parameters can be added to your opening tag:

author="1|2|3"

Filter selections by their author ID. Prepend the value with "not " to specify which author IDs to exclude.

category="1|2|3"

Filter selections by their category IDs. Prepend the value with "not " to specify which category IDs to exclude.

weblog="news|photos"

Filter selections by their weblog short name. Prepend the value with "not " to specify which weblogs to exclude.

status="open|my_custom_status"

Filter the selections by status. Prepend the value with “not ” to specify which statuses to exclude. Leave the value blank to include all statuses. (Default is “open”.)

orderby="entry_date|title"

Override the user-defined entry order. This can be set to any of the columns in your exp_weblog_titles table.

sort="desc|asc"

Specify whether the entries should be listed in ascending or descending order.

limit="5"

Limit the field to only display the first X entries.

backspace="2"

Remove the last X characters from the returned template markup.

Single tag variables

The following variables can be added within your tag pairs:

{count}

The current entry’s count within the Playa field.

{total_related_entries}

The total number of related entries (after filtering).

{switch="odd|even"}

Switch between multiple values per row.

:total_related_entries tag

Get the number of related entries in a playa field. Accepts the author, category, weblog, and status parameters. (Requires FieldFrame 1.0.8+)

{my_playa_field:total_related_entries}
Purchase a Playa Site License

Purchase a Playa Site License

Requires ExpressionEngine 1.6+, PHP 5+, and FieldFrame 1.0.5+

Recent Changes

2.0.7
added multi-select celltype option
2.0.6
added “category”, “author”, and “weblog” tag parameters
2.0.4
fixed {count} and {switch} tags
2.0.3
added :total_related_entries tag
2.0.2
fixed category filtering
2.0.0
Initial release

Awards & Recognition

Playa 2 is sweet. Got it working on my personal site quickly. Nicely done!

—Leslie Camacho, President of EllisLab

I consider this one of the most important extensions for EE. My websites rely on Playa for advanced functionality. I love it. Clients love it.

—Ryan Masuga, Masuga Design

No extension adds the complex functionality that Playa does, while at the same time remaining so simple for the site owner to use.

—Chad Crowell, Web Inception

Support

Get Satisfaction

Playa is supported through Get Satisfaction

Playa Site License

Each Site License may be used on one website at a time. This includes both public-facing websites and intranet websites. Each MSM-based website counts as one website. You may also install Playa on an unlimited number of private, in-development websites.

You may return your Site License for a full refund within 30 days of purchase.

  1. Filtering by Keyword requires the Search Module.