Metadata-Version: 2.0
Name: odoo9-addon-website-snippet-marginless-gallery
Version: 9.0.1.0.0.99.dev3
Summary: Add a snippet to have a marginless image gallery
Home-page: https://odoo-community.org/project/website-maintainers-79
Author: Grupo ESOC Ingeniería de Servicios, Tecnativa, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
License: LGPL-3
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Requires-Python: ~=2.7
Requires-Dist: odoo (<9.1a,>=9.0a)

.. image:: https://img.shields.io/badge/licence-LGPL--3-blue.svg
    :alt: License: LGPL-3

==========================
Marginless Gallery Snippet
==========================

This module extends the functionality of the website module to add a new
snippet that forms a marginless gallery and allow you to create a grid of
photos that have no spaces between themselves.

.. image:: ./images/marginless_gallery.png
   :alt: Marginless gallery

Usage
=====

To use this module, you need to:

* Edit any page in your website.
* Go to *Insert blocks > Features*.
* Drag the *Marginless Gallery* snippet anywhere in your page.
* Choose a fixed height for all your images. This is required to maintain a
  solid layout. Must be a number.

  * If you still do not want the fixed height (maybe because your theme
    applies it), just leave blank and press *Continue*.

To change images, you need to:

* Select any image block in the snippet you just created.
* Go to *Customize > Background* and choose any background you want.

  * Backgrounds will be centered and cover the whole element in any layout.

To change the images height, you need to:

* Select any block inside the snippet you just created.
* Go to the top parent.
* Go to *Customize > Change Images Height*.
* Input a number and press *Continue*.

To avoid trimming the images, you need to:

* Select any block inside the snippet you just created.
* Go to the top parent.
* Go to *Customize > Do not trim images*.

Known issues / Roadmap
======================

* If you do not set a fixed height to all your images in the snippet, it will
  get an ugly layout. Right now we manually set the height, but whenever
  Bootstrap 4 starts being used in Odoo with its flexbox support, this will not
  be needed anymore.

* Improve it using `Masonry <http://desandro.github.io/masonry/>`_ like the
  `Graphene theme  <https://theme-graphene.odoo.com/page/blocks>`_ does. It
  should allow to set arbitrary heights to images with a beautiful layout.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/website/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smashing it by providing a detailed and
welcomed feedback `here
<https://github.com/OCA/website/issues/new?body=module:%20website_snippet_marginless_gallery%0Aversion:%208.0.1.0.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Credits
=======

Contributors
------------

* Jairo Llopis <j.llopis@grupoesoc.es>

Maintainer
----------

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

To contribute to this module, please visit https://odoo-community.org.


