Welcome, visitor! Log in
 

Source View: widget_update_callback

To save our bandwidth, we show only a snippet of code around each occurence of the hook. View complete file in SVN (without highlighting).

Understanding Source Code

The best way to understand what a hook does is to look at where it occurs in the source code.

  • Action hooks look like this: do_action( "hook_name" )
  • Filter hooks look like this: apply_filters( "hook_name", "what_to_filter" ).

Remember, this hook may occur in more than one file. Moreover, the hook's context may change from version to version.

Source View

Line Code
222                foreach ( $settings as $number => $new_instance ) {
223                     $new_instance = stripslashes_deep($new_instance);
224                     $this->_set($number);
225
226                     $old_instance = isset($all_instances[$number]) ? $all_instances[$number] : array();
227
228                     $instance = $this->update($new_instance, $old_instance);
229
230                     // filters the widget's settings before saving, return false to cancel saving (keep the old settings if updating)
231                     $instance = apply_filters('widget_update_callback', $instance, $new_instance, $old_instance, $this);
232                     if ( false !== $instance )
233                          $all_instances[$number] = $instance;
234
235                     break; // run only once
236                }
237           }
238
239           $this->save_settings($all_instances);
240           $this->updated = true;