https://github.com/miohtama/visualtitle

Have different navigation and in-page text title in Plone
https://github.com/miohtama/visualtitle

Last synced: 2 months ago
JSON representation

Have different navigation and in-page text title in Plone

• Host: GitHub
• URL: https://github.com/miohtama/visualtitle
• Owner: miohtama
• Created: 2012-06-25T07:58:56.000Z (over 12 years ago)
• Default Branch: master
• Last Pushed: 2015-05-21T10:17:51.000Z (over 9 years ago)
• Last Synced: 2024-06-06T09:12:44.008Z (8 months ago)
• Language: Python
• Size: 285 KB
• Stars: 3
• Watchers: 3
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.rst

Awesome Lists containing this project

README

        
=================

 Visual Title

=================

.. contents:: :local:

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

* 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.

.. 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::

    

        

            .. page payload goes here ...

        

    

Correct example 2::

    


         Generic KSS Title. Is rendered with class="documentFirstHeading".

    


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

    
My title


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

    


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

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.

Author

--------

`Mikko Ohtamaa `_