Projet

Général

Profil

Paste
Télécharger (9,25 ko) Statistiques
| Branche: | Révision:

root / drupal7 / sites / all / modules / feeds / mappers / taxonomy.inc @ 74f6bef0

1
<?php
2

    
3
/**
4
 * @file
5
 * On behalf implementation of Feeds mapping API for taxonomy.module.
6
 */
7

    
8
/**
9
 * Search by term name.
10
 */
11
define('FEEDS_TAXONOMY_SEARCH_TERM_NAME', 0);
12

    
13
/**
14
 * Search by term id.
15
 */
16
define('FEEDS_TAXONOMY_SEARCH_TERM_ID', 1);
17

    
18
/**
19
 * Search by GUID.
20
 */
21
define('FEEDS_TAXONOMY_SEARCH_TERM_GUID', 2);
22

    
23
/**
24
 * Implements hook_feeds_parser_sources_alter().
25
 */
26
function taxonomy_feeds_parser_sources_alter(&$sources, $content_type) {
27
  if (!empty($content_type)) {
28
    foreach (taxonomy_get_vocabularies($content_type) as $vocabulary) {
29
      $sources['parent:taxonomy:' . $vocabulary->machine_name] = array(
30
        'name' => t('Feed node: Taxonomy: @vocabulary', array('@vocabulary' => $vocabulary->name)),
31
        'description' => t('Taxonomy terms from feed node in given vocabulary.'),
32
        'callback' => 'taxonomy_feeds_get_source',
33
      );
34
    }
35
  }
36
}
37

    
38
/**
39
 * Callback, returns taxonomy from feed node.
40
 */
41
function taxonomy_feeds_get_source(FeedsSource $source, FeedsParserResult $result, $key) {
42
  if ($node = node_load($source->feed_nid)) {
43
    $terms = taxonomy_feeds_node_get_terms($node);
44
    $vocabularies = taxonomy_vocabulary_load_multiple(array(), array('machine_name' => str_replace('parent:taxonomy:', '', $key)));
45
    $vocabulary = array_shift($vocabularies);
46
    $result = array();
47
    foreach ($terms as $tid => $term) {
48
      if ($term->vid == $vocabulary->vid) {
49
        $result[] = new FeedsTermElement($term);
50
      }
51
    }
52

    
53
    return $result;
54
  }
55
}
56

    
57
/**
58
 * Implements hook_feeds_processor_targets_alter().
59
 */
60
function taxonomy_feeds_processor_targets_alter(&$targets, $entity_type, $bundle_name) {
61
  foreach (field_info_instances($entity_type, $bundle_name) as $name => $instance) {
62
    $info = field_info_field($name);
63
    if ($info['type'] == 'taxonomy_term_reference') {
64
      $targets[$name] = array(
65
        'name' => check_plain($instance['label']),
66
        'callback' => 'taxonomy_feeds_set_target',
67
        'description' => t('The @label field of the entity.', array('@label' => $instance['label'])),
68
        'summary_callback' => 'taxonomy_feeds_summary_callback',
69
        'form_callback' => 'taxonomy_feeds_form_callback',
70
      );
71
    }
72
  }
73
}
74

    
75
/**
76
 * Callback for mapping. Here is where the actual mapping happens.
77
 *
78
 * @todo Do not create new terms for non-autotag fields.
79
 */
80
function taxonomy_feeds_set_target($source, $entity, $target, $terms, $mapping = array()) {
81

    
82
  // Allow mapping the string '0' to a term name.
83
  if (empty($terms) && $terms != 0) {
84
    return;
85
  }
86

    
87
  // Handle non-multiple values.
88
  if (!is_array($terms)) {
89
    $terms = array($terms);
90
  }
91

    
92
  // Add in default values.
93
  $mapping += array(
94
    'term_search' => FEEDS_TAXONOMY_SEARCH_TERM_NAME,
95
    'autocreate' => FALSE,
96
  );
97

    
98
  $info = field_info_field($target);
99

    
100
  $cache = &drupal_static(__FUNCTION__);
101
  if (!isset($cache['allowed_values'][$target])) {
102
    $cache['allowed_values'][$target] = taxonomy_allowed_values($info);
103
  }
104

    
105
  if (!isset($cache['allowed_vocabularies'][$target])) {
106
    foreach ($info['settings']['allowed_values'] as $tree) {
107
      if ($vocabulary = taxonomy_vocabulary_machine_name_load($tree['vocabulary'])) {
108
        $cache['allowed_vocabularies'][$target][$vocabulary->vid] = $vocabulary->machine_name;
109
      }
110
    }
111
  }
112

    
113
  $query = new EntityFieldQuery();
114
  $query->entityCondition('entity_type', 'taxonomy_term')
115
    ->entityCondition('bundle', $cache['allowed_vocabularies'][$target])
116
    ->range(0, 1);
117

    
118

    
119
  $field = isset($entity->$target) ? $entity->$target : array('und' => array());
120

    
121
  // Allow for multiple mappings to the same target.
122
  $delta = count($field['und']);
123

    
124
  // Iterate over all values.
125
  foreach ($terms as $term) {
126

    
127
    if ($info['cardinality'] == $delta) {
128
      break;
129
    }
130

    
131
    $tid = FALSE;
132

    
133
    // FeedsTermElement already is a term.
134
    if ($term instanceof FeedsTermElement) {
135
      $tid = $term->tid;
136
    }
137
    else {
138
      switch ($mapping['term_search']) {
139

    
140
        // Lookup by name.
141
        case FEEDS_TAXONOMY_SEARCH_TERM_NAME:
142
          $name_query = clone $query;
143
          if ($tids = $name_query->propertyCondition('name', $term)->execute()) {
144
            $tid = key($tids['taxonomy_term']);
145
          }
146
          elseif ($mapping['autocreate']) {
147
            $term = (object) array(
148
              'name' => $term,
149
              'vid' => key($cache['allowed_vocabularies'][$target]),
150
              'vocabulary_machine_name' => reset($cache['allowed_vocabularies'][$target]),
151
            );
152
            taxonomy_term_save($term);
153
            $tid = $term->tid;
154
            // Add to the list of allowed values.
155
            $cache['allowed_values'][$target][$tid] = $term->name;
156
          }
157
          break;
158

    
159
        // Lookup by tid.
160
        case FEEDS_TAXONOMY_SEARCH_TERM_ID:
161
          if (is_numeric($term)) {
162
            $tid = $term;
163
          }
164
          break;
165

    
166
        // Lookup by GUID.
167
        case FEEDS_TAXONOMY_SEARCH_TERM_GUID:
168
          $tid = taxonomy_feeds_term_lookup_term_by_guid($term);
169
          break;
170
      }
171
    }
172

    
173
    if ($tid && isset($cache['allowed_values'][$target][$tid])) {
174
      $field['und'][$delta]['tid'] = $tid;
175
      $delta++;
176
    }
177
  }
178

    
179
  $entity->$target = $field;
180
}
181

    
182
/**
183
 * Finds all terms associated with the given node, within one vocabulary.
184
 */
185
function taxonomy_feeds_node_get_terms($node, $key = 'tid') {
186
  $terms = &drupal_static(__FUNCTION__);
187

    
188
  if (!isset($terms[$node->nid][$key])) {
189
    // Get tids from all taxonomy_term_reference fields.
190
    $tids = array();
191
    $fields = field_info_fields();
192
    foreach ($fields as $field_name => $field) {
193
      if ($field['type'] == 'taxonomy_term_reference' && field_info_instance('node', $field_name, $node->type)) {
194
        if (($items = field_get_items('node', $node, $field_name)) && is_array($items)) {
195
          $tids = array_merge($tids, array_map('_taxonomy_feeds_extract_tid', $items));
196
        }
197
      }
198
    }
199

    
200
    // Load terms and cache them in static var.
201
    $curr_terms = taxonomy_term_load_multiple($tids);
202
    $terms[$node->nid][$key] = array();
203
    foreach ($curr_terms as $term) {
204
      $terms[$node->nid][$key][$term->$key] = $term;
205
    }
206
  }
207
  return $terms[$node->nid][$key];
208
}
209

    
210
/**
211
 * Extracts tid from array item returned by field_get_items().
212
 *
213
 * @param array $item
214
 *   Tid information in the form of a single element array
215
 *   (key == 'tid', value == tid we're looking for)
216
 *
217
 * @return int
218
 *   Term id extracted from $item.
219
 *
220
 * @see taxonomy_feeds_node_get_terms()
221
 * @see field_get_items()
222
 */
223
function _taxonomy_feeds_extract_tid($item) {
224
  return $item['tid'];
225
}
226

    
227
/**
228
 * Looks up a term by GUID, assumes SQL storage backend.
229
 *
230
 * @param string $guid
231
 *   The Feeds GUID to compare against.
232
 *
233
 * @return int|FALSE
234
 *   The term id, or FALSE if one was not found.
235
 */
236
function taxonomy_feeds_term_lookup_term_by_guid($guid) {
237
  return db_select('feeds_item')
238
    ->fields('feeds_item', array('entity_id'))
239
    ->condition('entity_type', 'taxonomy_term')
240
    ->condition('guid', $guid)
241
    ->execute()
242
    ->fetchField();
243
}
244

    
245
/**
246
 * Mapping configuration summary for taxonomy.module.
247
 *
248
 * @param array $mapping
249
 *   Associative array of the mapping settings.
250
 * @param array $target
251
 *   Array of target settings, as defined by the processor or
252
 *   hook_feeds_processor_targets_alter().
253
 * @param array $form
254
 *   The whole mapping form.
255
 * @param array $form_state
256
 *   The form state of the mapping form.
257
 *
258
 * @return string
259
 *   Returns, as a string that may contain HTML, the summary to display while
260
 *   the full form isn't visible.
261
 *   If the return value is empty, no summary and no option to view the form
262
 *   will be displayed.
263
 */
264
function taxonomy_feeds_summary_callback($mapping, $target, $form, $form_state) {
265
  $options = _taxonomy_feeds_form_callback_options();
266
  if (empty($mapping['term_search'])) {
267
    return t('Search taxonomy terms by: <strong>@search</strong>', array('@search' => $options[FEEDS_TAXONOMY_SEARCH_TERM_NAME]));
268
  }
269
  return t('Search taxonomy terms by: <strong>@search</strong>', array('@search' => $options[$mapping['term_search']]));
270
}
271

    
272
/**
273
 * Settings form callback.
274
 *
275
 * @return array
276
 *   The per mapping configuration form. Once the form is saved, $mapping will
277
 *   be populated with the form values.
278
 */
279
function taxonomy_feeds_form_callback($mapping, $target, $form, $form_state) {
280
  return array(
281
    'term_search' => array(
282
      '#type' => 'select',
283
      '#title' => t('Search taxonomy terms by'),
284
      '#options' => _taxonomy_feeds_form_callback_options(),
285
      '#default_value' => !empty($mapping['term_search']) ? $mapping['term_search'] : FEEDS_TAXONOMY_SEARCH_TERM_NAME,
286
    ),
287
    'autocreate' => array(
288
      '#type' => 'checkbox',
289
      '#title' => t('Auto create'),
290
      '#description' => t("Create the term if it doesn't exist."),
291
      '#default_value' => !empty($mapping['autocreate']) ? $mapping['autocreate'] : 0,
292
      '#states' => array(
293
        'visible' => array(
294
          ':input[name$="[settings][term_search]"]' => array('value' => FEEDS_TAXONOMY_SEARCH_TERM_NAME),
295
        ),
296
      ),
297
    ),
298
  );
299
}
300

    
301
/**
302
 * Returns the list of available term search methods.
303
 *
304
 * @return array
305
 *   An array of taxonomy search option titles.
306
 */
307
function _taxonomy_feeds_form_callback_options() {
308
  return array(
309
    FEEDS_TAXONOMY_SEARCH_TERM_NAME => 'Term name',
310
    FEEDS_TAXONOMY_SEARCH_TERM_ID => 'Term ID',
311
    FEEDS_TAXONOMY_SEARCH_TERM_GUID => 'GUID',
312
  );
313
}