From 9dad6f3d57defdcb8b1466062c53159d807d46f3 Mon Sep 17 00:00:00 2001
From: sgiehl <stefan@piwik.org>
Date: Sun, 7 Jul 2013 13:09:48 +0200
Subject: [PATCH] fixed some doc blocks, unresolved variables

---
 .gitignore                                          | 1 -
 core/Common.php                                     | 6 +++---
 core/DataAccess/ArchiveWriter.php                   | 2 +-
 core/Db/Adapter/Pdo/Mssql.php                       | 2 +-
 core/EventDispatcher.php                            | 4 ++--
 core/Period/Range.php                               | 6 ++++++
 core/PluginsManager.php                             | 2 +-
 core/Tracker/Cache.php                              | 2 +-
 core/Translate.php                                  | 3 ++-
 core/TranslationWriter.php                          | 1 +
 plugins/CoreAdminHome/API.php                       | 4 ++--
 plugins/CoreHome/Controller.php                     | 2 +-
 plugins/LanguagesManager/API.php                    | 3 ++-
 plugins/Live/API.php                                | 8 ++++++--
 plugins/UserCountry/Archiver.php                    | 2 --
 plugins/UserCountry/LocationProvider/GeoIp.php      | 1 +
 plugins/Zeitgeist/templates/_jsGlobalVariables.twig | 2 +-
 17 files changed, 31 insertions(+), 20 deletions(-)

diff --git a/.gitignore b/.gitignore
index ac561c35ed..0ae42c673e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -23,7 +23,6 @@ tmp/*
 *.buildpath
 config/config.ini.php
 .DS_Store
-tests/PHPUnit/Integration/processed/
 js/yui*
 misc/*.dat
 tests/javascript/enable_sqlite
diff --git a/core/Common.php b/core/Common.php
index e9a4625573..5eeb94ffaf 100644
--- a/core/Common.php
+++ b/core/Common.php
@@ -970,7 +970,7 @@ class Piwik_Common
     /**
      * Returns the browser language code, eg. "en-gb,en;q=0.5"
      *
-     * @param string $browserLang  Optional browser language, otherwise taken from the request header
+     * @param string|null $browserLang  Optional browser language, otherwise taken from the request header
      * @return string
      */
     public static function getBrowserLanguage($browserLang = NULL)
@@ -1075,8 +1075,8 @@ class Piwik_Common
     /**
      * Returns the visitor language based only on the Browser 'accepted language' information
      *
-     * @param $browserLanguage  Browser's accepted langauge header
-     * @param $validLanguages   array of valid language codes
+     * @param string $browserLanguage  Browser's accepted langauge header
+     * @param array  $validLanguages   array of valid language codes
      * @return string  2 letter ISO 639 code
      */
     public static function extractLanguageCodeFromBrowserLanguage($browserLanguage, $validLanguages)
diff --git a/core/DataAccess/ArchiveWriter.php b/core/DataAccess/ArchiveWriter.php
index 3f36252fdc..bb10fe7a44 100644
--- a/core/DataAccess/ArchiveWriter.php
+++ b/core/DataAccess/ArchiveWriter.php
@@ -231,7 +231,7 @@ class Piwik_DataAccess_ArchiveWriter
         if (is_numeric($value)) {
             return $this->getTableNumeric();
         }
-        return Piwik_DataAccess_ArchiveTableCreator::getBlobTable($this->dateStart);;
+        return Piwik_DataAccess_ArchiveTableCreator::getBlobTable($this->dateStart);
     }
 
     protected function getTableNumeric()
diff --git a/core/Db/Adapter/Pdo/Mssql.php b/core/Db/Adapter/Pdo/Mssql.php
index 6754962e6d..54a156295b 100644
--- a/core/Db/Adapter/Pdo/Mssql.php
+++ b/core/Db/Adapter/Pdo/Mssql.php
@@ -246,7 +246,7 @@ class Piwik_Db_Pdo_Mssql extends Zend_Db_Adapter_Pdo_Mssql implements Piwik_Db_A
             $version = $this->_connection->getAttribute(PDO::ATTR_CLIENT_VERSION);
             $requiredVersion = Piwik_Config::getInstance()->General['minimum_mssql_client_version'];
             if (version_compare($version['DriverVer'], $requiredVersion) === -1) {
-                throw new Exception(Piwik_TranslateException('General_ExceptionDatabaseVersion', array('MSSQL', $serverVersion, $requiredVersion)));
+                throw new Exception(Piwik_TranslateException('General_ExceptionDatabaseVersion', array('MSSQL', $version['DriverVer'], $requiredVersion)));
             } else {
                 return $version['DriverVer'];
             }
diff --git a/core/EventDispatcher.php b/core/EventDispatcher.php
index b1bc3daa1c..f11107d56e 100644
--- a/core/EventDispatcher.php
+++ b/core/EventDispatcher.php
@@ -117,7 +117,7 @@ class Piwik_EventDispatcher
      * name.
      * 
      * @param string $eventName
-     * @param array $callback This can be a normal PHP callback or an array
+     * @param array|callable $callback This can be a normal PHP callback or an array
      *                        that looks like this:
      *                        array(
      *                            'function' => $callback,
@@ -200,7 +200,7 @@ function Piwik_PostEvent($eventName, $params = array(), $pending = false, $plugi
  * Register an action to execute for a given event
  *
  * @param string $eventName  Name of event
- * @param function $function  Callback hook
+ * @param callable $function  Callback hook
  */
 function Piwik_AddAction($eventName, $function)
 {
diff --git a/core/Period/Range.php b/core/Period/Range.php
index c73f10b4fe..27ef4bd015 100644
--- a/core/Period/Range.php
+++ b/core/Period/Range.php
@@ -19,6 +19,12 @@ class Piwik_Period_Range extends Piwik_Period
 {
     protected $label = 'range';
 
+    /**
+     * @param string $strPeriod
+     * @param string $strDate
+     * @param string $timezone
+     * @param bool|Piwik_Date $today
+     */
     public function __construct($strPeriod, $strDate, $timezone = 'UTC', $today = false)
     {
         $this->strPeriod = $strPeriod;
diff --git a/core/PluginsManager.php b/core/PluginsManager.php
index f003859a39..c09988452f 100644
--- a/core/PluginsManager.php
+++ b/core/PluginsManager.php
@@ -424,7 +424,7 @@ class Piwik_PluginsManager
     /**
      * Unload plugin
      *
-     * @param Piwik_Plugin $plugin
+     * @param Piwik_Plugin|string $plugin
      * @throws Exception
      */
     public function unloadPlugin($plugin)
diff --git a/core/Tracker/Cache.php b/core/Tracker/Cache.php
index d277d94f84..f529b1d874 100644
--- a/core/Tracker/Cache.php
+++ b/core/Tracker/Cache.php
@@ -119,7 +119,7 @@ class Piwik_Tracker_Cache
     /**
      * Regenerate Tracker cache files
      *
-     * @param array $idSites  Array of idSites to clear cache for
+     * @param array|int $idSites  Array of idSites to clear cache for
      */
     static public function regenerateCacheWebsiteAttributes($idSites = array())
     {
diff --git a/core/Translate.php b/core/Translate.php
index 807638357c..d2b95e700b 100644
--- a/core/Translate.php
+++ b/core/Translate.php
@@ -69,6 +69,7 @@ class Piwik_Translate
 
     private function loadTranslation($language)
     {
+        $translations = array();
         $path = PIWIK_INCLUDE_PATH . '/lang/' . $language . '.php';
         if (!Piwik_Common::isValidFilename($language) || !is_readable($path)) {
             throw new Exception(Piwik_TranslateException('General_ExceptionLanguageFileNotFound', array($language)));
@@ -181,7 +182,7 @@ class Piwik_Translate
  * Returns translated string or given message if translation is not found.
  *
  * @param string $string Translation string index
- * @param array $args sprintf arguments
+ * @param array|string|int $args sprintf arguments
  * @return string
  */
 function Piwik_Translate($string, $args = array())
diff --git a/core/TranslationWriter.php b/core/TranslationWriter.php
index e2fbb9578c..e47ae10f89 100644
--- a/core/TranslationWriter.php
+++ b/core/TranslationWriter.php
@@ -69,6 +69,7 @@ class Piwik_TranslationWriter
      */
     static public function loadTranslation($lang)
     {
+        $translations = array();
         $path = self::getTranslationPath($lang);
         if (!is_readable($path)) {
             throw new Exception(Piwik_TranslateException('General_ExceptionLanguageFileNotFound', array($lang)));
diff --git a/plugins/CoreAdminHome/API.php b/plugins/CoreAdminHome/API.php
index 27a2293bcd..a2e272ffb3 100644
--- a/plugins/CoreAdminHome/API.php
+++ b/plugins/CoreAdminHome/API.php
@@ -129,8 +129,8 @@ class Piwik_CoreAdminHome_API
             // but also weeks overlapping several months stored in the month where the week is starting
             /* @var $week Piwik_Period_Week */
             $week = Piwik_Period::factory('week', $date);
-            $week = $week->getDateStart()->toString('Y_m');
-            $datesByMonth[$week][] = $date->toString();
+            $weekAsString = $week->getDateStart()->toString('Y_m');
+            $datesByMonth[$weekAsString][] = $date->toString();
 
             // Keep track of the minimum date for each website
             if ($minDate === false
diff --git a/plugins/CoreHome/Controller.php b/plugins/CoreHome/Controller.php
index 724bb1f472..fe9875c3d0 100644
--- a/plugins/CoreHome/Controller.php
+++ b/plugins/CoreHome/Controller.php
@@ -226,7 +226,7 @@ class Piwik_CoreHome_Controller extends Piwik_Controller
     public function redirectToPaypal()
     {
         $parameters = Piwik_API_Request::getRequestArrayFromString($request = null);
-        foreach ($paramaters as $name => $param) {
+        foreach ($parameters as $name => $param) {
             if ($name == 'idSite'
                 || $name == 'module'
                 || $name == 'action'
diff --git a/plugins/LanguagesManager/API.php b/plugins/LanguagesManager/API.php
index 484065f4e1..658deb886c 100644
--- a/plugins/LanguagesManager/API.php
+++ b/plugins/LanguagesManager/API.php
@@ -116,7 +116,7 @@ class Piwik_LanguagesManager_API
         }
 
         $filenames = $this->getAvailableLanguages();
-        $languagesInfo = array();
+        $translations = $languagesInfo = array();
         foreach ($filenames as $filename) {
             require PIWIK_INCLUDE_PATH . "/lang/$filename.php";
             $languagesInfo[] = array(
@@ -140,6 +140,7 @@ class Piwik_LanguagesManager_API
         if (!$this->isLanguageAvailable($languageCode)) {
             return false;
         }
+        $translations = array();
         require PIWIK_INCLUDE_PATH . "/lang/$languageCode.php";
         $languageInfo = array();
         foreach ($translations as $key => $value) {
diff --git a/plugins/Live/API.php b/plugins/Live/API.php
index 62c0b5c7be..074f1f7a05 100644
--- a/plugins/Live/API.php
+++ b/plugins/Live/API.php
@@ -84,8 +84,12 @@ class Piwik_Live_API
         $data = Piwik_FetchAll($query['sql'], $query['bind']);
 
         // These could be unset for some reasons, ensure they are set to 0
-        empty($data[0]['actions']) ? $data[0]['actions'] = 0 : '';
-        empty($data[0]['visitsConverted']) ? $data[0]['visitsConverted'] = 0 : '';
+        if (empty($data[0]['actions'])) {
+            $data[0]['actions'] = 0;
+        }
+        if (empty($data[0]['visitsConverted'])) {
+            $data[0]['visitsConverted'] = 0;
+        }
         return $data;
     }
 
diff --git a/plugins/UserCountry/Archiver.php b/plugins/UserCountry/Archiver.php
index 2fa2573d55..deac72405c 100644
--- a/plugins/UserCountry/Archiver.php
+++ b/plugins/UserCountry/Archiver.php
@@ -21,8 +21,6 @@ class Piwik_UserCountry_Archiver extends Piwik_PluginsArchiver
 
     private $latLongForCities = array();
 
-    private $dataArrays = array();
-
     protected $maximumRows;
 
     const COUNTRY_FIELD = 'location_country';
diff --git a/plugins/UserCountry/LocationProvider/GeoIp.php b/plugins/UserCountry/LocationProvider/GeoIp.php
index f7a9029797..5cf139ac12 100755
--- a/plugins/UserCountry/LocationProvider/GeoIp.php
+++ b/plugins/UserCountry/LocationProvider/GeoIp.php
@@ -168,6 +168,7 @@ abstract class Piwik_UserCountry_LocationProvider_GeoIp extends Piwik_UserCountr
     public static function getRegionNames()
     {
         if (is_null(self::$regionNames)) {
+            $GEOIP_REGION_NAME = array();
             require_once PIWIK_INCLUDE_PATH . '/libs/MaxMindGeoIP/geoipregionvars.php';
             self::$regionNames = $GEOIP_REGION_NAME;
         }
diff --git a/plugins/Zeitgeist/templates/_jsGlobalVariables.twig b/plugins/Zeitgeist/templates/_jsGlobalVariables.twig
index 3667f2169f..0ec9e5478d 100644
--- a/plugins/Zeitgeist/templates/_jsGlobalVariables.twig
+++ b/plugins/Zeitgeist/templates/_jsGlobalVariables.twig
@@ -1,5 +1,5 @@
 <script type="text/javascript">
-    var piwik = {}
+    var piwik = {};
     piwik.token_auth = "{{ token_auth }}";
     piwik.piwik_url = "{{ piwikUrl }}";
     {% if userLogin %}piwik.userLogin = "{{ userLogin|e('js')}}";
-- 
GitLab