visualtitle 0.3

Introduction

This add-on separates navigation title and visual title fields in Plone. This serves the needs of marketing message where

• The author wants long, marketing pitch tuned, title for the page

• For the navigation tree, shorter, informative title is preferred

The add-on is also useful for languages preferring long words, like German and Finnish, where the actual title does not fit well into the navigation tree and a shortened title may be preferred.

Compatibility

Plone 4+

Installation

Add visualtitle in buildout.cfg:

[buildout]

eggs =
    ...
    visualtitle

Install the add-on using the add-on installer in Site Setup.

• http://plone.org/products/dexterity/documentation/how-to/install

Usage

The add-on currently supports Archetypes based content.

When the add-on is activated you see title and visual title fields on Archetypes edit pages on all Archetypes content pages.

Limitations

The page template must use Plone 4+ content-core slots or generic_title_view macro to render the page title.

Correct example 1:

<html xmlns="http://www.w3.org/1999/xhtml"
      xmlns:metal="http://xml.zope.org/namespaces/metal"
      xmlns:tal="http://xml.zope.org/namespaces/tal"
      xmlns:i18n="http://xml.zope.org/namespaces/i18n"
      metal:use-macro="context/main_template/macros/master">

    <metal:block fill-slot="content-core">
        .. page payload goes here ...
    </metal:block>
</html>

Correct example 2:

<h1 metal:use-macro="context/kss_generic_macros/macros/generic_title_view">
     Generic KSS Title. Is rendered with class="documentFirstHeading".
</h1>

If you do like this for your own content types the visual title magic won’t take a place:

<h1 class="documentFirstHeading">My title</h1>

You can also access the visual title directly (not recommended):

<h1 tal:content="python:context.restrictedTraverse('visualtitle')()" class="documentFirstHeading" />

Internals

This add-on overrides kss_generic_macros template for Plone 4+, adds new fields using archetypes.schemaextender and a helper view which you can call from the code to get the visual title.

i18n

Yep, it does.

Source and issue tracking

• https://github.com/miohtama/visualtitle

Author

Mikko Ohtamaa

0.3 (2014-07-25)

• Register the ‘static’ directory in ZCML (grok no longer does this) [djowett]

• Correct English on field description [djowett]

• Insert the visualtitle layer into all existing skins [djowett]

• Fix for error: AttributeError: ‘module’ object has no attribute ‘CodeView’ [djowett]

0.2.2 (2012-06-25)

• Attempt #3 of fixing .mo distribution problems [miohtama]

0.2.1 (2012-06-25)

• Attempt #2 of fixing .mo distribution problems [miohtama]

0.2 (2012-06-25)

• Fixed distribution of .mo files [miohtama]

• Do not install as theme [miohtama]

0.1 (2012-06-25)

• Initial release [miohtama]