{ "info": { "author": "Lee Solway", "author_email": "lee@digitalanvil.co.uk", "bugtrack_url": null, "classifiers": [ "Development Status :: 2 - Pre-Alpha", "Framework :: Django", "Intended Audience :: Developers", "License :: OSI Approved :: BSD License", "Natural Language :: English", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7" ], "description": "djangocms-masonry\n=================\n\n**djangocms-masonry** is a reuseable plugin for `django-cms` that\nimplements the JavaScript Masonry library.\n\nDependencies\n------------\n\n- Djangocms>=3.0\n- Django>=1.6\n\nInstallation\n------------\n\nInstall djangocms-masonry from Pypi.\n\n.. code:: python\n\n pip install djangocms-masonry\n\nAdd Djangocms\\_masonry to INSTALLED\\_APPS\n\n.. code:: python\n\n INSTALLED_APPS = (\n ...\n 'djangocms_masonry',\n ...\n )\n\nDjango 1.6 and/or South users will need to add the following to ensure\nmigration compatibility.\n\n.. code:: python\n\n SOUTH_MIGRATION_MODULES = {\n ...\n 'djangocms_masonry': 'djangocms_masonry.south_migrations',\n ...\n }\n\nConfiguration\n-------------\n\nCSS classes can be added to the plugin via a select box by using the\n**DJANGOCMS\\_MASONRY\\_STYLES** settings tuple.\n\n.. code:: python\n\n DJANGOCMS_MASONRY_STYLES = (\n ('style1', 'Style 1'),\n ('style2', 'Style 2'),\n )\n\ndjangocms\\_masonry/default.html is rendered by default. The user can select\ncustom templates if the following tuple is set as the example below\ndemonstrates.\n\n.. code:: python\n\n DJANGOCMS_MASONRY_TEMPLATES = (\n ('template1', 'Template 1'),\n ('template2', 'Template 2'),\n )\n\n\nRestrict the plugins available to Masonry Carousel\n\n.. code:: python\n\n DJANGOCMS_MASONRY_CHILD_CLASSES = (\n 'PicturePlugin',\n )\n\nInclude or exclude static files\n\n.. code:: python\n\n DJANGOCMS_MASONRY_INCLUDE_JS_MASONRY = True\n\n\nTemplates\n---------\n\nbase.html includes all the JavaScript and CSS needed to run the masonry plugin, but it does not render the HTML.\nCustom templates can extend base.html as long as they define a plugin block containing the html and plugin render code as show in the below example.\n\n.. code:: html\n\n {% extends 'djangocms_masonry/base.html' %}\n {% load cms_tags %}\n\n {% block plugin %}\n