`` to the DOM. It is suggested to enable the\n``margin-top`` and ``margin-bottom`` CSS styles, so that the ruler can be positioned\nappropriately.\n\n\nHeadingPlugin\n=============\n\nThis plugins adds a text heading ``
``...```` to the DOM. Although simple headings can be\nachieved with the **TextPlugin**, there they can't be styled using special CSS classes or styles.\nHere the **HeadingPlugin** can be used, since any allowed CSS class or style can be added.\n\n\nCustomSnippetPlugin\n===================\n\nNot every collection of DOM elements can be composed using the Cascade plugin system. Sometimes one\nmight want to add a simple HTML snippet. Altough it is quite simple to create a customized plugin\nyourself, an easier approach to just render an arbitrary HTML snippet, is to use the\n**CustomSnippetPlugin**. This can be achieved by adding the customized template to the project's\n``settings.py``:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t # other settings\n\t 'plugins_with_extra_render_templates': {\n\t 'CustomSnippetPlugin': [\n\t ('myproject/snippets/custom-template.html', \"Custom Template Identifier\"),\n\t # other tuples\n\t ],\n\t },\n\t}\n\nNow, when editing the page, a plugin named **Custom Snippet** appears in the *Generic* section in\nthe plugin's dropdown menu. This plugin then offers a select element, where the site editor then can\nchose between the configured templates.\n\n\nAdding children to a CustomSnippetPlugin\n----------------------------------------\n\nIt is even possible to add children to the **CustomSnippetPlugin**. Simple add these templatetag_s\nto the customized template, and all plugins which are children of the **CustomSnippetPlugin** will\nbe rendered as well.\n\n.. code-block:: django\n\n\t{% load cms_tags %}\n\t\n\t{% for plugin in instance.child_plugin_instances %}\n\t {% render_plugin plugin %}\n\t{% endfor %}\n\t \n\n.. _templatetag: https://docs.djangoproject.com/en/stable/ref/templates/language/#tags\n"
},
{
"path": "docs/source/hide-plugins.rst",
"content": "==============================\nConditionally hide some plugin\n==============================\n\nSometimes a placholder contains some plugins, which temporarily should not show up while rendering.\nIf this feature is enabled, then instead of deleting them, it is possible to hide them.\n\n\nEnable the meachanism\n=====================\n\nIn the projects ``settings.py``, add:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'allow_plugin_hiding': True,\n\t ...\n\t}\n\nBy default, this feature is disabled. If enabled, **djangocms-cascade** adds a checkbox to every\nplugin editor. This checkbox is labeled *Hide plugin*. If checked, the plugin and all of it's\nchildren are not rendered in the current tree. To easily distinguish hidden plugins in structure\nmode, they are rendered using a shaded background.\n"
},
{
"path": "docs/source/icon-fonts.rst",
"content": "======================\nUsing Fonts with Icons\n======================\n\nIntroduction\n============\n\nSometimes we want to enrich our web pages with vectorized symbols. A lot of them can be found in\nvarious font libraries, such as `Font Awesome`_, `Material Icons`_, `Streamline Icons`_ and many\nmore. A typical approach would be to upload the chosen SVG symbol, and use it as image. This\nprocess however is time consuming and error-prone to organize. Therefore, **djangocms-cascade**\noffers an optional submodule, so that we can work with externally packed icon fonts.\n\nIn order to use such a font, currently we must use Fontello_, an external service for icon font\npackaging. In the future, this service might be integrated into **djangocms-cascade** itself.\n\nThis submodule, if enabled adds three additional plugins: **Icon with frame**, **Simple icon** and\n**Icon in text**. Additionally it allows to decorate buttons with an icon on the left or right side\nof its main content.\n\n\nConfiguration\n-------------\n\nTo enable this service in **djangocms-cascade**, in ``settings.py`` add:\n\n.. code-block:: python\n\n\tINSTALLED_APPS = [\n\t β¦\n\t 'cmsplugin_cascade',\n\t 'cmsplugin_cascade.icon',\n\t β¦\n\t]\n\n\tCMSPLUGIN_CASCADE_PLUGINS = [\n\t β¦\n\t 'cmsplugin_cascade.icon',\n\t β¦\n\t]\n\nThis submodule, can of course be combined with all other submodules available for the Cascade\necosystem.\n\nIf ``CMS_PLACEHOLDER_CONF`` is used to configure available plugins for each placeholder, assure\nthat the ``TextIconPlugin`` is added to the list of ``text_only_plugins``.\n\nSince the CKEditor widget must load the font stylesheets for it's own WYSIWIG mode, we have to add\nthis special setting to our configuration:\n\n.. code-block:: python\n\n\tfrom django.core.urlresolvers import reverse_lazy\n\tfrom django.utils.text import format_lazy\n\n\tCKEDITOR_SETTINGS = {\n\t β¦\n\t 'stylesSet': format_lazy(reverse_lazy('admin:cascade_texteditor_config')),\n\t}\n\n\nUploading the Font\n==================\n\nIn order to start with an external font icon, choose one or more icons and/or whole font families\nfrom the Fontello_ website and download the generated webfont zip-file to a local folder on your\ncomputer.\n\nIn Django's admin backend, change into ``Start βΊ django CMS Cascade βΊ Uploaded Icon Fonts`` and\nadd an Icon Font object. Choose an appropriate name and upload the just downloaded webfont file,\nwithout unzipping it. After the upload completed, all the imported icons appear grouped by their\nfont family name. They now are ready for being used by the Icon plugin.\n\n.. attention::\n\tThe icon fonts generated by Fontello_, offer a generated ``β¦.css`` file containing a mapping of\n\tprivate UTF-8 characters onto their font symbol. This means that the genarated font files may\n\thave an overlapping encoding. Therefore each uploaded font requires a unique CSS prefix,\n\totherwise it wouldn't be possible to use more than one icon font per page. This prefix must be\n\tset under Fontello's settings, located left of the **Download webfont** button.\n\nAttempting to upload an icon fonts with a CSS prefix, which is already used, will be rejected.\n\n.. warning::\n\tDepending on your settings, Safari auto-unzips that file and hence makes it unusable for\n\tre-upload. Either change your settings in Safari (Preferences > General > Open \"safe\" files),\n\tor use another browser.\n\n.. note::\n\tDuring the 0.17-series of **djangocms-cascade**, an icon font had to be selected per page,\n\trather than per element. This feature turned out to be impractical and has been reverted to\n\tthe pre-0.17 behaviour.\n\n\nUsing the Icon Plugin\n=====================\n\nIn **djangocms-cascade**, currently four plugins make use of the icon font sublibrary. These\nare the **Simple Icon**, the **Icon with frame**, the **Button** and the **Icon in Text** plugin.\nThe latter is available only as subplugin of the **Text Editor** plugin.\n\nIn their respective editors, the user may select one of the uploaded icon fonts. Each time one\nof them is selected, the table of symbols is rerendered. Use the search field on the top of the\ntable to restrict the list of icons, in case there are too many.\n\nChoose the desired symbol, its size and color. Optionally choose a background color, a border with\nwidth, color and style, and the relative position in respect of its wrapping element. After saving\nthe form, that element should appear inside the chosen container.\n\n\nShared Settings\n---------------\n\nBy default, the **IconPlugin** is configured to allow to share the following styling attributes:\n\n* Icon size\n* Icon color\n* Background color, or without background\n* Text alignment\n* Border width, color and style\n* Border radius\n\nBy storing these attributes under a common name, one can reuse them across various icons, without\nhaving to set them for each one, separately. Additionally, each of the shared styling attributes\ncan be changed globally in Django's admin backend at\n``Start βΊ django CMS Cascade βΊ Shared between Plugins``. For details please refer to the section\nabout :ref:`sharable-fields`.\n\n\nUsing the Icon Plugin in plain text\n===================================\n\nIf **django-CMS** is configured to use the `CKEditor for django-CMS`_, then you may use the\n**Icon Plugin** inside plain text. Place the cursor at the desired location in text and select\n**Icon** from the pull down menu **CMS Plugins**. This opens a popup where you may select the\nfont family and the symbol. All other attributes described above, are not available with this\ntype of plugin.\n\n.. _Font Awesome: http://fontawesome.io/\n.. _Material Icons: https://design.google.com/icons/\n.. _Streamline Icons: https://streamlineicons.com/\n.. _Fontello: http://fontello.com/\n.. _CKEditor for django-CMS: https://pypi.org/project/djangocms-text-ckeditor/\n"
},
{
"path": "docs/source/impatient.rst",
"content": "=================\nFor the Impatient\n=================\n\nThis HowTo gives you a quick instruction on how to get a demo of **djangocms-cascade** up and\nrunning. It also is a good starting point to ask questions or report bugs, since its backend is\nused as a fully functional reference implementation, used by the unit tests of project.\n\n\nCreate a Python Virtual Environment\n===================================\n\nTo keep environments separate, create a virtual environment and install external dependencies.\nMissing packages with JavaScript files and Style Sheets, which are not available via pip must be\ninstalled via npm:\nDependency packaging to made easy with Pipenv or Poetry.\n\n.. code-block:: bash\n\n\t$ git clone --depth=1 https://github.com/jrief/djangocms-cascade.git\n\t$ cd djangocms-cascade/examples/bs4demo\n\t$ python -m venv .venv \n\t$ poetry shell\n\t$ poetry update\n\nInitialize the database, create a superuser and start the development server:\n\n.. code-block:: bash\n\n\t$ cd djangocms-cascade/examples/bs4demo\n\t$ npm install\n\t$ ./manage.py migrate\n\t$ ./manage.py createsuperuser\n\t$ ./manage.py runserver\n\nPoint a browser to http://localhost:8000/?edit and log in as the super user you just\ncreated. Hit \"next\" and fill out the form to create your first page. Afterwards, click **Structure**\non the top of the page. A heading named **Main Content** appears, it symbolizes our main\n**django-CMS** Placeholder.\n\nLocate the plus sign right to the heading and click on it. From its context menu select\n**Container** located in the section **Bootstrap**:\n\n|add-container|\n\n.. |add-container| image:: _static/bootstrap3/add-container.png\n\nThis brings you into the editor mode for a Bootstrap container. To this container you may add one or\nmore Bootstrap **Rows**. Inside these rows you may organize the layout using some Bootstrap\n**Columns**.\n\nPlease proceed with the detailed explanation on how to use the\n:ref:`Bootstrap's grid ` system within **djangocms-cascade**.\n"
},
{
"path": "docs/source/index.rst",
"content": "============================================\nWelcome to DjangoCMS-Cascade's documentation\n============================================\n\nProject's home\n==============\n\nCheck for the latest release of this project on GitHub_.\n\nPlease report bugs or ask questions using the `Issue Tracker`_.\n\n\nProject's goals\n===============\n\n#. Create a modular system, which allows programmers to add simple widget code, without having to\n implement an extra djangoCMS_ plugins for each of them.\n\n#. Make available a meaningful subset of widgets as available for the most common CSS frameworks,\n such as `Twitter Bootstrap`_. With these special plugins, in many configurations, **djangoCMS**\n can be operated using one single template, containing one generic placeholder.\n\n#. Extend this **djangoCMS** plugin, to be used with other CSS frameworks such as `Foundation 5`_,\n Unsemantic_ and others.\n\n#. Use the base functionality of **djangoCMS-Cascade** to easily add special plugins. For instance,\n djangoSHOP_ implements all its cart and checkout specific forms this way.\n\n\nContents:\n=========\n\n.. toctree::\n :maxdepth: 2\n :numbered:\n\n impatient\n introduction\n installation\n link-plugin\n bootstrap3/index\n icon-fonts\n leaflet\n client-side\n section\n segmentation\n sharable-fields\n customize-styles\n render-template\n hide-plugins\n clipboard\n strides\n sphinx\n customized-plugins\n generic-plugins\n changelog\n\n\nIndices and tables\n==================\n\n* :ref:`genindex`\n* :ref:`modindex`\n* :ref:`search`\n\n.. _Github: https://github.com/jrief/djangocms-cascade\n.. _Issue Tracker: https://github.com/jrief/djangocms-cascade/issues\n.. _djangoCMS: https://www.django-cms.org/\n.. _djangoSHOP: https://www.django-shop.org/\n.. _Twitter Bootstrap: http://getbootstrap.com/\n.. _Foundation 5: http://foundation.zurb.com/\n.. _Grid System 960: http://960.gs/\n.. _Unsemantic: http://unsemantic.com/\n"
},
{
"path": "docs/source/installation.rst",
"content": "============\nInstallation\n============\n\nInstall the latest stable release\n\n.. code-block:: bash\n\n\t$ pip install djangocms-cascade\n\nor the current development release from github\n\n.. code-block:: bash\n\n\t$ pip install -e git+https://github.com/jrief/djangocms-cascade.git#egg=djangocms-cascade\n\n\nPython Package Dependencies\n===========================\n\nDue to some incompatibilities in the API of Django, django-CMS and djangocms-text-ckeditor, please\nonly use these combinations of Python package dependencies:\n\ndjangocms-cascade-0.11.x\n------------------------\n\n* Django_ >=1.8, <=1.9\n* Django-CMS_ >=3.2, <=3.3\n* djangocms-text-ckeditor_ == 3.0\n\ndjangocms-cascade-0.12.x\n------------------------\n\n* Django_ >=1.9, <1.11\n* Django-CMS_ >=3.4.3\n* djangocms-text-ckeditor_ >= 3.3\n\ndjangocms-cascade-0.13.x\n------------------------\n\n* Django_ >=1.9, <1.11\n* Django-CMS_ >=3.4.3\n* djangocms-text-ckeditor_ >= 3.4\n\ndjangocms-cascade-0.14.x\n------------------------\n\n* Django_ >=1.9, <1.11\n* Django-CMS_ >=3.4.4\n* djangocms-text-ckeditor_ >= 3.4\n* django-filer_ >= 1.2.8\n\ndjangocms-cascade-0.17.x - 0.19.x\n---------------------------------\n\n* Django_ >=1.10, <2.0\n* Django-CMS_ >=3.4.4, <=3.6\n* djangocms-text-ckeditor_ >= 3.4\n\ndjangocms-cascade-1.0.x\n-----------------------\n\n* Django_ >=1.11, <=2.1\n* Django-CMS_ >=3.5.3, <=3.6.x\n* djangocms-text-ckeditor_ >= 3.7\n\nother combinations might work, but have not been tested.\n\n\nOptional packages\n-----------------\n\nIf you intend to use Image, Picture, Jumbotron, or FontIcons you will have to install django-filer\nin addition:\n\n.. code-block:: bash\n\n\t$ pip install django-filer\n\nFor a full list of working requirements see the `requirements folder`_ in the sources.\n\n.. _requirements folder: https://github.com/jrief/djangocms-cascade/tree/master/requirements\n\n\nCreate a database schema\n========================\n\n.. code-block:: bash\n\n\t./manage.py migrate cmsplugin_cascade\n\n\nInstall Dependencies not handled by PIP\n=======================================\n\nSince the Bootstrap CSS and other JavaScript files are part of their own repositories, they are\nnot shipped within this package. Furthermore, as they are not part of the PyPI network, they have\nto be installed through the `Node Package Manager`_, ``npm``.\n\nIn your Django projects it is good practice to keep a reference onto external node modules using\nthe file ``packages.json`` added to its own version control repository, rather than adding the\ncomplete node package.\n\n.. code-block:: bash\n\n\tcd my-project-dir\n\tnpm init\n\tnpm install bootstrap@3 bootstrap-sass@3 jquery@3 leaflet@1 leaflet-easybutton@2.2 picturefill select2@4 --save\n\nIf the Django project contains already a file named ``package.json``, then skip the ``npm init``\nin the above command.\n\nThe node packages ``leaflet`` and ``leaflet-easybutton`` are only required if the Leaflet plugin\nis activated.\n\nThe node packages ``picturefill`` is a shim to support the ``srcset`` and ``sizes`` attributes on\n``![]()
`` elements. Please check `browser support`_ if that feature is required in your\nproject.\n\nThe node packages ``select2`` is required for autofilling the select box in Link plugins. It is\noptional, but strongly suggested.\n\nRemember to commit the changes in ``package.json`` into the projects version control repository.\n\nSince these Javascript and Stylesheet files are located outside of the project's ``static`` folder,\nwe must add them explicitly to our lookup path, using ``STATICFILES_DIRS`` in ``settings.py``:\n\n.. code-block:: python\n\n\tSTATICFILES_DIRS = [\n\t ...\n\t ('node_modules', os.path.join(MY_PROJECT_DIR, 'node_modules')),\n\t]\n\n\nUsing AngularJS instead of jQuery\n---------------------------------\n\nIf you prefer AngularJS over jQuery, then replace the above install command with:\n\n.. code-block:: bash\n\n\tnpm install bootstrap@3 bootstrap-sass@3 angular@1.5 angular-animate@1.5 angular-sanitize@1.5 angular-ui-bootstrap@0.14 leaflet@1 leaflet-easybutton@2.2 picturefill select2@4 --save\n\nRemember to point to the prepared AngularJS templates using this setting:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'bootstrap3': {\n\t 'template_basedir': 'angular-ui',\n\t },\n\t ...\n\t}\n\n\nConfiguration\n=============\n\nAdd ``'cmsplugin_cascade'`` to the list of ``INSTALLED_APPS`` in the projectβs ``settings.py``\nfile. Optionally add 'cmsplugin_cascade.extra_fields' and/or 'cmsplugin_cascade.sharable' to\nthe list of ``INSTALLED_APPS``. Make sure that these entries are located before the entry ``cms``.\n\n\nConfigure the CMS plugin\n------------------------\n\n.. code-block:: python\n\n\tINSTALLED_APPS = (\n\t ...\n\t 'cmsplugin_cascade',\n\t 'cmsplugin_cascade.clipboard', # optional\n\t 'cmsplugin_cascade.extra_fields', # optional\n\t 'cmsplugin_cascade.sharable', # optional\n\t 'cmsplugin_cascade.segmentation', # optional\n\t 'cms',\n\t ...\n\t)\n\n\nActivate the plugins\n--------------------\n\nBy default, no **djangocms-cascade** plugins is activated. Activate them in the projectβs\n``settings.py`` with the directive ``CMSPLUGIN_CASCADE_PLUGINS``.\n\nTo activate all available Bootstrap plugins, use:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE_PLUGINS = ['cmsplugin_cascade.bootstrap3']\n\nIf for some reason, only a subset of the available Bootstrap plugins shall be activated, name each\nof them. If for example, only the grid system shall be used but no other Bootstrap plugins, then\nconfigure:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE_PLUGINS = ['cmsplugin_cascade.bootstrap3.container']\n\nA very useful plugin is the **LinkPlugin**. It superseds the djangocms-link_-plugin, normally used\ntogether with the CMS.\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE_PLUGINS.append('cmsplugin_cascade.link')\n\nIf this plugin is enabled ensure, that the node package ``select2`` has been installed and findable\nby the static files finder using these directives in ``settings.py``:\n\n.. code-block:: python\n\n SELECT2_CSS = 'node_modules/select2/dist/css/select2.min.css'\n SELECT2_JS = 'node_modules/select2/dist/js/select2.min.js'\n\n:ref:`generic-plugins` which are not opinionated towards a specific CSS framework, are kept in a\nseparate folder. It is strongly suggested to always activate them:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE_PLUGINS.append('cmsplugin_cascade.generic')\n\nSometimes it is useful to do a :ref:`segmentation`. Activate this by adding its plugin:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE_PLUGINS.append('cmsplugin_cascade.segmentation')\n\n\nWhen :ref:`icon-fonts`: on your site, add ``'cmsplugin_cascade.icon'`` to ``INSTALLED_APPS``\nand add it to the configured Cascade plugins:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE_PLUGINS.append('cmsplugin_cascade.icon')\n\n\nSpecial settings when using the TextPlugin\n------------------------------------------\n\nSince it is possible to add plugins from the Cascade ecosystem as children to the\n`djangocms-text-ckeditor`_, we must add a special configuration:\n\n.. code-block:: python\n\n\tfrom django.core.urlresolvers import reverse_lazy\n\tfrom django.utils.text import format_lazy\n\n\tCKEDITOR_SETTINGS = {\n\t 'language': '{{ language }}',\n\t 'skin': 'moono-lisa',\n\t 'toolbar': 'CMS',\n\t 'stylesSet': format_lazy('default:{}', reverse_lazy('admin:cascade_texteditor_config')),\n\t}\n\nThe last line in this configuration invokes a special function, which adds special configuration settings to the\nCKTextEditor plugin.\n\n.. note:: The skin ``moono-lisa`` has been introduced in Django CKEditor version 3.5, so if you upgrade from an earlier\n\tversion, please adopt this in your settings.\n\n\nRestrict plugins to a particular placeholder\n--------------------------------------------\n\n.. warning:: You **must** set ``parent_classes`` for your placeholder, else you\n won't be able to add a container to your placeholder. This means that as an\n absolute minimum, you must add this to your settings:\n\n.. code-block:: python\n\n\tCMS_PLACEHOLDER_CONF = {\n\t ...\n\t 'content': {\n\t 'parent_classes': {'BootstrapContainerPlugin': None,},\n\t },\n\t ...\n\t}\n\nUnfortunately **django-CMS** does not allow to declare dynamically which plugins are eligible to be\nadded as children of other plugins. This is determined while bootstrapping the Django project and\nthus remains static. We therefore must somehow trick the CMS to behave as we want.\n\nSay, our Placeholder named \"Main Content\" shall accept the **BootstrapContainerPlugin** as its only\nchild, we then must use this CMS settings directive:\n\n.. code-block:: python\n\n\tCMS_PLACEHOLDER_CONF = {\n\t ...\n\t 'Main Content Placeholder': {\n\t 'plugins': ['BootstrapContainerPlugin'],\n\t 'text_only_plugins': ['TextLinkPlugin'],\n\t 'parent_classes': {'BootstrapContainerPlugin': None},\n\t 'glossary': {\n\t 'breakpoints': ['xs', 'sm', 'md', 'lg'],\n\t 'container_max_widths': {'xs': 750, 'sm': 750, 'md': 970, 'lg': 1170},\n\t 'fluid': False,\n\t 'media_queries': {\n\t 'xs': ['(max-width: 768px)'],\n\t 'sm': ['(min-width: 768px)', '(max-width: 992px)'],\n\t 'md': ['(min-width: 992px)', '(max-width: 1200px)'],\n\t 'lg': ['(min-width: 1200px)'],\n\t },\n\t },\n\t },\n\t ...\n\t}\n\nHere we add the **BootstrapContainerPlugin** to ``plugins`` and ``parent_classes``. This is because\nthe Container plugin normally is the root plugin in a placeholder. If this plugin would not restrict\nits parent plugin classes, we would be allowed to use it as a child of any plugin. This could\ndestroy the page's grid.\n\nFurthermore, in the above example we must add the **TextLinkPlugin** to ``text_only_plugins``.\nThis is because the **TextPlugin** is not part of the Cascade ecosystem and hence does not know\nwhich plugins are allowed as its children.\n\nThe dictionary named ``glossary`` sets the initial parameters of the :ref:`bootstrap3/grid`.\n\n\nDefine the leaf plugins\n-----------------------\n\nLeaf plugins are those, which contain real data, say text or images. Hence the default setting\nis to allow the **TextPlugin** and the **FilerImagePlugin** as leafs. This can be overridden using\nthe configuration directive\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'alien_plugins': ['TextPlugin', 'FilerImagePlugin', 'OtherLeafPlugin'],\n\t ...\n\t}\n\n\nBootstrap 3 with AngularJS\n--------------------------\n\nSome Bootstrap3 plugins can be rendered using templates which are suitable for the very popular\n`Angular UI Bootstrap`_ framework. This can be done during runtime; when editing the plugin a\nselect box appears which allows to chose an alternative template for rendering.\n\n\nTemplate Customization\n======================\n\nMake sure that the style sheets are referenced correctly by the used templates. **Django-CMS**\nrequires django-sekizai_ to organize these includes, so a strong recommendation is to use that\nDjango app.\n\nThe templates used for a **django-CMS** project shall include a header, footer, the menu bar and\noptionally a breadcrumb, but should leave out an empty working area. When using HTML5, wrap this\narea into an ```` or ```` element or just use it unwrapped.\n\nThis placeholder then shall be named using a generic identifier, for instance \"Main Content\" or\nsimilar:\n\n.. code-block:: html\n\n\t{% load cms_tags sekizai_tags %}\n\t\n\t ...\n\t {% render_block \"css\" postprocessor \"cmsplugin_cascade.sekizai_processors.compress\" %}\n\t\n\n\t\n\t ...\n\t \n\t {% placeholder \"Main Content\" %}\n\t \n\t {% render_block \"js\" postprocessor \"cmsplugin_cascade.sekizai_processors.compress\" %}\n\t\n\nFrom now on, the page layout can be adopted inside this placeholder, without having to fiddle with\ntemplate coding anymore.\n\nNote the two templatetags ``render_block``. The upper one collects all the CSS files referenced by\n``{% addtoblock \"css\" ... %}``. The lower one collects all the JS files referenced by\n``{% addtoblock \"js\" ... %}``. They then are rendered alltogether instead of beeing distributed all\nacross the page. If django-compressor_ is installed and enabled, then add the special compressor\n``\"cmsplugin_cascade.sekizai_processors.compress\"`` to the templatetag. It can handle files outside\nthe ``STATIC_ROOT``directory.\n\n.. _Django: http://djangoproject.com/\n.. _Django-CMS: https://www.django-cms.org/\n.. _Angular UI Bootstrap: http://angular-ui.github.io/bootstrap/\n.. _pip: http://pypi.python.org/pypi/pip\n.. _django-sekizai: http://django-sekizai.readthedocs.org/en/latest/\n.. _django-compressor: http://django-compressor.readthedocs.org/en/latest/\n.. _djangocms-link: https://github.com/divio/djangocms-link\n.. _djangocms-text-ckeditor: https://github.com/divio/djangocms-text-ckeditor\n.. _django-filer: https://github.com/divio/django-filer\n.. _Node Package Manager: https://nodejs.org/en/download/\n.. _browser support: https://caniuse.com/#search=srcset\n"
},
{
"path": "docs/source/introduction.rst",
"content": "============\nIntroduction\n============\n\n**DjangoCMS-Cascade** is a collection of plugins for Django-CMS_ >=3.3 to add various HTML elements\nfrom CSS frameworks, such as `Twitter Bootstrap`_ to the Django templatetag_ placeholder_. This\nDjango App makes it very easy to add other CSS frameworks, or to extend an existing collection with\nadditional elements.\n\n**DjangoCMS-Cascade** allows web editors to layout their pages, without having to create different\n`Django templates`_ for each layout modification. In most cases, one template with one single\nplaceholder is enough. The editor then can subdivide that placeholder into rows and columns, and\nadd additional DOM_ elements such as buttons, rulers, or even the Bootstrap Carousel. Some basic\nunderstanding on how the DOM works is required though.\n\n**Twitter Bootstrap** is a well documented CSS framework which gives web designers lots of\npossibilities to add a consistent structure to their pages. This collection of `Django-CMS plugins`_\noffers a subset of these predefined elements to web designers.\n\n\nExtensibility\n=============\n\nThis module requires one database table with one column to store all data in a JSON object. All\n**DjangoCMS-Cascade** plugins share this same model, therefore they can be easily extended, because\nnew data structures are added to that JSON object without requiring a database migration.\n\nAnother three database tables are required for additional optional features.\n\n\nNaming Conflicts\n----------------\n\nSome **djangoCMS** plugins may use the same name as plugins from **djangocms-cascade**. To prevent\nconfusion, since version 0.7.2, all Cascade plugins as prefixed with a Ο (koppa) symbol. This can\nbe deactivated or changed by setting ``CMSPLUGIN_CASCADE['plugin_prefix']`` to ``False`` or any\nother symbol.\n\n\n.. _Django-CMS: https://github.com/divio/django-cms/\n.. _Twitter Bootstrap: http://getbootstrap.com/\n.. _Django templates: https://docs.djangoproject.com/en/dev/topics/templates/\n.. _templatetag: https://docs.djangoproject.com/en/dev/howto/custom-template-tags/\n.. _placeholder: https://django-cms.readthedocs.org/en/latest/advanced/templatetags.html#placeholder\n.. _DOM: http://www.w3.org/DOM/\n.. _Django-CMS plugins: https://django-cms.readthedocs.org/en/latest/getting_started/plugin_reference.html\n"
},
{
"path": "docs/source/leaflet.rst",
"content": "=====================================\nMap Plugin using the Leaflet frontend\n=====================================\n\nIf you want to add a interactive maps to a **Django-CMS** placeholder, the **Cascade Leaflet Map\nPlugin** may be your best choice. It is not activated by default, because it requires a special\nJavaScript library, an active Internet connection (in order to load the map tiles), and a license\nkey (this depends on the chosen tiles layer). By default the **Cascade Leaflet Map Plugin** uses\nthe `Open Street Map`_ tile layer, but this can be changed to Mapbox_, `Google Maps`_ or another\nprovider.\n\nThis plugin uses third party packages, based on the `Leaflet JavaScript`_ library for mobile-friendly\ninteractive maps.\n\n.. _Open Street Map: http://www.openstreetmap.org/\n.. _Mapbox: https://www.mapbox.com/\n.. _Google Maps: https://developers.google.com/maps/\n.. _Leaflet JavaScript: http://leafletjs.com/\n\n\nInstallation\n============\n\nThe required JavaScript dependencies are not shipped with **djangocms-cascade**. They must be\ninstalled separately from the `Node JS repository`_.\n\n.. code-block:: shell\n\n\tnpm install leaflet\n\tnpm install leaflet-easybutton\n\n.. note:: Leaflet Easybutton is only required for the administration backend.\n\n.. _Node JS repository: https://www.npmjs.com/\n\n\nConfiguration\n=============\n\nThe default Cascade settings must be active in order to use the **Leaflet Map Plugin**. Additionally\nadd to the project's settings:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE_PLUGINS = [\n\t ...\n\t 'cmsplugin_cascade.leaflet',\n\t ...\n\t]\n\nBy modifying the dictionary ``CMSPLUGIN_CASCADE['leaflet']`` you may override Leaflet specific\nsettings. Change ``CMSPLUGIN_CASCADE['leaflet']['tilesURL']`` to the `titles layer`_ of your choice.\n\nAll other attributes of that dictionary are passed as options to the Leaflet ``tileLayer``\nconstructor. For details, please refer to the Leaflet specific documentation.\n\n.. _titles layer: http://leafletjs.com/reference-1.0.3.html#tilelayer\n\n\nUsage\n=====\n\nAdd a **Map Plugin** to any **django-CMS** placeholder. Here you may adjust the width and height of\nthe map.\n\nThe map can be repositioned at any time. Use the *Center* button on the top left corner to reset the\nposition to the coordinates and zoom level, it was saved the last time.\n\n\nAdding a marker to the map\n--------------------------\n\nFirst click on *Add another Marker* and enter a title of your choice. Afterwards go to the map and\nplace the marker. After saving the map, this new marker will be persisted.\n\nAdditionally, one may choose a customized marker icon: Click on *Use customized marker icon* and\nchoose an image from your media files. It is recommended to use PNG images with a transparent layer\nas marker icons.\n\nAdjust the icon's size by setting the marker width. The height is computed in order to keep the same\naspect ratio.\n\n.. note:: Customized marker icons are only displayed in the frontend. The backend always uses the\n\tdefault pin symbol.\n\nBy settings the marker's anchor, the icon can be positioned exactly.\n\nMarkers can be repositioned at any time and the new coordinates are saved together with the map.\n\n\nAlternative Tiles\n=================\n\nBy default, **djangocms-cascade** is shipped using tiles from the `Open Street Map`_ project.\nThis is mainly because these tiles can be used without requiring a license key. However, they load\nslowly and their appearance might not be what your customers expect.\n\n\nMapbox\n------\n\nA good alternative are tiles from Mapbox_. Please refer to their terms and conditions for details.\nThere you can also apply for an access token, they offer free plans for low traffic sites.\n\nThen add to the project's ``settings.py``:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'leaflet': {\n\t 'tilesURL': 'https://api.tiles.mapbox.com/v4/{id}/{z}/{x}/{y}.png?access_token={accessToken}',\n\t 'accessToken': YOUR-MAPBOX-ACCESS-TOKEN,\n\t ...\n\t }\n\t ...\n\t}\n\n\nGoogle Maps\n-----------\n\nThe problem with Google is that its Terms of Use forbid any means of tile access other than through\nthe Google Maps API. Therefore in the frontend, Google Maps are rendered using a different template,\nwhich is not based on the LeafletJS library. This means that you must edit your maps using Mapbox or\nOpenStreetMap titles, whereas Google Maps is only rendered in the frontend.\n\nTo start with, apply for a `Google Maps API key`_ and add it to the project's ``settings.py``:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'leaflet': {\n\t ...\n\t 'apiKey': YOUR-GOOGLE-MAPS-API-KEY,\n\t ...\n\t }\n\t ...\n\t}\n\nWhen editing a **Map** plugin, choose *Google Map* from the select field named *Render template*.\n\nIf want to render Google Maps exclusively in the frontend, change this in your project's\n``settings.py``:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'plugins_with_extra_render_templates': {\n\t 'LeafletPlugin': [\n\t ('cascade/plugins/googlemap.html', \"Google Map\"),\n\t ],\n\t }\n\t ...\n\t}\n\n.. _Google Maps API key: https://developers.google.com/maps/documentation/javascript/get-api-key\n\n\nDefault Starting Position\n=========================\n\nDepending of the region you normally create maps, you can specify the default starting position. If for instance\nyour main area of interest is Germany, than these coordinates are a good setting:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'leaflet': {\n\t ...\n\t 'default_position': {'lat': 50.0, 'lng': 12.0, 'zoom': 6},\n\t }\n\t ...\n\t}\n\n\nDefault Marker Icon\n===================\n\nIn case you don't like the default marker icon, you can replace it with your own one.\nSimply add to the configuration\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'leaflet': {\n\t ...\n\t 'defaultMarkerIcon': {\n\t 'iconUrl': STATIC_URL + 'my_project/icons/marker.svg',\n\t 'iconSize': (25, 41),\n\t 'iconAnchor': (13, 41),\n\t ...\n\t },\n\t }\n\t ...\n\t}\n\nFor details about all the possible options for a marker icon, refer to the `Leaflet documentation`_.\n\n.. _Leaflet documentation: https://leafletjs.com/reference.html#icon\n\n\nAddress Lookup\n==============\n\nSince version 2.3 it is possible to search for a location, using the `OSM Nominatim`_ lookup\nservice.\n\n.. _OSM Nominatim: https://nominatim.org/\n\nWhen adding or editing a marker, there is a field named **Address lookup**. Entering an address\ninto that field and pressing the \"Enter\" key, generates a list of possible locations. Choose one\nfrom that list and the marker will be placed at the specified coordinates.\n\nIn case you want to override the address lookup service with one compatible the Nominatim's API,\nchange the URL in the Django settings:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'leaflet': {\n\t ...\n\t 'addressLookupURL': 'https://my-nominatim.example.org/search',\n\t }\n\t ...\n\t}\n"
},
{
"path": "docs/source/link-plugin.rst",
"content": ".. _link-plugin:\n\n===========\nLink Plugin\n===========\n\n**djangocms-cascade** ships with its own link plugin. This is because other plugins from the\nCascade eco-system, such as the **BootstrapButtonPlugin**, the **BootstrapImagePlugin** or the\n**BootstrapPicturePlugin** also require a functionality in order to set links to internal- and\nexternal URLs. Since we do not want to duplicate the linking functionality for each of those\nplugins, it has been moved into its own mixin-classes. Therefore we will use the terminology\n**TextLinkPlugin** when referring to text-based links.\n\nThe de-facto plugin for links, djangocms-link_ can't be used as a base class for these plugins,\nhence an alternative implementation has been created within the Cascade framework. The link related\ndata is stored in a various fields in our main JSON field (named ``glossary``).\n\n\nPrerequisites\n=============\n\nBefore using this plugin, assure that ``'cmsplugin_cascade.link'`` is member of the list or\ntuple ``CMSPLUGIN_CASCADE_PLUGINS`` in the project's ``settings.py``.\n\n|simple-link-element|\n\n.. |simple-link-element| image:: _static/simple-link-element.png\n\nThe behavior of this Plugin is what you expect from a Link editor. The field **Link Content** is the\ntext displayed between the opening and closing ```` tag. If used in combination with\ndjangocms-text-ckeditor_ the field automatically is filled out.\n\nBy changing the **Link type**, the user can choose between different types of Links:\n\n * Internal Links pointing to another page inside the CMS.\n * External Links pointing to a valid Internet URL.\n * Files from **django-filer** to download.\n * Links pointing to a valid e-mail address.\n * Optionally any other linkable object, if another Django application extends the Link-Plugin (see\n below for details).\n\nThe optional field **Title** can be used to add a ``title=\"some value\"`` attribute to the\n```` element.\n\nWith **Link Target**, the user can specify, whether the linked content shall open in the current\nwindow or if the browser shall open a new window.\n\n\nLink Plugin with Sharable Fields\n================================\n\nIf your web-site contains many links pointing onto a few external URLs, you might want to refer to\nthem by a symbolic name, rather than having to reenter the URL repeatedly. With\n**djangocms-cascade** this can be achieved easily by declaring some of the plugin's fields as\n*sharable*.\n\nAssure that ``INSTALLED_APPS`` contains ``'cmsplugin_cascade.sharable'``, then redefine the\n**TextLinkPlugin** to have sharable fields in ``settings.py``:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'plugins_with_sharables':\n\t β¦\n\t 'TextLinkPlugin': ['link_type', 'ext_url'],\n\t β¦\n\t },\n\t ...\n\t}\n\nThis will change the Link Plugin's editor slightly. Note the extra field added to the bottom of the\nform.\n\n|sharable-link-element|\n\n.. |sharable-link-element| image:: _static/sharable-link-element.png\n\nThe URL for this link entity now is stored in a central entity. This feature is useful, if for\ninstance the URL of an external web page may change in the future. Then the administrator can change\nthat link in the administration area once, rather than having to go through all the pages and check\nif that link was used.\n\nTo retain the Link settings, click onto the checkbox *Remember these settings as: ...* and give it\na name of your choice. The next time your create a Shared Link element, you may select a previously\nnamed settings from the select field *Shared Settings*. Since these settings can be shared among\nother plugins, these input fields are disabled and can't be changed anymore.\n\n\nChanging shared settings\n------------------------\n\nThe settings of a shared plugin can be changed globally, for all plugins using them. To edit such a\nshared setting, in the Django Admin, go into the list view for\n**Home βΊ django CMS Cascade βΊ Shared between Plugins** and choose the named shared settings.\n\nPlease note, that each plugin type can specify which fields shall be sharable between plugins of\nthe same type. In this example, only the Link itself is shared, but one could configure\n**djangocms-cascade** to also share the link's ``title``, the ``target``, and other tags.\n\nThen only these fields are editable in the detail view **Shared between Plugins**. The interface\nfor other shared plugin may vary substantially, depending of their type definition.\n\n\nExtending the Link Plugin\n=========================\n\nWhile programming third party modules for Django, one might have to access a model instance through\na URL and thus add the method get_absolute_url_ to that Django model. Since such a URL is neither a\nCMS page, nor a URL to an external web page, it would be convenient to access that model using a\nspecial Link type.\n\nFor example, in django-shop_ we can allow to link directly to a product, sold by the shop.\nThis is achieved by reconfiguring the Link Plugin inside Cascade with:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t β¦\n\t 'link_plugin_classes': (\n\t 'shop.cascade.plugin_base.CatalogLinkPluginBase',\n\t 'shop.cascade.plugin_base.CatalogLinkForm',\n\t ),\n\t β¦\n\t}\n\nThe tuple specified through ``link_plugin_classes`` replaces the base class for the **LinkPlugin**\nclass and the form class used by its editor.\n\nHere we replace the two built-in classes :class:`cmsplugin_cascade.link.plugin_base.DefaultLinkPluginBase`\nand :class:`cmsplugin_cascade.link.forms.LinkForm` by alternative implementations.\n\n.. code-block:: python\n\t:caption: shop/cascade/plugin_base.py\n\n\tfrom entangled.forms import get_related_object\n\tfrom cmsplugin_cascade.link.plugin_base import LinkPluginBase\n\n\tclass CatalogLinkPluginBase(LinkPluginBase):\n\t @classmethod\n\t def get_link(cls, obj):\n\t link_type = obj.glossary.get('link_type')\n\t if link_type == 'product':\n\t relobj = get_related_object(obj.glossary, 'product')\n\t if relobj:\n\t return relobj.get_absolute_url()\n\t else:\n\t return super().get_link(obj) or link_type\n\nThis class handles links of type \"Product\" and creates a URL pointing onto a Django model implementing\nthe method ``get_absolute_url``.\n\nAdditionally, we have to override the form class used by the Link plugin editor:\n\n.. code-block:: python\n\t:caption: shop/cascade/plugin_base.py\n\n\tfrom cms.plugin_pool import plugin_pool\n\tfrom django.forms import models\n\tfrom shop.models.product import ProductModel\n\n\tclass CatalogLinkForm(LinkForm):\n\t LINK_TYPE_CHOICES = [\n\t ('cmspage', _(\"CMS Page\")),\n\t ('product', _(\"Product\")),\n\t ('download', _(\"Download File\")),\n\t ('exturl', _(\"External URL\")),\n\t ('email', _(\"Mail To\")),\n\t ]\n\n\t product = models.ModelChoiceField(\n\t label=_(\"Product\"),\n\t queryset=ProductModel.objects.all(),\n\t required=False,\n\t help_text=_(\"An internal link onto a product from the catalog\"),\n\t )\n\n\t class Meta:\n\t entangled_fields = {'glossary': ['product']}\n\nNow the select box for **Link type** will offer one additional option named \"Product\". When this is\nselected, the page administrator can select one product in the shop and the link will point onto\nits proper detail page.\n\n\nUsing Links in your own Plugins\n===============================\n\nMany HTML components allow to link onto other resources, for instance images, the button element,\nicons, etc. Since we don't want the reimplement the linking functionality for each of them,\n**djangocms-cascade** offers a few base classes, which can be used by those plugin. As an example,\nlet's implement a simple button plugin.\n\n.. code-block:: python\n\t:caption: myproject/cascade/button.py\n\n\tfrom django.forms import models\n\tfrom cms.plugin_pool import plugin_pool\n\tfrom cmsplugin_cascade.link.config import LinkPluginBase, LinkFormMixin\n\tfrom cmsplugin_cascade.link.plugin_base import LinkElementMixin\n\n\tclass ButtonForm(LinkFormMixin):\n\t require_link = False\n\n\t button_content = models.CharField(\n\t label=_(\"Button Content\"),\n\t )\n\n\t class Meta:\n\t entangled_fields = {'glossary': ['link_content']}\n\n\tclass ButtonPlugin(LinkPluginBase):\n\t name = _(\"Button\")\n\t model_mixins = (LinkElementMixin,)\n\t form = ButtonForm\n\t render_template = 'myproject/button.html'\n\t allow_children = False\n\n\tplugin_pool.register_plugin(ButtonPlugin)\n\nWhat we see here is, that our ``ButtonForm``, which is used by our ``ButtonPlugin`` inherits from\na base form offering all the fields required to link somewhere. Sine the button may just display\nsome content, but without linking anywhere, we make that optional by setting ``require_link`` to\n``False``. The box for selecting the \"Link Type\" then adds \"No Link\" to its set of options.\n\nWe don't even have to bother, whether our custom button can point onto links types specified by yet\nanother third party app, and not handled by **djangocms-cascade** β All these additional link types\nare handled automatically by the configuration setting ``CMSPLUGIN_CASCADE['link_plugin_classes']``\nas explained in the previous section.\n\n\n.. _djangocms-link: https://github.com/divio/djangocms-link\n.. _djangocms-text-ckeditor: https://github.com/divio/djangocms-text-ckeditor\n.. _get_absolute_url: https://docs.djangoproject.com/en/stable/ref/models/instances/#get-absolute-url\n.. _django-shop: https://github.com/awesto/django-shop\n"
},
{
"path": "docs/source/release-notes-1.rst",
"content": "# Release Notes for version 1.0\n\nApart from dropping support for Python-2.7, **djangocms-cascade** version 1.0 internally changes a lot.\nUntil version 0.19 it used a special widget :class:`cmsplugin_cascade.widgets.JSONMultiWidget` which\ntook care of converting the so named \"glossary fields\" into an editor, used to change the properties\nof all Cascade plugins.\n\nWhile this editor was able to handle all kinds of primitive data types, such as strings, numeric input,\nsimple- and multiple choices, it failed to handle references onto foreign keys and other data inputs,\nrequiring input validation and rectification. Therefore many Cascade plugins turned into kind of hybrids,\nusing a mixture of classic Django form fields plus one special \"glossary\" field, using the ``JSONMultiWidget``\nmentioned before.\n\nThis approach turned out to be impracticable, because input widgets rendered by the form fields could not\nbe mixed with fields rendered by the ``JSONMultiWidget``. It also was complicated from a point of understanding\nand other programmers had difficulties to implement their own plugins.\n\nTherefore in version 1.0, the list of \"glossary fields\" will be replaced against a slightly modified Django\n``ModelForm``. This form then reads and writes its data from the Django model field\n:class:`cmsplugin_cascade.models.CascadeElement.glossary`, just as it always did. This means that we still\nhave the advantage of using a JSON field to store arbitrary data, preventing us from having to create a Django\nmodel for each plugin in our database.\n\nThe code for reading and writing JSON data from and to this special Django model field (ie. ``glossary``),\nhas been moved out of **dangocms-cascade** and into a new Django app named\n[django-entangled](https://github.com/jrief/django-entangled). The reason for this code separation is greater\nreusability.\n"
},
{
"path": "docs/source/render-template.rst",
"content": "========================================\nChoose an alternative rendering template\n========================================\n\nSometimes you must render a plugin with a slightly different template, other than the given default.\nA possible solution is to create a new plugin, inheriting from the given one and overriding\nthe ``render_template`` attribute with a customized template. This however adds another plugin to\nthe list of registered CMS plugins.\n\nA simpler solution to solve this problem, is to allow a plugin to be rendered with a customized\ntemplate out of a set of alternatives.\n\n\nChange the path for template lookups\n====================================\n\nSome Bootstrap Plugins are shipped with templates, which are optimized to be rendered by Angular-UI_\nrather than the default jQuery. These alternative templates are located in the folder\n``cascade/bootstrap3/angular-ui``. If your project uses AngularJS instead of jQuery, then configure\nthe lookup path in ``settings.py`` with\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'bootstrap3': {\n\t ...\n\t 'template_basedir': 'angular-ui',\n\t },\n\t}\n\nThis lookup path is applied only to the Plugin's field ``render_template`` prepared for it. Such a\ntemplate contains the placeholder ``{}``, which is expanded to the configured ``template_basedir``.\n\nFor instance, the **CarouselPlugin** defines its ``render_template`` such as:\n\n.. code-block:: python\n\n\tclass CarouselPlugin(BootstrapPluginBase):\n\t ...\n\t render_template = 'cascade/bootstrap3/{}/carousel.html'\n\t ...\n\n.. _Angular-UI: http://angular-ui.github.io/bootstrap/versioned-docs/0.13.4/\n\n\nConfigure Cascade Plugins to be rendered using alternative templates\n====================================================================\n\nAll plugins which offer more than one rendering template, shall be added in the projects\n``settings.py`` to the dictionary ``CMSPLUGIN_CASCADE['plugins_with_extra_render_templates']``.\nEach item in this dictionary consists of a key, naming the plugin, and a value containing a list of\ntwo-tuples. The first element of this two-tuple must be the templates filename, while the second\nelement shall contain an arbitrary name to identify that template.\n\nExample:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'plugins_with_extra_render_templates': {\n\t 'TextLinkPlugin': (\n\t ('cascade/link/text-link.html', _(\"default\")),\n\t ('cascade/link/text-link-linebreak.html', _(\"with linebreak\")),\n\t )\n\t },\n\t ...\n\t}\n\n\nUsage\n-----\n\nWhen editing a **djangoCMS** plugins with alternative rendering templates, the plugin editor\nadds a select box containing choices for alternative rendering templates. Choose one other than the\ndefault, and the plugin will be rendered using that template.\n"
},
{
"path": "docs/source/section.rst",
"content": "=================\nSection Bookmarks\n=================\n\nIf you have a long page, and you want to allow the visitors of your site to quickly navigate to\ndifferent sections, then you can use bookmarks and create links to the different sections of any\nHTML page.\n\nWhen a user clicks on a bookmark link, then that page will load as usual but will scroll down\nimmediately, so that the bookmark is at the very top of the page. Bookmarks are also known as\nanchors. They can be added to any HTML element using the attribute ``id``. For example:\n\n.. code-block:: html\n\n\t\n\nFor obvious reasons, this identifier must be unambiguous, otherwise the browser does not know\nwhere to jump to. Therefore **djangocms-cascade** enforces the uniqueness of all bookmarks used on\neach CMS page.\n\n\nConfiguration\n=============\n\nThe HTML standard allows the usage of the ``id`` attribute on any element, but in practice it only\nmakes sense on ````, ```` and the heading elements ````...````.\nCascade by default is configured to allow bookmarks on the **SimpleWrapperPlugin** and the\n**HeadingPlugin**. This can be overridden in the project's configuration settings using:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'plugins_with_bookmark': [list-of-plugins],\n\t ...\n\t}\n\n\nHashbang Mode\n-------------\n\nLinks onto bookmarks do not work properly in hashbang mode. Depending on the HTML settings, you may\nhave to prefix them with ``/`` or ``!``. Therefore **djangocms-cascade** offers a configuration\ndirective:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'bookmark_prefix': '/',\n\t ...\n\t}\n\nwhich automatically prefixes the used bookmark.\n\n\nUsage\n=====\n\nWhen editing a plugin that is eligible for adding a bookmark, an extra input field is shown:\n\n|section-bookmark|\n\n.. |section-bookmark| image:: /_static/section-bookmark.png\n\nYou may add any identifier to this field, as long as it is unique on that page. Otherwise the\nplugin's editor will be reject the given inputs, while saving.\n\n\nHyperlinking to a Bookmark\n==========================\n\nWhen editing a **TextLink**, **BootstrapButton** or the link fields inside the **Image** or\n**Picture** plugins, the user gets an additional drop-down menu to choose one of the bookmarks for\nthe given page. This additional drop-down is only available if the **Link** is of type *CMS page*.\n\n|link-bookmark|\n\n.. |link-bookmark| image:: /_static/link-bookmark.png\n\nIf no bookmarks have been associated with the chosen CMS page, the drop-down menu displays only\n*Page root*, which is the default.\n"
},
{
"path": "docs/source/segmentation.rst",
"content": "=======================\nSegmentation of the DOM\n=======================\n\nThe **SegmentationPlugin** allows to personalize the DOM structure, depending on the context used to\nrender the corresponding page. Since **django-CMS** always uses a RequestContext_ while rendering\nits pages, we always have access onto the request object. Some use cases are:\n\n* Depending on the user, show a different portion of the DOM, if he is a certain user or not logged\n in at all.\n* Show different parts of the DOM, depending on the browsers estimated geolocation. Useful to\n render different content depending on the visitors country.\n* Show different parts of the DOM, depending on the supplied marketing channel.\n* Show different parts of the DOM, depending on the content in the session objects from previous\n visits of the users.\n* Segment visitors into different groups used for A/B-testing.\n\n\nConfiguration\n=============\n\nThe **SegmentationPlugin** must be activated separately on top of other **djangocms-cascade**\nplugins. In ``settings.py``, add to\n\n.. code-block:: python\n\n\tINSTALLED_APPS = (\n\t ...\n\t 'cmsplugin_cascade',\n\t 'cmsplugin_cascade.segmentation',\n\t ...\n\t)\n\nThen, depending on what kind of data shall be emulated, add a list of two-tuples to the\nconfiguration settings ``CMSPLUGIN_CASCADE['segmentation_mixins']``. The first entry of each\ntwo-tuple specifies the mixin class added the the proxy model for the ``SegmentationPlugin``. The\nsecond entry specifies the mixin class added the model admin class for the ``SegmentationPlugin``.\n\n.. code-block:: python\n\n\t# this entry is optional:\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'segmentation_mixins': (\n\t ('cmsplugin_cascade.segmentation.mixins.EmulateUserModelMixin', 'cmsplugin_cascade.segmentation.mixins.EmulateUserAdminMixin',), # the default\n\t # other segmentation plugin classes\n\t ),\n\t ...\n\t}\n\n\nUsage\n=====\n\nWhen editing **djangoCMS** plugins in **Structure** mode, below the section **Generic** a new plugin\ntype appears, named **Segment**.\n\n|segment-plugin|\n\n.. |segment-plugin| image:: _static/segment-plugin.png\n\nThis plugin now behaves as an ``if`` block, which is rendered only, if the specified condition\nevaluates to true. The syntax used to specify the condition, is the same as used in the Django\ntemplate language. Therefore it is possible to evaluate against more than one condition and combine\nthem with ``and``, ``or`` and ``not`` as described in `boolean operators`_ in the Django docs\n\nImmediately below a segmentation block using the condition tag ``if``, it is possible to use the\ntags ``elif`` or ``else``. This kind of conditional blocks is well known to Python programmers.\n\nNote, that when rendering pages in djangoCMS, a RequestContext_- rather than a Context-object is used.\nThis RequestContext is populated by the ``user`` object if ``'django.contrib.auth.context_processors.auth'``\nis added to your settings.py ``TEMPLATE_CONTEXT_PROCESSORS``. This therefore is a prerequisite\nwhen the Segmentation plugin evaluates conditions such as ``user.username == \"john\"``.\n\n.. _RequestContext: https://docs.djangoproject.com/en/1.8/ref/templates/api/#django.template.RequestContext\n.. _boolean operators: https://docs.djangoproject.com/en/dev/ref/templates/builtins/#boolean-operators\n.. _request object: https://docs.djangoproject.com/en/dev/ref/request-response/#httprequest-objects\n\n\nEmulating Users\n===============\n\nOnly staff users or administrators can emulate the currently logged in user. Staff-only users must\npossess the four permissions `cmsplugin_cascade.add_segmentation`,\n`cmsplugin_cascade.change_segmentation`, `cmsplugin_cascade.delete_segmentation` and\n`cmsplugin_cascade.view_segmentation`.\n\nIf this plugin is activated and the permissions are set, then in the CMS toolbar a new menu\ntag appears named βSegmentationβ. Here the currently logged in staff user can select another user.\nAll evaluation conditions then evaluate against this selected user, instead of the currently logged\nin user.\n\nIt is quite simple to add other overriding emulations. Have a look at the class\n``cmsplugin_cascade.segmentation.mixins.EmulateUserMixin``. This class then has to be added to\nyour configuration settings ``CMSPLUGIN_CASCADE_SEGMENTATION_MIXINS``. It then overrides the\nevaluation conditions and the toolbar menu.\n"
},
{
"path": "docs/source/sharable-fields.rst",
"content": ".. _sharable-fields:\n\n============================\nWorking with sharable fields\n============================\n\nSometime you'd want to remember sizes, links or any other options for rendering a plugin instance\nacross the project. In order to not have to do this job for each managed entity, you can remember\nthese settings using a name of your choice, controllable in a special section of the administration\nbackend.\n\nNow, whenever someone adds a new instance using this plugin, a select box with these remembered\nsettings appears. He then can choose from one of the remembered settings, which frees him to\nreenter all the values.\n\n\nConfigure a Cascade Plugins to optionally share some fields\n===========================================================\n\nConfiguring a plugin to share specific fields with other plugins of the same type is very easy.\nIn the projects ``settings.py``, assure that ``'cmsplugin_cascade.sharable'`` is part of your\n``INSTALLED_APPS``.\n\nThen add a dictionary of Cascade plugins, with a list of fields which shall be sharable. For\nexample, with this settings, the image plugin can be configured to share its sizes and rendering\noptions among each other.\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'plugins_with_sharables': {\n\t 'BootstrapImagePlugin': ['image-shapes', 'image-width-responsive', 'image-width-fixed', 'image-height', 'resize-options'],\n\t },\n\t ...\n\t}\n\n\nControl some named settings\n===========================\n\nWhenever a plugin is configured to allow to share fields, at the bottom of the plugin editor a\nspecial field appears:\n\n|remember-settings|\n\n.. |remember-settings| image:: /_static/remember-settings.png\n\nBy activating the checkbox, adding an arbitrary name next to it and saving the plugin, an entity\nof sharable fields is saved in the database. Now, whenever someone starts to edit a plugin of this\ntype, a select box appears on the top of the editor:\n\n|use-shared-settings|\n\n.. |use-shared-settings| image:: /_static/use-shared-settings.png\n\nBy choosing a previously named shared settings, the configured fields are disabled for input and\nreplaced by their shared field's counterparts.\n\nIn order to edit these shared fields in the administration backend, one must access\n**Home βΊ Cmsplugin_cascade βΊ Shared between Plugins**. By choosing a named shared setting, one can\nenter into the shared field's editor. This editor auto adopts to the fields declared as shared,\nhence will change from entity to entity. For the above example, it may look like this:\n\n|edit-shared-fields|\n\n.. |edit-shared-fields| image:: /_static/edit-shared-fields.png\n\nIn this editor one can change these shared settings globally, for all plugin instances where this\nnamed shared settings have been applied to.\n"
},
{
"path": "docs/source/sphinx.rst",
"content": "==============================\nIntegrate Sphinx Documentation\n==============================\n\nRestructured Text (ReST) is the de facto standard for documenting Python projects and is even widely\nused outside of this realm, by applications written in other languages. Sphinx_ is a compiler to\ngenerate HTML, Latex, PDF, e-books, etc. out of sources written in ReST.\n\nHTML rendered by Sphinx, typically is rendered as static content by the web server. This makes it\ndifficult to serve documentation, side by side with content from **django-CMS**, because these are\ncompletely different technologies. Furthermore, since Sphinx uses Jinja2 templates, but **django-CMS**'s\ninternal templatetags are not available for Jinja2, template sharing is not possible.\n\nTherefore **djangocms-cascade** offers an integration service, which makes it possible to integrate\ndocumentation generated by Sphinx, unintrusively inside the menu tree of **django-CMS**.\n\n\nConfiguration\n=============\n\nTo the project's ``settings.py``, add these options to the configuration directives:\n\n.. code-block:: python\n\n\tINSTALLED_APPS = [\n\t ...\n\t 'cmsplugin_cascade',\n\t 'cmsplugin_cascade.sphinx',\n\t ...\n\t]\n\n\tCMS_TEMPLATES = [\n\t ...\n\t ('path/to/documentation.html', \"Documentation Page\"),\n\t ...\n\t]\n\n\tSPHINX_DOCS_ROOT = '/path/to/docs/_build/fragments'\n\nReplace ``'/path/to/documentation.html'`` with a filename pointing to your documentation\nroot template (see below).\n\nPoint ``SPHINX_DOCS_ROOT`` onto the directory, into which the HTML page fragments are generated.\n\n\nConfigure Sphinx Builder\n------------------------\n\nLocate the file ``conf.py`` and add:\n\n.. code-block:: python\n\n\textensions = [\n\t ...\n\t 'cmsplugin_cascade.sphinx.fragmentsbuilder',\n\t]\n\nBy invoking ``make fragments``, Sphinx generates a HTML fragment for each page inside the\ndocumentation folder, typically into ``docs/build/fragments``. Later we use these fragments\nand include them using a normal Django view.\n\n\nIntegration with the CMS\n========================\n\nIn Django's admin backend, add a page as the starting point for the documentation inside\nthe CMS menu tree. Typically, one would name that page \"*Documentation*\" using ``docs`` or\n``documentation`` as its slug.\n\nIn the *Advanced Settings* tab, choose **Documentation Page** as the template. This settings\nhas been configured using the directive ``CMS_TEMPLATES``, as shown above.\n\nAs *Application*, select **Sphinx Documentation** from the pull down menu. This attaches the\ncomplete documentation tree just below the chosen slug.\n\nOptionally select **Documentation Menu** from the pull down menu as the *Attached menu*. It adds\na submenu for each main chapter of the documentation. If omitted, only **Documentation** is added\nthe the CMS menu tree.\n\n\nThe Documentation Template\n--------------------------\n\nYou must provide a template to be used by the documentation view. This template typically extends\na base CMS page template, providing a header, the navigation bar and the footer. In the block,\nresponsible for rendering the main content, add this template code:\n\n.. code-block:: django\n\n\t{% extends \"path/to/base.html\" %}\n\t{% load static cascade_tags %}\n\t...\n\t{% block head %}\n\t{{ block.super }}\n\t\n\t{% endblock %}\n\t...\n\t{% block main-content %}\n\t {% if page_content %}\n\t {{ page_content }}\n\t {% else %}\n\t {% sphinx_docs_include \"index.html\" %}\n\t {% endif %}\n\t{% endblock %}\n\nThis Django template now includes the HTML fragments compiled by Sphinx. This allows us to use\n**django-CMS** and combine it with Sphinx. In the URL, the part behind the documentation's slug\ncorresponds 1:1 to the name of the ReST document.\n\nIn this example we add a stylesheet to adopt the output to the `Bootstrap theme`_ for Sphinx_.\nDepending on your template layout, the way you import this may vary.\n\n.. _Sphinx: http://www.sphinx-doc.org/\n.. _Bootstrap theme: http://ryan-roemer.github.io/sphinx-bootstrap-theme/README.html\n\n\nLinking onto Documentation Pages\n--------------------------------\n\nBy overriding the :ref:`link-plugin` with a special target named **Documentation**, we can\neven add links onto our documentation pages symbolically. This means, that whenever we open the\n**LinkPlugin** editor, an additional target is added. It offers a select box showing all\npages from our documentation tree. This prevents us, having to hard code the URL pointing\nonto the documentation.\n\nThis feature has to be configured in the project's ``settings.py``, by replacing the LinkPlugin\nwith a modified version of itself:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'link_plugin_classes': [\n\t 'cmsplugin_cascade.sphinx.link_plugin.SphinxDocsLinkPlugin',\n\t 'cmsplugin_cascade.link.plugin_base.LinkElementMixin',\n\t 'cmsplugin_cascade.sphinx.link_plugin.SphinxDocsLinkForm',\n\t ],\n\t ...\n\t}\n"
},
{
"path": "docs/source/strides.rst",
"content": ".. _strides:\n\n==============================\nUse Cascade outside of the CMS\n==============================\n\nOne of the most legitimate points **djangocms-cascade** can be criticised for, is the lack of\nstatic content rendering. Specially in projects, where we want to work with static pages instead\nof CMS pages, one might fall back to handcrafting HTML, giving up all the benefits of rapid\nprototyping as provided by the Cascade plugin system.\n\nSince version 0.14 of **djangocms-cascade**, one can prototype the page content and export it as\nJSON file using :ref:`clipboard`. Later on, one can reuse that persisted data and create the same\ncontent outside of a CMS page. This is specially useful, if you must persist the page content\nin the project's version control system.\n\n\nUsage\n=====\n\nAfter the placeholder of a CMS page, is filled up with plugins from **djangocms-cascade**,\nswitch into *Structure Mode*, go to the context menu of that placeholder and click *Copy all*.\n\nNext, inside Django's administration backend, go to\n\n\tHome βΊ Django CMS Cascade βΊ Persited Clipboard Content\n\nand click onto *Add Persisted Clipboard Content*. The *Data* field will now be filled with a\ncascade of plugins serialized as JSON data. Copy that data and paste it into a file locatable\nby Django's static file finders, for example ``myproject/static/myapp/cascades/slug.json``.\n\n\nIn Templates\n============\n\nCreate a Django template, where instead of adding a Django-CMS placeholder, use the templatetag\n``render_cascade``. Example:\n\n.. code-block:: Django\n\n\t{% load cascade_tags %}\n\n\t{% render_cascade \"myapp/cascades/slug.json\" %}\n\nThis templatetag now renders the content just as if it would be rendered by the CMS. This means\nthat changing the template of a **djangocms-cascade** plugin, immediately has effect on the rendered\noutput. This is so to say **Model View Control**, where the Model is the content peristed as JSON,\nand the View is the template provided by the plugin. It separates the composition of HTML components\nfrom their actual representation, allowing a much better division of work during the page creation.\n\n\nCaveats when creating your own Plugins\n======================================\n\nWhen developing your own plugins, consider the following precautions:\n\n\nInvoking ``super``\n------------------\n\nInstead of invoking ``super(MyPlugin, self).some_method()`` use\n``self.super(MyPlugin, self).some_method()``. This is required because **djangocms-cascade**\ncreates a list of \"shadow\" plugins, which do not inherit from ``CMSPluginBase``.\n\n\nTemplatetag ``render_plugin``\n-----------------------------\n\nDjango-CMS provides a templatetag ``render_plugin``. Don't use it in templates provided by\n**djangocms-cascade** plugins. Instead use the templatetag named ``render_plugin`` from\nCascade. Example:\n\n.. code-block:: Django\n\n\t{% load cascade_tags %}\n\t\n\t{% for plugin in instance.child_plugin_instances %}\n\t {% render_plugin plugin %}\n\t{% endfor %}\n\t\n\n\nCaching\n=======\n\nEven though rendering using this templatetag is slightly faster than the classic ``placeholder``\ntag provided by the CMS (because we don't hit the database for each plugin instance), combining\neach plugin template with its context also takes its time. Therefore plugins rendered by\n``render_cascade``, by default are cached as well, just as their CMS counterparts.\n\nThis caching is disabled for plugins containing the attribute ``cache = False``. It can be turned\noff globally using the directive ``CMSPLUGIN_CASCADE['cache_strides'] = True`` in the project's\n``settings.py``.\n"
},
{
"path": "examples/bs4demo/.coveragerc",
"content": "[run]\nbranch = True\nsource =\n cmsplugin_cascade\n[report]\nprecision = 2\nomit =\n ../*migrations*\n gs960 \n"
},
{
"path": "examples/bs4demo/bs4demo/__init__.py",
"content": "# -*- coding: utf-8 -*-\n"
},
{
"path": "examples/bs4demo/bs4demo/cms_plugins.py",
"content": "# -*- coding: utf-8 -*-\nfrom __future__ import unicode_literals\n\nfrom django.forms import widgets\nfrom django.utils.translation import ugettext_lazy as _\n\nfrom cms.plugin_pool import plugin_pool\nfrom cmsplugin_cascade.fields import GlossaryField\nfrom cmsplugin_cascade.plugin_base import CascadePluginBase\n\n\nclass Badge(CascadePluginBase):\n \"\"\"\n This is a simple example of a plugin suitable for the djangocms-cascade system.\n It contains one single field: `content` rendered via the template `bs4demo/badge.html`.\n \"\"\"\n name = _(\"Badge\")\n require_parent = False\n allow_children = False\n render_template = 'bs4demo/badge.html'\n\n content = GlossaryField(\n widgets.TextInput(),\n label=_(\"Content\"),\n )\n\nplugin_pool.register_plugin(Badge)\n"
},
{
"path": "examples/bs4demo/bs4demo/context_processors.py",
"content": "# -*- coding: utf-8 -*-\nfrom django.conf import settings\n\n\ndef cascade(request):\n \"\"\"\n Adds additional context variables to the default context.\n \"\"\"\n context = {\n 'DJANGO_CLIENT_FRAMEWORK': settings.CMSPLUGIN_CASCADE['bootstrap4'].get('template_basedir'),\n }\n return context\n"
},
{
"path": "examples/bs4demo/bs4demo/models.py",
"content": "# -*- coding: utf-8 -*-\n"
},
{
"path": "examples/bs4demo/bs4demo/settings.py",
"content": "# Django settings for unit test project.\nfrom __future__ import unicode_literals\n\nimport os\nimport sys\n\nfrom django.urls import reverse_lazy\n\nfrom cmsplugin_cascade.extra_fields.config import PluginExtraFieldsConfig\nfrom django.utils.text import format_lazy\n\nDEBUG = True\n\nBASE_DIR = os.path.dirname(__file__)\n\n# Root directory for this Django project\nPROJECT_ROOT = os.path.abspath(os.path.join(BASE_DIR, os.path.pardir))\n\n# Directory where working files, such as media and databases are kept\nWORK_DIR = os.path.join(PROJECT_ROOT, 'workdir')\nif not os.path.isdir(WORK_DIR):\n os.makedirs(WORK_DIR)\n\nSITE_ID = 1\n\nROOT_URLCONF = 'bs4demo.urls'\n\nSECRET_KEY = 'secret'\n\nDATABASES = {\n 'default': {\n 'ENGINE': 'django.db.backends.sqlite3',\n 'NAME': os.path.join(WORK_DIR, 'db.sqlite3'),\n },\n}\n\nINSTALLED_APPS = [\n 'django.contrib.auth',\n 'django.contrib.contenttypes',\n 'django.contrib.sessions',\n 'django.contrib.sites',\n 'django.contrib.messages',\n 'django.contrib.admin',\n 'django.contrib.staticfiles',\n 'django.contrib.sitemaps',\n #'reversion',\n 'djangocms_text_ckeditor',\n 'django_select2',\n 'cmsplugin_cascade',\n 'cmsplugin_cascade.clipboard',\n 'cmsplugin_cascade.extra_fields',\n 'cmsplugin_cascade.icon',\n 'cmsplugin_cascade.sharable',\n 'cmsplugin_cascade.segmentation',\n 'cms',\n 'cms_bootstrap',\n 'adminsortable2',\n 'menus',\n 'treebeard',\n 'filer',\n 'easy_thumbnails',\n 'sass_processor',\n 'sekizai',\n 'bs4demo',\n]\n\nMIDDLEWARE = [\n 'django.middleware.security.SecurityMiddleware',\n 'django.contrib.sessions.middleware.SessionMiddleware',\n 'django.middleware.common.CommonMiddleware',\n 'django.middleware.csrf.CsrfViewMiddleware',\n 'django.contrib.auth.middleware.AuthenticationMiddleware',\n 'django.contrib.messages.middleware.MessageMiddleware',\n 'django.middleware.clickjacking.XFrameOptionsMiddleware',\n 'django.middleware.locale.LocaleMiddleware',\n 'django.middleware.gzip.GZipMiddleware',\n 'cms.middleware.page.CurrentPageMiddleware',\n 'cms.middleware.user.CurrentUserMiddleware',\n 'cms.middleware.toolbar.ToolbarMiddleware',\n 'cms.middleware.language.LanguageCookieMiddleware',\n]\n\n# silence false-positive warning 1_6.W001\n# https://docs.djangoproject.com/en/1.8/ref/checks/#backwards-compatibility\n#TEST_RUNNER = 'django.test.runner.DiscoverRunner'\n\n# Absolute path to the directory that holds media.\n# Example: \"/home/media/media.lawrence.com/\"\nMEDIA_ROOT = os.path.join(WORK_DIR, 'media')\n\n# URL that handles the media served from MEDIA_ROOT. Make sure to use a\n# trailing slash.\n# Examples: \"http://media.lawrence.com/media/\", \"http://example.com/media/\"\nMEDIA_URL = '/media/'\n\n# Absolute path to the directory that holds static files.\n# Example: \"/home/media/media.lawrence.com/static/\"\nSTATIC_ROOT = os.path.join(WORK_DIR, 'static')\n\n# URL that handles the static files served from STATIC_ROOT.\n# Example: \"http://media.lawrence.com/static/\"\nSTATIC_URL = '/static/'\n\nSTATICFILES_FINDERS = [\n 'django.contrib.staticfiles.finders.FileSystemFinder',\n 'django.contrib.staticfiles.finders.AppDirectoriesFinder',\n 'sass_processor.finders.CssFinder',\n]\n\nSTATICFILES_DIRS = [\n ('node_modules', os.path.join(PROJECT_ROOT, 'node_modules')),\n]\n\nTEMPLATES = [{\n 'BACKEND': 'django.template.backends.django.DjangoTemplates',\n 'APP_DIRS': True,\n 'OPTIONS': {\n 'context_processors': (\n 'django.contrib.auth.context_processors.auth',\n 'django.template.context_processors.debug',\n 'django.template.context_processors.i18n',\n 'django.template.context_processors.media',\n 'django.template.context_processors.static',\n 'django.template.context_processors.tz',\n 'django.template.context_processors.csrf',\n 'django.template.context_processors.request',\n 'django.contrib.messages.context_processors.messages',\n 'sekizai.context_processors.sekizai',\n 'cms.context_processors.cms_settings',\n 'bs4demo.context_processors.cascade',\n ),\n },\n}]\n\n# If you set this to False, Django will make some optimizations so as not\n# to load the internationalization machinery.\nUSE_I18N = True\n\n# If you set this to False, Django will not format dates, numbers and\n# calendars according to the current locale.\nUSE_L10N = True\n\n# If you set this to False, Django will not use timezone-aware datetimes.\nUSE_TZ = True\n\nLANGUAGE_CODE = 'en'\n\nLANGUAGES = (\n ('en', 'English'),\n)\n\nLOGGING = {\n 'version': 1,\n 'disable_existing_loggers': True,\n 'filters': {\n 'require_debug_false': {\n '()': 'django.utils.log.RequireDebugFalse',\n }\n },\n 'formatters': {\n 'simple': {\n 'format': '[%(asctime)s %(module)s] %(levelname)s: %(message)s'\n },\n },\n 'handlers': {\n 'console': {\n 'level': 'INFO',\n 'class': 'logging.StreamHandler',\n 'formatter': 'simple',\n },\n },\n 'loggers': {\n 'django': {\n 'handlers': ['console'],\n 'level': 'INFO',\n 'propagate': True,\n },\n },\n}\n\nX_FRAME_OPTIONS = 'SAMEORIGIN'\n\nXS_SHARING_ALLOWED_METHODS = ['POST', 'GET', 'OPTIONS', 'PUT', 'DELETE']\n\n#############################################################\n# Application specific settings\n\nif sys.argv[1] == 'test':\n CMS_TEMPLATES = (\n ('testing.html', \"Default Page\"),\n )\nelse:\n CMS_TEMPLATES = (\n ('bs4demo/main.html', \"Main Content\"),\n ('bs4demo/wrapped.html', \"Wrapped Bootstrap Column\"),\n )\n\nCMS_SEO_FIELDS = True\n\nCMS_CACHE_DURATIONS = {\n 'content': 3600,\n 'menus': 3600,\n 'permissions': 86400,\n}\n\nCMSPLUGIN_CASCADE_PLUGINS = (\n 'cmsplugin_cascade.segmentation',\n 'cmsplugin_cascade.generic',\n 'cmsplugin_cascade.leaflet',\n 'cmsplugin_cascade.link',\n 'cmsplugin_cascade.bootstrap4',\n 'bs4demo',\n)\n\nCMSPLUGIN_CASCADE = {\n 'alien_plugins': ('TextPlugin', 'TextLinkPlugin',),\n 'plugins_with_sharables': {\n 'BootstrapImagePlugin': ('image_shapes', 'image_width_responsive', 'image_width_fixed',\n 'image_height', 'resize_options',),\n 'BootstrapPicturePlugin': ('image_shapes', 'responsive_heights', 'image_size', 'resize_options',),\n },\n 'exclude_hiding_plugin': ('SegmentPlugin', 'Badge'),\n 'allow_plugin_hiding': True,\n 'leaflet': {'default_position': {'lat': 50.0, 'lng': 12.0, 'zoom': 6}},\n 'cache_strides': True,\n}\n\nCMS_PLACEHOLDER_CONF = {\n # this placeholder is used in templates/main.html, it shows how to\n # scaffold a djangoCMS page starting with an empty placeholder\n 'Main Content': {\n 'plugins': ['BootstrapContainerPlugin', 'BootstrapJumbotronPlugin'],\n 'parent_classes': {'BootstrapContainerPlugin': None, 'BootstrapJumbotronPlugin': None},\n },\n # this placeholder is used in templates/wrapped.html, it shows how to\n # add content to an existing Bootstrap column\n 'Bootstrap Column': {\n 'plugins': ['BootstrapRowPlugin', 'TextPlugin', ],\n 'parent_classes': {'BootstrapRowPlugin': None},\n 'require_parent': False,\n },\n}\n\nCKEDITOR_SETTINGS = {\n 'language': '{{ language }}',\n 'skin': 'moono-lisa',\n 'toolbar': 'CMS',\n 'stylesSet': format_lazy('default:{}', reverse_lazy('admin:cascade_texteditor_config')),\n}\n\nSELECT2_CSS = 'node_modules/select2/dist/css/select2.min.css'\nSELECT2_JS = 'node_modules/select2/dist/js/select2.min.js'\n\nFILER_ALLOW_REGULAR_USERS_TO_ADD_ROOT_FOLDERS = True\n\nFILER_DUMP_PAYLOAD = True\n\nTHUMBNAIL_PROCESSORS = (\n 'easy_thumbnails.processors.colorspace',\n 'easy_thumbnails.processors.autocrop',\n 'filer.thumbnail_processors.scale_and_crop_with_subject_location',\n 'easy_thumbnails.processors.filters',\n)\n\nTHUMBNAIL_HIGH_RESOLUTION = False\n\nTHUMBNAIL_PRESERVE_EXTENSIONS = True\n\nTHUMBNAIL_OPTIMIZE_COMMAND = {\n 'png': '/opt/local/bin/optipng {filename}',\n 'gif': '/opt/local/bin/optipng {filename}',\n 'jpeg': '/opt/local/bin/jpegoptim {filename}',\n}\n\nSASS_PROCESSOR_INCLUDE_DIRS = [\n os.path.join(PROJECT_ROOT, 'node_modules'),\n]\n\nSASS_PROCESSOR_ROOT = STATIC_ROOT\n\n# to access files such as fonts via staticfiles finders\nNODE_MODULES_URL = STATIC_URL + 'node_modules/'\n\ntry:\n from .private_settings import *\nexcept ImportError:\n pass\n\n"
},
{
"path": "examples/bs4demo/bs4demo/static/bs4demo/cascades/strides.json",
"content": "{\n \"plugins\":[\n [\n \"BootstrapJumbotronPlugin\",\n {\n \"glossary\":{\n \"background_width_height\":{\n \"width\":\"\",\n \"height\":\"\"\n },\n \"background_vertical_position\":\"center\",\n \"media_queries\":{\n \"xs\":[\n \"(max-width: 768px)\"\n ],\n \"lg\":[\n \"(min-width: 1200px)\"\n ],\n \"sm\":[\n \"(min-width: 768px)\",\n \"(max-width: 992px)\"\n ],\n \"md\":[\n \"(min-width: 992px)\",\n \"(max-width: 1200px)\"\n ]\n },\n \"background_attachment\":\"scroll\",\n \"image\":{\n \"pk\":5,\n \"model\":\"filer.Image\"\n },\n \"background_repeat\":\"no-repeat\",\n \"hide_plugin\":\"\",\n \"fluid\":true,\n \"container_max_heights\":{\n \"xs\":\"100%\",\n \"md\":\"100%\",\n \"sm\":\"100%\",\n \"lg\":\"100%\"\n },\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"500px\",\n \"padding-bottom\":\"\"\n },\n \"background_size\":\"cover\",\n \"resize_options\":[\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"container_max_widths\":{\n \"xs\":768,\n \"lg\":1980,\n \"sm\":992,\n \"md\":1200\n },\n \"breakpoints\":[\n \"xs\",\n \"sm\",\n \"md\",\n \"lg\"\n ],\n \"background_color\":[\n \"\",\n \"#12308b\"\n ],\n \"background_horizontal_position\":\"center\"\n },\n \"pk\":900\n },\n [\n [\n \"TextPlugin\",\n {\n \"body\":\"Django-CMS Cascade
\",\n \"pk\":901\n },\n []\n ]\n ]\n ],\n [\n \"BootstrapContainerPlugin\",\n {\n \"glossary\":{\n \"media_queries\":{\n \"xs\":[\n \"(max-width: 768px)\"\n ],\n \"lg\":[\n \"(min-width: 1200px)\"\n ],\n \"sm\":[\n \"(min-width: 768px)\",\n \"(max-width: 992px)\"\n ],\n \"md\":[\n \"(min-width: 992px)\",\n \"(max-width: 1200px)\"\n ]\n },\n \"container_max_widths\":{\n \"xs\":750,\n \"lg\":1170,\n \"sm\":750,\n \"md\":970\n },\n \"breakpoints\":[\n \"xs\",\n \"sm\",\n \"md\",\n \"lg\"\n ],\n \"hide_plugin\":\"\",\n \"fluid\":\"\"\n },\n \"pk\":902\n },\n [\n [\n \"HeadingPlugin\",\n {\n \"glossary\":{\n \"content\":\"Cascade Demo Page\",\n \"element_id\":\"heading-1\",\n \"tag_type\":\"h1\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Margins\":{\n \"margin-right\":\"\",\n \"margin-top\":\"\",\n \"margin-left\":\"\",\n \"margin-bottom\":\"\"\n }\n },\n \"pk\":936\n },\n []\n ],\n [\n \"BootstrapRowPlugin\",\n {\n \"glossary\":{\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Margins\":{\n \"margin-top\":\"\",\n \"margin-bottom\":\"\"\n }\n },\n \"pk\":903\n },\n [\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"md-column-offset\":\"\",\n \"sm-column-width\":\"\",\n \"md-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-width\":\"col-md-6\",\n \"hide_plugin\":\"\",\n \"sm-column-ordering\":\"\",\n \"sm-column-offset\":\"\",\n \"lg-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"xs-column-ordering\":\"\",\n \"xs-column-width\":\"col-xs-12\",\n \"lg-responsive-utils\":\"\",\n \"container_max_widths\":{\n \"xs\":720.0,\n \"lg\":555.0,\n \"sm\":720.0,\n \"md\":455.0\n },\n \"lg-column-width\":\"\",\n \"md-column-ordering\":\"\"\n },\n \"pk\":904\n },\n [\n [\n \"SimpleWrapperPlugin\",\n {\n \"glossary\":{\n \"extra_inline_styles:line-height\":\"2\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"367px\"\n },\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"15px\"\n },\n \"element_id\":\"\",\n \"extra_inline_styles:color\":[\n \"\",\n \"#474747\"\n ],\n \"extra_css_classes\":[],\n \"tag_type\":\"div\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#ffffff\"\n ],\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"20px\",\n \"padding-right\":\"50px\",\n \"padding-bottom\":\"20px\",\n \"padding-left\":\"50px\"\n }\n },\n \"pk\":905\n },\n [\n [\n \"TextPlugin\",\n {\n \"body\":\"What we do?
\\n\\nLorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla vitae elit libero, a pharetra augue. Curabitur blandit tempus porttitor. Donec id elit non mi porta gravida at eget metus. Vestibulum id ligula porta felis euismod semper. Aenean lacinia bibendum nulla sed consectetur. Maecenas faucibus mollis interdum. Cras mattis consectetur purus sit amet fermentum. Nullam id dolor id nibh ultricies vehicula ut id elit.
\",\n \"pk\":906\n },\n []\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"md-column-offset\":\"\",\n \"sm-column-width\":\"\",\n \"md-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-width\":\"col-md-6\",\n \"hide_plugin\":\"\",\n \"sm-column-ordering\":\"\",\n \"sm-column-offset\":\"\",\n \"lg-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"xs-column-ordering\":\"\",\n \"xs-column-width\":\"col-xs-12\",\n \"lg-responsive-utils\":\"\",\n \"extra_css_classes\":[],\n \"container_max_widths\":{\n \"xs\":720.0,\n \"lg\":555.0,\n \"sm\":720.0,\n \"md\":455.0\n },\n \"lg-column-width\":\"\",\n \"md-column-ordering\":\"\"\n },\n \"pk\":907\n },\n [\n [\n \"BootstrapImagePlugin\",\n {\n \"glossary\":{\n \"image_width_responsive\":\"100%\",\n \"target\":\"\",\n \"title\":\"\",\n \"image\":{\n \"pk\":11,\n \"model\":\"filer.Image\"\n },\n \"alt_tag\":\"\",\n \"hide_plugin\":\"\",\n \"image_width_fixed\":\"\",\n \"image_height\":\"\",\n \"link\":{\n \"type\":\"none\"\n },\n \"resize_options\":[\n \"upscale\",\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"image_title\":\"\",\n \"image_shapes\":[\n \"img-responsive\"\n ]\n },\n \"pk\":908\n },\n []\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapRowPlugin\",\n {\n \"glossary\":{\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Margins\":{\n \"margin-top\":\"20px\",\n \"margin-bottom\":\"\"\n }\n },\n \"pk\":909\n },\n [\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"md-column-offset\":\"\",\n \"extra_inline_styles:line-height\":\"\",\n \"sm-column-offset\":\"\",\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"\",\n \"padding-right\":\"\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"\"\n },\n \"xs-column-width\":\"col-xs-4\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#42c8c6\"\n ],\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"sm-column-width\":\"\",\n \"md-responsive-utils\":\"\",\n \"lg-column-ordering\":\"\",\n \"sm-column-ordering\":\"\",\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"\"\n },\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"container_max_widths\":{\n \"xs\":220.0,\n \"lg\":360.0,\n \"sm\":220.0,\n \"md\":293.33\n },\n \"md-column-width\":\"\",\n \"xs-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"360px\"\n },\n \"extra_css_classes\":[],\n \"lg-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-ordering\":\"\",\n \"lg-column-width\":\"\"\n },\n \"pk\":910\n },\n [\n [\n \"SimpleWrapperPlugin\",\n {\n \"glossary\":{\n \"extra_inline_styles:line-height\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"360px\"\n },\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"\"\n },\n \"element_id\":\"\",\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"extra_css_classes\":[],\n \"tag_type\":\"div\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#42c8c6\"\n ],\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"\",\n \"padding-right\":\"50px\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"50px\"\n }\n },\n \"pk\":911\n },\n [\n [\n \"FramedIconPlugin\",\n {\n \"glossary\":{\n \"font_size\":\"10em\",\n \"color\":[\n \"\",\n \"#ffffff\"\n ],\n \"background_color\":[\n \"disabled\",\n \"#ffffff\"\n ],\n \"symbol\":\"wrench\",\n \"hide_plugin\":\"\",\n \"text_align\":\"text-center\",\n \"icon_font\":\"3\",\n \"border_radius\":\"\",\n \"border\":[\n \"0px\",\n \"none\",\n \"#000000\"\n ]\n },\n \"pk\":912\n },\n []\n ],\n [\n \"TextPlugin\",\n {\n \"body\":\"Quick Installs
\\n\\nLorem ipsum dolor sit amet conse ctetur adipisicing elit, sed do eiusmod tempor incididunt ut labore.
\",\n \"pk\":913\n },\n []\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"md-column-offset\":\"\",\n \"extra_inline_styles:line-height\":\"\",\n \"sm-column-offset\":\"\",\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"\",\n \"padding-right\":\"\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"\"\n },\n \"xs-column-width\":\"col-xs-4\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#f5b10e\"\n ],\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"sm-column-width\":\"\",\n \"md-responsive-utils\":\"\",\n \"lg-column-ordering\":\"\",\n \"sm-column-ordering\":\"\",\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"\"\n },\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"container_max_widths\":{\n \"xs\":220.0,\n \"lg\":360.0,\n \"sm\":220.0,\n \"md\":293.33\n },\n \"md-column-width\":\"\",\n \"xs-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"360px\"\n },\n \"extra_css_classes\":[],\n \"lg-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-ordering\":\"\",\n \"lg-column-width\":\"\"\n },\n \"pk\":918\n },\n [\n [\n \"SimpleWrapperPlugin\",\n {\n \"glossary\":{\n \"extra_inline_styles:line-height\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"360px\"\n },\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"\"\n },\n \"element_id\":\"\",\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"extra_css_classes\":[],\n \"tag_type\":\"div\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#f5b10e\"\n ],\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"\",\n \"padding-right\":\"50px\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"50px\"\n }\n },\n \"pk\":919\n },\n [\n [\n \"FramedIconPlugin\",\n {\n \"glossary\":{\n \"font_size\":\"10em\",\n \"color\":[\n \"\",\n \"#ffffff\"\n ],\n \"background_color\":[\n \"disabled\",\n \"#ffffff\"\n ],\n \"symbol\":\"cog-alt\",\n \"hide_plugin\":\"\",\n \"text_align\":\"text-center\",\n \"icon_font\":\"3\",\n \"border_radius\":\"\",\n \"border\":[\n \"0px\",\n \"none\",\n \"#000000\"\n ]\n },\n \"pk\":920\n },\n []\n ],\n [\n \"TextPlugin\",\n {\n \"body\":\"Customizable
\\n\\nLorem ipsum dolor sit amet conse ctetur adipisicing elit, sed do eiusmod tempor incididunt ut labore.
\",\n \"pk\":921\n },\n []\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"md-column-offset\":\"\",\n \"extra_inline_styles:line-height\":\"\",\n \"sm-column-offset\":\"\",\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"\",\n \"padding-right\":\"\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"\"\n },\n \"xs-column-width\":\"col-xs-4\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#56ba41\"\n ],\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"sm-column-width\":\"\",\n \"md-responsive-utils\":\"\",\n \"lg-column-ordering\":\"\",\n \"sm-column-ordering\":\"\",\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"\"\n },\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"container_max_widths\":{\n \"xs\":220.0,\n \"lg\":360.0,\n \"sm\":220.0,\n \"md\":293.33\n },\n \"md-column-width\":\"\",\n \"xs-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"360px\"\n },\n \"extra_css_classes\":[],\n \"lg-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-ordering\":\"\",\n \"lg-column-width\":\"\"\n },\n \"pk\":914\n },\n [\n [\n \"SimpleWrapperPlugin\",\n {\n \"glossary\":{\n \"extra_inline_styles:line-height\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"360px\"\n },\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"\"\n },\n \"element_id\":\"\",\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"extra_css_classes\":[],\n \"tag_type\":\"div\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#56ba41\"\n ],\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"\",\n \"padding-right\":\"50px\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"50px\"\n }\n },\n \"pk\":915\n },\n [\n [\n \"FramedIconPlugin\",\n {\n \"glossary\":{\n \"font_size\":\"10em\",\n \"color\":[\n \"\",\n \"#ffffff\"\n ],\n \"background_color\":[\n \"disabled\",\n \"#ffffff\"\n ],\n \"symbol\":\"bell-alt\",\n \"hide_plugin\":\"\",\n \"text_align\":\"text-center\",\n \"icon_font\":\"3\",\n \"border_radius\":\"\",\n \"border\":[\n \"0px\",\n \"none\",\n \"#000000\"\n ]\n },\n \"pk\":916\n },\n []\n ],\n [\n \"TextPlugin\",\n {\n \"body\":\"Support
\\n\\nLorem ipsum dolor sit amet conse ctetur adipisicing elit, sed do eiusmod tempor incididunt ut labore.
\",\n \"pk\":917\n },\n []\n ]\n ]\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapRowPlugin\",\n {\n \"glossary\":{\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Margins\":{\n \"margin-top\":\"20px\",\n \"margin-bottom\":\"\"\n }\n },\n \"pk\":929\n },\n [\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"container_max_widths\":{\n \"xs\":720.0,\n \"lg\":1140.0,\n \"sm\":720.0,\n \"md\":940.0\n },\n \"xs-column-width\":\"col-xs-12\"\n },\n \"pk\":930\n },\n [\n [\n \"CarouselPlugin\",\n {\n \"glossary\":{\n \"resize_options\":[\n \"upscale\",\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"container_max_heights\":{\n \"xs\":\"200px\",\n \"md\":\"300px\",\n \"sm\":\"250px\",\n \"lg\":\"350px\"\n },\n \"interval\":\"5\",\n \"hide_plugin\":\"\",\n \"options\":[\n \"slide\",\n \"pause\",\n \"wrap\"\n ]\n },\n \"pk\":931\n },\n [\n [\n \"CarouselSlidePlugin\",\n {\n \"glossary\":{\n \"resize_options\":[\n \"upscale\",\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"image\":{\n \"pk\":4,\n \"model\":\"filer.Image\"\n },\n \"image_title\":\"\",\n \"hide_plugin\":\"\",\n \"alt_tag\":\"\"\n },\n \"pk\":932\n },\n [\n [\n \"TextPlugin\",\n {\n \"body\":\"Hallo Welt!
\",\n \"pk\":933\n },\n []\n ]\n ]\n ],\n [\n \"CarouselSlidePlugin\",\n {\n \"glossary\":{\n \"resize_options\":[\n \"upscale\",\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"image\":{\n \"pk\":7,\n \"model\":\"filer.Image\"\n },\n \"image_title\":\"\",\n \"hide_plugin\":\"\",\n \"alt_tag\":\"\"\n },\n \"pk\":934\n },\n []\n ],\n [\n \"CarouselSlidePlugin\",\n {\n \"glossary\":{\n \"resize_options\":[\n \"upscale\",\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"image\":{\n \"pk\":6,\n \"model\":\"filer.Image\"\n },\n \"image_title\":\"\",\n \"hide_plugin\":\"\",\n \"alt_tag\":\"\"\n },\n \"pk\":935\n },\n []\n ]\n ]\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapRowPlugin\",\n {\n \"glossary\":{\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Margins\":{\n \"margin-top\":\"20px\",\n \"margin-bottom\":\"20px\"\n }\n },\n \"pk\":922\n },\n [\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"md-column-offset\":\"\",\n \"sm-column-width\":\"col-sm-6\",\n \"md-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-width\":\"\",\n \"hide_plugin\":\"\",\n \"sm-column-ordering\":\"\",\n \"sm-column-offset\":\"\",\n \"lg-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"xs-column-ordering\":\"\",\n \"xs-column-width\":\"col-xs-12\",\n \"lg-responsive-utils\":\"\",\n \"container_max_widths\":{\n \"xs\":720.0,\n \"lg\":555.0,\n \"sm\":345.0,\n \"md\":455.0\n },\n \"lg-column-width\":\"\",\n \"md-column-ordering\":\"\"\n },\n \"pk\":923\n },\n [\n [\n \"BootstrapImagePlugin\",\n {\n \"glossary\":{\n \"image_width_responsive\":\"100%\",\n \"target\":\"\",\n \"title\":\"\",\n \"image\":{\n \"pk\":12,\n \"model\":\"filer.Image\"\n },\n \"alt_tag\":\"\",\n \"hide_plugin\":\"\",\n \"image_width_fixed\":\"\",\n \"image_height\":\"\",\n \"link\":{\n \"type\":\"none\"\n },\n \"resize_options\":[\n \"upscale\",\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"image_title\":\"\",\n \"image_shapes\":[\n \"img-responsive\"\n ]\n },\n \"pk\":924\n },\n []\n ]\n ]\n ],\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"md-column-offset\":\"\",\n \"sm-column-width\":\"col-sm-6\",\n \"md-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-width\":\"\",\n \"hide_plugin\":\"\",\n \"sm-column-ordering\":\"\",\n \"sm-column-offset\":\"\",\n \"lg-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"xs-column-ordering\":\"\",\n \"xs-column-width\":\"col-xs-12\",\n \"lg-responsive-utils\":\"\",\n \"container_max_widths\":{\n \"xs\":720.0,\n \"lg\":555.0,\n \"sm\":345.0,\n \"md\":455.0\n },\n \"lg-column-width\":\"\",\n \"md-column-ordering\":\"\"\n },\n \"pk\":925\n },\n [\n [\n \"SimpleWrapperPlugin\",\n {\n \"glossary\":{\n \"extra_inline_styles:line-height\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"370px\"\n },\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"130%\"\n },\n \"element_id\":\"\",\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"extra_css_classes\":[],\n \"tag_type\":\"div\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#ef3e42\"\n ],\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"50px\",\n \"padding-right\":\"50px\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"50px\"\n }\n },\n \"pk\":926\n },\n [\n [\n \"TextPlugin\",\n {\n \"body\":\"Let us make
\\na difference in your
\\nweb design
\\n\\nLorem ipsum dolor sit amet conse ctetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam.
\",\n \"pk\":927\n },\n []\n ],\n [\n \"BootstrapButtonPlugin\",\n {\n \"glossary\":{\n \"icon_align\":\"icon-right\",\n \"extra_inline_styles:Margins\":{\n \"margin-top\":\"20px\",\n \"margin-bottom\":\"\"\n },\n \"button_options\":[],\n \"button_size\":\"btn-lg\",\n \"quick_float\":\"pull-right\",\n \"hide_plugin\":\"\",\n \"icon_font\":\"3\",\n \"link_content\":\"Continue\",\n \"link\":{\n \"pk\":5,\n \"model\":\"cms.Page\",\n \"type\":\"cmspage\",\n \"section\":\"\"\n },\n \"button_type\":\"btn-default\",\n \"symbol\":\"right-open\"\n },\n \"pk\":928\n },\n []\n ]\n ]\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapRowPlugin\",\n {\n \"glossary\":{\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Margins\":{\n \"margin-top\":\"\",\n \"margin-bottom\":\"20px\"\n }\n },\n \"pk\":937\n },\n [\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"container_max_widths\":{\n \"xs\":720.0,\n \"lg\":1140.0,\n \"sm\":720.0,\n \"md\":940.0\n },\n \"xs-column-width\":\"col-xs-12\"\n },\n \"pk\":938\n },\n [\n [\n \"LeafletPlugin\",\n {\n \"glossary\":{\n \"render_template\":\"cascade/plugins/leaflet.html\",\n \"map_position\":{\n \"lat\":47.27337658656428,\n \"lng\":11.399195194244387,\n \"zoom\":15\n },\n \"hide_plugin\":\"\",\n \"map_height\":\"400px\",\n \"map_width\":\"100%\"\n },\n \"pk\":939,\n \"inlines\":[\n {\n \"title\":\"Kirche St. Nikolaus\",\n \"image\":{\n \"pk\":15,\n \"model\":\"filer.Image\"\n },\n \"marker_width\":\"25px\",\n \"position\":{\n \"lat\":47.274337475394645,\n \"lng\":11.393036842346191\n },\n \"popup_text\":null,\n \"marker_anchor\":{\n \"top\":\"50%\",\n \"left\":\"50%\"\n }\n }\n ]\n },\n []\n ]\n ]\n ]\n ]\n ]\n ]\n ]\n ]\n}"
},
{
"path": "examples/bs4demo/bs4demo/static/bs4demo/css/_footer.scss",
"content": "// include this file when using a static footer\n@import \"variables\";\n\nhtml {\n\tposition: relative;\n\tmin-height: 100%;\n}\n\nbody {\n\tmargin-bottom: $body-footer-height;\n}\n\n#footer {\n\tposition: absolute;\n\tbottom: 0;\n\twidth: 100%;\n\theight: $body-footer-height;\n\tcolor: $body-footer-color;\n\tbackground: $body-footer-bg;\n\tpadding-top: 20px;\n\tpadding-bottom: 20px;\n}\n"
},
{
"path": "examples/bs4demo/bs4demo/static/bs4demo/css/_variables.scss",
"content": "@import \"bootstrap/scss/_functions\";\n@import \"bootstrap/scss/_variables\";\n@import \"bootstrap/scss/mixins/_breakpoints.scss\";\n\n// footer\n$body-footer-height: 200px;\n$body-footer-color: $yiq-text-light;\n$body-footer-bg: $dark;\n"
},
{
"path": "examples/bs4demo/bs4demo/static/bs4demo/css/badge.scss",
"content": ".badge-ribbon {\n position: relative;\n background: lightgrey;\n font-size: 50px;\n height: 100px;\n width: 100px;\n -moz-border-radius: 50px;\n -webkit-border-radius: 50px;\n border-radius: 50px;\n text-align: center;\n padding-top: 12px;\n margin-bottom: 50px;\n &:before, &:after {\n content: '';\n position: absolute;\n border-bottom: 70px solid lightgrey;\n border-left: 40px solid transparent;\n border-right: 40px solid transparent;\n top: 90px;\n left: -10px;\n -webkit-transform: rotate(-150deg);\n -moz-transform: rotate(-150deg);\n -ms-transform: rotate(-150deg);\n -o-transform: rotate(-150deg);\n }\n &:after {\n left: auto;\n right: -10px;\n -webkit-transform: rotate(150deg);\n -moz-transform: rotate(150deg);\n -ms-transform: rotate(150deg);\n -o-transform: rotate(150deg);\n }\n}\n"
},
{
"path": "examples/bs4demo/bs4demo/static/bs4demo/css/main.scss",
"content": "@import \"variables\";\n@import \"bootstrap/scss/bootstrap\";\n@import \"footer\";\n\nbody {\n\tbackground-color: #eee8e8;\n}\n"
},
{
"path": "examples/bs4demo/bs4demo/templates/bs4demo/badge.html",
"content": "{% load sekizai_tags sass_tags %}\n{% addtoblock \"css\" %}{% endaddtoblock %}\n{% with inline_styles=instance.inline_styles %}\n{{ instance.glossary.content }}\n{% endwith %}\n"
},
{
"path": "examples/bs4demo/bs4demo/templates/bs4demo/base.html",
"content": "{% load static cms_tags sekizai_tags %}\n\n\n\n\n\t{% block title %}Page Title{% endblock %} \n\t\n\t\n\t\n\t{% block head %}{% endblock %}\n\t{% render_block \"css\" %}\n\n\n\n\t{% cms_toolbar %}\n\t\n\t\t{% block header %}{% endblock %}\n\t \n\t\n\t\t{% block main %}{% endblock %}\n\t \n\t\n\t{% if DJANGO_CLIENT_FRAMEWORK == 'angular-ui' %}\n\t\n\t\n\t\n\t\n\t\n\t{% else %}\n\t\n\t\n\t\n\t{% endif %}\n\t{% render_block \"js\" %}\n\n\n
``...````.\nCascade by default is configured to allow bookmarks on the **SimpleWrapperPlugin** and the\n**HeadingPlugin**. This can be overridden in the project's configuration settings using:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'plugins_with_bookmark': [list-of-plugins],\n\t ...\n\t}\n\n\nHashbang Mode\n-------------\n\nLinks onto bookmarks do not work properly in hashbang mode. Depending on the HTML settings, you may\nhave to prefix them with ``/`` or ``!``. Therefore **djangocms-cascade** offers a configuration\ndirective:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'bookmark_prefix': '/',\n\t ...\n\t}\n\nwhich automatically prefixes the used bookmark.\n\n\nUsage\n=====\n\nWhen editing a plugin that is eligible for adding a bookmark, an extra input field is shown:\n\n|section-bookmark|\n\n.. |section-bookmark| image:: /_static/section-bookmark.png\n\nYou may add any identifier to this field, as long as it is unique on that page. Otherwise the\nplugin's editor will be reject the given inputs, while saving.\n\n\nHyperlinking to a Bookmark\n==========================\n\nWhen editing a **TextLink**, **BootstrapButton** or the link fields inside the **Image** or\n**Picture** plugins, the user gets an additional drop-down menu to choose one of the bookmarks for\nthe given page. This additional drop-down is only available if the **Link** is of type *CMS page*.\n\n|link-bookmark|\n\n.. |link-bookmark| image:: /_static/link-bookmark.png\n\nIf no bookmarks have been associated with the chosen CMS page, the drop-down menu displays only\n*Page root*, which is the default.\n"
},
{
"path": "docs/source/segmentation.rst",
"content": "=======================\nSegmentation of the DOM\n=======================\n\nThe **SegmentationPlugin** allows to personalize the DOM structure, depending on the context used to\nrender the corresponding page. Since **django-CMS** always uses a RequestContext_ while rendering\nits pages, we always have access onto the request object. Some use cases are:\n\n* Depending on the user, show a different portion of the DOM, if he is a certain user or not logged\n in at all.\n* Show different parts of the DOM, depending on the browsers estimated geolocation. Useful to\n render different content depending on the visitors country.\n* Show different parts of the DOM, depending on the supplied marketing channel.\n* Show different parts of the DOM, depending on the content in the session objects from previous\n visits of the users.\n* Segment visitors into different groups used for A/B-testing.\n\n\nConfiguration\n=============\n\nThe **SegmentationPlugin** must be activated separately on top of other **djangocms-cascade**\nplugins. In ``settings.py``, add to\n\n.. code-block:: python\n\n\tINSTALLED_APPS = (\n\t ...\n\t 'cmsplugin_cascade',\n\t 'cmsplugin_cascade.segmentation',\n\t ...\n\t)\n\nThen, depending on what kind of data shall be emulated, add a list of two-tuples to the\nconfiguration settings ``CMSPLUGIN_CASCADE['segmentation_mixins']``. The first entry of each\ntwo-tuple specifies the mixin class added the the proxy model for the ``SegmentationPlugin``. The\nsecond entry specifies the mixin class added the model admin class for the ``SegmentationPlugin``.\n\n.. code-block:: python\n\n\t# this entry is optional:\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'segmentation_mixins': (\n\t ('cmsplugin_cascade.segmentation.mixins.EmulateUserModelMixin', 'cmsplugin_cascade.segmentation.mixins.EmulateUserAdminMixin',), # the default\n\t # other segmentation plugin classes\n\t ),\n\t ...\n\t}\n\n\nUsage\n=====\n\nWhen editing **djangoCMS** plugins in **Structure** mode, below the section **Generic** a new plugin\ntype appears, named **Segment**.\n\n|segment-plugin|\n\n.. |segment-plugin| image:: _static/segment-plugin.png\n\nThis plugin now behaves as an ``if`` block, which is rendered only, if the specified condition\nevaluates to true. The syntax used to specify the condition, is the same as used in the Django\ntemplate language. Therefore it is possible to evaluate against more than one condition and combine\nthem with ``and``, ``or`` and ``not`` as described in `boolean operators`_ in the Django docs\n\nImmediately below a segmentation block using the condition tag ``if``, it is possible to use the\ntags ``elif`` or ``else``. This kind of conditional blocks is well known to Python programmers.\n\nNote, that when rendering pages in djangoCMS, a RequestContext_- rather than a Context-object is used.\nThis RequestContext is populated by the ``user`` object if ``'django.contrib.auth.context_processors.auth'``\nis added to your settings.py ``TEMPLATE_CONTEXT_PROCESSORS``. This therefore is a prerequisite\nwhen the Segmentation plugin evaluates conditions such as ``user.username == \"john\"``.\n\n.. _RequestContext: https://docs.djangoproject.com/en/1.8/ref/templates/api/#django.template.RequestContext\n.. _boolean operators: https://docs.djangoproject.com/en/dev/ref/templates/builtins/#boolean-operators\n.. _request object: https://docs.djangoproject.com/en/dev/ref/request-response/#httprequest-objects\n\n\nEmulating Users\n===============\n\nOnly staff users or administrators can emulate the currently logged in user. Staff-only users must\npossess the four permissions `cmsplugin_cascade.add_segmentation`,\n`cmsplugin_cascade.change_segmentation`, `cmsplugin_cascade.delete_segmentation` and\n`cmsplugin_cascade.view_segmentation`.\n\nIf this plugin is activated and the permissions are set, then in the CMS toolbar a new menu\ntag appears named βSegmentationβ. Here the currently logged in staff user can select another user.\nAll evaluation conditions then evaluate against this selected user, instead of the currently logged\nin user.\n\nIt is quite simple to add other overriding emulations. Have a look at the class\n``cmsplugin_cascade.segmentation.mixins.EmulateUserMixin``. This class then has to be added to\nyour configuration settings ``CMSPLUGIN_CASCADE_SEGMENTATION_MIXINS``. It then overrides the\nevaluation conditions and the toolbar menu.\n"
},
{
"path": "docs/source/sharable-fields.rst",
"content": ".. _sharable-fields:\n\n============================\nWorking with sharable fields\n============================\n\nSometime you'd want to remember sizes, links or any other options for rendering a plugin instance\nacross the project. In order to not have to do this job for each managed entity, you can remember\nthese settings using a name of your choice, controllable in a special section of the administration\nbackend.\n\nNow, whenever someone adds a new instance using this plugin, a select box with these remembered\nsettings appears. He then can choose from one of the remembered settings, which frees him to\nreenter all the values.\n\n\nConfigure a Cascade Plugins to optionally share some fields\n===========================================================\n\nConfiguring a plugin to share specific fields with other plugins of the same type is very easy.\nIn the projects ``settings.py``, assure that ``'cmsplugin_cascade.sharable'`` is part of your\n``INSTALLED_APPS``.\n\nThen add a dictionary of Cascade plugins, with a list of fields which shall be sharable. For\nexample, with this settings, the image plugin can be configured to share its sizes and rendering\noptions among each other.\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'plugins_with_sharables': {\n\t 'BootstrapImagePlugin': ['image-shapes', 'image-width-responsive', 'image-width-fixed', 'image-height', 'resize-options'],\n\t },\n\t ...\n\t}\n\n\nControl some named settings\n===========================\n\nWhenever a plugin is configured to allow to share fields, at the bottom of the plugin editor a\nspecial field appears:\n\n|remember-settings|\n\n.. |remember-settings| image:: /_static/remember-settings.png\n\nBy activating the checkbox, adding an arbitrary name next to it and saving the plugin, an entity\nof sharable fields is saved in the database. Now, whenever someone starts to edit a plugin of this\ntype, a select box appears on the top of the editor:\n\n|use-shared-settings|\n\n.. |use-shared-settings| image:: /_static/use-shared-settings.png\n\nBy choosing a previously named shared settings, the configured fields are disabled for input and\nreplaced by their shared field's counterparts.\n\nIn order to edit these shared fields in the administration backend, one must access\n**Home βΊ Cmsplugin_cascade βΊ Shared between Plugins**. By choosing a named shared setting, one can\nenter into the shared field's editor. This editor auto adopts to the fields declared as shared,\nhence will change from entity to entity. For the above example, it may look like this:\n\n|edit-shared-fields|\n\n.. |edit-shared-fields| image:: /_static/edit-shared-fields.png\n\nIn this editor one can change these shared settings globally, for all plugin instances where this\nnamed shared settings have been applied to.\n"
},
{
"path": "docs/source/sphinx.rst",
"content": "==============================\nIntegrate Sphinx Documentation\n==============================\n\nRestructured Text (ReST) is the de facto standard for documenting Python projects and is even widely\nused outside of this realm, by applications written in other languages. Sphinx_ is a compiler to\ngenerate HTML, Latex, PDF, e-books, etc. out of sources written in ReST.\n\nHTML rendered by Sphinx, typically is rendered as static content by the web server. This makes it\ndifficult to serve documentation, side by side with content from **django-CMS**, because these are\ncompletely different technologies. Furthermore, since Sphinx uses Jinja2 templates, but **django-CMS**'s\ninternal templatetags are not available for Jinja2, template sharing is not possible.\n\nTherefore **djangocms-cascade** offers an integration service, which makes it possible to integrate\ndocumentation generated by Sphinx, unintrusively inside the menu tree of **django-CMS**.\n\n\nConfiguration\n=============\n\nTo the project's ``settings.py``, add these options to the configuration directives:\n\n.. code-block:: python\n\n\tINSTALLED_APPS = [\n\t ...\n\t 'cmsplugin_cascade',\n\t 'cmsplugin_cascade.sphinx',\n\t ...\n\t]\n\n\tCMS_TEMPLATES = [\n\t ...\n\t ('path/to/documentation.html', \"Documentation Page\"),\n\t ...\n\t]\n\n\tSPHINX_DOCS_ROOT = '/path/to/docs/_build/fragments'\n\nReplace ``'/path/to/documentation.html'`` with a filename pointing to your documentation\nroot template (see below).\n\nPoint ``SPHINX_DOCS_ROOT`` onto the directory, into which the HTML page fragments are generated.\n\n\nConfigure Sphinx Builder\n------------------------\n\nLocate the file ``conf.py`` and add:\n\n.. code-block:: python\n\n\textensions = [\n\t ...\n\t 'cmsplugin_cascade.sphinx.fragmentsbuilder',\n\t]\n\nBy invoking ``make fragments``, Sphinx generates a HTML fragment for each page inside the\ndocumentation folder, typically into ``docs/build/fragments``. Later we use these fragments\nand include them using a normal Django view.\n\n\nIntegration with the CMS\n========================\n\nIn Django's admin backend, add a page as the starting point for the documentation inside\nthe CMS menu tree. Typically, one would name that page \"*Documentation*\" using ``docs`` or\n``documentation`` as its slug.\n\nIn the *Advanced Settings* tab, choose **Documentation Page** as the template. This settings\nhas been configured using the directive ``CMS_TEMPLATES``, as shown above.\n\nAs *Application*, select **Sphinx Documentation** from the pull down menu. This attaches the\ncomplete documentation tree just below the chosen slug.\n\nOptionally select **Documentation Menu** from the pull down menu as the *Attached menu*. It adds\na submenu for each main chapter of the documentation. If omitted, only **Documentation** is added\nthe the CMS menu tree.\n\n\nThe Documentation Template\n--------------------------\n\nYou must provide a template to be used by the documentation view. This template typically extends\na base CMS page template, providing a header, the navigation bar and the footer. In the block,\nresponsible for rendering the main content, add this template code:\n\n.. code-block:: django\n\n\t{% extends \"path/to/base.html\" %}\n\t{% load static cascade_tags %}\n\t...\n\t{% block head %}\n\t{{ block.super }}\n\t\n\t{% endblock %}\n\t...\n\t{% block main-content %}\n\t {% if page_content %}\n\t {{ page_content }}\n\t {% else %}\n\t {% sphinx_docs_include \"index.html\" %}\n\t {% endif %}\n\t{% endblock %}\n\nThis Django template now includes the HTML fragments compiled by Sphinx. This allows us to use\n**django-CMS** and combine it with Sphinx. In the URL, the part behind the documentation's slug\ncorresponds 1:1 to the name of the ReST document.\n\nIn this example we add a stylesheet to adopt the output to the `Bootstrap theme`_ for Sphinx_.\nDepending on your template layout, the way you import this may vary.\n\n.. _Sphinx: http://www.sphinx-doc.org/\n.. _Bootstrap theme: http://ryan-roemer.github.io/sphinx-bootstrap-theme/README.html\n\n\nLinking onto Documentation Pages\n--------------------------------\n\nBy overriding the :ref:`link-plugin` with a special target named **Documentation**, we can\neven add links onto our documentation pages symbolically. This means, that whenever we open the\n**LinkPlugin** editor, an additional target is added. It offers a select box showing all\npages from our documentation tree. This prevents us, having to hard code the URL pointing\nonto the documentation.\n\nThis feature has to be configured in the project's ``settings.py``, by replacing the LinkPlugin\nwith a modified version of itself:\n\n.. code-block:: python\n\n\tCMSPLUGIN_CASCADE = {\n\t ...\n\t 'link_plugin_classes': [\n\t 'cmsplugin_cascade.sphinx.link_plugin.SphinxDocsLinkPlugin',\n\t 'cmsplugin_cascade.link.plugin_base.LinkElementMixin',\n\t 'cmsplugin_cascade.sphinx.link_plugin.SphinxDocsLinkForm',\n\t ],\n\t ...\n\t}\n"
},
{
"path": "docs/source/strides.rst",
"content": ".. _strides:\n\n==============================\nUse Cascade outside of the CMS\n==============================\n\nOne of the most legitimate points **djangocms-cascade** can be criticised for, is the lack of\nstatic content rendering. Specially in projects, where we want to work with static pages instead\nof CMS pages, one might fall back to handcrafting HTML, giving up all the benefits of rapid\nprototyping as provided by the Cascade plugin system.\n\nSince version 0.14 of **djangocms-cascade**, one can prototype the page content and export it as\nJSON file using :ref:`clipboard`. Later on, one can reuse that persisted data and create the same\ncontent outside of a CMS page. This is specially useful, if you must persist the page content\nin the project's version control system.\n\n\nUsage\n=====\n\nAfter the placeholder of a CMS page, is filled up with plugins from **djangocms-cascade**,\nswitch into *Structure Mode*, go to the context menu of that placeholder and click *Copy all*.\n\nNext, inside Django's administration backend, go to\n\n\tHome βΊ Django CMS Cascade βΊ Persited Clipboard Content\n\nand click onto *Add Persisted Clipboard Content*. The *Data* field will now be filled with a\ncascade of plugins serialized as JSON data. Copy that data and paste it into a file locatable\nby Django's static file finders, for example ``myproject/static/myapp/cascades/slug.json``.\n\n\nIn Templates\n============\n\nCreate a Django template, where instead of adding a Django-CMS placeholder, use the templatetag\n``render_cascade``. Example:\n\n.. code-block:: Django\n\n\t{% load cascade_tags %}\n\n\t{% render_cascade \"myapp/cascades/slug.json\" %}\n\nThis templatetag now renders the content just as if it would be rendered by the CMS. This means\nthat changing the template of a **djangocms-cascade** plugin, immediately has effect on the rendered\noutput. This is so to say **Model View Control**, where the Model is the content peristed as JSON,\nand the View is the template provided by the plugin. It separates the composition of HTML components\nfrom their actual representation, allowing a much better division of work during the page creation.\n\n\nCaveats when creating your own Plugins\n======================================\n\nWhen developing your own plugins, consider the following precautions:\n\n\nInvoking ``super``\n------------------\n\nInstead of invoking ``super(MyPlugin, self).some_method()`` use\n``self.super(MyPlugin, self).some_method()``. This is required because **djangocms-cascade**\ncreates a list of \"shadow\" plugins, which do not inherit from ``CMSPluginBase``.\n\n\nTemplatetag ``render_plugin``\n-----------------------------\n\nDjango-CMS provides a templatetag ``render_plugin``. Don't use it in templates provided by\n**djangocms-cascade** plugins. Instead use the templatetag named ``render_plugin`` from\nCascade. Example:\n\n.. code-block:: Django\n\n\t{% load cascade_tags %}\n\t\n\t{% for plugin in instance.child_plugin_instances %}\n\t {% render_plugin plugin %}\n\t{% endfor %}\n\t\n\n\nCaching\n=======\n\nEven though rendering using this templatetag is slightly faster than the classic ``placeholder``\ntag provided by the CMS (because we don't hit the database for each plugin instance), combining\neach plugin template with its context also takes its time. Therefore plugins rendered by\n``render_cascade``, by default are cached as well, just as their CMS counterparts.\n\nThis caching is disabled for plugins containing the attribute ``cache = False``. It can be turned\noff globally using the directive ``CMSPLUGIN_CASCADE['cache_strides'] = True`` in the project's\n``settings.py``.\n"
},
{
"path": "examples/bs4demo/.coveragerc",
"content": "[run]\nbranch = True\nsource =\n cmsplugin_cascade\n[report]\nprecision = 2\nomit =\n ../*migrations*\n gs960 \n"
},
{
"path": "examples/bs4demo/bs4demo/__init__.py",
"content": "# -*- coding: utf-8 -*-\n"
},
{
"path": "examples/bs4demo/bs4demo/cms_plugins.py",
"content": "# -*- coding: utf-8 -*-\nfrom __future__ import unicode_literals\n\nfrom django.forms import widgets\nfrom django.utils.translation import ugettext_lazy as _\n\nfrom cms.plugin_pool import plugin_pool\nfrom cmsplugin_cascade.fields import GlossaryField\nfrom cmsplugin_cascade.plugin_base import CascadePluginBase\n\n\nclass Badge(CascadePluginBase):\n \"\"\"\n This is a simple example of a plugin suitable for the djangocms-cascade system.\n It contains one single field: `content` rendered via the template `bs4demo/badge.html`.\n \"\"\"\n name = _(\"Badge\")\n require_parent = False\n allow_children = False\n render_template = 'bs4demo/badge.html'\n\n content = GlossaryField(\n widgets.TextInput(),\n label=_(\"Content\"),\n )\n\nplugin_pool.register_plugin(Badge)\n"
},
{
"path": "examples/bs4demo/bs4demo/context_processors.py",
"content": "# -*- coding: utf-8 -*-\nfrom django.conf import settings\n\n\ndef cascade(request):\n \"\"\"\n Adds additional context variables to the default context.\n \"\"\"\n context = {\n 'DJANGO_CLIENT_FRAMEWORK': settings.CMSPLUGIN_CASCADE['bootstrap4'].get('template_basedir'),\n }\n return context\n"
},
{
"path": "examples/bs4demo/bs4demo/models.py",
"content": "# -*- coding: utf-8 -*-\n"
},
{
"path": "examples/bs4demo/bs4demo/settings.py",
"content": "# Django settings for unit test project.\nfrom __future__ import unicode_literals\n\nimport os\nimport sys\n\nfrom django.urls import reverse_lazy\n\nfrom cmsplugin_cascade.extra_fields.config import PluginExtraFieldsConfig\nfrom django.utils.text import format_lazy\n\nDEBUG = True\n\nBASE_DIR = os.path.dirname(__file__)\n\n# Root directory for this Django project\nPROJECT_ROOT = os.path.abspath(os.path.join(BASE_DIR, os.path.pardir))\n\n# Directory where working files, such as media and databases are kept\nWORK_DIR = os.path.join(PROJECT_ROOT, 'workdir')\nif not os.path.isdir(WORK_DIR):\n os.makedirs(WORK_DIR)\n\nSITE_ID = 1\n\nROOT_URLCONF = 'bs4demo.urls'\n\nSECRET_KEY = 'secret'\n\nDATABASES = {\n 'default': {\n 'ENGINE': 'django.db.backends.sqlite3',\n 'NAME': os.path.join(WORK_DIR, 'db.sqlite3'),\n },\n}\n\nINSTALLED_APPS = [\n 'django.contrib.auth',\n 'django.contrib.contenttypes',\n 'django.contrib.sessions',\n 'django.contrib.sites',\n 'django.contrib.messages',\n 'django.contrib.admin',\n 'django.contrib.staticfiles',\n 'django.contrib.sitemaps',\n #'reversion',\n 'djangocms_text_ckeditor',\n 'django_select2',\n 'cmsplugin_cascade',\n 'cmsplugin_cascade.clipboard',\n 'cmsplugin_cascade.extra_fields',\n 'cmsplugin_cascade.icon',\n 'cmsplugin_cascade.sharable',\n 'cmsplugin_cascade.segmentation',\n 'cms',\n 'cms_bootstrap',\n 'adminsortable2',\n 'menus',\n 'treebeard',\n 'filer',\n 'easy_thumbnails',\n 'sass_processor',\n 'sekizai',\n 'bs4demo',\n]\n\nMIDDLEWARE = [\n 'django.middleware.security.SecurityMiddleware',\n 'django.contrib.sessions.middleware.SessionMiddleware',\n 'django.middleware.common.CommonMiddleware',\n 'django.middleware.csrf.CsrfViewMiddleware',\n 'django.contrib.auth.middleware.AuthenticationMiddleware',\n 'django.contrib.messages.middleware.MessageMiddleware',\n 'django.middleware.clickjacking.XFrameOptionsMiddleware',\n 'django.middleware.locale.LocaleMiddleware',\n 'django.middleware.gzip.GZipMiddleware',\n 'cms.middleware.page.CurrentPageMiddleware',\n 'cms.middleware.user.CurrentUserMiddleware',\n 'cms.middleware.toolbar.ToolbarMiddleware',\n 'cms.middleware.language.LanguageCookieMiddleware',\n]\n\n# silence false-positive warning 1_6.W001\n# https://docs.djangoproject.com/en/1.8/ref/checks/#backwards-compatibility\n#TEST_RUNNER = 'django.test.runner.DiscoverRunner'\n\n# Absolute path to the directory that holds media.\n# Example: \"/home/media/media.lawrence.com/\"\nMEDIA_ROOT = os.path.join(WORK_DIR, 'media')\n\n# URL that handles the media served from MEDIA_ROOT. Make sure to use a\n# trailing slash.\n# Examples: \"http://media.lawrence.com/media/\", \"http://example.com/media/\"\nMEDIA_URL = '/media/'\n\n# Absolute path to the directory that holds static files.\n# Example: \"/home/media/media.lawrence.com/static/\"\nSTATIC_ROOT = os.path.join(WORK_DIR, 'static')\n\n# URL that handles the static files served from STATIC_ROOT.\n# Example: \"http://media.lawrence.com/static/\"\nSTATIC_URL = '/static/'\n\nSTATICFILES_FINDERS = [\n 'django.contrib.staticfiles.finders.FileSystemFinder',\n 'django.contrib.staticfiles.finders.AppDirectoriesFinder',\n 'sass_processor.finders.CssFinder',\n]\n\nSTATICFILES_DIRS = [\n ('node_modules', os.path.join(PROJECT_ROOT, 'node_modules')),\n]\n\nTEMPLATES = [{\n 'BACKEND': 'django.template.backends.django.DjangoTemplates',\n 'APP_DIRS': True,\n 'OPTIONS': {\n 'context_processors': (\n 'django.contrib.auth.context_processors.auth',\n 'django.template.context_processors.debug',\n 'django.template.context_processors.i18n',\n 'django.template.context_processors.media',\n 'django.template.context_processors.static',\n 'django.template.context_processors.tz',\n 'django.template.context_processors.csrf',\n 'django.template.context_processors.request',\n 'django.contrib.messages.context_processors.messages',\n 'sekizai.context_processors.sekizai',\n 'cms.context_processors.cms_settings',\n 'bs4demo.context_processors.cascade',\n ),\n },\n}]\n\n# If you set this to False, Django will make some optimizations so as not\n# to load the internationalization machinery.\nUSE_I18N = True\n\n# If you set this to False, Django will not format dates, numbers and\n# calendars according to the current locale.\nUSE_L10N = True\n\n# If you set this to False, Django will not use timezone-aware datetimes.\nUSE_TZ = True\n\nLANGUAGE_CODE = 'en'\n\nLANGUAGES = (\n ('en', 'English'),\n)\n\nLOGGING = {\n 'version': 1,\n 'disable_existing_loggers': True,\n 'filters': {\n 'require_debug_false': {\n '()': 'django.utils.log.RequireDebugFalse',\n }\n },\n 'formatters': {\n 'simple': {\n 'format': '[%(asctime)s %(module)s] %(levelname)s: %(message)s'\n },\n },\n 'handlers': {\n 'console': {\n 'level': 'INFO',\n 'class': 'logging.StreamHandler',\n 'formatter': 'simple',\n },\n },\n 'loggers': {\n 'django': {\n 'handlers': ['console'],\n 'level': 'INFO',\n 'propagate': True,\n },\n },\n}\n\nX_FRAME_OPTIONS = 'SAMEORIGIN'\n\nXS_SHARING_ALLOWED_METHODS = ['POST', 'GET', 'OPTIONS', 'PUT', 'DELETE']\n\n#############################################################\n# Application specific settings\n\nif sys.argv[1] == 'test':\n CMS_TEMPLATES = (\n ('testing.html', \"Default Page\"),\n )\nelse:\n CMS_TEMPLATES = (\n ('bs4demo/main.html', \"Main Content\"),\n ('bs4demo/wrapped.html', \"Wrapped Bootstrap Column\"),\n )\n\nCMS_SEO_FIELDS = True\n\nCMS_CACHE_DURATIONS = {\n 'content': 3600,\n 'menus': 3600,\n 'permissions': 86400,\n}\n\nCMSPLUGIN_CASCADE_PLUGINS = (\n 'cmsplugin_cascade.segmentation',\n 'cmsplugin_cascade.generic',\n 'cmsplugin_cascade.leaflet',\n 'cmsplugin_cascade.link',\n 'cmsplugin_cascade.bootstrap4',\n 'bs4demo',\n)\n\nCMSPLUGIN_CASCADE = {\n 'alien_plugins': ('TextPlugin', 'TextLinkPlugin',),\n 'plugins_with_sharables': {\n 'BootstrapImagePlugin': ('image_shapes', 'image_width_responsive', 'image_width_fixed',\n 'image_height', 'resize_options',),\n 'BootstrapPicturePlugin': ('image_shapes', 'responsive_heights', 'image_size', 'resize_options',),\n },\n 'exclude_hiding_plugin': ('SegmentPlugin', 'Badge'),\n 'allow_plugin_hiding': True,\n 'leaflet': {'default_position': {'lat': 50.0, 'lng': 12.0, 'zoom': 6}},\n 'cache_strides': True,\n}\n\nCMS_PLACEHOLDER_CONF = {\n # this placeholder is used in templates/main.html, it shows how to\n # scaffold a djangoCMS page starting with an empty placeholder\n 'Main Content': {\n 'plugins': ['BootstrapContainerPlugin', 'BootstrapJumbotronPlugin'],\n 'parent_classes': {'BootstrapContainerPlugin': None, 'BootstrapJumbotronPlugin': None},\n },\n # this placeholder is used in templates/wrapped.html, it shows how to\n # add content to an existing Bootstrap column\n 'Bootstrap Column': {\n 'plugins': ['BootstrapRowPlugin', 'TextPlugin', ],\n 'parent_classes': {'BootstrapRowPlugin': None},\n 'require_parent': False,\n },\n}\n\nCKEDITOR_SETTINGS = {\n 'language': '{{ language }}',\n 'skin': 'moono-lisa',\n 'toolbar': 'CMS',\n 'stylesSet': format_lazy('default:{}', reverse_lazy('admin:cascade_texteditor_config')),\n}\n\nSELECT2_CSS = 'node_modules/select2/dist/css/select2.min.css'\nSELECT2_JS = 'node_modules/select2/dist/js/select2.min.js'\n\nFILER_ALLOW_REGULAR_USERS_TO_ADD_ROOT_FOLDERS = True\n\nFILER_DUMP_PAYLOAD = True\n\nTHUMBNAIL_PROCESSORS = (\n 'easy_thumbnails.processors.colorspace',\n 'easy_thumbnails.processors.autocrop',\n 'filer.thumbnail_processors.scale_and_crop_with_subject_location',\n 'easy_thumbnails.processors.filters',\n)\n\nTHUMBNAIL_HIGH_RESOLUTION = False\n\nTHUMBNAIL_PRESERVE_EXTENSIONS = True\n\nTHUMBNAIL_OPTIMIZE_COMMAND = {\n 'png': '/opt/local/bin/optipng {filename}',\n 'gif': '/opt/local/bin/optipng {filename}',\n 'jpeg': '/opt/local/bin/jpegoptim {filename}',\n}\n\nSASS_PROCESSOR_INCLUDE_DIRS = [\n os.path.join(PROJECT_ROOT, 'node_modules'),\n]\n\nSASS_PROCESSOR_ROOT = STATIC_ROOT\n\n# to access files such as fonts via staticfiles finders\nNODE_MODULES_URL = STATIC_URL + 'node_modules/'\n\ntry:\n from .private_settings import *\nexcept ImportError:\n pass\n\n"
},
{
"path": "examples/bs4demo/bs4demo/static/bs4demo/cascades/strides.json",
"content": "{\n \"plugins\":[\n [\n \"BootstrapJumbotronPlugin\",\n {\n \"glossary\":{\n \"background_width_height\":{\n \"width\":\"\",\n \"height\":\"\"\n },\n \"background_vertical_position\":\"center\",\n \"media_queries\":{\n \"xs\":[\n \"(max-width: 768px)\"\n ],\n \"lg\":[\n \"(min-width: 1200px)\"\n ],\n \"sm\":[\n \"(min-width: 768px)\",\n \"(max-width: 992px)\"\n ],\n \"md\":[\n \"(min-width: 992px)\",\n \"(max-width: 1200px)\"\n ]\n },\n \"background_attachment\":\"scroll\",\n \"image\":{\n \"pk\":5,\n \"model\":\"filer.Image\"\n },\n \"background_repeat\":\"no-repeat\",\n \"hide_plugin\":\"\",\n \"fluid\":true,\n \"container_max_heights\":{\n \"xs\":\"100%\",\n \"md\":\"100%\",\n \"sm\":\"100%\",\n \"lg\":\"100%\"\n },\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"500px\",\n \"padding-bottom\":\"\"\n },\n \"background_size\":\"cover\",\n \"resize_options\":[\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"container_max_widths\":{\n \"xs\":768,\n \"lg\":1980,\n \"sm\":992,\n \"md\":1200\n },\n \"breakpoints\":[\n \"xs\",\n \"sm\",\n \"md\",\n \"lg\"\n ],\n \"background_color\":[\n \"\",\n \"#12308b\"\n ],\n \"background_horizontal_position\":\"center\"\n },\n \"pk\":900\n },\n [\n [\n \"TextPlugin\",\n {\n \"body\":\"Django-CMS Cascade
\",\n \"pk\":901\n },\n []\n ]\n ]\n ],\n [\n \"BootstrapContainerPlugin\",\n {\n \"glossary\":{\n \"media_queries\":{\n \"xs\":[\n \"(max-width: 768px)\"\n ],\n \"lg\":[\n \"(min-width: 1200px)\"\n ],\n \"sm\":[\n \"(min-width: 768px)\",\n \"(max-width: 992px)\"\n ],\n \"md\":[\n \"(min-width: 992px)\",\n \"(max-width: 1200px)\"\n ]\n },\n \"container_max_widths\":{\n \"xs\":750,\n \"lg\":1170,\n \"sm\":750,\n \"md\":970\n },\n \"breakpoints\":[\n \"xs\",\n \"sm\",\n \"md\",\n \"lg\"\n ],\n \"hide_plugin\":\"\",\n \"fluid\":\"\"\n },\n \"pk\":902\n },\n [\n [\n \"HeadingPlugin\",\n {\n \"glossary\":{\n \"content\":\"Cascade Demo Page\",\n \"element_id\":\"heading-1\",\n \"tag_type\":\"h1\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Margins\":{\n \"margin-right\":\"\",\n \"margin-top\":\"\",\n \"margin-left\":\"\",\n \"margin-bottom\":\"\"\n }\n },\n \"pk\":936\n },\n []\n ],\n [\n \"BootstrapRowPlugin\",\n {\n \"glossary\":{\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Margins\":{\n \"margin-top\":\"\",\n \"margin-bottom\":\"\"\n }\n },\n \"pk\":903\n },\n [\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"md-column-offset\":\"\",\n \"sm-column-width\":\"\",\n \"md-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-width\":\"col-md-6\",\n \"hide_plugin\":\"\",\n \"sm-column-ordering\":\"\",\n \"sm-column-offset\":\"\",\n \"lg-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"xs-column-ordering\":\"\",\n \"xs-column-width\":\"col-xs-12\",\n \"lg-responsive-utils\":\"\",\n \"container_max_widths\":{\n \"xs\":720.0,\n \"lg\":555.0,\n \"sm\":720.0,\n \"md\":455.0\n },\n \"lg-column-width\":\"\",\n \"md-column-ordering\":\"\"\n },\n \"pk\":904\n },\n [\n [\n \"SimpleWrapperPlugin\",\n {\n \"glossary\":{\n \"extra_inline_styles:line-height\":\"2\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"367px\"\n },\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"15px\"\n },\n \"element_id\":\"\",\n \"extra_inline_styles:color\":[\n \"\",\n \"#474747\"\n ],\n \"extra_css_classes\":[],\n \"tag_type\":\"div\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#ffffff\"\n ],\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"20px\",\n \"padding-right\":\"50px\",\n \"padding-bottom\":\"20px\",\n \"padding-left\":\"50px\"\n }\n },\n \"pk\":905\n },\n [\n [\n \"TextPlugin\",\n {\n \"body\":\"What we do?
\\n\\nLorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla vitae elit libero, a pharetra augue. Curabitur blandit tempus porttitor. Donec id elit non mi porta gravida at eget metus. Vestibulum id ligula porta felis euismod semper. Aenean lacinia bibendum nulla sed consectetur. Maecenas faucibus mollis interdum. Cras mattis consectetur purus sit amet fermentum. Nullam id dolor id nibh ultricies vehicula ut id elit.
\",\n \"pk\":906\n },\n []\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"md-column-offset\":\"\",\n \"sm-column-width\":\"\",\n \"md-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-width\":\"col-md-6\",\n \"hide_plugin\":\"\",\n \"sm-column-ordering\":\"\",\n \"sm-column-offset\":\"\",\n \"lg-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"xs-column-ordering\":\"\",\n \"xs-column-width\":\"col-xs-12\",\n \"lg-responsive-utils\":\"\",\n \"extra_css_classes\":[],\n \"container_max_widths\":{\n \"xs\":720.0,\n \"lg\":555.0,\n \"sm\":720.0,\n \"md\":455.0\n },\n \"lg-column-width\":\"\",\n \"md-column-ordering\":\"\"\n },\n \"pk\":907\n },\n [\n [\n \"BootstrapImagePlugin\",\n {\n \"glossary\":{\n \"image_width_responsive\":\"100%\",\n \"target\":\"\",\n \"title\":\"\",\n \"image\":{\n \"pk\":11,\n \"model\":\"filer.Image\"\n },\n \"alt_tag\":\"\",\n \"hide_plugin\":\"\",\n \"image_width_fixed\":\"\",\n \"image_height\":\"\",\n \"link\":{\n \"type\":\"none\"\n },\n \"resize_options\":[\n \"upscale\",\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"image_title\":\"\",\n \"image_shapes\":[\n \"img-responsive\"\n ]\n },\n \"pk\":908\n },\n []\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapRowPlugin\",\n {\n \"glossary\":{\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Margins\":{\n \"margin-top\":\"20px\",\n \"margin-bottom\":\"\"\n }\n },\n \"pk\":909\n },\n [\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"md-column-offset\":\"\",\n \"extra_inline_styles:line-height\":\"\",\n \"sm-column-offset\":\"\",\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"\",\n \"padding-right\":\"\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"\"\n },\n \"xs-column-width\":\"col-xs-4\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#42c8c6\"\n ],\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"sm-column-width\":\"\",\n \"md-responsive-utils\":\"\",\n \"lg-column-ordering\":\"\",\n \"sm-column-ordering\":\"\",\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"\"\n },\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"container_max_widths\":{\n \"xs\":220.0,\n \"lg\":360.0,\n \"sm\":220.0,\n \"md\":293.33\n },\n \"md-column-width\":\"\",\n \"xs-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"360px\"\n },\n \"extra_css_classes\":[],\n \"lg-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-ordering\":\"\",\n \"lg-column-width\":\"\"\n },\n \"pk\":910\n },\n [\n [\n \"SimpleWrapperPlugin\",\n {\n \"glossary\":{\n \"extra_inline_styles:line-height\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"360px\"\n },\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"\"\n },\n \"element_id\":\"\",\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"extra_css_classes\":[],\n \"tag_type\":\"div\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#42c8c6\"\n ],\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"\",\n \"padding-right\":\"50px\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"50px\"\n }\n },\n \"pk\":911\n },\n [\n [\n \"FramedIconPlugin\",\n {\n \"glossary\":{\n \"font_size\":\"10em\",\n \"color\":[\n \"\",\n \"#ffffff\"\n ],\n \"background_color\":[\n \"disabled\",\n \"#ffffff\"\n ],\n \"symbol\":\"wrench\",\n \"hide_plugin\":\"\",\n \"text_align\":\"text-center\",\n \"icon_font\":\"3\",\n \"border_radius\":\"\",\n \"border\":[\n \"0px\",\n \"none\",\n \"#000000\"\n ]\n },\n \"pk\":912\n },\n []\n ],\n [\n \"TextPlugin\",\n {\n \"body\":\"Quick Installs
\\n\\nLorem ipsum dolor sit amet conse ctetur adipisicing elit, sed do eiusmod tempor incididunt ut labore.
\",\n \"pk\":913\n },\n []\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"md-column-offset\":\"\",\n \"extra_inline_styles:line-height\":\"\",\n \"sm-column-offset\":\"\",\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"\",\n \"padding-right\":\"\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"\"\n },\n \"xs-column-width\":\"col-xs-4\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#f5b10e\"\n ],\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"sm-column-width\":\"\",\n \"md-responsive-utils\":\"\",\n \"lg-column-ordering\":\"\",\n \"sm-column-ordering\":\"\",\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"\"\n },\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"container_max_widths\":{\n \"xs\":220.0,\n \"lg\":360.0,\n \"sm\":220.0,\n \"md\":293.33\n },\n \"md-column-width\":\"\",\n \"xs-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"360px\"\n },\n \"extra_css_classes\":[],\n \"lg-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-ordering\":\"\",\n \"lg-column-width\":\"\"\n },\n \"pk\":918\n },\n [\n [\n \"SimpleWrapperPlugin\",\n {\n \"glossary\":{\n \"extra_inline_styles:line-height\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"360px\"\n },\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"\"\n },\n \"element_id\":\"\",\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"extra_css_classes\":[],\n \"tag_type\":\"div\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#f5b10e\"\n ],\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"\",\n \"padding-right\":\"50px\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"50px\"\n }\n },\n \"pk\":919\n },\n [\n [\n \"FramedIconPlugin\",\n {\n \"glossary\":{\n \"font_size\":\"10em\",\n \"color\":[\n \"\",\n \"#ffffff\"\n ],\n \"background_color\":[\n \"disabled\",\n \"#ffffff\"\n ],\n \"symbol\":\"cog-alt\",\n \"hide_plugin\":\"\",\n \"text_align\":\"text-center\",\n \"icon_font\":\"3\",\n \"border_radius\":\"\",\n \"border\":[\n \"0px\",\n \"none\",\n \"#000000\"\n ]\n },\n \"pk\":920\n },\n []\n ],\n [\n \"TextPlugin\",\n {\n \"body\":\"Customizable
\\n\\nLorem ipsum dolor sit amet conse ctetur adipisicing elit, sed do eiusmod tempor incididunt ut labore.
\",\n \"pk\":921\n },\n []\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"md-column-offset\":\"\",\n \"extra_inline_styles:line-height\":\"\",\n \"sm-column-offset\":\"\",\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"\",\n \"padding-right\":\"\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"\"\n },\n \"xs-column-width\":\"col-xs-4\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#56ba41\"\n ],\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"sm-column-width\":\"\",\n \"md-responsive-utils\":\"\",\n \"lg-column-ordering\":\"\",\n \"sm-column-ordering\":\"\",\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"\"\n },\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"container_max_widths\":{\n \"xs\":220.0,\n \"lg\":360.0,\n \"sm\":220.0,\n \"md\":293.33\n },\n \"md-column-width\":\"\",\n \"xs-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"360px\"\n },\n \"extra_css_classes\":[],\n \"lg-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-ordering\":\"\",\n \"lg-column-width\":\"\"\n },\n \"pk\":914\n },\n [\n [\n \"SimpleWrapperPlugin\",\n {\n \"glossary\":{\n \"extra_inline_styles:line-height\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"360px\"\n },\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"\"\n },\n \"element_id\":\"\",\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"extra_css_classes\":[],\n \"tag_type\":\"div\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#56ba41\"\n ],\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"\",\n \"padding-right\":\"50px\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"50px\"\n }\n },\n \"pk\":915\n },\n [\n [\n \"FramedIconPlugin\",\n {\n \"glossary\":{\n \"font_size\":\"10em\",\n \"color\":[\n \"\",\n \"#ffffff\"\n ],\n \"background_color\":[\n \"disabled\",\n \"#ffffff\"\n ],\n \"symbol\":\"bell-alt\",\n \"hide_plugin\":\"\",\n \"text_align\":\"text-center\",\n \"icon_font\":\"3\",\n \"border_radius\":\"\",\n \"border\":[\n \"0px\",\n \"none\",\n \"#000000\"\n ]\n },\n \"pk\":916\n },\n []\n ],\n [\n \"TextPlugin\",\n {\n \"body\":\"Support
\\n\\nLorem ipsum dolor sit amet conse ctetur adipisicing elit, sed do eiusmod tempor incididunt ut labore.
\",\n \"pk\":917\n },\n []\n ]\n ]\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapRowPlugin\",\n {\n \"glossary\":{\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Margins\":{\n \"margin-top\":\"20px\",\n \"margin-bottom\":\"\"\n }\n },\n \"pk\":929\n },\n [\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"container_max_widths\":{\n \"xs\":720.0,\n \"lg\":1140.0,\n \"sm\":720.0,\n \"md\":940.0\n },\n \"xs-column-width\":\"col-xs-12\"\n },\n \"pk\":930\n },\n [\n [\n \"CarouselPlugin\",\n {\n \"glossary\":{\n \"resize_options\":[\n \"upscale\",\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"container_max_heights\":{\n \"xs\":\"200px\",\n \"md\":\"300px\",\n \"sm\":\"250px\",\n \"lg\":\"350px\"\n },\n \"interval\":\"5\",\n \"hide_plugin\":\"\",\n \"options\":[\n \"slide\",\n \"pause\",\n \"wrap\"\n ]\n },\n \"pk\":931\n },\n [\n [\n \"CarouselSlidePlugin\",\n {\n \"glossary\":{\n \"resize_options\":[\n \"upscale\",\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"image\":{\n \"pk\":4,\n \"model\":\"filer.Image\"\n },\n \"image_title\":\"\",\n \"hide_plugin\":\"\",\n \"alt_tag\":\"\"\n },\n \"pk\":932\n },\n [\n [\n \"TextPlugin\",\n {\n \"body\":\"Hallo Welt!
\",\n \"pk\":933\n },\n []\n ]\n ]\n ],\n [\n \"CarouselSlidePlugin\",\n {\n \"glossary\":{\n \"resize_options\":[\n \"upscale\",\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"image\":{\n \"pk\":7,\n \"model\":\"filer.Image\"\n },\n \"image_title\":\"\",\n \"hide_plugin\":\"\",\n \"alt_tag\":\"\"\n },\n \"pk\":934\n },\n []\n ],\n [\n \"CarouselSlidePlugin\",\n {\n \"glossary\":{\n \"resize_options\":[\n \"upscale\",\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"image\":{\n \"pk\":6,\n \"model\":\"filer.Image\"\n },\n \"image_title\":\"\",\n \"hide_plugin\":\"\",\n \"alt_tag\":\"\"\n },\n \"pk\":935\n },\n []\n ]\n ]\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapRowPlugin\",\n {\n \"glossary\":{\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Margins\":{\n \"margin-top\":\"20px\",\n \"margin-bottom\":\"20px\"\n }\n },\n \"pk\":922\n },\n [\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"md-column-offset\":\"\",\n \"sm-column-width\":\"col-sm-6\",\n \"md-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-width\":\"\",\n \"hide_plugin\":\"\",\n \"sm-column-ordering\":\"\",\n \"sm-column-offset\":\"\",\n \"lg-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"xs-column-ordering\":\"\",\n \"xs-column-width\":\"col-xs-12\",\n \"lg-responsive-utils\":\"\",\n \"container_max_widths\":{\n \"xs\":720.0,\n \"lg\":555.0,\n \"sm\":345.0,\n \"md\":455.0\n },\n \"lg-column-width\":\"\",\n \"md-column-ordering\":\"\"\n },\n \"pk\":923\n },\n [\n [\n \"BootstrapImagePlugin\",\n {\n \"glossary\":{\n \"image_width_responsive\":\"100%\",\n \"target\":\"\",\n \"title\":\"\",\n \"image\":{\n \"pk\":12,\n \"model\":\"filer.Image\"\n },\n \"alt_tag\":\"\",\n \"hide_plugin\":\"\",\n \"image_width_fixed\":\"\",\n \"image_height\":\"\",\n \"link\":{\n \"type\":\"none\"\n },\n \"resize_options\":[\n \"upscale\",\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"image_title\":\"\",\n \"image_shapes\":[\n \"img-responsive\"\n ]\n },\n \"pk\":924\n },\n []\n ]\n ]\n ],\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"md-column-offset\":\"\",\n \"sm-column-width\":\"col-sm-6\",\n \"md-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-width\":\"\",\n \"hide_plugin\":\"\",\n \"sm-column-ordering\":\"\",\n \"sm-column-offset\":\"\",\n \"lg-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"xs-column-ordering\":\"\",\n \"xs-column-width\":\"col-xs-12\",\n \"lg-responsive-utils\":\"\",\n \"container_max_widths\":{\n \"xs\":720.0,\n \"lg\":555.0,\n \"sm\":345.0,\n \"md\":455.0\n },\n \"lg-column-width\":\"\",\n \"md-column-ordering\":\"\"\n },\n \"pk\":925\n },\n [\n [\n \"SimpleWrapperPlugin\",\n {\n \"glossary\":{\n \"extra_inline_styles:line-height\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"370px\"\n },\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"130%\"\n },\n \"element_id\":\"\",\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"extra_css_classes\":[],\n \"tag_type\":\"div\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#ef3e42\"\n ],\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"50px\",\n \"padding-right\":\"50px\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"50px\"\n }\n },\n \"pk\":926\n },\n [\n [\n \"TextPlugin\",\n {\n \"body\":\"Let us make
\\na difference in your
\\nweb design
\\n\\nLorem ipsum dolor sit amet conse ctetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam.
\",\n \"pk\":927\n },\n []\n ],\n [\n \"BootstrapButtonPlugin\",\n {\n \"glossary\":{\n \"icon_align\":\"icon-right\",\n \"extra_inline_styles:Margins\":{\n \"margin-top\":\"20px\",\n \"margin-bottom\":\"\"\n },\n \"button_options\":[],\n \"button_size\":\"btn-lg\",\n \"quick_float\":\"pull-right\",\n \"hide_plugin\":\"\",\n \"icon_font\":\"3\",\n \"link_content\":\"Continue\",\n \"link\":{\n \"pk\":5,\n \"model\":\"cms.Page\",\n \"type\":\"cmspage\",\n \"section\":\"\"\n },\n \"button_type\":\"btn-default\",\n \"symbol\":\"right-open\"\n },\n \"pk\":928\n },\n []\n ]\n ]\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapRowPlugin\",\n {\n \"glossary\":{\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Margins\":{\n \"margin-top\":\"\",\n \"margin-bottom\":\"20px\"\n }\n },\n \"pk\":937\n },\n [\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"container_max_widths\":{\n \"xs\":720.0,\n \"lg\":1140.0,\n \"sm\":720.0,\n \"md\":940.0\n },\n \"xs-column-width\":\"col-xs-12\"\n },\n \"pk\":938\n },\n [\n [\n \"LeafletPlugin\",\n {\n \"glossary\":{\n \"render_template\":\"cascade/plugins/leaflet.html\",\n \"map_position\":{\n \"lat\":47.27337658656428,\n \"lng\":11.399195194244387,\n \"zoom\":15\n },\n \"hide_plugin\":\"\",\n \"map_height\":\"400px\",\n \"map_width\":\"100%\"\n },\n \"pk\":939,\n \"inlines\":[\n {\n \"title\":\"Kirche St. Nikolaus\",\n \"image\":{\n \"pk\":15,\n \"model\":\"filer.Image\"\n },\n \"marker_width\":\"25px\",\n \"position\":{\n \"lat\":47.274337475394645,\n \"lng\":11.393036842346191\n },\n \"popup_text\":null,\n \"marker_anchor\":{\n \"top\":\"50%\",\n \"left\":\"50%\"\n }\n }\n ]\n },\n []\n ]\n ]\n ]\n ]\n ]\n ]\n ]\n ]\n}"
},
{
"path": "examples/bs4demo/bs4demo/static/bs4demo/css/_footer.scss",
"content": "// include this file when using a static footer\n@import \"variables\";\n\nhtml {\n\tposition: relative;\n\tmin-height: 100%;\n}\n\nbody {\n\tmargin-bottom: $body-footer-height;\n}\n\n#footer {\n\tposition: absolute;\n\tbottom: 0;\n\twidth: 100%;\n\theight: $body-footer-height;\n\tcolor: $body-footer-color;\n\tbackground: $body-footer-bg;\n\tpadding-top: 20px;\n\tpadding-bottom: 20px;\n}\n"
},
{
"path": "examples/bs4demo/bs4demo/static/bs4demo/css/_variables.scss",
"content": "@import \"bootstrap/scss/_functions\";\n@import \"bootstrap/scss/_variables\";\n@import \"bootstrap/scss/mixins/_breakpoints.scss\";\n\n// footer\n$body-footer-height: 200px;\n$body-footer-color: $yiq-text-light;\n$body-footer-bg: $dark;\n"
},
{
"path": "examples/bs4demo/bs4demo/static/bs4demo/css/badge.scss",
"content": ".badge-ribbon {\n position: relative;\n background: lightgrey;\n font-size: 50px;\n height: 100px;\n width: 100px;\n -moz-border-radius: 50px;\n -webkit-border-radius: 50px;\n border-radius: 50px;\n text-align: center;\n padding-top: 12px;\n margin-bottom: 50px;\n &:before, &:after {\n content: '';\n position: absolute;\n border-bottom: 70px solid lightgrey;\n border-left: 40px solid transparent;\n border-right: 40px solid transparent;\n top: 90px;\n left: -10px;\n -webkit-transform: rotate(-150deg);\n -moz-transform: rotate(-150deg);\n -ms-transform: rotate(-150deg);\n -o-transform: rotate(-150deg);\n }\n &:after {\n left: auto;\n right: -10px;\n -webkit-transform: rotate(150deg);\n -moz-transform: rotate(150deg);\n -ms-transform: rotate(150deg);\n -o-transform: rotate(150deg);\n }\n}\n"
},
{
"path": "examples/bs4demo/bs4demo/static/bs4demo/css/main.scss",
"content": "@import \"variables\";\n@import \"bootstrap/scss/bootstrap\";\n@import \"footer\";\n\nbody {\n\tbackground-color: #eee8e8;\n}\n"
},
{
"path": "examples/bs4demo/bs4demo/templates/bs4demo/badge.html",
"content": "{% load sekizai_tags sass_tags %}\n{% addtoblock \"css\" %}{% endaddtoblock %}\n{% with inline_styles=instance.inline_styles %}\n{{ instance.glossary.content }}\n{% endwith %}\n"
},
{
"path": "examples/bs4demo/bs4demo/templates/bs4demo/base.html",
"content": "{% load static cms_tags sekizai_tags %}\n\n\n\n\n\t{% block title %}Page Title{% endblock %} \n\t\n\t\n\t\n\t{% block head %}{% endblock %}\n\t{% render_block \"css\" %}\n\n\n\n\t{% cms_toolbar %}\n\t\n\t\t{% block header %}{% endblock %}\n\t \n\t\n\t\t{% block main %}{% endblock %}\n\t \n\t\n\t{% if DJANGO_CLIENT_FRAMEWORK == 'angular-ui' %}\n\t\n\t\n\t\n\t\n\t\n\t{% else %}\n\t\n\t\n\t\n\t{% endif %}\n\t{% render_block \"js\" %}\n\n\n
\n\t{% for plugin in instance.child_plugin_instances %}\n\t {% render_plugin plugin %}\n\t{% endfor %}\n\t
\n\n\nCaching\n=======\n\nEven though rendering using this templatetag is slightly faster than the classic ``placeholder``\ntag provided by the CMS (because we don't hit the database for each plugin instance), combining\neach plugin template with its context also takes its time. Therefore plugins rendered by\n``render_cascade``, by default are cached as well, just as their CMS counterparts.\n\nThis caching is disabled for plugins containing the attribute ``cache = False``. It can be turned\noff globally using the directive ``CMSPLUGIN_CASCADE['cache_strides'] = True`` in the project's\n``settings.py``.\n"
},
{
"path": "examples/bs4demo/.coveragerc",
"content": "[run]\nbranch = True\nsource =\n cmsplugin_cascade\n[report]\nprecision = 2\nomit =\n ../*migrations*\n gs960 \n"
},
{
"path": "examples/bs4demo/bs4demo/__init__.py",
"content": "# -*- coding: utf-8 -*-\n"
},
{
"path": "examples/bs4demo/bs4demo/cms_plugins.py",
"content": "# -*- coding: utf-8 -*-\nfrom __future__ import unicode_literals\n\nfrom django.forms import widgets\nfrom django.utils.translation import ugettext_lazy as _\n\nfrom cms.plugin_pool import plugin_pool\nfrom cmsplugin_cascade.fields import GlossaryField\nfrom cmsplugin_cascade.plugin_base import CascadePluginBase\n\n\nclass Badge(CascadePluginBase):\n \"\"\"\n This is a simple example of a plugin suitable for the djangocms-cascade system.\n It contains one single field: `content` rendered via the template `bs4demo/badge.html`.\n \"\"\"\n name = _(\"Badge\")\n require_parent = False\n allow_children = False\n render_template = 'bs4demo/badge.html'\n\n content = GlossaryField(\n widgets.TextInput(),\n label=_(\"Content\"),\n )\n\nplugin_pool.register_plugin(Badge)\n"
},
{
"path": "examples/bs4demo/bs4demo/context_processors.py",
"content": "# -*- coding: utf-8 -*-\nfrom django.conf import settings\n\n\ndef cascade(request):\n \"\"\"\n Adds additional context variables to the default context.\n \"\"\"\n context = {\n 'DJANGO_CLIENT_FRAMEWORK': settings.CMSPLUGIN_CASCADE['bootstrap4'].get('template_basedir'),\n }\n return context\n"
},
{
"path": "examples/bs4demo/bs4demo/models.py",
"content": "# -*- coding: utf-8 -*-\n"
},
{
"path": "examples/bs4demo/bs4demo/settings.py",
"content": "# Django settings for unit test project.\nfrom __future__ import unicode_literals\n\nimport os\nimport sys\n\nfrom django.urls import reverse_lazy\n\nfrom cmsplugin_cascade.extra_fields.config import PluginExtraFieldsConfig\nfrom django.utils.text import format_lazy\n\nDEBUG = True\n\nBASE_DIR = os.path.dirname(__file__)\n\n# Root directory for this Django project\nPROJECT_ROOT = os.path.abspath(os.path.join(BASE_DIR, os.path.pardir))\n\n# Directory where working files, such as media and databases are kept\nWORK_DIR = os.path.join(PROJECT_ROOT, 'workdir')\nif not os.path.isdir(WORK_DIR):\n os.makedirs(WORK_DIR)\n\nSITE_ID = 1\n\nROOT_URLCONF = 'bs4demo.urls'\n\nSECRET_KEY = 'secret'\n\nDATABASES = {\n 'default': {\n 'ENGINE': 'django.db.backends.sqlite3',\n 'NAME': os.path.join(WORK_DIR, 'db.sqlite3'),\n },\n}\n\nINSTALLED_APPS = [\n 'django.contrib.auth',\n 'django.contrib.contenttypes',\n 'django.contrib.sessions',\n 'django.contrib.sites',\n 'django.contrib.messages',\n 'django.contrib.admin',\n 'django.contrib.staticfiles',\n 'django.contrib.sitemaps',\n #'reversion',\n 'djangocms_text_ckeditor',\n 'django_select2',\n 'cmsplugin_cascade',\n 'cmsplugin_cascade.clipboard',\n 'cmsplugin_cascade.extra_fields',\n 'cmsplugin_cascade.icon',\n 'cmsplugin_cascade.sharable',\n 'cmsplugin_cascade.segmentation',\n 'cms',\n 'cms_bootstrap',\n 'adminsortable2',\n 'menus',\n 'treebeard',\n 'filer',\n 'easy_thumbnails',\n 'sass_processor',\n 'sekizai',\n 'bs4demo',\n]\n\nMIDDLEWARE = [\n 'django.middleware.security.SecurityMiddleware',\n 'django.contrib.sessions.middleware.SessionMiddleware',\n 'django.middleware.common.CommonMiddleware',\n 'django.middleware.csrf.CsrfViewMiddleware',\n 'django.contrib.auth.middleware.AuthenticationMiddleware',\n 'django.contrib.messages.middleware.MessageMiddleware',\n 'django.middleware.clickjacking.XFrameOptionsMiddleware',\n 'django.middleware.locale.LocaleMiddleware',\n 'django.middleware.gzip.GZipMiddleware',\n 'cms.middleware.page.CurrentPageMiddleware',\n 'cms.middleware.user.CurrentUserMiddleware',\n 'cms.middleware.toolbar.ToolbarMiddleware',\n 'cms.middleware.language.LanguageCookieMiddleware',\n]\n\n# silence false-positive warning 1_6.W001\n# https://docs.djangoproject.com/en/1.8/ref/checks/#backwards-compatibility\n#TEST_RUNNER = 'django.test.runner.DiscoverRunner'\n\n# Absolute path to the directory that holds media.\n# Example: \"/home/media/media.lawrence.com/\"\nMEDIA_ROOT = os.path.join(WORK_DIR, 'media')\n\n# URL that handles the media served from MEDIA_ROOT. Make sure to use a\n# trailing slash.\n# Examples: \"http://media.lawrence.com/media/\", \"http://example.com/media/\"\nMEDIA_URL = '/media/'\n\n# Absolute path to the directory that holds static files.\n# Example: \"/home/media/media.lawrence.com/static/\"\nSTATIC_ROOT = os.path.join(WORK_DIR, 'static')\n\n# URL that handles the static files served from STATIC_ROOT.\n# Example: \"http://media.lawrence.com/static/\"\nSTATIC_URL = '/static/'\n\nSTATICFILES_FINDERS = [\n 'django.contrib.staticfiles.finders.FileSystemFinder',\n 'django.contrib.staticfiles.finders.AppDirectoriesFinder',\n 'sass_processor.finders.CssFinder',\n]\n\nSTATICFILES_DIRS = [\n ('node_modules', os.path.join(PROJECT_ROOT, 'node_modules')),\n]\n\nTEMPLATES = [{\n 'BACKEND': 'django.template.backends.django.DjangoTemplates',\n 'APP_DIRS': True,\n 'OPTIONS': {\n 'context_processors': (\n 'django.contrib.auth.context_processors.auth',\n 'django.template.context_processors.debug',\n 'django.template.context_processors.i18n',\n 'django.template.context_processors.media',\n 'django.template.context_processors.static',\n 'django.template.context_processors.tz',\n 'django.template.context_processors.csrf',\n 'django.template.context_processors.request',\n 'django.contrib.messages.context_processors.messages',\n 'sekizai.context_processors.sekizai',\n 'cms.context_processors.cms_settings',\n 'bs4demo.context_processors.cascade',\n ),\n },\n}]\n\n# If you set this to False, Django will make some optimizations so as not\n# to load the internationalization machinery.\nUSE_I18N = True\n\n# If you set this to False, Django will not format dates, numbers and\n# calendars according to the current locale.\nUSE_L10N = True\n\n# If you set this to False, Django will not use timezone-aware datetimes.\nUSE_TZ = True\n\nLANGUAGE_CODE = 'en'\n\nLANGUAGES = (\n ('en', 'English'),\n)\n\nLOGGING = {\n 'version': 1,\n 'disable_existing_loggers': True,\n 'filters': {\n 'require_debug_false': {\n '()': 'django.utils.log.RequireDebugFalse',\n }\n },\n 'formatters': {\n 'simple': {\n 'format': '[%(asctime)s %(module)s] %(levelname)s: %(message)s'\n },\n },\n 'handlers': {\n 'console': {\n 'level': 'INFO',\n 'class': 'logging.StreamHandler',\n 'formatter': 'simple',\n },\n },\n 'loggers': {\n 'django': {\n 'handlers': ['console'],\n 'level': 'INFO',\n 'propagate': True,\n },\n },\n}\n\nX_FRAME_OPTIONS = 'SAMEORIGIN'\n\nXS_SHARING_ALLOWED_METHODS = ['POST', 'GET', 'OPTIONS', 'PUT', 'DELETE']\n\n#############################################################\n# Application specific settings\n\nif sys.argv[1] == 'test':\n CMS_TEMPLATES = (\n ('testing.html', \"Default Page\"),\n )\nelse:\n CMS_TEMPLATES = (\n ('bs4demo/main.html', \"Main Content\"),\n ('bs4demo/wrapped.html', \"Wrapped Bootstrap Column\"),\n )\n\nCMS_SEO_FIELDS = True\n\nCMS_CACHE_DURATIONS = {\n 'content': 3600,\n 'menus': 3600,\n 'permissions': 86400,\n}\n\nCMSPLUGIN_CASCADE_PLUGINS = (\n 'cmsplugin_cascade.segmentation',\n 'cmsplugin_cascade.generic',\n 'cmsplugin_cascade.leaflet',\n 'cmsplugin_cascade.link',\n 'cmsplugin_cascade.bootstrap4',\n 'bs4demo',\n)\n\nCMSPLUGIN_CASCADE = {\n 'alien_plugins': ('TextPlugin', 'TextLinkPlugin',),\n 'plugins_with_sharables': {\n 'BootstrapImagePlugin': ('image_shapes', 'image_width_responsive', 'image_width_fixed',\n 'image_height', 'resize_options',),\n 'BootstrapPicturePlugin': ('image_shapes', 'responsive_heights', 'image_size', 'resize_options',),\n },\n 'exclude_hiding_plugin': ('SegmentPlugin', 'Badge'),\n 'allow_plugin_hiding': True,\n 'leaflet': {'default_position': {'lat': 50.0, 'lng': 12.0, 'zoom': 6}},\n 'cache_strides': True,\n}\n\nCMS_PLACEHOLDER_CONF = {\n # this placeholder is used in templates/main.html, it shows how to\n # scaffold a djangoCMS page starting with an empty placeholder\n 'Main Content': {\n 'plugins': ['BootstrapContainerPlugin', 'BootstrapJumbotronPlugin'],\n 'parent_classes': {'BootstrapContainerPlugin': None, 'BootstrapJumbotronPlugin': None},\n },\n # this placeholder is used in templates/wrapped.html, it shows how to\n # add content to an existing Bootstrap column\n 'Bootstrap Column': {\n 'plugins': ['BootstrapRowPlugin', 'TextPlugin', ],\n 'parent_classes': {'BootstrapRowPlugin': None},\n 'require_parent': False,\n },\n}\n\nCKEDITOR_SETTINGS = {\n 'language': '{{ language }}',\n 'skin': 'moono-lisa',\n 'toolbar': 'CMS',\n 'stylesSet': format_lazy('default:{}', reverse_lazy('admin:cascade_texteditor_config')),\n}\n\nSELECT2_CSS = 'node_modules/select2/dist/css/select2.min.css'\nSELECT2_JS = 'node_modules/select2/dist/js/select2.min.js'\n\nFILER_ALLOW_REGULAR_USERS_TO_ADD_ROOT_FOLDERS = True\n\nFILER_DUMP_PAYLOAD = True\n\nTHUMBNAIL_PROCESSORS = (\n 'easy_thumbnails.processors.colorspace',\n 'easy_thumbnails.processors.autocrop',\n 'filer.thumbnail_processors.scale_and_crop_with_subject_location',\n 'easy_thumbnails.processors.filters',\n)\n\nTHUMBNAIL_HIGH_RESOLUTION = False\n\nTHUMBNAIL_PRESERVE_EXTENSIONS = True\n\nTHUMBNAIL_OPTIMIZE_COMMAND = {\n 'png': '/opt/local/bin/optipng {filename}',\n 'gif': '/opt/local/bin/optipng {filename}',\n 'jpeg': '/opt/local/bin/jpegoptim {filename}',\n}\n\nSASS_PROCESSOR_INCLUDE_DIRS = [\n os.path.join(PROJECT_ROOT, 'node_modules'),\n]\n\nSASS_PROCESSOR_ROOT = STATIC_ROOT\n\n# to access files such as fonts via staticfiles finders\nNODE_MODULES_URL = STATIC_URL + 'node_modules/'\n\ntry:\n from .private_settings import *\nexcept ImportError:\n pass\n\n"
},
{
"path": "examples/bs4demo/bs4demo/static/bs4demo/cascades/strides.json",
"content": "{\n \"plugins\":[\n [\n \"BootstrapJumbotronPlugin\",\n {\n \"glossary\":{\n \"background_width_height\":{\n \"width\":\"\",\n \"height\":\"\"\n },\n \"background_vertical_position\":\"center\",\n \"media_queries\":{\n \"xs\":[\n \"(max-width: 768px)\"\n ],\n \"lg\":[\n \"(min-width: 1200px)\"\n ],\n \"sm\":[\n \"(min-width: 768px)\",\n \"(max-width: 992px)\"\n ],\n \"md\":[\n \"(min-width: 992px)\",\n \"(max-width: 1200px)\"\n ]\n },\n \"background_attachment\":\"scroll\",\n \"image\":{\n \"pk\":5,\n \"model\":\"filer.Image\"\n },\n \"background_repeat\":\"no-repeat\",\n \"hide_plugin\":\"\",\n \"fluid\":true,\n \"container_max_heights\":{\n \"xs\":\"100%\",\n \"md\":\"100%\",\n \"sm\":\"100%\",\n \"lg\":\"100%\"\n },\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"500px\",\n \"padding-bottom\":\"\"\n },\n \"background_size\":\"cover\",\n \"resize_options\":[\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"container_max_widths\":{\n \"xs\":768,\n \"lg\":1980,\n \"sm\":992,\n \"md\":1200\n },\n \"breakpoints\":[\n \"xs\",\n \"sm\",\n \"md\",\n \"lg\"\n ],\n \"background_color\":[\n \"\",\n \"#12308b\"\n ],\n \"background_horizontal_position\":\"center\"\n },\n \"pk\":900\n },\n [\n [\n \"TextPlugin\",\n {\n \"body\":\"Let us make
\\n\\n{% block title %}Page Title{% endblock %} \n\t\n\t\n\t\n\t{% block head %}{% endblock %}\n\t{% render_block \"css\" %}\n\n\n\n\t{% cms_toolbar %}\n\t\n\t\t{% block header %}{% endblock %}\n\t \n\t\n\t\t{% block main %}{% endblock %}\n\t \n\t\n\t{% if DJANGO_CLIENT_FRAMEWORK == 'angular-ui' %}\n\t\n\t\n\t\n\t\n\t\n\t{% else %}\n\t\n\t\n\t\n\t{% endif %}\n\t{% render_block \"js\" %}\n\n\n
Django-CMS Cascade
\",\n \"pk\":901\n },\n []\n ]\n ]\n ],\n [\n \"BootstrapContainerPlugin\",\n {\n \"glossary\":{\n \"media_queries\":{\n \"xs\":[\n \"(max-width: 768px)\"\n ],\n \"lg\":[\n \"(min-width: 1200px)\"\n ],\n \"sm\":[\n \"(min-width: 768px)\",\n \"(max-width: 992px)\"\n ],\n \"md\":[\n \"(min-width: 992px)\",\n \"(max-width: 1200px)\"\n ]\n },\n \"container_max_widths\":{\n \"xs\":750,\n \"lg\":1170,\n \"sm\":750,\n \"md\":970\n },\n \"breakpoints\":[\n \"xs\",\n \"sm\",\n \"md\",\n \"lg\"\n ],\n \"hide_plugin\":\"\",\n \"fluid\":\"\"\n },\n \"pk\":902\n },\n [\n [\n \"HeadingPlugin\",\n {\n \"glossary\":{\n \"content\":\"Cascade Demo Page\",\n \"element_id\":\"heading-1\",\n \"tag_type\":\"h1\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Margins\":{\n \"margin-right\":\"\",\n \"margin-top\":\"\",\n \"margin-left\":\"\",\n \"margin-bottom\":\"\"\n }\n },\n \"pk\":936\n },\n []\n ],\n [\n \"BootstrapRowPlugin\",\n {\n \"glossary\":{\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Margins\":{\n \"margin-top\":\"\",\n \"margin-bottom\":\"\"\n }\n },\n \"pk\":903\n },\n [\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"md-column-offset\":\"\",\n \"sm-column-width\":\"\",\n \"md-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-width\":\"col-md-6\",\n \"hide_plugin\":\"\",\n \"sm-column-ordering\":\"\",\n \"sm-column-offset\":\"\",\n \"lg-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"xs-column-ordering\":\"\",\n \"xs-column-width\":\"col-xs-12\",\n \"lg-responsive-utils\":\"\",\n \"container_max_widths\":{\n \"xs\":720.0,\n \"lg\":555.0,\n \"sm\":720.0,\n \"md\":455.0\n },\n \"lg-column-width\":\"\",\n \"md-column-ordering\":\"\"\n },\n \"pk\":904\n },\n [\n [\n \"SimpleWrapperPlugin\",\n {\n \"glossary\":{\n \"extra_inline_styles:line-height\":\"2\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"367px\"\n },\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"15px\"\n },\n \"element_id\":\"\",\n \"extra_inline_styles:color\":[\n \"\",\n \"#474747\"\n ],\n \"extra_css_classes\":[],\n \"tag_type\":\"div\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#ffffff\"\n ],\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"20px\",\n \"padding-right\":\"50px\",\n \"padding-bottom\":\"20px\",\n \"padding-left\":\"50px\"\n }\n },\n \"pk\":905\n },\n [\n [\n \"TextPlugin\",\n {\n \"body\":\"What we do?
\\n\\nLorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla vitae elit libero, a pharetra augue. Curabitur blandit tempus porttitor. Donec id elit non mi porta gravida at eget metus. Vestibulum id ligula porta felis euismod semper. Aenean lacinia bibendum nulla sed consectetur. Maecenas faucibus mollis interdum. Cras mattis consectetur purus sit amet fermentum. Nullam id dolor id nibh ultricies vehicula ut id elit.
\",\n \"pk\":906\n },\n []\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"md-column-offset\":\"\",\n \"sm-column-width\":\"\",\n \"md-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-width\":\"col-md-6\",\n \"hide_plugin\":\"\",\n \"sm-column-ordering\":\"\",\n \"sm-column-offset\":\"\",\n \"lg-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"xs-column-ordering\":\"\",\n \"xs-column-width\":\"col-xs-12\",\n \"lg-responsive-utils\":\"\",\n \"extra_css_classes\":[],\n \"container_max_widths\":{\n \"xs\":720.0,\n \"lg\":555.0,\n \"sm\":720.0,\n \"md\":455.0\n },\n \"lg-column-width\":\"\",\n \"md-column-ordering\":\"\"\n },\n \"pk\":907\n },\n [\n [\n \"BootstrapImagePlugin\",\n {\n \"glossary\":{\n \"image_width_responsive\":\"100%\",\n \"target\":\"\",\n \"title\":\"\",\n \"image\":{\n \"pk\":11,\n \"model\":\"filer.Image\"\n },\n \"alt_tag\":\"\",\n \"hide_plugin\":\"\",\n \"image_width_fixed\":\"\",\n \"image_height\":\"\",\n \"link\":{\n \"type\":\"none\"\n },\n \"resize_options\":[\n \"upscale\",\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"image_title\":\"\",\n \"image_shapes\":[\n \"img-responsive\"\n ]\n },\n \"pk\":908\n },\n []\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapRowPlugin\",\n {\n \"glossary\":{\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Margins\":{\n \"margin-top\":\"20px\",\n \"margin-bottom\":\"\"\n }\n },\n \"pk\":909\n },\n [\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"md-column-offset\":\"\",\n \"extra_inline_styles:line-height\":\"\",\n \"sm-column-offset\":\"\",\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"\",\n \"padding-right\":\"\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"\"\n },\n \"xs-column-width\":\"col-xs-4\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#42c8c6\"\n ],\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"sm-column-width\":\"\",\n \"md-responsive-utils\":\"\",\n \"lg-column-ordering\":\"\",\n \"sm-column-ordering\":\"\",\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"\"\n },\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"container_max_widths\":{\n \"xs\":220.0,\n \"lg\":360.0,\n \"sm\":220.0,\n \"md\":293.33\n },\n \"md-column-width\":\"\",\n \"xs-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"360px\"\n },\n \"extra_css_classes\":[],\n \"lg-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-ordering\":\"\",\n \"lg-column-width\":\"\"\n },\n \"pk\":910\n },\n [\n [\n \"SimpleWrapperPlugin\",\n {\n \"glossary\":{\n \"extra_inline_styles:line-height\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"360px\"\n },\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"\"\n },\n \"element_id\":\"\",\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"extra_css_classes\":[],\n \"tag_type\":\"div\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#42c8c6\"\n ],\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"\",\n \"padding-right\":\"50px\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"50px\"\n }\n },\n \"pk\":911\n },\n [\n [\n \"FramedIconPlugin\",\n {\n \"glossary\":{\n \"font_size\":\"10em\",\n \"color\":[\n \"\",\n \"#ffffff\"\n ],\n \"background_color\":[\n \"disabled\",\n \"#ffffff\"\n ],\n \"symbol\":\"wrench\",\n \"hide_plugin\":\"\",\n \"text_align\":\"text-center\",\n \"icon_font\":\"3\",\n \"border_radius\":\"\",\n \"border\":[\n \"0px\",\n \"none\",\n \"#000000\"\n ]\n },\n \"pk\":912\n },\n []\n ],\n [\n \"TextPlugin\",\n {\n \"body\":\"Quick Installs
\\n\\nLorem ipsum dolor sit amet conse ctetur adipisicing elit, sed do eiusmod tempor incididunt ut labore.
\",\n \"pk\":913\n },\n []\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"md-column-offset\":\"\",\n \"extra_inline_styles:line-height\":\"\",\n \"sm-column-offset\":\"\",\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"\",\n \"padding-right\":\"\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"\"\n },\n \"xs-column-width\":\"col-xs-4\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#f5b10e\"\n ],\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"sm-column-width\":\"\",\n \"md-responsive-utils\":\"\",\n \"lg-column-ordering\":\"\",\n \"sm-column-ordering\":\"\",\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"\"\n },\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"container_max_widths\":{\n \"xs\":220.0,\n \"lg\":360.0,\n \"sm\":220.0,\n \"md\":293.33\n },\n \"md-column-width\":\"\",\n \"xs-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"360px\"\n },\n \"extra_css_classes\":[],\n \"lg-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-ordering\":\"\",\n \"lg-column-width\":\"\"\n },\n \"pk\":918\n },\n [\n [\n \"SimpleWrapperPlugin\",\n {\n \"glossary\":{\n \"extra_inline_styles:line-height\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"360px\"\n },\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"\"\n },\n \"element_id\":\"\",\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"extra_css_classes\":[],\n \"tag_type\":\"div\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#f5b10e\"\n ],\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"\",\n \"padding-right\":\"50px\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"50px\"\n }\n },\n \"pk\":919\n },\n [\n [\n \"FramedIconPlugin\",\n {\n \"glossary\":{\n \"font_size\":\"10em\",\n \"color\":[\n \"\",\n \"#ffffff\"\n ],\n \"background_color\":[\n \"disabled\",\n \"#ffffff\"\n ],\n \"symbol\":\"cog-alt\",\n \"hide_plugin\":\"\",\n \"text_align\":\"text-center\",\n \"icon_font\":\"3\",\n \"border_radius\":\"\",\n \"border\":[\n \"0px\",\n \"none\",\n \"#000000\"\n ]\n },\n \"pk\":920\n },\n []\n ],\n [\n \"TextPlugin\",\n {\n \"body\":\"Customizable
\\n\\nLorem ipsum dolor sit amet conse ctetur adipisicing elit, sed do eiusmod tempor incididunt ut labore.
\",\n \"pk\":921\n },\n []\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"md-column-offset\":\"\",\n \"extra_inline_styles:line-height\":\"\",\n \"sm-column-offset\":\"\",\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"\",\n \"padding-right\":\"\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"\"\n },\n \"xs-column-width\":\"col-xs-4\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#56ba41\"\n ],\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"sm-column-width\":\"\",\n \"md-responsive-utils\":\"\",\n \"lg-column-ordering\":\"\",\n \"sm-column-ordering\":\"\",\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"\"\n },\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"container_max_widths\":{\n \"xs\":220.0,\n \"lg\":360.0,\n \"sm\":220.0,\n \"md\":293.33\n },\n \"md-column-width\":\"\",\n \"xs-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"360px\"\n },\n \"extra_css_classes\":[],\n \"lg-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-ordering\":\"\",\n \"lg-column-width\":\"\"\n },\n \"pk\":914\n },\n [\n [\n \"SimpleWrapperPlugin\",\n {\n \"glossary\":{\n \"extra_inline_styles:line-height\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"360px\"\n },\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"\"\n },\n \"element_id\":\"\",\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"extra_css_classes\":[],\n \"tag_type\":\"div\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#56ba41\"\n ],\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"\",\n \"padding-right\":\"50px\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"50px\"\n }\n },\n \"pk\":915\n },\n [\n [\n \"FramedIconPlugin\",\n {\n \"glossary\":{\n \"font_size\":\"10em\",\n \"color\":[\n \"\",\n \"#ffffff\"\n ],\n \"background_color\":[\n \"disabled\",\n \"#ffffff\"\n ],\n \"symbol\":\"bell-alt\",\n \"hide_plugin\":\"\",\n \"text_align\":\"text-center\",\n \"icon_font\":\"3\",\n \"border_radius\":\"\",\n \"border\":[\n \"0px\",\n \"none\",\n \"#000000\"\n ]\n },\n \"pk\":916\n },\n []\n ],\n [\n \"TextPlugin\",\n {\n \"body\":\"Support
\\n\\nLorem ipsum dolor sit amet conse ctetur adipisicing elit, sed do eiusmod tempor incididunt ut labore.
\",\n \"pk\":917\n },\n []\n ]\n ]\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapRowPlugin\",\n {\n \"glossary\":{\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Margins\":{\n \"margin-top\":\"20px\",\n \"margin-bottom\":\"\"\n }\n },\n \"pk\":929\n },\n [\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"container_max_widths\":{\n \"xs\":720.0,\n \"lg\":1140.0,\n \"sm\":720.0,\n \"md\":940.0\n },\n \"xs-column-width\":\"col-xs-12\"\n },\n \"pk\":930\n },\n [\n [\n \"CarouselPlugin\",\n {\n \"glossary\":{\n \"resize_options\":[\n \"upscale\",\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"container_max_heights\":{\n \"xs\":\"200px\",\n \"md\":\"300px\",\n \"sm\":\"250px\",\n \"lg\":\"350px\"\n },\n \"interval\":\"5\",\n \"hide_plugin\":\"\",\n \"options\":[\n \"slide\",\n \"pause\",\n \"wrap\"\n ]\n },\n \"pk\":931\n },\n [\n [\n \"CarouselSlidePlugin\",\n {\n \"glossary\":{\n \"resize_options\":[\n \"upscale\",\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"image\":{\n \"pk\":4,\n \"model\":\"filer.Image\"\n },\n \"image_title\":\"\",\n \"hide_plugin\":\"\",\n \"alt_tag\":\"\"\n },\n \"pk\":932\n },\n [\n [\n \"TextPlugin\",\n {\n \"body\":\"Hallo Welt!
\",\n \"pk\":933\n },\n []\n ]\n ]\n ],\n [\n \"CarouselSlidePlugin\",\n {\n \"glossary\":{\n \"resize_options\":[\n \"upscale\",\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"image\":{\n \"pk\":7,\n \"model\":\"filer.Image\"\n },\n \"image_title\":\"\",\n \"hide_plugin\":\"\",\n \"alt_tag\":\"\"\n },\n \"pk\":934\n },\n []\n ],\n [\n \"CarouselSlidePlugin\",\n {\n \"glossary\":{\n \"resize_options\":[\n \"upscale\",\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"image\":{\n \"pk\":6,\n \"model\":\"filer.Image\"\n },\n \"image_title\":\"\",\n \"hide_plugin\":\"\",\n \"alt_tag\":\"\"\n },\n \"pk\":935\n },\n []\n ]\n ]\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapRowPlugin\",\n {\n \"glossary\":{\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Margins\":{\n \"margin-top\":\"20px\",\n \"margin-bottom\":\"20px\"\n }\n },\n \"pk\":922\n },\n [\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"md-column-offset\":\"\",\n \"sm-column-width\":\"col-sm-6\",\n \"md-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-width\":\"\",\n \"hide_plugin\":\"\",\n \"sm-column-ordering\":\"\",\n \"sm-column-offset\":\"\",\n \"lg-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"xs-column-ordering\":\"\",\n \"xs-column-width\":\"col-xs-12\",\n \"lg-responsive-utils\":\"\",\n \"container_max_widths\":{\n \"xs\":720.0,\n \"lg\":555.0,\n \"sm\":345.0,\n \"md\":455.0\n },\n \"lg-column-width\":\"\",\n \"md-column-ordering\":\"\"\n },\n \"pk\":923\n },\n [\n [\n \"BootstrapImagePlugin\",\n {\n \"glossary\":{\n \"image_width_responsive\":\"100%\",\n \"target\":\"\",\n \"title\":\"\",\n \"image\":{\n \"pk\":12,\n \"model\":\"filer.Image\"\n },\n \"alt_tag\":\"\",\n \"hide_plugin\":\"\",\n \"image_width_fixed\":\"\",\n \"image_height\":\"\",\n \"link\":{\n \"type\":\"none\"\n },\n \"resize_options\":[\n \"upscale\",\n \"crop\",\n \"subject_location\",\n \"high_resolution\"\n ],\n \"image_title\":\"\",\n \"image_shapes\":[\n \"img-responsive\"\n ]\n },\n \"pk\":924\n },\n []\n ]\n ]\n ],\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"sm-responsive-utils\":\"\",\n \"xs-responsive-utils\":\"\",\n \"md-column-offset\":\"\",\n \"sm-column-width\":\"col-sm-6\",\n \"md-responsive-utils\":\"\",\n \"xs-column-offset\":\"\",\n \"md-column-width\":\"\",\n \"hide_plugin\":\"\",\n \"sm-column-ordering\":\"\",\n \"sm-column-offset\":\"\",\n \"lg-column-ordering\":\"\",\n \"lg-column-offset\":\"\",\n \"xs-column-ordering\":\"\",\n \"xs-column-width\":\"col-xs-12\",\n \"lg-responsive-utils\":\"\",\n \"container_max_widths\":{\n \"xs\":720.0,\n \"lg\":555.0,\n \"sm\":345.0,\n \"md\":455.0\n },\n \"lg-column-width\":\"\",\n \"md-column-ordering\":\"\"\n },\n \"pk\":925\n },\n [\n [\n \"SimpleWrapperPlugin\",\n {\n \"glossary\":{\n \"extra_inline_styles:line-height\":\"\",\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Heights\":{\n \"max-height\":\"\",\n \"min-height\":\"\",\n \"height\":\"370px\"\n },\n \"extra_inline_styles:Font Size\":{\n \"font-size\":\"130%\"\n },\n \"element_id\":\"\",\n \"extra_inline_styles:color\":[\n \"\",\n \"#ffffff\"\n ],\n \"extra_css_classes\":[],\n \"tag_type\":\"div\",\n \"extra_inline_styles:background-color\":[\n \"\",\n \"#ef3e42\"\n ],\n \"extra_inline_styles:Paddings\":{\n \"padding-top\":\"50px\",\n \"padding-right\":\"50px\",\n \"padding-bottom\":\"\",\n \"padding-left\":\"50px\"\n }\n },\n \"pk\":926\n },\n [\n [\n \"TextPlugin\",\n {\n \"body\":\"Let us make
\\na difference in your
\\nweb design
\\n\\nLorem ipsum dolor sit amet conse ctetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam.
\",\n \"pk\":927\n },\n []\n ],\n [\n \"BootstrapButtonPlugin\",\n {\n \"glossary\":{\n \"icon_align\":\"icon-right\",\n \"extra_inline_styles:Margins\":{\n \"margin-top\":\"20px\",\n \"margin-bottom\":\"\"\n },\n \"button_options\":[],\n \"button_size\":\"btn-lg\",\n \"quick_float\":\"pull-right\",\n \"hide_plugin\":\"\",\n \"icon_font\":\"3\",\n \"link_content\":\"Continue\",\n \"link\":{\n \"pk\":5,\n \"model\":\"cms.Page\",\n \"type\":\"cmspage\",\n \"section\":\"\"\n },\n \"button_type\":\"btn-default\",\n \"symbol\":\"right-open\"\n },\n \"pk\":928\n },\n []\n ]\n ]\n ]\n ]\n ]\n ]\n ],\n [\n \"BootstrapRowPlugin\",\n {\n \"glossary\":{\n \"hide_plugin\":\"\",\n \"extra_inline_styles:Margins\":{\n \"margin-top\":\"\",\n \"margin-bottom\":\"20px\"\n }\n },\n \"pk\":937\n },\n [\n [\n \"BootstrapColumnPlugin\",\n {\n \"glossary\":{\n \"container_max_widths\":{\n \"xs\":720.0,\n \"lg\":1140.0,\n \"sm\":720.0,\n \"md\":940.0\n },\n \"xs-column-width\":\"col-xs-12\"\n },\n \"pk\":938\n },\n [\n [\n \"LeafletPlugin\",\n {\n \"glossary\":{\n \"render_template\":\"cascade/plugins/leaflet.html\",\n \"map_position\":{\n \"lat\":47.27337658656428,\n \"lng\":11.399195194244387,\n \"zoom\":15\n },\n \"hide_plugin\":\"\",\n \"map_height\":\"400px\",\n \"map_width\":\"100%\"\n },\n \"pk\":939,\n \"inlines\":[\n {\n \"title\":\"Kirche St. Nikolaus\",\n \"image\":{\n \"pk\":15,\n \"model\":\"filer.Image\"\n },\n \"marker_width\":\"25px\",\n \"position\":{\n \"lat\":47.274337475394645,\n \"lng\":11.393036842346191\n },\n \"popup_text\":null,\n \"marker_anchor\":{\n \"top\":\"50%\",\n \"left\":\"50%\"\n }\n }\n ]\n },\n []\n ]\n ]\n ]\n ]\n ]\n ]\n ]\n ]\n}" }, { "path": "examples/bs4demo/bs4demo/static/bs4demo/css/_footer.scss", "content": "// include this file when using a static footer\n@import \"variables\";\n\nhtml {\n\tposition: relative;\n\tmin-height: 100%;\n}\n\nbody {\n\tmargin-bottom: $body-footer-height;\n}\n\n#footer {\n\tposition: absolute;\n\tbottom: 0;\n\twidth: 100%;\n\theight: $body-footer-height;\n\tcolor: $body-footer-color;\n\tbackground: $body-footer-bg;\n\tpadding-top: 20px;\n\tpadding-bottom: 20px;\n}\n" }, { "path": "examples/bs4demo/bs4demo/static/bs4demo/css/_variables.scss", "content": "@import \"bootstrap/scss/_functions\";\n@import \"bootstrap/scss/_variables\";\n@import \"bootstrap/scss/mixins/_breakpoints.scss\";\n\n// footer\n$body-footer-height: 200px;\n$body-footer-color: $yiq-text-light;\n$body-footer-bg: $dark;\n" }, { "path": "examples/bs4demo/bs4demo/static/bs4demo/css/badge.scss", "content": ".badge-ribbon {\n position: relative;\n background: lightgrey;\n font-size: 50px;\n height: 100px;\n width: 100px;\n -moz-border-radius: 50px;\n -webkit-border-radius: 50px;\n border-radius: 50px;\n text-align: center;\n padding-top: 12px;\n margin-bottom: 50px;\n &:before, &:after {\n content: '';\n position: absolute;\n border-bottom: 70px solid lightgrey;\n border-left: 40px solid transparent;\n border-right: 40px solid transparent;\n top: 90px;\n left: -10px;\n -webkit-transform: rotate(-150deg);\n -moz-transform: rotate(-150deg);\n -ms-transform: rotate(-150deg);\n -o-transform: rotate(-150deg);\n }\n &:after {\n left: auto;\n right: -10px;\n -webkit-transform: rotate(150deg);\n -moz-transform: rotate(150deg);\n -ms-transform: rotate(150deg);\n -o-transform: rotate(150deg);\n }\n}\n" }, { "path": "examples/bs4demo/bs4demo/static/bs4demo/css/main.scss", "content": "@import \"variables\";\n@import \"bootstrap/scss/bootstrap\";\n@import \"footer\";\n\nbody {\n\tbackground-color: #eee8e8;\n}\n" }, { "path": "examples/bs4demo/bs4demo/templates/bs4demo/badge.html", "content": "{% load sekizai_tags sass_tags %}\n{% addtoblock \"css\" %}{% endaddtoblock %}\n{% with inline_styles=instance.inline_styles %}\n{{ instance.glossary.content }}
\n{% endwith %}\n"
},
{
"path": "examples/bs4demo/bs4demo/templates/bs4demo/base.html",
"content": "{% load static cms_tags sekizai_tags %}\n\n\n\n\n\t