def method(self, field1, field2=None):
    ...

def method(self):
    request = self.request 
    field1 = request.form['field1']
    field2 = request.form.get('field2', None)

2.2. How to use currentFormVar on multiselect widgets?

Instead of currentFormVar and formVar please consider using the following to send up an entire form:

action-server:                     myServerAction;
myServerAction-kssSubmitForm:      currentForm();

This has the disadvantage that it sends up all form fields, but it works naturally with all the :list, etc. variables.

In the future we plan to implement a way to filter fields in this construct.

Please also have a look at kss.demo, there is an example case.

For developing or debugging kss in Plone, we use the FireFox browser In addition we use the following extensions:

• FireBug, this is inevitable for introspecting nodes and viewing the kss log
• Web Developer, contains a useful menu bar to complement FireBug

On Safari, the kss log is placed into the console. On IE, the Firebug Lite can be used.

• Reload your page in IE. Pressing F12 toggles the tool in the bottom of the page area. The functionality is very simple: it comes with a console and an area to show kss logs.

It also works in Safari.

It is harmless to enable this file for all the time during development.

To do development, it is a good idea to avoid caching, otherwise you change some file, but the result will not be shown.

To achieve this, first you must disable caching from your browser. The Firefox Developer Extension gives a convenient switch for this. You can also force the browser to reload the page each time manually.

Second, if you change kss files you need to switch portal_kss tool to Debug mode, similarly if you change javascript you need to do similarly with portal_javascripts, to have your changes in effect without restarting Zope. Restarting after each change is another option.

kss.core in lib/python of your instance contains the server side python, and the javascript of kss, including the core kss plugins.

Versioning is summarized int he following table:

Kss runs in Production mode as default. This means that although you will get a visible javascript error, the error message will be meaningless. In return the javascript code is slightly faster and more compact.

You can switch at any time to Development mode, to see the error. Visit the url anywhere in your portal: @@kss_devel_mode/ui. You can switch between the two modes and currently active mode is displayed. After that, you need to reload your page to operate it in the selected mode.

This setting works with browser cookies. So you can use this method to debug a production server. However if Debug mode is switched on in the portal_javascripts tool, kss will always operate in Development mode, regardless of the cookie setting. If yyou have one instance that you use for development continously, this may also be a comfortable way of switching.

Kss bugs in kss.core should go into the kss bug tracker. Besides a detailed description of your problem, you should give in particular

• your browser version where you discovered it,
  
• and the kss log transcript from the loading of the page until the error, including the full traceback, copypasted from Firebug. To do this you must run kss in Development mode, as described in 4.7.

If you report a bug on IE, you need to copy the kss log transcript from Firebug Lite, after enabling it as described in point 4.2.

Switch on KSS Development Mode as described in 4.7.

Visit your error_log object from the ZMI, and remove Unauthorized and NotFound from the filter. Save.

Restart Zope, and reload your page in the client. You are supposed to see any log now, both on the client side (kss log console) and the server side (event.log).

If you have an Unauthorized bug, please enable VerboseSecurity as described here, and attach the information to the report.