.. 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 ~~~~~~~~~~~~~~~~~ :fonticon:`fa fa-rss fa-border fa-2x` 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**: Switch this option to "Yes" 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**: Switch this option to "Yes" if you want to see the entire feed content and not only the heading of a blog post. #. **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 your feed is not updated automatically, please ask your site administrator to check the *cron* settings. :index:`If ` you click an entry in the RSS feed, it will open in a new window. .. index:: pair: Blocks; External media single: External content block; External media single: External media iframe filters .. _external_media_block: External media ~~~~~~~~~~~~~~~~~~ :fonticon:`fa fa-youtube-play fa-border fa-2x` 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 embedded using the **