 | Products.DoormatAdds a doormat viewlet and installs it in the Plone footer |
| Download | |
Products.Doormat Ranking & Summary
Advertisement
Products.Doormat Tags
Products.Doormat Description
Adds a doormat viewlet and installs it in the Plone footer A doormat is a large collection of links which are presented in a structured way. One example is the current plone.org, where the div#sitemap at the bottom is actually an ordered collection of internal and external links, with sections called "Downloads", "Documentation", "Developers", "Plone foundation" and "Support". See more examples of doormats.Products.Doormat adds a couple of content types (Archetypes), which are used to create a structure which is used for generating a doormat. A viewlet on this doormat is placed in the Plone footer. The links in the Doormat are managed as content, making the Doormat more flexible than a sitemap. It's also possible to add external links. It's also possible to add bits of text, with markup.Getting startedAfter installing the product in your site, you can add a "Doormat" item to your Plone site. Inside it, you can create a hierarchical structure of Columns, Sections, links (both internal and external), and Documents (Plone's Page type).The Doormat may look like this, schematically:+-- Doormat -----------------------------------------------------------------------+| || +-- Column 1 ----------+ +-- Column 2----------+ +-- Column 3 -------------+ || | | | | | | || | +-- Section 1 ----+ | | +-- Section 1 ----+ | | +-- Section 1 --------+ | || | | | | | | | | | | | | || | | +-- Link 1 --+ | | | | +-- Link 1 --+ | | | | +-- Document 1 --+ | | || | | +------------+ | | | | +------------+ | | | | | | | | || | | | | | | | | | | | (Contact info) | | | || | | +-- Link 2 --+ | | | | +-- Link 2 --+ | | | | | | | | || | | +------------+ | | | | +------------+ | | | | +----------------+ | | || | | | | | | | | | | | | || | +-----------------+ | | +-----------------+ | | +---------------------+ | || | | | | | | || +----------------------+ +---------------------+ +-------------------------+ || |+----------------------------------------------------------------------------------+In fact, you can add more than one section, they will be displayed below each other. In each section, you can mix internal links, external links and Documents.Simple configurationYou'll probably want to exclude the doormat object from navigation using the "Settings" tab. (This was not yet done when the above screenshot was taken.)There's a field showTitle on the folderish types (Doormat, Column and Section) which allows content managers to decide if the item's title should be displayed in the doormat.More advanced configuration and stylingThis section is intended for integrators and/or developers who would like to customize the way the doormat is rendered in more detail.Moving the doormatBy default, the default doormat viewlet (doormat.footer) is placed in the plone.portalfooter viewlet manager. It's easy to modify this in an add-on product, so the doormat will display below the global navigation (portal tabs), or anywhere else in the site.Displaying the doormat without the extra div elementsThe default viewlet renders the doormat inside Plone's default footer elements, so it blends in with Plone 4's default Sunburst Theme:< div class="row" > < div class="cell width-full position-0" > < div id="doormat-container" / > < /div >< /div >Using the doormat.footer.bare viewlet will omit the two outermost 's. This may be handy when using the doormat in a different theme, or in a customized layout. You can hide the default viewlet and enable the bare version through @@manage-viewlets, or by adding a customized viewlets.xml to the product you're developing.CaveatsThe viewlet does a catalog lookup for the Doormat portal type. If you have more than one object of this type (nothing stops you), it will use the oldest one. Requirements: · Python · Plone CMS What's New in This Release: · Set global_allow=False on DoormatSection by adding tagged value in UML. (agx mysteriously sets it to True by default) · Developer documentation (about using AGX) · Explicitly set external-link class for Link type objects.
Products.Doormat Related Software