createapi.api.php

<?php

/**
 * @file
 * Hooks provided by the CreateAPI module.
 */

/**
 * Expose content types as endpoints.
 *
 * @return array
 *   Describes the properties of the endpoint, each element keyed by the machine
 *   name of each content type being exposed.
 */
function hook_createapi_content_types() {
  return array(
    // The content type machine name.
    'topic' => array(
      // This will create a path of the form "/api/<version>/<path>".
      'version' => '1.0',
      'path' => 'topics.json',
      // Wrapper fields for JSON data.
      'wrapper' => 'topics',
      'row' => 'topic',
      // Which fields and properties to be output, as well as the path.
      // The key represents the output alias and the value is the field or
      // property machine name.
      'data' => array(
        'fields' => array(
          'short_title' => 'field_short_title',
          'primary_image' => 'field_primary_image',
          'teaser_image' => array('field_teaser_image' => array(
            'fields' > array(
              'alt' => 'field_file_image_alt_text',
              'title' => 'field_file_image_title_text',
              'caption' => 'field_caption',
            ),
            'styles' => array(
              'thumbnail' => 'thumbnail',
              'medium' => 'medium',
              'large' => 'large',
              'square_thumbnail' => 'square_thumbnail',
            ),
          ),
          'assets' => array('field_asset_reference' => array(
            'fields' => array(
              'type' => 'field_type'
            ),
            'properties' => array(
              'title' => 'title',
            ),
            'path' => 'path',
          )),
        ),
        'properties' => array(
          'id' => 'nid',
          'title' => 'title',
          'created' => 'created',
        ),
        // The value is used as the output alias.
        'path' => 'path',
      ),
      // URL filters that can be used with this endpoint.
      'filters' => array(
        // The key represents the parameter to be used in the URL and the value
        // is the property to filter by. Multiple parameters can be provided,
        // separated by ",".
        'properties' => array(
          'id' => 'nid',
        ),
        // The key represents the parameter to be used in the URL.
        'fields' => array(
          'person' => array(
            'field' => 'field_person',
            'column' => 'target_id',
          ),
          'type' => array(
            'field' => 'field_type',
            'column' => 'value',
          ),
        ),
        // The value is used as the URL parameter.
        'path' => 'path',
        'start_end' => array(
          // The property to restrict results by. This could also be
          // 'field' => 'field_name', however the property will override the
          // field if both are present.
          'property' => 'created',
          // The values are used in the URL parameters.
          'start' => 'start',
          'end' => 'end',
        ),
        // The values are used in the URL parameters. There is an enforced limit
        // of 200 items for the range.
        'range' => 'count',
        'offset' => 'offset',
      ),
    ),
  );
}

/**
 * Expose nodequeues as endpoints.
 *
 * @return array
 *   Describes the properties of the endpoint, each element keyed by the machine
 *   name of each nodequeue being exposed.
 *
 * @see hook_createapi_content_types()
 */
function hook_createapi_nodequeues() {
  return array(
    // The nodequeue machine name.
    'trending_topics' => array(
      'version' => '1.0',
      'path' => 'trending-topics.json',
      'wrapper' => 'topics',
      'row' => 'topic',
      'data' => array(
        'fields' => array(
          'short_title' => 'field_short_title',
        ),
        'properties' => array(
          'id' => 'nid',
          'title' => 'title',
        ),
        'path' => 'path',
      ),
      // Only the following filters are supported in nodequeue endpoints.
      'filters' => array(
        'properties' => array(
          'id' => 'nid',
        ),
        'path' => 'path',
        'range' => 'count',
        'offset' => 'offset',
      ),
    ),
  );
}

/**
 * Expose menus as an endpoint.
 */
function hook_createapi_menus() {
  return array(
    'main-menu' => array(
      'version' => '1.0',
      'path' => 'main-menu.json',
      'wrapper' => 'links',
      'row' => 'link',
    ),
  );
}

/**
 * Expose any entities as an endpoint.
 *
 * @return array
 *   Describes the properties of the endpoint.
 *
 * @see hook_createapi_content_types()
 */
function hook_createapi_custom_entities_info() {
  return array(
    'topics' => array(
      'version' => '1.0',
      'path' => 'topics.json',
      'wrapper' => 'topics',
      'row' => 'topic',
      'data' => array(
        'fields' => array(
          'short_title' => 'field_short_title',
        ),
        'properties' => array(
          'id' => 'nid',
          'title' => 'title',
          'created' => 'created',
        ),
        'path' => 'path',
      ),
      'filters' => array(
        'properties' => array(
          'id' => 'nid',
        ),
        'path' => 'path',
        'start_end' => array(
          'property' => 'created',
          'start' => 'start',
          'end' => 'end',
        ),
        'range' => 'count',
        'offset' => 'offset',
      ),
      'custom_query' => array(
        'entity_type' => 'node',
        // This item is only required if path filtering is used. It is the alias
        // of the node ID as used in the EntityFieldQuery.
        'nid_alias' => 'nid',
      ),
    ),
  );
}

/**
 * The query that is used for fetching the set of entities to use for custom
 * endpoints.
 *
 * @return EntityFieldQuery
 */
function hook_createapi_custom_entities_query_ENDPOINT_ID() {
  $query = new EntityFieldQuery();
  $query->entityCondition('entity_type', 'node')
    ->entityCondition('bundle', 'topic')
    ->propertyCondition('status', 1)
    ->propertyOrderBy('nid', 'DESC');

  return $query;
}

/**
 * Expose items from the variable table in a json feed.
 *
 * @return array
 *   Describes the properties of the endpoint.
 */
function hook_createapi_variables() {
  return array(
    'site-information' => array(
      'version' => '1.0',
      'path' => 'site-information.json',
      'wrapper' => 'variables',
      'data' => array(
        'site_name' => 'site_name',
      ),
    ),
  );
}

/**
 * Alter the output of an entity before it's added to a feed.
 *
 * CreateAPI automatically will prepare fields, properties, and path information
 * based on hook_createapi_custom_entities_info() and other related hooks that
 * define feed information. For properties that aren't supported by CreateAPI or
 * for properties that need additional modification, this hook may be used
 * to add or modify information on an individual item's output.
 *
 * @param array $item
 *   The associative array containing the item that will be JSON encoded.
 * @param stdClass $entity
 *   The entity for the item being output.
 *
 * @see _createapi__helper__process_entities()
 */
function hook_createapi_process_entity_alter(&$item, $entity) {
  if (isset($item['type']) && $item['type'] == 'photo') {
    // Remove HTML tags for app delivery.
    $item['description'] = strip_tags($item['description']);

    // Check if this entity is flagged.
    $flag = flag_get_flag('promoted');
    $item['promoted'] = $flag->is_flagged($entity->nid);
  }
}