autometal-piwik 0.4.4 → 0.6.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/LICENSE

@@ -0,0 +1,4 @@
+No-Copyright (c) 
+
+You have all the Copyright. This code is yours.
+

data/README.md

@@ -0,0 +1,88 @@
+# autometal-piwik
+  * https://github.com/Achillefs/autometal-piwik
+  * http://humbuckercode.co.uk/licks/gems/piwik
+
+## DESCRIPTION:
+A simple Ruby client for the Piwik API. This gem is based on Rodrigo Tassinari de Oliveira's piwik gem (https://github.com/riopro/piwik). Since it hasn't been updated since 2008, I took the liberty to fork it, and finish it up.
+
+## FEATURES/PROBLEMS:
+
+  * Object-oriented interface to the Piwik API;
+  * For now, only a small subset of the API is implemented (only basic actions)
+
+## SYNOPSIS:
+Piwik is an open source web analytics software, written in PHP. It provides an 
+extensive REST-like API, and this gem aims to be a simple Ruby wrapper to access 
+this API in a Ruby-friendly way. For example:
+
+    require 'rubygems'
+    require 'piwik'
+    Piwik.auth_token = "i need to configure simple-piwik with my auth_token here"
+    Piwik.piwik_url = "http://piwik.mypiwikdomain.org"
+    site = Piwik::Site.load(1)
+    => #<Piwik::Site:0xb74bf994 @name="Example.com", @config={:auth_token=>"some_auth_key", :piwik_url=>"http://your.piwi.install"}, @id=1, @main_url="http://www.example.com", @created_at=Tue Jul 15 18:55:40 -0300 2008>
+    site.pageviews(:month, Date.today)
+    => 3002378
+    user = Piwik::User.load(1, 'http://piwik.mypiwikdomain.org', 'my_auth_key')
+    => #<Piwik::User:0xb66bf544 @login="Example.com", @config={:auth_token=>"some_auth_key", :piwik_url=>"http://your.piwi.install"}, @id=1, @main_url="http://www.example.com", @created_at=Tue Jul 15 18:55:40 -0300 2008>
+
+Configuring with initializer config/initializers/simple-piwik.rb :
+  
+    if Rails.env.production? 
+      Piwik.piwik_url  # "http://piwik.mypiwikdomain.org"
+      Piwik.auth_token # "2ad590308b1efa590a9a43ad86d3ac1s"
+    elsif Rails.env.development?
+      #this is currently set to the same as production
+      Piwik.piwik_url  # "http://piwik.mypiwikdomain.org"
+      Piwik.auth_token # "2ad590308b1efa590a9a43ad86d3ac1s"
+    end
+
+  * Piwik website (http://piwik.org)
+  * Piwik API reference (http://dev.piwik.org/trac/wiki/API/Reference)
+
+## REQUIREMENTS:
+
+    activesupport, rest-client, json
+
+## INSTALL:
+
+    gem install simple-piwik
+
+## CHANGELOG:
+  * 0.6.1
+  New methods (pulled from [yehezkielbs' fork](https://github.com/Achillefs/autometal-piwik/pull/6))
+    * `Site#bounce_count`
+    * `Site#sum_visits_length`
+    * `Site#website_referrers`
+  * 0.6.0 
+  Merged a few updates from [Mihael's fork](https://github.com/Achillefs/autometal-piwik/pull/5)
+  Gem now works with Rails 3.x, and the credentials specification strategy changed slightly
+  * 0.4.2
+  Final fix for inconsistent API outputs caused by Rails using its own version of XmlSimple.
+  * 0.4.1
+  Quick fixed api result parsing in site creation. The API's responses are inconsistent, but I am not sure why.
+  * 0.4.0
+  Added Piwik::Trackable controller mixing, pretty much swiped off of halfdan's piwik analytics project (https://github.com/halfdan/piwik_analytics/). The version included in this plugin is not suitable for application tracking, and is instead geared towards tracking multiple websites stored as ActiveRecord models
+  * 0.3.0
+  UsersManager CRUD implementation, with tests
+  * 0.2.3
+  Started adding some tests
+  * 0.2.0
+  Reworked plugin to also look for a rails config file called piwik.yml, and not just the .piwik user prefs file.
+  * 0.0.2 2008-07-22 (riopro)
+  * Added specs for existing API methods
+  * Created RubyForge project at http://rubyforge.org/projects/piwik/
+  * 0.0.1 2008-07-21 (riopro)
+  * major enhancement:
+  * Initial release
+
+## LICENSE:
+(The MIT License)
+
+Copyright © 2010-2013 Achillefs Charmpilas, Humbucker Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the ‘Software’), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED ‘AS IS’, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -1,16 +1,33 @@
-require 'rubygems'
-gem 'hoe', '>= 2.1.0'
-require 'hoe'
-require 'fileutils'
-require './lib/piwik'
-
-Hoe.plugin :newgem
-$hoe = Hoe.spec 'autometal-piwik' do
-  self.developer 'Achillefs Charmpilas', 'ac@humbuckercode.co.uk'
-  self.post_install_message = File.read('PostInstall.txt')
-  self.rubyforge_name       = self.name
-  self.extra_deps         = [['activesupport','>= 2.3.8'],['xml-simple',">=1.0.11"],["rest-client",">= 1.6.1"]]
-end
-
-require 'newgem/tasks'
-Dir['tasks/**/*.rake'].each { |t| load t }
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name        = "autometal-piwik"
+    gem.summary     = %Q{A ruby client for the Piwik API.}
+    gem.description = %Q{Provides simple access to the Piwik API.}
+    gem.email       = "ac@humbuckercode.co.uk"
+    gem.homepage    = "https://github.com/Achillefs/autometal-piwik"
+    gem.authors     = ['Achillefs Charmpilas', 'mihael']
+    gem.add_dependency "activesupport", ">= 3.0.9"
+    gem.add_dependency "rest-client",   ">= 1.6.1"
+    gem.add_dependency "json",          ">= 1.4.6"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+

data/VERSION

@@ -0,0 +1 @@
+0.6.1

data/autometal-piwik.gemspec

@@ -1,50 +1,59 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
 
 Gem::Specification.new do |s|
   s.name = %q{autometal-piwik}
-  s.version = "0.4.2"
+  s.version = "0.6.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.authors = ["Achillefs Charmpilas"]
-  s.date = %q{2011-01-18}
-  s.description = %q{A simple Ruby client for the Piwik API. This gem is based on Rodrigo Tassinari de Oliveira's piwik gem (https://github.com/riopro/piwik). Since it hasn't been updated since 2008, I took the liberty to fork it, and finish it up.}
-  s.email = ["ac@humbuckercode.co.uk"]
-  s.extra_rdoc_files = ["License.txt", "Manifest.txt", "PostInstall.txt", "Todo.txt"]
-  s.files = ["License.txt", "Manifest.txt", "PostInstall.txt", "README.rdoc", "Rakefile", "Todo.txt", "autometal-piwik.gemspec", "lib/piwik.rb", "lib/piwik/base.rb", "lib/piwik/site.rb", "lib/piwik/trackable.rb", "lib/piwik/user.rb", "script/console", "script/destroy", "script/generate", "script/txt2html", "setup.rb", "test/files/config/piwik.yml", "test/piwik_test.rb", "test/test_helper.rb"]
-  s.homepage = %q{http://github.com/Achillefs/tree/master}
-  s.post_install_message = %q{
-For more information on piwik, see http://piwik.rubyforge.org or 
-http://github.com/Achillefs/piwik/
-
-}
-  s.rdoc_options = ["--main", "README.rdoc"]
+  s.authors = ["Achillefs Charmpilas", "mihael"]
+  s.date = %q{2013-01-05}
+  s.description = %q{Provides simple access to the Piwik API.}
+  s.email = %q{ac@humbuckercode.co.uk}
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README.md"
+  ]
+  s.files = [
+    ".document",
+    "LICENSE",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "autometal-piwik.gemspec",
+    "lib/piwik.rb",
+    "lib/piwik/base.rb",
+    "lib/piwik/site.rb",
+    "lib/piwik/trackable.rb",
+    "lib/piwik/user.rb",
+    "script/console",
+    "test/files/config/example_piwik.yml",
+    "test/piwik_test.rb",
+    "test/test_helper.rb"
+  ]
+  s.homepage = %q{https://github.com/Achillefs/autometal-piwik}
   s.require_paths = ["lib"]
-  s.rubyforge_project = %q{autometal-piwik}
-  s.rubygems_version = %q{1.4.2}
-  s.summary = %q{A simple Ruby client for the Piwik API}
-  s.test_files = ["test/test_helper.rb"]
+  s.rubygems_version = %q{1.6.1}
+  s.summary = %q{A ruby client for the Piwik API.}
 
   if s.respond_to? :specification_version then
     s.specification_version = 3
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<activesupport>, [">= 2.3.8"])
-      s.add_runtime_dependency(%q<xml-simple>, [">= 1.0.11"])
+      s.add_runtime_dependency(%q<activesupport>, [">= 3.0.9"])
       s.add_runtime_dependency(%q<rest-client>, [">= 1.6.1"])
-      s.add_development_dependency(%q<rubyforge>, [">= 2.0.4"])
-      s.add_development_dependency(%q<hoe>, [">= 2.6.2"])
+      s.add_runtime_dependency(%q<json>, [">= 1.4.6"])
     else
-      s.add_dependency(%q<activesupport>, [">= 2.3.8"])
-      s.add_dependency(%q<xml-simple>, [">= 1.0.11"])
+      s.add_dependency(%q<activesupport>, [">= 3.0.9"])
       s.add_dependency(%q<rest-client>, [">= 1.6.1"])
-      s.add_dependency(%q<rubyforge>, [">= 2.0.4"])
-      s.add_dependency(%q<hoe>, [">= 2.6.2"])
+      s.add_dependency(%q<json>, [">= 1.4.6"])
     end
   else
-    s.add_dependency(%q<activesupport>, [">= 2.3.8"])
-    s.add_dependency(%q<xml-simple>, [">= 1.0.11"])
+    s.add_dependency(%q<activesupport>, [">= 3.0.9"])
     s.add_dependency(%q<rest-client>, [">= 1.6.1"])
-    s.add_dependency(%q<rubyforge>, [">= 2.0.4"])
-    s.add_dependency(%q<hoe>, [">= 2.6.2"])
+    s.add_dependency(%q<json>, [">= 1.4.6"])
   end
 end
+

data/lib/piwik.rb

@@ -1,10 +1,6 @@
-$:.unshift(File.dirname(__FILE__)) unless
-  $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+$:.unshift(File.dirname(__FILE__)) unless $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
 
 require 'piwik/base.rb'
 require 'piwik/site.rb'
 require 'piwik/user.rb'
-require 'piwik/trackable.rb'
-module Piwik
-  VERSION = "0.4.4"
-end
+require 'piwik/trackable.rb'

data/lib/piwik/base.rb

@@ -1,8 +1,8 @@
 require 'rubygems'
 require 'cgi'
-require 'active_support'
+require 'active_support/all'
+require 'json/ext'
 require 'rest_client'
-require 'xmlsimple'
 
 module Piwik
   class ApiError < StandardError; end
@@ -10,6 +10,13 @@ module Piwik
   class UnknownSite < ArgumentError; end
   class UnknownUser < ArgumentError; end
 
+  mattr_accessor :piwik_url
+  mattr_accessor :auth_token
+
+  def self.is_configured?
+    @@piwik_url!=nil && @@auth_token!=nil
+  end
+
   class Base
     @@template  = <<-EOF
 # .piwik
@@ -22,15 +29,27 @@ module Piwik
 piwik_url: 
 auth_token: 
 EOF
-=begin rdoc
-  This is required to normalize the API responses when the Rails XmlSimple version is used
-=end
-  def self.parse_xml xml
-    result = XmlSimple.xml_in(xml, {'ForceArray' => false})
-    result = result['result'] if result['result']
-    result
+
+  def self.config_file
+    if defined?(Rails.root) && Rails.root!=nil
+#     puts "config_file from Rails.root: #{Rails.root.to_s}"
+      Rails.root.join('config', 'piwik.yml')
+#   elsif defined?(RAILS_ROOT) && RAILS_ROOT!=nil
+#     puts "config_file from RAILS_ROOT: #{RAILS_ROOT}"
+#     File.join(RAILS_ROOT, 'config', 'piwik.yml')
+    else
+#     puts "config_file from ~/.piwik"
+      File.join( ENV['HOME'] || ENV['USERPROFILE'] || ENV['HOMEPATH'] || ".", '.piwik' )
+    end
+  end
+
+  def self.parse_json json
+    JSON.parse json
+  end
+  
+  def parse_json json 
+    self.class.parse_json json
   end
-  def parse_xml xml; self.class.parse_xml xml; end
   
   private
     # Calls the supplied Piwik API method, with the supplied parameters.
@@ -44,49 +63,45 @@ EOF
     
     # Calls the supplied Piwik API method, with the supplied parameters.
     # 
-    # Returns a string containing the XML reply from Piwik, or raises a 
+    # Returns the object parsed from JSON reply from Piwik, or raises a 
     # <tt>Piwik::ApiError</tt> exception with the error message returned by Piwik 
     # in case it receives an error.
     def self.call(method, params={}, piwik_url=nil, auth_token=nil)
-      raise MissingConfiguration, "Please edit ~/.piwik to include your piwik url and auth_key" if piwik_url.nil? || auth_token.nil?
-      url = "#{piwik_url}/?module=API&format=xml&method=#{method}"
+      raise MissingConfiguration, "Please edit #{config_file} to include your piwik url and auth_token or configure Piwik.piwik_url and Piwik.auth_token before use" if piwik_url.nil? || auth_token.nil?
+      url = "#{piwik_url}/?module=API&format=json&method=#{method}"
       url << "&token_auth=#{auth_token}" unless auth_token.nil?
       params.each { |k, v| url << "&#{k}=#{CGI.escape(v.to_s)}" }
       verbose_obj_save = $VERBOSE
       $VERBOSE = nil # Suppress "warning: peer certificate won't be verified in this SSL session"
-      xml = RestClient.get(url)
+      json = RestClient.get(url)
       $VERBOSE = verbose_obj_save
-      if xml =~ /error message=/
-        result = XmlSimple.xml_in(xml, {'ForceArray' => false})
+      result = self.parse_json json
+      if json =~ /error message=/
         raise ApiError, result['error']['message'] if result['error']
       end
-      xml
+      result
     end
     
     # Checks for the config, creates it if not found
-    def self.load_config_from_file
+    def self.load_config
       config = {}
-      if defined?(RAILS_ROOT) and RAILS_ROOT != nil
-        home =  RAILS_ROOT
-        filename = "config/piwik.yml"
+      if Piwik.is_configured?
+        config = { :piwik_url => Piwik.piwik_url, :auth_token => Piwik.auth_token }
       else
-        home =  ENV['HOME'] || ENV['USERPROFILE'] || ENV['HOMEPATH'] || "."
-        filename = ".piwik"
-      end
-      temp_config = if File.exists?(File.join(home,filename))
-        YAML::load(open(File.join(home,filename)))
-      else
-        open(File.join(home,filename),'w') { |f| f.puts @@template }
-        YAML::load(@@template)
-      end
-      temp_config.each { |k,v| config[k.to_sym] = v } if temp_config
-      if config[:piwik_url] == nil || config[:auth_token] == nil
-        if defined?(RAILS_ROOT) and RAILS_ROOT != nil
-          raise MissingConfiguration, "Please edit ./config/piwik.yml to include your piwik url and auth_key"
-        else
-          raise MissingConfiguration, "Please edit ~/.piwik to include your piwik url and auth_key"
+        config_file = self.config_file
+        if config_file
+          temp_config = if File.exists?(config_file)
+            YAML::load(open(config_file))
+          else
+            open(config_file,'w') { |f| f.puts @@template }
+            YAML::load(@@template)
+          end
+          temp_config.each { |k,v| config[k.to_sym] = v } if temp_config
         end
-        
+        raise MissingConfiguration, "Please edit #{config_file} to include piwik url and auth_token or configure Piwik.piwik_url and Piwik.auth_token before use" if config[:piwik_url] == nil || config[:auth_token] == nil
+        #cache settings
+        Piwik.piwik_url = config[:piwik_url]
+        Piwik.auth_token = config[:auth_token]
       end
       config
     end

data/lib/piwik/site.rb

@@ -16,7 +16,7 @@ module Piwik
     def initialize(attributes={}, piwik_url=nil, auth_token=nil)
       raise ArgumentError, "expected an attributes Hash, got #{attributes.inspect}" unless attributes.is_a?(Hash)
       @config = if piwik_url.nil? || auth_token.nil?
-        self.class.load_config_from_file
+        self.class.load_config
       else
         {:piwik_url => piwik_url, :auth_token => auth_token}
       end
@@ -35,7 +35,7 @@ module Piwik
     def self.load(site_id, piwik_url=nil, auth_token=nil)
       raise ArgumentError, "expected a site Id" if site_id.nil?
       @config = if piwik_url.nil? || auth_token.nil?
-        load_config_from_file
+        load_config
       else
         {:piwik_url => piwik_url, :auth_token => auth_token}
       end
@@ -62,9 +62,8 @@ module Piwik
       raise ArgumentError, "Site already exists in Piwik, call 'update' instead" unless new?
       raise ArgumentError, "Name can not be blank" if name.blank?
       raise ArgumentError, "Main URL can not be blank" if main_url.blank?
-      xml = call('SitesManager.addSite', :siteName => name, :urls => main_url)
-      result = parse_xml(xml)
-      @id = result.to_i
+      result = call('SitesManager.addSite', :siteName => name, :urls => main_url)
+      @id = result['value'].to_i
       @created_at = Time.current
       id && id > 0 ? true : false
     end
@@ -76,9 +75,8 @@ module Piwik
       raise UnknownSite, "Site not existent in Piwik yet, call 'save' first" if new?
       raise ArgumentError, "Name can not be blank" if name.blank?
       raise ArgumentError, "Main URL can not be blank" if main_url.blank?
-      xml = call('SitesManager.updateSite', :idSite => id, :siteName => name, :urls => main_url)
-      result = parse_xml(xml)
-      result['success'] ? true : false
+      result = call('SitesManager.updateSite', :idSite => id, :siteName => name, :urls => main_url)
+      result['result'] == 'success' ? true : false
     end
     
     def reload
@@ -90,10 +88,10 @@ module Piwik
     # Equivalent Piwik API call: SitesManager.deleteSite (idSite)
     def destroy
       raise UnknownSite, "Site not existent in Piwik yet, call 'save' first" if new?
-      xml = call('SitesManager.deleteSite', :idSite => id)
-      result = parse_xml(xml)
+      result = call('SitesManager.deleteSite', :idSite => id)
+      #puts "\n destroy #{result} \n"
       freeze
-      result['success'] ? true : false
+      result['result'] == 'success' ? true : false
     end
     
     # Gives read access (<tt>'view'</tt>) to the supplied user login for the current
@@ -114,7 +112,8 @@ module Piwik
       give_access_to(:noaccess, login)
     end
     alias_method :remove_access_from, :give_no_access_to
-    
+
+
     # Returns a hash with a summary of access information for the current site 
     # (visits, unique visitors, actions / pageviews, maximum actions per visit, 
     # bounces and total time spent in all visits in seconds), filtered by the 
@@ -126,8 +125,7 @@ module Piwik
     # Equivalent Piwik API call: VisitsSummary.get (idSite, period, date)
     def summary(period=:day, date=Date.today)
       raise UnknownSite, "Site not existent in Piwik yet, call 'save' first" if new?
-      xml = call('VisitsSummary.get', :idSite => id, :period => period, :date => date)
-      result = parse_xml(xml)
+      result = call('VisitsSummary.get', :idSite => id, :period => period, :date => date)
       {
         :visits => result['nb_visits'].to_i,
         :unique_visitors => result['nb_uniq_visitors'].to_i,
@@ -147,9 +145,8 @@ module Piwik
     # Equivalent Piwik API call: VisitsSummary.getVisits (idSite, period, date)
     def visits(period=:day, date=Date.today)
       raise UnknownSite, "Site not existent in Piwik yet, call 'save' first" if new?
-      xml = call('VisitsSummary.getVisits', :idSite => id, :period => period, :date => date)
-      result = parse_xml(xml)
-      result.to_i
+      result = call('VisitsSummary.getVisits', :idSite => id, :period => period, :date => date)
+      result['value']
     end
     
     # Returns the amount of unique visitors for the current site, filtered by 
@@ -161,9 +158,8 @@ module Piwik
     # Equivalent Piwik API call: VisitsSummary.getUniqueVisitors (idSite, period, date)
     def unique_visitors(period=:day, date=Date.today)
       raise UnknownSite, "Site not existent in Piwik yet, call 'save' first" if new?
-      xml = call('VisitsSummary.getUniqueVisitors', :idSite => id, :period => period, :date => date)
-      result = parse_xml(xml)
-      result.to_i
+      result = call('VisitsSummary.getUniqueVisitors', :idSite => id, :period => period, :date => date)
+      result['value']
     end
     
     # Returns the amount of actions (pageviews) for the current site, filtered 
@@ -175,12 +171,68 @@ module Piwik
     # Equivalent Piwik API call: VisitsSummary.getActions (idSite, period, date)
     def actions(period=:day, date=Date.today)
       raise UnknownSite, "Site not existent in Piwik yet, call 'save' first" if new?
-      xml = call('VisitsSummary.getActions', :idSite => id, :period => period, :date => date)
-      result = parse_xml(xml)
-      result.to_i
+      result = call('VisitsSummary.getActions', :idSite => id, :period => period, :date => date)
+      result['value']
     end
     alias_method :pageviews, :actions
-    
+
+    # Returns a string with the javascript tracking code for the current site.
+    # 
+    # Equivalent Piwik API call: SitesManager.getJavascriptTag (idSite)
+    def get_javascript_tag
+      raise UnknownSite, "Site not existent in Piwik yet, call 'save' first" if new?
+      result = call('SitesManager.getJavascriptTag', :idSite => id)
+      #puts "get_javascript_tag #{result.to_s}"
+      result['value']
+    end    
+
+    # Returns a big Array of Hashes with all page titles along with standard Actions metrics for each row, for the current site.
+    #
+    # Example result:
+    # => [{"label"=>" Izdelava spletnih strani | Spletnik d.o.o.", "nb_visits"=>36, "nb_uniq_visitors"=>35, "nb_hits"=>41, "sum_time_spent"=>240, "entry_nb_uniq_visitors"=>"33", "entry_nb_visits"=>"36", "entry_nb_actions"=>"92", "entry_sum_visit_length"=>"3422", "entry_bounce_count"=>"20", "exit_nb_uniq_visitors"=>"19", "exit_nb_visits"=>"22", "avg_time_on_page"=>7, "bounce_rate"=>"56%", "exit_rate"=>"61%"}]
+    #
+    # Equivalent Piwik API call: Actions.getPageTitles (idSite, period, date, segment = '', expanded = '', idSubtable = '')
+    def get_page_titles(params={})
+      raise UnknownSite, "Site not existent in Piwik yet, call 'save' first" if new?
+      result = call('Actions.getPageTitles', {:idSite => id, :period => :day, :date => Date.today, :segment => '', :expanded => '', :idSubtable => ''}.update(params))
+      #puts "get_page_titles: #{result}"
+      result
+    end
+
+    # Returns a big Array of Hashes with all page urls along with standard Actions metrics for each row, for the current site.
+    #
+    # Example result:
+    # => [{"label"=>"spletnik", "nb_visits"=>69, "nb_hits"=>87, "sum_time_spent"=>4762, "entry_nb_visits"=>40, "entry_nb_actions"=>101, "entry_sum_visit_length"=>6752, "entry_bounce_count"=>26, "exit_nb_visits"=>39, "avg_time_on_page"=>69, "bounce_rate"=>"65%", "exit_rate"=>"57%", "idsubdatatable"=>1}]
+    #
+    # Example call:
+    #  
+    # Piwik::Site.load(203).get_page_urls(:expanded=>1)
+    #
+    # Equivalent Piwik API call: Actions.getPageUrls (idSite, period, date, segment = '', expanded = '', idSubtable = '')
+    def get_page_urls(params={})
+      raise UnknownSite, "Site not existent in Piwik yet, call 'save' first" if new?
+      result = call('Actions.getPageUrls', { :idSite => id, :period => :day, :date => Date.today, :segment => '', :expanded => '', :idSubtable => '' }.update(params))
+      #puts "get_page_urls: #{result}"
+      result
+    end
+
+    def bounce_count(period=:day, date=Date.today)
+      raise UnknownSite, "Site not existent in Piwik yet, call 'save' first" if new?
+      result = call('VisitsSummary.getBounceCount', :idSite => id, :period => period, :date => date)
+      result['value']
+    end
+
+    def sum_visits_length(period=:day, date=Date.today)
+      raise UnknownSite, "Site not existent in Piwik yet, call 'save' first" if new?
+      result = call('VisitsSummary.getSumVisitsLength', :idSite => id, :period => period, :date => date)
+      result['value']
+    end
+
+    def website_referrers(period=:day, date=Date.today)
+      raise UnknownSite, "Site not existent in Piwik yet, call 'save' first" if new?
+      call('Referers.getWebsites', :idSite => id, :period => period, :date => date)
+    end
+
     private
       # Loads the attributes in the instance variables.
       def load_attributes(attributes)
@@ -198,9 +250,9 @@ module Piwik
       # Equivalent Piwik API call: UsersManager.setUserAccess (userLogin, access, idSites)
       def give_access_to(access, login)
         raise UnknownSite, "Site not existent in Piwik yet, call 'save' first" if new?
-        xml = call('UsersManager.setUserAccess', :idSites => id, :access => access.to_s, :userLogin => login.to_s)
-        result = parse_xml(xml)
-        result['success'] ? true : false
+        result = call('UsersManager.setUserAccess', :idSites => id, :access => access.to_s, :userLogin => login.to_s)
+        #result['success'] ? true : false
+        result['result'] == 'success' ? true : false  
       end
 
       # Returns a hash with the attributes of the supplied site, identified 
@@ -208,15 +260,17 @@ module Piwik
       # 
       # Equivalent Piwik API call: SitesManager.getSiteFromId (idSite)
       def self.get_site_attributes_by_id(site_id, piwik_url, auth_token)
-        xml = call('SitesManager.getSiteFromId', {:idSite => site_id}, piwik_url, auth_token)
-        result = parse_xml(xml)
+        result = call('SitesManager.getSiteFromId', {:idSite => site_id}, piwik_url, auth_token)
+        #puts "get_site_attributes_by_id #{result.to_s}"
+        raise UnknownSite, "Site not existent in Piwik" if result.kind_of?(Hash) && result['value'] == false
         attributes = {
-          :id => result['row']['idsite'].to_i,
-          :name => result['row']['name'],
-          :main_url => result['row']['main_url'],
-          :created_at => Time.parse(result['row']['ts_created'])
+          :id => result[0]['idsite'].to_i,
+          :name => result[0]['name'],
+          :main_url => result[0]['main_url'],
+          :created_at => Time.parse(result[0]['ts_created'])
         }
         attributes
       end
+
   end
 end