Update wording on Create New System Setting to identify the default Lexicon keys
everettg_99 created Redmine issue ID 6824
It would be more transparent for the user if when creating a new system setting that the required lexicon keys have to follow the format:
- setting_ + key
- setting_ + key + _desc
At a minimum, this format should be included on that form's description. A bit nicer would be a javascript auto-update thing that listed exactly what the lexicon keys have to be after the user had typed the name of the System Setting key, much like the page title updates when you type the title of a page.
See issue #6605
markh submitted:
By default that's what the "name" var is set to when it was left empty - but iirc can't you just type in whatever you want to use for custom settings?
everettg_99 submitted:
NO: you can't use whatever lexicon key you want. See issue #6605.
The thing that I'm getting at is it's completely opaque and very un-MODX to have this lexicon entry thing hard-coded -- even the fact that there is some behavior that kicks in if you leave the field empty is confusing. I didn't know that... is that documented? Is the user made aware of this "under the table" stuff?
I would expect that I could use any lexicon key I want for the setting's name and description, but due to the nature of it, my understanding is that the lexicon keys MUST be named a very specific way. I've run into that several times before, and each time it throws me for an hour so. Surely, I'm not the only one baffled by this behavior, thus the request to list that naming convention right there when you create or edit the system setting, otherwise it will continue to confuse folks and waste time.