<?php
// $Id$

/**
 * @file
 * An xmlrpc service which offers a formatting service where
 * you can send text to be processed by the input formats.
 */

/**
 * Implementation of hook_xmlrpc().
 */
function formatting_service_xmlrpc() {
  return array(
    array(
      'formats.render_default', // xml-rpc method
      'formatting_service_process_default', // drupal function
      array(
        'string',  // return value: processed text
        'string',  // text to process
      ),
      t('Process the text with the default input format')
    ),
    array(
      'formats.render',
      'formatting_service_process',
      array(
        'string',  // return value: processed text
        'string',  // text to process
        'string',  // input format
      ),
      t('Process the text with the input format selected by the input format name')
    ),
    array(
      'formats.list',
      'formatting_service_list',
      array(
        'array',  // return value: list of input formats
      ),
      t('List available input formats')
    ),
  );
}

/**
 * Callback of xmlrpc call 'formats.process_default'.
 */
function formatting_service_process_default($text) {
  return _formatting_service_process_by_id($text, FILTER_FORMAT_DEFAULT, TRUE);
}

/**
 * Callback of xmlrpc call 'formats.process'.
 */
function formatting_service_process($text, $format_name) {
  $format_id = -1;
  // get format id by name
  foreach (filter_formats() as $format) {
    if (strcasecmp($format_name, $format->name) == 0) {
      $format_id = $format->format;
      break;
    }
  }
  if ($format_id == -1) {
    return t('Invalid format name');
  }
  else {
    return _formatting_service_process_by_id($text, $format_id);
  }
}

/**
 * Process text with given input format
 */
function _formatting_service_process_by_id($text, $input_format_id) {
  // Access checking will be done to ensure no one tries the
  // PHP filter (if it is enabled). Everyone can use the
  // default format which is probably the only one used anyway
  return check_markup($text, $input_format_id, TRUE);
}

/**
 * Callback of xmlrpc call 'formats.list'.
 */
function formatting_service_list() {
  $result = array();
  foreach (filter_formats() as $format) {
    $result[] = $format->name;
  }
  return $result;
}