imio.dashboard 2.12

This package adds functionnality to collective.eeafaceted.dashboard but only work for Plone 4.3.x

imio.dashboard

This package does the glue between :

• collective.eeafaceted.batchactions

• collective.eeafaceted.collectionwidget

• collective.eeafaceted.dashboard

• collective.eeafaceted.z3ctable

• collective.compoundcriterion

• collective.documentgenerator

This build a useable dashboard tool by adapting following things :

• displaying the collectionwidget in a portlet;

• defining an adapter to easily extend the plone.app.collection customViewFields to add our own columns;

• adding a DashboardCollection based on plone.app.collection Collection;

• being able to generate a POD template from what is displayed in a dashboard;

• styling of displayed dashboard.

Distant faceted config :

It is possible to define a central faceted config that will be used by different elements that will use it because getting criteria managed by an only method defined in an adapter, to do so :

In adapters.py :

from eea.facetednavigation.criteria.handler import Criteria as eeaCriteria

class Criteria(eeaCriteria):
    """ Handle criteria
    """

    def __init__(self, context):
        """ Handle criteria
        """
        super(Criteria, self).__init__(context)
        # let's say we have a centralized faceted config defined at the root and called 'distantfacetedconfig'
        if hasattr(self.context, 'distantfacetedconfig'):
            self.context = self.context.distantfacetedconfig
            self.criteria = self._criteria()

In a overrides.zcml :

<adapter
  for="eea.facetednavigation.interfaces.IFacetedNavigable"
  provides="eea.facetednavigation.interfaces.ICriteria"
  factory=".adapters.Criteria" />

Combined indexes :

Sometime you build an index made of the concatenation of some subindexes to workaround ZCatalog weakness. In this case, you could need several faceted filters to query theses indexes, it is possible with combined indexes.

Let’s say you have an index for portal_type Folder that stores the portal_type and review_state of contained objects. The index contained_with_review_state content could looks like :

['Document__private', 'Document__published', 'Image__private']

Now if you want to display in a dashboard folders containing Documents that are in state private, you will likely use 2 filters :

• the first listing portal_types (Document, Image, Folder, …);

• the second listing review_states (private, published, …).

In the filter list of indexes available, you will have every available portal_catalog indexes and a duplicated list of these indexes prefixed with (Combined). If you select the index contained_with_review_state for the filter portal_types and the (Combined) contained_with_review_state for the filter review_states, this will automatically be combined so selecting Document in first filter and private in second filter will actually query for Document__private.

Changelog

2.12 (2023-07-07)

• get_transitions was moved from imio.helpers.content to imio.helpers.workflow. [gbastien]

2.11 (2023-03-22)

• Changes for WCA compatibility. [odelaere]

2.10 (2022-10-25)

• Adapts generationlink viewlet to last collective.documentgenerator last changes. [sdelcourt]

2.9 (2022-01-07)

• Fixed setup functions changing state of created elements, use imio.helpers.content.get_transitions instead portal_workflow.getTransitionsFor. [gbastien]

2.8 (2020-08-18)

• Enable PloneGroupUsersGroupsColumn in dashboards displaying organizations. [gbastien]

2.7 (2020-05-08)

• Use OrgaPrettyLinkWithAdditionalInfosColumn instead PrettyLinkColumn in dashboards displaying persons and held_positions. [gbastien]

2.6 (2019-05-16)

• Use OrgaPrettyLinkWithAdditionalInfosColumn and SelectedInPlonegroupColumn in dashboards displaying organizations. [gbastien]

2.5 (2019-03-28)

• Fix an issue with SolR and combined indexes [mpeeters]

• For imio.dashboard.ContactsReviewStatesVocabulary, take into account workflow of each contact portal_types (organization, person, held_position) as it can be different for each. [gbastien]

• Add CSS class to ContactPrettyLinkColumn if content is an organization, so we have a different class for every elements and we can style specific content. This needed to add soft dependency to collective.contact.core. [gbastien]

• Corrected typo [sgeulette]

2.4 (2019-01-25)

• Keep order of migrated portlet [sgeulette]

• Added projectspace type in migration. [sgeulette]

• Pinned products [sgeulette]

• Fixed test for fingerpointing [sgeulette]

2.3 (2018-12-04)

• Added translations for Add contacts icons. [gbastien]

2.2 (2018-11-29)

• Fixed failing migration because unexisting attribute exclude_from_nav was migrated with the parent’s value that is an instancemethod and it crashed the transaction during commit because it can not be serialized. [gbastien]

• Completelly removed ActionsColumn as it was moved to collective.eeafaceted.z3ctable previously. [gbastien]

• Moved CachedCollectionVocabulary to collective.eeafaceted.collectionwidget, now named collective.eeafaceted.collectionwidget.cachedcollectionvocabulary. Moved also dashboard collection related events. [sgeulette]

• Migration: secure attribute get in DashboardPODTemplateMigrator. Include portal portlet migration. [sgeulette]

• Added setuphandlers.add_orgs_searches that adds dashboards for collective.contact.core on the /contacts directory. [gbastien]

2.1 (2018-09-04)

• Added back imio.dashboard.js file to remove faceted spinner and speed up faceted fade speed. [gbastien]

• Added migrator DashboardPODTemplateMigratorWithDashboardPODTemplateMetaType as due to missing migration to 0.28 where DashboardPODTemplate meta_type was changed from DashboardPODTemplate to Dexterity Item, we may have DashboardPODTemplate created with different meta_types that is still cataloged. This way we manage both cases. [gbastien]

• The actions column was moved to collective.eeafaceted.z3ctable. [gbastien]

2.0 (2018-06-21)

• Change JS Faceted options in the ready function so we are sure that Faceted exists. [gbastien]

• Rely on collective.eeafaceted.dashboard to move to Plone5. Dashboard functionnalities working on Plone5 are now moved to this package we are relying on. Needs eea.facetednavigation >= 10.0. [gbastien]

1.7 (2018-05-25)

• Moved some methods to collective.eeafaceted.collectionwidget: _get_criterion, getCollectionLinkCriterion, getCurrentCollection [sgeulette]

• Consider other view than “facetednavigation_view” as outside faceted. [sgeulette]

1.6 (2018-05-03)

• Do not rely on the context.REQUEST to get the REQUEST because context is a ram.cached DashboardCollection and REQUEST is not reliable. Use getRequest from zope.globalrequest to get the REQUEST. The REQUEST is set in term.request so it is directly available. [gbastien]

1.5 (2018-04-23)

• Invalidate imio.dashboard.conditionawarecollectionvocabulary vocabulary cache when a WF transition is triggered on a DashboardCollection. [gbastien]

1.4 (2018-04-20)

• Use ram.cache for the imio.dashboard.conditionawarecollectionvocabulary vocabulary. This is user and closest faceted context relative and is invalidated when a DashboardCollection is modified. [gbastien]

1.3 (2018-01-06)

• Do not use CSS to manage contenttype icon, we have an icon_epxr on the portal_types. [gbastien]

1.2 (2017-12-01)

• Removed ‘imiodashboard_js_variables.js’ as it just translated the ‘no_selected_items’ message and it is now in ‘collective.eeafaceted.batchactions’ this package is relying on. [gbastien]

1.1 (2017-11-24)

• Added upgrade step that installs ‘collective.eeafaceted.batchactions’. [gbastien]

1.0 (2017-11-23)

• Corrected icon path and added contenttype-dashboardpodtemplate style. [sgeulette]

• Rely on ‘collective.eeafaceted.batchactions’, removed ‘select_row’ column that is already defined in ‘collective.eeafaceted.batchactions’. [gbastien]

0.28 (2017-10-09)

• Removed bad class attribute meta_type to avoid paste error [sgeulette]

0.27 (2017-08-07)

• Add a listing with brains, objects and helper view only available when selection ‘use_objects’ on the dashboard template. [sdelcourt]

0.26 (2017-08-02)

• Add ‘use_objects’ attribute on dashboard template if you want to have iterate over the objects and their helper view rather than the brains. [sdelcourt]

0.25 (2017-03-22)

• Use CheckBoxFieldWidget for IDashboardPODTemplate.dashboard_collections to ease selection when displaying several elements. [gbastien]

0.24 (2017-02-09)

• Added javascript variables for i18n. [sgeulette]

• Enable merging and caching for imio.dashboard.js in portal_javascripts. [gbastien]

0.23 (2017-01-31)

• Check if there are some checkboxes on a faceted to get uids. [bsuttor]

• Added plone.app.collection as a dependency. [gbastien]

0.22 (2016-11-22)

• Check if context is provided by IDashboardCollection to count number of dashborad collections. [bsuttor]

• Check if context is provided by IDashboardCollection to display_number_of_items. [bsuttor]

• Updated _get_generation_context to add needed parameter from documentgenerator. Test context variables integration [sgeulette]

0.21 (2016-10-05)

• Added own doc generation dashboard viewlet. Modified generation view to handle both outside or inside dashboard generations. [sgeulette]

• Display category in pod template collections vocabulary [sgeulette]

• Test exception when getting criterion value. [sgeulette]

• Check if we are in dashboard documentgenerator viewlet. For some content with iframe dashboard, there can be also a normal documentgenerator viewlet. [sgeulette]

0.20 (2016-08-03)

• Move columns ordering to collective.eeafaceted.z3ctable [sdelcourt]

0.19 (2016-05-13)

• Removed invasive styling, not the place here. [gbastien]

0.18 (2016-04-15)

• Added english translations. [sgeulette]

• Make configuration types not displayed in the search, added ‘Collection’, ‘DashboardCollection’, ‘Topic’, ‘ConfigurablePODTemplate’, ‘DashboardPODTemplate’, ‘PODTemplate’, ‘StyleTemplate’ and ‘SubTemplate to site_properties.types_not_searched. [gbastien]

0.17 (2016-03-22)

• Added meta_type for ‘DashboardPODTemplate’. [gbastien]

• Fixed JS in generatePodDocument to not generate the Pod template after alert ‘no items selected’. [gbastien]

• Changed JS generatePodDocument check to know if we are on a faceted page : do not query input[name=”select_item”] checkboxes as there could be none displayed if current faceted displays no result, instead check for presence of div#faceted-results. [gbastien]

0.16 (2016-03-03)

• Added possibility to display number of collection items in the term view. [cedricmessiant]

• Removed unused method CustomViewFieldsVocabularyAdapter.additionalViewFields. [gbastien]

• Added params in PrettyLinkColumn. Use it in RelationPrettyLinkColumn and external columns. [sgeulette]

0.15 (2016-02-15)

• Added RelationPrettyLinkColumn to display with PrettyLink a z3c.relationfield.relation.RelationValue attribute. [sgeulette]

• Limit padding left and right of the faceted checkbox widget to 0.2em instead of 1em. [gbastien]

• Added ‘combined indexes’ functionnality making it possible to combinate faceted filters together to query a single catalog index. [gbastien]

• In utils._updateDefaultCollectionFor as we change the faceted criteria annotations, make sure it is persisted by setting _p_changed = True [gbastien]

0.14 (2016-01-21)

• The POD template description is now displayed when hovering the POD template title. [gbastien]

0.13 (2016-01-15)

• Consider portlet is outside faceted when adding a new element. [sgeulette]

• Use ITopAboveNavManager to display the dashboard POD templates viewlet, this is due to a change in collective.eeafaceted.z3ctable where viewlet managers were renamed (was ITopManager before). [gbastien]

0.12 (2016-01-04)

• Adapted CSS regarding sort triangle entities now that we use larger ones. [gbastien]

0.11 (2015-12-17)

• Format sort triangle entities. [sgeulette]

• Define an icon_expr for portal_type DashboardPODTemplate so it is correctly displayed in the DX types control panel especially. [gbastien]

0.10 (2015-11-27)

• Added possibility to pass ‘extra_expr_ctx’ to evaluateExpressionFor while evaluating the TAL condition defined on the DashboardCollection. [gbastien]

0.9 (2015-11-24)

• Added method utils.getDashboardQueryResult that compute ‘uids’ and ‘brains’ returned by the current faceted query. [sdelcourt, gbastien]

• Test if collective.querynextprev is installed before accessing session [sgeulette]

0.8 (2015-11-03)

• Release that corrects the wrong 0.7 release. [gbastien]

0.7 (2015-11-03)

• Give permission ‘eea.facetednavigation: Configure faceted’ only for ‘Manager’ by default. [gbastien]

• Added a submethod utils._get_criterion that gets any widget type of a given faceted_context, it is now used by utils.getCollectionLinkCriterion and may be used alone if necessary. [gbastien]

0.6 (2015-10-08)

• Omit field ‘pod_portal_types’ for DashboardPODTemplate, it is useless as it is always available for Folders. [gbastien]

• Do not fail when extracting facetedQuery values if we receive an ‘int’. [gbastien]

• Added content_type icon for DashboardPODTemplate. [gbastien]

0.5 (2015-10-01)

• Rely on collective.documentgenerator and override the ‘document-generation’ view and the ‘generationlink’ viewlet so it is possible to generate a document from elements displayed in a dashboard. [gbastien]

• Added helper method utils.getCurrentCollection that will return the current collection used by a CollectionWidget in a faceted. [gbastien]

• Rely on Products.ZCatalog >= 3 to be able to use ‘not:’ statement in queries. [gbastien]

• Add DashboardPODtemplate type. This type of pod template is configurable to choose on which dashboard it is available/generable. [sdelcourt]

0.4 (2015-09-04)

• Moved ‘sorting’ and ‘collection-link’ criteria top ‘top/default’ position to be sure that it is evaluated first by faceted query. [gbastien]

• Add adapter for collective.querynextprev integration. [cedricmessiant]

• Added a creatorsvocabulary listing creators of the site, available especially for faceted criteria. [gbastien]

• Added helpers methods utils.getCollectionLinkCriterion and utils._updateDefaultCollectionFor. [sdelcourt]

0.3 (2015-08-21)

• Added utils method to enable faceted dashboard on an object and import xml configuration file. [sgeulette]

0.2 (2015-08-04)

• Factorized code that check if we are outside the faceted in the portlet so it is easy to override without overriding the entire widget_render method. [gbastien]

• Create the “imio.dashboard: Add DashboardCollection” permission in ZCML [cedricmessiant]

• Fix DashboardCollection object name in type definition [cedricmessiant]

0.1 (2015-07-14)

• Added portlet that shows Collection widget defined on a faceted nav enabled folder. [gbastien]

• Initial release. [IMIO]