ClientConfig gives your client a user-friendly interface for making site wide changes, while you as the administrator set up the different options available to the end-user.

New in ClientConfig 2.0: context-aware settings!

Possible uses include:

• Regularly update a slogan or tag-line in header or footer
• Change call-to-action button colors based on the season
• Keep contact details updated in one central location
• Update the email-address a form sends notifications to.

Please report bugs and feature requests on Github, and chat about it on the Forums.

Installation Instructions

To install, simply grab the package through package manager and install it. Navigate to the component in the components directory, hit the admin button in the top right, and start configuring settings for your clients to maintain. 

You can use the values from the settings by using either the system setting tag syntax [[++key]], or by using $modx->getOption('key') in code. 

For further information, refer to the documentation.

ClientConfig 2.1.0-pl :: 2018-12-05

• Update menu to no longer rely on modAction, instead using namespace routing [#158, #139]
• Fix image/file fields not refreshing when switching context [#147, #155]
• Adjust plugin to accept both OnMODXInit and OnHandleRequest so you can change the event it runs on, if needed [#140]
• Prevent events (i.e., priority) from being overwritten on upgrade [#148]

ClientConfig 2.0.0-pl :: 2018-06-26

• Don't add _duplicate to the key when duplicating a setting [#142]
• Updated German [#141], Russian [#145] and Dutch translations

ClientConfig 2.0.0-rc1 :: 2017-10-04

• ClientConfig can now (optionally) manage settings for different contexts [#4/#112]
• Media fields (image/file) now prefix the media source url [#124]
• Allow snippet/chunk tags in options for the dropdown field [#104]
• Updated minimum requirements to PHP 5.5.0 and MODX 2.5.2. 
• Added separate clientconfig.categories lexicon for the vertical tabs interface [#91]

ClientConfig 1.4.2-pl :: 2017-07-22

• Restore PHP 5.3 compatibility in creating settings. Note: next release will require 5.5+!
• Fix issue saving settings on certain environments due to missing value for source [#129]
• Fix incorrect header/container alignment in both manager pages [#128]
• Fix (unused) namespace assets path (on new installs) [#126]

ClientConfig 1.4.1-pl :: 2017-02-01

• Fix bug where the new source dropdown does not appear for image field types

ClientConfig 1.4.0-pl :: 2017-01-31

• Fix loading of TinyMCE RTE, causing it to be initialised without configuration [#122]
• Add ClientConfig_ConfigChange event to be able of hooking into configuration changes [#117]
• Change plugin event from OnHandleRequest to OnMODXInit [#87, #109, #115]
• Enable inline editing in the admin component [#94, #95, #114]
• Fix field-required errors not being shown by adding a popup
• Accept 0 as valid required value on the number input [#119]
• Add a Password input type [#105]
• Add a File input type [#36]
• Don't show "Error adding field" errors during installation/upgrade [#92]
• Fix loading RTE if the field key contains a dot [#89]
• Add CMD/CTRL + S shortcut for saving the configuration [#80]
• Preserve linebreaks when editing a setting in the admin section by using a textarea for the value [#69]
• Relicense under the MIT license instead of GPL [#67]
• Allow specifying a media source for the image input type [#66]

ClientConfig 1.3.2-pl :: 2015-12-09

• Update French translation
• Make sure image field uses the MODX default media source
• Respect manager_date_format and manager_time_format settings

ClientConfig 1.3.1-pl :: 2014-07-20 

• Update Dutch translation
• More weird border fixes
• Minor fix to when borders are added, specifically for 2.2.

ClientConfig v1.3.0 :: July 19th, 2014

• #27  Ability to import/export groups and settings
• #16  Auto-select first group when adding a setting
• #15  Force admins to create a group before creating a setting, as settings need groups
• #76  Fix issue where unchecking a checkbox would fail if the setting was required
• #78  Make the is_required column show Yes/No instead of true/false
• #60  Get rid of an extra border
• #75  Update help link to point to modmore.com

ClientConfig v1.2.1 :: January 7th, 2014 

• #57  Add Google Font input type (Thanks @garryn)
• #63  Fix issue loading more than one rich text field

ClientConfig v1.2.0 :: August 16th, 2013 (modmore.com) / November 14th, 2013 (modx.com)

• #38  Add setting (vertical_tabs) to allow stacking groups vertically instead of horizontal tabs
• #46  Add ability to duplicate a setting
• #45  Show field options field when editing a select box setting.
• #54  Add Rich Text input type.
• Improved width consistency of input items.
• #37  Added input type Image (thanks COEX!)
• #3   Fix/add colorpicker input type (thanks COEX!)

ClientConfig v1.1.2 :: March 7th, 2012

• Add/update translations: Russian (thx @Alroniks!), German (thx @enigmatic-user!), Swedish (thx @fractalwolfe!) and Dutch.
• #47  Show field descriptions under the fields. (Thanks @fractalwolfe!)
• #40  Add placeholder tooltips with the [[++key]] for admins. (Thanks @fractalwolfe!)

ClientConfig v1.1.1 :: December 31st, 2012

• #35  Don't strip out tags when saving values.
• #39  Increase database field max sizes for longer descriptions and values.
• #33  Make sure to show message when no tabs are to be shown.
• #34  Prevent E_WARNING when there are no settings configured.

ClientConfig v1.1.0 :: December 16th, 2012

• #26  Add ability to manually sort Settings within a Group
• #25  Add ability to manually sort Groups
• #21  Add Filter on Group for settings.
• #24  Remember last visited tab in both admin and client view.
• #22  Add "Help!" button on Admin panel linking to RTFM instructions.
• Improve checking if key exists on updating a setting.
• #30  Fix bug with incorrectly checking cgSetting.is_required checkbox
• Make controller a tad more portable.

ClientConfig v1.0.0 :: December 9th, 2012

Initial release.