Version 7
    Basic use

     

    We've added support to embed a single tweet from twitter into the site.

     

    In order to start with embedding a tweet, you need to be editing a piece of rich content.

     

    Once there, click on the chevron icon to open additional functionality, and select "Embed Twitter Post" from the resulting menu.

     

     

    This opens a dialog with only a few options. Really, your only options can be summarized as "What tweet do I want to show", and "should it show pictures and/or video".

     

     

    The twitter status URL is the URL of the tweet you want to copy in. There are several ways to get at this. From twitter, you can use either of these options:

     

     

    This will get you the URL you need to paste into the dialog

     

     

    Note that the dialog shows a text preview of the tweet - allowing you to ensure you have the right one, but also showing that you have a URL that the system supports.

     

    Once you've done this, click insert, and it will close the dialog and place a place holder into your content.

     

     

    Then, when you publish this content, the page will get the tweet body from twitter and embed it into your content.

     

     

    Should you not want the images and just want a simple tweet, do the same process, but uncheck the Show Media checkbox.

     

     

    And the end result, when held in content, looks like this.

     

    placeholder for tweet

     

    Advanced use

    Should you wish to control the size of the embedded tweet, there is a hidden parameter that allows you to set this. Note that the tweet will resize on smaller displays already, so you do not need to size it to handle mobile devices - but you might want to be putting the tweet into a table or a floating div in the corner of a post, and then you might want it to be narrower.

     

    You can do this in html mode. The social media macro goes in with a variety of parameters, one of which is _post_width. This defaults to the maximum allowed width of 550 pixels - but you can change this to any value within the range that twitter allow. At time of writing, this is from 220 pixels to 550 pixels.

     

    Shown here is an example of setting it to 220 pixels.

     

     

     

    And the end result looks like this.

     

    With media turned on

     

    With media turned off

     

    Resized to minimum size