From 8de8cdb38ce3330e4c800e756e6a60668d0bb8c2 Mon Sep 17 00:00:00 2001 From: Maik Derstappen Date: Sat, 31 Jan 2026 20:26:40 +0200 Subject: [PATCH 1/3] Replace Plone 5 links with Plone 6 links Updated links to Plone 6 documentation and replaced direct URLs with internal documentation references. --- docs/classic-ui/views.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/classic-ui/views.md b/docs/classic-ui/views.md index e2a7097be0..273b9a5a0b 100644 --- a/docs/classic-ui/views.md +++ b/docs/classic-ui/views.md @@ -715,17 +715,17 @@ However, in most cases: Replace links to Plone 5.2 docs with links to Plone 6 docs. Specifically: -- [TAL page template](https://5.docs.plone.org/adapt-and-extend/theming/templates_css/template_basics) -- [interface](https://5.docs.plone.org/develop/addons/components/interfaces) +- {doc}`TAL page template ` +- {doc}`interface ` ``` - Full Plone page views are a subclass of [`Products.Five.browser.BrowserView`](https://github.com/zopefoundation/Zope/blob/d1814d0a6bddb615629b552de10e9aa5ad30a6da/src/Products/Five/browser/__init__.py#L20) which is a wrapper class. It wraps [`zope.publisher.browser.BrowserView`](https://github.com/zopefoundation/zope.publisher/blob/dea3d4757390d04f6a5b53e696f08d0cab5f6023/src/zope/publisher/browser.py#L958), and adds an acquisition (parent traversal) support for it. -- Views have an attribute `index`, which points to a [TAL page template](https://5.docs.plone.org/adapt-and-extend/theming/templates_css/template_basics) that is responsible for rendering the HTML code. +- Views have an attribute `index`, which points to a {doc}`TAL page template ` that is responsible for rendering the HTML code. You get the HTML output with `self.index()`. The page template gets a context argument `view`, pointing to the view class instance. The `index` value is usually an instance of [`Products.Five.browser.pagetemplate.ViewPageTemplateFile`](https://github.com/zopefoundation/Zope/blob/d1814d0a6bddb615629b552de10e9aa5ad30a6da/src/Products/Five/browser/pagetemplatefile.py#L35) for full Plone pages or [`zope.pagetemplate.pagetemplatefile.PageTemplateFile`](https://github.com/zopefoundation/zope.pagetemplate/blob/14ba59c98e12517b9f8abcdb24bc882bb435ed7c/src/zope/pagetemplate/pagetemplatefile.py#L43) for HTML snippets without using acquisition. -- View classes should implement the [interface](https://5.docs.plone.org/develop/addons/components/interfaces) +- View classes should implement the {doc}`interface ` [`zope.browser.interfaces.IBrowserView`](https://github.com/zopefoundation/zope.browser/blob/1239c75e4e190df992bf34a88b4ead2c952afe86/src/zope/browser/interfaces.py#L27). Views that render page snippets and parts can be direct subclasses of `zope.publisher.browser.BrowserView`, as snippets might not need acquisition support which adds some overhead to the rendering process. @@ -1126,4 +1126,4 @@ One workaround to avoid this mess is to use `aq_inner` when accessing `self.obj` - {doc}`/classic-ui/layers` - {doc}`/classic-ui/templates` -- {doc}`/classic-ui/viewlets` \ No newline at end of file +- {doc}`/classic-ui/viewlets` From 8ba2d6397376b5e893a8883704ae2fd63a7de880 Mon Sep 17 00:00:00 2001 From: MrTango Date: Wed, 18 Feb 2026 15:13:50 +0200 Subject: [PATCH 2/3] remove outdated todo for template link --- docs/classic-ui/views.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/docs/classic-ui/views.md b/docs/classic-ui/views.md index 273b9a5a0b..77111c5fed 100644 --- a/docs/classic-ui/views.md +++ b/docs/classic-ui/views.md @@ -715,7 +715,6 @@ However, in most cases: Replace links to Plone 5.2 docs with links to Plone 6 docs. Specifically: -- {doc}`TAL page template ` - {doc}`interface ` ``` @@ -839,7 +838,7 @@ Make sure that you declare the `i18n:domain` again, or the strings in this templ ## Access a view instance in code -You need to get access to the view in your code if you call a view from either: +You need to get access to the view in your code if you call a view from either: - inside another view - your unit test code From 105cc90484d89fde8ff5e90493d5d1173a7d764b Mon Sep 17 00:00:00 2001 From: MrTango Date: Wed, 18 Feb 2026 15:31:30 +0200 Subject: [PATCH 3/3] remove todo interfaces link --- docs/classic-ui/views.md | 7 ------- 1 file changed, 7 deletions(-) diff --git a/docs/classic-ui/views.md b/docs/classic-ui/views.md index 77111c5fed..0058a687e4 100644 --- a/docs/classic-ui/views.md +++ b/docs/classic-ui/views.md @@ -711,13 +711,6 @@ class MyView(object): However, in most cases: -```{todo} -Replace links to Plone 5.2 docs with links to Plone 6 docs. -Specifically: - -- {doc}`interface ` -``` - - Full Plone page views are a subclass of [`Products.Five.browser.BrowserView`](https://github.com/zopefoundation/Zope/blob/d1814d0a6bddb615629b552de10e9aa5ad30a6da/src/Products/Five/browser/__init__.py#L20) which is a wrapper class. It wraps [`zope.publisher.browser.BrowserView`](https://github.com/zopefoundation/zope.publisher/blob/dea3d4757390d04f6a5b53e696f08d0cab5f6023/src/zope/publisher/browser.py#L958), and adds an acquisition (parent traversal) support for it. - Views have an attribute `index`, which points to a {doc}`TAL page template ` that is responsible for rendering the HTML code.