mirror of
https://github.com/OCA/web.git
synced 2025-02-22 13:21:25 +02:00
d59af25db3
* Add local slick files to use instead of CDN
* Override CSS to display widget correctly
* Adjust arrow button size/placement
* Bump version
* Rename __openerp__.py -> __manifest__.py
* Rename widget_slick.js -> web_widget_slick.js
* Update copyright, license (AGPL -> LGPL)
* Update readme
* Correct eslint errors
* Change module name in various places for consistency
* Improve styling of widget arrows, dots
* Change css -> less
* Remove unneeded slick files
* Copyright 2017 -> 2016-2017
* Add OCA to authors
* Use OCA icon
* Fix readme
* Clean up assets
* Fix file permissions
* Update readme with reference to example module
* Fix formatting error, incorrect link
* Add javascript tests
* Add note to readme about functional testing with example module
* Fix/cleanup javascript
* Fix destroy_content() method
* Move slide navigation out of slide addition loop
* Remove unused variables
* Remove unneeded DOM append
* Reorganize files/directories
* Adjust template tags (templates -> template)
* Add slick-field class to field template instead of using jQuery
* Misc cleanup
* Adjust breakpoint settings to show fewer images by default
* Enable adaptiveHeight by default
* Add .img and .img-responsive classes to images
* Fix dragging issues by preventing default mousedown and
touchstart event behavior
* Set swipeToSlide default to true
* Change how slick slides are populated to allow grid mode
* Fix issue causing carousel images to display improperly in some
situations
* Add better functional testing instructions to readme
* Add roadmap to readme
* Make minor styling changes
* Fix issue with template loading w/ PhantomJS
* Clean up template, use css class provided by widget
* Remove unneeded dependency from tests
* Break up render_value method
* Break up destroy_content method
* Add unslicking to destroy_content, add test
* Clean up qweb template formatting
* Fix indentation
* Change widget name
* Add Slick copyright information
* Add padding left/right, move arrows in to avoid clipping when
widget not in a sheet tag
* Apply dot and arrow styles only when needed
* Add _resizeCarousel() and related methods to ensure accurate
carousel sizing in various views
* Resize carousel on core.bus resize
* Account for differences in group layouts and labels,
sheet/no-sheet layouts
* Adjust, clean up less
* Clean up js
115 lines
4.8 KiB
ReStructuredText
Executable File
115 lines
4.8 KiB
ReStructuredText
Executable File
.. image:: https://img.shields.io/badge/license-LGPL--3-blue.svg
|
|
:target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
|
|
:alt: License: LGPL-3
|
|
|
|
=====================
|
|
Slick Carousel Widget
|
|
=====================
|
|
|
|
This module provides a Slick Carousel widget for use in the Odoo backend web interface.
|
|
|
|
Usage
|
|
=====
|
|
|
|
Default usage is on a One2many attachment field, as defined below::
|
|
|
|
class SlickExample(models.Model):
|
|
_name = 'slick.example'
|
|
_description = 'Slick Example Model'
|
|
image_ids = fields.One2many(
|
|
name='Images',
|
|
comodel_name='ir.attachment',
|
|
inverse_name='res_id',
|
|
)
|
|
|
|
Assuming the above model, you would add a Slick Carousel on the
|
|
``image_ids`` column by using the following field definition in the
|
|
model's form view::
|
|
|
|
<field name="image_ids" widget="one2many_slick_images" options="{}"/>
|
|
|
|
Options
|
|
-------
|
|
|
|
The widget passes options directly through to Slick, so any `setting
|
|
available to Slick`_ is available to the widget. Additional options
|
|
specific to Odoo are:
|
|
|
|
+-----------------+--------------+---------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| Name | Type | Default | Description |
|
|
+=================+==============+=====================+=============================================================================================================================================================================+
|
|
| ``fieldName`` | ``String`` | ``datas`` | Field to lookup on relation table. Defaults to ``datas``, which is the data field used in ``ir.attachment`` table. This would be used to define a custom attachment model |
|
|
+-----------------+--------------+---------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| ``modelName`` | ``String`` | ``ir.attachment`` | Model of attachment relation. This would be used to define a custom attachment model instead of default ``ir.attachment`` |
|
|
+-----------------+--------------+---------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
.. _setting available to Slick: http://kenwheeler.github.io/slick/#settings
|
|
|
|
Example Module
|
|
--------------
|
|
|
|
An example implementation, for instructional purposes as well as convenient
|
|
functional testing, is provided in the `web_widget_slick_example` module.
|
|
|
|
* Install `web_widget_slick_example`.
|
|
* Activate Developer Mode.
|
|
* Go to Settings / Technical / Slick, and open the record to view the widget.
|
|
|
|
To try out different Slick settings:
|
|
|
|
* Go to Settings/User Interface/Views and search for 'slick.example.view.form'.
|
|
* Open the form view record.
|
|
* Click the Edit button.
|
|
* In the Architecture editor, find `options="{'slidesToShow': 2}`, and add
|
|
any desired settings (separated by commas) inside the curly braces.
|
|
* Save the changes and browse to the widget, as described above, to see the
|
|
widget with the new settings in effect.
|
|
|
|
.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
|
|
:alt: Try me on Runbot
|
|
:target: https://runbot.odoo-community.org/runbot/162/10.0
|
|
|
|
Known issues / Roadmap
|
|
======================
|
|
|
|
* Adding / Deleting images from a carousel is not currently supported.
|
|
|
|
Bug Tracker
|
|
===========
|
|
|
|
Bugs are tracked on `GitHub Issues
|
|
<https://github.com/OCA/web/issues>`_. In case of trouble, please
|
|
check there if your issue has already been reported. If you spotted it first,
|
|
help us smash it by providing detailed and welcomed feedback.
|
|
|
|
Credits
|
|
=======
|
|
|
|
Images
|
|
------
|
|
|
|
* Odoo Community Association: `Icon <https://github.com/OCA/maintainer-tools/blob/master/template/module/static/description/icon.svg>`_.
|
|
|
|
Contributors
|
|
------------
|
|
|
|
* Dave Lasley <dave@laslabs.com>
|
|
* Brent Hughes <brent.hughes@laslabs.com>
|
|
|
|
Do not contact contributors directly about support or help with technical issues.
|
|
|
|
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.
|