ContentTranslationMetadataWrapperInterface.php 2.66 KB
Newer Older
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 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122
<?php

/**
 * @file
 * Contains \Drupal\content_translation\ContentTranslationMetadataInterface.
 */

namespace Drupal\content_translation;

use Drupal\Core\Entity\EntityChangedInterface;
use Drupal\Core\Entity\EntityInterface;
use Drupal\user\UserInterface;

/**
 * Common interface for content translation metadata wrappers.
 *
 * This acts as a wrapper for an entity translation object, encapsulating the
 * logic needed to retrieve translation metadata.
 */
interface ContentTranslationMetadataWrapperInterface extends EntityChangedInterface {

  /**
   * Retrieves the source language for this translation.
   *
   * @return string
   *   The source language code.
   */
  public function getSource();

  /**
   * Sets the source language for this translation.
   *
   * @param string $source
   *   The source language code.
   *
   * @return $this
   */
  public function setSource($source);

  /**
   * Returns the translation outdated status.
   *
   * @return bool
   *   TRUE if the translation is outdated, FALSE otherwise.
   */
  public function isOutdated();

  /**
   * Sets the translation outdated status.
   *
   * @param bool $outdated
   *   TRUE if the translation is outdated, FALSE otherwise.
   *
   * @return $this
   */
  public function setOutdated($outdated);

  /**
   * Returns the translation author.
   *
   * @return \Drupal\user\UserInterface
   *   The user entity for the translation author.
   */
  public function getAuthor();

  /**
   * Sets the translation author.
   *
   * @param \Drupal\user\UserInterface $account
   *   The translation author user entity.
   *
   * @return $this
   */
  public function setAuthor(UserInterface $account);

  /**
   * Returns the translation published status.
   *
   * @return bool
   *   TRUE if the translation is published, FALSE otherwise.
   */
  public function isPublished();

  /**
   * Sets the translation published status.
   *
   * @param bool $published
   *   TRUE if the translation is published, FALSE otherwise.
   *
   * @return $this
   */
  public function setPublished($published);

  /**
   * Returns the translation creation timestamp.
   *
   * @return int
   *   The UNIX timestamp of when the translation was created.
   */
  public function getCreatedTime();

  /**
   * Sets the translation creation timestamp.
   *
   * @param int $timestamp
   *   The UNIX timestamp of when the translation was created.
   *
   * @return $this
   */
  public function setCreatedTime($timestamp);

  /**
   * Sets the translation modification timestamp.
   *
   * @param int $timestamp
   *   The UNIX timestamp of when the translation was last modified.
   *
   * @return $this
   */
  public function setChangedTime($timestamp);

}