..  _introduction:

What does it do?
================

The extension presents the partner institutions of a university. Each partner
is a page of the page type :guilabel:`Academic partner`, with its address, its
coordinates and its categories: the region, the partner type, the kind of
collaboration and the sustainable development goals it works on. The page
renders in the layout of the site.

Four content elements show the partners, see :ref:`integrator`: a list
visitors filter and sort, a map of every partner with coordinates, and the
partners linked to a page, with the role each one plays there, as a list or as
a row of logos. An editor links partners to a page, a project or a study
programme for example, in the :guilabel:`Partnership` tab of that page.

..  _third-party-icons:

Third-party icons
-----------------

The SVG icons below :file:`Resources/Public/Icons/`, except
:file:`Extension.svg`, are `Font Awesome Free <https://fontawesome.com>`__
icons by Fonticons, Inc., licensed under the `Creative Commons Attribution 4.0
International license <https://creativecommons.org/licenses/by/4.0/>`__. The
notice :file:`Resources/Public/Icons/LICENSE-font-awesome.txt` lists every file
with its Font Awesome name and the changes made to it. The record icons of
partnerships and roles and the icon of the collaboration type draw the shared
icons of :guilabel:`academic_base`, which lists them in its own notice.

This manual shows the icons of the content elements from
:file:`Documentation/Images/Icons/`, copies of the files below
:file:`Resources/Public/Icons/plugin/`, the Font Awesome icons `building-flag`,
`building`, `map-location-dot` and `building-ngo`, drawn in a fixed grey
instead of the colour of the surrounding text, so that they read on a light and
a dark page alike.