feeds_tamper 8.x-2.x-dev

Work in progress of the D8 version of Feeds Tamper. Feeds Tamper now depends on the Tamper module.

There is no UI yet, but the module is minimally usable in the following way:

// Load a feed type.
/** @var \Drupal\feeds\FeedTypeInterface */
$feed_type = \Drupal\feeds\Entity\FeedType::load('article_importer');

// Get Tamper functionality for this feed type.
/** @var \Drupal\feeds_tamper\FeedTypeTamperMetaInterface */
$tamper_meta = \Drupal::service('feeds_tamper.feed_type_tamper_manager')->getTamperMeta($feed_type);

// Example: add a Tamper plugin of type 'explode' to source field 'gamma'.
/** @var \Drupal\tamper\TamperInterface */
$tamper = $tamper_meta->addTamper([
  'plugin' => 'explode',
  'source' => 'gamma',
  'separator' => ',',
  'description' => 'Explode with comma character',
]);
// And save the feed type to make the addition permanent.
$feed_type->save();

// Example: get a single Tamper instance.
/** @var \Drupal\tamper\TamperInterface */
$tamper = $tamper_meta->getTamper($uuid);

// Example: get all tampers for a feed type.
/** @var \Drupal\feeds_tamper\TamperPluginCollection|\Drupal\tamper\TamperInterface[] */
$tampers = $tamper_meta->getTampers();

// Example: get all tampers for a feed type keyed by source.
/** @var \Drupal\tamper\TamperInterface[][] */
$tampers_by_source = $tamper_meta->getTampersGroupedBySource();

// Example: remove a tamper instance. Changes are immediately permanent (feed 
// type is saved in the process).
$tamper_meta->removeTamper($tamper);

One way of executing the code examples from above is by using the 'Execute PHP' form from the Devel module.

Available Tamper plugins
The available Tamper plugins can be found in the Tamper module in the folder tamper/src/Plugin/Tamper.
You can also get a list of available tamper plugins this way:

// Get tamper manager.
/** @var \Drupal\tamper\TamperManagerInterface */
$tamper_manager = \Drupal::service('plugin.manager.tamper');

// Get definitions. Definitions will be an array of available plugins where the
// key will be the plugin ID and value the plugin's metadata.
/** @var array */
$definitions = $tamper_manager->getDefinitions();