Package: redturtle.volto
This is an helper package that setup a RedTurtle’s Plone site ready to work with Volto.FeaturesContent-typesNews Item and Event can only containLinks,ImagesandFilesBlocksvolto.blocksbehavior is enabled by default for these content-types:DocumentNews ItemEventThere are also some adapters registered forIBlockSearchableTextto index some common blocks.LinksThere is a custom adapter for TextLine field that return the proper widget forremoteUrl.Custom blocks transformersThere are custom transformers for serializer and deserializer to better manage resolveuids.If a block refers to some internal content, on deserialization we only store its UID, and in serialization
we “expand” informations with the summary-serialized content.@context-navigation endpointplone.restapi’s@navigationendpoint always return the navigation tree from the site root.There is a@context-navigationendpoint that returns the contextual navigation tree:> curl -ihttp://localhost:8080/Plone/folder?context-navigation-H ‘Accept: application/json’This is the result:{
    '@id': 'http://localhost:8080/Plone/folder',
    'items': [
        {'@id': 'http://localhost:8080/Plone/folder/folder-a',
            'description': '',
            'title': 'Folder A'},
        {'@id': 'http://localhost:8080/Plone/folder/folder-b',
            'description': '',
            'title': 'Folder B'},
        {'@id': 'http://localhost:8080/Plone/folder/folder-c',
            'description': '',
            'title': 'Folder C'}
    ]
}By default only first level is shown.
You can pass anexpand.navigation.depthparameter to set the depth:> curl -i http://localhost:8080/Plone/folder?context-navigation?expand.navigation.depth=2 -H 'Accept: application/json'And this is the result:{
    '@id': 'http://localhost:8080/Plone/folder',
    'items': [
        {
            '@id': 'http://localhost:8080/Plone/folder/folder-a',
            'description': '',
            'items': [
                {
                    '@id': 'http://localhost:8080/Plone/folder/folder-a/folder-aa',
                    'description': '',
                    'title': 'Folder AA',
                },
                {
                    '@id': 'http://localhost:8080/Plone/folder/folder-a/folder-ab',
                    'description': '',
                    'title': 'Folder AB',
                },
            ],
            'title': 'Folder A',
        },
        {
            '@id': 'http://localhost:8080/Plone/folder/folder-b',
            'description': '',
            'title': 'Folder B',
        },
        {
            '@id': 'http://localhost:8080/Plone/folder/folder-c',
            'description': '',
            'title': 'Folder C',
        },
    ],
}@site-search endpointThis endpoint works exactly like@searchbut take care of types not searchable settings.@sitemap-settingsEndpoint that returns sitemap settings for anonymous users (that can’t access registry entries).Returns a data structure like this:{
    'depth': 3,
}@search endpointWe customized @search endpoint for that bug:https://github.com/plone/plone.restapi/pull/1066@querystring-search endpoint customizationIf we are searching only forEventtypes, do a special search usingget_eventsmethod to search events: that method handle recurrences and avoid wrong results.Otherwise, perform a default querystring-search.Disallow bot indexingThere is a custom viewlet that add a <meta> tag in the <head> section to prevent bot indexing.For reference:https://developers.google.com/search/docs/advanced/crawling/block-indexing?visit_id=637489966041845317-1328107746&rd=1Restapi Search LimitsSearch results length is limited to 500 items by default, but you can change this limit
using the environment variableREDTURTLE_VOLTO_MAX_LIMIT_SEARCHPatchesProducts.PortalTransformsSeehttps://github.com/plone/Products.PortalTransforms/pull/43There is a monkeypatch to apply that changes.Events recurrenceThere is a monkeypatch for Events recurrences that fix their duration.If it works well, we can make a pr in p.a.event.There is another monkeypatch for Events recurrences to change the default behavior of start index serializer.
Now it keeps all dates even if the single date is already passed.Respect locally allowed types on pasteDisallow paste items that are not allowed into destination folder.DateTime field serializer/deserializerCustomized these adapters to correctly set effective and expires dates.Without this change, these dates will be stored with UTC hour and not with the current timezone’s hour
because behavior’ssetter/getterstrip timezone from the value.With this patch we will send to the setter the date with already localized hour, so even if the setter strip timezone info, we are going to save the correct date.Default ISerializeToJsonSummary adapterThis is a patch for backward compatibility for old volto templates that need a full image scales object.Authentication HeaderThere is a custom event handler for IPubStart that set authorization bearer header from auth_token cookie.
For details see thepull-request.This patch is not enabled by default. You need to set an environment variable totrue:PROXY_BEARER_AUTH.Conditionally search for similar if nonexistent site path passedplone.app.redirector.FourOhFourView.search_for_similar method patched to return an empty list if
theREDTURTLE_VOLTO_ENABLE_SEARCH_FOR_SIMILARenvironment variable is set.New CriteriaThere is one new criteria for Collections and Listing blocks that search onexclude_from_navindex.Caching controlpanelAfter installation the caching control panel is populated with custom policies while caching is globally enabled by default. Please, set the caching proxies properly.@vocabularies permissionsAccording to new plone.restapi implementation, @vocabularies endpoint will check some permissions to make a vocabulary available or not.We patched PERMISSIONS variable in __init__ file to allow Keywords vocabulary to be available for anonymous users.Reference:https://github.com/plone/plone.restapi/pull/1258#issuecomment-980628982RamCache in tersecachingWe disabled ramcache for tersecaching (plone.app.caching.terseCaching.plone.content.dynamic.ramCache) because
it seems not correctly purged when there are more instances and a content has been modified.We need to check why it’s not purged and fix it.Template overridesRSS.pt TemplateThere is a customization of the Products.CMFPlone.browser.syndication.templates.RSS.pt
template to add enclosure tag to feed items.
A record has also been added to the registry to be able to set the miniature to be
displayed with the RSS item. This record is named redturtle.volto.rss_image_miniatureFix internal linksThere is a view@@fix-linksthat will check internal links into blocks and fix some links that refs to a staging
or local development environment.Find blocksThere is a view@@find-blocksthat will return contents that have at least one block of the given type.Stringinterp adaptersThere is a new stringinterp adapter that can be used for example in content rules:{volto_url}This adapter will remove “/api” from the content’s absolute_url.Sitemap.xml.gz view customizationThere is a custom viewsitemap.xml.gzthat will return a sitemap.xml.gz file.This is a copy of the original view from plone.app.layout.sitemap.sitemapThe only difference is that:we restrict level of depth toplone.sitemap_depthregistry setting (default 3)we add content modified in the last weekWith Volto, for serve this file, we need to add a line like this in apache config:RewriteRule ^/+(sitemap.xml.gz) http://127.0.0.1:8080/VirtualHostBase/https/%{SERVER_NAME}:443/Plone/VirtualHostRoot/$1 [L,P]InstallationInstall redturtle.volto by adding it to your buildout:[buildout]

...

eggs =
    redturtle.voltoand then runningbin/buildoutContributeIssue Tracker:https://github.com/RedTurtle/redturtle.volto/issuesSource Code:https://github.com/RedTurtle/redturtle.voltoLicenseThe project is licensed under the GPLv2.AuthorsThis product was developed byRedTurtle Technologyteam.ContributorsRedTurtle Technology,sviluppo@redturtle.itChangelog5.4.4 (2024-02-20)Add adapters for link integrity for content-types with BlocksField fields.
[cekk]Fix: occurrences indexing
[mamico]5.4.3 (2024-01-30)Upgrade step to remove all custom Googlebot rules from robots.txt
[mamico]Fix: add range_start to function for calculate recurrences in the right way
[eikichi18]5.4.2 (2024-01-11)Fix deserializer for relationfield, add lstrip to path object calculation
[eikichi18]5.4.1 (2023-12-28)Fix deserializer for relationfield, use UID instead of @id
[eikichi18]Isort
[folix-01]Add monkeypatch to fix @scadeziario-day endpoint
[eikichi18]5.4.0 (2023-11-14)Return error instead of raise Excpetion for BadRequest in querystringsearch
[mamico]Add upgrade step and setuphandler to fix robots.txt
original rules adding ‘Allow: /?expand’
[lucabel]5.3.0 (2023-10-25)Fix: the ‘fix-link’ view has a bug that corrupts links by replacing
the current external URL with a URL that is always relative to the
site, even when requesting replacement with a link from a different
website.
[lucabel].plone.app.redirector.FourOhFourView.search_for_similar patch to enable conditionally
the search for similar
[folix-01]Set search/querystring-search limit patch only for anonymous users.
Auth users can need to perform an higher query (in contents view for example).
[cekk]Re-apply context UID filter in querystringsearch service (as it is in plone.restapi).
[cekk]5.2.4 (2023-09-26)Fix the issue in the @translation GET endpoint: If this
endpoint is invoked, possibly by a bot, and plone.app.multilingual
is not installed, the call will result in an empty search query
on the catalog.
[lucabel]backporthttps://github.com/plone/Products.CMFPlone/pull/3845fix: avoid searching all users when many_users is flagged
[mamico]5.2.3 (2023-09-21)Max search limit became configurable by env var ‘REDTURTLE_VOLTO_MAX_LIMIT_SEARCH’, 500 by default.
[folix-01]5.2.2 (2023-08-29)Fix RESOLVEUID_RE regexp.
[cekk]5.2.1 (2023-08-29)Use plone.volto uid_to_url method to convert resolveuid links in summary.
[cekk]Patch plone.restapi RESOLVEUID_RE regexp to catch more urls.
[cekk]Ignore non-existing indexes in custom ranking.
[cekk]5.2.0 (2023-08-21)Add catalog and search patches to limit results.
[cekk]5.1.0 (2023-08-17)set authorization bearer header from auth_token cookie
[mamico]Remove Patch to avoid auto-closed tags in portal transforms:https://github.com/plone/Products.PortalTransforms/pull/43[mamico]Remove Patch for folderish types migrationhttps://github.com/plone/plone.volto/pull/86[mamico]5.0.1 (2023-07-04)Custom portal url in @@fix-links
[mamico]5.0.0 (2023-04-04)Remove unused default text in homepage.
[cekk]5.0.0rc1 (2023-03-20)Plone 6.0 supportHandle custom search ranking with AdvancedQuery.
[mamico]Add controlpanel for redturtle.volto settings.
[cekk]4.1.3 (2023-02-12)sitemap.xml.gz customization.
[mamico]4.1.2 (2022-12-27)Customized voltobackendwarning viewlet because is broken in plone 5.2.
[cekk]4.1.1 (2022-12-23)Upgrade-step to remove etags list from p.a.caching terseCaching (in old Plone sites).
[cekk]4.1.0 (2022-11-22)Add new utility view@@find-blocks.
[cekk]4.0.2 (2022-08-29)Patch for plone.volto upgrade-step (https://github.com/plone/plone.volto/pull/86).
[cekk]4.0.1 (2022-08-12)Fix upgrade-step.
[cekk]Allow add Document into News Item and Event.
[cekk]4.0.0 (2022-08-12)Remove content-types customizations to be aligned with plone.volto configs.
[cekk]3.12.2 (2022-05-19)Addqueryto ignored keys in blocks deserializer. This avoid blocks with querystringsearch widget to be parsed (for example the search one).
[cekk]3.12.1 (2022-05-19)Add string interp for volto_parent_url.
[eikichi18]3.12.0 (2022-04-04)Add new metadata for Events dates.
[cekk]3.11.0 (2022-04-01)Add stringinterp adapter to replace{volto_url}with the current frontend url (backend url without “/api”).
[cekk]3.10.0 (2022-03-26)Add Table block serializer/deserializer for internal links.
[cekk]Add view for fix internal links.
[cekk]3.9.2 (2022-03-25)Fix remoteUrl serialization in summary.
[cekk]3.9.1 (2022-03-17)Refs serialization in blocks now uses brains instead adapted objects because brain has all catalog metadata and can get the fullobject.
[cekk]3.9.0 (2022-03-14)Allow to select custom miniature for RSS template
[lucabel]Better serialize refs in blocks: now we don’t serialize the full object, but only the summary (with all metadata) to decrease (A LOT) the size of the response.
[cekk]3.8.3 (2022-03-07)Fix null dates in summary serialization (now we handle differente use-cases).
[cekk]Return remoteUrl metadata when serializing a brain for backward compatibility with non-brain serializers.
[cekk]3.8.2 (2022-02-07)Handle non-path values in blocks deserializer when trying to extract UIDs.
[cekk]3.8.1 (2022-01-31)Return null value in summary serialization for dates not set (because metadata are set with dates in the future or past for better filtering/sorting).
[cekk]3.8.0 (2022-01-26)Customized json summary serializer to expose image scales when requested _all metadata_fields without waking up the object.
[cekk]3.7.3 (2021-12-27)Upgrade-step to add default blocks in pages that don’t have them.
[cekk]3.7.2 (2021-12-02)Customized ZCTextIndexQueryParser forhttps://github.com/plone/plone.restapi/pull/1209.
[cekk]3.7.1 (2021-12-01)Upgrade-step to reindex SearchableText for all contents with a table block (change in plone.restapi 8.16.1).
[cekk]3.7.0 (2021-12-01)Remove enabled_vocabularies implementation because in recent plone.restapi (>8.15.2) there is a standard way.
[cekk]3.6.2 (2021-11-09)Bypass plone.volto serialization for blocks right now (in monkeypatch.py).
[cekk]3.6.1 (2021-11-05)Fix upgrade-step for plone.volto.
[cekk]3.6.0 (2021-10-28)Add plone.volto dependency
[cekk]3.5.0 (2021-10-11)p.a.caching rules for rest api services
[mamico]3.4.2 (2021-10-01)Fix tests.
[cekk]3.4.1 (2021-09-30)Disable ramcache from tersecaching (to fix the problem with cache invalidation for balanced instances..see README).
[cekk]3.4.0 (2021-09-29)Better handle events searches.
[cekk]3.3.0 (2021-09-21)Index text from some common blocks.
[cekk]Fix date timezones in fields.
[cekk]3.2.2 (2021-08-24)Customize serializer/deserializer for DateTime fields to correctly set effective and expires with right timezone delta.
[cekk]Enable Anonymous to access Plone vocabularies with restapi.@vocabulariesendpoint has been customized to limit the vocabularies that anonymous can actually access.
[cekk]3.2.1 (2021-08-04)Remove customized @workflow endpoint. Is now merged in plone.restapi >= 8.7.1.
[cekk]3.2.0 (2021-08-02)Customize @workflow endpoint for plone.restapi #1184 and #1190 pr.
[cekk]Remove default cache proxy address on install.
[cekk]3.1.3 (2021-06-30)Fix b_size conversion in upgrade-step for Volto 13.
[cekk]3.1.2 (2021-06-18)Fix also linkMore in volto13 migration.
[cekk]3.1.1 (2021-06-17)Handle contents with old Richtext values in volto13 migration.
[cekk]3.1.0 (2021-06-17)[BREAKING CHANGE] Volto 13 support. The upgrade-step will update listing blocks data.
[cekk]3.0.1 (2021-06-08)review caching profile
[mamico]3.0.0 (2021-05-28)Provided basic setup for caching policies in control panel.
[daniele]2.1.2 (2021-05-11)Additional fix in start and end values handling in querystring-search.
[cekk]2.1.1 (2021-05-11)Fix start and end values handling in querystring-search.
[cekk]2.1.0 (2021-05-05)Compatibility with changes in plone.restapi 7.3.2.
[cekk]2.0.2 (2021-05-05)Handle also limit in querystringsearch patch.
[cekk]2.0.1 (2021-05-05)Handle sort order in querystringsearch patch.
[cekk]2.0.0 (2021-04-30)Remove @events-search endpoint and customize @querystring-search one to handle Events like @events-search.
[cekk]1.3.0 (2021-04-19)Monkeypatch to respect locally allowed types also on content paste.
[cekk]1.2.4 (2021-04-15)Customize translation for remoteUrl field description only for restapi call.
[cekk]1.2.3 (2021-04-01)added block type ‘searchEvents’ to EXCLUDE_TYPES [giuliaghisini]1.2.2 (2021-03-25)Added upgrade step to import p.a.c. profile.
[daniele]1.2.1 (2021-03-17)Monkeypatch for Events recurrences.
[cekk]Fix profile name in upgrade-steps.
[cekk]1.2.0 (2021-03-02)New endpoint to search Events: @events-search.Better handle serialization for recursion problems: now only serialize with ISerializeToJsonSummary
if the referred item is the current context.
[cekk]1.1.0 (2021-03-01)Expand uids with ISerializeToJsonSummary and not with fullobject to gain space and
avoid maximum recursion depth it a block has an internal reference to the current context.
[cekk]1.0.9 (2021-02-23)Handle unauthorized in blocks serializer.
[cekk]1.0.8 (2021-02-19)Fix typo.
[cekk]1.0.7 (2021-02-19)Do not run dependencies when upgrading plone.app.registry.
[cekk]1.0.6 (2021-02-15)Disallow Plone site indexing: add noindex in <head>
[cekk]Revert robots.txt customization because is in conflict to noindex directive.
[cekk]1.0.5 (2021-02-11)Custom @search endpoint to fix bug with Access inactive portal content permission
(https://github.com/plone/plone.restapi/pull/1066)
[cekk]1.0.4 (2021-02-10)Customize robots.txt to disallow /api entry.
[cekk]1.0.3 (2021-02-09)Patched Products.PortalTransforms
(https://github.com/plone/Products.PortalTransforms/pull/43).
[cekk]1.0.2 (2021-02-09)Re-add remoteUrl field serializer.
[cekk]1.0.1 (2021-02-08)[new] Add here from modena the RSS.pt template override
[lucabel]Remove text block serializer that is already merged into plone.restapi.
[cekk]Register generic serializer also for site root.
[cekk]1.0.0 (2020-12-07)Add exclude_from_nav as Collection criteria (used also in Volto’s listing blocks).
[cekk]Add custom TextLine adapter to return the proper widget forremoteUrlfield.
[cekk]0.1.6 (2020-11-25)Allow Products.PloneHotfix20200121 versions greater than 1.0.
[pnicolli]Fix generic serializer/deserializer.
[cekk]Skip also “calendar” when check for url deserializing blocks
[lucabel]Fix document template.
[cekk]0.1.5 (2020-10-20)Remove resolveuid serializer/deserializer for blocks: now they are integrated in plone.restapi.
[cekk]Add custom transformers for blocks to handle link in generic blocks.
[cekk]Enable Editor and Contributor to access Plone vocabularies with restapi.
[cekk]Add @sitemap-settings endpoint.
[cekk]0.1.4 (2020-07-16)Add keywords vocabulary patch.
[cekk]0.1.3 (2020-06-22)Added default homepages
[nzambello]Added blocks behavior to LRF
[nzambello]Made editable and viewable Plone Site with blocks behavior
[nzambello]Remove richtext behavior from News Items, Events and Documents.
[cekk]News Item and Event are folderish and can only contain Links, Images and Files.
[cekk]0.1.2 (2020-05-25)Revert to Event and News Item default behaviors.
[cekk]0.1.1 (2020-05-22)Install also collective.volto.cookieconsent.
[cekk]0.1.0 (2020-05-22)Initial release.
[cekk]