About
This module allows us to sort the elements of a field which has the select list
widget.
Usage
For example:
We have a field called Months, which is a "List (text)" field with the "Select list" widget. In the "Allowed values list" for this field we have the following values:
January|January
February|February
March|March
April|April
May|May
June|June
July|July
August|August
September|September
October|October
November|November
December|DecemberIn the "SORT OPTIONS" fieldset:
- Check "Apply sort option";
- Choose "Order by" - order by text or by the selected value;
Explanation: If we will inspect (using FireBug or else) the Months element
from the form, we will have the following:
<select id="edit-field-months-und" name="field_months[und]"
class="form-select">
<option value="_none">- None -</option>
<option value="April">April</option>
<option value="August">August</option>
...
<option value="November">November</option>
<option value="October">October</option>
<option value="September">September</option>
</select> Based on the code above, the "value" for an option will be "_none"
and the text will be "- None -".
- Choose "Sort" - Ascending or Descending.
In our given form, we will be able to see the elements sorted by the chosen
criteria.
Furthermore, it is possible to add 2 new attributes for the custom created
forms: "#sort_order" and "#order_by".
"#sort_order" - may contain values as "asc" or "desc" and
"#order_by" may contain values as "text" or "value".
For example:
<?php
$form['selected_my_data'] = array(
'#type' => 'select',
'#title' => t('Selected Integer'),
'#options' => array(
'zero' => t('Zero'),
'one' => t('One'),
...
'seven' => t('Seven'),
'seven' => t('Six'),
'two' => t('Two'),
),
'#default_value' => 'nine',
'#order_by' => 'text', // May contain values as "text" or "value".
'#sort_order' => 'asc', // May contain values as "asc" or "desc".
);
?>As specified in the code above, the options for this element will be ordered by
text and ascendingly sorted.
For more details, please view this video: http://www.youtube.com/watch?v=7eYkUA28gvw
Note
At the moment a select list with the "Check boxes/radio buttons" widget cannot be sorted.
Thanks.
Downloads
Project Information
- Maintenance status: Minimally maintained
- Development status: Maintenance fixes only
- Module categories: Content, Content Display, Fields
- Reported installs: 16 sites currently report using this module. View usage statistics.
- Downloads: 54
- Last modified: February 27, 2013
