{"id":24443803,"url":"https://github.com/endlessm/kolibri-explore-plugin","last_synced_at":"2025-07-22T17:03:00.162Z","repository":{"id":37801807,"uuid":"329302802","full_name":"endlessm/kolibri-explore-plugin","owner":"endlessm","description":"The kolibri plugin to add the custom channel representation","archived":false,"fork":false,"pushed_at":"2024-07-15T18:49:42.000Z","size":69730,"stargazers_count":2,"open_issues_count":60,"forks_count":4,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-06-19T20:14:01.499Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/endlessm.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-01-13T12:34:42.000Z","updated_at":"2024-09-14T15:06:33.000Z","dependencies_parsed_at":"2023-12-19T04:28:12.878Z","dependency_job_id":"f841c150-d371-41e9-be1c-d3162de259f2","html_url":"https://github.com/endlessm/kolibri-explore-plugin","commit_stats":{"total_commits":1123,"total_committers":12,"mean_commits":93.58333333333333,"dds":0.6589492430988424,"last_synced_commit":"dca2861a13c26cc961018e6c8ee660b6f1850174"},"previous_names":[],"tags_count":155,"template":false,"template_full_name":null,"purl":"pkg:github/endlessm/kolibri-explore-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/endlessm%2Fkolibri-explore-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/endlessm%2Fkolibri-explore-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/endlessm%2Fkolibri-explore-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/endlessm%2Fkolibri-explore-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/endlessm","download_url":"https://codeload.github.com/endlessm/kolibri-explore-plugin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/endlessm%2Fkolibri-explore-plugin/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266076308,"owners_count":23872737,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-20T22:17:41.786Z","updated_at":"2025-07-22T17:03:00.129Z","avatar_url":"https://github.com/endlessm.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kolibri Explore Plugin\n\nThis plugin adds the Endless Key experience on top of Kolibri:\n\n- A content navigation view exposed in the `/explore` URL. As an\n  alternative to the Kolibri Learn plugin for self-guided learners.\n\n- Branding and layout customizations for several channels.\n\n- Download of content packs with extra metadata.\n\n## Usage\n\nThis is a plugin for Kolibri, so it must be installed in your Kolibri\nenvironment.\n\nInstall latest release from PyPi:\n\n```\npip install kolibri-explore-plugin\n```\n\nThen enable it in Kolibri and run migrations:\n\n```\nkolibri plugin enable kolibri_explore_plugin\nkolibri manage migrate\n```\n\nDownload the `apps-bundle.zip` from the [GitHub releases\npage](https://github.com/endlessm/kolibri-explore-plugin/releases) and\nextract them to the `kolibri_explore_plugin/apps` folder.  Note that\nthis is not ideal, because you should know where has `pip` installed\nthe plugin.\n\nDownload the JSON files from the\n[endless-key-collections](https://github.com/endlessm/endless-key-collections/tree/main/json)\nrepo and place them in `kolibri_explore_plugin/static/collections/`.\n\nNow start Kolibri. You should be able to navigate to `/explore` if `/`\ndoesn't redirect you already.\n\n## Setup\n\nMake sure you already have the **latest** `pipenv`.\n\nEither if you want to build or develop the plugin, please run:\n\n```\n./scripts/bootstrap.sh\n```\n\nJust like Kolibri, we use a Python virtual environment along with Node\nto obtain the exact same dependencies.\n\n## Building\n### Creating the `.whl` file\n\nWith all the dependencies installed, it's now possible to build the\nplugin by running:\n\n```\nyarn build-dist\n```\n\nA `.whl` file will be created in the `dist/` folder. You\ncan then install it:\n\n```\npip install dist/kolibri_explore_plugin-*.whl\n```\n\n## Testing\n### Backend tests\n\nTests for the Python backend can be run by executing `python -m pytest`\nor `yarn run test:python`. See the plugin\n[`test`](kolibri_explore_plugin/test) directory for more details about\nthe Python testing infrastructure.\n\n## Development\n### Getting started with development\n\nFor developing you could build and install the `.whl` file over and\nover for each iteration. But is much easier to install the project in\neditable mode, which basically creates a symlink:\n\n```\npip install --editable .\n```\n\n**Note:** you still need to enable the plugin and run migrations as in\nUsage above!\n\nThen serve the plugin in watch mode:\n\n```\nyarn dev\n```\n\nUsually you will also be developing Kolibri, as described in\n[the Kolibri developer documentation](https://kolibri-dev.readthedocs.io/en/develop/getting_started.html).\n\nSo probably you have the following running in another Terminal tab:\n\n```\nyarn run devserver-hot\n```\n\nAnd you can edit both the plugin and Kolibri in live-mode. Further,\nyou can also edit a custom channel presentation in another Terminal\ntab. See \"Developing custom channel presentations\" section below.\n\n### Configuring the precommit hook\n\nTo run checks before any commit just run this command:\n\n```\npre-commit install -f --install-hooks\n```\n\nThere is a continuous integration tool in Github that will run the\nsame checks for each pull request.\n\n### Bundling custom channel presentations\n\nThere is a Github action that does this automatically on each\nrelease. To do it locally yourself:\n\n```\nyarn build:apps\n```\n\nAll custom presentation app bundles should be added in the\n`kolibri_explore_plugin/apps` directory to have this fully working.\nThe zip bundle should be named `custom-channel-ui.zip` and it should\nbe placed inside the corresponding app folder.\n\n### Developing custom channel presentations\n\nInstead of bundling the custom channel presentation inside the apps\ndirectory, it's possible to work with a proxy for development. Note\nthat the proxy will be used for all the channels, not only for the\nchannel in question.\n\n1. Run the custom channel presentation development server. For\n   instance to run the template:\n\n```bash\n$ cd packages/template-ui\n$ yarn serve\n```\n\n2. Run Kolibri with the `PROXY_CUSTOM_CHANNEL` environment variable\n   enabled:\n\n```bash\n$ cd /PATH/TO/kolibri\n$ PROXY_CUSTOM_CHANNEL=1 yarn run devserver-hot\n```\n\nEvery request to the `custom-channel-ui.zip` will be proxied to the\ndevserver. The hot reloading should work here too!\n\n### Ingesting highlighted content\n\nMake sure to have a `.env` file with the spreadsheet key as content:\n\n```bash\nCONTENT_SPREADSHEET_KEY=123456\n```\n\nThen run the script:\n\n```\n./scripts/ingest_highlighted.py\n```\n\nIf everything goes well, the `highlighted-content.json` file will be\nupdated. You then need to commit the file.\n\n### Releasing\n\n#### Release with GitHub action\n\nTriggering [Bump version to release](https://github.com/endlessm/kolibri-explore-plugin/actions/workflows/bump2release.yml)\naction from `bump2release.yml` will do all release steps mentioned in\n[Release with local environment](#release-with-local-environment)\nautomatically, including:\n* Bump version and create a new tag\n* Publish kolibri-explore-plugin wheel package to PyPI\n* Release apps-bundle.zip\n\n#### Release with local environment\n\nTo release a new version first please bump the version number to\neither major or minor. Note that the major version also needs a version\nname for branding. For example:\n\n```bash\n# For a minor release:\nyarn bump-version minor\n\n# For a major release:\nyarn bump-version major \"Komodo Dragon\"\n```\n\nThat creates a new commit and a git tag. Please push them to the\nremote:\n\n```bash\ngit push\ngit push origin NEW_TAG\n```\n\nThe `bump-version` script can also be run with options such as\n`--dry-run --list` or `--no-commit` to see what will happen. You can\nalso specify `--current-version` to see the effect without actually\nchanging the current version. See `bumpversion --help` for all options.\n\n#### Release candidates\n\nPyPI and `pip` support release candidates with the `rc\u003cN\u003e` suffix. Prior\nto major releases it may be helpful to build and publish release\ncandidates so they can be tested prior to general availability. Our\n`bumpversion` configuration has limited support for release candidates,\nso care should be taken to ensure the new version comes out correctly.\n\nTo begin a release candidate series, the version must be fully specified:\n\n```bash\nyarn bump-version major \"Komodo Dragon\" --new-version 7.0.0rc1\n```\n\nTo make the next release candidate, run:\n\n``` bash\nyarn bump-version rc\n```\n\nFinally, to end a release candidate series, the version must be fully\nspecified again:\n\n``` bash\nyarn bump-version major \"Komodo Dragon\" --new-version 7.0.0\n```\n\nIn all cases, the commit and tag must be pushed to the remote as\nexplained above.\n\n### How to display the build information\n\nTo show the build information in the front page, as a tag in top right corner,\nyou can set the environment variable, `SHOW_BUILD_INFO` to \"true\", for example,\nfor the development kolibri server:\n\n```\n$ SHOW_BUILD_INFO=true yarn run devserver\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fendlessm%2Fkolibri-explore-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fendlessm%2Fkolibri-explore-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fendlessm%2Fkolibri-explore-plugin/lists"}