Package: collective.portaltabs
Table of contentsIntroductionWhen you need thisWhen you don’t need thisHow to useFirst noteHandling tabsWhat I can write inside an URL section?Manage additional actions categoriesUpload directly an “actions.xml” filePlone is an helephant, remember allTODOBug report and feature requestCreditsAuthorsChangelog0.4.0 (2014-07-25)0.3.0 (2013-01-15)0.2.0 (2011-05-19)0.1.0a (2010-12-15)IntroductionAdd to Plone a way to manage siteportal tabsusing the Plone interface and hiding common
syntax difficulties you can find in ZMI.When you need thisYou need this product when you want to give to your non-technical users the ability to
manage theportal tabssection of your Plone site.Going deeply:you don’t want (or you can’t) that your power user will need to go to ZMI
(for example, the Plone 4.1 “Site Administrator” role can’t)you still want to make them able to manage portal tabsyour users don’t know nothing about TAL and python, and commonly want only to add static
links to the siteyour additional tabs don’t need advanced features like condition for being seen, or permissions
(for this, you can still go to ZMI)When you don’t need thisIf you only need to port into Plone interface the “portal_action” tool customizationthis is not your
product. Try to checkquintagroup.plonetabsinstead.How to useFirst noteThis product only manage portal tabs that are not automatically generated from Plone. For this
reason, a warning message is displayed if the “Automatically generate tabs” option is selected
in the “Navigation settings” panel.Handling tabsFrom the “Site Setup” panel, go to the new “Manage portal tabs” link you’ll find after the
product installation.The “Portal Tabs settings” view is composed by two section; the first one for make changes to
existing tabs (and also order and delete them), and the second for adding new tabs.Newly created tab only need two kind of information: the name of the tab to be displayed (title)
and the URL. When creating a tab you can also handle the id of the tab, or this will be
automatically generated.What I can write inside an URL section?The product try to hide some of the too-technical feature you have available in the ZMI
portal_actions tool management, however all features are still there.to create an absolute link to something, just type the link (e.g: “http://foo.org”)when you need to create links to URL inside the site, just type “/folder/foo”
(note that this pathcanbe a content path, but no check are done at all)TAL espression are still available, but you need to start them with a “tal:”Python expression are still available, but you need to start them with a “python:”inside an URL, you can still use TALES expressions in the normal form “${foo1/foo2/...}”For security reason, usage on “python:”, “tal:” and in-string TALES with “$” are protected
by another permissions “collective.portaltabs: Use advanced expressions”, given only toManagerrole.Manage additional actions categoriesYou can use collective.portaltabs to handle also other CMF action categorie than “portal_tabs”.
To do this you need to configure what other categories can be handled accessing the
“@@manage-portaltabs-categories” settings page.All entries must match a CMF action category that exists.
Going back to the “Portal Tabs settings” make possible to handle also those new actionsUpload directly an “actions.xml” fileIf you have defined your own portal tabs using aGeneric Setupprofile, you can upload youractions.xml(or compatible file) file directly in the manage form.Plone is an helephant, remember allPlease, remember that if you used anactions.xmlin one of your product, Plone will remember all action you have
loaded, and changes done manually later will be reverted if you reinstall the product.To make Plone stopping remember about those actions, you need to:uninstall your product that added the actionsremove the products from theportal_quickinstaller(“Contents” tab)remove theactions.xmlfile from your productinstall againTODOMore testsProvide some AJAX fancy features for selecting portal contentsBug report and feature requestPlease, go to theproduct’s issue tracker.CreditsDeveloped with the support of:S. Anna Hospital, FerraraAzienda USL FerraraUniversity of Padova - Department of Management and EngineeringAll of them supports thePloneGov initiative.AuthorsThis product was developed by RedTurtle Technology team.Changelog0.4.0 (2014-07-25)Restored controlpanel icons no more delivered by Plone 4.3
[keul]Fixed link to navigation controlpanel
[keul]Added option for visibility condition of the action
[keul]0.3.0 (2013-01-15)updated to Plone 4.1+ security and new “Site Administrator” role [keul]support for query expression starting with/, that generate links to
internal section of the site [keul]tabs settings panel is now protected with a specific permission [keul]protected the use oftal:,python:and$with a proper permission
[keul]removed the usage of CMF properties. General configuration migrated to
Plone registry
[keul]Added tests
[keul]0.2.0 (2011-05-19)added input validations [keul]more help texts and translations [keul]added a direct link to the ZMI manage section [keul]added a way to upload Generic Setup compatibleactions.xmlfile, to
automatically load actions [marco.mariani]0.1.0a (2010-12-15)initial release