What is symphonyextensions.com?

How do I submit an extension?

Host your extension on Github and make sure the repository has a good README and an extension.meta.xml file. Then sign in to this site using your GitHub profile where you will see a list of your public repositories. Pick one, and add it to the site. When you make changes, just update the XML file in your repository and we do the rest.

What is an extension.meta.xml file?

It is an XML file that you add to your repository to describe your extension. You can include a name and description, developer contact details, version history, changelog, dependencies and more. Please read the documentation for a full list. You can use the lint tool to check your XML against the schema before submitting your extension to the site.

Readme

Select Box Link Field

Installation

Upload the selectbox_link_field folder in this archive to your Symphony 'extensions' folder.

Enable it by selecting the "Field: Select Box Link", choose Enable from the with-selected menu, then click Apply.

You can now add the "Select Box Link" field to your sections.

Updating

Be sure to visit the Extension page in the Symphony admin and enable "Select Box Link Field" so the database is updated accordingly.

Usage

Works in a near identical way to the standard select box field, however there is no static options and entries are linked internally via their ID, meaning that if an entry is changed, any Select Box Link fields will not lose their link to that entry. The data on the front-end is presented in a way identical to that of a Section Link.

Setting an instance of the field to be not required will cause an empty option to show up on the publish form.

Filtering options

The Select Box Link supports the following filtering options in your data sources:

Red Cats or not: Red Cats: Return all entries where the linked entry has the value of Red Cats (or does not have the value Red Cats)

red-cats or not: red-cats: Return all entries where the linked entry has the handle of red-cats (or does not have the handle red-cats)

1 or not: 1: Return all entries where the linked entry ID is 1, (or is not 1)

sql-null-or-not: 1: Return all entries where the linked entry ID is not 1 or the entry has no linked entries.

sql: NULL: Return all entries that do not have any linked entries

sql: NOT NULL: Return all entries that have a linked entry

Please note that predicate filters, such as not: or sql:, will ignore all other data source filters for that field.

Sorting

The sorting is activated only if ALL related field are sortable.

Right now, to be sortable, the related field must have a value column in the entries data.

- [#18](https://github.com/symphonycms/selectbox_link_field/issues/18) Show a message when there are no entries in a section
- Correctly fetch file name and other values using the Exportable interface
- Revert to saving NULL instead of 0 when no value is selected
- Updated Russian translation

- [#36](https://github.com/symphonycms/selectbox_link_field/issues/36) Add functionality to hide field in a prepopulated state
- [#35](https://github.com/symphonycms/selectbox_link_field/issues/35) Handle grouping on null values better
- When importing into the SBL field, if the data given is not entry ID's, attempt to find the entry ID's assuming the value we've been given is handles or values

- [#23](https://github.com/symphonycms/selectbox_link_field/pull/23) Fix invalid type error
- Add `ImportableField` and `ExportableField` support
- Fix issues where cached entries would not be unique (and therefore would no show in the backend)

- Implement `requiresSQLGrouping` function which prevents some oddities with pagination
- Preform some checks for `relation_id` to improve compatibility with extensions that extend the Select Box Link field.

- Fixed sort order of entries in select box. Corrected to use the column sort order. A bug in 1.13+ caused this particular issue to reappear. This fix is based on code by Nick Dunn initially introduced in 1.12.

- Fixed a couple of issues where 'related_field_id' was returning the wrong type. **@buzzomatic**
- In dropdown options, sort Sections by their Symphony order and sort Entries by their Symphony order (using EntryManager) **@nickdunn**
- Sort Sections in field's settings panel by Symphony order **@nickdunn**