=================
Aldryn django CMS
=================
|build| |coverage|
Aldryn django CMS is an opinionated django CMS setup bundled as an Aldryn addon for the
`Divio Cloud <https://docs.divio.com>`_.
`Aldryn addons <https://docs.divio.com/en/latest/background/addons-basics/>`_ are
wrappers around Python packages, that take care of their installation and configuration.
Python/Django compatibility
===========================
This version of Aldryn django CMS installs |djangocms| and is compatible with:
|python| |django|
Get started
===========
See the `Divio Developer Handbook <https://docs.divio.com>`_ for general information on using the platform. Start with
the `tutorial <https://docs.divio.com/introduction>`_ if this is new to you.
Recommended
-----------
To use Aldryn django CMS, create a new Aldryn **django CMS** project on `the Divio Control Panel
<https://control.divio.com>`_. This project type includes Aldryn django CMS along with some additional packages in
order to set up a ready-to-go project. The additional packages include Django Filer, a default set of plugins, Django
Parler and others.
Alternative option
------------------
Alternatively, you can install Aldryn django CMS in an Aldryn Divio Django project, but in this case, you will need
to install Django Filer and other components included in the Divio django CMS base project yourself.
How to
=================
Contribute
----------
This is a an open-source project. We'd be delighted to receive your
feedback in the form of issues and pull requests. Before submitting your
pull request, please review our `contribution guidelines
<http://docs.django-cms.org/en/latest/contributing/index.html>`_.
We're grateful to all contributors who have helped create and maintain this package.
Contributors are listed at the `contributors <https://github.com/divio/aldryn-django-cms/graphs/contributors>`_
section.
Run tests
-------------
Run tests by executing::
virtualenv env
source env/bin/activate
pip install -r tests/requirements.txt
python setup.py test
Release a new version
---------------------
Each Aldryn django CMS release uses the version number of the corresponding django CMS release, with an extra number
(starting with ``1``) to indicate the version of Aldryn django CMS for that release. So for example version ``3.7.4.3``
of Aldryn django CMS is the *third* Aldryn django CMS version that installs django CMS 3.7.4.
Repeat the following until you are satisfied that the Addon works as expected:
#. Ensure that you are working in a clean local directory, and that no unwanted compiled or other files are present.
#. Update the ``CHANGELOG.rst`` as and if required.
#. Update the version number in ``__init__.py`` and ``setup.py``.
#. Use the Divio CLI to verify and upload the addon (see `How to update an existing addon
<https://docs.divio.com/en/latest/how-to/addon-update-existing/>`_ to the the *Alpha* channel.
#. Test the Addon on the Divio platform.
Once satisfied:
#. Push to Git, make a pull request, ask for a review, obtain approval, squash and merge.
#. Tag with the version number.
#. Move the release to the *Beta* or *Stable* channel as appropriate, and add a note to the Changelog field,
on Divio.
#. Notify the team via Slack.
.. |build| image:: https://github.com/divio/aldryn-django-cms/actions/workflows/default.yml/badge.svg?branch=support/4.0.x
:target: https://github.com/divio/aldryn-django-cms/actions
.. |coverage| image:: https://codecov.io/gh/divio/aldryn-django-cms/branch/support/4.0.x/graph/badge.svg
:target: https://codecov.io/gh/divio/aldryn-django-cms
.. |python| image:: https://img.shields.io/badge/python-3.8%20%7C%C2%A03.9%20%7C%C2%A03.10%20%7C%C2%A03.11-blue.svg
:target: https://pypi.org/project/aldryn-django-cms/
.. |django| image:: https://img.shields.io/badge/django-3.2%20%7C%203.1%20%7C%C2%A04.2-blue.svg
:target: https://www.djangoproject.com/
.. |djangocms| image:: https://img.shields.io/badge/django%20CMS-4.0-blue.svg
:target: https://www.django-cms.org/
Raw data
{
"_id": null,
"home_page": "https://github.com/divio/aldryn-django-cms",
"name": "aldryn-django-cms",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Divio AG",
"author_email": "info@divio.ch",
"download_url": "https://files.pythonhosted.org/packages/33/ee/dd6614432b4f99bae1c6aa1fa2bc2f34cc2b4ccf528bb45507305bf3408b/aldryn_django_cms-4.0.1.19.tar.gz",
"platform": null,
"description": "=================\nAldryn django CMS\n=================\n\n|build| |coverage|\n\nAldryn django CMS is an opinionated django CMS setup bundled as an Aldryn addon for the\n`Divio Cloud <https://docs.divio.com>`_.\n\n`Aldryn addons <https://docs.divio.com/en/latest/background/addons-basics/>`_ are\nwrappers around Python packages, that take care of their installation and configuration.\n\nPython/Django compatibility\n===========================\n\nThis version of Aldryn django CMS installs |djangocms| and is compatible with:\n\n|python| |django|\n\n\nGet started\n===========\n\nSee the `Divio Developer Handbook <https://docs.divio.com>`_ for general information on using the platform. Start with\nthe `tutorial <https://docs.divio.com/introduction>`_ if this is new to you.\n\n\nRecommended\n-----------\n\nTo use Aldryn django CMS, create a new Aldryn **django CMS** project on `the Divio Control Panel\n<https://control.divio.com>`_. This project type includes Aldryn django CMS along with some additional packages in\norder to set up a ready-to-go project. The additional packages include Django Filer, a default set of plugins, Django\nParler and others.\n\nAlternative option\n------------------\n\nAlternatively, you can install Aldryn django CMS in an Aldryn Divio Django project, but in this case, you will need\nto install Django Filer and other components included in the Divio django CMS base project yourself.\n\n\nHow to\n=================\n\nContribute\n----------\n\nThis is a an open-source project. We'd be delighted to receive your\nfeedback in the form of issues and pull requests. Before submitting your\npull request, please review our `contribution guidelines\n<http://docs.django-cms.org/en/latest/contributing/index.html>`_.\n\nWe're grateful to all contributors who have helped create and maintain this package.\nContributors are listed at the `contributors <https://github.com/divio/aldryn-django-cms/graphs/contributors>`_\nsection.\n\n\nRun tests\n-------------\n\nRun tests by executing::\n\n virtualenv env\n source env/bin/activate\n pip install -r tests/requirements.txt\n python setup.py test\n\n\nRelease a new version\n---------------------\n\nEach Aldryn django CMS release uses the version number of the corresponding django CMS release, with an extra number\n(starting with ``1``) to indicate the version of Aldryn django CMS for that release. So for example version ``3.7.4.3``\nof Aldryn django CMS is the *third* Aldryn django CMS version that installs django CMS 3.7.4.\n\nRepeat the following until you are satisfied that the Addon works as expected:\n\n#. Ensure that you are working in a clean local directory, and that no unwanted compiled or other files are present.\n#. Update the ``CHANGELOG.rst`` as and if required.\n#. Update the version number in ``__init__.py`` and ``setup.py``.\n#. Use the Divio CLI to verify and upload the addon (see `How to update an existing addon\n <https://docs.divio.com/en/latest/how-to/addon-update-existing/>`_ to the the *Alpha* channel.\n#. Test the Addon on the Divio platform.\n\nOnce satisfied:\n\n#. Push to Git, make a pull request, ask for a review, obtain approval, squash and merge.\n#. Tag with the version number.\n#. Move the release to the *Beta* or *Stable* channel as appropriate, and add a note to the Changelog field,\n on Divio.\n#. Notify the team via Slack.\n\n\n.. |build| image:: https://github.com/divio/aldryn-django-cms/actions/workflows/default.yml/badge.svg?branch=support/4.0.x\n :target: https://github.com/divio/aldryn-django-cms/actions\n.. |coverage| image:: https://codecov.io/gh/divio/aldryn-django-cms/branch/support/4.0.x/graph/badge.svg\n :target: https://codecov.io/gh/divio/aldryn-django-cms\n\n.. |python| image:: https://img.shields.io/badge/python-3.8%20%7C%C2%A03.9%20%7C%C2%A03.10%20%7C%C2%A03.11-blue.svg\n :target: https://pypi.org/project/aldryn-django-cms/\n.. |django| image:: https://img.shields.io/badge/django-3.2%20%7C%203.1%20%7C%C2%A04.2-blue.svg\n :target: https://www.djangoproject.com/\n.. |djangocms| image:: https://img.shields.io/badge/django%20CMS-4.0-blue.svg\n :target: https://www.django-cms.org/\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "An opinionated django CMS setup bundled as an Divio Cloud addon",
"version": "4.0.1.19",
"project_urls": {
"Homepage": "https://github.com/divio/aldryn-django-cms"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "35926b626c8eecfc279e14c697f27fcfa69e7ece7f14aa21328e0f52e5b38266",
"md5": "eec7619272467b7973f317c423c49824",
"sha256": "bc7ac9ef619bc4c09ff8ee1bbceeaad59f4f9aed61b94797550121f5fe0f4084"
},
"downloads": -1,
"filename": "aldryn_django_cms-4.0.1.19-py3-none-any.whl",
"has_sig": false,
"md5_digest": "eec7619272467b7973f317c423c49824",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 7961,
"upload_time": "2025-10-09T09:27:57",
"upload_time_iso_8601": "2025-10-09T09:27:57.442025Z",
"url": "https://files.pythonhosted.org/packages/35/92/6b626c8eecfc279e14c697f27fcfa69e7ece7f14aa21328e0f52e5b38266/aldryn_django_cms-4.0.1.19-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "33eedd6614432b4f99bae1c6aa1fa2bc2f34cc2b4ccf528bb45507305bf3408b",
"md5": "5558cc15f264798a228baa70bdab3f0b",
"sha256": "411b13d0fa947b47d02ad3253244659cfa441c82527a3dc40cef205bdb8370dd"
},
"downloads": -1,
"filename": "aldryn_django_cms-4.0.1.19.tar.gz",
"has_sig": false,
"md5_digest": "5558cc15f264798a228baa70bdab3f0b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7327,
"upload_time": "2025-10-09T09:27:58",
"upload_time_iso_8601": "2025-10-09T09:27:58.426352Z",
"url": "https://files.pythonhosted.org/packages/33/ee/dd6614432b4f99bae1c6aa1fa2bc2f34cc2b4ccf528bb45507305bf3408b/aldryn_django_cms-4.0.1.19.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-09 09:27:58",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "divio",
"github_project": "aldryn-django-cms",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "aldryn-django-cms"
}
JSON
