.. include:: /shortcuts.rstext

.. index:: Blocks usage matrix

.. _blocks_in_context:

Blocks in various pages
--------------------------

Certain blocks can only exist in certain page contexts. For example, the wall can only be placed on the profile page whereas a note can be used on any page. There are a number of page contexts which can have different blocks:

* portfolio page
* group page
* institution page
* site page
* profile page
* dashboard page

The following list shows in which contexts a specific block and therefore a specific artefact can be used. It also shows which blocks can be copied. The original idea came from Synergy Learning for Mahara 1.3.

.. note::
   Blocks in a page that are copied from one user to another need to be checked for content accuracy and whether they can be retained as they are or need to be updated.

|new in Mahara 18.10| :index:`Blocks <single: New in Mahara 18.10; Add more blocks to group, institution, and site pages>` that display a * next to their check mark can be added to a group, institution, or site page and configured where possible. No content is displayed though when the page is viewed because user-specific content is required. The blocks can be added though to create better templates.

Files, images and video
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1

   * - Block
     - User
     - Group
     - Institution
     - Site
     - Dashboard
     - Profile
     - Group homepage
     - Copyable
   * - :fonticon:`fa fa-video-camera fa-border fa-2x`

       :ref:`Embedded media <embedded_media_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
   * - :fonticon:`fa fa-download fa-border fa-2x`

       :ref:`File(s) to download <file_download_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
   * - :fonticon:`fa fa-folder fa-border fa-2x`

       :ref:`Folder <folder_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
   * - :fonticon:`fa fa-picture-o fa-border fa-2x`

       :ref:`Image <image_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
   * - :fonticon:`fa fa-picture-o fa-border fa-2x`

       :ref:`Image gallery <image_gallery_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
   * - :fonticon:`fa fa-file-pdf-o fa-border fa-2x`

       :ref:`PDF <pdf_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
   * - :fonticon:`fa fa-code fa-border fa-2x`

       :ref:`Some HTML <html_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|

Journals
~~~~~~~~~~~

.. list-table::
   :header-rows: 1

   * - Block
     - User
     - Group
     - Institution
     - Site
     - Dashboard
     - Profile
     - Group homepage
     - Copyable
   * - :fonticon:`fa fa-pencil fa-border fa-2x`

       :ref:`Journal <journal_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
   * - :fonticon:`fa fa-file-text fa-border fa-2x`

       :ref:`Journal entry <journal_entry_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
   * - :fonticon:`fa fa-clock-o fa-border fa-2x`

       :ref:`Recent journal entries <recent_journal_entry_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     -
   * - :fonticon:`fa fa-tags fa-border fa-2x`

       :ref:`Tagged journal entries <tagged_journal_entries_block>`
     - |check|
     -
     -
     -
     - |check|
     - |check|
     -
     - |check|

General
~~~~~~~~~~~

.. list-table::
   :header-rows: 1

   * - Block
     - User
     - Group
     - Institution
     - Site
     - Dashboard
     - Profile
     - Group homepage
     - Copyable
   * - :fonticon:`fa fa-pencil-square-o fa-border fa-2x`

       :ref:`Annotation <annotation_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     -
     -
     -
     - |check|
   * - :fonticon:`fa fa-comment fa-border fa-2x`

       :ref:`Comments <comments_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     -
     -
     -
     - |check|
   * - :fonticon:`fa fa-creative-commons fa-border fa-2x`

       :ref:`Creative Commons license <creative_commons_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
   * - :fonticon:`fa fa-info fa-border fa-2x`

       :ref:`Group info <group_info_block>`
     -
     -
     -
     -
     -
     -
     - |check|
     -
   * - :fonticon:`fa fa-users fa-border fa-2x`

       :ref:`Group members <group_members_block>`
     -
     -
     -
     -
     -
     -
     - |check|
     -
   * - :fonticon:`fa fa-file fa-border fa-2x`

       :ref:`Group portfolios <group_pages_block>`
     -
     -
     -
     -
     -
     -
     - |check|
     -
   * - :fonticon:`fa fa-inbox fa-border fa-2x`

       :ref:`Inbox <inbox_block>`
     -
     -
     -
     -
     - |check|
     -
     -
     -
   * - :fonticon:`fa fa-file fa-border fa-2x`

       :ref:`Latest changes I can view <latest_changes_block>`
     -
     -
     -
     -
     - |check|
     -
     -
     -
   * - :fonticon:`fa fa-location-arrow fa-border fa-2x`

       | :ref:`Navigation <navigation_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
   * - :fonticon:`fa fa-pencil-square-o fa-border fa-2x`

       :ref:`Note <note_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
   * - :fonticon:`fa fa-list-alt fa-border fa-2x`

       :ref:`Peer assessment <peer_assessment_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     -
     -
     -
     - |check|
   * - :fonticon:`fa fa-map-o fa-border fa-2x`

       :ref:`Plans <plans_block>`
     - |check|
     - |check| *
     - |check| *
     - |check| *
     - |check|
     - |check|
     -
     - |check| *
   * - :fonticon:`fa fa-comments fa-border fa-2x`

       :ref:`Recent forum posts <recent_forum_posts_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
   * - :fonticon:`fa fa-check-square-o fa-border fa-2x`

       :ref:`Sign-off <sign-off_block>`
     - |check|
     - |check| *
     - |check| *
     - |check| *
     -
     -
     -
     - |check| *
   * - :fonticon:`fa fa-font fa-border fa-2x`

       :ref:`Text <text_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
   * - :fonticon:`fa fa-eye fa-border fa-2x`

       :ref:`Watched pages <watchlist_block>`
     -
     -
     -
     -
     - |check|
     -
     -
     -

Personal info
~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1

   * - Block
     - User
     - Group
     - Institution
     - Site
     - Dashboard
     - Profile
     - Group homepage
     - Copyable
   * - :fonticon:`fa fa-user-plus fa-border fa-2x`

       :ref:`My friends <friends_block>`
     -
     -
     -
     -
     - |check|
     - |check|
     -
     -
   * - :fonticon:`fa fa-users fa-border fa-2x`

       :ref:`My groups <groups_block>`
     -
     -
     -
     -
     - |check|
     - |check|
     -
     -
   * - :fonticon:`fa fa-file fa-border fa-2x`

       :ref:`My portfolios <myportfolios_block>`
     -
     -
     -
     -
     - |check|
     - |check|
     -
     -
   * - :fonticon:`fa fa-star fa-border fa-2x`

       :ref:`My entire résumé <full_resume_block>`
     - |check|
     - |check| *
     - |check| *
     - |check| *
     - |check|
     - |check|
     -
     - |check| *
   * - :fonticon:`fa fa-star-half fa-border fa-2x`

       :ref:`One résumé field <resume_field_block>`
     - |check|
     - |check| *
     - |check| *
     - |check| *
     - |check|
     - |check|
     -
     - |check| *
   * - :fonticon:`fa fa-info fa-border fa-2x`

       :ref:`Profile information <profile_info_block>`
     - |check|
     - |check| *
     - |check| *
     - |check| *
     - |check|
     - |check|
     -
     - |check|
   * - :fonticon:`fa fa-thumbs-up fa-border fa-2x`

       :ref:`Social media <social_media_block>`
     - |check|
     - |check| *
     - |check| *
     - |check| *
     - |check|
     - |check|
     -
     - |check|
   * - :fonticon:`fa fa-quote-left fa-border fa-2x`

       :ref:`Wall <wall>`
     -
     -
     -
     -
     -
     - |check|
     -
     -

External content
~~~~~~~~~~~~~~~~~~~

.. list-table::
   :header-rows: 1

   * - Block
     - User
     - Group
     - Institution
     - Site
     - Dashboard
     - Profile
     - Group homepage
     - Copyable
   * - :fonticon:`fa fa-rss fa-border fa-2x`

       :ref:`External feed <external_feed_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
   * - :fonticon:`fa fa-youtube-play fa-border fa-2x`

       :ref:`External media <external_media_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
   * - :fonticon:`fa fa-google fa-border fa-2x`

       | :ref:`Google Apps <googleapps_block>`
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|
     - |check|