jQuery config

[lillebitte]

I have just updated my cms, but now I do not know how to config the jQuery plugin. Can someone point me to a page that can inform me about the settings, so I can decide which setting to use? There are some hints next to some of the settings, but it does not help me to decide whether to use it or not.

What I have done so far is to
1) select the highest version available for 'Core' and 'UI'.
From here I am lost
2) Then I can select 'Migrate' - but I have no idea whatsoever for what it is all about - migrating what?? - or which version to select - 'jquery-migrate-3.0.0.js' or 'jquery-migrate- 3.0.0.min.js'?
3) Then I can activate 'Migrate'. The clue gives me no information that I have not guessed already, 'Whether to load the Migrate-plugin or not.' Why I should or why I should not I do not know.
4) 'Autoload' - Why or why not, e.g. what is it good for?
5) 'Libraries' - Why or why not, e.g. what is it good for?

I have had a look at the help link, but that only seems to be relevant to developers or theme designers. I want to know how to set up the site for plain use, maybe with some additional plugins.

I would like to be able to recommend this ingenious CMS to cms newbies too, but then has to actually be simple, not only by name.
Having said all that I am very pleased to be a CMSimple_XH user

[cmb]

I have just updated my cms, but now I do not know how to config the jQuery plugin. Can someone point me to a page that can inform me about the settings, so I can decide which setting to use? There are some hints next to some of the settings, but it does not help me to decide whether to use it or not.

Indeed, this documentation is missing.

select the highest version available for 'Core' and 'UI'.

That is not necessarily the best option. Most importantly is that jQuery 1.x still supports IE <= 8, but jQuery 2.x and 3.x don't. Secondly, jQuery 1.x is probably best for compatibility with existing plugins; jQuery 3.x is likely to cause some issues. jQuery 2.x is in between.

Then I can select 'Migrate' - but I have no idea whatsoever for what it is all about - migrating what?? - or which version to select - 'jquery-migrate-3.0.0.js' or 'jquery-migrate- 3.0.0.min.js'?

The migrate plugin serves two purposes: it improves backward compatibility and it gives info about potential incompatibilities. The min version only does the former, so unless you want to debug or report issues, the min version is preferable.

It is important that the major version number of the migrate plugin matches the major version number of jQuery. So for jQuery 2.x there is no migrate plugin.

'Autoload' - Why or why not, e.g. what is it good for?

Some templates and Addons require autoloading jQuery and sometimes jQueryUI. In this case you have to enable autoloading, and choose the needed libraries. Otherwise it's fine to disable autoload.

[lillebitte]

Thanks for enlighten me on this issue.
I suggest that next to each setting you recommend a standard configuration.
Eg. in the drop down list "1.12.4.(Standard)", "Migrate (Standard:Activated)"
Is it ok to make such suggestions here or do I have to do it in the bug forum?

[Holger]

Is it ok to make such suggestions here or do I have to do it in the bug forum?

Best place is the Open Development forum, since it's not a real bug. But it's fine here too.
You're right, the update instructions and the documentation of the jQuery-plugin give us some room for improvement . The next jQuery-Plugin will have better descriptions for all options. And I'm thinking about a way to auto-select the correct migrate-version depending on the selected jQuery core version.

[lillebitte]

Sounds fine. Keep up the good work!