X-Git-Url: http://www.aleph1.co.uk/gitweb/?a=blobdiff_plain;f=web%2Fcore%2Fmodules%2Faggregator%2Fsrc%2FPlugin%2FProcessorInterface.php;fp=web%2Fcore%2Fmodules%2Faggregator%2Fsrc%2FPlugin%2FProcessorInterface.php;h=3b138338da1d08c68420a4425db6c354abb8bc56;hb=a2bd1bf0c2c1f1a17d188f4dc0726a45494cefae;hp=0000000000000000000000000000000000000000;hpb=57c063afa3f66b07c4bbddc2d6129a96d90f0aad;p=yaffs-website

diff --git a/web/core/modules/aggregator/src/Plugin/ProcessorInterface.php b/web/core/modules/aggregator/src/Plugin/ProcessorInterface.php
new file mode 100644
index 000000000..3b138338d
--- /dev/null
+++ b/web/core/modules/aggregator/src/Plugin/ProcessorInterface.php
@@ -0,0 +1,59 @@
+<?php
+
+namespace Drupal\aggregator\Plugin;
+
+use Drupal\aggregator\FeedInterface;
+
+/**
+ * Defines an interface for aggregator processor implementations.
+ *
+ * A processor acts on parsed feed data. Active processors are called at the
+ * third and last of the aggregation stages: first, data is downloaded by the
+ * active fetcher; second, it is converted to a common format by the active
+ * parser; and finally, it is passed to all active processors that manipulate or
+ * store the data.
+ *
+ * @see \Drupal\aggregator\Annotation\AggregatorProcessor
+ * @see \Drupal\aggregator\Plugin\AggregatorPluginSettingsBase
+ * @see \Drupal\aggregator\Plugin\AggregatorPluginManager
+ * @see plugin_api
+ */
+interface ProcessorInterface {
+
+  /**
+   * Processes feed data.
+   *
+   * @param \Drupal\aggregator\FeedInterface $feed
+   *   A feed object representing the resource to be processed.
+   *   $feed->items contains an array of feed items downloaded and parsed at the
+   *   parsing stage. See \Drupal\aggregator\Plugin\FetcherInterface::parse()
+   *   for the basic format of a single item in the $feed->items array.
+   *   For the exact format refer to the particular parser in use.
+   */
+  public function process(FeedInterface $feed);
+
+  /**
+   * Refreshes feed information.
+   *
+   * Called after the processing of the feed is completed by all selected
+   * processors.
+   *
+   * @param \Drupal\aggregator\FeedInterface $feed
+   *   Object describing feed.
+   *
+   * @see aggregator_refresh()
+   */
+  public function postProcess(FeedInterface $feed);
+
+  /**
+   * Deletes stored feed data.
+   *
+   * Called by aggregator if either a feed is deleted or a user clicks on
+   * "delete items".
+   *
+   * @param \Drupal\aggregator\FeedInterface $feed
+   *   The $feed object whose items are being deleted.
+   */
+  public function delete(FeedInterface $feed);
+
+}