Extension Portal


Extension Basics

Title
Portal
Name
ckanext-portal
Type
Public extension
Description
Extends organization and dataset entities to comply with the portal metadata structure, adding carousel and portal customization capabilities.
CKAN versions
Download-Url (zip)
Last commit
a year ago (2024-08-27 16:34:56)
Url to repo
Category
Content Management


Background Infos

Description (long)
Show details

ckanext-portal

With this plugin, you extend the organization, and dataset entities to comply with the portal metadata structure.

Requirements

This plugin includes schemas and thus the ckanext-scheming is a requirement for it to function properly.

Installation

  1. Activate your CKAN virtual environment:

    . /usr/lib/ckan/default/bin/activate

  2. Install the ckanext-portal Python package:

    pip install ckanext-portal

  3. Add portal to the ckan.plugins setting in your CKAN config file.

  4. Restart CKAN.

Config settings

Adding and enabling the portal schema will modify the forms used to update and create each entity. Enable the plugin by including it in the configuration options:

ckan.plugins = ... portal ...

Set the schemas you want to use:

# For dataset portal schema:
scheming.dataset_schemas = ckanext.portal:scheming/schemas/portal.json

# For organization portal schema:
scheming.organization_schemas = ckanext.portal:scheming/schemas/organization/portal_organization.json

Portal dataset schema keys

  • carousel_active: choose to display a dataset in the portal’s carousel widget
  • carousel_order: set the order in which you want the dataset to be displayed in the carousel widget
  • carousel_image: set an image URL to be displayed as a background image
  • carousel_text: set a description to be displayed in your carousel activated dataset

Portal organization schema keys

  • portal_intro_text: set an intro text to be displayed in your portal’s homepage screen

API Endpoints

  • scheming_package_show: An extended version of package_show, returning information fitted to what the Dataplatform Portal needs.

License

AGPL-3.0

Version
1.0.0
Version release date
2024-08-27
Contact name
Civity
Contakt email
Contact Url
(not set)


Installation Guide

Configuration hints

Add ‘portal’ to ckan.plugins. Requires ckanext-scheming. Configure dataset and organization schemas.

Plugins to configure (ckan.ini)
portal
CKAN Settings (ckan.ini)
# scheming.dataset_schemas = ckanext.portal:scheming/schemas/portal.json
# scheming.organization_schemas = ckanext.portal:scheming/schemas/organization/portal_organization.json
DB migration to be executed
(not set)
<< back to Extensions