1.2.1developmentAssociation UI: Selector

Search and select associated entries

Clone URLhttps://github.com/mazedigital/association_ui_selector.git

Add as a submodulegit submodule add https://github.com/mazedigital/association_ui_selector.git extensions/association_ui_selector --recursive

Compatibility

2.x.x2.1.x2.2.x2.3.x2.4.x2.5.x2.6.x2.7.0
NoNoNoNoNo1.2.1NoNo. Soon?

Readme

Association UI for Symphony: Selector

Interface preview

Selector provides a search and select interface for associative Symphony fields. It works with core select boxes and tag lists as well as with Association fields.

Installation

  1. Upload Selector to your extensions folder.
  2. Enable Selector in the backend.
  3. Add an associative field to your section and choose one of the interface.

Please keep in mind that interface are only available in combination with dynamic values, if you are using default select boxes or tag lists.

Modes

There are two modes:

  • single select
  • multiple select

Sorting

Sorting is currently only available for Association fields.

Custom Captions

It’s possible to include markup in your related field in order to create more informative item captions. Selector bundles styles for text, image previews and emphasis. If you’d like to combine multiple field values into a single caption, please take a look at Reflection field.

Basic Reflection field expressions

You can create a second row with a standard <br />. Emphasized text will be displayed in grey. The Reflection field can access fields by entry/[fieldname]. For example:

xsl {entry/title}<br/><em>{entry/upload/filename}</em>

If you want to display an image thumbnail you can make use of JIT. An image size of 35×35px works best. Using this Reflection field fork mentioned here, you can use {root} to create a dynamic URL:

xml <img src='{root}/image/2/35/35/5/{entry/upload/filename}' /> {entry/title}<br/><em>{entry/upload/filename}</em>

Reflection field with XSLT-utility

For more complex needs Reflection field lets you use an XSLT-utility. Here’s an example that formats biographic-data nicely based on if data is available in a specific entry. The Reflection field expression is simply:

xml {person}

The XSLT-utility needs to be in the workspace/utilities folder. It will be selectable in the Reflection field settings:

```xml <?xml version="1.0" encoding="utf-8"?>

<![CDATA[>                 <xsl:text><![CDATA[<br/>]]>– * †<![CDATA[]]>

```

Acknowledgement

The interface of Selector is based on Selectize by Brian Reavis bundled with the Symphony core.

This project has kindly been funded by Bernardo Dias da Cruz, Ben Babcock, Juraj Kapsz, Daniel Golbig, Vojtech Grec, Andrea Buran, Brendan Abbot, Roman Klein, Korelogic, Ngai Kam Wing, David Oliver, Patrick Probst, Mario Butera, John Puddephatt, Goldwiege, Andrew Minton, munki-boy, Martijn Kremers, Ian Young, Leo Nikkilä, Jonathan Mifsud and others. Read more.

If you like this extension, please consider a donation to support the further development.

PayPal Donation

Version history

Requires Symphony 2.5

  • Fixed styling of index table overviews for single select fields (requires Association Field 1.0.1)

Requires Symphony 2.5

  • Added styling to index table overviews (requires Association Field 1.0.0)

Requires Symphony 2.5

  • Fixed optgroup styling (#33)
  • Fixed auto-focus behaviour (#36)

Requires Symphony 2.5

  • Added German tranlation

Requires Symphony 2.5

  • First release