The default 'primary' view (:mod:`cubicweb.web.views.primary`)
---------------------------------------------------------------

The primary view of an entity is the view called by default when a single
entity is in the result set and needs to be displayed. 

This view is supposed to render a maximum of informations about the entity.



Rendering methods and attributes for ``PrimaryView``
----------------------------------------------------

By default, `CubicWeb` provides a primary view for each new entity type
you create. The first view you might be interested in modifying.

Let's have a quick look at the EntityView ``PrimaryView`` as well as
its rendering method

.. code-block:: python
    
    class PrimaryView(EntityView):
        """the full view of an non final entity"""
        id = 'primary'
        title = _('primary')
        show_attr_label = True
        show_rel_label = True
        skip_none = True
        skip_attrs = ('eid', 'creation_date', 'modification_date')
        skip_rels = ()
        main_related_section = True

        ...

    def cell_call(self, row, col):
        self.row = row
        self.render_entity(self.complete_entity(row, col))

    def render_entity(self, entity):
        """return html to display the given entity"""
        siderelations = []
        self.render_entity_title(entity)
        self.render_entity_metadata(entity)
        # entity's attributes and relations, excluding meta data
        # if the entity isn't meta itself
        self.w(u'<div>')
        self.w(u'<div class="mainInfo">')
        self.render_entity_attributes(entity, siderelations)
        self.w(u'</div>')
        self.content_navigation_components('navcontenttop')
        if self.main_related_section:
            self.render_entity_relations(entity, siderelations)
        self.w(u'</div>')
        # side boxes
        self.w(u'<div class="primaryRight">')
        self.render_side_related(entity, siderelations)
        self.w(u'</div>')
        self.w(u'<div class="clear"></div>')
        self.content_navigation_components('navcontentbottom')

    ...

``cell_call`` is executed for each entity of a result set and apply ``render_entity``.

The methods you want to modify while customizing a ``PrimaryView`` are:

*render_entity_title(self, entity)* 
    Renders the entity title based on the assumption that the method 
    ``def content_title(self)`` is implemented for the given entity type.

*render_entity_metadata(self, entity)*
    Renders the entity metadata based on the assumption that the method
    ``def summary(self)`` is implemented for the given entity type.

*render_entity_attributes(self, entity, siderelations)*
    Renders all the attribute of an entity with the exception of attribute
    of type `Password` and `Bytes`.

*content_navigation_components(self, context)*
    This method is applicable only for entity type implementing the interface 
    `IPrevNext`. This interface is for entities which can be linked to a previous
    and/or next entity. This methods will render the navigation links between
    entities of this type, either at the top or at the bottom of the page
    given the context (navcontent{top|bottom}).

*render_entity_relations(self, entity, siderelations)*
    Renders all the relations of the entity in the main section of the page.
        
*render_side_related(self, entity, siderelations)*
    Renders all the relations of the entity in a side box. This is equivalent
    to *render_entity_relations* in addition to render the relations
    in a box.

Also, please note that by setting the following attributes in you class,
you can already customize some of the rendering:

*show_attr_label*
    Renders the attribute label next to the attribute value if set to True.
    Otherwise, does only display the attribute value.

*show_rel_label* 
    Renders the relation label next to the relation value if set to True.
    Otherwise, does only display the relation value.

*skip_none*
    Does not render an attribute value that is None if set to True.

*main_related_section*
    Renders the relations of the entity if set to True.

A good practice is for you to identify the content of your entity type for which
the default rendering does not answer your need so that you can focus on the specific
method (from the list above) that needs to be modified. We do not recommand you to
overwrite ``render_entity`` as you might potentially loose the benefits of the side
boxes handling.

.. XXX talk about uicfg.rdisplay