Metadata-Version: 2.2
Name: collective.behavior.relatedmedia
Version: 3.6.7
Summary: Adds Various configuration fields and viewlets to manage and show content related images and attachments
Home-page: https://github.com/kombinat/collective.behavior.relatedmedia
Author: petschki
Author-email: peter.mathis@kombinat.at
License: gpl
Keywords: plone richmedia relatedmedia
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Plone :: 6.0
Classifier: Framework :: Plone :: Addon
Classifier: Framework :: Plone
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: setuptools
Requires-Dist: plone.api
Requires-Dist: plone.behavior
Requires-Dist: plone.app.dexterity
Requires-Dist: Products.CMFCore
Requires-Dist: z3c.form
Provides-Extra: test
Requires-Dist: plone.app.testing[robot]; extra == "test"
Requires-Dist: plone.app.robotframework; extra == "test"
Requires-Dist: plone.app.contenttypes; extra == "test"
Requires-Dist: robotframework-selenium2library; extra == "test"
Requires-Dist: robotframework-selenium2screenshots; extra == "test"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: provides-extra
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary


# Upload and Manage Related Images and Attachments


This packages adds a dexterity behavior to upload and manage related images and attachments for rich media pages.


## Install

Add to buildout configuration or ``pip install collective.behavior.relatedmedia``.

Enable it in Plone Add-on controlpanel.


## Configure

There is a ``Related Media Settings`` controlpanel in the Add-on configuration section.

Make sure you set a valid ``Media Container`` path where all the media is stored.


## Edit

When you edit a Page go to the tab ``Related Media``.

In the relateditems widgets you can select existing content from your page, or you upload
new content via the uploader. Relation type is selected via the mimetype of the media.
You can change the titles of the relations in an input field and rearrange the order
within the widget via drag/drop.


## View

The related media viewlets (image, attachment) are defined by:

- ``collective.behavior.related_images`` -> plone.belowcontenttitle
- ``collective.behavior.related_attachments`` -> plone.belowcontentbody


Feel free to override the placement in your package zcml for example::

    <include package="collective.behavior.relatedmedia" />
    <configure package="collective.behavior.relatedmedia">
        <browser:viewlet
            name="collective.behavior.related_images"
            for="*"
            manager="plone.app.layout.viewlets.interfaces.IAboveContentTitle"
            template="widget_images_display.pt"
            permission="zope2.View" />
    </configure>

## TinyMCE Template

We provide a TinyMCE toolbar icon to enable gallery placement inside the richtext editor::

- create a new paragraph in your text where you want to place the gallery.
- Click on the Gallery Icon in the toolbar
- Choose the images you want inside your gallery. You can drag/drop reorder the images too.
- Edit an existing gallery by clicking inside the preview block and click the toolbar icon again.

NOTES:

- make sure you disable the checkbox "Show images in viewlet" to prevent double rendered gallery.
- When you add related images after you've inserted a gallery in TinyMCE you need to edit it again
  and add the new images manually.


## Author

- Peter Mathis [petschki]


## Contributors

- Peter Holzer [agitator]


Changelog
=========


## 3.6.7 (2025-03-11)


- Refactor default settings value lookup.
  [petschki]


## 3.6.6 (2024-11-13)


- Configurable large overlay images scale
  [petschki]


## 3.6.5 (2024-10-28)


- Inject slickSliderOptions via data-attributes.
  [petschki]


## 3.6.4 (2024-10-28)


- Fix Fancybox initialization problems.
  [petschki]


## 3.6.3 (2024-10-25)


- Initialize "slick-slider" automatically inside TinyMCE image gallery.
  [petschki]


## 3.6.2 (2024-06-14)


- Fix broken attachments.
  [petschki]


## 3.6.1 (2024-06-14)

- Hide image/attachment viewlet when no content available.
  [petschki]
- update JS resources.
  [petschki]

## 3.6.0 (2024-05-14)

- Enhanced Attachment viewlet.
  [petschki]


## 3.5.4 (2024-04-08)

- Fixed upgrade step for TinyMCE gallery tool.
  Cleanup settings for old template.
  [petschki]


## 3.5.3 (2024-03-22)

- Fixed upgrade step for migrating "base_path" relations.
  [petschki]


## 3.5.2 (2024-02-29)

- Remove old obsolete JS resource from upload viewlet.
  [petschki]


## 3.5.1 (2024-02-27)

- packaging updates.
  [petschki]


## 3.5.0 (2024-02-27)

Features:

- New gallery editor plugin for TinyMCE replacing the gallery template and adds
  possibility to select/reorder gallery images inside TinyMCE.
  [petschki]


## 3.4.0 (2024-01-25)

Features:

- Outputfilter and pattern for related image gallery.
- TinyMCE template for gallery placement inside richtext.
  [petschki]


## 3.3.5 (2023-11-16)

- Do not fail in update script when broken catalog brains exists.
  [petschki]


## 3.3.4 (2023-10-09)

- Fix syncing review_state of (deprecated) related media container.
  [petschki]


## 3.3.3 (2023-09-27)

- Fix error when invalid attachment is uploaded.
  [petschki]


## 3.3.2 (2023-09-21)

- Added upgrade tep for renamed behavior.
  [petschki]


## 3.3.1 (2023-07-19)

- Fix default behavior assignment for "Page".
  [petschki]


## 3.3.0 (2023-07-17)
------------------

Feature:

- Mark `base_path` concept as deprecated and add a migration script for it.
  [petschki]

- Convenience short name for behavior.
  [petschki]

- Use `plone.base.utils.human_readable_size` for attachment size and implement
  mimetype icons for attachment list.
  [petschki]


3.2.0 (2022-07-20)
------------------

- Fixed customized `selection.xml` template for `pat-relateditems`.
  [petschki]

- CI Test setup with `mxdev`.
  [petschki]

- Remove `related-media` widget and enable "upload" for related widget.
  [petschki]


3.1.1 (2022-07-04)
------------------

- Fix moved utility. import now from `plone.base`
  [petschki]


3.1.0 (2022-04-23)
------------------

- remove requireJS from JS resource (Plone 6 compatibility)
  [petschki]


3.0.4 (2022-03-16)
------------------

- Add browserlayer for viewlets. (fixes #7)
  [petschki]


3.0.3 (2022-03-14)
------------------

- Fix related media container utility permissions
  [petschki]


3.0.2 (2022-03-09)
------------------

- Fix bug in memoized utility
  [petschki]


3.0.1 (2022-03-09)
------------------

- Fix adding leadimage to the gallery
- Fix media container determination when in language independent Assets
  [petschki]


3.0.0 (2022-01-18)
------------------

Breaking changes:

- 3.x is Plone6/py3 only version. Use 2.x for Plone5/py2/3 compatibility
  [petschki]

- Change strategy for optional media base_path container creation. This is a registry setting.
- inline title editing for related items
- Plone6 / Classic Theme updates
  [petschki]


2.1.3 (2020-07-22)
------------------

- Fix bug in util method when related base_path is missing. fixes #2
  [petschki]


2.1.2 (2020-07-02)
------------------

- Fix issue with unauthorized media folder
  [petschki]

- Update/enhance default settings in controlpanel
  [petschki]

- bugfix in workflow synchronization of related media base path
  [petschki]


2.1.1 (2020-05-27)
------------------

- Fix imports to support ``plone.app.contenttypes`` < 2.0
  [petschki]


2.1 (2020-05-27)
----------------

Features:

- global setting to always update first related image as leadimage.
  This is disabled per default.
  [petschki]


2.0.3 (2020-05-26)
------------------

- fix attachment viewlet to be hidden when no files are related
  [petschki]


2.0.2 (2019-12-13)
------------------

- Fix bug in workflow sync event when pasting objects
  [petschki]


2.0.1 (2019-11-22)
------------------

- merged HISTORY.txt and CHANGES.rst
  [petschki]


2.0.0 (2019-11-22)
------------------

- Python 3 / Plone 5.2 compatibility
  [petschki]

- Media Base Path feature
  [petschki]

- test setup and CI
  [petschki]

1.1.1 (2018-05-25)
------------------

- Update documentation.
  [petschki]


1.1 (2018-05-25)
----------------

- fix image_size vocabulary. Plone 5 compatibility.
  [petschki]


1.0 (2018-05-23)
----------------

- Fix issue with disappearing images when 'include_leadimage' was deactivated
  [petschki]

- support for Event Occurrences.
  [petschki]

- add markup for fancybox library
  [petschki]

- Separate viewlet caption and overlay caption
  [petschki]


1.0b1 (2015-07-15)
------------------

- title caption toggle for gallery images
  [petschki]


1.0a1 (2015-07-14)
------------------

- Initial release
