Metadata-Version: 2.1
Name: collective.folderishtraverse
Version: 2.0
Summary: Traverse to first item in folder
Home-page: http://github.com/collective/collective.forlderishtraverse
Author: Johannes Raggam
Author-email: thetetet@gmail.com
License: GPL
Keywords: plone view
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Plone
Classifier: License :: OSI Approved :: GNU General Public License v2 (GPLv2)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python
License-File: LICENSE.rst
Requires-Dist: plone.app.contentmenu
Requires-Dist: plone.folder
Requires-Dist: plone.memoize
Requires-Dist: Products.CMFCore
Requires-Dist: Products.CMFPlone
Requires-Dist: Products.statusmessages
Requires-Dist: setuptools
Requires-Dist: zope.component
Requires-Dist: zope.i18nmessageid
Provides-Extra: test
Requires-Dist: plone.app.testing; extra == "test"
Requires-Dist: plone.testing>=5.0.0; extra == "test"
Requires-Dist: plone.app.contenttypes; extra == "test"
Requires-Dist: plone.app.robotframework[debug]; extra == "test"

Introduction
============

This package provides an view which traverses to the first item found in an
ordered container. If the default view of the item, which the traverse view is
traversing to is also a traverse view, the traversing happens again to the next
sub-sub-item in the sub-folder, if possible.

The traversing/redirection is only done for users who are not allowed to see
the folder listing of the current context (usally anonymous users and normal
members). For users with higher permissions, a folder contents view is shown.
This way, members can easily edit the folder without being redirected to
another folder.

collective.folderishtraverse is an alternative to a default page in Plone. The
difference is, that the target content is shown in the navigation tree and that
traversing to any nested content in any level of the tree's hierarchy is
possible.

Author
======

Johannes Raggam, BlueDynamics Alliance <raggam-nl@adm.at>

Changes
=======

2.0 (2024-12-08)
----------------

- Let editors also traverse to the right context.

  There is a new "EDITOR_TRAVERSE" option, set per default to "True".
  When "True", editors are also redirected to the first accessible content item
  in a folder. If set to "False", editors are redirected to the folder contents
  view.

  I think showing the folder contents view is confusing and not necessary
  anymore, therefore this breaking change.

  In the next major release this feature will be removed alltogether.

  Currently the "EDITOR_TRAVERSE" option is a module constant in
  "collective.folderishtraverse.browser.traverse_view" - if needed this can be
  changed to a registry entry.

  [thet]


1.2 (2024-12-08)
----------------

- When redirecting, set a 302 status header and the redirection url.
  This makes the redirection not only a standard one, but allows also
  redirections on AJAX requests.
  [thet]


1.11 (2022-11-15)
-----------------

- Improve readability of traverse_view
  [jensens]

- Add browser-layer
  [jensens]

- Add basic testing.
  [jensens]

- Add integrated buildout for easier development.
  [jensens]

1.10 (2015-07-15)
-----------------

- normalize non-readable boolean expression.
  [jensens]

- Dont cache on instance to reduce write on reads.
  Cache volatile for 60min instead.
  [jensens]

- On traversing, don't check for the ``published`` workflow state but for
  content permissions.
  [thet]

- Use the plone.app.contenttypes folder listing view as fallback view, if
  available.
  [thet]


1.9 (2014-06-03)
----------------

- Add simplified Chinese translations.
  [jianaijun]

- Change permission needed to not beeing redirected to the first content item
  from ``List folder contents`` to ``Add portal content``. This is a better
  default, as only editors need not beeing redirected to be able to add and
  edit content.
  [thet]


1.8 (2014-05-02)
----------------

- Added Chinese Simplified translation.
  [jianaijun]

- Register views more generally to also support Dexterity based folderish
  types.
  [thet]

1.7 (2014-02-03)
----------------

- Redirect not only for anonymous users but all users not having the "List
  folder contents" permission on contexts with "traverse_view" enabled.
  [thet]


1.6.3 (2013-11-23)
------------------

- If no translation is found for a content item which' language doesn't match,
  continue with the next object in the folder instead of redirecting to the
  folder_summary_view.
  [thet]


1.6.2 (2013-04-23)
------------------

- Add "en" and "de" translations.
  [thet]


1.6.1 (2013-01-28)
------------------

- Do not try to translate object if no lang set.
  [rnix]


1.6 (2013-01-14)
----------------

- Consider translation in traverse_view if LinguaPlone is installed.
  [rnix]

- Add z3c.autoinclude.plugin entry point.
  [thet]


1.5.1 (2012-12-18)
------------------

- Use ``zExceptions.Redirect`` instead of ``request.response.redirect`` in
  traverse view. The Redirect exception redirects immediately instead of
  rendering the current page and submitting a transaction.commit() first.
  [rnix]


1.5 (2012-12-11)
----------------

- Add ``NON_TRAVERSE_FALLBACK_VIEW``. May be patched if fallback view for
  ``folder_contents`` should differ from ``folder_summary_view``.
  [rnix]

- Check non-traversing fallback view against ``List folder contents``
  permission instead of anonymous.
  [rnix]


1.4 (2012-11-25)
----------------

- Show the "Display" content-menu also in the folder contents view on the Plone
  Site Root. The "Actions" menu is not displayed yet, since object_buttons are
  not registered for the Plone Site Root (copy, cut, rename and delete wouldn't
  make much sense on the portal object itself).
  [thet]


1.3 (2012-11-22)
----------------

- Show the Actions and Display content-menus also in folder content views.
  Allows Action submenu items like from c.folderorder and setting the display
  to something else than traverse_view.
  [thet]

- Add statusmessage for when displaying the traverse_view for non-anonymous
  users.
  [thet]

- When no endpoint is found, redirect to folder_summary_view for anonymous
  users. folder_contents needs higher permissions.
  [thet]


1.2 (2012-11-07)
----------------

- For non-anonymous users or if no endpoint was found, redirect to
  folder_contents. This view is generally nicer and more usable.
  [thet]


1.1 (2012-02-20)
----------------

- Allow the traverse_view also on the Plone Site itself.
  [thet]


1.0 (2012-02-02)
----------------

- Initial release
