.. 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: Insecure SSL mode for feeds single: Allow authenticated feeds .. _external_feed_block: External feed ~~~~~~~~~~~~~~~~~ .. image:: /images/page_editor/blocks/externalfeed_chooser.* :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. You must provide a feed URL here. .. note:: Unfortunately, Firefox and Chrome do not display the RSS feed icon for a page immediately near the address bar anymore. In Firefox you will have to go to *View → Toolbars → Customize* and then drag the RSS icon to your toolbar. It lights up orange / white when a feed is available. If you use Chrome, you will have to install the `RSS Subscription Extension `_. #. **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. #. **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. #. **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. #. **Retractable**: Tick this checkbox if you want to allow users to reduce the block to its heading on a page. The user can click the *Retractable* icon |retractable| to just show the heading. #. **Automatically retract**: Tick this checkbox if you want to show only the block's heading when a user views the page. The user can click the *Retracted* icon |retracted| to view the entire block. #. 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 for the first time. #. You can also click the *Close* button |close| in the top right-hand corner 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 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: External media iframe filters .. _external_media_block: External media ~~~~~~~~~~~~~~~~~~ .. image:: /images/page_editor/blocks/externalmedia_chooser.* :alt: External media With this block you can embed content from a wide variety of third-party sites. The sites that are allowed are listed below the text area in the pop-up. You see only their favicons, but when you hover over an icon with your mouse, you see the site's name as well. .. seealso:: Mahara comes with a number of sites that are allowed per default. These are listed on the page. Your site admin can :ref:`add additional iframe sources `. .. figure:: /images/page_editor/blocks/externalmedia_configure.* :alt: Configure the external media block Configure the external media block #. **Block title**: Choose a title for your embedded content. #. **URL or embed code**: Paste the URL or the embed code of a page where the content is located. #. **Embed code**: Content from the sites listed in this section can be embeded using the **