Hea

From Koha Wiki
Jump to navigation Jump to search

Hea: Koha Usage Statistics

What is Hea

It's a website to collect data from libraries using Koha: https://hea.koha-community.org

Why these statistics are useful

The main information we will be able to have is how many libraries are using Koha?

How big are they? How many patrons are registered? How many items do they have?

Moreover, the developers need to know which parts of Koha are used and which other parts are not.

This way they will concentrate on features used by most people.

They will also be able to clean up unused code.

How to collaborate

To have your library data displayed on the website, you can go to "Home › Administration › Usage statistics" and fill in the information you want to share.

Fill the info you want to share

By default you are not sharing anything and see:

Hea not sharing.png

Switch "Share my Koha usage statistics:" to "yes", then fill in the other data you want to share.

To set the geolocation you need to click on the blue pin then click on the map.

Hea sharing 1.png

You can share the data for each library you have in your installation, do it by setting "Libraries information:" to "yes"

Hea sharing 2.png

When everything is setup as you want to see it on the public website, click the "Update" button at the bottom of the page.

Share the data

So far the data are only stored locally, in your database. To share them with the Koha community you need to run a script. If you installed using the packages the cronjob is already set up to run on a monthly basis (in /etc/cron.monthly/koha-common you will see koha-foreach --chdir --enabled /usr/share/koha/bin/cronjobs/share_usage_with_koha_community.pl).

For your first time you may want to share the data immediately without waiting. To do you so you can run perl misc/cronjobs/share_usage_with_koha_community.pl

You will immediately see the result on the Hea website. To get your public page you need to refresh the page and click on the "See your public page: " link.

Hea website public page.png

Which data is sent?

Only the number of lines in these database tables (anonymous):

  • biblio
  • items
  • auth_header
  • old_issues
  • old_reserves
  • borrowers
  • aqorders
  • subscription

And some system preference values to know which configuration options of Koha are used and which are the preferred settings. You can find the list of system preference values in C4/UsageStats.pm.

The first time data is sent, a random ID (UsageStatsID) is generated server side. Please don't change it, to not bias the results.