Extension IATI Registry


Extension Basics

Title
IATI Registry
Name
ckanext-iati
Type
Public extension
Description
This extension powers the IATI Registry (iatiregistry.org), the global repository of aid data following the IATI Standard. Features include: custom publisher (organization) management with approval workflow, custom dataset schema for IATI XML files, CSV import/export for bulk dataset management, daily archiver for downloading and validating IATI files, issue tracking for data quality problems, email notifications for publisher activation, custom theme, and Google Analytics integration.
CKAN versions
Download-Url (zip)
Last commit
a year ago (2025-02-20 11:42:46)
Url to repo
Category
Cloud Infrastructure & Storage


Background Infos

Description (long)
Show details

International Aid Transparency Initiative (IATI) Registry Extension for CKAN

.. image:: https://api.travis-ci.org/ViderumGlobal/ckanext-iati.svg?branch=master

:target: https://travis-ci.org/ViderumGlobal/ckanext-iati

  • Installation_
  • Migrating from the old Registry version_
  • Configuration_
  • General workflow_
  • Main customizations_
  • Copying and License_

Installation

The current version of ckanext-iati has been developed and tested again CKAN 2.9.1. We assume a running CKAN 2.9.1 instance.

The installation has the following steps, assuming you have a running copy of CKAN:

. Install the extension from its source repository::

(pyenv) $ pip install -e git+https://github.com/IATI/ckanext-iati#egg=ckanext-iati

. Install dependencies::

(pyenv) $ pip install -r ckanext-iati/pip-requirements.txt

Set up the configuration options as described in the Configuration_ section.

Migrating from the old Registry version

The previous version of the registry run on CKAN 1.5.1. To upgrade the database follow the following steps:

. Backup the CKAN 1.5.1 database

. Run the normal update command::

(pyenv) $ cd ckan
(pyenv) $ paster db upgrade

. Run the SQL script to transform Groups to Organizations::

sudo -u postgres psql -f ckanext-iati/scripts/groups_to_orgs.sql

. Edit the users_to_members.py script with a suitable API key and run it

to create members for the migrated organizations::

(pyenv) $ python ckanext-iati/scripts/users_to_members.py

. Run a final SQL script to cleanup the database (may take a long time)::

sudo -u postgres psql -f ckanext-iati/scripts/cleanup_db.sql

Configuration

Create a sysadmin user called iati-archiver and note down its API key, you will need to ad

Version
1.1.9
Version release date
2018-03-26
Contact name
International Aid Transparency Initiative
Contakt email
Contact Url
(not set)


Installation Guide

Configuration hints
Plugins to configure (ckan.ini)
iati_publishers iati_datasets iati_theme iati_csv
CKAN Settings (ckan.ini)
# ckanext.archiver.user_agent_string = "IATI (CKAN)"
DB migration to be executed
upgrade
<< back to Extensions