README.md

Common Catalog

Common catalog for various uses.

The program is built on the Django CMS framework.

The program itself does not contain any cascading styles or javascript code. CSS styles and js are only in the example.

Install

Install the package from pypi.org.

pip install djangocms-common-catalog

Add into INSTALLED_APPS in your site settings.py:

INSTALLED_APPS = [
    ...
    'common_catalog',
]

Extra settings

• COMMON_CATALOG_TEMPLATE_LIST - custom template for the list of items.
• COMMON_CATALOG_TEMPLATE_DETAIL - custom template the Item detail.
• COMMON_CATALOG_LOCATIONS - Custom filter location names.
• COMMON_CATALOG_FILTER_QUERY_NAME - URL query name. Default is cocaf.
• COMMON_CATALOG_DETAIL_PARENT_TEMPLATE - Name of parent template on Item detail page.

Site example

Along with the program, an example is stored in the repository that you can run in the docker.

Download the example:

curl https://gitlab.nic.cz/djangocms-apps/djangocms-common-catalog/-/archive/main/djangocms-common-catalog-main.zip?path=example --output example.zip

Extract the archive and go to the folder:

unzip example.zip
cd djangocms-common-catalog-main-example/example/

Build the image:

docker build -t catalog .

Run the site:

docker run --rm -d -p 8000:8000 --name catalog_example catalog

Open the site in your browser: http://localhost:8000/. You'll see what's in the screenshots.

Login to the administration: http://localhost:8000/admin with username admin and password password.

Stop the site:

docker stop catalog_example

License

GPLv3+