1  2  3  4  5  6  7  8  9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 
<?php

/* --------------------------------------------------------------
   ProductCategoryLinkerInterface.inc.php 2016-01-28
   Gambio GmbH
   http://www.gambio.de
   Copyright (c) 2016 Gambio GmbH
   Released under the GNU General Public License (Version 2)
   [http://www.gnu.org/licenses/gpl-2.0.html]
   --------------------------------------------------------------
*/

/**
 * Interface ProductCategoryLinkerInterface
 *
 * @category   System
 * @package    Product
 * @subpackage Interfaces
 */
interface ProductCategoryLinkerInterface
{
    /**
     * Links a product to a category.
     *
     * @param IdType $productId        Product ID.
     *
     * @param IdType $targetCategoryId Target category ID.
     *
     * @return $this|ProductCategoryLinkerInterface Same instance for chained method calls.
     */
    public function linkProduct(IdType $productId, IdType $targetCategoryId);


    /**
     * Changes a link to a new category.
     *
     * @param IdType $productId         Product ID.
     * @param IdType $currentCategoryId Category ID which the product is linked to.
     * @param IdType $newCategoryId     New category to be linked to.
     *
     * @return $this|ProductCategoryLinkerInterface Same instance for chained method calls.
     */
    public function changeProductLink(IdType $productId, IdType $currentCategoryId, IdType $newCategoryId);


    /**
     * Removes a link to a category.
     *
     * @param IdType $productId  Product ID.
     * @param IdType $categoryId Category ID which the link should be removed to.
     *
     * @return $this|ProductCategoryLinkerInterface Same instance for chained method calls.
     */
    public function deleteProductLink(IdType $productId, IdType $categoryId);


    /**
     * Removes all links from a product.
     *
     * @param IdType $productId Product ID.
     *
     * @return $this|ProductCategoryLinkerInterface Same instance for chained method calls.
     */
    public function deleteProductLinks(IdType $productId);
    
    
    /**
     * Returns the category Ids which are linked with given product id.
     * 
     * @param IdType $productId
     *
     * @return IdCollection
     */
    public function getProductLinks(IdType $productId);
    
    
    /**
     * @param \IdType $productId
     *
     * @return ProductRepositoryInterface|$this Same instance for chained method calls.
     */
    public function removeProductFromStartPage(IdType $productId);
    
    
    /**
     * @param \IdType $productId
     *
     * @return ProductRepositoryInterface|$this Same instance for chained method calls.
     */
    public function addProductToStartPage(IdType $productId);
}