.. include:: /shortcuts.rstext .. index:: pair: Block category; Journal Journals ---------- You can embed content from your journals in various ways in a page: * display an entire journal * display only one journal entry * show the latest journal entries * |new15| display journal entries with a specific tag .. note:: You must create at least one :ref:`journal ` in order to see anything in this block. .. warning:: You can allow the copying of your journal (entries). Choose this option wisely because once a user copied your journal content into their portfolio, it looks as if they had written the journal entries. This could lead to plagiarism. However, it can be used very nicely to create templates and to scaffold learning. .. index:: pair: Blocks; Display an entire journal single: Journal block; Display an entire journal .. _journal_block: Display an entire journal ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. image:: /images/page_editor/blocks/journal.* :alt: Display an entire journal Display an entire journal in your portfolio page. .. figure:: /images/page_editor/blocks/journal_configure.* :alt: Configure the journal block Configure the *Journal* block #. **Block title**: The title for the block is chosen automatically from the title of the journal unless you provide a different one. #. **Journal**: Select the journal you wish to display. If you have many journals, you can also search for the one you want to use. #. **Entries per page**: Decide how many entries you want to display. Entries beyond this number are accessible via a page navigation bar. #. **Block copy permissions**: You decide what shall happen with this block when you allow other users to copy your page. Options are: * Skip this block entirely when copying the page * Others may display your journal in their page * Others will get their own copy of your journal #. Click the *Save* button to accept your changes, or click the *Cancel* button to leave the block's content as it is. The *Remove* button is shown only when you place the block into the page and have not yet added any artefacts. .. note:: If you :ref:`share the page ` in which you make an entire journal visible with the public, your journal receives an RSS feed to which your readers can subscribe in their favorite RSS readers. .. index:: pair: Blocks; Display one journal entry single: Journal block; Display one journal entry .. _journal_entry_block: Display one journal entry ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. image:: /images/page_editor/blocks/journalpost.* :alt: Display one journal entry Display an entire journal in your portfolio page. .. figure:: /images/page_editor/blocks/journalpost_configure.* :alt: Configure the journal entry block Configure the *Journal entry* block #. **Block title**: The title of the journal post is chosen automatically unless you provide a different one. #. **Journal entry**: Select the journal entry you wish to display. If you have many posts, you can also search for the one you want to use. You always also see the title of the journal in which the entry appears. #. **Block copy permissions**: You decide what shall happen with this block when you allow other users to copy your page. Options are: * Skip this block entirely when copying the page * Others may display your journal entry in their page * Others will get their own copy of your journal entry #. Click the *Save* button to accept your changes, or click the *Cancel* button to leave the block's content as it is. The *Remove* button is shown only when you place the block into the page and have not yet added any artefacts. .. index:: pair: Blocks; Display recent journal entries single: Journal block; Display recent journal entries .. _recent_journal_entry_block: Display recent journal entries ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. image:: /images/page_editor/blocks/recentjournalpost.* :alt: Display recent journal entries Display recent journal entries across all your journals in your portfolio page. .. figure:: /images/page_editor/blocks/recentjournalpost_configure.* :alt: Configure the recent journal entries block Configure the *Recent journal entries* block #. **Block title**: Choose a title for your block. #. **Journals**: Select the journal(s) from which you wish to display the latest posts. If you have many journals, you can also search for the one(s) you want to use. #. **Items to show**: Decide how many entries you want to display. #. Click the *Save* button to accept your changes, or click the *Cancel* button to leave the block's content as it is. The *Remove* button is shown only when you place the block into the page and have not yet added any artefacts. .. note:: If you have multiple journals, you can display recent entries from all of them. .. index:: pair: Blocks; Display tagged journal entries single: Journal block; Display tagged journal entries single: New in Mahara 1.5; Display tagged journal entries .. _tagged_journal_entries_block: |new15| Display tagged journal entries ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. image:: /images/page_editor/blocks/taggedjournalentries.* :alt: Display tagged journal entries Display tagged journal entries across all your journals in your portfolio page. .. figure:: /images/page_editor/blocks/taggedjournalentries_configure.* :alt: Configure the tagged journal entries block Configure the *Tagged journal entries* block #. **Block title**: Choose a title for your block. #. **My tags**: Select the tag for which you want to display all journal entries. The entries will appear as link list. #. **Items to show**: Decide how many entries you want to display. #. Click the *Save* button to accept your changes, or click the *Cancel* button to leave the block's content as it is. The *Remove* button is shown only when you place the block into the page and have not yet added any artefacts.