293 lines
8.7 KiB
Text
293 lines
8.7 KiB
Text
<?php namespace ProcessWire;
|
|
|
|
/**
|
|
* AsmSelect is a sortable multiple-select Inputfield
|
|
*
|
|
* Copyright (c) 2009-2022 by Ryan Cramer
|
|
*
|
|
* @property bool $addable Can items be added to selection? (default=true)
|
|
* @property string $addItemTarget Where to place new selected items in list: top or bottom (default='bottom')
|
|
* @property bool $animate Animate the the adding/removing of items in the list? (default=false)
|
|
* @property bool $debugMode Debug mode keeps original select visible (default=false)
|
|
* @property bool $deletable Can items be removed from selection? (default=true)
|
|
* @property float|string $deletedOpacity Opacity of deleted item, set to 1.0 to disable opacity adjustment (applicable only if hideDeleted=true)
|
|
* @property string $deletedPrepend Deleted item values are prepended with this character in the form submission (applicable only if hideDeleted=true) (default='-')
|
|
* @property string $editLabel Text used in the "edit" link (if editLink is populated)
|
|
* @property string $editLink Optional URL options can link to with tag {value} replaced by option value, i.e. /path/to/page/edit?id={$value}
|
|
* @property string $editLinkButtonSelector Button selector for finding buttons that should become modal window buttons
|
|
* @property string|bool $editLinkModal Whether the edit link (if used) should be modal or "longclick" for longclick modal only (default=true)
|
|
* @property bool $editLinkOnlySelected When true, edit link only appears for items that were already selected (default=true)
|
|
* @property bool $fieldset Use fieldset support? (for PW Fieldset types) (default=false)
|
|
* @property bool $hideDeleted Hide items when deleted. If false, items remain but are marked for deletion (default=true)
|
|
* @property bool $hideWhenEmpty Hide the <select> when there are no items available to select? (default=false)
|
|
* @property bool $highlight Use the highlight feature? (default=false)
|
|
* @property string $highlightAddedLabel Text that precedes highlight of added item (default='Added: ')
|
|
* @property string $highlightRemovedLabel Text that precedes highlight of removed item (default='Removed: ')
|
|
* @property string $removeLabel Text used in the "remove" link
|
|
* @property bool $sortable Should the list be sortable? (default=true)
|
|
* @property string $sortLabel Sortable handle/icon
|
|
* @property int|bool $usePageEdit Use page editor links for selected Page items, when user has edit permission? (default=false)
|
|
*
|
|
*/
|
|
class InputfieldAsmSelect extends InputfieldSelectMultiple implements InputfieldHasArrayValue, InputfieldHasSortableValue {
|
|
|
|
/**
|
|
* Module info
|
|
*
|
|
* @return array
|
|
*
|
|
*/
|
|
public static function getModuleInfo() {
|
|
return array(
|
|
'title' => __('asmSelect', __FILE__),
|
|
'version' => 203,
|
|
'summary' => __('Multiple selection, progressive enhancement to select multiple', __FILE__), // Module Summary
|
|
'permanent' => true,
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Custom defined AsmSelect options
|
|
*
|
|
* @var array
|
|
*
|
|
*/
|
|
protected $asmOptions = array();
|
|
|
|
/**
|
|
* Options as specified at init() state (common to all instances)
|
|
*
|
|
* @var array
|
|
*
|
|
*/
|
|
protected $asmDefaults = array();
|
|
|
|
/**
|
|
* Common option names for asmSelect
|
|
*
|
|
* (note this array gets flipped in the constructor)
|
|
*
|
|
* @var array
|
|
*
|
|
*/
|
|
protected $asmOptionNames = array(
|
|
// general
|
|
'addable',
|
|
'addItemTarget',
|
|
'animate',
|
|
'debugMode',
|
|
'deletable',
|
|
'deletedOpacity',
|
|
'deletedPrepend',
|
|
'fieldset',
|
|
'hideDeleted',
|
|
'hideWhenEmpty',
|
|
'highlight',
|
|
'jQueryUI',
|
|
'sortable',
|
|
|
|
// labels
|
|
'editLabel',
|
|
'highlightAddedLabel',
|
|
'highlightRemovedLabel',
|
|
'removeLabel',
|
|
'sortLabel',
|
|
|
|
// edit link
|
|
'editLink',
|
|
'editLinkButtonSelector',
|
|
'editLinkModal',
|
|
'editLinkOnlySelected',
|
|
);
|
|
|
|
/**
|
|
* Construct
|
|
*
|
|
*/
|
|
public function __construct() {
|
|
$this->set('usePageEdit', 0);
|
|
$this->asmOptionNames = array_flip($this->asmOptionNames);
|
|
parent::__construct();
|
|
}
|
|
|
|
/**
|
|
* Init
|
|
*
|
|
*/
|
|
public function init() {
|
|
|
|
parent::init();
|
|
|
|
$this->setAsmSelectOptions(array(
|
|
'sortable' => true,
|
|
'fieldset' => false,
|
|
|
|
// an optional edit or detail link where items can be modified or viewed
|
|
// i.e. /path/to/page/?id={value} where {value} is replaced with option value
|
|
'editLink' => '',
|
|
'editLabel' => "<i class='fa fa-fw fa-edit asmIcon'></i>",
|
|
|
|
// only applicable if editLink is set. set to false if you don't want edit link to be modal
|
|
'editLinkModal' => true,
|
|
));
|
|
|
|
if($this->wire('adminTheme')) $this->setAsmSelectOptions(array(
|
|
// replace jquery ui icon default with a font-awesome icon
|
|
'removeLabel' => "<i class='fa fa-trash'></i>",
|
|
|
|
// replace jquery ui icon default with a font-awesome icon
|
|
'sortLabel' => "<i class='fa fa-fw fa-arrows'></i>",
|
|
));
|
|
|
|
// cancel the 'size' attribute used by select multiple
|
|
$this->set('size', null);
|
|
|
|
$this->wire()->config->js('InputfieldAsmSelect', $this->asmOptions);
|
|
$this->asmDefaults = $this->asmOptions;
|
|
}
|
|
|
|
/**
|
|
* Set Inputfield property or AsmSelect option
|
|
*
|
|
* @param string $key
|
|
* @param mixed $value
|
|
* @return Inputfield|InputfieldAsmSelect|InputfieldSelect
|
|
*
|
|
*/
|
|
public function set($key, $value) {
|
|
if(isset($this->asmOptionNames[$key])) return $this->setAsmSelectOption($key, $value);
|
|
return parent::set($key, $value);
|
|
}
|
|
|
|
/**
|
|
* Set custom option for AsmSelect
|
|
*
|
|
* @param string $key
|
|
* @param string|bool $value
|
|
* @return self
|
|
*
|
|
*/
|
|
public function setAsmSelectOption($key, $value) {
|
|
$this->asmOptions[$key] = $value;
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Set multiple custom options for AsmSelect
|
|
*
|
|
* @param array $options
|
|
* @return self
|
|
* @since 3.0.169
|
|
*
|
|
*/
|
|
public function setAsmSelectOptions(array $options) {
|
|
$this->asmOptions = array_merge($this->asmOptions, $options);
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Called before render()
|
|
*
|
|
* @param Inputfield $parent
|
|
* @param bool $renderValueMode
|
|
* @return bool
|
|
*
|
|
*/
|
|
public function renderReady(Inputfield $parent = null, $renderValueMode = false) {
|
|
|
|
$modules = $this->wire()->modules;
|
|
$config = $this->wire()->config;
|
|
|
|
// asmSelect requires jQuery UI, so we enforce it being loaded here
|
|
$modules->get('JqueryCore');
|
|
|
|
/** @var JqueryUI $jQueryUI */
|
|
$jQueryUI = $modules->get('JqueryUI');
|
|
|
|
if(!empty($this->asmOptions['editLink'])) {
|
|
$jQueryUI->use('modal');
|
|
}
|
|
|
|
if($this->hasFieldtype == 'FieldtypePage' && $this->usePageEdit && empty($this->asmOptions['editLink'])) {
|
|
$this->setAsmSelectOptions(array(
|
|
'editLink' => $config->urls->admin . 'page/edit/?id={value}',
|
|
'editLinkOnlySelected' => false,
|
|
'editLinkButtonSelector' => '.InputfieldSubmit button.ui-button:visible',
|
|
'editLinkModal' => true,
|
|
));
|
|
}
|
|
|
|
// require javascript and css
|
|
$class = $this->className();
|
|
$info = self::getModuleInfo();
|
|
$ver = $config->version . '-' . $info['version'];
|
|
$jsfile = $config->debug ? 'jquery.asmselect.js' : 'jquery.asmselect.min.js';
|
|
$url = $config->urls($class);
|
|
|
|
$config->scripts->add($url . "asmselect/$jsfile?v=$ver");
|
|
$config->styles->add($url . "$class.css?v=$ver");
|
|
$config->styles->add($url . "asmselect/jquery.asmselect.css?v=$ver");
|
|
|
|
// $this->config->js($this->id, $this->asmOptions); // deprecated/legacy
|
|
|
|
return parent::renderReady($parent, $renderValueMode);
|
|
}
|
|
|
|
/**
|
|
* Render
|
|
*
|
|
* @return string
|
|
*
|
|
*/
|
|
public function ___render() {
|
|
|
|
// compile settings unique to this instance into a JSON encoded data-asmopt attribute
|
|
$settings = array();
|
|
foreach($this->asmOptions as $key => $value) {
|
|
if(!isset($this->asmDefaults[$key]) || $this->asmDefaults[$key] != $value) {
|
|
$settings[$key] = $value;
|
|
}
|
|
}
|
|
$this->attr('data-asmopt', json_encode($settings));
|
|
|
|
// ensure selected options are placed as last in the AsmSelect select output
|
|
$selectedOptions = $this->attr('value');
|
|
foreach($selectedOptions as $id) {
|
|
if(!isset($this->options[$id])) continue;
|
|
$label = $this->options[$id];
|
|
unset($this->options[$id]);
|
|
$this->addOption($id, $label);
|
|
}
|
|
|
|
return parent::___render();
|
|
}
|
|
|
|
/**
|
|
* Field config
|
|
*
|
|
* @return InputfieldWrapper
|
|
*
|
|
*/
|
|
public function ___getConfigInputfields() {
|
|
|
|
$inputfields = parent::___getConfigInputfields();
|
|
if($this->hasFieldtype != 'FieldtypePage' || !$this->hasField) return $inputfields;
|
|
|
|
/** @var InputfieldRadios $f */
|
|
$f = $this->wire()->modules->get('InputfieldRadios');
|
|
$f->attr('name', 'usePageEdit');
|
|
$f->label = $this->_('Link selected pages to page editor?');
|
|
$f->description = $this->_('When enabled, the selected label(s) will link to edit the selected page.');
|
|
$f->addOption(0, $this->_('No'));
|
|
$f->addOption(1,
|
|
$this->_('Yes') . ' ' .
|
|
$this->_('(in modal window)')
|
|
);
|
|
$f->attr('value', $this->usePageEdit);
|
|
$f->optionColumns = 1;
|
|
$f->collapsed = Inputfield::collapsedBlank;
|
|
$inputfields->add($f);
|
|
|
|
return $inputfields;
|
|
}
|
|
}
|