openAFRICA CKAN Extension
CKAN theme for openAFRICA platform accessible at https://openafrica.net/
Development
Then follow the steps below to install the openAfrica extension:
Step 1:
- Activate your virtual environment; use the path to your virtual environment. On Mac OSX, you may have to use
/usr/local/lib/ckan/default/bin/activate. You can copy the code as it is below, including the preceeding dot.
. /usr/lib/ckan/default/bin/activate
Step 2:
If you are not a developer and just want to install the extension from package, just run this command from your virtual environment:
pip install ckanext-openafrica
Note: If you wish to modify the extension in any way, you can download the source code and install the extension manually. To do so, execute the following command:
$ pip install -e git+https://github.com/CodeForAfrica/ckanext-openafrica.git#egg=ckanext-openafrica
Alternatively: You can clone this repo (preferrably into the /src directory where you installed CKAN), cd into ckanext-openafrica and run
$ python setup.py develop
Step 3:
- Modify your configuration file (generally in
/etc/ckan/default/production.ini) and add openafrica in the ckan.plugins property.
ckan.plugins = openafrica <OTHER_PLUGINS>
Step 4:
paster serve /etc/ckan/default/production.ini
OR
paster serve --reload /etc/ckan/default/production.ini
With --reload, your server is restarted automatically whenever you make changes in your source code.
If your extension is installed successfully, your page will change to the openAfrica theme.
Note: This extension, being a thememing extension, may override templates from other extensions. Templates in /ckanext/openafrica/templates
may require some modifications to render properly with openAfrica extension.
Contributing
If you’ve found a bug/issue in the extension, ope