Skip to content

Latest commit

 

History

History
90 lines (63 loc) · 2.68 KB

README.markdown

File metadata and controls

90 lines (63 loc) · 2.68 KB
Raw

Select Box Link Field Combo

It allows creation of chained selects in Admin.

1. Instalation

  1. Upload the 'selectbox_link_field_combo' folder in this archive to your Symphony 'extensions' folder.
  2. Enable it by selecting the "Field: Select Box Link Combo", choose Enable from the with-selected menu, then click Apply.
  3. You can now add the "Select Box Link Combo" field to your sections.

2. Usage

  • Works in an identical way to the standard SBL with some additions for parent relation.
  • Setting an instance of the field to be not required will cause an empty option to show up on the publish form.
  • Always the root of a chain will be a SBL.

The settings of Select Box Link Combo describe the behavior of the field. You will need to set the following:

  • Parent of the select. It will be another SBL / SBLC from current section.
  • Values the options which will populate the select.
  • Relation an external SBL (from another section) describing relations between Values and Parent.

3. Example

SBL = Select Box Link
SBLC = Select Box Link Combo

Lets say you have a Persons Section and each person has to be localized on the globe by Continent->Country->City. You would create the following sections to store the info:

Section Continents

  1. Text Input
    • name : Title

Section `Countries`
1. Text Input
- `name` : Title
2. Select Box Link (SBL\#1)
- `name` : Continent
- `values` : Continents->Title
Section `Cities`
1. Text Input
- `name` : Title
2. Select Box Link (SBL\#2)
- `name` : Country
- `values` : Countries->Title
Section `Persons`
1. Text Input
- `name` : Name
2. Select Box Link (SBL\#3)
- `name` : Continent
- `values` : Continents->Title
**SAVE the Section first. Next field needs SBL\#3's ID from Database**
3. Select Box Link Combo (SBLC\#1)
- `name` : Country
- `parent` : Persons->Continent (SBL\#3)
- `values` : Countries->Title
- `relation` : Countries->Continent (SBL\#1)
**SAVE the Section first. Next field needs SBLC\#1's ID from Database**
4. Select Box Link Combo (SBLC\#2)
- `name` : City
- `parent` : Persons->Country (SBLC\#1)
- `values` : Cities->Title
- `relation` : Cities->Country (SBL\#2)

Enjoy!