Provide Interfaces for import data writing #26 #32

inc/Import/Iterator/XmlNodeIterator.php

@@ -73,6 +73,8 @@ public function valid() {
 
 	/**
 	 * closes the reader and re-open the URI
+	 *
+	 * Todo: consider if it is necessary or even reliable
 	 */
 	public function rewind() {
 

inc/Import/Service/MlpTranslationConnector.php

@@ -0,0 +1,54 @@
+<?php # -*- coding: utf-8 -*-
+
+namespace W2M\Import\Service;
+
+use
+	W2M\Import\Type,
+	W2M\Import\Data,
+	Mlp_Language_Api_Interface,
+	WP_Error,
+	WP_Post;
+
+class MlpTranslationConnector implements TranslationConnectorInterface {
+
+	/**
+	 * @var Mlp_Language_Api_Interface
+	 */
+	private $mlp_language_api;
+
+	/**
+	 * @var Data\IdMapperInterface
+	 */
+	private $id_mapper;
+
+	/**
+	 * @param Mlp_Language_Api_Interface $mlp_language_api
+	 * @param Data\IdMapperInterface $id_mapper
+	 */
+	public function __construct(
+		Mlp_Language_Api_Interface $mlp_language_api,
+		Data\IdMapperInterface $id_mapper
+	) {
+
+		$this->mlp_language_api = $mlp_language_api;
+		$this->id_mapper        = $id_mapper;
+	}
+	/**
+	 * @param $new_term
+	 * @param Type\ImportTermInterface $import_term
+	 * @return bool|WP_Error
+	 */
+	public function link_term( $new_term, Type\ImportTermInterface $import_term ) {
+		// TODO: Implement link_term() method.
+	}
+
+	/**
+	 * @param WP_Post $new_post
+	 * @param Type\ImportPostInterface $import_post
+	 * @return bool|WP_Error
+	 */
+	public function link_post( WP_Post $new_post, Type\ImportPostInterface $import_post ) {
+		// TODO: Implement link_post() method.
+	}
+
+}

inc/Import/Service/ObjectImporterInterface.php

@@ -0,0 +1,24 @@
+<?php # -*- coding: utf-8 -*-
+
+namespace W2M\Import\Service;
+
+use
+	W2M\Import\Type;
+
+interface ObjectImporterInterface {
+
+	/**
+	 * @param Type\ImportTermInterface $term
+	 *
+	 * @return bool|\WP_Error
+	 */
+	public function import_term( Type\ImportTermInterface $term );
+
+	/**
+	 * @param Type\ImportPostInterface $post
+	 *
+	 * @return bool|\WP_Error
+	 */
+	public function import_post( Type\ImportPostInterface $post );
+
+}

inc/Import/Service/TranslationConnectorInterface.php

@@ -0,0 +1,27 @@
+<?php # -*- coding: utf-8 -*-
+
+namespace W2M\Import\Service;
+
+use
+	W2M\Import\Type,
+	WP_Error,
+	WP_Post;
+
+interface TranslationConnectorInterface {
+
+	/**
+	 * @param $new_term
+	 * @param Type\ImportTermInterface $import_term
+	 *
+	 * @return bool|WP_Error
+	 */
+	public function link_term( $new_term, Type\ImportTermInterface $import_term );
+
+	/**
+	 * @param WP_Post $new_post
+	 * @param Type\ImportPostInterface $import_post
+	 *
+	 * @return bool|WP_Error
+	 */
+	public function link_post( WP_Post $new_post, Type\ImportPostInterface $import_post );
+}

inc/Import/Service/WpObjectImporter.php

@@ -0,0 +1,81 @@
+<?php # -*- coding: utf-8 -*-
+
+namespace W2M\Import\Service;
+
+use
+	W2M\Import\Type,
+	W2M\Import\Data;
+
+class WpObjectImporter implements ObjectImporterInterface {
+
+	/**
+	 * @var TranslationConnectorInterface
+	 */
+	private $translation_connector;
+
+	/**
+	 * @var Data\IdMapperInterface
+	 */
+	private $id_mapper;
+
+	/**
+	 * Todo: specify this
+	 */
+	private $ancestor_resolver;
+
+	/**
+	 * @param TranslationConnectorInterface $translation_connector
+	 * @param Data\IdMapperInterface $id_mapper
+	 * @param $ancestor_resolver (Not specified yet)
+	 */
+	public function __construct(
+		TranslationConnectorInterface $translation_connector,
+		Data\IdMapperInterface $id_mapper,
+		$ancestor_resolver
+	) {
+
+		$this->translation_connector = $translation_connector;
+		$this->id_mapper             = $id_mapper;
+		$this->ancestor_resolver     = $ancestor_resolver;
+	}
+
+	/**
+	 * @param Type\ImportTermInterface $term
+	 * @return bool|\WP_Error
+	 */
+	public function import_term( Type\ImportTermInterface $term ) {
+
+		// TODO: Implement import_term() method.
+
+		// 1. Insert Term via wp_insert_term()
+		// 2. set the new term_id(!) via $term->id( $new_term_id );
+		// 3. connect translations $this->translation_connector->link_term( $new_term, $term );
+
+		/**
+		 * Todo: resolve ancestor relation
+		 * Here we don't know and should not depend on whether the parent was already
+		 * imported or not.
+		 *
+		 * $ansestor_resolver->resolve_term( $new_term, $term );
+		 */
+	}
+
+	/**
+	 * @param Type\ImportPostInterface $post
+	 * @return bool|\WP_Error
+	 */
+	public function import_post( Type\ImportPostInterface $post ) {
+
+		// 1. Insert Term via wp_insert_term()
+		// 2. set the new term_id(!) via $term->id( $new_term_id );
+		// 3. connect translations $this->translation_connector->link_term( $new_post, $post );
+
+		/**
+		 * Todo: resolve ancestor relation
+		 * Here we don't know and should not depend on whether the parent was already
+		 * imported or not.
+		 *
+		 * $ansestor_resolver->resolve_term( $new_post, $post );
+		 */
+	}
+}

inc/Import/Type/ImportPost.php → inc/Import/Type/ImportPostInterface.php

@@ -2,10 +2,7 @@
 
 namespace W2M\Import\Type;
 
-/**
- * Interface ImportPost
- */
-interface ImportPost extends ImportElementInterface {
+interface ImportPostInterface extends ImportElementInterface {
 
 	/**
 	 * @return string

inc/Import/Type/ImportTermInterface.php

@@ -0,0 +1,41 @@
+<?php # -*- coding: utf-8 -*-
+
+namespace W2M\Import\Type;
+
+/**
+ * Interface ImportTermInterface
+ *
+ * @package W2M\Import\Type
+ */
+interface ImportTermInterface extends ImportElementInterface {
+
+	/**
+	 * @return string
+	 */
+	public function taxonomy();
+
+	/**
+	 * @return string
+	 */
+	public function name();
+
+	/**
+	 * @return string
+	 */
+	public function slug();
+
+	/**
+	 * @return string
+	 */
+	public function description();
+
+	/**
+	 * @return int
+	 */
+	public function origin_parent_term_id();
+
+	/**
+	 * @return array
+	 */
+	public function locale_relations();
+}

inc/Import/readme.md

@@ -8,7 +8,7 @@ Wrapps around XMLReader to iterate over entity objects (terms, users, posts)
 
 ## Types 
 
-`ImportPost`, `ImportTerm`, etc.
+`ImportPostInterface`, `ImportTerm`, etc.
 
 To have a clear defined interface to the importing data. Types are almost immutable. The only value that can changed 
 once in the object live time is the id of the object, as this gets created when inserting it into DB. This change will