__('General site settings', __FILE__),
'summary' => __('Module that stores global site settings', __FILE__),
'version' => 121,
'permanent' => false,
'autoload' => true,
'icon' => 'sliders',
'page' => array(
'name' => 'general_settings',
'parent' => 'setup',
'title' => 'General settings',
),
'permission' => 'general-settings',
"permissions" => ["general-settings" => "Access general settings"],
//'permissionMethod' => 'permissionCheck',
);
}
protected static $defaults = array(
'global' => 'g_settings',
'settings' => '{"0":{"api":"title","label":"Your site title","type":"Text","width":"100","description":"","select":""}}',
);
public static function permissionCheck(array $data) {
$user = $data['user'];
$wire = $data['wire'];
// if in admin/backend, then require "my-custom-permission" permission
if(strpos($wire->input->url, $wire->config->urls->admin) === 0 && !$user->hasPermission('general-settings')) {
return true;
}
// else in frontend, so allow full access to call actions via the API
else {
return true;
}
}
public function init() {
//load styles for backend
if ($this->wire('user')->isLoggedin() && $this->input->get('name') == __CLASS__) {
$root = $this->config->urls->siteModules . __CLASS__;
$this->config->styles->prepend($root . '/' . 'SettingsStyles.css');
$this->config->scripts->add($root . '/' . 'SettingsJS.js');
}
//register wire 'global'
if (isset($this->data['global'])) {
$this->wire($this->data['global'], $this);
}
if (!isset($this->data['settings'])) {
parent::init();
return;
}
//set api as key with value as value
//it makes it callable $settings->key
$langData = array();
$data = json_decode($this->data['settings'], true);
foreach ($data as $key => $field) {
if (!isset($field['api'])) continue;
$value = (isset($field['value']) ? $field['value'] : '');
if ($field['type'] == 'Textarea') {
$value = nl2br($value);
}
if ($this->user->language) {
//if api ends with language name: site_name_polish, add its value to langData array
//so if user language is polish calling site_name will return its polish value
if (strpos($field['api'], '_'.$this->user->language->name) !== false) {
//$api without language suffix - site_title
$api = str_replace('_'.$this->user->language->name, '', $field['api']);
foreach ($data as $k => $f) {
if ($f['api'] === $api) {
$langData[$api] = $field['value'];
}
}
}
}
$this->set($field['api'], $value);
}
foreach ($langData as $key => $value) {
$this->set($key, $value);
}
parent::init();
}
public function ___execute() {
if ($this->input->post('submit_save')) {
return $this->renderForm($this->saveValues());
//wire('session')->redirect(wire('page')->url);
} else {
return $this->renderForm();
}
}
/**
* Render all settings with basic markup
*
* @return string markup
*
*/
public function render() {
$out = '';
foreach (json_decode($this->data['settings'], true) as $key => $field) {
if (isset($field['api']) && $field['type'] != 'Fieldset') {
$v = (isset($field['value'])) ? $field['value'] : '';
$out .= $this->wire('sanitizer')->entities($field['label'])
. ' ('. $field['api'] . ') => '
. nl2br($this->wire('sanitizer')->entities($v)) . '
';
}
}
return $out .'
';
}
/**
* Render form for admin page
*
* @return string form markup
*
*/
protected function renderForm($settings=null) {
if (!isset($this->data['settings'])) {
return 'Create settings in module configuration first.';
}
$data = $this->data;
$attrs = json_decode( $settings ?:$data['settings'], true);
if ($attrs === null) {
return 'Error decoding settings data.';
}
$form = $this->modules->get('InputfieldForm');
$form->attr('id', 'SettingsModule');
$form->attr('action', $this->wire('page')->url );
$parent = $form;
foreach ($attrs as $fset) {
$field = $this->modules->get('Inputfield'.$fset['type']);
$value = (isset($fset['value']) ? $fset['value'] : '');
//------- NEW --------
if($fset['type'] == 'FieldsetClose') {
$parent = $form;
continue;
}
//------- END NEW --------
if (!$field) {
$this->message('Unable to find field type ' .$fset['type']);
continue;
}
//set attrbs for all type of fields
$field->label = $fset['label'];
$field->columnWidth = (intval($fset['width']) >=10) ? $fset['width'] : 100;
$field->description = $fset['description'];
//------- NEW --------
// Placeholder
$field->placeholder = isset($fset['placeholder']) ? $fset['placeholder'] : '';
// Collapsed
if(isset($fset['collapsed']) && $fset['collapsed'] != 'Default') {
if($fset['collapsed'] == 'collapsedNever') $field->collapsed = Inputfield::collapsedNever;
if($fset['collapsed'] == 'collapsedBlank') $field->collapsed = Inputfield::collapsedBlank;
if($fset['collapsed'] == 'collapsedYes') $field->collapsed = Inputfield::collapsedYes;
}
// Markup
if ($fset['type'] == 'Markup') {
$field->markupText = '' . $fset['description'] . '
';
$field->description = '';
}
//------- END NEW --------
if ($fset['type'] == 'Checkbox') {
$field->uncheckedValue = '0';
if($value === '1') {
$field->setAttribute('checked', 'checked');
}
}
if ($fset['type'] == 'URL') {
$field->set('noRelative', 1);
}
if ($fset['type'] == 'Select' || $fset['type'] == 'Radios') {
foreach (explode(',', trim($fset['select'], ',')) as $label) {
//value, label, attr
$v = $this->wire('sanitizer')->name($label);
if ($value == $v) {
$field->addOption($v, $label, array('selected' => 1));
} else {
$field->addOption($v, $label);
}
}
}
if ($fset['type'] == 'Integer') {
$field->setAttribute('type', 'number');
}
//fieldset or normal field
if ($fset['type'] == 'Fieldset') {
$field->addClass('fset_red');
$parent = $field;
$form->append($field);
} else {
$field->attr('name', $fset['api']);
$field->attr('value', $value);
$parent->append($field);
}
}
// $f = $this->modules->get('InputfieldTextarea');
// $f->label = __('Export/Backup These Settings');
// $f->attr('name+id', 'export_settings');
// $f->attr('value', $this->data['settings']);
// $f->collapsed = Inputfield::collapsedYes;
// $form->add($f);
// $f = $this->modules->get('InputfieldTextarea');
// $f->label = __('Import/Restore Settings');
// $f->attr('name', 'import_settings');
// $f->attr('value', isset($this->data['import_settings']) ? $this->data['import_settings'] : '' );
// $f->collapsed = Inputfield::collapsedYes;
// $form->add($f);
$f = $this->modules->get('InputfieldSubmit');
$f->attr('name', 'submit_save');
$f->attr('value', $this->_('Save'));
$f->addClass('head_button_clone');
$f->icon = 'save';
$form->add($f);
return $form->render();
}
/**
* Save values provided by user to module config data
*
*/
protected function saveValues() {
// if($this->wire('input')->post->import_settings != '') {
// $this->message('Site settings restored');
// return $this->wire('input')->post->import_settings;
// }
$old = $this->data;
$data = json_decode($old['settings'], true);
$new = array();
foreach ($data as $key => $field) {
$new[$key] = $field;
$new[$key]['value'] = $this->wire('input')->{$field['api']};
}
$old['settings'] = json_encode($new);
wire('modules')->saveModuleConfigData($this, $old);
$this->message('Site settings saved');
return $old['settings'];
}
static public function getModuleConfigInputfields(array $data) {
$data = array_merge(self::$defaults, $data);
$options = array();
$values = array();
$json = (isset( $data['settings'] )) ? json_decode($data['settings'], true) : '';
// if(isset($data['settings_import']) && $data['settings_import'] != '') {
// $json = json_decode($data['settings_import'], true);
// $data['settings'] = $data['settings_import'];
// $data['settings_import'] = '';
// }
foreach ($json as $key => $value) {
if ($value['type'] == 'Fieldset' || $value['type'] == 'FieldsetClose') {
$options[$value['api']] ='-- '. $value['label'] . ' -- ' . $value['width'] . '%';
} else {
$options[$value['api']] = $value['label'] . ' ('. $value['api'] .') - ' . $value['width'] . '%';
}
$values[] = $value['api'];
}
$order = array();
$fields = new InputfieldWrapper();
$modules = wire('modules');
//------------------------------------------
$field = $modules->get("InputfieldMarkup");
$field->label = __("Help", __FILE__);
$help = ('API variable - Any combination of letters (a-z), numbers (0-9) and underscores (no spaces).
You can call it in template files to output a value ($settings->site_name will return "My site").
IMPORTANT: take care to not overload ProcessWire properties ($page, $user, etc.). It must be unique across all settings.
Label - descriptive name for a backend user
Description - longer explanation shown as notes in ProcessWire backend
Width - field width in %, set between 10 and 100
Options for select or radios - this will be used as names and labels, the best one word only');
$field->entityEncodeText = false;
$field->entityEncodeLabel = false;
$field->attr('value', $help);
$field->collapsed = Inputfield::collapsedYes;
$fields->append($field);
//------------------------------------------
$field = $modules->get("InputfieldText");
$field->attr('name', 'global');
$field->label = __("Global name", __FILE__);
$field->attr('value', $data['global']);
$field->description = __('Use to call settings property in frontend ($settings->property).', __FILE__);
$field->notes = __("After changing make sure to change it in your template files.", __FILE__);
$field->collapsed = Inputfield::collapsedYes;
$fields->append($field);
//------------------------------------------
$field = wire('modules')->get("InputfieldTextarea");
$field->attr('name', 'settings');
$field->attr('id', 'settings');
$field->label = __("Json data", __FILE__);
$field->attr('value', $data['settings']);
$field->columnWidth = 34;
$field->collapsed = Inputfield::collapsedYes;
$fields->append($field);
//------------------------------------------
// $field = wire('modules')->get("InputfieldTextarea");
// $field->attr('name', 'settings_import');
// $field->attr('id', 'settings_import');
// $field->label = __("Import Settings Config", __FILE__);
// $field->attr('value', $data['settings_import']);
// $field->collapsed = Inputfield::collapsedYes;
// $fields->append($field);
//------------------------------------------
$field = $modules->get("InputfieldAsmSelect");
$field->attr('name', 'order');
$field->attr('id', 'ASMOrder');
$field->label = __("Settings", __FILE__);
$field->addOptions($options);
$field->attr('value', $values);
$fields->append($field);
return $fields;
}
}