You are here

interface AddressInterface in Ubercart 8.4

Defines an object to hold Ubercart mailing address information.

Hierarchy

Expanded class hierarchy of AddressInterface

All classes that implement AddressInterface

4 files declare their use of AddressInterface
Shipment.php in shipping/uc_fulfillment/src/Shipment.php
ShipmentInterface.php in shipping/uc_fulfillment/src/ShipmentInterface.php
UcAddress.php in uc_store/src/Element/UcAddress.php
uc_ups.module in shipping/uc_ups/uc_ups.module
UPS shipping quote module.

File

uc_store/src/AddressInterface.php, line 8

Namespace

Drupal\uc_store
View source
interface AddressInterface {

  /**
   * Returns the first (given) name.
   *
   * @return string
   *   The given name.
   */
  public function getFirstName();

  /**
   * Sets the first (given) name.
   *
   * @param string $first_name
   *   The given name.
   *
   * @return $this
   */
  public function setFirstName($first_name);

  /**
   * Returns the surname.
   *
   * @return string
   *   The surname.
   */
  public function getLastName();

  /**
   * Sets the surname.
   *
   * @param string $last_name
   *   The surname.
   *
   * @return $this
   */
  public function setLastName($last_name);

  /**
   * Returns the company or organization name.
   *
   * @return string
   *   The company or organization name.
   */
  public function getCompany();

  /**
   * Sets the company or organization name.
   *
   * @param string $company
   *   The company or organization name.
   *
   * @return $this
   */
  public function setCompany($company);

  /**
   * Returns the first line of street address.
   *
   * @return string
   *   First line of street address.
   */
  public function getStreet1();

  /**
   * Sets the first line of street address.
   *
   * @param string $street1
   *   First line of street address.
   *
   * @return $this
   */
  public function setStreet1($street1);

  /**
   * Returns the second line of street address.
   *
   * @return string
   *   Second line of street address.
   */
  public function getStreet2();

  /**
   * Sets the second line of street address.
   *
   * @param string $street2
   *   Second line of street address.
   *
   * @return $this
   */
  public function setStreet2($street2);

  /**
   * Returns the city name.
   *
   * @return string
   *   The city.
   */
  public function getCity();

  /**
   * Sets the city name.
   *
   * @param string $city
   *   The city.
   *
   * @return $this
   */
  public function setCity($city);

  /**
   * Returns the state, provence, or region id.
   *
   * @return string
   *   The zone.
   */
  public function getZone();

  /**
   * Sets the state, provence, or region id.
   *
   * @param string $zone
   *   The zone.
   *
   * @return $this
   */
  public function setZone($zone);

  /**
   * Returns the ISO 3166-1 2-character numeric country code.
   *
   * @return string
   *   The country code.
   */
  public function getCountry();

  /**
   * Sets the ISO 3166-1 2-character numeric country code.
   *
   * @param string $country
   *   The country code.
   *
   * @return $this
   */
  public function setCountry($country);

  /**
   * Returns the postal code.
   *
   * @return string
   *   The postal code.
   */
  public function getPostalCode();

  /**
   * Sets the postal code.
   *
   * @param string $postal_code
   *   The postal code.
   *
   * @return $this
   */
  public function setPostalCode($postal_code);

  /**
   * Returns the telephone number.
   *
   * @return string
   *   The telephone number.
   */
  public function getPhone();

  /**
   * Sets the telephone number.
   *
   * @param string $phone
   *   The telephone number.
   *
   * @return $this
   */
  public function setPhone($phone);

  /**
   * Returns the email address.
   *
   * @return string
   *   The email address.
   */
  public function getEmail();

  /**
   * Sets the email address.
   *
   * @param string $email
   *   The email address.
   *
   * @return $this
   */
  public function setEmail($email);

  /**
   * Determines if two Address objects represent the same physical address.
   *
   * Address properties such as first_name, phone, and email aren't considered
   * in this comparison because they don't contain information about the
   * physical location.
   *
   * @param \Drupal\uc_store\AddressInterface $address
   *   An object of type AddressInterface.
   *
   * @return bool
   *   TRUE if the two addresses are the same physical location, else FALSE.
   */
  public function isSamePhysicalLocation(AddressInterface $address);

  /**
   * Utility function to simplify comparison of address properties.
   *
   * For the purpose of this function, the canonical form is stripped of all
   * whitespace and has been converted to all upper case. This ensures that we
   * don't get false inequalities when comparing address properties that a
   * human would consider identical, but may be capitalized differently or
   * have different whitespace.
   *
   * @param string $string
   *   String to make canonical.
   *
   * @return string
   *   Canonical form of input string.
   */
  public static function makeCanonical($string);

}

Members

Namesort descending Modifiers Type Description Overrides
AddressInterface::getCity public function Returns the city name.
AddressInterface::getCompany public function Returns the company or organization name.
AddressInterface::getCountry public function Returns the ISO 3166-1 2-character numeric country code.
AddressInterface::getEmail public function Returns the email address.
AddressInterface::getFirstName public function Returns the first (given) name.
AddressInterface::getLastName public function Returns the surname.
AddressInterface::getPhone public function Returns the telephone number.
AddressInterface::getPostalCode public function Returns the postal code.
AddressInterface::getStreet1 public function Returns the first line of street address.
AddressInterface::getStreet2 public function Returns the second line of street address.
AddressInterface::getZone public function Returns the state, provence, or region id.
AddressInterface::isSamePhysicalLocation public function Determines if two Address objects represent the same physical address.
AddressInterface::makeCanonical public static function Utility function to simplify comparison of address properties.
AddressInterface::setCity public function Sets the city name.
AddressInterface::setCompany public function Sets the company or organization name.
AddressInterface::setCountry public function Sets the ISO 3166-1 2-character numeric country code.
AddressInterface::setEmail public function Sets the email address.
AddressInterface::setFirstName public function Sets the first (given) name.
AddressInterface::setLastName public function Sets the surname.
AddressInterface::setPhone public function Sets the telephone number.
AddressInterface::setPostalCode public function Sets the postal code.
AddressInterface::setStreet1 public function Sets the first line of street address.
AddressInterface::setStreet2 public function Sets the second line of street address.
AddressInterface::setZone public function Sets the state, provence, or region id.