PKPAuthor.inc.php

<?php
 
import('lib.pkp.classes.identity.Identity');
 
class PKPAuthor extends Identity {
 
   function &getLocalizedData($key, $preferredLocale = null) {
      if (is_null($preferredLocale)) $preferredLocale = AppLocale::getLocale();
      $localePrecedence = array($preferredLocale);
      // the submission locale is the default locale
      if (!in_array($this->getSubmissionLocale(), $localePrecedence)) $localePrecedence[] = $this->getSubmissionLocale();
      // for settings other than givenName, familyName and affiliation (that are required)
      // consider also the application primary locale
      if (!in_array(AppLocale::getPrimaryLocale(), $localePrecedence)) $localePrecedence[] = AppLocale::getPrimaryLocale();
      foreach ($localePrecedence as $locale) {
         if (empty($locale)) continue;
         $value =& $this->getData($key, $locale);
         if (!empty($value)) return $value;
         unset($value);
      }
 
      // Fallback: Get the first available piece of data.
      $data =& $this->getData($key, null);
      foreach ((array) $data as $dataValue) {
         if (!empty($dataValue)) return $dataValue;
      }
 
      // No data available; return null.
      unset($data);
      $data = null;
      return $data;
   }
 
   function getLocalizedGivenName($defaultLocale = null) {
      if (!isset($defaultLocale)) $defaultLocale = $this->getSubmissionLocale();
 
      return parent::getLocalizedGivenName($defaultLocale);
   }
 
   function getLocalizedFamilyName($defaultLocale = null) {
      if (!isset($defaultLocale)) $defaultLocale = $this->getSubmissionLocale();
 
      return parent::getLocalizedFamilyName($defaultLocale);
   }
 
   function getFullName($preferred = true, $familyFirst = false, $defaultLocale =  null) {
      if (!isset($defaultLocale)) $defaultLocale = $this->getSubmissionLocale();
      return parent::getFullName($preferred, $familyFirst, $defaultLocale);
   }
 
   //
   // Get/set methods
   //
 
   function getSubmissionId() {
      return $this->getData('submissionId');
   }
 
   function setSubmissionId($submissionId) {
      $this->setData('submissionId', $submissionId);
   }
 
   function getSubmissionLocale() {
      return $this->getData('submissionLocale');
   }
 
   function setSubmissionLocale($submissionLocale) {
      return $this->setData('submissionLocale', $submissionLocale);
   }
 
   function setUserGroupId($userGroupId) {
      $this->setData('userGroupId', $userGroupId);
   }
 
   function getUserGroupId() {
      return $this->getData('userGroupId');
   }
 
   function setIncludeInBrowse($include) {
      $this->setData('includeInBrowse', $include);
   }
 
   function getIncludeInBrowse() {
      return $this->getData('includeInBrowse');
   }
 
   function getShowTitle() {
      return $this->getData('showTitle');
   }
 
   function _setShowTitle($showTitle) {
      $this->setData('showTitle', $showTitle);
   }
 
   function getPrimaryContact() {
      return $this->getData('primaryContact');
   }
 
   function setPrimaryContact($primaryContact) {
      $this->setData('primaryContact', $primaryContact);
   }
 
   function getSequence() {
      return $this->getData('seq');
   }
 
   function setSequence($sequence) {
      $this->setData('seq', $sequence);
   }
 
   function getUserGroup() {
      //FIXME: should this be queried when fetching Author from DB? - see #5231.
      static $userGroup; // Frequently we'll fetch the same one repeatedly
      if (!$userGroup || $this->getUserGroupId() != $userGroup->getId()) {
         $userGroupDao = DAORegistry::getDAO('UserGroupDAO'); /* @var $userGroupDao UserGroupDAO */
         $userGroup = $userGroupDao->getById($this->getUserGroupId());
      }
      return $userGroup;
   }
 
   function getLocalizedUserGroupName() {
      $userGroup = $this->getUserGroup();
      return $userGroup->getLocalizedName();
   }
}