crm.fsf.org/20131203/files/sites/all/modules-new/ctools/UPGRADE.txt

   1 Upgrading from ctools-6.x-1.x to ctools-7.x-2.x:
   2
   3   - Remove ctools_ajax_associate_url_to_element as it shouldn't be necessary
   4     with the new AJAX api's in Drupal core.
   5
   6   - All calls to the ctools_ajax_command_prepend() should be replace with
   7     the core function ajax_command_prepend();
   8     This is also the case for append, insert, after, before, replace, html,
   9     and remove commands.
  10     Each of these commands have been incorporated into the
  11     Drupal.ajax.prototype.commands.insert
  12     function with a corresponding parameter specifying which method to use.
  13
  14   - All calls to ctools_ajax_render() should be replaced with calls to core
  15     ajax_render(). Note that ctools_ajax_render() printed the json object and
  16     exited, ajax_render() gives you this responsibility.
  17
  18     ctools_ajax_render()
  19
  20     becomes
  21
  22     print ajax_render();
  23     exit;
  24
  25   - All calls to ctools_static*() should be replaced with corresponding calls
  26     to drupal_static*().
  27
  28   - All calls to ctools_css_add_css should be replaced with calls to
  29     drupal_add_css(). Note that the arguments to drupal_add_css() have changed.
  30
  31   - All wizard form builder functions must now return a form array().
  32
  33   - ctools_build_form is very close to being removed.  In anticipation of this,
  34     all $form_state['wrapper callback']s must now be
  35     $form_state['wrapper_callback']. In addition to this $form_state['args']
  36     must now be $form_state['build_info']['args'].
  37
  38     NOTE: Previously checking to see if the return from ctools_build_form()
  39     is empty would be enough to see if the form was submitted. This is no
  40     longer true. Please check for $form_state['executed']. If using a wizard
  41     check for $form_state['complete'].
  42
  43   - Plugin types now must be explicitly registered via a registration hook,
  44     hook_ctools_plugin_type(); info once provided in magically-named functions
  45     (e.g., ctools_ctools_plugin_content_types() was the old function to
  46     provide plugin type info for ctools' content_type plugins) now must be
  47     provided in that global hook. See http://drupal.org/node/910538 for more
  48     details.
  49
  50   - Plugins that use 'theme arguments' now use 'theme variables' instead.
  51
  52   - Context, argument and relationship plugins now use 'add form' and/or
  53     'edit form' rather than 'settings form'. These plugins now support
  54     form wizards just like content plugins. These forms now all take
  55     $form, &$form_state as arguments, and the configuration for the plugin
  56     can be found in $form_state['conf'].
  57
  58     For all these forms, the submit handler MUST put appropriate data in
  59     $form_state['conf']. Data will no longer be stored automatically.
  60
  61     For all of these forms, the separate settings #trees in the form are now
  62     gone, so form ids may be adjusted. Also, these are now all real forms
  63     using CTools form wizard instead of fake subforms as previously.