semvec/pypi-packages huggingface dataset:
djangocms-career 0.1.3
Django CMS Plugin to showcase a career or educational paths on portfolio and CV-Websites.
License: BSD License

######################
DjangoCMS Career
######################

DjangoCMS Career is a plugin to easily showcase career and educational paths.
The recommended use for this plugin is on a Portfolio- or a personal CV-Website.
The plugin was initially created for - and first used by - my personal `CV-Page`_.

.. _CV-Page: https://dmonn.ch

+------------------------------------------------------------------------------------------------------+
| .. image:: https://raw.githubusercontent.com/dmonn/djangocms-career/master/docs/img/presentation.png |
+------------------------------------------------------------------------------------------------------+

============
Installation
============

This plugin requires `django CMS` 3.0.2+ or higher to be properly installed.

* In yourpip projects `virtualenv`, run ``pip install djangocms-career``.
* Add ``djangocms_career`` to your ``INSTALLED_APPS`` (the order does not matter).
* Run ``manage.py migrate djangocms_career``.

=====
Usage
=====

DjangoCMS Career is a CMS- *Plugin*, which means, you can only use it in the frontend editing mode.
In an available placeholder, just choose a *Career Plugin Container* and use the 'Plus'-Sign to add Positions to it.

+--------------------------------------------------------------------------------------------------+
| .. image:: https://raw.githubusercontent.com/dmonn/djangocms-career/master/docs/img/career-1.png |
+--------------------------------------------------------------------------------------------------+

This dropdown will usually open if you click on a placeholder in structure-mode.

+--------------------------------------------------------------------------------------------------+
| .. image:: https://raw.githubusercontent.com/dmonn/djangocms-career/master/docs/img/career-2.png |
+--------------------------------------------------------------------------------------------------+

After you've added a *Career Plugin Container*, you can add *Positions*.

=============
Customization
=============

To override the plugins template, add ``djangocms_career/position_object.html`` to your template path.

To customize the colors of the plugin, you have to override the CSS. ::

        .position-duration::before,
        .position-duration::after{
            background: YOURCOLOR;
        }


        .duration-circle {
            background: YOURCOLOR;
        }


=========
Run tests
=========

You can run tests via ``manage.py test djangocms_career``

============
Contributing
============

This is a community project. We love to get any feedback in the form of
`issues`_ and `pull requests`_.

.. _issues: https://github.com/dmonn/djangocms-career/issues
.. _pull requests: https://github.com/dmonn/djangocms-career/pulls