The action icons tool (portal_actionicons) has been deprecated

by Plone Documentation Team last modified Nov 07, 2009 12:07 AM
Products providing icons for CMF actions should now register them using the 'icon_expr' setting on the action itself, rather than using the separate action icons tool.

In Plone 3, products could register icons associated with CMF actions using the action icons tool (portal_actionicons in the ZMI, actionicons.xml in GenericSetup profiles). In Plone 4 the action icons tool has been deprecated. Instead, actions in the actions tool and control panel tool can now have an associated icon expression which gives the URL of the icon.

For example, Kupu now registers the icon for its control panel using the following controlpanel.xml file in its GenericSetup profile:

<?xml version="1.0"?>
<object name="portal_controlpanel" meta_type="Plone Control Panel Tool">
 <configlet title="Visual editor" action_id="kupu" appId="Kupu"
    category="Plone" condition_expr=""
    icon_expr="string:$portal_url/kupuimages/kupu_icon.gif"
    url_expr="string:${portal_url}/kupu_library_tool/kupu_config"
    visible="True">
  <permission>Manage portal</permission>
 </configlet>
</object>

The 'icon_expr' setting gives the URL for the icon associated with this configlet.

The 'icon_expr' setting may also be used with normal actions in the actions tool / actions.xml.

Registering icons with the action icons tool will still work in Plone 4, but it is deprecated and will no longer work in the next major release of Plone. You may remove actionicons.xml to avoid a deprecation warning, or leave it in place to maintain compatibility with Plone 3, depending on your needs.