drupalcode.com

• View documentation
• List references

Definition

gmap_cck_widget($op, &$node, $field, &$items)
gmap_addons/gmap_cck.module, line 376

Description

Define the behavior of a widget.

Parameters

$op What kind of action is being performed. Possible values:

• "prepare form values": The editing form will be displayed. The widget should perform any conversion necessary from the field's native storage format into the storage used for the form. Convention dictates that the widget's version of the data should be stored beginning with "default".
• "form": The node is being edited, and a form should be prepared for display to the user.
• "validate": The user has just finished editing the node and is trying to preview or submit it. This hook can be used to check or even modify the node. Errors should be set with form_set_error().
• "process form values": The inverse of the prepare operation. The widget should convert the data back to the field's native format.
• "submit": The user has just finished editing the node and the node has passed validation. This hook can be used to modify the node.

&$node The node the action is being performed on. This argument is passed by reference for performance only; do not modify it.

$field The field the action is being performed on.

&$items The contents of the field in this node. Changes to this variable will be saved back to the node object.

Return value

This varies depending on the operation.

• The "form" operation should return an array of form elements to display.
• Other operations have no return value.

Related topics

Name	Description
Hooks	Allow modules to interact with the Drupal core.

Code

<?php
function gmap_cck_widget($op, &$node, $field, &$items) {

  switch ($op) {

    case 'prepare form values':
      // db-value (serialized array) is in $items[0]['value'];
      $items[0]['raw'] = unserialize($items[0]['value']);
      // show some gpx-data?
      if (!empty($field['gpx'])) {
        _gmap_cck_check_gpx_source($items[0]['raw'], $field, $node);
      }
      // if ($field['multiple']) { ??? }
      break;

    case 'form':
      $rd =& $items[0]['raw']; // raw data
      if (empty($rd)) $rd = array();

      $ndefs = array(
        'maptype' => $field['maptype'],
        'width' => $field['width'],
        'height' => $field['height'],
        'zoom' => $field['zoom'],
        'latlong' => $field['latlong'],
      );

      if (isset($rd['gpx'])) {
        $gpx_support = array('#value' => 'GPX support enabled');
        _gmap_cck_get_gpx($rd, $field, $node);
      }
      $ndefs = array_merge(gmap_defaults(), $ndefs, $rd);
      $hide = array('mapid' => 1, // type=hidden
        'width' => 1, 'height' => 1, 'alignment' => 1, // 'zoom' => 2,
        'maptype' => 1, 'controltype' => 1, 'macro' => 2,
      );
      $form = gmap_macro_builder_form($ndefs, $hide);

      // remove/hide unwanted parts of form
      $mf =& $form['macroform'];
      $mf['#title'] = t('Select map view');
      unset($mf['overlayedit'], $mf['address']);

      foreach ($mf as $key => $val) {
        if ($key[0] == '#') continue;
        $mf['#tree'] = true;
        $mf['#parents'] = array($field['field_name']);
      }

      $form[$field['field_name']] = $form['macroform'];
      unset($form['macroform']);

      if (isset($gpx_support)) {
        $form['gpx_support'] = $gpx_support;
      }

      return $form;

    case 'process form values':
      // TODO: if ($field['multiple']) ...
      // get the values and build serialized array for db-save
/*      $ms = '[gmap zoom='. $items['zoom'] .'|center='.
            $items['latlong'] .'|width='. $field['width'] .'|height='.
            $field['height'] .'|id=gmap_'. $field['field_name'] .'|control='.
            $field['controltype'] .'|type='. $field['maptype'] .']';
*/
      $v = array('zoom' => $items['zoom'], 'latlong' => $items['latlong']);
      // TODO: add more props like 'markers', gpx-file, ...
      foreach ($items as $delta => $item) {
        unset($items[$delta]);
      }

      // show some gpx-data?
      if (!empty($field['gpx'])) {
        _gmap_cck_check_gpx_source($v, $field, $node);
      }

      $items[0]['value'] = serialize($v);// $ms;
      break;
  }
}
?>