skip to navigation
skip to content

Not Logged In

visualtitle 0.2.2

Separate content and navigation titles for Plone CMS

Visual Title

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.

Note

For Plone 4.1 or lower: Add Dexterity extends = line in buildout.cfg

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.

Note

Dexterity support is planned, but looking for the sponsor.

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

Policy and source coding conventions

The code follows Pylint policies defined in VVV policy file.

The code is PEP-8 compatible for the parts where PEP-8 does not get confused.

Changelog

0.2.2 (2012-06-25)

  • Attempt #3 of fixing .mo distribution problems

0.2.1 (2012-06-25)

  • Attempt #2 of fixing .mo distribution problems

0.2 (2012-06-25)

  • Fixed distribution of .mo files
  • Do not install as theme

0.1 (2012-06-25)

  • Initial release
 
File Type Py Version Uploaded on Size
visualtitle-0.2.2.zip (md5) Source 2012-06-25 18KB
  • Downloads (All Versions):
  • 3 downloads in the last day
  • 49 downloads in the last week
  • 274 downloads in the last month