Metadata-Version: 2.4
Name: eteaching.plone.openbadges
Version: 1.1.1
Summary: Open Badge integration for Plone 6.
Project-URL: Homepage, https://github.com/e-teachingorg/eteaching.plone.openbadges
Project-URL: PyPI, https://pypi.org/project/eteaching.plone.openbadges
Project-URL: Source, https://github.com/e-teachingorg/eteaching.plone.openbadges
Project-URL: Tracker, https://github.com/e-teachingorg/eteaching.plone.openbadges/issues
Project-URL: Documentation, https://github.com/e-teachingorg/eteaching.plone.openbadges
Project-URL: ChangeLog, https://github.com/e-teachingorg/eteaching.plone.openbadges/blob/main/CHANGELOG.md
Author-email: Markus Schmidt <m.schmidt@iwm-tuebingen.de>
License-Expression: GPL-2.0-only
License-File: LICENSE.GPL
License-File: LICENSE.md
Keywords: CMS,Plone,Python
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: Framework :: Plone :: 6.0
Classifier: Framework :: Plone :: 6.1
Classifier: Framework :: Plone :: 6.2
Classifier: Framework :: Plone :: Addon
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Requires-Dist: plone-api
Requires-Dist: products-cmfplone
Requires-Dist: z3c-jbot
Provides-Extra: release
Requires-Dist: zest-pocompile; extra == 'release'
Requires-Dist: zest-releaser[recommended]; extra == 'release'
Requires-Dist: zestreleaser-towncrier; extra == 'release'
Provides-Extra: test
Requires-Dist: horse-with-no-namespace; extra == 'test'
Requires-Dist: plone-app-testing; extra == 'test'
Requires-Dist: plone-classicui; extra == 'test'
Requires-Dist: plone-restapi[test]; extra == 'test'
Requires-Dist: pytest; extra == 'test'
Requires-Dist: pytest-cov; extra == 'test'
Requires-Dist: pytest-plone>=1.0.0a2; extra == 'test'
Description-Content-Type: text/markdown

# eteaching.plone.openbadges

Open Badge integration for [Plone 6](https://plone.org/).

Once the add-on has been installed, the Plone CMS operator can act as the issuing institution. This means they can use a control panel to enter their organisation's data, as well as any necessary prefixes for badge titles. They can then create a new badge in the portal using the new OpenBadges content type. This template provides a title, description, SVG image, award criteria and an associated resource. Additionally, an award period can be specified during which registered Plone members can collect the badge. The badge assertion (the personalised badge) is then automatically generated in the OpenBadge folder. To generate this, a logged-in Plone member must be directed to the badge's URL. This can be done via a link at the end of a successfully completed course, for example. The member will then receive a note detailing the criteria for receiving the badge and will be able to generate it with a single click and switch to the personalised badge view. There, the hosted badge can be verified by entering the email address or using the assertion from external systems. Additionally, badge recipients have the option to share their badge.

## Features

- Provides a way to create Open Badges
- Provides a way to host Open Badges
- Provides a way to register an issuing organization
- Provides a view that allows Open Badges to be viewed, shared, and validated


## Prerequisites
* Plone 6.1 (Classic UI), Plone 6.0 should also work
* Python 3.10, 3.12, 3.13
* Git

## Install

```bash
git clone https://github.com/e-teachingorg/eteaching.plone.openbadges.git
cd eteaching.plone.openbadges
python3 -m venv .
bin/pip3 install uv
source bin/activate
make install
make create-site
```

### Start

```bash
make start
```
* Point your browser to http://localhost:8080
* Login with admin admin


## Install with existing Plone 6.1 buildout

Please note that you need zc.buildout >= 5.1.1. Check requirements.txt

Open your buildout.cfg

```bash
[instance]
eggs +=
    eteaching.plone.openbadges
```

### Rerun buildout

```bash
bin/buildout
```


## Install as source packages using buildout

Open your dev.cfg

```bash
[buildout]
extends = buildout.cfg

parts +=
    instance

auto-checkout +=
    eteaching.plone.openbadges

[sources]
eteaching.plone.openbadges = git https://github.com/e-teachingorg/eteaching.plone.openbadges.git
```

### Rerun buildout

Please note that you need zc.buildout >= 5.1.1. Check requirements.txt

```bash
bin/buildout -c dev.cfg
bin/pip3 install -e src/eteaching.plone.openbadges/
```

### Activate

```bash
* Start Plone
* Point your browser to your plone site
* Login as admin
* Goto configuration --> extensions
* Install eteaching.plone.openbadges
```

## Authors

[Markus Schmidt](https://github.com/Arkusm)

## Contribute

- Issue Tracker: https://github.com/e-teachingorg/eteaching.plone.openbadges/issues
- Source Code: https://github.com/e-teachingorg/eteaching.plone.openbadges

## Support

If you are having issues, please let us know.

## License

The project is licensed under the GPLv2.

## Funding information
The eteaching.plone.openbadges was funded as part of a publicly financed project by the Federal Ministry of Research, Technology and Space of the Federal Republic of Germany.
