Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Vlad Ghita
committed
Dec 27, 2011
1 parent
ef15651
commit d41059d
Showing
2 changed files
with
127 additions
and
114 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,114 +1,92 @@ | ||
| Select Box Link Field Combo | ||
| ------------------------------------ | ||
|
|
||
| * Version: 1.1 | ||
| * Author: [Vlad Ghita](vlad_micutul@yahoo.com) | ||
| * Build Date: 2011-09-27 | ||
| * Requirements: | ||
| - Symphony 2.2 or greater. | ||
| - [Select Box Link Field](http://symphony-cms.com/download/extensions/view/20054/) | ||
|
|
||
| In short, it allows creation of chained select boxes in backend. | ||
|
|
||
| ##INSTALLATION## | ||
|
|
||
| 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. | ||
|
|
||
|
|
||
| ##UPDATING## | ||
|
|
||
| 1. Be sure to visit the Extension page in the Symphony admin and enable "Field: Select Box Link Combo" so the database is updated accordingly. | ||
|
|
||
|
|
||
| ##USAGE## | ||
|
|
||
| - Works in an identical way to the standard `select box link field` 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. One 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`. | ||
|
|
||
| ###EXAMPLE### | ||
|
|
||
| SBL = Select Box Link<br /> | ||
| 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. One would create the following sections to store the info: | ||
|
|
||
| Secition `Continents`<br /> | ||
| 1. Text Input<br /> | ||
| - `name` : Title | ||
|
|
||
| <br /> | ||
| Section `Countries`<br /> | ||
| 1. Text Input<br /> | ||
| - `name` : Title<br /> | ||
| 2. Select Box Link (SBL\#1)<br /> | ||
| - `name` : Continent<br /> | ||
| - `values` : Continents->Title | ||
|
|
||
| <br /> | ||
| Section `Cities`<br /> | ||
| 1. Text Input<br /> | ||
| - `name` : Title<br /> | ||
| 2. Select Box Link (SBL\#2)<br /> | ||
| - `name` : Country<br /> | ||
| - `values` : Countries->Title | ||
|
|
||
| <br /> | ||
| Persons<br /> | ||
| 1. Text Input<br /> | ||
| - `name` : Name<br /> | ||
| 2. Select Box Link (SBL\#3)<br /> | ||
| - `name` : Continent<br /> | ||
| - `values` : Continents->Title<br /> | ||
| **SAVE the Section first. Next field needs SBL\#3's ID from Database**<br /> | ||
| 3. Select Box Link Combo (SBLC\#1)<br /> | ||
| - `name` : Country<br /> | ||
| - `parent` : Persons->Continent (SBL\#3)<br /> | ||
| - `values` : Countries->Title<br /> | ||
| - `relation` : Countries->Continent (SBL\#1)<br /> | ||
| **SAVE the Section first. Next field needs SBLC\#1's ID from Database**<br /> | ||
| 4. Select Box Link Combo (SBLC\#2)<br /> | ||
| - `name` : City<br /> | ||
| - `parent` : Persons->Country (SBLC\#1)<br /> | ||
| - `values` : Cities->Title<br /> | ||
| - `relation` : Cities->Country (SBL\#2) | ||
|
|
||
| Enjoy! | ||
|
|
||
| <br /> | ||
| ## Compatibility ## | ||
|
|
||
| Symphony | Selectbox Link Combo | ||
| ---------------|--------------------- | ||
| 2.2 - 2.2.2 | [1.0beta2](https://github.com/vlad-ghita/selectbox_link_field_combo/tree/1.0beta2) | ||
| 2.2.3 - * | [latest](https://github.com/vlad-ghita/page_lhandles) | ||
|
|
||
| Selectbox Link | Selectbox Link Combo | ||
| ---------------|--------------------- | ||
| 1.18 - 1.19 | [1.0beta2](https://github.com/vlad-ghita/selectbox_link_field_combo/tree/1.0beta2) | ||
| 1.20 - * | [latest](https://github.com/vlad-ghita/page_lhandles) | ||
|
|
||
| <br /> | ||
| ##CHANGE LOG## | ||
|
|
||
| * 1.1, 27 September 2011 | ||
| * First stable release. | ||
| * Compatibility with [Selectbox Link v1.20](https://github.com/symphonycms/selectbox_link_field/tree/1.20) | ||
|
|
||
| * 1.0beta2 | ||
| * Field rewrite. Better error checking on field settings. | ||
| * New and improved JS (good job Nils) | ||
|
|
||
| * 1.0beta - Initial release. | ||
| Select Box Link Field Combo | ||
| =========================== | ||
|
|
||
| It allows creation of chained selects in Admin. | ||
|
|
||
| * Version: 2.2 | ||
| * Build Date: 2011-09-27 | ||
| * Authors: | ||
| - [Vlad Ghita](http://www.xanderadvertising.com) | ||
| * Requirements: | ||
| - Symphony 2.2.x | ||
| - [Select Box Link Field](https://github.com/symphonycms/selectbox_link_field) | ||
|
|
||
| Thank you all other Symphony Extensions developers for your inspirational work. | ||
|
|
||
|
|
||
|
|
||
| ## 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<br /> | ||
| 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`<br /> | ||
| 1. Text Input<br /> | ||
| - `name` : Title | ||
|
|
||
|
|
||
| <br /> | ||
| Section `Countries`<br /> | ||
| 1. Text Input<br /> | ||
| - `name` : Title<br /> | ||
| 2. Select Box Link (SBL\#1)<br /> | ||
| - `name` : Continent<br /> | ||
| - `values` : Continents->Title | ||
|
|
||
|
|
||
| <br /> | ||
| Section `Cities`<br /> | ||
| 1. Text Input<br /> | ||
| - `name` : Title<br /> | ||
| 2. Select Box Link (SBL\#2)<br /> | ||
| - `name` : Country<br /> | ||
| - `values` : Countries->Title | ||
|
|
||
|
|
||
| <br /> | ||
| Section `Persons`<br /> | ||
| 1. Text Input<br /> | ||
| - `name` : Name<br /> | ||
| 2. Select Box Link (SBL\#3)<br /> | ||
| - `name` : Continent<br /> | ||
| - `values` : Continents->Title<br /> | ||
| **SAVE the Section first. Next field needs SBL\#3's ID from Database**<br /> | ||
| 3. Select Box Link Combo (SBLC\#1)<br /> | ||
| - `name` : Country<br /> | ||
| - `parent` : Persons->Continent (SBL\#3)<br /> | ||
| - `values` : Countries->Title<br /> | ||
| - `relation` : Countries->Continent (SBL\#1)<br /> | ||
| **SAVE the Section first. Next field needs SBLC\#1's ID from Database**<br /> | ||
| 4. Select Box Link Combo (SBLC\#2)<br /> | ||
| - `name` : City<br /> | ||
| - `parent` : Persons->Country (SBLC\#1)<br /> | ||
| - `values` : Cities->Title<br /> | ||
| - `relation` : Cities->Country (SBL\#2) | ||
|
|
||
| Enjoy! |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,35 @@ | ||
| <?xml version="1.0" encoding="UTF-8"?> | ||
|
|
||
| <extension id="selectbox_link_field_combo" status="released" xmlns="http://symphony-cms.com/schemas/extension/1.0"> | ||
|
|
||
| <name>Select Box Link Field Combo</name> | ||
|
|
||
| <description>It allows creation of chained selects in Admin.</description> | ||
|
|
||
| <repo type="github">https://github.com/vlad-ghita/selectbox_link_field_combo</repo> | ||
|
|
||
| <url type="discuss">http://symphony-cms.com/discuss/thread/68202/</url> | ||
|
|
||
| <types> | ||
| <type>Field Types</type> | ||
| </types> | ||
|
|
||
| <authors> | ||
| <author> | ||
| <name github="vlad-ghita" symphony="vladG">Vlad Ghita</name> | ||
| <email>vlad.github@gmail.com</email> | ||
| <website>http://www.xanderadvertising.com</website> | ||
| </author> | ||
| </authors> | ||
|
|
||
| <dependencies> | ||
| <dependency version="1.0">https://github.com/symphonycms/selectbox_link_field</dependency> | ||
| </dependencies> | ||
|
|
||
| <releases> | ||
| <release version="1.0" date="2011-09-27" min="2.2.3"><![CDATA[ | ||
| * Initial release. | ||
| ]]></release> | ||
| </releases> | ||
|
|
||
| </extension> |