Package: kitconcept.volto
kitconcept.volto is a helper package to set up a Plone site to use with Volto. It
installs several convenience packages, Plone configurations and patches to prepare Plone
to be ready for support all the Volto features. Drop it in your buildout and then
install it. It is used in Volto development itself for testing it.If you want, take it as base of your own integration package.Usagehttps://github.com/plone/volto/blob/master/api/base.cfg#L13and along with plonesite recipe:https://github.com/plone/volto/blob/master/api/base.cfg#L13CompatibilityVolto requires specific versions of kitconcept.volto and plone.restapi:kitconcept.voltoplone.restapi1.x6.0.0 and below2.x7.0.0 and aboveplone.restapi 7.0.0 is included in Plone 5.3.4 (and later).You can still use 2.x in p.restapi 7.0.0 based installations but the transforms included won’t work.
Volto only supports the latest plone.restapi branch, therefore it is recommended to always use the latest version in your Volto projects.Featureskitconcept.volto provides the following features:Demo home page and Plone site blocks supportIt features a hack to make the Plone site Volto blocks-enabled with some demo
content. You can take only the hack to enable the blocks on your site.You can see it in action in the Volto demo:https://volto.kitconcept.comInstall the provided profile to install it by default:kitconcept.volto:default-homepagee.g. in your GSmetadata.xmlalong with your other dependencies:<metadata>
<version>1000</version>
<dependencies>
  <dependency>kitconcept.volto:default-homepage</dependency>
</dependencies>
</metadata>Volto Blocks SupportIt enables the Volto Blocks behavior on theDocumentcontent type by default, enabling Volto editor for that content type.Just use the same pattern to enable your own content types to have blocks.Document content typeRichtextandtable of contentsbehaviors has been removed from theDocumentbehaviors since it’s confusing for the users if they shows in the form. Both have been superseeded by blocks in the editor.CORS profileA quick helper for enable CORS for development config is also provided in thekitconcept.voltomodule. So you can call:<include package="kitconcept.volto.cors" />from your ZCML while developing.Enable it on demand, since it’s considered a security issue if you enable CORS in your
productions sites.It’s planned that Volto will feature a development pass-through proxy to the backend in
the future. It will be addressed in next sprints.ZLog patchp.restapi low level errors are routed through the ancient ZLog and areplone_errorenabled, making it difficult to follow since all are marked with a UUID. Specially if
using helpers like Sentry. This patch removes the UUID so the same error is categorized
all together. This is planned to be addressed in next sprints.Patch fix for PlonesubjectfieldThere are some problems of serialization on special characters derivated from how the
current shape of the Plone’s default Dexteritysubjectsfield that has to be
addressed in order to make it work properly with Volto (and other systems that are not
Plone). This will be fixed in core in upcoming sprints.Preview Image BehaviorThe preview image behavior makes content types provide a preview_image field that can store a preview image that Volto views can pick up.
This is especially userful for listings (e.g. listing block customizations) and teaser elements (e.g. teaser blocks such as [volto-blocks-grid](https://github.com/kitconcept/volto-blocks-grid)).The “volto.preview_image behavior can be enabled in the generic setup XML definition of a content type (e.g. “/profiles/default/types/MyContentType.xml”):<?xml version="1.0" encoding="UTF-8" ?>
<object i18n:domain="fzj.internet" meta_type="Dexterity FTI" name="MyContentType"
  xmlns:i18n="http://xml.zope.org/namespaces/i18n">

  ...

  <!-- Enabled behaviors -->
  <property name="behaviors" purge="false">
    ...
    <element value="volto.preview_image" />
  </property>
  ...
</object>Navigation Title BehaviorThe navigation title makes content types provide a nav_title field that is used by Volto in the main navigation, the breadcrumbs and the navigation portlet.The “volto.navtitle behavior can be enabled in the generic setup XML definition of a content type (e.g. “/profiles/default/types/MyContentType.xml”):<?xml version="1.0" encoding="UTF-8" ?>
<object i18n:domain="fzj.internet" meta_type="Dexterity FTI" name="MyContentType"
  xmlns:i18n="http://xml.zope.org/namespaces/i18n">

  ...

  <!-- Enabled behaviors -->
  <property name="behaviors" purge="false">
    ...
    <element value="volto.navtitle" />
  </property>
  ...
</object>Head Title BehaviorThe headtitle makes content types provide a headtitle field that can be used by Volto in teasers and alikes.The “volto.head_title” behavior can be enabled in the generic setup XML definition of a content type (e.g. “/profiles/default/types/MyContentType.xml”):<?xml version="1.0" encoding="UTF-8" ?>
<object i18n:domain="fzj.internet" meta_type="Dexterity FTI" name="MyContentType"
  xmlns:i18n="http://xml.zope.org/namespaces/i18n">

  ...

  <!-- Enabled behaviors -->
  <property name="behaviors" purge="false">
    ...
    <element value="volto.head_title" />
  </property>
  ...
</object>Volto blocks enabled LRFMultilingual support for LRF (Language Root Folders) is supported. Install PAM before
installing this package and demo homepages will be created in each enabled language.
Currently only support for EN/DE.Image ScalesThis package introduces new Plone image scales in Plone and redefines a couple of
existing ones. These are know to work well with Volto layout and grid system:icon 32:32
tile 64:64
thumb 128:128
mini 200:65536
preview 400:65536
teaser 600:65536
large 800:65536
larger 1000:65536
great 1200:65536
huge 1600:65536This change is opinionated and may collide with your previously defined ones, so make
sure your add-on’s profiles are applied AFTER this one.Versions compatibilitykitconcept.voltodemo is deprecated in favor of this package as of since March, 5th 2020.Contributorskitconcept GmbH,info@kitconcept.comChangelog2.5.3 (2021-09-13)Fix condition of the guard for the multilingual fixture in the docker image.
[sneridagh]2.5.2 (2021-09-13)Fix multilingual fixture for docker image, the guard seems not to work there, for some reason the blocks and blocks_layout are not set yet (?)
[sneridagh]2.5.1 (2021-09-12)More agnostic by simplify definition ofPlone Sitein GS profile. This fixes the error when applying it in Plone 6 with DX site root.
[sneridagh]2.5.0 (2021-09-12)Support pip-based Plone installation by explicitly including dependencies on configure.zcml
[ericof]Add Lock-Token to default CORS allow_headers
[avoinea]Add guard for not overwrite blocks in default home pages (if PAM enabled) if they are already set
[sneridagh]2.4.0 (2021-07-19)Fix German translation for “Navigation title” (“Navigation titel” -> “Navigationstitel”)
[timo]Fix and complete upgrade step from Volto 12 to Volto 13
[sneridagh]Add helper scripts
[sneridagh]Add preview_image to transforms
[sneridagh]Add headtitle behavior
[sneridagh]Guard for setuphandlers disablecontenttype
[sneridagh]Fix audit script
[sneridagh]Add support for subblocks in the custom transforms forvolto-blocks-grid[sneridagh]2.3.0 (2021-05-19)Add upgrade step facilityAdd upgrade step from Volto 12 to Volto 13
[sneridagh]2.2.1 (2021-04-21)Better multilingual profile
[sneridagh]2.2.0 (2021-04-21)Add multilingual test fixture for Cypress tests
[sneridagh]2.1.3 (2021-03-26)Addrequestsas dependency
[sneridagh]2.1.2 (2021-03-07)Add a demo home page for demo site
[sneridagh]2.1.1 (2021-03-06)Add demo site profile
[sneridagh]2.1.0 (2021-02-23)Remove Images and Files from types_use_view_action_in_listings since in Volto it’s no used at all.
[sneridagh]2.0.0 (2021-02-20)[Breaking] Define good known to work well with Volto image scales inregistry.xmlGenericSetup profile. When this add-on is installed or the profile is applied, it will
overwrite the existing scales in your Plone site. If you are using specific scales for
your project, make sure they are installed after this addon’s profile.This scales have been tested in real production projects and work well with Volto’s
layout and responsive viewports.
[timo, sneridagh]1.7.2 (2021-01-26)Nothing changed yet.1.7.1 (2021-01-25)Fix first level tabs and add nav_title to them
[sneridagh]1.7.0 (2021-01-21)Addbreadcrumbs_viewoverride to includenav_title[sneridagh]1.6.0 (2021-01-14)Added indexers forpreview_image, it allows the Volto object browser widget to access it
[sneridagh]1.5.2 (2020-12-14)Missing ZCML for translations
[sneridagh]1.5.1 (2020-12-14)Add zest.pocompile
[sneridagh]Add missing .mo
[sneridagh]1.5.0 (2020-12-09)Fix locales default in German
[sneridagh]1.4.0 (2020-07-29)Add volto.preview_image behavior to Page type.
[timo]1.3.2 (2020-05-17)Make sure that the enable_pam helper does its job.
[sneridagh]1.3.1 (2020-05-12)Fix LRF global allow and ensure default behaviors
[sneridagh]1.3.0 (2020-05-11)Add registry navigation setting for not show the current item in navigations
[sneridagh]New enable_pam setuphandlers helper
[sneridagh]New enable_pam_consistency setuphandlers helper
[sneridagh]1.2.0 (2020-04-17)Bring back the event type, since it’s fully working in Volto now
[sneridagh]fix typo in behavior namenavttitle->navtitle[sneridagh]1.1.0 (2020-03-10)Added a specific IImageScaleFactory forImagecontent type, to fix SVG handling
[sneridagh]1.0.1 (2020-03-08)Update version numbers in default home page.
[sneridagh]1.0.0 (2020-03-06)Add Zope log patch
[sneridagh]Add nav_title and preview_image behaviors
[sneridagh]override plone.app.vocabularies.Keywords with a version that
uses the unencode subject value as the token.
[csenger]Remove versioning behavior from Document type.
[timo]Backport all features that were in kitconcept.voltodemo
[sneridagh]Patch Password reset tool in Products.CMFPlone to use the optional volto_domain in the
e-email which is sent to users, only if the request is made through REST.
[fredvd]Add Volto settings control panel with frontend_domain field.
[fredvd]Homepage profile for demo purposes
[sneridagh]CORS profile
[sneridagh]Enable Volto Blocks for Document and LRF
[sneridagh]Initial release.
[kitconcept]