.. include:: /shortcuts.rstext .. index:: pair: Block category; External content .. _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. #. **Tags**: Enter tags for this block to find this content more easily. The tags are displayed as part of the page tags. #. **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 configuration screen. 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 administrator 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 **