.. include:: /shortcuts.rstext .. index:: pair: Block category; Journal .. _journal_blocks: 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 * 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: Journal ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :fonticon:`fa fa-pencil fa-border fa-2x` Display an entire journal on 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. .. note:: Journals from groups, institutions and the site that you may have access to are indicated to provide the proper context. #. **Entries per page**: Decide how many entries you want to display. Entries beyond this number are accessible via a navigation bar. #. **Block copy permissions**: You decide what shall happen with this block when you allow other users to copy your page. The 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 #. **Retractable**: Choose whether you want to allow users to reduce the block to its heading on a page or see just the heading only automatically. The options are: * **No**: The block and its content is displayed at all times. * **Yes**: Allow users to reduce the block to just the heading by clicking the *Retractable* icon |retractable|. * **Automatically retract**: Only the heading of the block is visible, and the user can click the *Retracted* icon |retracted| to view its content. #. Click the *Save* button to accept your changes, or click *Cancel* to leave the block's content as it is. *Remove* is shown only when you place the block into the page for the first time. #. You can also click the *Close* button |close| in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block's content as it is. .. note:: If you :ref:`share the page publicly` in which you make an entire journal visible, your journal receives an RSS feed address to which your readers can subscribe in their favorite RSS readers. .. index:: single: Journal block; Add new journal post directly from a page Once you have included the *Journal* block into a page, you can create a new journal entry directly from that block when you are in the *Edit* mode for the page. When you click the *New entry* button, you will be taken to your journal and a new entry is started for you. It is then added to the journal automatically. .. figure:: /images/page_editor/blocks/journal_new_entry.* :alt: Create a new journal entry directly from the *Entire journal* block Create a new journal entry directly from the *Entire journal* block .. index:: pair: Blocks; Display one journal entry single: Journal block; Display one journal entry .. _journal_entry_block: Journal entry ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :fonticon:`fa fa-file-text fa-border fa-2x` Display one journal entry on 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 entry is chosen automatically unless you provide a different one. #. **Journal entry**: Select the journal entry you wish to display. If you have many, 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 #. **Retractable**: Choose whether you want to allow users to reduce the block to its heading on a page or see just the heading only automatically. The options are: * **No**: The block and its content is displayed at all times. * **Yes**: Allow users to reduce the block to just the heading by clicking the *Retractable* icon |retractable|. * **Automatically retract**: Only the heading of the block is visible, and the user can click the *Retracted* icon |retracted| to view its content. #. Click the *Save* button to accept your changes, or click *Cancel* to leave the block's content as it is. *Remove* is shown only when you place the block into the page for the first time. #. You can also click the *Close* button |close| in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block's content as it is. .. index:: pair: Blocks; Display recent journal entries single: Journal block; Display recent journal entries .. _recent_journal_entry_block: Recent journal entries ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :fonticon:`fa fa-clock-o fa-border fa-2x` Display recent journal entries across all your journals on your portfolio page. You can use this block also in group, institution and site pages. .. 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 entries. If you have many journals, you can also search for the one(s) you want to use. #. **Entries to show**: Decide how many entries you want to display. #. **Retractable**: Choose whether you want to allow users to reduce the block to its heading on a page or see just the heading only automatically. The options are: * **No**: The block and its content is displayed at all times. * **Yes**: Allow users to reduce the block to just the heading by clicking the *Retractable* icon |retractable|. * **Automatically retract**: Only the heading of the block is visible, and the user can click the *Retracted* icon |retracted| to view its content. #. Click the *Save* button to accept your changes, or click *Cancel* to leave the block's content as it is. *Remove* is shown only when you place the block into the page for the first time. #. You can also click the *Close* button |close| in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block's content as it is. .. note:: If you have multiple journals, you can display recent entries from all of them. .. index:: single: Add new journal post directly from a page Once you included the *Recent journal entries* block into a page, you can create a new journal entry directly from that block when you are in *Edit* mode for the page. When you click the *New entry* button, you will be taken to your journal, and a new entry is started for you. It is then added to the journal automatically. .. figure:: /images/page_editor/blocks/journal_recent_new_entry.* :alt: Create a new journal entry directly from the *Recent journal entries* block - one journal only Create a new journal entry directly from the *Recent journal entries* block - one journal only If you enabled multiple journals and selected more than one for which to display recent journal entries, you will see a slightly different display. .. figure:: /images/page_editor/blocks/journals_recent_new_entry.* :alt: Create a new journal entry directly from the *Recent journal entries* block - multiple journals available Create a new journal entry directly from the *Recent journal entries* block - multiple journals available #. Choose the journal to which to add your entry from the drop-down menu. #. Click the *Add* button to create your new entry. .. index:: pair: Blocks; Display tagged journal entries single: Journal block; Display tagged journal entries single: Display tagged journal entries in full single: Choose only from tags used in journal entries .. _tagged_journal_entries_block: Tagged journal entries ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ :fonticon:`fa fa-tags fa-border fa-2x` Display tagged journal entries across all your journals on 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. #. **Display entries tagged with**: :index:`Choose ` the tags that you want to use to filter all your journal entries for display. Only tags you used on journal entries are available. You can include or exclude tags. See below for more information. #. |new in Mahara 16.10| **Block copy permissions**: :index:`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 will get a copy of the block configuration: The block is copied, but not the journal entries. When the user creates journal entries with the tag(s) used in the block, they will be displayed. #. **Items to show**: Decide how many entries you want to display. #. **Show journal entries in full**: If you switch this option to "Yes", your journal entries will be displayed. Otherwise, only their titles are shown and people need to click on them to read your entries. #. **Retractable**: Choose whether you want to allow users to reduce the block to its heading on a page or see just the heading only automatically. The options are: * **No**: The block and its content is displayed at all times. * **Yes**: Allow users to reduce the block to just the heading by clicking the *Retractable* icon |retractable|. * **Automatically retract**: Only the heading of the block is visible, and the user can click the *Retracted* icon |retracted| to view its content. #. Click the *Save* button to accept your changes, or click *Cancel* to leave the block's content as it is. *Remove* is shown only when you place the block into the page for the first time. #. You can also click the *Close* button |close| in the top left-hand corner of the modal window to either remove a newly created block before it is being saved or to cancel any changes and leave the block's content as it is. .. index:: single: Add new journal entry directly from a page Add new tagged journal entries directly from a page ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Once you have included the *Tagged journal entries* block into a page, you can create a new journal entry directly from that block when you are in *Edit* mode for the page. When you click the *New entry* button, you will be taken to your journal and a new entry is started for you. It is then added to the journal automatically with the tag(s) whose journal entries are displayed on the page. .. figure:: /images/page_editor/blocks/journal_tagged_new_entry.* :alt: Create a new journal entry directly from the *Tagged journal entries* block - one journal only Create a new journal entry directly from the *Tagged journal entries* block - one journal only If you enabled multiple journals and have a minimum of two journals, you will see a slightly different display. .. figure:: /images/page_editor/blocks/journals_tagged_new_entry.* :alt: Create a new journal entry directly from the *Tagged journal entries* block - multiple journals available Create a new journal entry directly from the *Tagged journal entries* block - multiple journals available #. Choose the journal to which to add your entry from the drop-down menu. #. Click the *Go* button to create your new entry. Select tags to include or exclude ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ When you want to choose which tags to use in your block, you can select multiple tags to include or exclude. That way you can be very flexible in which entries to display in your block and which ones to leave out. You must have tagged your journal entries beforehand. If you haven't done that, please go to your journal entries and tag them. You can find them under *Content → Journal(s)*. .. figure:: /images/page_editor/blocks/taggedjournalentries_taglist.* :alt: Display all the tags that you used on journal entries Display all the tags that you used on journal entries #. Click in the text field for the tag entries. You can start typing the tag that you are looking for if you know it. The result list that you see underneath gets shorter based on what you type. If you want to exclude a tag, type the minus sign and then the tag. #. In the tag result list, click the tag that you want to include. If you want to exclude a tag, type the minus sign and then select the tag. Once the tags are in the field, you can see directly which ones are included and which ones are excluded. .. figure:: /images/page_editor/blocks/taggedjournalentries_tags.* :alt: A selection of tags for the tagged journal entries A selection of tags for the tagged journal entries #. Tags that are excluded from your journal entries are displayed in red. #. Tags that your journal entries must have are displayed in light grey. #. You can remove any tag by clicking the *x* to the left of it. .. note:: |tags mentioned in journal entries| When you display your page that has a tagged journal entries block, you see which tags are used to filter your journal entries. For example: Journal entries with tag "learning" but not tag "conference". Know which tags to include and exclude ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ You can add multiple tags to limit the results as well as indicate which tags you want to ignore. If you select multiple tags, a journal entry must match **all** selected tags in order to be listed. Let's assume, you tagged your journal entries with the following tags: #. learning, formal, education #. learning, formal, education, music #. learning, formal, education, language #. learning, nonformal, education #. learning, nonformal, education, music #. learning, nonformal, education, language #. teaching, nonformal, education #. teaching, nonformal, education, music #. teaching, nonformal, education, language When you select: * the tag "education", all journal entries would be displayed in the block. * the tags "learning" and "language", journal entries 3 and 6 would be displayed, i.e. the entries that are tagged "learning" **and** "language". * the tags "education" and "language", journal entries 3, 6, and 9 would be shown, i.e. the entries that are tagged "education" **and** "language". You can also exclude tags from the results by putting a minus sign before the tag you want to select. If you select: * the tag "learning" and exclude "formal" (exclude the tag by typing "-formal" without the quotation marks), journal entries 4, 5, and 6 would be displayed. You search for journal entries tagged "learning" and **not** "formal". * the tag "nonformal" and "education" and exclude "music" and "language" (exclude the tags by typing "-music -language" without the quotation marks), journal entries 4 and 7 would be shown. You search for journal entries tagged "nonformal" **and** "education" and **not** "music" and **not** "language". .. note:: The operators **and** and **not** are two of the so-called "Boolean operators".