.. include:: /shortcuts.rstext .. index:: pair: Block category; External content External content ------------------ With the help of the external content blocks, you can include RSS feeds, external media or GoogleApps documents etc. into a page. .. index:: pair: Blocks; External feed single: External content block; External feed single: New in Mahara 1.5; Insecure SSL mode for feeds single: New in Mahara 1.5; Allow authenticated feeds .. _external_feed_block: External feed ~~~~~~~~~~~~~~~~~ .. image:: /images/page_editor/blocks/externalfeed.* :alt: External feed Embed an external RSS or ATOM feed, e.g. to display an external blog. .. figure:: /images/page_editor/blocks/externalfeed_configure.* :alt: Configure the external feed Configure the external feed block #. **Block title**: If you leave the title blank, the title of the feed will be used. #. **Feed location**: Put the entire feed URL from a valid RSS or ATOM feed in here. If the feed is not displayed, try to view it in a regular feed reader to make sure that the URL is correct. #. |new15| **Insecure SSL mode**: Place a check mark in this box if you wish to enable the insecure SSL mode. This mode allows you to override certificate errors generated by a feed. #. |new15| **HTTP username**: Provide a username if you wish to access a feed that requires authentication. This is the username to access the feed and not your portfolio system. #. |new15| **HTTP password**: Provide a password to access a feed that requires authentication. This is the password to access the feed and not your portfolio system. #. **Items to show**: Decide how many of the latest items in the feed you wish to display. You can choose up to 20. #. **Show feed items in full**: If you do not select this option, only a heading will be shown for each feed item, e.g. the blog heading of a post. If you select this option, the entire content of the feed item will be shown, e.g. the entire blog post or in case of a flickr RSS feed, the photo and its description. #. Click the *Save* button to accept your changes, or click the *Remove* button to remove this block from your page. .. note:: If your feed is not updated automatically, please ask your site administrator to check the *cron* settings. .. index:: pair: Blocks; External media single: External content block; External media single: New in Mahara 1.5; External media filters .. _external_media_block: External media ~~~~~~~~~~~~~~~~~~ .. image:: /images/page_editor/blocks/externalmedia.* :alt: External media Embed content from: * `YouTube `_ * `TeacherTube `_ * `Scivee.tv `_ * `Google Videos `_ And |new15| also: * `Glogster `_ * `SlideShare `_ * `VoiceThread `_ * `WikiEducator `_ * `Prezi `_ * `Vimeo `_ * `Voki `_ .. figure:: /images/page_editor/blocks/externalmedia_configure.* :alt: Configure external media Configure the external media block #. **Block title**: Choose a title for your embedded content. #. **Content URL**: Paste the embed code or the URL of page where the content is located. #. **Width and Height**: Choose the width and the height that the content should take up on the page. #. Click the *Save* button to accept your changes, or click the *Remove* button to remove this block from your page. .. note:: If you use the embed code, you still have to provide the correct width and height although they already exist in the embed code. Mahara ignores these variables from the embed code. .. index:: pair: Blocks; Google Apps single: External content block; Google Apps .. _googleapps_block: Google Apps ~~~~~~~~~~~~~~~~ .. image:: /images/page_editor/blocks/googleapps.* :alt: Google Apps Embed any of the following content available via Google (Apps): * books * calendars * documents, spreadsheets, presentations * maps You can only display the content, but not immediately edit documents, spreadsheets or presentations. You will have to be logged in to your Google (Apps) account to do so. You can use this block with a regular, personal Google account or if you have a Google Apps account via an institution, e.g. your school or university. .. note:: If certain documents are restricted to a Google Apps domain or to specific people, a login screen is displayed. .. figure:: /images/page_editor/blocks/googleapps_configure.* :alt: Configure the Google Apps block Configure the Google Apps block #. **Block title**: Choose a title for your embedded content. #. **Embed code or URL**: Depending on what kind of content you wish to display, you either provide the embed code or the URL. Click on the |help| button for more information on how to embed each Google component. #. **Height**: Choose the height for the embedded content. The width is adjusted to the column width of the block automatically. #. Click the *Save* button to accept your changes, or click the *Remove* button to remove this block from your page. **Google document** #. Open the document. #. Click *File* in the menu bar and then *Publish to the Web*. #. Click the *Start publishing* button. #. Copy the document link or embed code. #. Paste the link or embed code into the *Embed code or URL* box in the Google Apps block. **Google spreadsheet** #. Open the spreadsheet. #. Click *File* in the menu bar and then *Publish to the Web*. #. Click the *Start publishing* button. #. Read through the other options and decide on them. #. Copy the link for the option *Web page* or the embed code for the option *HTML to embed in a page*. #. Paste the link or embed code into the *Embed code or URL* box in the Google Apps block. **Google presentation** #. Open the presentation. #. Click the *Share* button and then *Publish / embed* (upper right-hand corner) **OR** if you use the new interface: Click *File* in the menu bar and then *Publish to the Web*. #. Click the *Start publishing* button. #. Copy the link or embed code. #. Paste the link or embed code into the *Embed code or URL* box in the Google Apps block. **Google collections** #. Click on the arrow to the right of the collection name and then on *Share* and *Share* again. #. Change the permissions to *Public on the web* and save your changes. #. Copy the link. #. Paste the link into the *Embed code or URL* box in the Google Apps block. **Google docs viewer** When you have access to a document, e.g. PDF file, through Google Docs from another person, you can embed it: #. Click on *File* in the menu bar and then *Embed this PDF file... / Embed link...*. #. Copy the embed code. #. Paste it into the *Embed code or URL* box in the Google Apps block. Alternatively, you can export the document into your Google Documents and treat it like any other document (see the section on Google documents above). **Google Calendar** #. Open Google Calendar. #. Click on the little triangle next to the calendar that you wish to embed. #. Click on *Calendar settings*. #. On the *Calendar details* tab scroll down to *Embed This Calendar*. #. Customize the calendar appearance and then copy the embed code. #. Paste the embed code into the *Embed code or URL* box in the Google Apps block. **Google Maps** #. Open Google Maps. #. Click the *My Places* button. #. Click on the name of the map that you wish to embed. #. Click on the *Link* icon to the left of the map. #. Customize the appearance of the map and copy the embed code. #. Paste the embed code into the *Embed code or URL* box in the Google Apps block. .. note:: Use steps 2 and 3 only if you wish to embed one of your Google maps. If you wish to embed any Google map, you can skip these steps. **Google Books** #. Open Google Books. #. Find the book that you wish to embed. #. Click on the book title. #. Click on the *Link* icon above the book. #. Copy the embed code of the book. #. Paste the embed code into the *Embed code or URL* box in the Google Apps block. .. note:: The link icon only appears if you are allowed to embed this book.