| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263 |
- Upgrading from ctools-6.x-1.x to ctools-7.x-2.x:
- - Remove ctools_ajax_associate_url_to_element as it shouldn't be necessary
- with the new AJAX api's in Drupal core.
- - All calls to the ctools_ajax_command_prepend() should be replace with
- the core function ajax_command_prepend();
- This is also the case for append, insert, after, before, replace, html,
- and remove commands.
- Each of these commands have been incorporated into the
- Drupal.ajax.prototype.commands.insert
- function with a corresponding parameter specifying which method to use.
- - All calls to ctools_ajax_render() should be replaced with calls to core
- ajax_render(). Note that ctools_ajax_render() printed the json object and
- exited, ajax_render() gives you this responsibility.
- ctools_ajax_render()
- becomes
- print ajax_render();
- exit;
- - All calls to ctools_static*() should be replaced with corresponding calls
- to drupal_static*().
- - All calls to ctools_css_add_css should be replaced with calls to
- drupal_add_css(). Note that the arguments to drupal_add_css() have changed.
- - All wizard form builder functions must now return a form array().
- - ctools_build_form is very close to being removed. In anticipation of this,
- all $form_state['wrapper callback']s must now be
- $form_state['wrapper_callback']. In addition to this $form_state['args']
- must now be $form_state['build_info']['args'].
- NOTE: Previously checking to see if the return from ctools_build_form()
- is empty would be enough to see if the form was submitted. This is no
- longer true. Please check for $form_state['executed']. If using a wizard
- check for $form_state['complete'].
- - Plugin types now must be explicitly registered via a registration hook,
- hook_ctools_plugin_type(); info once provided in magically-named functions
- (e.g., ctools_ctools_plugin_content_types() was the old function to
- provide plugin type info for ctools' content_type plugins) now must be
- provided in that global hook. See http://drupal.org/node/910538 for more
- details.
- - Plugins that use 'theme arguments' now use 'theme variables' instead.
- - Context, argument and relationship plugins now use 'add form' and/or
- 'edit form' rather than 'settings form'. These plugins now support
- form wizards just like content plugins. These forms now all take
- $form, &$form_state as arguments, and the configuration for the plugin
- can be found in $form_state['conf'].
- For all these forms, the submit handler MUST put appropriate data in
- $form_state['conf']. Data will no longer be stored automatically.
- For all of these forms, the separate settings #trees in the form are now
- gone, so form ids may be adjusted. Also, these are now all real forms
- using CTools form wizard instead of fake subforms as previously.
|
