Extension Intro


Extension Basics

Title
Intro
Name
ckanext-intro
Type
Public extension
Description
A quick interactive introduction to writing CKAN extensions. Used in the CKAN workshop at OKCon 2013 as a step-by-step tutorial.
CKAN versions
Download-Url (zip)
Last commit
12 years ago (2013-09-15 15:08:56)
Url to repo
Category
Specialized Tools


Background Infos

Description (long)
Show details

ckanext-intro - A quick interactive introduction to writing CKAN extensions

This is a sample extension, intended as a quick and interactive introduction to writing CKAN extensions. It was used in the CKAN workshop at OKCon 2013.

This does not go into as much details as the proper tutorials for writing extensions. Developers willing to start writing CKAN extensions should use those as they provide all necessary detail:

  • Writing extensions tutorial: http://docs.ckan.org/en/latest/extensions/tutorial.html
  • Custom theming tutorial: http://docs.ckan.org/en/latest/extensions/theming.html

Requisites

  • A running source CKAN 2.1 install (http://docs.ckan.org/en/latest/install-from-source.html)
  • A sysadmin user
  • Some datasets created

Installation

Install the extension as usual, in your activated virtualenv:

pip install -e git+https://github.com/okfn/ckanext-intro.git#egg=ckanext-intro

If you want to jump straight away to the end result, just add the plugin to your CKAN configuration file:

ckan.plugins = intro_plugin

It is recommended though that you follow the individual steps as described in the next section.

How it works

The repository contains a step-by-step process of building an extension. Each step is contained in a single commit, and flagged with a git tag (step1, step2, …)

You can move between steps using the git checkout command. For example to start on the first step:

git checkout step1

To move to the next step:

git checkout step2

And so on.

Version
Version release date
(not set)
Contact name
CKAN
Contakt email
(not set)
Contact Url
(not set)


Installation Guide

Configuration hints

Requires CKAN 2.1 source install. Educational purposes only.

Plugins to configure (ckan.ini)
intro_plugin
CKAN Settings (ckan.ini)
# No specific environment variables required
DB migration to be executed
(not set)
<< back to Extensions