Fix for older versions of php-l
[civicrm-core.git] / CRM / Utils / System / Soap.php
index 5be3b32a70bed90c39135cc7670e7791048d77ce..b96ba20d9752460209ba488c7f918f0f0239a2f8 100644 (file)
@@ -23,7 +23,7 @@
  | GNU Affero General Public License or the licensing of CiviCRM,     |
  | see the CiviCRM license FAQ at http://civicrm.org/licensing        |
  +--------------------------------------------------------------------+
-*/
+ */
 
 /**
  *
@@ -44,74 +44,23 @@ class CRM_Utils_System_Soap extends CRM_Utils_System_Base {
   static $uf = NULL;
   static $ufClass = NULL;
 
-  /**
-   * Sets the title of the page
-   *
-   * @param string $title title  for page
-   * @param $pageTitle
-   *
-   * @paqram string $pageTitle
-   *
-   * @return void
-   * @access public
-   */
-  function setTitle($title, $pageTitle) {
-    return;
-  }
-
   /**
    * Given a permission string, check for access requirements
    *
-   * @param string $str the permission to check
+   * @param string $str
+   *   The permission to check.
    *
-   * @return boolean true if yes, else false
-   * @static
-   * @access public
+   * @return bool
+   *   true if yes, else false
    */
-  function checkPermission($str) {
+  public function checkPermission($str) {
     return TRUE;
   }
 
   /**
-   * Append an additional breadcrumb tag to the existing breadcrumb
-   *
-   * @param string $title
-   * @param string $url
-   *
-   * @return void
-   * @access public
-   */
-  function appendBreadCrumb($title, $url) {
-    return;
-  }
-
-  /**
-   * Append a string to the head of the html file
-   *
-   * @param string $head the new string to be appended
-   *
-   * @return void
-   * @access public
-   */
-  function addHTMLHead($head) {
-    return;
-  }
-
-  /**
-   * Generate an internal CiviCRM URL
-   *
-   * @param $path     string   The path being linked to, such as "civicrm/add"
-   * @param $query    string   A query string to append to the link.
-   * @param $absolute boolean  Whether to force the output to be an absolute link (beginning with http:).
-   *                           Useful for links that will be displayed outside the site, such as in an
-   *                           RSS feed.
-   * @param $fragment string   A fragment identifier (named anchor) to append to the link.
-   *
-   * @return string            an HTML string containing a link to the given path.
-   * @access public
-   *
+   * @inheritDoc
    */
-  function url($path = NULL, $query = NULL, $absolute = TRUE, $fragment = NULL) {
+  public function url($path = NULL, $query = NULL, $absolute = TRUE, $fragment = NULL) {
     if (isset(self::$ufClass)) {
       $className = self::$ufClass;
       $url = $className::url($path, $query, $absolute, $fragment);
@@ -123,37 +72,28 @@ class CRM_Utils_System_Soap extends CRM_Utils_System_Base {
   }
 
   /**
-   * Figure out the post url for the form
-   *
-   * @param the default action if one is pre-specified
-   *
-   * @return string the url to post the form
-   * @access public
+   * FIXME: Can this override be removed in favor of the parent?
+   * @inheritDoc
    */
-  function postURL($action) {
+  public function postURL($action) {
     return NULL;
   }
 
   /**
    * Set the email address of the user
    *
-   * @param object $user handle to the user object
+   * @param object $user
+   *   Handle to the user object.
    *
    * @return void
-   * @access public
    */
-  function setEmail(&$user) {}
+  public function setEmail(&$user) {
+  }
 
   /**
-   * Authenticate a user against the real UF
-   *
-   * @param string $name      Login name
-   * @param string $pass      Login password
-   *
-   * @return array            Result array
-   * @access public
+   * @inheritDoc
    */
-  function &authenticate($name, $pass) {
+  public function authenticate($name, $pass) {
     if (isset(self::$ufClass)) {
       $className = self::$ufClass;
       $result =& $className::authenticate($name, $pass);
@@ -166,8 +106,6 @@ class CRM_Utils_System_Soap extends CRM_Utils_System_Base {
 
   /**
    * Swap the current UF for soap
-   *
-   * @access public
    */
   public function swapUF() {
     $config = CRM_Core_Config::singleton();
@@ -179,26 +117,15 @@ class CRM_Utils_System_Soap extends CRM_Utils_System_Base {
     $config->userFrameworkClass = 'CRM_Utils_System_Soap';
   }
 
-  /**
-   * Get the locale set in the hosting CMS
-   *
-   * @return null  as the language is set elsewhere
-   */
-  function getUFLocale() {
-    return NULL;
-  }
-
   /**
    * Get user login URL for hosting CMS (method declared in each CMS system class)
    *
-   * @param string $destination - if present, add destination to querystring (works for Drupal only)
+   * @param string $destination
    *
    * @throws Exception
-   * @return string - loginURL for the current CMS
-   * @static
    */
   public function getLoginURL($destination = '') {
     throw new Exception("Method not implemented: getLoginURL");
   }
-}
 
+}