'rules_ui_form_ajax_reload_form', 'wrapper' => 'rules-form-wrapper', 'effect' => $effect, 'speed' => 'fast', ); } /** * Submit handler for switching the parameter input mode. */ function rules_ui_parameter_replace_submit($form, &$form_state) { if (isset($form_state['triggering_element'])) { $name = $form_state['triggering_element']['#parameter']; $form_state['parameter_mode'][$name] = $form_state['parameter_mode'][$name] == 'selector' ? 'input' : 'selector'; } $form_state['rebuild'] = TRUE; } /** * General form submit handler, that rebuilds the form. */ function rules_form_submit_rebuild($form, &$form_state) { $form_state['rebuild'] = TRUE; } /** * Edit a rules configuration. */ function rules_ui_form_edit_rules_config($form, &$form_state, $rules_config, $base_path) { RulesPluginUI::$basePath = $base_path; $form_state += array('rules_element' => $rules_config); // Add the rule configuration's form. $rules_config->form($form, $form_state, array('show settings' => TRUE, 'button' => TRUE)); $form['#validate'] = array('rules_ui_form_rules_config_validate'); return $form; } /** * General rules configuration form validation callback. * * Also populates the rules configuration with the form values. */ function rules_ui_form_rules_config_validate($form, &$form_state) { $form_state['rules_element']->form_validate($form, $form_state); } /** * Edit a rules configuration form submit callback. */ function rules_ui_form_edit_rules_config_submit($form, &$form_state) { $form_state['rules_element']->form_submit($form, $form_state); drupal_set_message(t('Your changes have been saved.')); if (empty($form_state['redirect'])) { $form_state['redirect'] = RulesPluginUI::defaultRedirect($form_state['rules_element']); } } /** * Clone a rules configuration form. */ function rules_ui_form_clone_rules_config($form, &$form_state, $rules_config, $base_path) { RulesPluginUI::$basePath = $base_path; $rules_config = clone $rules_config; $rules_config->id = NULL; $rules_config->name = ''; $rules_config->label .= ' (' . t('cloned') . ')'; $rules_config->status = ENTITY_CUSTOM; $form['#validate'][] = 'rules_ui_form_rules_config_validate'; $form['#submit'][] = 'rules_ui_form_edit_rules_config_submit'; $form_state += array('rules_element' => $rules_config, 'op' => 'clone'); // Add the rule configuration's form. $rules_config->form($form, $form_state, array('show settings' => TRUE, 'button' => TRUE, 'init' => TRUE)); // Open the settings fieldset so altering the name is easier. $form['settings']['#collapsed'] = FALSE; return $form; } /** * A simple form just showing a textarea with the export. */ function rules_ui_form_export_rules_config($form, &$form_state, $rules_config, $base_path) { $form['export'] = array( '#type' => 'textarea', '#title' => t('Export'), '#description' => t('For importing copy the content of the text area and paste it into the import page.'), '#rows' => 25, '#default_value' => $rules_config->export(), ); return $form; } /** * Configuration form to directly execute a rules configuration. */ function rules_ui_form_execute_rules_config($form, &$form_state, $rules_config, $base_path) { // Only components can be executed. if (!($rules_config instanceof RulesTriggerableInterface)) { RulesPluginUI::$basePath = $base_path; // Create either the appropriate action or condition element. $element = rules_plugin_factory($rules_config instanceof RulesActionInterface ? 'action' : 'condition', 'component_' . $rules_config->name); $form['exec_help'] = array( '#prefix' => '
', '#markup' => t('This form allows you to manually trigger the execution of the @plugin "%label". If this component requires any parameters, input the suiting execution arguments below.', array('@plugin' => $rules_config->plugin(), '%label' => $rules_config->label())), '#suffix' => '
', ); $element->form($form, $form_state); // For conditions hide the option to negate them. if (isset($form['negate'])) { $form['negate']['#access'] = FALSE; } $form['submit'] = array( '#type' => 'submit', '#value' => t('Execute'), '#weight' => 20, ); // Re-use the validation callback, which will also populate the action with // the configuration settings in the form. $form['#validate'] = array('rules_ui_form_rules_config_validate'); return $form; } drupal_not_found(); exit; } /** * Submit callback for directly executing a component. */ function rules_ui_form_execute_rules_config_submit($form, &$form_state) { $element = $form_state['rules_element']; $result = $element->execute(); if ($element instanceof RulesActionInterface) { drupal_set_message(t('Component %label has been executed.', array('%label' => $element->label()))); } else { drupal_set_message(t('Component %label evaluated to %result.', array('%label' => $element->label(), '%result' => $result ? 'true' : 'false'))); } } /** * Gets the confirmation question for valid operations, or else FALSE. */ function rules_ui_confirm_operations($op, $rules_config) { $vars = array('%plugin' => $rules_config->plugin(), '%label' => $rules_config->label()); switch ($op) { case 'enable': return array( t('Are you sure you want to enable the %plugin %label?', $vars), '', ); case 'disable': return array( t('Are you sure you want to disable the %plugin %label?', $vars), '', ); case 'revert': return array( t('Are you sure you want to revert the %plugin %label?', $vars), t('This action cannot be undone.'), ); case 'delete': return array( t('Are you sure you want to delete the %plugin %label?', $vars), t('This action cannot be undone.'), ); default: return FALSE; } } /** * Confirmation form for applying the operation to the config. */ function rules_ui_form_rules_config_confirm_op($form, &$form_state, $rules_config, $op, $base_path) { if (list($confirm_question, $description) = rules_ui_confirm_operations($op, $rules_config)) { RulesPluginUI::$basePath = $base_path; $form_state += array('rules_config' => $rules_config, 'op' => $op); return confirm_form($form, $confirm_question, $base_path, $description, t('Confirm'), t('Cancel')); } else { drupal_not_found(); exit; } } /** * Applies the operation and returns the message to show to the user. * * The operation is also logged to the watchdog. Note that the string is * defined two times so that the translation extractor can find it. */ function rules_ui_confirm_operation_apply($op, $rules_config) { $vars = array('%plugin' => $rules_config->plugin(), '%label' => $rules_config->label()); $edit_link = l(t('edit'), RulesPluginUI::path($rules_config->name)); switch ($op) { case 'enable': $rules_config->active = TRUE; $rules_config->save(); watchdog('rules', 'Enabled %plugin %label.', $vars, WATCHDOG_NOTICE, $edit_link); return t('Enabled %plugin %label.', $vars); case 'disable': $rules_config->active = FALSE; $rules_config->save(); watchdog('rules', 'Disabled %plugin %label.', $vars, WATCHDOG_NOTICE, $edit_link); return t('Disabled %plugin %label.', $vars); case 'revert': $rules_config->delete(); watchdog('rules', 'Reverted %plugin %label to the defaults.', $vars, WATCHDOG_NOTICE, $edit_link); return t('Reverted %plugin %label to the defaults.', $vars); case 'delete': $rules_config->delete(); watchdog('rules', 'Deleted %plugin %label.', $vars); return t('Deleted %plugin %label.', $vars); } } /** * Rule config deletion form submit callback. */ function rules_ui_form_rules_config_confirm_op_submit($form, &$form_state) { if ($form_state['values']['confirm']) { $msg = rules_ui_confirm_operation_apply($form_state['op'], $form_state['rules_config']); drupal_set_message($msg); } } /** * Add a new element a rules configuration. */ function rules_ui_add_element($form, &$form_state, $rules_config, $plugin_name, RulesContainerPlugin $parent, $base_path) { $cache = rules_get_cache(); if (!isset($cache['plugin_info'][$plugin_name]['class'])) { drupal_not_found(); exit; } RulesPluginUI::$basePath = $base_path; $plugin_is_abstract = in_array('RulesAbstractPlugin', class_parents($cache['plugin_info'][$plugin_name]['class'])); // In the first step create the element and in the second step show its edit // form. if ($plugin_is_abstract && !isset($form_state['rules_element'])) { RulesPluginUI::formDefaults($form, $form_state); $form_state += array('parent_element' => $parent, 'plugin' => $plugin_name); $form['element_name'] = array( '#type' => 'select', '#title' => t('Select the %element to add', array('%element' => $plugin_name)), '#options' => RulesPluginUI::getOptions($plugin_name), '#ajax' => rules_ui_form_default_ajax() + array( 'trigger_as' => array('name' => 'continue'), ), ); $form['continue'] = array( '#type' => 'submit', '#name' => 'continue', '#value' => t('Continue'), '#ajax' => rules_ui_form_default_ajax(), ); } elseif (!$plugin_is_abstract) { // Create the initial, empty element. $element = rules_plugin_factory($plugin_name); // Always add the new element at the bottom, thus set an appropriate weight. $iterator = $parent->getIterator(); if ($sibling = end($iterator)) { $element->weight = $sibling->weight + 1; } $element->setParent($parent); $form_state['rules_element'] = $element; } if (isset($form_state['rules_element'])) { $form_state['rules_element']->form($form, $form_state, array('button' => TRUE, 'init' => TRUE)); $form['#validate'][] = 'rules_ui_edit_element_validate'; $form['#submit'][] = 'rules_ui_edit_element_submit'; } return $form; } /** * Add element submit callback. * * Used for "abstract plugins" to create the initial element object with the * given implementation name and rebuild the form. */ function rules_ui_add_element_submit($form, &$form_state) { $element = rules_plugin_factory($form_state['plugin'], $form_state['values']['element_name']); // Always add the new element at the bottom, thus set an appropriate weight. $iterator = $form_state['parent_element']->getIterator(); if ($sibling = end($iterator)) { $element->weight = $sibling->weight + 1; } // Clear the element settings so they won't be processed on serialization as // there is nothing to be processed yet. $element->settings = array(); $element->setParent($form_state['parent_element']); $form_state['rules_element'] = $element; $form_state['rebuild'] = TRUE; } /** * Delete elements. */ function rules_ui_delete_element($form, &$form_state, $rules_config, $rules_element, $base_path) { RulesPluginUI::$basePath = $base_path; if (empty($form_state['rules_config'])) { // Before modifying the rules config we have to clone it, so any // modifications won't appear in the static cache of the loading controller. $rules_config = clone $rules_config; // Also get the element from the cloned config. $rules_element = $rules_config->elementMap()->lookup($rules_element->elementId()); $form_state['rules_config'] = $rules_config; $form_state['rules_element'] = $rules_element; $form_state['element_parent'] = $rules_element->parentElement(); } // Try deleting the element and warn the user if something breaks, but // save the parent for determining the right redirect target on submit. $removed_plugin = $form_state['rules_element']->plugin(); $rules_element->delete(); if (empty($rules_config->dirty) && empty($form_state['input'])) { try { $rules_config->integrityCheck(); } catch (RulesIntegrityException $e) { $args = array( '@plugin' => $e->element->plugin(), '%label' => $e->element->label(), '@removed-plugin' => $removed_plugin, '!url' => url(RulesPluginUI::path($form_state['rules_config']->name, 'edit', $e->element)), ); drupal_set_message(t('Deleting this @removed-plugin would break your configuration as some of its provided variables are utilized by the @plugin %label.', $args), 'warning'); } } $confirm_question = t('Are you sure you want to delete the %element_plugin %element_name?', array( '%element_plugin' => $rules_element->plugin(), '%element_name' => $rules_element->label(), )); return confirm_form($form, $confirm_question, RulesPluginUI::path($rules_config->name), t('This action cannot be undone.'), t('Delete'), t('Cancel')); } /** * Rule config deletion form submit callback. */ function rules_ui_delete_element_submit($form, &$form_state) { $rules_config = $form_state['rules_config']; $rules_config->save(); if (empty($form_state['redirect'])) { $form_state['redirect'] = RulesPluginUI::defaultRedirect($form_state['element_parent']); } } /** * Configure a rule element. */ function rules_ui_edit_element($form, &$form_state, $rules_config, $element, $base_path) { RulesPluginUI::$basePath = $base_path; $form_state += array('rules_element' => $element); $form_state['rules_element']->form($form, $form_state, array('button' => TRUE)); return $form; } /** * Validate the element configuration. */ function rules_ui_edit_element_validate($form, &$form_state) { $form_state['rules_element']->form_validate($form, $form_state); } /** * Submit the element configuration. */ function rules_ui_edit_element_submit($form, &$form_state) { $form_state['rules_element']->form_submit($form, $form_state); drupal_set_message(t('Your changes have been saved.')); if (empty($form_state['redirect'])) { $form_state['redirect'] = RulesPluginUI::defaultRedirect($form_state['rules_element']); } } /** * Form builder for the "add event" page. */ function rules_ui_add_event_page($form, &$form_state, RulesTriggerableInterface $rules_config, $base_path) { RulesPluginUI::$basePath = $base_path; RulesPluginUI::formDefaults($form, $form_state); $form = rules_ui_add_event($form, $form_state, $rules_config, $base_path); $form['#validate'][] = 'rules_ui_add_event_validate'; return $form; } /** * Submit the event configuration. */ function rules_ui_add_event_page_submit($form, &$form_state) { rules_ui_add_event_apply($form, $form_state); $rules_config = $form_state['rules_config']; // Tell the user if this breaks something, but let him proceed. if (empty($rules_config->dirty)) { try { $rules_config->integrityCheck(); } catch (RulesIntegrityException $e) { $warning = TRUE; drupal_set_message(t('Added the event, but it does not provide all variables utilized.'), 'warning'); } } $rules_config->save(); if (!isset($warning)) { $events = rules_fetch_data('event_info'); $label = $events[$form_state['values']['event']]['label']; drupal_set_message(t('Added event %event.', array('%event' => $label))); } } /** * Add a new event. */ function rules_ui_add_event($form, &$form_state, RulesReactionRule $rules_config, $base_path) { $form_state += array('rules_config' => $rules_config); $events = array_diff_key(rules_fetch_data('event_info'), array_flip($rules_config->events())); $form['help'] = array( '#markup' => t('Select the event to add. However note that all added events need to provide all variables that should be available to your rule.'), ); $form['event'] = array( '#type' => 'select', '#title' => t('React on event'), '#options' => RulesPluginUI::getOptions('event', $events), '#description' => t('Whenever the event occurs, rule evaluation is triggered.'), '#ajax' => rules_ui_form_default_ajax(), '#required' => TRUE, ); if (!empty($form_state['values']['event'])) { $handler = rules_get_event_handler($form_state['values']['event']); $form['event_settings'] = $handler->buildForm($form_state); } else { $form['event_settings'] = array(); } $form['submit'] = array( '#type' => 'submit', '#value' => t('Add'), ); $form_state['redirect'] = RulesPluginUI::path($rules_config->name); return $form; } /** * Validation callback for adding an event. */ function rules_ui_add_event_validate($form, $form_state) { $handler = rules_get_event_handler($form_state['values']['event']); $handler->extractFormValues($form['event_settings'], $form_state); try { $handler->validate(); } catch (RulesIntegrityException $e) { form_set_error(implode('][', $e->keys), $e->getMessage()); } } /** * Submit callback that just adds the selected event. * * @see rules_admin_add_reaction_rule() */ function rules_ui_add_event_apply($form, &$form_state) { $handler = rules_get_event_handler($form_state['values']['event']); $handler->extractFormValues($form['event_settings'], $form_state); $form_state['rules_config']->event($form_state['values']['event'], $handler->getSettings()); } /** * Form to remove an event from a rule. */ function rules_ui_remove_event($form, &$form_state, $rules_config, $event, $base_path) { RulesPluginUI::$basePath = $base_path; $form_state += array('rules_config' => $rules_config, 'rules_event' => $event); $event_info = rules_get_event_info($event); $form_state['event_label'] = $event_info['label']; $confirm_question = t('Are you sure you want to remove the event?'); return confirm_form($form, $confirm_question, RulesPluginUI::path($rules_config->name), t('You are about to remove the event %event.', array('%event' => $form_state['event_label'])), t('Remove'), t('Cancel')); } /** * Submit the event configuration. */ function rules_ui_remove_event_submit($form, &$form_state) { $rules_config = $form_state['rules_config']; $rules_config->removeEvent($form_state['rules_event']); // Tell the user if this breaks something, but let him proceed. if (empty($rules_config->dirty)) { try { $rules_config->integrityCheck(); } catch (RulesIntegrityException $e) { $warning = TRUE; drupal_set_message(t('Removed the event, but it had provided some variables which are now missing.'), 'warning'); } } $rules_config->save(); if (!isset($warning)) { drupal_set_message(t('Event %event has been removed.', array('%event' => $form_state['event_label']))); } $form_state['redirect'] = RulesPluginUI::path($rules_config->name); } /** * Import form for rule configurations. */ function rules_ui_import_form($form, &$form_state, $base_path) { RulesPluginUI::$basePath = $base_path; RulesPluginUI::formDefaults($form, $form_state); $form['import'] = array( '#type' => 'textarea', '#title' => t('Import'), '#description' => t('Paste an exported Rules configuration here.'), '#rows' => 20, ); $form['overwrite'] = array( '#title' => t('Overwrite'), '#type' => 'checkbox', '#description' => t('If checked, any existing configuration with the same identifier will be replaced by the import.'), '#default_value' => FALSE, ); $form['submit'] = array( '#type' => 'submit', '#value' => t('Import'), ); return $form; } /** * Validation callback for the import form. */ function rules_ui_import_form_validate($form, &$form_state) { if ($rules_config = rules_import($form_state['values']['import'], $error_msg)) { // Store the successfully imported entity in $form_state. $form_state['rules_config'] = $rules_config; // Check for existing entities with the same identifier. if ($existing_config = rules_config_load($rules_config->name)) { // Don't import and overwrite the existing configuration unless the user // has checked the 'overwrite' box. if (!$form_state['values']['overwrite']) { $vars = array('@entity' => t('Rules configuration'), '%label' => $rules_config->label()); form_set_error('import', t('Import of @entity %label failed, a @entity with the same machine name already exists. Check the overwrite option to replace it.', $vars)); } // Don't import if the existing configuration has the status ENTITY_FIXED // because that means the configuration can't be modified. if ($existing_config->status == ENTITY_FIXED) { $vars = array('@entity' => t('Rules configuration'), '%label' => $rules_config->label()); form_set_error('import', t("Import of @entity %label failed, a @entity with the same machine name already exists and is marked as ENTITY_FIXED meaning it can't be mofified.", $vars)); } } try { $rules_config->integrityCheck(); } catch (RulesIntegrityException $e) { form_set_error('import', t('Integrity check for the imported configuration failed. Error message: %message.', array('%message' => $e->getMessage()))); } if (!user_access('bypass rules access') && !$rules_config->access()) { form_set_error('import', t('You have insufficient access permissions for importing this Rules configuration.')); } } else { form_set_error('import', t('Import failed.')); if ($error_msg) { drupal_set_message($error_msg, 'error'); } } } /** * Submit callback for the import form. */ function rules_ui_import_form_submit($form, &$form_state) { $rules_config = $form_state['rules_config']; if ($existing_config = rules_config_load($rules_config->name)) { // Copy DB id and remove the new indicator to overwrite the existing record. $rules_config->id = $existing_config->id; // Set the ENTITY_CUSTOM bit in the status bitmask, because the // configuration has now been customized by the import. $rules_config->status = $existing_config->status | ENTITY_CUSTOM; unset($rules_config->is_new); } $rules_config->save(); $vars = array('@entity' => t('Rules configuration'), '%label' => $rules_config->label()); watchdog('rules_config', 'Imported @entity %label.', $vars); drupal_set_message(t('Imported @entity %label.', $vars)); $form_state['redirect'] = RulesPluginUI::$basePath; } /** * FAPI process callback for the data selection widget. * * This finalises the auto completion callback path by appending the form build * id. */ function rules_data_selection_process($element, &$form_state, $form) { $element['#autocomplete_path'] .= '/' . $form['#build_id']; $form_state['cache'] = TRUE; return $element; } /** * Autocomplete data selection results. */ function rules_ui_form_data_selection_auto_completion($parameter, $form_build_id, $string = '') { // Get the form and its state from the cache to get the currently edited // or created element. $form_state = form_state_defaults(); $form = form_get_cache($form_build_id, $form_state); if (!isset($form_state['rules_element'])) { return; } $element = $form_state['rules_element']; $params = $element->pluginParameterInfo(); $matches = array(); if (isset($params[$parameter])) { $parts = explode(':', $string); // Remove the last part as it might be unfinished. $last_part = array_pop($parts); $selector = implode(':', $parts); // Start with the partly given selector or from scratch. $result = array(); if ($selector && $wrapper = $element->applyDataSelector($selector)) { $result = RulesData::matchingDataSelector($wrapper, $params[$parameter], $selector . ':', 0); } elseif (!$selector) { $result = RulesData::matchingDataSelector($element->availableVariables(), $params[$parameter], '', 0); } foreach ($result as $selector => $info) { // If we have an uncomplete last part, take it into account now. $attributes = array(); if (!$last_part || strpos($selector, $string) === 0) { $attributes['class'][] = 'rules-dsac-item'; $attributes['title'] = isset($info['description']) ? strip_tags($info['description']) : ''; if ($selector[strlen($selector) - 1] == ':') { $attributes['class'][] = 'rules-dsac-group'; $text = check_plain($selector) . '... (' . check_plain($info['label']) . ')'; } else { $text = check_plain($selector) . ' (' . check_plain($info['label']) . ')'; } $matches[$selector] = "